iKiBiKi/ blog/ 2007/ 07/ 10/ Setting up ikiwiki

Summary of my setup

  1. Install ikiwiki

  2. Choose a hierarchy for the blog entries. It is blog/$year/$month/$day/$title.mdwn right now, and tags are stored under tags/.

  3. Enable some plugins. Currently:

    • sidebar: integrate a menu bar on each page;

    • tag: ease the creation of tags and links;

    • pagestats: needed to generate automatically the list of the tags;

    • prettydate: specify a string format for the Posted/Last edited dates;

    • shortcut: enable many interesting shortcuts like [[debbug NNNNNN]] or [[debpkg package]].

  4. Create some placeholders:

    • index.mdwn;
    • tags.mdwn;
    • tags/*.mdwn (one for each tag),

  5. Write a configuration file: ikiwiki.setup, enabling these plugins, and containing some basic information like origin and target directories.

  6. To do:

    • learn the syntax for real;
    • automate the creation of index.mdwn placeholders under blog/$year, blog/$year/$month, and so on. Extend a module to do so?
    • poke the author of the calendar plugin so as to get the code;
    • report that shortcuts containing slashes aren't working;
    • integrate it in git.