Savoir-faire requis

Procédure initiale

Installation des dépendances

NOTE : cette procédure est pour Debian Wheezy.

Installe le dépôt de Squeeze pour thttpd :

% sudo tee /etc/apt/sources.list.d/squeeze.list <<EOF
deb http://ftp.fr.debian.org/debian squeeze main
EOF
% sudo apt-get update

Installe IkiWiki et les dépendances des modules que nous utilisons :

% sudo apt-get install \
 ikiwiki \
 gcc \
 libcgi-formbuilder-perl \
 libcgi-session-perl \
 libdatetime-perl \
 libemail-folder-perl \
 libemail-mime-perl \
 libemail-thread-perl \
 libfile-mimeinfo-perl \
 libhtml-parser-perl \
 libhtml-scrubber-perl \
 libhtml-template-perl \
 libmail-sendmail-perl \
 libsearch-xapian-perl \
 libtext-markdown-perl \
 libtext-multimarkdown-perl \
 libtimedate-perl \
 liburi-perl \
 libxml-simple-perl \
 thttpd \
 xapian-omega

Mise-à-jour des sous-modules Git pour IkiWiki

% cd ~/SparkleShare/cyclowiki/
% git submodule update --init --recursive

Construction du rendu de l’IkiWiki

% ikiwiki --rebuild --verbose --wrappers \
 --setup ~/SparkleShare/cyclowiki/ikiwiki.setup --no-rcs

NOTE : le rendu se fait dans ~/SparkleShare/cyclowiki-www/

Création d'un compte

Se rendre sur http://localhost/cgi/ikiwiki.cgi?do=prefs et se Créer un compte de camarade.

NOTE : en local la phrase-de-passe de création de compte est vide.

Procédure d’utilisation

Lancer un serveur Web

% sudo thttpd -D -u $USER -h localhost -p 80 -T UTF-8 -l /dev/stderr -c '/cgi/*.cgi' \
 -d ~/SparkleShare/cyclowiki-www

NOTE : sudo est nécessaire pour acquérir le port 80 (< 1024) lui même nécessaire car thttpd ne respecte pas la RFC 3875

Rafraîchir le rendu du wiki

% ikiwiki --refresh --verbose --wrappers \
 --setup ~/SparkleShare/cyclowiki/ikiwiki.setup --no-rcs

Consulter ou modifier les sources du wiki

Via le Web

Se rendre sur http://localhost/.

Via un éditeur

% $EDITOR ~/SparkleShare/cyclowiki/$page.mdwn

NOTE :

  • $EDITOR étant votre éditeur de texte préféré par exemple Gedit.
  • $page étant le chemin vers une page du wiki.

Stopper le serveur Web

% sudo pkill thttpd