🅭

article wikipédia sur les langages de balisage léger

# pense bête :
https://powerman.name/doc/asciidoc
# en français
https://worldliterate.com/translations/asciidoc
# en ligne
https://asciidoclive.com

# cdk fabriquer des présentations HTML à la powerpoint ( prerequis installation python-pip ) 
# pour insserer du code htlm : +++<img src="toto.png">+++
# necessite le droit de creer un repertoir ~/.cdk
cdk --generate=/tmp/presentation.txt
vi /tmp/presentation.txt
cdk [--logo=image.png] -o /tmp/presentation.txt
# la touche [F11] est pratique pour mettre en diaporama
version perso en ligne

	

////

fichier texte à transformer en page html
il faut souvent mettre des lignes vides

asciidoc [-n] [-a toc2] -a data-uri toto.txt
   l'option -n numérote automatiquement les sous titres
   -a toc2    #met une table des matière dans une trame à gauche
     /!\ onpeut aussi mettre :toc2: au début du document
   -a data-uri    # integre les images dans la page
   -a footer-style=none  # évite l'ajout "last update ...."

renome .txt ou ajoute .html au nom de fichier

sauf si on met un tiret à la place du nom de fichier alors il écrit dans la sortie standard

cliquer pour voir le rendu

// ligne de commentaires

////

= Titre du document ( une seule occurence par page )

image::asciidoc.png[align="center"]

== sous titre inspiration

mini https://www.latex-project.org/[[big]#L^A^T~E~X#]

[red]#rouge normal# ou [big red yellow-background]*gros et gras*.

_e_^iπ^ + 1 = 0

== sous-titre suite

http://www.memoperso.fr/www/divers/asciidoc[lien vers le source]

=== sous sous titre

passage à la ligne +
sinon il faut une ligne vide

ligne horizontale  '''

_italique_
*gras*

+mono+

''simple quote''

(C) (R) (TM)  ->  <-  =>  <= 

.liste à puces
* un
* deux

.liste ordonnée
. premier
.. sous premier
.. second sous premier
... sous sous
.... sous sous sous
. second


++++
''passthru'' ce qui suit ne dois pas être traité
mais certaines sequences sont effacées: +++
////
commentaires normalement non transmis
////
++++

....
quatres points pour que le HTML affiche telquel
du coup ça rajoute les bornes : 

////
commentaires normalement non traités
////
....

----
cadre code source
----

====
barre verticale grise
====

****
cadre jaune
****

[cols=2]
|===
|a
|b
|c
|d
|===

[graphviz]
---------------------------------------------------------------------
digraph { a->b->c a->d }
---------------------------------------------------------------------
https://asciidoc.org/asciidoc-graphviz-sample.html[cf]

[music]
---------------------------------------------------------------------
\version "2.18.2"
\relative c'' {
 \key g \major \time 2/2
 g g g a b2 a g4 b a a g1
}
\addlyrics {
Au clair de la lu -- ne mon a -- mi Pier -- rot.
}
---------------------------------------------------------------------
https://asciidoc.org/music-filter.html[cf]


[NOTE]
ne fonctionnent pas avec asciidoctor +
les grandes partitions sont tronquées

pour dessiner une ligne: trois apostrophes

'''

saut de page

<<<

sans doute plus utile en PDF +
à ce propos la meilleur solution est d'imprimer le HTML +
asciidoctor n'est pas 100% compatible

# un concurent d'adciidoc est markdown
je le trouve moins élégant mais il semble avoir plus de succès
en particulier pour l'environement de documentation zettlr

# ou reStructuredText utilisé par Sphynx

#ou Doxygen qui ferait la doc à partir du code source C, PHP, Python ......

# pour convertir entre langages de balises:
pandoc mais ne gère pas les caractères spéciaux (schema formats de convertions)
depuis asciidoc il faut passer par le format docbook
asciidoc -b docbook truc.asc
pandoc -f docbook -t markdown_strict truc.xml -o truc.md

# pour de la documentation d'aide par exemple depuis un programme avec la commande yelp de GNOME
Mallard en particulier pour de l'aide

# pour generer un sit web a partir de markdown
MkDocs
wowchemy
mdBook

# Scenari, une suite libre française pour gerer les chaîne d'edition multimedia contient pour la documentation
Dokiel

# voir aussi OpenEdition et Lodel

# ou plus pour site web HUGO