1. Ensure there's a syntax directory in the personal vim directory.

   mkdir -p ~/.vim/syntax
   

2. Download the markdown syntax file and put it in this directory (e.g. markdown.vim).

3. Affect the markdown filetype to *.mdwn files and avoid long lines (in ~/.vimrc).

   " Help autodetection
   augroup filetypedetect
       au! BufRead,BufNewFile *.mdwn setfiletype markdown
   augroup END
   
   
   " Limit the line length for this mode
   autocmd FileType markdown set tw=80
   

4. Enjoy.

Logo added at the top of the page.

Idea taken from http://ikiwiki.info/logo/, and adapted with a random font. To get a PNG file from the SVG one, just create a group with the appropriate objects, named it say kibilogo, and then call:

inkscape -w 150 -i kibilogo -e logo.png logo.svg

A bit of CSS later, that's done.

Thanks to ebzao, I'm back on the internets. :-)

To use ikiwiki with a remote host, just do the following:

• put ikibiki.git on the server;

• put the following in ikibiki.git/.git/hooks/post-receive and make it executable (it looks like setting GIT_DIR is mandatory to have run successfully when pushing, although locally or over through ssh, everything seems fine without it...):

  export GIT_DIR=~/ikibiki.git/.git
  cd $GIT_DIR/..
  git checkout -f                # Update this repository
  ikiwiki --setup ikiwiki.setup  # Update the HTML pages
  echo 'HTML update: done!'      # Notify the 'push'-er
  

• git-clone on the local host;

• edit/patch/...

• git-push

And now the site gets automatically updated some seconds after a push.

(Note to self: a code block inside a list needs to be indented twice.)

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.