PmWiki: ReleaseNotes6

Version 1.0.8 (26-Aug-2004)

This release provides a minor bugfix to sessionauth.php.

Version 1.0.7 (23-Aug-2004)

This release provides a minor bugfix to prevent links containing <img ...> tags at the end of a markup line from being inappropriately floated to the front when the source of the tag was not an image link.

Version 1.0.6 (19-Aug-2004)

This release provides some minor improvements: A $LockFile variable has been introduced to allow the location of the ".flock" file to be set, and the sample-config.php file has been improved.

Version 1.0.5 (8-Jul-2004)

This release provides some minor bugfixes: it corrects a bug with $WikiPageCreateSpaceFmt, and eliminates a couple of ctype_digit() calls that were missed in the 1.0.1 release (for PHP 4.1 compatibility).

Version 1.0.4 (2-Jul-2004)

This release cleans up the table caption code a bit, and also makes some minor enhancements to the search functionality. See the ChangeLog for details.

Version 1.0.3 (30-Jun-2004)

This release adds the capability to author captions and column headers in SimpleTables. In addition, the release eliminates the warning message generated on IIS systems when QUERY_STRING is not set. Finally, support for &#x...; hexadecimal character encodings has been added.

Version 1.0.2 (28-Jun-2004)

This release fixes a bug in the Patch() function that incorrectly applied non-diff lines to page restores.

Version 1.0.1 (20-Jun-2004)

This release provides a couple of minor bugfixes:

• Changes ctype_digit to preg_match to allow better PHP 4.1 compatibility.
• Corrects bug in XLPage() with $FarmD variable not declared global.
• Corrects oddity in AsSpaced() where spaces occur between hyphens and digits.

Version 1.0.0 (13-Jun-2004)

This is the PmWiki 1.0 release. The primary purpose of this release
is to give PmWiki a "1.0" release number to reflect its demonstrated
stability. In reality, the changes between 0.6.21 and this version are
the same as a minor version change--upgrading to this version should not
pose any difficulties. The minor changes are:

• Added a $DiffAccessLevel variable to allow one to choose a different password to control page history display (e.g., 'edit' or 'admin' instead of 'read').

• Added code that allows PmWiki to understand multiple ?'s in query strings. Thus, URLs such as http://www.pmwiki.org/wiki?pagename=Main.WikiSandbox?action=edit now work (note the use of the '?' instead of a '&' to separate the parameters). This also means that markups like ThisPage:?action=edit will work even on systems that must use the ?pagename= form of URL.

• Eliminated references to PHP's $HTTP_* variables (these were deprecated in PHP 4.1).

