From 6af5bf82902dc31491da50c3e836f03ec1073e48 Mon Sep 17 00:00:00 2001 From: joey Date: Tue, 9 Oct 2007 10:57:11 +0000 Subject: [PATCH] web commit by http://madduck.myopenid.com/: add info on advantages and disadvantages of usedirs --- doc/tips/switching_to_usedirs.mdwn | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/tips/switching_to_usedirs.mdwn b/doc/tips/switching_to_usedirs.mdwn index d2fed6dda..183ce00ac 100644 --- a/doc/tips/switching_to_usedirs.mdwn +++ b/doc/tips/switching_to_usedirs.mdwn @@ -17,3 +17,14 @@ to usedirs, or edit your setup file and turn usedirs back off. * 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. + +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](http://microformats.org/wiki/rel-tag). + +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. -- 2.45.0