Salut,
Voila, grace a notre gentil stagiaire (Jean-francois), nous avons une
jolie génération de documentation html a partir du rst. Et tout cela est
directement integre a maven avec le plugin maven-topia-plugin.
la version du plugin qui prend en compte le rst est la 0.22. Elle ne
change rien de plus par rapport a la 0.20.
Comment ca marche
=================
Il faut mettre dans son projet, dans le repertoire /doc, des fichiers
avec l'extension .rst. Ensuite il faut ecrire un petit fichier
/xdocs/navigation.xml qui permet de prendre en compte le fichier rst.
Par exemple si j'ai le fichier /doc/JRst.rst
le fichier /xdocs/navigation.xml contiendra par exemple::
<?xml version="1.0" encoding="ISO-8859-15"?>
<project name="JRst">
<title>Implantation Java d'un générateur ReStructuredText</title>
<body>
<links>
<item href="http://labs.libre-entreprise.org/" name="Labs">
</item>
<item href="http://www.codelutin.com/" name="Code Lutin">
</item>
</links>
<menu name="Overview">
<item href="/JRst.html" name="A propos">
</item>
</menu>
</body>
</project>
Il faut ensuite modifier un peu le fichier maven.xml pour ajouter la regle suivante::
<preGoal name="site">
<attainGoal name="topia:docs"/>
</preGoal>
Et voila il ne reste plus qu'a lancer maven site ou maven site:deploy
pour avoir un joli site avec une jolie documentation :)
Limite
======
Pour l'instant il avant d'ecrire un titre il faut passer 2 lignes
(normalement une devrait suffire dans le futur).
Il n'y a pas encore tout le rst (par exemple les images). Mais la
plupart des choses utile est implante
--
Benjamin
--------------------
email: poussin(a)codelutin.com () campagne du ruban ascii
http://www.codelutin.com /\ pour les mails en ascii
