doc/index.mdwn

   1 [[Ikiwiki]] is a wiki compiler. It converts a directory full of wiki pages
   2 into html pages suitable for publishing on a website. Unlike a traditional
   3 wiki, ikiwiki does not have its own means of storing page history, its own
   4 markup language, or support for editing pages online.
   5
   6 To use [[ikiwiki]] to set up a wiki, you will probably want to use it with a
   7 revision control system, such as [[Subversion]], for keeping track of past
   8 versions of pages. ikiwiki can run as a Subversion post-commit hook, so
   9 that each committed change to your wiki is immediatly compiled and
  10 published. (It can also be run by hand, by cron, or integrated with any
  11 other revision control system.)
  12
  13 [[Subversion]] also offers a way to let others edit pages on your wiki.
  14 Just configure subversion to let appropriate users (or everyone) commit to
  15 the wiki's repository. There are some things you should keep in mind about
  16 [[Security]] when allowing the world to edit your ikiwiki.
  17
  18 ikiwiki supports pages using [[MarkDown]] as their markup language. Any
  19 page with a filename ending in ".mdwn" is converted from markdown to html
  20 by ikiwiki. Markdown understands text formatted as it would be in an email,
  21 and is quite smart about converting it to html. The only additional markup
  22 provided by ikiwiki aside from regular markdown is the [[WikiLink]].
  23
  24 ikiwiki also supports files of any other type, including raw html, text,
  25 images, etc. These are not converted to wiki pages, they are just copied
  26 unchanged by ikiwiki as it builds your wiki. So you can check in an image,
  27 program, or other special file and link to it from your wiki pages.
  28 ikiwiki also supports making one page that is a [[SubPage]] of another.
  29
  30 [[TODO]] lists things that need to be added to ikiwiki before most people
  31 would consider it a full-fledged wiki.
  32
  33 All wikis are supposed to have a [[SandBox]], so this one does to.
  34 If you'd like to try editing pages on this wiki, do whatever you'd like in
  35
  36 [[ikiwiki]] is developed by JoeyHess.