summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-04-29 22:48:35 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-04-29 22:48:35 +0000
commit67631c51ab971aa272b9b1230d2fe469d77091ee (patch)
tree2a8142fa0f30626589a0ae480f7f58c0d86c5767
parentfa6852bb7c6d8054bccc90f5095fcefe85052080 (diff)
add
-rw-r--r--doc/tips/switching_to_usedirs.mdwn19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/tips/switching_to_usedirs.mdwn b/doc/tips/switching_to_usedirs.mdwn
new file mode 100644
index 000000000..d2fed6dda
--- /dev/null
+++ b/doc/tips/switching_to_usedirs.mdwn
@@ -0,0 +1,19 @@
+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.
+
+* Upgrade ikiwiki to 2.0.
+* Force ikiwiki to rebuild your wiki, by using `ikiwiki-mass-rebuild`,
+ or manually.
+* Since usedirs is enabled, ikiwiki will have created a bunch of new
+ html files. Where before ikiwiki generated a `dest/foo.html`, now it will
+ generate `dest/foo/index.html`. But, the old html files will still be
+ present too. Remove them:
+ find dest -name \*.html -not -name index.html -exec rm {} \;
+* 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 [[howto_avoid_flooding_aggregators]] for a workaround.
+* Now all the URLs to pages in your wiki have changed. See
+ [[redirections_for_usedirs]] for instructions on setting up redirections
+ to keep the old URLs working.