This page is intended to describe features of PmWiki 1.0 that have been changed or eliminated in PmWiki 2.0. For now this page will be maintained a simple list and will probably need some restructuring later.
Markup changes
- Double brackets are used for all links, including
[[free links]]. Providing alternate text for a link is performed using either a vertical brace [[PageName | link text]] or an arrow [[link text -> PageName]]. See http://www.pmwiki.org/pmwiki2/pmwiki.php/PmWiki/LinkSyntax.
- So far, the
ThisPage:, ThisGroup:, etc., Inter Map shortcuts are not defined. In fact, they may not be needed in PmWiki 2. If someone needs them, add an entry to PITS:NewIssue explaining why.
Ok, so as an example, how next lines, which are in a sidebar, may be written in pmwiki2 ?
*[[ThisPage:?action=upload Upload]]
*[[ThisGroup:SideBar&action=edit Edit menu]]
You can write them as [[{$Name}?action=upload | Upload]] and [[{$Group}/SideBar?action=edit | Edit menu]].
Changes affecting skins
- $Page Template Fmt? is now $Page Skins Fmt?. But $Page Template Fmt? still works, and this may change yet again before the 2.0 official release.
- $HTML Title Fmt? no longer exists — just place the <title> information directly into the template.
- In $…Fmt strings, $Title_ and $Title are currently represented by $Name. $Title is now used to refer to a page’s title (which may be different from its name and could have different formatting, such as spaces).
- The css/stdlayout.css file no longer exists; PmWiki and other modules now place required formatting styles directly into the $HTML Styles Fmt? array.
- $Page Name? is now $Full Name?. $Page Name? still functions but will be removed in the 2.0 official release.
Other customization changes
- PmWiki 2 now uses session-based authentication by default. If you want to continue to use HTTP-Basic authentication, add the following line to config.php:
include_once(‘scripts/httpauth.php’);
- Disabling Wiki Words is now done by setting $Link Wiki Words? . Previously this was controlled by $Wiki Word Count Max? .
- $HTML Line Break? is now $HTMLP Newline?. See Cookbook:LineBreaks.
- The skins system has been revised, and is now much more flexibily controlled by the $Skin and $Action Skins? variables. See PmWiki.Layout Basics. But $Page Template Fmt? still works.
- The $Browse Replacements?, $Double Brackets?, and $Inline Replacements? arrays are no longer used — see custom markup.
?action=post no longer exists — posting a new page is now performed by using ?action=edit with the post control set to a true value.
- $Wiki Word Page Path Fmt? is now $Page Path Fmt?, which is applied to all page links not qualified by a group.
- $Wiki Page Exists Fmt?, $Wiki Page Create Fmt?, etc. are now $Link Page Exists Fmt?, $Link Page Create Fmt?, etc.
- $Delete Key Word? is now $Delete Key Pattern?.
- $Group Header Fmt? and $Group Footer Fmt? now specify the markup to be added to the beginning and end of each page, rather than the name of the page. The default settings of $Group Header Fmt? and $Group Footer Fmt? perform the equivalent of an
(:include:) of the Group Header and GroupFooter pages.
- The css/stdlayout.css file no longer exists; PmWiki now places any required formatting styles directly into the $HTML Styles Fmt? array.
- PmWiki’s ReadPage() function no longer supplies default text for non-existent pages — this is now decided by whatever functions need the page. (As of 2.0.devel9 the default text is still stored in $Default Page Text Fmt?, however.)
- $Search Exclude Patterns? is now simply $Search Patterns? and can be chosen by the
list= parameter to (:searchresults:) and (:pagelist:). See Cookbook:SearchResults.
- $Enable Per Group Cust? is now $Enable PG Cust?.