TEXTALLION [tɛkstaljɔ̃]
n.m. — (2009 ; de texte, et suffixe inconnu -llion, probabl. d’o. animale ou indiquant l'idée de la prem. pers. du pluriel. On l'écrit indiff. textallion ou TeXtallion.)
Système de traitement de texte utilisant une syntaxe wiki, générant une présentation finale attrayante, que cela soit au format PDF, HTML ou ePUB, et permettant une mise en forme simplifiée au clavier au lieu d'avoir à cliquer dans des menus. Accessoirement, la source d'un document peut être lue sans logiciel particulier. V.txt2tags.
Citation :
La syntaxe générale est celle de txt2tags, à laquelle on a rajouté quelques symboles pour permettre des fonctionalités avancées.
Nous rappelons brièvement ici cette syntaxe :
[image.jpg]
[lien vers un site http://www.site.com] : lien vers un site
Les nouveaux symboles sont généralement définis par 4 signes entre accolades. Ainsi on a ces conventions :
{*~~~} avant la première lettre.
*-*- ou {*-*-}
{-@- }, rajoute une petite feuille aldine, aussi nommée cœur floral {-/@-} : {** *}
| Description | symbole | code |
|---|---|---|
| lune premier quartier | ☽ |
{ )) } |
| pleine lune | ○ |
{ () } |
| lune dernier quartier | ☾ |
{ (( } |
| soleil | ☼ |
{( )} |
Il est possible d'entrer ces symboles directement dans votre source si vous le souhaitez, mais ils seront peut-être plus difficiles à lire dans un éditeur de texte. Vous ne pourrez entrer de nouveaux symboles en unicode si vous voulez publier en pdf (à moins de modifier les directives de préprocesseur dans votre document, sur le modèle de ce qui a été fait dans le fichier textallion.t2t), car cette version de latex ne supporte pas unicode. Mais la sortie html pourrait le faire.
Certains lecteurs ePUB ne supportent pas ces symboles, aussi ils ont été remplacés par des étoiles * dans l'export ePUB.
Pour signifier des passages importants vous avez également ces symboles :
⊕ pour un passage positif ⊖ pour un passage négatif
⚠ pour un passage à faire attention (?) pour une question (i) pour une information générale
{x} (pour une erreur ?)
Les notes de bas de pages sont possibles en entourant ces notes avec °° des deux côtés (voir exemple plus bas, et le code source du document pour des exemples plus précis).
Pour plus de logique avec la syntaxe ajoutée à txt2tags, il est possible de créer des notes de bas de page avec le symbole { °° } (celui-ci doit rester accolé à la portion de texte).
La version LaTeX renumérotera automatiquement les notes, tandis que la version html utilisera une étoile pour faire référence à la note.
Pour apporter plus de souplesse dans l'exportation html, qui ne peut générer cette renumérotation, on peut ajouter manuellement à la fin de la note, entre parenthèses, un numéro pour remplacer l'étoile, par exemple :
Ceci est un texte avec une annotation°°Ceci est la note.(1)°°.
donnera :
Ceci est un texte avec une annotation1 (Ceci est la note.).
Le symbole ° peuvent être tapé sur les claviers qwerty avec alt+248 sous Windows, et alt gr + 0 sous Linux.
La table des matières est automatiquement générée par txt2tags. C'est la commande %%toc qui indique l'endroit de cette table des matières dans votre document, sinon, par défaut c'est au début du document.
L'index est optionnel. Pour l'activer, il suffit de vérifier que les options \usepackage{makeidx} et \makeindex soient bien présentes dans le fichier de style .sty, et que la commande %%index soit appelée à l'endroit où vous souhaitez placer cet index.
Les entrées d'index se font avec les mots à indexer entre le symbole {^}. Pour indexer sous un autre nom, il suffit d'écrire par exemple {^}pomme{^fruit}.
Pour débuter des dialogues, veuillez écrire un triple tiret (-), qui générera un tiret cadratin (—) dans le document final.
Il est nécessaire de laisser une ligne entre chaque réplique.
Les guillemets à la française peuvent être ajoutés tels quels, mais il est également faisable d'écrire à la place {" } et { "} (sans espace avec les mots concernés).
Si vous voulez ajouter un espace insécable dans votre texte, vous pouvez utiliser le symbole ¯.
Txt2tags offre une réelle souplesse quand aux remplacements de portions de texte, aussi si votre source ne contient pas les espaces nécessaires à la ponctuation française (par exemple avec les points d'interrogation collés aux mots les précédant), vous pouvez utiliser dans l'entête de votre document ces remplacements :
Textallion corrige automatiquement l'espace avant ; par un espace insécable. Mais si le point virgule est collé ; rien ne sera corrigé (vous pouvez le faire manuellement avec une règle preproc).
Textallion ne corrige pas automatiquement les trois points de suspension…
Txt2tags (txt2tags) est conçu pour ne pas prendre en compte un simple retour à la ligne dans l'affichage final.
Pour faire un véritable saut de ligne, il faut donc passer 2 lignes, mais il est également envisageable de faire débuter chaque ligne où vous voulez un retour, d'un espace simple (syntaxe rajoutée et spécifique à textallion). Cela peut être ainsi plus pratique et élégant pour afficher de la poésie, qui utilise de nombreux sauts de ligne. En cas de deux espaces ou plus avant le premier mot, cela fera un retour à la ligne suivi d'une indentation de paragraphe (dans la version PDF uniquement), ceci n'est pas un alinéa, c'est juste un effet visuel lié à LaTeX. Pour réaliser un véritable alinéa, il faut passer 2 lignes.
Vous pouvez forcer un retour à la ligne avec {//..}, ou la version simplifiée //... Si possible, vous devriez essayer malgré tout de garder la syntaxe complète avec les accolades pour garder une unité, mais c'est aussi selon votre goût.
Si vous souhaitez copier et coller rapidement du texte d'internet ou d'une autre source, vous trouverez sans doute ennuyeux de devoir inclure à chaque fois les marques spéciales de retour à la ligne (*-*-), aussi vous pouvez activer cette option dans l'entête de votre document pour pallier cela :
%!postproc: "$" '{//..}'
Mais cela peut conduire à d'autres contraintes, aussi c'est à utiliser avec parcimonie.
Un saut de page se fait avec le symbole {/…}.
On peut utiliser ^^ ou { ^^ } pour entourer la partie à utiliser en tant qu'exposant. Par exemple 2^^ème^^ ou 24^^5^^.
Pour inclure des graphismes, il suffit d'utiliser la syntaxe générale de txt2tags, et de rajouter optionnellement accolé à votre image, entre crochets, la taille souhaitée (valeur en mm) :
par exemple : [chemin_vers/mon_image.png][24]
(10) (20) (30)
Dans la version html, cela affichera cette valeur en pourcentage de la page.
Il est possible de centrer l'image en utilisant une tabulation avant celle-ci
Pour entourer ou envelopper l'image avec du texte (wrapping), on peut utiliser la forme [image.png]{~~~~} (image à gauche) ou {~~~~}[image.png] (image à droite)
Cette dernière notation vient après l'éventuelle notation de taille.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Il est toujours possible d'indiquer l'information de taille d'image, ce qui sera d'ailleurs souhaitable pour maîtriser pleinement l'effet de la vignette.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Si vous trouvez plus logique d'utiliser la syntaxe [description URL] pour vos liens, vous pouvez l'écrire ainsi, cela sera converti en interne par textallion, vers [description URL].
Plus spécialement utile pour le module de jeux textuels (voir plus bas), il est possible de rajouter de la musique avec la syntaxe : [musique.ogg], ce qui s'affichera dans le navigateur sous forme de lecteur de musique compatible balise HTML5 dans les exports HTML. Seul le format ouvert et libre ogg/vorbis est supporté, car contrairement au mp3, il est directement compatible avec la plupart des navigateurs : Firefox, Chrome, Opera.
Exemple de musique :
De la même manière vous pouvez inclure des vidéos au format ogg/theora, avec l'extension .ogv ou .webm à la place de l'extension .ogg : [video.ogv]
Exemple de vidéo (téléchargée depuis un site internet extérieur) :
Exemple de vidéo :
{ ++ } et en le terminant avec {/++ }.
{ -- } et en le terminant avec {/-- }.
Txt2tags ne permet de formater en italique ou en gras que dans des passages sans retour à la ligne. Si vous souhaitez mettre en italique un passage contenant plusieurs paragraphes, il vous suffit de le débuter avec { // } et de le terminer avec {/// }.
De même pour des passages en gras, qu'il vous suffit de débuter avec { ** } et de clore avec {/** }.
Du code (écriture non-proportionnelle), s'écrit avec {####} et {/###}.
Le Verbatim de txt2tags (trois fois `) fonctionne bien avec HTML, mais peut poser problème en LaTeX (sort du cadre de la page si la ligne est trop longue)
En exergue on place traditionnellement une citation avec son auteur sous un titre de chapitre. Nous avons fait en sorte de décaler le texte à droite, avec une margue assez importante à gauche, c'est pour cela que nous avons indiqué comme symboles pour débuter { ~~} et pour terminer {/ ~~}. Il est possible de modifier l'apparence finale en modifiant le style LaTeX ou le style CSS.
Vous pouvez indiquer un auteur à cette citation en l'accolant juste après { ~~} ou après {/ ~~}, soit entre accolades, soit directement.
Veuillez éviter d'écrire sur une seule ligne : { ~~}Citation{/ ~~}
Ainsi :
deviendra :
Pour illustrer ponctuellement des documents avec du texte en couleur (Traitement des couleurs), il est possible d'utiliser la syntaxe @@COLOR@@nom de la couleur@@Texte à coloriser@@/COLOR@@. On commence à observer une syntaxe un peu intrusive, mais c'est le prix à payer pour obtenir un peu de couleur, ce type d'indication ne pouvant se symboliser autrement. Cela reste plus simple que leurs équivalents respectifs en LaTeX ou html.
Les couleurs de base sont :
black blue brown cyan darkgray gray green lightgray lime magenta olive orange pink purple red teal violet white yellow
Et vous pouvez également utiliser les codes couleurs suivants, qui sont compatibles à la fois dans LaTeX et en HTML (couleurs svg, mais la plupart sont sans doute inutiles) :
AliceBlue AntiqueWhite Aqua Aquamarine Azure Beige Bisque Black BlanchedAlmond Blue BlueViolet Brown BurlyWood CadetBlue Chartreuse Chocolate Coral CornflowerBlue Cornsilk Crimson Cyan DarkBlue DarkCyan DarkGoldenrod DarkGray DarkGreen DarkGrey DarkKhaki DarkMagenta DarkOliveGreen DarkOrange DarkOrchid DarkRed DarkSalmon DarkSeaGreen DarkSlateBlue DarkSlateGray DarkSlateGrey DarkTurquoise DarkViolet DeepPink DeepSkyBlue DimGray DimGrey DodgerBlue FireBrick FloralWhite ForestGreen Fuchsia Gainsboro GhostWhite Gold Goldenrod Gray Green GreenYellow Grey Honeydew HotPink IndianRed Indigo Ivory Khaki Lavender LavenderBlush LawnGreen LemonChiffon LightBlue LightCoral LightCyan LightGoldenrod LightGoldenrodYellow LightGray LightGreen LightGrey LightPink LightSalmon LightSeaGreen LightSkyBlue LightSlateBlue LightSlateGray LightSlateGrey LightSteelBlue LightYellow Lime LimeGreen Linen Magenta Maroon MediumAquamarine MediumBlue MediumOrchid MediumPurple MediumSeaGreen MediumSlateBlue MediumSpringGreen MediumTurquoise MediumVioletRed MidnightBlue MintCream MistyRose Moccasin NavajoWhite Navy NavyBlue OldLace Olive OliveDrab Orange OrangeRed Orchid PaleGoldenrod PaleGreen PaleTurquoise PaleVioletRed PapayaWhip PeachPuff Peru Pink Plum PowderBlue Purple Red RosyBrown RoyalBlue SaddleBrown Salmon SandyBrown SeaGreen Seashell Sienna Silver SkyBlue SlateBlue SlateGray SlateGrey Snow SpringGreen SteelBlue Tan Teal Thistle Tomato Turquoise Violet VioletRed Wheat White WhiteSmoke Yellow YellowGreen
On peut indiquer une couleur avec son code html à la place de son nom, par exemple #6D7D2E, ce qui donne : Ma belle couleur verte. Par contre LaTeX n'affichera pas cette couleur, cela sera remplacé par du gris.
Vous pouvez centrer du texte en commençant une ligne par un | (avec LaTex uniquement) :
| texte centré (mais pas en html) |
ou encore en entourant un paragraphe avec {->--} et {-<--} :
N'oubliez pas de rajouter une espace avant chaque ligne pour préserver les retours à la ligne.
ou encore avec @@begin((center))** et @@end((center))**
Troisième possibilité, pour aller avec le symbole de l'exergue, vous pouvez utiliser { ~~ } et {/ ~~ }
Vous pouvez utiliser le symbole {|n|} pour signifier que vous voulez avoir votre texte sur n colonnes, n étant une valeur comprise entre 0 et 4. On considère que 4 colonnes c'est déjà un maximum pour une présentation de texte. À la fin de la zone à mettre en colonnes, on termine par cette même commande avec n=0 ou n=1 pour signifier le retour à la normale.
Les tables sont natives dans txt2tags. Mais dans l'export LaTeX (pdf) par défaut, si une table est trop longue, elle sortira en bas de la page et la fin ne sera pas affichée, aussi nous utilisons le paquet longtable et tabu au lieu de tabular. Si vous préférez revenir à tabular, veuillez rajouter ceci dans votre en-tête :
%!postproc(tex): 'longtable' 'tabular'``
%!postproc(tex): 'longtabu' 'tabular'``
In the case your tables has so many columns that it will print outside the width of the page, use this trick to wrap long texts, for example if your table has 4 columns:
%!postproc(tex): '\{\|l\|l\|l\|l\|\}' {|p{3cm}|p{3cm}|p{3cm}|p{3cm}|}
(we must escape the { and | symbols when using *proc in txt2tags)
If your document has only one table, it will be ok. You can also customise the width of each column. If it has more tables and you wish to use different widths, you can use a second trick:
add extra spaces at the beginning of one of the colum, like this:
| left | left | left | right |
so this table will be unique to the document and you can use this now:
%!postproc(tex): '\{\|l\|l\|l\|r\|\}' {|p{2cm}|p{3cm}|p{5cm}|p{3cm}|}
Reminder: tables are aligned like this:
| left align | left align | left align |
| left align | right align | left align |
| Lorem ipsum dolor | sit amet, consectetur | adipiscing elit. Donec a diam lectus. | | left align | right align | center align |
| Lorem ipsum dolor | sit amet, consectetur | adipiscing elit. Donec a diam lectus. |
| left align | right align | center align |
| Lorem ipsum dolor | sit amet, consectetur | adipiscing elit. Donec a diam lectus. | | left align | right align | center align |
| Lorem ipsum dolor | sit amet, consectetur | adipiscing elit. Donec a diam lectus. |
| left align | right align | center align |
Même si ce n'est pas prévu pour, vous pouvez également rajouter du code spécifique à LaTeX, en remplaçant les \ par des @@ et les { et } par respectivement (( et )). Si vous voulez que la commande disparaîsse totalement du document html, vous aurez besoin de finir la commande par deux étoiles ** pour indiquer la fin du code.
Il est également possible, de façon plus simple, d'encadrer votre code latex avec la syntaxe txt2tags pour le verbatim (trois ```) ou le nouveau format tagged (trois '''). Mais contrairement à la syntaxe décrite précédemment, cela inclura le code LaTeX dans le document html, ce qui n'est pas forcément souhaitable, sauf si vous avez uniquement besoin de l'exportation LaTeX.
Le code source du présent document vous donnera plus d'exemples sur comment rajouter directement des options latex dans votre texte. Par exemple une formule mathématique (qui n'apparaîtra pas dans la version html) :
En version verbatim :
\begin{displaymath}
\frac{a}{b} + \sqrt[n]{abcd}
\end{displaymath}
Ou une boîte :
@@Ovalbox((Test de mise en boîte))
Ce dernier exemple apparaîtra bizarrement dans la version html car il n'y a pas les ** de fin de commande spéciale.
On pourra ainsi include des notes (version avec le code de remplacement)
Mais attention, de cette manière, celles-ci n'apparaîtront pas lors de l'export html
Il vaut mieux utiliser cette forme pour avoir des notes sauvegardées* (Cette note sera gardée dans la version html du document, incluant également du formatage éventuel.)
Enfin, il y a également cette forme alternative* (Uniquement pour garder l'idée des symboles entourés d'accolades…)
Elles se créent en entourant les équations avec le symbole { $$ } (des deux côtés).
Elles seront affichées telles quelles en html. Vous pouvez les visualiser en ligne avec http://www.codecogs.com/latex/eqneditor.php
En version en ligne : \delta = 3 \times \sum X_i^2, ainsi que 4 - \sqrt X
En version hors ligne : \delta = 3 \times \sum X_i^2
Si vous avez besoin d'include des caratères que l'on trouve dans le code txt2tags, vous pouvez protéger leur exécution en les entourant de double quote ("")
| find . -print | cpio -o -H newc | gzip -9 > ../initrd.gz |