ikiwiki/ tips/ switching to usedirs

As of version 2.0, ikiwiki will switch to enabling the 'usedirs' setting by default. This will 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.

Why usedirs?

There are several advantages to usedirs, including simpler URLs, URLs that aren't dependent on the underlying implementation (.html), and being able to use URLs as tags as described in the rel-tag microformat.

The main disadvantage is that it is harder to browse using file:// URIs, since file:///dir/ doesn't automatically translate to dir/index.html. This is something one could fix in the browser though.