TODO des articles du site

Article écrit par Arnaud Fontaine.

Voici une liste complète des articles à convertir pour le wiki. Je décris ici la procédure pour convertir du DocBookXML en Wiki*. Voici également un lien vers un tutorial [1] très court sur le langage Wiki. Si vous souhaitez participer de manière ponctuelle, envoyez-moi votre article converti sur arnaud (at) andesi (dot) org [2], sinon consultez la page Participer [3].

important Par abus de langage et pour la suite de cet article, on désignera par Wiki, la syntaxe propre au wiki d'andesi(car tous les wikis n'ont pas nécessairement la même syntaxe).

Convertir des articles du guide en wiki

Le guide andesi [4], originellement écrit par Cédric Lignier et dont www.andesi.org s'appuie largement, est publié dans différents formats [5], dont le format DocBookXML dont on va ici se servir. Téléchargez-le ici [6].

note Une fois le guide téléchargé au format DocBookXML, décompressez-le grâce à la commande:
$ tar -xvf guide-debian-xml.tar
NB: Les articles se trouvent alors dans le répertoire contents/

Le wiki d'andesi à sa syntaxe propre qui diffère de celle du guide. Aussi, pour rendre ces articles disponibles sur le wiki d'andesi, il faut d'abord procéder à leur transcription(passer d'un format à un autre): DocBookXML -> wiki d'andesi. Par chance, un script(en python) est à votre disposition pour dégrossir le travail et rendre la wikisation des articles du guide moins laborieuse!

Pour exécuter le script, vous pourrez avoir à installer ces paquets:

# apt-get install python python-xml

Voici les commandes à taper dans votre répertoire utilisateur (où toto.xml est le fichier à convertir) :

$ wget -r --no-parent -A xml,py -nd http://arnaud.andesi.org/pub/xml/ [7]
$ cat inc-header.xml toto.xml inc-footer.xml > toto2.xml
$ python unxml.py toto2.xml | tr -s ' ' | tr -d '\t' > toto.wiki

Ensuite, si vous avez un compte, corrigez un peu l'article si nécessaire, puis mettez le sur le site dans la section appropriée (voir ci-dessous), sinon envoyez le moi comme indiqué en haut de cet article.

Arborescence des articles à Wikiser

Légende :

Liste :