From poussin@codelutin.com Tue Jul 27 20:07:19 2004 From: Benjamin POUSSIN To: topia-devel@list.nuiton.org Subject: [Topia-devel] nouvelle version avec generation de doc Date: Tue, 27 Jul 2004 20:01:42 +0200 Message-ID: <20040727200142.04b63e56@cube.codelutin.home> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============0840788794725151802==" --===============0840788794725151802== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Salut, Voila, grace a notre gentil stagiaire (Jean-francois), nous avons une jolie g=C3=A9n=C3=A9ration de documentation html a partir du rst. Et tout cel= a 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 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D 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:: Implantation Java d'un g=C3=A9n=C3=A9rateur ReStructuredText</titl= e> <body> <links> <item href=3D"http://labs.libre-entreprise.org/" name=3D"Labs"> </item> <item href=3D"http://www.codelutin.com/" name=3D"Code Lutin"> </item> </links> <menu name=3D"Overview"> <item href=3D"/JRst.html" name=3D"A propos"> </item> </menu> </body> </project> Il faut ensuite modifier un peu le fichier maven.xml pour ajouter la regle su= ivante:: <preGoal name=3D"site"> <attainGoal name=3D"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 =3D=3D=3D=3D=3D=3D 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 --=20 Benjamin -------------------- email: poussin@codelutin.com () campagne du ruban ascii http://www.codelutin.com /\ pour les mails en ascii --===============0840788794725151802==-- From poussin@codelutin.com Fri Jul 30 15:08:47 2004 From: Benjamin POUSSIN <poussin@codelutin.com> To: topia-devel@list.nuiton.org Subject: Re: [Topia-devel] nouvelle version avec generation de doc Date: Fri, 30 Jul 2004 15:03:01 +0200 Message-ID: <20040730150301.769065ca@cube.codelutin.home> In-Reply-To: <20040727200142.04b63e56@cube.codelutin.home> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="===============0252775657313189623==" --===============0252775657313189623== Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit On Tue, 27 Jul 2004 20:01:42 +0200 Benjamin POUSSIN <poussin@codelutin.com> wrote: > 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. Salut, apres de petit correction maintenant ca marche encore mieux :) On peut mettre plus de 1 fichier .rst dans /doc :) la version a recuperer est la 0.23 ps: il ne faut pas hesiter a faire remonter les bugs s'il y en a :) -- Benjamin -------------------- email: poussin@codelutin.com () campagne du ruban ascii http://www.codelutin.com /\ pour les mails en ascii --===============0252775657313189623==--