Demo Asciidoctor

Ceci est une démonstration de {library}. Et c’est le préambule de ce document.

Objectif

Ce document exerce de nombreuses fonctionnalités d’AsciiDoc pour tester l’implémentation d’Asciidoctor.

Si vous souhaitez que la sortie semble familière, copiez (ou liez) la feuille de style AsciiDoc, asciidoc.css, dans le répertoire de sortie.

Les éléments marqués de TODO ne sont pas encore pris en charge ou sont en cours de travail.

Premiers pas

Balisage en ligne

les guillemets simples autour d’une phrase placent 'l’accent '
les astérisques autour d’une phrase rendent le texte gras
des doubles astérisques autour d’une ou plusieurs lettres dans un mot mettent ces lettres en gras
un double trait de soulignement autour d’une substring dans un mot souligne cette sous-chaîne.

les caractères d’échappement sont pris en charge
- par exemple, vous pouvez échapper une citation à l’intérieur d’un texte souligné comme « Voici Johnny ! »
vous pouvez utiliser en toute sécurité des caractères XML réservés comme <, > et &, qui sont échappés lors du rendu
forcer un espace entre les éléments en ligne en utilisant l’attribut {sp}
maintenir le texte ensemble avec un attribut d’espace intrinsèque insécable, {nbsp}
gérer les mots avec des caractères Unicode comme dans le nom Gregory Romé.

Vous pouvez écrire du texte avec des liens en ligne, éventuellement en utilisant un lien explicite :http://example.com[préfixe du lien]. Dans les deux cas, le lien peut avoir une query string.

Si tu veux briser une ligne
terminez-le simplement par un signe +
et continuez à taper sur la ligne suivante.

Listes adjacentes

cette liste
devrait joindre
avoir
quatres éléments

Listes numérotées (TODO)

Ces éléments
sera numéroté automatiquement
1. et peuvent s’imbriquer
Une liste numérotée peut s’imbriquer
- non séquentiel
- listes
- éléments

Affirmation

Je jure que je l’ai laissé dans la voiture de Guy. Allons le chercher.

terme: definition
un autre terme: une autre définition, qui peut être littérale (en retrait) ou paragraphe ordinaire

Il doit s’agir d’un paragraphe autonome, non saisi par la liste de définitions.

premier niveau écrit sur deux lignes
premier niveau
```
avec ce texte littéral
```
- deuxième niveau
  - troisième niveau
    
    quatrième niveau(TODO)
retour au
premier niveau

Faisons une règle horizontale…

alors cassez.

Nous sommes de retour!

Vous voulez voir une image :tiger.webp[Tigre] ?

Vous sentez-vous plus en sécurité avec le tigre encadré ?

Figure 1. Tigre encadré

Exemple d’utilisation d’Asciidoctor, doit contenir 3 lignes (TODO)

doc = Asciidoctor::Document.new("Le *voici!*", :header_footer => false)

met doc.render

Voici ce qu’il génère (en utilisant les modèles intégrés) :

<div class='paragraph'>
  <p>Le<strong>voici!</strong></p>
</div>

Citations

AsciiDoc est si puissant!

Ce verset vient à l’esprit.

La la la

Voici une autre citation:

Lorsque vous avez éliminé tout ce qui est impossible, alors tout ce qui reste, aussi improbable soit-il, doit être la vérité.

— Sir Arthur Conan Doyle
Les Aventures de Sherlock Holmes

Devenir littéral

Vous voulez être littéral ? Préfixez simplement une ligne avec un espace (un seul suffira).

Je rejoindrai cette fête aussi.

première règle (ouais !)
deuxième règle, a l’air "tellement mono"

Conclusion

AsciiDoc est plutôt cool, vous devriez l’essayer !

Info AsciiDoc

Accédez à cette URL pour en savoir plus :

http://asciidoc.org

Encore une chose. Bonne documentation !