En aquest xicotet article explique com instal·lar Asciidoctor a un sistema Microsoft Windows per a poder generar la nostra documentació tècnica de manera còmoda i fàcil.
La web oficial és https://asciidoctor.org, on tenim tota la informació necessària per a instal·lar, editar i modificar documentació. Ja fa temps, vaig publicar un article anomenat Documents i manuals tècnics amb Asciidoctor però el meu entorn era OpenBSD i en aquest article explique com fer-ho a un Microsoft Windows, aleshores canvia un poc el procediment d'instal·lació.
Asciidoctor es pot instal·lar fent servir l'ordre gem de Ruby. Si no ho tens instal·lat, pots instal·lar-ho fàcilment des d'un repositori de choco amb:
choco install ruby
I ara que ja tenim Ruby, podem obrir la terminal de windows normal i instal·lar asciidoctor amb:
gem install asciidoctor
Si vols escriure i crear cosetes, tens el manual d'usuari oficial a la web https://asciidoctor.org/docs/user-manual/
Per tal de generar la nostra documentació en format PDF, instal·lem asciidoctor-pdf amb:
gem install asciidoctor-pdf
