turn this into a tip

diff --git a/doc/tips.mdwn b/doc/tips.mdwn
index 77eeffb4950ffc0b69b6c0a38ea80969fc0a1a41..c5faa45b391040b112d3765558127eb63ddd322f 100644 (file)
--- a/doc/tips.mdwn
+++ b/doc/tips.mdwn
@@ -1,5 +1,7 @@
 This page is a place to document tips and techniques for using ikiwiki.
 
+[[toc ]]
+
 ## wikiannounce
 
 One thing I use ikiwiki for is the web pages for software projects I
@@ -33,3 +35,8 @@ access. --[[JoshTriplett]]
 [[This_article|issue_tracking]] has some thoughts and tips on using ikiwiki
 as a BTS, as is done on this very wiki to track [[bugs]] and [[todo]] items
 for ikiwiki.
+
+## redirections for usedirs
+
+Want to turn on the `usedirs` setting on an existing wiki without breaking
+all the links into it? Here's [[how|usedirs_redirections]].

diff --git a/doc/tips/usedirs_redirections.mdwn b/doc/tips/usedirs_redirections.mdwn
new file mode 100644 (file)
index 0000000..ef356a0
--- /dev/null
+++ b/doc/tips/usedirs_redirections.mdwn
@@ -0,0 +1,22 @@
+Want to turn on the `usedirs` setting on an existing wiki without breaking
+all the links into it? Here's a way to do it for Apache, using the
+RewriteEngine. This example is for a wiki at the top of a web site, but can
+be adapted to other situations.
+
+       # pages
+       RewriteCond $1 !^/~             # these pages
+       RewriteCond $1 !^/doc/          # are not part of
+       RewriteCond $1 !^/ajaxterm      # the wiki, so
+       RewriteCond $1 !^/cgi-bin/      # don't rewrite them
+       RewriteCond $1 !.*/index$
+       RewriteRule (.+).html $1/ [R]
+       
+       # rss feeds
+       RewriteCond $1 !^/~
+       RewriteCond $1 !.*/index$
+       RewriteRule (.+).rss $1/index.rss
+       
+       # atom feeds
+       RewriteCond $1 !^/~
+       RewriteCond $1 !.*/index$
+       RewriteRule (.+).atom $1/index.atom

diff --git a/doc/todo/Document_redirections_for_use_with_usedirs.mdwn b/doc/todo/Document_redirections_for_use_with_usedirs.mdwn
deleted file mode 100644 (file)
index 2ed4c68..0000000
--- a/doc/todo/Document_redirections_for_use_with_usedirs.mdwn
+++ /dev/null
@@ -1,29 +0,0 @@
-Now that ikiwiki supports using page/index.html rather than page.html, how about some mechanism to automatically generate a .htaccess file with "Redirect permanent" lines for each such page?
-
-> I was thinking of using an apache RewriteRule for this, haven't written
-> one yet though. --[[Joey]]
-
-> Here's a RewriteRule that I'm using for <http://kitenet.net/>, which
-> has an wiki at the top level that's using index.htmls, and some
-> other stuff that shouldn't be rewritten.
-
-       RewriteCond $1 !^/~
-       RewriteCond $1 !^/doc/
-       RewriteCond $1 !^/ajaxterm
-       RewriteCond $1 !^/cgi-bin/
-       RewriteCond $1 !.*/index$
-       RewriteRule (.+).html $1/ [R]
-       
-       RewriteCond $1 !^/~
-       RewriteCond $1 !.*/index$
-       RewriteRule (.+).rss $1/index.rss
-       
-       RewriteCond $1 !^/~
-       RewriteCond $1 !.*/index$
-       RewriteRule (.+).atom $1/index.atom
-
->> Nice solution.  I think this would work for a newly-converted wiki as well,
->> using a condition to limit rewrites to that wiki's directory, and the
->> rewrite rule you propose.  Thus, autogenerating seems unnecessary; we
->> should just have a documented, known-working RewriteCond and RewriteRule
->> for wikis that want to turn on the `usedirs` option.  --[[JoshTriplett]]