PmWiki: Changes from PmWiki 1

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 as 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 PmWiki.Links.

• So far, the ThisPage:, ThisGroup:, etc., InterMap 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]]

Changes affecting skins

• $PageTemplateFmt is obsolete, but $PageTemplateFmt still works, and this may change yet again before the 2.0 official release. To use a different skin, you can use the $Skin variable ($Skin = ‘skinname’;) and just fill it with the name of the skin, it will assume it’s in the pub/skins/[skinname] folder containing the [skinname].tmpl file.

• $HTMLTitleFmt 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 $HTMLStylesFmt array.

• $PageName is now $FullName. $PageName still functions but will be removed in the 2.0 official release.

• Searching now uses the q= variable to provide the text to be searched (formerly the search text went in the text= variable.

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 WikiWords is now done by setting $LinkWikiWords . Previously this was controlled by $WikiWordCountMax .

• $HTMLLineBreak is now $HTMLPNewline. See Cookbook:Line Breaks.

• The skins system has been revised, and is now much more flexibly controlled by the $Skin and $ActionSkins variables. See PmWiki.Skins. But $PageTemplateFmt still works.

• The $BrowseReplacements, $DoubleBrackets, and $InlineReplacements 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.

• $WikiWordPagePathFmt is now $PagePathFmt, which is applied to all page links not qualified by a group.

• $WikiPageExistsFmt, $WikiPageCreateFmt, etc. are now $LinkPageExistsFmt, $LinkPageCreateFmt, etc.

• $DeleteKeyWord is now $DeleteKeyPattern.

• $GroupHeaderFmt and $GroupFooterFmt 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 $GroupHeaderFmt and $GroupFooterFmt perform the equivalent of an (:include:) of the GroupHeader and GroupFooter pages.

• 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 $DefaultPageTextFmt, however.)

• $SearchExcludePatterns is now simply $SearchPatterns and can be chosen by the list= parameter to (:searchresults:) and (:pagelist:). See Cookbook:SearchResults.

• $EnablePerGroupCust is now $EnablePGCust.

• $TableCellAttr is now $TableCellAttrFmt.

• $Url is now $LinkUrl.

PmWiki.Documentation Index

Copyright © 2005–2025 the Main wiki and its authors