Discussion :

[BerBiX]

Bonjour,

J'utilise le plugin pdf pour générer automatiquement une documentation à partir des éléments contenus dans mon pom et de différents fichiers apt utilisés pour le site du projet.

Ma question est de savoir si on peut facilement personnaliser tous les éléments du template de base utilisé lors de la génération documentaire. Par exemple, on trouve par défaut en pied de page le "copyright ${COMPANY_NAME}, all rights reserved" ; si je veux changer cette valeur et mettre par exemple une propriété annexe qui serait le numéro de version du document dans mon entreprise, est-ce qu'il existe un moyen de personnaliser la valeur du pied de page ? De même, la numérotation des pages est mise dans l'en-tête par défaut, si je veux la mettre dans le pied de page ? Dans le même cas : la couverture du document est uniformément définie avec un certain nombre d'éléments : logo de l'entreprise, logo du projet, nom du projet, version, date, etc... Est-il possible de rajouter des éléments lors de la génération, comme la liste des auteurs par exemple ?

Tous ces éléments m'ont l'air figés dans le marbre car la documentation du plugin : http://maven.apache.org/plugins/mave...gin/usage.html spécifie que le format du template doit respecter celui-ci : http://svn.apache.org/repos/asf/mave...fo-styles.xslt. Mais est-il possible d'utiliser un format qui définit d'autres éléments et comment les utiliser ?

Merci d'avance.

[BerBiX]

Bon il semblerait qu'il existe un plugin plus adapté pour personnaliser les templates de génération documentaire en utilisant les DocBook :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
 
<plugin>
	<groupId>com.agilejava.docbkx</groupId>
	<artifactId>docbkx-maven-plugin</artifactId>
	<version>2.0.9</version>
</plugin>

Je l'ai trouvé en regardant les sources de la traduction du Definitive Guide. Bon par contre, il me reste à trouver une doc ou mieux, des exemples simples de mise à oeuvre, pour comprendre à la fois le format DocBook et ses style sheets xsl, ainsi que le mode de fonctionnement du plugin...