Zwiki

=======================

Preliminary reStructured Text support, page types cleanup, skin
bugfixes, customizable issue colours.

**Upgrade notes**

Nothing special this month.

**General**

* preliminary reStructured Text support, based on Andreas' and
Richard's work.

* page types cleanup. Retired a bunch of old types, added new ones.
Fit tests and issue properties form support is now standard.

* New allowedPageTypes method returns the allowed page types for
the wiki, defined in Defaults.py or an allowed_page_types
folder lines property. Only these types can be selected when changing
the page type (except in ZMI). Note: at present a new wiki will not
allow DTML-enabled types, so if a user edits one of the DTML pages
like RecentChanges it's type will change, disabling it. The edit form
gives a warning in this situation.

* when creating pages, don't inherit page type from the parent -
use either the wiki's standard_page_type, the specified type, or
the zwiki default. Should make administration simpler.

* creationTime and lastEditTime now always return a valid DateTime

* new page methods: ageInDays, lastEditIntervalInDays

* standard_error_message was getting instantiated as a wiki page in CMF
(IssueNo0510)

* fix NameErrors due to missing imports

**Skins and content**

* start with no bookmarks by default

* UI code cleanups, more useful error messages

* use xhtml-compliant tag for uploaded images

* default: replace DTML methods with page templates (IssueNo0508).
Zwiki now requires Page Templates.

* default: XHTML 1.0 compliance fixes for the default skin
(IssueNo0399, Jordan Carswell)

* default: subscribeform layout tweaks, remove extra title tag

* default: fix editform action url

* default: fix contentspage tal:contents typo

* default: replace stray DTML in editform with TAL
(IssueNo0506, Jordan Carswell)

* zwiki_plone: remove the bookmarks & help links from the page footer

**Tracker**

* IssueTracker & FilterIssues dtml cleanups, robustness enhancements

* Instead of highlighting open and pending issues, we now highlight
open and pending non-wishlist issues more than 60 days old

* issue colours code cleanup; issue colours are now defined in
Default.py or issue_colours folder lines property

=======================

Full Plone and CMF skin, miscellaneous fixes.

**Upgrade notes**

If you have a cmf_install_zwiki external method, refresh it after
installing this release (by saving it, or restarting zope).

The new zwiki_plone skin replaces the zwiki_cmf skin; although the
latter is still shipped it will hopefully go away soon. An existing
CMF zwiki should keep working as before. To change it over to the
zwiki_plone skin, do this:

