Documents i manuals tècnics amb Asciidoctor

Documents i manuals tècnics amb Asciidoctor

De Markdown a Asciidoc, i d'Asciidoc ara a Asciidoctor per tal de documentar documents i manuals tècnics d'una manera ràpida, senzilla i generant PDFs o HTML 5 responsive. Una meravella. Ja dubto de si m'agrada més LaTeX o aquest Asciidoctor.

Doncs bé, si volem instal·lar Asciidoctor a FreeBSD, ens instal·larà unes llibreries de Ruby. Ho fem amb:

# pkg install rubygem-asciidoctor

He generat el document HTML5 a partir de quart.adoc amb:

asciidoctor -b html5 -a stylesheet=colony.css quart.adoc

També he generat un Docbook amb:

asciidoctor -b html5 -a stylesheet=foundation-lime.css quart.adoc

Web oficial del projecte Asciidoc
http://asciidoc.org/manpage.html

Asciidoctor cheat sheet al Github
https://github.com/powerman/asciidoc-cheatsheet

Podem probar AsciiDoc en línia
https://asciidoclive.com/edit/scratch/1

Algunes captures de themes per al format HTML
https://darshandsoni.com/asciidoctor-skins/screenshots/

Per a l'atribut de la taula de continguts, podem ficar: auto / left / right / preamble / macro.

Ací tenim els themes:
http://themes.asciidoctor.org/stylesheets/colony.css (CLARET TAMBÉ)
http://themes.asciidoctor.org/stylesheets/golo.css (XULO)
http://themes.asciidoctor.org/stylesheets/asciidoctor.css (PER DEFECTE)
http://themes.asciidoctor.org/stylesheets/foundation.css (NEGRET)
http://themes.asciidoctor.org/stylesheets/foundation-lime.css (KIWI)
http://themes.asciidoctor.org/stylesheets/foundation-potion.css (DIPCAS)
http://themes.asciidoctor.org/stylesheets/iconic.css (CAPÇALERA NEGRA)
http://themes.asciidoctor.org/stylesheets/maker.css (MINIMALISTA ROGET)
http://themes.asciidoctor.org/stylesheets/readthedocs.css (XULO NEGRET I MODERN)
http://themes.asciidoctor.org/stylesheets/riak.css (GRISET MINIMALISTA)
http://themes.asciidoctor.org/stylesheets/rubygems.css (NEGET)