Si vous souhaitez compiler un wiki Ikiwiki sur votre ordinateur, histoire de voir les modifications avant de les montrer au reste du monde (ou si bulbe est en panne), ce guide est pour vous.

Prérequis

Pour ce faire, il va vous falloir :

  • Une copie du fichier wiki-$WIKI.setup, situé sur bulbe.nos-oignons.net:/etc/ikiwiki/wiki-$WIKI.setup ; par convention, il sera rangé dans ~/.ikiwiki.
  • Un clone Git du wiki en question ; cf Accéder au wiki admin sys.
  • Le paquet po4a installé sur votre système, ou supprimer po de la section add_plugins dans le fichier wiki-$WIKI.setup.

La recette

La procédure est librement inspirée de la documentation d'Ikiwiki :

  1. Modifier wiki-$WIKI.setup
  2. srcdir doit pointer vers votre clone du wiki.
    Par exemple, /home/nicoo/nos-oignons/wiki-légumes.
  3. destdir doit pointer vers le dossier où sera mis les fichiers générés par Ikiwiki (le « contenu » du site).
    Par exemple, ce sera /home/nicoo/nos-oignons/wiki-légumes.out.
  4. url est de la forme file:///destdir.
    Par exemple, file:///home/nicoo/nos-oignons/wiki-légumes.out.
  5. cgi_url, cgi_wrapper et cgi_wrappermode sont commentés ou inexistants
  6. gitorigin_branch est mis à ''
  7. usedirs est à 0

  8. Lancer ikiwiki --setup ~/.ikiwiki/wiki-$WIKI.setup.

  9. Pointer son butineur préféré vers l'URL choisie précédemment. Dans notre exemple, file:///home/nicoo/nos-oignons/wiki-légumes.out.

Petites remarques

  1. Il n'y a pas besoin de serveur HTTP, de scripts CGI ou autres Yog-Sogotheries ;)