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; PmWiki and other modules now place required formatting styles directly into the <a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.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>PmWiki 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 WikiWords is now done by setting <a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/BasicVariables#LinkWikiWords'><code class='varlink'>$LinkWikiWords</code></a> . Previously this was controlled by <a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/LinkVariables#LinkPageExistsFmt'><code class='varlink'>$LinkPageExistsFmt</code></a>, <a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/EditVariables#DeleteKeyPattern'><code class='varlink'>$DeleteKeyPattern</code></a>. <div class='vspace'></div></li><li><a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/LayoutVariables#GroupHeaderFmt'><code class='varlink'>$GroupHeaderFmt</code></a> and <a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/LayoutVariables#GroupHeaderFmt'><code class='varlink'>$GroupHeaderFmt</code></a> and <a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/LayoutVariables#GroupFooterFmt'><code class='varlink'>$GroupFooterFmt</code></a> perform the equivalent of an <code class='escaped'>(:include:)</code> of the GroupHeader and GroupFooter pages. <div class='vspace'></div></li><li>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 <a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/BasicVariables#EnablePGCust'><code class='varlink'>$EnablePGCust</code></a>. <div class='vspace'></div></li><li>$TableCellAttr is now <a class='varlink' href='http://xyinteraction.free.fr/wiki/pmwiki.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://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/PageFileFormat'>Page file format</a> | <a class='wikilink' href='http://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/DocumentationIndex'>PmWiki.Documentation Index</a> | <a class='wikilink' href='http://xyinteraction.free.fr/wiki/pmwiki.php/PmWiki/UpgradingFromPmWiki1'>Upgrading from PmWiki 1</a> >></span> <a name='trailstart' id='trailstart'></a> <a name='trailend' id='trailend'></a> <br clear='all' /> </p><div style='background-color: #ffe; border-top: 1px solid black; font-size: .8em;' > <p>This page may have <span class='commentout-pmwikiorg'> a more recent version on <a class='urllink' href='http://www.pmwiki.org' rel='nofollow'>pmwiki.org</a>: <a class='urllink' href='http://www.pmwiki.org/wiki/PmWiki/ChangesFromPmWiki1' rel='nofollow'>PmWiki:ChangesFromPmWiki1</a>, and </span> a talk page: <a class='urllink' href='http://www.pmwiki.org/wiki/PmWiki/ChangesFromPmWiki1-Talk' rel='nofollow'>PmWiki:ChangesFromPmWiki1-Talk</a>. </p></div> </div> </div> <div id="sidebar"> <!--PageSearchFmt--> <form id="searchform" action='http://xyinteraction.free.fr/wiki/pmwiki.php' method="post"> <input class="hidden" type='hidden' name='n' value='PmWiki.ChangesFromPmWiki1' /> <input class="hidden" type='hidden' name='action' value='search' /> <input id="searchfield" type='text' name='q' value='' /> <input id="searchbutton" type='submit' name="searchbutton" value='Search' /> </form> <!--/PageSearchFmt--> <!--PageRightFmt--> <p class='vspace'><br /> </p> <!--/PageRightFmt--> </div> <div id="footer"> <!--PageFooterFmt--> <p>Cette page a été modifiée le 21 Février 2008 </p> <!--/PageFooterFmt--> <hr class="clear" /> </div> </div> <div id="credits"> <div class="alignright"> Powered by <a href="http://pmwiki.com/wiki/PmWiki/ChangeLog">pmwiki-2.2.10</a> </div> </div> </body> </html>