<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>ikiwiki-transition</title> <meta name="viewport" content="width=device-width, initial-scale=1" /> <link rel="stylesheet" href="style.css" type="text/css" /> <link rel="stylesheet" href="local.css" type="text/css" /> </head> <body> <div class="page"> <div class="pageheader"> <div class="header"> <span> <span class="parentlinks"> <a href="./index.html">ikiwiki</a>/ </span> <span class="title"> ikiwiki-transition </span> </span> </div> </div> <div id="pagebody"> <div id="content" role="main"> <h1>NAME</h1> <p>ikiwiki-transition - transition ikiwiki pages to new syntaxes, etc</p> <h1>SYNOPSIS</h1> <p>ikiwiki-transition type ...</p> <h1>DESCRIPTION</h1> <p><code>ikiwiki-transition</code> aids in converting wiki pages when there's a major change in ikiwiki syntax. It also handles other transitions not involving wiki pages.</p> <h1>prefix_directives your.setup</h1> <p>The <code>prefix_directives</code> mode converts all pages from the old preprocessor directive syntax, requiring a space, to the new syntax, prefixed by '!'.</p> <p>Preprocessor directives which already use the new syntax will remain unchanged.</p> <p>Note that if a page contains wiki links with spaces, which some older versions of ikiwiki accepted, the prefix_directives transition will treat these as preprocessor directives and convert them.</p> <h1>setupformat your.setup</h1> <p>The <code>setupformat</code> mode converts a setup file from using a single <code>wrappers</code> block to using <code>cgi_wrapper</code>, <code>git_wrapper</code>, etc.</p> <p>Note that all comments and any unusual stuff like perl code in the setup file will be lost, as it is entirely rewritten by the transition.</p> <h1>aggregateinternal your.setup</h1> <p>The <code>aggregateinternal</code> mode moves pages aggregated by the aggregate plugin so that the <code>aggregateinternal</code> option can be enabled.</p> <h1>moveprefs your.setup</h1> <p>Moves values that used to be admin preferences into the setup file.</p> <p>Note that all comments and any unusual stuff like perl code in the setup file will be lost, as it is entirely rewritten by the move.</p> <h1>indexdb your.setup|srcdir</h1> <p>The <code>indexdb</code> mode handles converting a plain text <code>.ikiwiki/index</code> file to a binary <code>.ikiwiki/indexdb</code>. You do not normally need to run <code>ikiwiki-transition indexdb</code>; ikiwiki will automatically run it as necessary.</p> <h1>hashpassword your.setup|srcdir</h1> <p>The <code>hashpassword</code> mode forces any plaintext passwords stored in the <code>.ikiwiki/userdb</code> file to be replaced with password hashes. (The Authen::Passphrase perl module is needed to do this.)</p> <p>If this is not done explicitly, a user's plaintext password will be automatically converted to a hash when a user logs in for the first time after upgrade to ikiwiki 2.48.</p> <h1>deduplinks your.setup</h1> <p>In the past, bugs in ikiwiki have allowed duplicate link information to be stored in its indexdb. This mode removes such duplicate information, which may speed up wikis afflicted by it. Note that rebuilding the wiki will have the same effect.</p> <h1>AUTHOR</h1> <p>Josh Triplett <a href="mailto:josh@freedesktop.org">josh@freedesktop.org</a>, Joey Hess <a href="mailto:joey@ikiwiki.info">joey@ikiwiki.info</a></p> <p>Warning: this page is automatically made into ikiwiki-transition's man page, edit with care</p> </div> </div> <div id="footer" class="pagefooter" role="contentinfo"> <div id="pageinfo"> <div id="backlinks"> Links: <a href="./roadmap.html">roadmap</a> <a href="./tips/upgrade_to_3.0.html">tips/upgrade to 3.0</a> <a href="./usage.html">usage</a> </div> <div class="pagedate"> Last edited <span class="date">Tue Feb 26 23:01:54 2019</span> <!-- Created <span class="date">Tue Feb 26 23:01:54 2019</span> --> </div> </div> <!-- from ikiwiki --> </div> </div> </body> </html>