<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>switching to usedirs</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>/ <a href="../tips.html">tips</a>/ </span> <span class="title"> switching to usedirs </span> </span> </div> </div> <div id="pagebody"> <div id="content" role="main"> <p>As of version 2.0, ikiwiki will switch to enabling the 'usedirs' setting by default. This <em>will</em> break all URLs to wikis that did not have 'usedirs' turned on before. You can either follow this procedure to convert your wiki to usedirs, or edit your setup file and turn usedirs back off.</p> <ul> <li>Upgrade ikiwiki to 2.0.</li> <li>Force ikiwiki to rebuild your wiki, by using <code>ikiwiki-mass-rebuild</code>, or manually.</li> <li>Since usedirs is enabled, ikiwiki will have created a bunch of new html files. Where before ikiwiki generated a <code>dest/foo.html</code>, now it will generate <code>dest/foo/index.html</code>. The old html files will be removed.</li> <li>If you have a blog that is aggregated on a Planet or similar, all the items in the RSS or atom feed will seem like new posts, since their URLs have changed. See <a href="./howto_avoid_flooding_aggregators.html">howto avoid flooding aggregators</a> for a workaround.</li> <li>Now all the URLs to pages in your wiki have changed. See <a href="./redirections_for_usedirs.html">redirections for usedirs</a> for instructions on setting up redirections to keep the old URLs working.</li> </ul> <h2>Why usedirs?</h2> <p>There are several advantages to <code>usedirs</code>, including simpler URLs, URLs that aren't dependent on the underlying implementation (<code>.html</code>), and being able to use URLs as tags as described in the <a href="http://microformats.org/wiki/rel-tag">rel-tag microformat</a>.</p> <p>The main disadvantage is that it is harder to browse using <code>file://</code> URIs, since <code>file:///dir/</code> doesn't automatically translate to <code>dir/index.html</code>. This is something one could fix in the browser though.</p> </div> </div> <div id="footer" class="pagefooter" role="contentinfo"> <div id="pageinfo"> <div id="backlinks"> Links: <a href="../news/ikiwiki_version_2.0.html">news/ikiwiki version 2.0</a> </div> <div class="pagedate"> Last edited <span class="date">Tue Feb 26 23:01:54 2019</span> <!-- Created <span class="date">Sun Apr 29 22:48:35 2007</span> --> </div> </div> <!-- from ikiwiki --> </div> </div> </body> </html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
d8544620e4ac7bee48ddb48c85d55709
>
files
>
588
