Un nuevo manual escrito en AsciiDoc

Parte 6

Ni siquiera me gusta decirlo ni escribirlo; la realidad me ha alcanzado en este proyecto. He mirado la fecha de la última entrada del blog y me he sobresaltado: 14 de enero de 2022.

Seré sincero, tampoco he escrito mucho sobre el nuevo manual desde esa fecha. Por supuesto, reconocí el problema hace unos meses e incluso intenté buscar soluciones. Pero, por desgracia, todo no salió bien y me di cuenta de que necesitaba apoyo.

Así que me senté con Antoni -con quien ya había escrito el libro Merlin 2 para el editor Hanser Verlag – y relanzamos el proyecto. Sé que es vergonzoso. Pero a veces hay que reconocer y resolver un problema, incluso si usted es el problema.

Espero que juntos terminemos el libro en alemán en el primer semestre de 2023, para que luego pueda ser traducido a otros idiomas poco a poco.

Tema AsciiDoc

Nada cambia en el proyecto en sí, ya que Antoni conoce a nuestro pequeño mago como la palma de su mano. El lenguaje de marcado AsciiDoc sigue fijado. Después de todo, Antoni -como todos los demás en ProjectWizards- ha estado escribiendo en este dialecto desde aproximadamente 2012.

Sin embargo, hay que buscar la sintaxis de vez en cuando. En este caso, el modo de ayuda de Asciidoctor ha resultado muy útil.

Introduzca lo siguiente en el terminal:

asciidoctor --help syntax

Obtendrá como salida una página de ayuda en notación AsciiDoc. Incluso puede convertir esta página directamente en HTML:

asciidoctor --help syntax | asciidoctor -o syntax.html -

Consejo: El "-" al final de la línea fija la salida a la salida estándar (STDOUT).
El resultado es una página HTML con el siguiente aspecto.

Ahora puede añadir un comando de apertura:

asciidoctor --help syntax | asciidoctor -o syntax.html - && open syntax.html

Esto mostrará inmediatamente la página en su propio navegador.

Así que, ahora vamos a ver cómo nos va en las próximas semanas.

En este sentido - hasta la próxima vez ...