doc/tips.mdwn

   1 This page is a place to document tips and techniques for using ikiwiki.
   2
   3 [[toc ]]
   4
   5 ## wikiannounce
   6
   7 One thing I use ikiwiki for is the web pages for software projects I
   8 maintain. Each of my projects has a news page with an announcements feed,
   9 and to automatically update this when I release a new version, generating
  10 an announcement from the debian/changelog and debian/NEWS files, I use a
  11 [wikiannounce](http://svn.kitenet.net/trunk/bin/wikiannounce) program. It's
  12 somewhat specific to dealing with Debian packages, and uses a special
  13 `announcedir` target in debian/rules, but the general idea could be useful.
  14 --[[Joey]]
  15
  16 ## blog script
  17
  18 I should mention that I also have a
  19 [blog](http://svn.kitenet.net/trunk/bin/blog) program that I use to
  20 write blog posts in a text editor. The first line I enter is used as the
  21 title, and it automatically comes up with a unique page name based on the
  22 title and handles all the details of posting to my blog. --[[Joey]]
  23
  24 ## using the web interface with a real text editor
  25
  26 If you use Firefox or Iceweasel, the [It's All
  27 Text](https://addons.mozilla.org/en-US/firefox/addon/4125) extension allows
  28 you to use a real text editor like Emacs or Vim to edit the contents of text
  29 areas.  This allows you to edit ikiwiki pages with a real text editor through
  30 the ikiwiki web interface, rather than only with direct commit
  31 access. --[[JoshTriplett]]
  32
  33 ## using ikiwiki as an issue tracker
  34
  35 [[This_article|issue_tracking]] has some thoughts and tips on using ikiwiki
  36 as a BTS, as is done on this very wiki to track [[bugs]] and [[todo]] items
  37 for ikiwiki.
  38
  39 ## redirections for usedirs
  40
  41 Want to turn on the `usedirs` setting on an existing wiki without breaking
  42 all the links into it? Here's [[how|usedirs_redirections]].