Un nouveau manuel écrit en AsciiDoc
Partie 6
Je n'ose pas le dire ni même l'écrire ; dans ce projet, la réalité m'a rattrapé. J'ai regardé la date du dernier billet de blog et j'ai eu un choc : 14 janvier 2022.
Je vais être honnête, depuis cette date, je n'ai pas non plus écrit grand chose sur le nouveau manuel. Bien sûr, j'ai identifié le problème il y a quelques mois et j'ai même essayé de trouver des solutions. Mais malheureusement, tout ne fonctionnait pas vraiment et je me suis rendu compte que j'avais besoin d'aide.
Je me suis donc assis avec Antoni - avec qui j'avais déjà écrit le livre Merlin 2 pour la maison d'édition Hanser Verlag - et nous avons relancé le projet. Je sais que c'est gênant. Mais parfois, il faut reconnaître un problème et le résoudre, même si c'est soi-même le problème.
J'espère que nous aurons terminé le livre en allemand au premier semestre 2023, afin qu'il puisse être traduit peu à peu dans d'autres langues.
Sujet AsciiDoc
Le projet lui-même ne change pas, car Antoni connaît notre petit magicien sur le bout des doigts. Le langage de balisage AsciiDoc reste en place. Après tout, Antoni, comme tout le monde chez ProjectWizards, écrit dans ce dialecte depuis 2012 environ.
Néanmoins, il faut de temps en temps consulter la syntaxe. C'est là que le mode d'aide d'Asciidoctor s'avère très utile.
Dans le terminal, tapez ce qui suit :
asciidoctor --help syntax
Vous obtenez en sortie une page d'aide en notation AsciiDoc. Vous pouvez même convertir cette page directement en HTML :
asciidoctor --help syntax | asciidoctor -o syntax.html -
Astuce : Le "-" à la fin de la ligne place la sortie sur la sortie standard (STDOUT).
Le résultat est une page HTML qui ressemble à ceci.
Vous pouvez maintenant ajouter une commande Open :
asciidoctor --help syntax | asciidoctor -o syntax.html - && open syntax.html
Ainsi, la page s'affiche immédiatement dans votre propre navigateur.
Voyons maintenant comment nous allons progresser au cours des prochaines semaines.
Sur ce, à la prochaine fois...