More details about this release will be available in the pmwiki-users [http://www.pmwiki.org/wiki/PmWiki/MailingLists] archives.

Version 0.6.21 (27-May-2004)

This release is experimental and contains a first implementation for WikiFarms. A WikiFarm is a way of having multiple independent wikis run from a single installed copy of PmWiki.

Version 0.6.20 (24-May-2004)

This release contains some bugfixes and minor enhancements to the
[[include:]] syntax, newlines between GroupHeader and GroupFooter
pages, and other miscellaneous details. For full information, see
the ChangeLog.

Version 0.6.19 (10-May-2004)

This release contains only minor changes:

• Adds support for a summary of each edit change. This summary is disabled by default -- see Cookbook:ChangeSummary for details about enabling it.

• Includes updates and bugfixes to the "pmwe" script.

• Adds a new [@...@] markup, which effectively combines the @@...@@ and [=...=] markups for producing <code> text.

In addition, Pm advises cookbook authors and other local customizers that the internal routines for editing, previewing, and posting pages may change somewhat within the next few revisions. This is not expected to warrant a significant change for any but the most complex PmWiki installations with significant deviations from the standard edit code.

Version 0.6.18 (7-May-2004)

The major change in this release is that PmWiki's default Patch() function has been rewritten to run entirely in PHP, without requiring a call to an external program such as patch(1). This provides a number of advantages:

• a call to an external program is no longer needed,
• this function should works in all cases, whereas the external patch(1) function sometimes failed to properly restore the text,
• the new version performs the patch in memory without using temporary files, eliminating the residual txt*.rej and txt*.orig files that sometimes occurred with the previous version,
• efficiency of performing a restore may be improved.

However, because of potential differences in the way that various operating systems store page history information, there's a possibility that the new Patch() function will not work where the external call to patch(1) previously did. To revert to using the old method (via an external program), simply add the line

    include_once('scripts/syspatch.php');

to local/config.php and PmWiki will revert to using the function found in previous versions of PmWiki.

This release also has some minor improvements:

• Changes the PrintWikiPage() function to add support for [[include:]] markup within sidebars and other wiki pages included via page templates.

• Adds $GroupPrintHeaderFmt and $GroupPrintFooterFmt variables to allow customization of the pages used for headers and footers with ?action=print.

• Fixes a small bug with consecutive instances of [=...=] markup on some non-US windows environments.

Version 0.6.17 (4-May-2004)

This release adds some extensions to the [[include:]] syntax to allow portions of another page to be included in the current one, based on either anchors embedded in the page or line numbers in the source markup. More details are available at SpecialMarkups#Includes .

Version 0.6.16 (28-Apr-2004)

This release provides some minor improvements:

• The [+...+] markup now produces percentages without decimals, to avoid problems in locales that use ',' for a decimal point.
• The mkgiddir() function is a bit more robust.

Version 0.6.15 (30-Mar-2004)

This release provides some minor improvements to trail markups.

It also changes the default value of $AuthRealmFmt to use a single realm for the entire site instead of the per-group realm in previous versions. To revert back to the old behavior, use

    $AuthRealmFmt = '$WikiTitle - $Group';

Version 0.6.14 (24-Mar-2004)

This version provides a minor bugfix to $WikiWordCountMax, and adds support for XLPage files to automatically load i18n-specific setup scripts (e.g., for alternate charsets).

Version 0.6.13 (20-Mar-2004)

This version updates the mailposts.php script to provide better
functionality. See PmWiki.MailPosts for details.

Version 0.6.11, 0.6.12 (20-Mar-2004)

These releases fix a bug in the %class% wiki style.

Version 0.6.10 (18-Mar-2004)

This release makes some minor changes:

• Fixes some bugs in the handling of --> (indent) and preformatted text markups.

• Changes PmWiki's default DOCTYPE to be XHTML 1.0 Transitional instead of HTML 4.01 Transitional.

• Adds the 'sit' and 'css' extensions to the set of allowed file uploads

• Fixes a minor annoying in setting $Needle and $SearchGroup in search.php.

• Changes $ScriptUrl to $PageUrl in the attributes form to work better on sites using mod_rewrite or aliasmatch code.

Version 0.6.8, 0.6.9 (3-Mar-2004)

This release cleans up a few documentation bugs and adds a few minor features.

• The variable $EnablePostAuthorRequired can be set to 1 to require that a user fill in a non-blank author field before saving changes to a page. To support this, the edit form now includes an $EditMessageFmt field where messages can be displayed to the user.

• The variables $DiffFunction and $PatchFunction can be used to specify alternate diff/patch functions for page history save/restore.

• Added font-family, font-style, font-weight, text-decoration, and class to WikiStyle declarations.

• Added preliminary support so that $PageFileFmt can be used to place pages into subdirectories of wiki.d and wikilib.d.

• Converted the page template code to be a callable function (LoadPageTemplate).

• Other bug fixes and minor changes are listed in the ChangeLog.

Version 0.6.7 (26-Feb-2004)

• This release fixes a (major) bug in the ?action=search routine that would always result in a blank page, introduced in 0.6.2.

• Templates now can have a <!--/Page...Fmt--> directive to mark the end of a section. Any (HTML) text that does not occur in a section will always be output.

• The main pmwiki.php now defines a 'PmWiki' constant that external scripts can use to insure they were called from pmwiki.php and not directly from the webserver.

Version 0.6.6 (26-Feb-2004)

• Minor bugfix to authorization code not working with arrays of default passwords.

Version 0.6.3 through Version 0.6.5 (25-Feb-2004)

• This version makes a slight modification to the template layout code; it now uses "<!--HeaderText-->" instead of "$HTMLHeaders" to mark script-defined headers in the <head>...</head> section of the HTML output. The position of <!--HeaderText--> determines where the $HTMLHeaderFmt array is added to the output. To help with upgrades and compatibility, this version of PmWiki automatically converts the string "$HTMLHeaders" in a template to be <!--HeaderText-->, but this behavior is deprecated and will likely be removed in a future version.

• Added the variable $PageLogoFmt to the default skin and tlayout.php to define the HTML code that should be used for the logo at the top of the page, to allow user-customizable headers.

• Moved the inclusions of 'PmWiki.EditQuickReference' into the definition of $PageEditFmt (previously it was included by $HandleEditFmt). This means that redefining $PageEditFmt removes the EditQuickReference unless it is explicitly included. To define an edit template that includes the quick reference, use

    $PageEditFmt = array('...your custom edit template...',
      'wiki:$[PmWiki.EditQuickReference]');

• Performed a similar modification for PmWiki.UploadQuickReference and $PageUploadFmt.

• pub/css/local.css, pub/css/$Group.css, and pub/css/$Group.$Title_.css are now included in $HTMLHeaderFmt by default for output by <!--HeaderText-->. The list of automatically included css files can be controlled via the $PageCSSListFmt array.

• This version adds the capability for a WikiAdministrator to customize the AsSpaced() function (used to space wiki words). Simply set $AsSpacedFunction to the name of your custom function for spacing wiki words (the default is 'AsSpaced').

• Fixed a bug with search.php generating an extra <div>.

• Added logic so that attempting to overwrite a page when the disk is full no longer loses the previous contents of the page.

Version 0.6.2 (23-Feb-2004)

• This version cleans up some warning messages that appear in PHP 5.

• This version also introduces [!--PageHeaderFmt--] syntax as an alternate for <!--PageHeaderFmt--> in templates.

Version 0.6.1 (22-Feb-2004)

• With huge and humble apologies to those who installed 0.6.0, I'm retracting the layout scheme that was introduced in 0.6.0 and replacing it with a new template-file based scheme. The new scheme is much easier to work with and understand. See PmWiki.LayoutBasics for the updated documentation, and look at the files in the pub/skins/pmwiki/ directory an example template. Note that this gets rid of the need to set numerous variables in config.php to create layouts.
  
  If you're using the 0.6.0 layout scheme and need to use it or assistance in converting to 0.6.1, email me at pmichaud@pobox.com and I'll be glad to help.

• Author names in the page history output now link to the corresponding profile page (if it exists).

• Variable documentation has been greatly improved--variable names in the wiki text now link to the corresponding variable definition page. More documentation will be forthcoming.

Version 0.6.0

This is the 0.6.0 release. WikiAdministrators should carefully read the notes below before upgrading from 0.5.x to 0.6, as many substantial changes have been incorporated into this release. PmWiki:Upgrade6Notes contains notes from others who are currently undergoing 0.5.x to 0.6 upgrades.

Major changes from version 0.5.27

• PmWiki 0.6 requires PHP version 4.1.0 or higher.

• Site-wide configurations should now be stored in local/config.php. The 0.5 local.php and local/local.php files continue to work, but may be removed in a future release.

• PmWiki's default page layout scheme has been changed substantially for 0.6. Sites can restore the old layout scheme by adding include_once("scripts/layout-0.5.php"); at the beginning of config.php.

• The $ScriptDir variable no longer exists (unless the layout-0.5.php script above is loaded), and has been replaced somewhat by $PubDirUrl. Sites that need $ScriptDir defined can explicitly set its value in local/config.php.

• A new directory (pub/) has been added for files that need to be accessed externally by browsers.

• The $WikiImg and $WikiImgUrl variables no longer exist (unless the layout-0.5.php script above is loaded). $WikiImg is replaced by $PageLayoutFmt['wikilogo'], and $WikiImgUrl is replaced by $PageLogoUrl.

• The characters |, `, and ^ are now excluded from URI paths by default.

• Generation of <p></p> tags has been greatly optimized, and can be changed entirely through the $HTMLVSpace variable.

• The new default stylesheet settings remove the browser-default margins around lists (<ul>, <ol>, <dl>) and preformatted text (<pre>).

• PmWiki automatically generates <meta> tags to prevent robots from indexing edit pages, page history, etc., as well as the pages in the PmWiki WikiGroup.

• The ISBN InterMap entry has been changed to reflect a new URI structure at the target site.

• Added a Cookbook: InterMap link.

• [=...=] links work more "naturally" around directives such as [[noheader]], [[nofooter]], etc.

• By default, the WikiWord "PmWiki" is only converted to a link the first time it appears (controlled by the setting of $WikiWordCount['PmWiki']).

• The notify.php and printable-page.php scripts have been removed from the distribution. Notify.php will appear in the Cookbook, printable-page.php is now print.php.

New features in PmWiki 0.6

• The default layout scheme has been significantly reworked to be more consistent with current web standards and to make it easier to use stylesheets and skins. It has built in support for sidebars and also makes it easier to switch from one layout skin to another. For more details, see LayoutBasics.

• PmWiki now has built-in support for tracking authorship of edits, and introduces a {{~name}} markup for referring to author profiles on the site. See PmWiki.AuthorTracking.

• PmWiki now has extensive support for internationalization (i18n), including accented characters in page titles and WikiWords. See PmWiki.Internationalizations.

• A new markup sequence has been defined for creating breaks in text; placing '\\' at the end of a line generates a <br> HTML tag. Adding more \'s at the end of the line increases the number of <br>s. The historic [[<<]] markup is still available to generate <br clear='all'> tags.

• A new markup sequence (->) has been defined for indented text. More hyphens produce larger indents.

• Many HTML tags now include appropriate CSS selectors.

• The page history (formerly "page revisions") feature has been substantially reworked. Page history output can now be fully internationalized, and includes options to hide minor edits and to display changes to the source markup instead of the rendered output. The output display is also largely controlled via stylesheets.

• InterMap links can now be parameterized so that the URI-text following the InterMap name can appear in the middle of a URI instead of at the end. See PmWiki.CustomInterMap.

• Search results can now be embedded in any wiki page. Furthermore, the WikiAdministrator can use $SearchExcludePatterns to exclude certain pages (e.g., RecentChanges) from appearing in the search results.

• The display and rendering of WikiWords can be greatly controlled:
  • $WikiWordPagePathFmt allows a WikiAdministrator to specify alternate pages to search for when encountering a bare WikiWord. By default it will look for a WikiWord link in the same group, then in a group with the same name as the WikiWord.
  • $WikiWordCountMax allows a WikiAdministrator to specify the maximum number of times WikiWords should be converted to links within a page. $WikiWordCount[] allows this number to be determined on a per-WikiWord basis.
  • $WikiWordReplaceFmt[] allows a WikiAdministrator to specify the replacement text to be used for specific WikiWords.

• WikiGroup names can now be specified as part of FreeLinks, thus the markup {{PmWiki/free links}} refers to PmWiki.FreeLinks and displays as free links.

• Printable view functionality is included by default. It can be customized via stylesheets and the $PrintSkin variable.

• Setting $SpaceWikiWords=2 selects a different form of WikiWord spacing.

• Greatly improved the contents and structure of sample-config.php, and moved it to the base pmwiki directory.