Mise en forme avec Text2Tags
Ph.Leroy
2018-09-27
1. Text2Tags
Txt2tags est un générateur de document. Il lit un fichier texte relativement lisible qui contient des balises minimes comme **gras** ou //italique// et les convertit dans différents formats comme: Html, Wikimedia ou LaTex...
Donc on a un format compact mais qui in fine présente un résultat de qualité.
2. Structure de document
Les 3 premières lignes définissent l'entête du document, généralement le titre, puis l'auteur et enfin la date.
Les suivantes définissent la zone de configuration dans laquelle on peut mettre des directives comme
| Directives | Syntaxe | Description |
|---|---|---|
| Commentaire | % This is a comment. | sans commentaire |
| Table de contenu | %!options: --toc | Affiche la table de contenu avec les liens sur les ancres |
| Mots clés | %kw motcle1, motcle2 | Extension de Sisal-Store permettant de recherche toute information disponible sur le site |
| Fond de page | %!postproc: <BODY.*?> <BODY style="background-color:yellow;"> | Aprés il faut analyser les options du générateur parceque là cela ne marche pas... |
Après on a le contenu du document, structuré en chapitre, paragraphe intégrant des liens, des images etc...
Pour avoir un retour à la ligne, il faut en mettre deux dans le source.
3. Balises
On dispose des balises suivantes:
3.1. Les chapitres
| Type de balise | Syntaxe | Description |
|---|---|---|
| Titre1 | =mon titre= | Titre de premier niveau |
| Titre2 | ==mon titre== | Titre de deuxième niveau |
| Titre3 | ===mon titre=== | Titre de troisième niveau |
| Titre1 numéroté | +mon titre numéroté+ | Titre numéroté de premier niveau |
| Titre2 numéroté | ++mon titre numéroté++ | Titre numéroté de deuxième niveau |
| Titre3 numéroté | +++mon titre numéroté+++ | Titre numéroté de troisième niveau |
3.2. Les formattages
| Type de balise | Syntaxe | Description |
|---|---|---|
| Commentaires | % commentaires | |
| Ligne de séparation | ----------------------- |
|
| Ligne plus épaisse | ======================= |
|
| Image | [fichier.jpg] |
Par exemple avec l'identifiant d'une image que l'on a déposée sur le serveur [/img/15/04/1504164721.png] |
| Image centrée | <esp>[fichier.jpg]<esp> |
Pour centrer une image on fait précéder la balise d'un espace et suivre aussi d'un espace [/img/15/04/1504164721.png] |
| Liens | [label url] |
[En route http://www.veymont-tech.com] |
| Gras | **mots** |
|
| Italique | //mots// |
|
| Souligné | __mots__ |
|
| Barré | --mots-- |
|
| Monospaced | ``mots`` |
|
| Raw | ""mots"" |
|
| Tagged | ''mots'' |
|
| Paragraphe | `` mots | |
| Citation | <TAB>mots | |
| Liste | - mots | |
| Liste numérotée | + mots | |
| Liste de définitions | : mots |
3.3. Les tables
Les tables sont marquées par l'utilisation du caractère barre vertical | ( U+007C) et permet de caractériser la présentation.
La première ligne définit les colonnes, si la première barre est en début de ligne le tableau est cadré à gauche, si la première barre est après un espace la table est centrée.
Si la première ligne finit avec une barre verticale, les cellules du tableau seront encadrées.
| Type de balise | Syntaxe | Description |
| Table | | cellule1 | cellule2 | cellule3... |
3.4. Le texte sans formatage
| Ligne verbatim ``` mots |
| Ligne raw """ mots |
| Ligne tagged ''' mots |
| Bloc verbatim | ``` |
| lignes | |
| ``` | |
| Bloc raw | """ |
| lignes | |
| """ | |
| Bloc tagged | ''' |
| lignes | |
| ''' |
Par exemple poour insérer un graphique SVG dans une page t2t (destinée à générer du html), il suffit d'écrire
''' <svg width="100" height="100"> <circle cx="50" cy="50" r="40" stroke="#444" stroke-width="4" fill="yellow" /> </svg> '''
et on obtient: