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]]
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. <div class='vspace'></div></li><li>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). <div class='vspace'></div></li><li>The <em>css/stdlayout.css</em> file no longer exists; <span class='wikiword'>PmWiki</span> and other modules now place required formatting styles directly into the <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LayoutVariables#HTMLStylesFmt'><code class='varlink'>$HTMLStylesFmt</code></a> array. <div class='vspace'></div></li><li>$PageName is now $FullName. $PageName still functions but will be removed in the 2.0 official release. <div class='vspace'></div></li><li>Searching now uses the <code class='escaped'>q=</code> variable to provide the text to be searched (formerly the search text went in the <code class='escaped'>text=</code> variable. </li></ul><div class='vspace'></div><h2>Other Customization Changes</h2> <ul><li><span class='wikiword'>PmWiki</span> 2 now uses session-based authentication by default. If you want to continue to use HTTP-Basic authentication, add the following line to <em>config.php</em>: </li></ul><pre> include_once('scripts/httpauth.php'); </pre><div class='vspace'></div><ul><li>Disabling <span class='wikiword'>WikiWords</span> is now done by setting <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/BasicVariables#LinkWikiWords'><code class='varlink'>$LinkWikiWords</code></a> . Previously this was controlled by <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LinkVariables#WikiWordCountMax'><code class='varlink'>$WikiWordCountMax</code></a> . <div class='vspace'></div></li><li>$HTMLLineBreak is now $HTMLPNewline. See <a class='urllink' href='http://www.pmwiki.org/wiki/Cookbook/Line%20Breaks' rel='nofollow'>Cookbook:Line Breaks</a>. <div class='vspace'></div></li><li>The skins system has been revised, and is now much more flexibly controlled by the $Skin and $ActionSkins variables. See <a class='wikilink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/Skins'>PmWiki.Skins</a>. But $PageTemplateFmt still works. <div class='vspace'></div></li><li>The $BrowseReplacements, $DoubleBrackets, and $InlineReplacements arrays are no longer used -- see <a class='wikilink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/CustomMarkup'>custom markup</a>. <div class='vspace'></div></li><li><code class='escaped'>?action=post</code> no longer exists -- posting a new page is now performed by using <code class='escaped'>?action=edit</code> with the <code class='escaped'>post</code> control set to a true value. <div class='vspace'></div></li><li>$WikiWordPagePathFmt is now <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LinkVariables#PagePathFmt'><code class='varlink'>$PagePathFmt</code></a>, which is applied to all page links not qualified by a group. <div class='vspace'></div></li><li>$WikiPageExistsFmt, $WikiPageCreateFmt, etc. are now <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LinkVariables#LinkPageExistsFmt'><code class='varlink'>$LinkPageExistsFmt</code></a>, <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LinkVariables#LinkPageCreateFmt'><code class='varlink'>$LinkPageCreateFmt</code></a>, etc. <div class='vspace'></div></li><li>$DeleteKeyWord is now <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/EditVariables#DeleteKeyPattern'><code class='varlink'>$DeleteKeyPattern</code></a>. <div class='vspace'></div></li><li><a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LayoutVariables#GroupHeaderFmt'><code class='varlink'>$GroupHeaderFmt</code></a> and <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LayoutVariables#GroupFooterFmt'><code class='varlink'>$GroupFooterFmt</code></a> now specify the <em>markup</em> to be added to the beginning and end of each page, rather than the name of the page. The default settings of <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LayoutVariables#GroupHeaderFmt'><code class='varlink'>$GroupHeaderFmt</code></a> and <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LayoutVariables#GroupFooterFmt'><code class='varlink'>$GroupFooterFmt</code></a> perform the equivalent of an <code class='escaped'>(:include:)</code> of the <span class='wikiword'>GroupHeader</span> and GroupFooter pages. <div class='vspace'></div></li><li><span class='wikiword'>PmWiki</span>'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 <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/EditVariables#DefaultPageTextFmt'><code class='varlink'>$DefaultPageTextFmt</code></a>, however.) <div class='vspace'></div></li><li>$SearchExcludePatterns is now simply <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/PagelistVariables#SearchPatterns'><code class='varlink'>$SearchPatterns</code></a> and can be chosen by the <code class='escaped'>list=</code> parameter to <code class='escaped'>(:searchresults:)</code> and <code class='escaped'>(:pagelist:)</code>. See <a class='urllink' href='http://www.pmwiki.org/wiki/Cookbook/SearchResults' rel='nofollow'>Cookbook:SearchResults</a>. <div class='vspace'></div></li><li>$EnablePerGroupCust is now <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/BasicVariables#EnablePGCust'><code class='varlink'>$EnablePGCust</code></a>. <div class='vspace'></div></li><li>$TableCellAttr is now <a class='varlink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/LayoutVariables#TableCellAttrFmt'><code class='varlink'>$TableCellAttrFmt</code></a>. <div class='vspace'></div></li><li>$Url is now $LinkUrl. </li></ul><p class='vspace' style='background-color: #eee;'><span class='wikitrail'><< <a class='wikilink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/PageFileFormat'>Page file format</a> | <a class='wikilink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/DocumentationIndex'>PmWiki.Documentation Index</a> | <a class='wikilink' href='http://recherche.ircam.fr/equipes/analyse-synthese/lanchant/index.php/PmWiki/UpgradingFromPmWiki1'>Upgrading from PmWiki 1</a> >></span> </p> </div> <!--PageFooterFmt--> <div id='footer'></div> <!--/PageFooterFmt--> </div> <div class='clearfix'></div> </div> <div class='clearfix'></div> </div> <div class='clearfix'></div> </body> </html>