Pour la doc, on diffuse du PDF, on peut travailler en collaboratif, car il y a la directive include qui peut accepter les tags git et des numéros de lignes et aussi l'argument Level, qui permet de réarranger le plan très simplement.
Pour les présentations reveal.js j'utilise : $ asciidoctor-revealjs -r asciidoctor-diagram -a data-uri Slides.adoc
les images se trouvent inlinées, le HTML est simple à diffuser.
Le gros intérêt pour nous d'asciidoctor et diagram, c'est que l'on peut inclure du plantuml, du vega (une tuerie, sauf que j'aime pas le json) ou du gnuplot ou graphviz très simplement, et les données bruts sont dans le git directement.
Bref, c'est l'idéal pour documenter les sources, créer des doc techniques, reveal.js permet de très jolie chose comme là (penser à cliquer sur la flèche du bas ou échappe).
Par contre il faut creuser pas mal avant de pouvoir l'utiliser convenablement, on ne peut pas conseiller ça à un néophyte. Il faut montrer des exemples concrets. Et il faut que l'utilisateur en ait l'utilité...
[^] # Re: Moi j’aime bien Libre Office
Posté par YBoy360 (site web personnel) . En réponse au journal C'est foutu pour LibreOffice. Évalué à 3.
Pour la doc, on diffuse du PDF, on peut travailler en collaboratif, car il y a la directive
includequi peut accepter les tags git et des numéros de lignes et aussi l'argument Level, qui permet de réarranger le plan très simplement.Pour les présentations reveal.js j'utilise :
$ asciidoctor-revealjs -r asciidoctor-diagram -a data-uri Slides.adocles images se trouvent inlinées, le HTML est simple à diffuser.
Le gros intérêt pour nous d'asciidoctor et diagram, c'est que l'on peut inclure du plantuml, du vega (une tuerie, sauf que j'aime pas le json) ou du gnuplot ou graphviz très simplement, et les données bruts sont dans le git directement.
Bref, c'est l'idéal pour documenter les sources, créer des doc techniques, reveal.js permet de très jolie chose comme là (penser à cliquer sur la flèche du bas ou échappe).
Par contre il faut creuser pas mal avant de pouvoir l'utiliser convenablement, on ne peut pas conseiller ça à un néophyte. Il faut montrer des exemples concrets. Et il faut que l'utilisateur en ait l'utilité...