]> sipb.mit.edu Git - ikiwiki.git/blob - doc/tips/switching_to_usedirs.mdwn
* Support pagespec "functions" with no parameters, like included() in the
[ikiwiki.git] / doc / tips / switching_to_usedirs.mdwn
1 As of version 2.0, ikiwiki will switch to enabling the 'usedirs' setting by
2 default. This *will* break all URLs to wikis that did not have 'usedirs'
3 turned on before. You can either follow this procedure to convert your wiki
4 to usedirs, or edit your setup file and turn usedirs back off.
5
6 * Upgrade ikiwiki to 2.0.
7 * Force ikiwiki to rebuild your wiki, by using `ikiwiki-mass-rebuild`,
8   or manually.
9 * Since usedirs is enabled, ikiwiki will have created a bunch of new
10   html files. Where before ikiwiki generated a `dest/foo.html`, now it will
11   generate `dest/foo/index.html`. But, the old html files will still be
12   present too. Remove them:
13         find dest -name \*.html -not -name index.html -exec rm {} \;
14 * If you have a blog that is aggregated on a Planet or similar, all the
15   items in the RSS or atom feed will seem like new posts, since their URLs
16   have changed. See [[howto_avoid_flooding_aggregators]] for a workaround.
17 * Now all the URLs to pages in your wiki have changed. See
18   [[redirections_for_usedirs]] for instructions on setting up redirections
19   to keep the old URLs working.