Instal·lant Asciidoctor a Windows per a fer programació literària

Instal·lant Asciidoctor a Windows per a fer programació literària

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

Doncs bé això és tot, espere que trobes útil aquest article i que et motive a compartir els teus trucs, els teus coneixements i els teus experiments amb el Programari Lliure. Pensa-ho, va, que la Comunitat del Programari Lliure va creixent gràcies a la documentació, el disseny, la formació o la programació, sigues part de la Comunitat :-)

La cultura i la lliure circulació de les idees és l'arma més efectiva contra les dictadures del pensament i contra la ignorància.