Tutosuite est une application écrite en langage Python par delroth qui permet de rédiger des tutoriels destinés au Site du Zéro et ce dans le langage de rédaction naturel mdown.
Cette application est disponible sur le serveur personnel de delroth. Suivez ce lien pour télécharger l'archive tar.gz. Vous devrez ensuite la décompresser à l'aide d'un outil adéquat dans le dossier de votre choix. Ensuite, suivez la démarche expliquée par l'auteur :
Placez les fichiers dans le répertoire où vous voulez créer votre
tutoriel. Ensuite, modifiez le fichier .mktutrc à l'aide de mktutrc Editor.
Vous pouvez ensuite lancer le script makefile.py, qui vous
générera un fichier Makefile. Lancez ensuite make pour récupérer un
joli tutoriel en sortie :) .
Il est cependant nécessaire d’avoir mdown installé pour utiliser ce script. Les instructions d’installation et d’utilisation de mdown peuvent être trouvées sur le site de rz0 qui a une page consacrée à la question : http://rzpages.ovh.org/mdown.php5. Python est aussi nécessaire, et GNU make est un plus si vous voulez pouvoir utiliser le Makefile (ce qui n’est pas en soi obligatoire, mais tellement plus pratique).
L’utilisation de ce script permet un gain de temps énorme au niveau du temps de rédaction d’un tutoriel sachant que le mdown est un langage se prenant très rapidement en main et très proche de la syntaxe naturelle. Il permet également un gain de productivité énorme par rapport à la syntaxe XML du zCode. De plus, la séparation en plusieurs fichier permet très facilement d’utiliser un gestionnaire de version et d’écrire un tutoriel à plusieurs de manière très aisée :) .