X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/b9dc3e84a512eecf66b2b3e73be39530b588f49c..2cab8880ad61f9d134b56c5eed952c1a48f4ea8a:/doc/tips/switching_to_usedirs/discussion.mdwn?ds=sidebyside

diff --git a/doc/tips/switching_to_usedirs/discussion.mdwn b/doc/tips/switching_to_usedirs/discussion.mdwn
index 3a9487c42..fe937c5dd 100644
--- a/doc/tips/switching_to_usedirs/discussion.mdwn
+++ b/doc/tips/switching_to_usedirs/discussion.mdwn
@@ -18,4 +18,21 @@ This may serve only to highlight my naivete, but what are the advantages of the
 
 It seems to me that the only advantage is slightly tidier URLs, but with the disadvantage that source files change dir level and relative links need to change too.
 
--- [[KarlMW]]
\ No newline at end of file
+-- [[KarlMW]]
+
+The cleaner urls seem worth it to me. The `urlto()` function makes it easy
+for ikiwiki code to deal with the path changes. --[[Joey]]
+
+--------
+
+when migrating to usedirs, the following apache config sniplet might be useful (use inside the Directory section that manages your wiki):
+
+    RewriteEngine on
+    RewriteCond %{REQUEST_FILENAME} !-f
+    RewriteRule ^(.+)\.html$ /my_base_path/$1/ [R]
+
+that sniplet causes redirects from any non-existing .html file to the respective usedirs directory. (when serving from the host root url, drop the my_base_path part, otherwise adapt it to your needs).
+
+i recommend using this or a similar mechanism to keep your old urls reachable.
+
+--[[chrysn]]