ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / tips / ikiwiki_via_gopher.mdwn
1 Remember gopher? Ikiwiki can be served up by this venerable protocol.
2
3 It's pretty simple to get it going. Just install pygopherd or another gopher
4 server, and have ikiwiki put its pages where that server expects. For
5 pygopherd, it was in `/var/gopher`.
6
7 When building the wiki, make sure to specify --no-usedirs (or equivilant in
8 the setup file). Gopher doesn't convert "foo/" links into
9 "foo/index.html", so usedirs won't work well with it; if usedirs is
10 disabled, browsing through the wiki via gopher will work just fine.
11
12 Since AFAIK gopher has no equivilant to CGI, you'll need to keep a
13 web server around for editing pages. If you do set up a cgi, make sure to
14 configure `url` to something like `gopher://hostname/h/`, so that it
15 links back properly to gopherspace from the CGI.
16
17 One unresolved problem: Style sheets are not loaded. The urls seem ok, but
18 pygopherd seems to serve them in a form that doesn't work somehow. I have
19 not invesitaged more, because a fully unstyled web page fits the retro
20 gopher better anyhow.
21
22 --[[Joey]]