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]]=] ->%Pm font-style=normal% You can write them as [@[[{$Name}?action=upload | Upload]]@] and [@[[{$Group}/SideBar?action=edit | Edit menu]]@]. ->(The variables [={$Name}=] and [={$Group}=] are [[page variables]].) !!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 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. %trail%<<|[[PmWiki.Documentation Index]]|>>