1. in your CMF site's portal_skins Contents tab, delete the default
and zwiki_cmf folders (and zwiki_orig, if you don't use that)

2. in the properties tab, remove zwiki_cmf (and zwiki_orig) from
all skins

3. run the install method again (CMFSITEURL/cmf_install_zwiki)

Structured text headings will get bigger next time you save the page
(or visit SOMEPAGEURL/upgradeAll to re-render all pages).

**General**

* structured text headings now start at H2 not H3

* when using regulations, don't require change regulations
permission just to comment (IssueNo0485)

* be more robust displaying pages with old-style page ids that
have not yet been upgraded (IssueNo0495)

* use precise links in contents, rather than depending on
standard_error_message (IssueNo0454, Leslie Barnes)

* when saving a page via external editor/ftp/webdav, don't require
a space after the : in the safety belt/type/log headers. Was
causing a name error with external editor + emacs whitespace mode
(IssueNo0438, Andrew Burrow)

* if there is an id renaming collision during upgradeAll, just log
the error and continue (IssueNo0483)

* edit conflict & lock dialogs were giving NameErrors

* new method: ancestorsAsList

**Skins and content**

* a fully functional Plone (and CMF) skin, at last! The
zwiki_plone skin provides most current features of Zwiki's default
skin, within the standard plone UI. It should also be functional
for CMF sites, allowing zwiki_cmf to be retired. (Alexander Limi
funded by Walt Ludwick, with Simon Michael, Sidnei da Silva, Alan
Runyan)

* skin code fixes; Zwiki accepts Page Templates, Filesystem Page
Templates, and DTML Methods as skin objects, and will warn if any
other type is found.

* UserOptions was not honouring the redirectURL argument if just
clearing cookies

* tweaked blank subject comment heading format.. not happy with it
yet

**Mail**

* mailouts were failing when creating a page with no initial text

* make comment mailout work when there is no subject_heading field
(IssueNo0481, az` on irc)

**Tracker**

* when changing issue properties, add a user-supplied or default
comment to the page recording what was done (DeanGoodmanson)

=======================

Simpler page ids, faster performance and better memory efficiency,
new general-purpose page type including tracker and fit support, more
robust parenting, skin improvements, preliminary stylesheet support,
code cleanups, doctest no longer used.

**Upgrade notes**

If you have pages with punctuation in the names, or zwiki tracker
issues, you'll need to change their id/name. See below.

If you have a tracker in your wiki, you'll also need to install the
latest IssueTracker/FilterIssues pages and add a new 'isIssue'
FieldIndex to your catalog. Also, in a large wiki you may find
changing issue descriptions is much slower than before. See below.

issuedtml and stxprelinkdtmlhtml pages will be auto-upgraded to the
new stxprelinkdtmlfitissuehtml type.

The CMF install method in Extensions has been renamed to Install.py.

**General**

* Simpler page ids

Page ids are now always derived from the name (title). This
improves performance, removes a source of confusion, but means
pages can no longer have a totally different title and id (like
tracker issues used to). Also, page ids no longer include
punctuation, and fuzzy links now ignore punctuation.

Pages with old-style ids should be renamed so that wiki links to
them will work. You can upgrade these pages and update links
throughout the wiki by visiting SOMEPAGEURL/upgradeAll. This
may take a long time; you can watch progress in the debug
log. It's safe to run this more than once. Alternately, you can
visit SOMEPAGE/upgradeId to rename and relink a single page.

Some incoming links may break due to url changes; having the
zwiki standard_error_message installed will help.

* Improved performance and memory efficiency

Link rendering is faster due to the new ids and code
refactoring.
(Unscientific ab test: roughly a 4x speedup rendering a
normal page and 20x for a long one.) Also, zwiki is no longer
so eager to load all pages into the zodb cache. Certain
operations will still trigger this (search, rename) but in
general use, a zope serving large wikis should now use less
memory. This may also help your performance and reduce "first
page render" delay.

* new/improved page lookup methods: pages, pageIds, pageNames,
pageIdsStartingWith, pageNamesStartingWith,
firstPageIdStartingWith, firstPageNameStartingWith, pageWithId,
pageWithName, pageWithNameOrId, pageWithFuzzyName. Use these in
your DTML code when possible as they will be optimized. pageWith*
now return a correct acquisition wrapper (fixes IssueNo0472).
pageWithFuzzyName's ignore_case has no extra cost now and is
always on. The argument is left in place for backwards
compatibility for the moment. Also this may have been acquiring
pages, fixed.

* new general-purpose page type incorporating issue and fit
support: stxprelinkdtmlfitissuehtml. stxprelinkdtmlhtml and
issuedtml pages are auto-upgraded to this. This page type
displays an issue properties form if the page name begins with
IssueNo. Also, any tables whose first cell begins with "fit." or
"fittests." are run as fit tests at page view time.

* rename improvements: support for upgrading to new-style ids;
allow renames without sending mail; reduce unnecessary indexing;
preserve creation info when renaming (IssueNo0398); be more
tolerant of confused parentage;

* Don't leave orphans when deleting a page

* cleaner catalog logging

* all doctests have been converted to pyunit tests

* Details of WWML changes in last month's release (PeterMerel):

- C2-compatible apostrophe embedding using minimal-munch

- C2-compatible generation of indents from leading spaces

- Intuitive fixed-width tables using | as a column delimiter. I
purely hate the STX tables, which do everything except the most
obvious formatting everybody wants.

- Ability to use images as page names with [image-url]

- Ability to generate blockquotes by using = instead of *

- Ability to force a BR in definitions using \\

- Probably some other things I've forgotten.

**Skins and content**

* the latest zwiki.org RecentChanges: fix a mispaced try which
allowed errors, be less chatty about brute force/catalog, move
note field next to page name, drop the "use table" option and the
T issue indicator.

* edit form layout improvements

* lose the gray title background and use site logo on all "form" pages

* Made the diff form skinnable: support a 'diffform' page template
or dtml method accepting two arguments: 'revA' and 'difftext'.

* Made the contents view skinnable: support a 'contentspage' page
template or dtml method accepting two arguments: 'hierarchy'
(a html string) and 'singletons' (a list of html strings).

* allow multiple space-separated wiki names in backlinks' other
parents field and the page management form (PeterMerel)

* contents improvements: make "you are here" bold; list singletons
at the bottom, if any. (PeterMerel)

* "contents" is used more consistently and is the preferred new name
for the map method.

* page creation links now have class "new" (IssueNo0456)

* preliminary CSS support: the default skin embeds a "stylesheet"
object if present.

**Mail**

* longish headings were not being stripped from mailouts

* mail out comments with their original formatting (not the page
diff)

* don't try to find a subject in comment body any more

* don't send mailouts from a page named TestPage, whether or not it has
[test] subject; log discarded [test] mailouts

**CMF**

* cmf_install_zwiki.py has been renamed to Install.py (IssueNo0460)

**Tracker**

* Issue pages have a new naming scheme to conform with the new
page ids: "IssueNoNNNN issue description". upgradeAll will take
care of this for you. Old IssueNoXXXX urls will still work if
you have standard_error_message installed. You need updated
IssueTracker/FilterIssues pages which can be found in
ZWiki/content/tracker. A new 'isIssue' FieldIndex is required in
the catalog.

* changeProperties has been replaced by changeIssueProperties.
This does a full page rename, with link updating, when changing
an issue description (slow).

* The 'issuedtml' page type is deprecated; the new combined
'stxprelinkdtmlfitissuehtml' type is used instead. Old issue
pages will be auto-upgraded. See also HowToInstallAZwikiTracker.

* If you use the new page type throughout, you can change an
ordinary page into an issue by renaming it "IssueNo..." and vice
versa.

=======================

CMF skin updates, various mail tweaks to support mailing list
integration, enhancements to comment behaviour, WWML, misc. bugfixes.

**Skins and content**

* enhancements and fixes to the CMF support and zwiki_cmf skin
from the nzo project - title fix, wiki folder edit view, don't
create standard_error_message in CMF, CMF-style edit form, other
skin updates. (Sidnei da Silva, LaloMartins)

* dropped zwiki_orig skin

* default skin: subject field, always post with heading,
tweaked page management form

* more compact comment headings

* add discussion icon to comment headings in a CMF site

**Mail**

* mailout all comments, regardless of use_heading flag

* with multiple bracketed strings in a subject, use the right-most

* mailin.py: support for preventing duplicates when using a
mailing list, commented out;

* generate list id header from mail_from, not mail_replyto

* new mail_signature property to override mailout footer

* new mail_page_name boolean property to disable page name in
subject

* mailin.py: parse boolean options correctly

* don't add extra spaces in mailout subjects

* log reason for mailout failures

**General**

* WWML: fixed a couple of little bugs and added a couple of little
extra markups. (PeterMerel)

* comment(): a non-blank comment subject now enables the heading
if use_heading is not already true

* preserve parentage when pages are renamed (IssueNo0168)

* fixed a strange problem with catalog()

* fix Localizer ustr NameError caused by non-unicode zope or unit
testing

* testing support - don't append or mail out comments with [test]
subject

* test modules re-organized

=======================

Minor bugfixes and some changes to wikimail behaviour.

**Upgrade notes**

If you're doing mailin, don't forget to re-save your external method
after installing this release.

**Mail**

* don't store page names in recipient real name. This seems to
create more confusion than it solves. mailin.py's checkrecipient
option is now off by default, and the line in Mail.py:sendMailTo()
which puts the page name in mailouts' reply-to is commented out.

* don't recognize bare wiki names in mailin subjects - only page
names enclosed in brackets. Explicit is better than implicit.
More details on http://zwiki.org/WikiMailDiscussion, please
comment there if you don't agree with these changes.

* non-headed comments were sending error reports to mail_admin
if configured

**Skins and content**

* default: some fixes for valid HTML (Pieter Biemond, IssueNo0399)

* default, zwiki_orig: increase max quote size in header to 300

* zwiki_orig: get rid of the javascript double-click

**General**

* leave unknown link titles blank instead of showing "xxx zwiki bug"

* a comment's subject (explicit from a field or inlined) is now
used for the transaction log regardless of the use_heading checkbox.

=======================

A mailin.py rewrite.

**Upgrade notes**

If you don't use mailin, no need to upgrade. After installing this
you'll want to click your external method's save button to update
it. Note this version of mailin.py drops the special virtual host
support.

**Mail**

* a rewritten mailin.py with tweaked delivery rules and unit
tests. Fixes IssueNo0376.

* be more fussy about recognizing a recipient real name as a page
name

* bracketed free form names in the subject are now also recognized
(it will use the first bracketed thing found)