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 le lien vers le Guide de la mise en page du wiki. Si vous souhaitez participer de manière ponctuelle, envoyez-moi votre article converti sur arnaud@andesi.org, sinon consultez la page Participer.
Le guide andesi, originellement écrit par Cédric Lignier et dont http://www.andesi.org s'appuie largement, est publié dans différents formats, dont le format DocBookXML dont on va ici se servir. Téléchargez-le ici.
Une fois le guide téléchargé au format DocBookXML, décompressez-le grâce à la commande:
$ tar -xvf guide-debian-xml.tar
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!
Voir les modules Perl pour convertir du dokuwiki.
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 |
| $ 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.
Légende :
Liste :