Un nouveau manuel écrit en AsciiDoc

Partie 5

La nouvelle année a déjà commencé depuis quelques jours et les derniers vacanciers se sont remis au travail.

Bien sûr, j'ai ralenti pendant les vacances et j'ai surtout travaillé sur les aspects administratifs de la nouvelle année. J'ai également préparé une partie du site web pour la version 8.1 de Merlin Project qui sera bientôt disponible.

Le lecteur attentif peut donc immédiatement en déduire que je n'ai pas écrit grand-chose sur le nouveau manuel ... en fait rien du tout 🤷‍♂️.

Réactions aux messages précédents

J'aimerais tout de même répondre à quelques courriers que j'ai reçus après la quatrième partie. De nombreuses personnes sont très intéressées par les variables et les traductions de texte. Je voudrais donc cette fois-ci donner un conseil important.

Asciidoc connaît le concept d'Admonitions, que l'on peut traduire au mieux par avertissements. Les valeurs habituelles sont NOTE, IMPORTANT, TIP, CAUTION et WARNING. Ces avertissements sont affichés sous forme de mots, ce qui peut ressembler à ceci :

IMPORTANT | Lire la documentation peut éviter des erreurs !

Cependant, au début du document, la ligne :

:icons: font

est présente, les termes sont remplacés par des symboles. Selon l'image utilisée, cela peut alors ressembler à ceci :

Lire la documentation peut éviter des erreurs !

J'utilise cette technique, chaque fois que je dois faire la différence entre les programmes, comme Merlin Project et Merlin Project Express, j'insère un texte comme celui-ci :

[{MPE}]
NOTE: Merlin Project Express only knows the attachment type Files.

A partir de là, on obtient ceci :

Cela suppose que l'icône est définie dans le fichier attributes.adoc.

:mpe: icon=mpExpress-32.png

Dans ce sens - jusqu'à la semaine prochaine ...