Articles contenant le tag asdoc
Formatter ses documentations asDoc
Après avoir lu l’article plutôt intéressant d’ekameleon sur l’utilisation de google prettify avec asDoc, j’ai voulu fouiller les xsl des templates d’asDoc afin d’intégrer un peu plus google prettify au formattage de la doc.
Il se trouve que certaines balises ‘code’ et ‘pre’ se trouve dans le fichier ‘class-files.xsl’. Ce fichier sert au formattage d’une page d’une classe. En affectant la class prettyprint aux balises code et pre présentes, on améliore ainsi la visibilité des signatures des méthodes, description des proprietés, etc.
Cela permet également de formatter automatiquement les fichiers d’exemple se trouvant en bas de page.
Petit exemple sur la doc du composant Window
Tutorial Asdoc
Un petit tutorial sur l’asdoc que j’ai réalisé il y a quelques temps, se trouve sur le wiki de flexx.fr (Merci à Itératif de l’avoir retranscrit).
Il traite la mise en place des différents fichiers à créer pour créer sa documentation, ainsi que quelques règles de bases à respecter pour la documentation, et certaines qui sont spécifiques au langage actionscript (et donc différentes de celles utilisées pour la javadoc).
Communauté française sur flex, AIR et LiveCycle