La syntaxe Texy
Texy est un langage de balisage léger créé en 2004 par David Grudl.
L'outil Texy a été créé pour permettre à des utilisateurs inexpérimentés d'éditer le contenu des pages web. Par conséquent la syntaxe est la plus intuitive possible. L'intention est que le texte sous forme brute (non formaté) soit clair et lisible tel quel.
Aujourd'hui Texy est également utile pour les experts du HTML. Il vous permet de combiner librement la notation Texy avec les balises HTML. Ainsi les utilisateurs expérimentés n'ont pas besoin d'apprendre un nouveau méta-langage et peuvent pleinement utiliser leurs connaissances. Texy ne fait que simplifier leur travail.
Texy possède une syntaxe claire et légère. L'insertion d'informations avancées comme des classes CSS ou des liens ne perturbe pas le flux de texte. Et il est écrit de manière à ce que même les utilisateurs non techniques puissent facilement le comprendre.
Les paragraphes
Un paragraphe est constitué d'une ou plusieurs lignes de texte. Les paragraphes sont séparés par un saut de ligne. Les retours à la ligne simples sont ignorés.
Premier paragraphe lorem ipsum dolor sit amet.
Deuxième paragraphe, In id erat non orci commodo lobortis.
Et deuxième ligne de texte. Texy regroupe les lignes.
Pour ajouter un retour à la ligne simple dans un paragraphe, insérez un espace à gauche :
La lune était sereine et jouait sur les flots. —
La fenêtre enfin libre est ouverte à la brise,
La sultane regarde, et la mer qui se brise,
Là-bas, d’un flot d’argent brode les noirs îlots.
Les titres
Les titres peuvent être écrits de deux façons: soulignés ou entourés.
La méthode par soulignement ne permet d'afficher que quatre niveaux de
titre. Le niveau est défini par le caractère de soulignement. Du plus haut
niveau au plus bas, ce sont les suivants : #
*
=
-
.
Titre de niveau 1
**********
Titre de niveau 2
========
La deuxième méthode consiste à entourer le titre des caractères = ou #.
Pour les titres entourés, le niveau est déterminé par le nombre de
caractères précédent le titre. Les caractères utilisables sont
#
ou =
.
La règle suivante s'applique : plus il y a de caractères, plus le titre est important (minimum 2 caractères, maximum 7).
======= Titre de niveau 1 =======
====== Titre de niveau 2======
===== Titre de niveau 3 =====
#### Titre de niveau 4
Comme vous pouvez le constater dans le cas des sous-titres les caractères à droite peuvent être omis.
Les barres de séparation
Texy propose les notations suivantes :
------------
********
L'emphase faible
Pour mettre un texte en emphase, entourez le par *
ou
//
:
Voici un mot *important* à mon sens.
Voici un mot //important// à mon sens.
L'emphase forte
Pour mettre un texte en emphase forte, entourez le par **
:
Voici un mot **important** à mon sens.
Avec un modificateur
Voici un mot **important .{color:Teal}** à mon sens.
Désactiver Texy
Les mots-clefshtml
ou text
déterminent si contenu
est interprété comme du HTML ou du texte brut :
/---html
<em>example</em>: **this is not strong**
\---
/---text
<em>example</em>: **this is not strong**
\---
Pour désactiver Texy sur une ligne, il est possible d'utiliser une double
apostrophe, en entourant la partie du texte qui ne doit pas être traitée par
Texy.
Example: ''**this is not strong**''
Les citations
Les citations sont indentées de la même manière que dans les e-mails par un caractère >
> Un bloc de citation avec deux paragraphes.
>
> Il n’est point de bonheur sans liberté, ni de liberté sans courage.
Les liens
Les liens sont écrits en mettant le texte de référence entre guillemets, suivi des deux points et de l'URL. Texy essaie de deviner intelligemment la fin de l'URL. Vous pouvez également l'aider en mettant l'URL entre crochets. La section http:// est facultative.
Texy:[http://texy.info]
"Wikipédia ":https://fr.wikipedia.org/
"Ecrivez-moi":me@example.com
Les images
Elles sont écrites entre crochets avec un astérisque :
[* image.gif .(alternative text) *]
Les caractères < et > insérés avant le crochet fermant de droite permettent respectivement d'aligner l'image à gauche ou à droite.
[* image.gif <] Image alignée à gauche. Lorem ipsum ...
[* image.gif >] Image alignée à droite. Curabitur quam ...
Incorporer du code HTML
Bien qu'il soit très complet et très puissant, Texy ne remplace pas le HTML. Il ne propose pas non plus un autre moyen d'écrire du HTML. L'objectif est de simplifier l'édition de contenu. Vous pouvez donc écrire une structure en HTML si cela semble plus simple. Les balises HTML sont entièrement supportées.
Ce texte est normal.
<strong class="info">Ce texte est important.</strong>
Les listes
Les listes non ordonnées
Pour afficher une liste simple commencez la ligne par un *, + ou un -, suivi par un espace :
- PHP
- HTML
- JavaScript
Le choix n'a pas d'importance mais il faut rester cohérent.
Les listes numérotées
1) Item 1
2) Item 2
3) Item 3
a) Item a
b) Item b
c) Item c
A) Item A
B) Item B
C) Item C
I) Item I
II) Item II
III) Item III
Les listes imbriquées
a) Item a
I) Item I
- Item I1
- Item I2
- Item I3
II) Item II
III) Item III
b) Item b
c) Item c
1) Item c1
2) Item c2
3) Item c3
Les acronymes
Les pages web sont écrites en HTML((Hypertext Markup Language)).
Les listes de définition
HTML:
- HyperText Markup Language: Définit la structure de la page et son contenu
CSS:
- Cascading Style Sheets: Permet de mettre en forme la page
Le bloc de code
Pour afficher un bloc de code, utilisez la syntaxe suivante :/---code php
function reImage($matches) {
$content = $matches[1];
$align = $matches[5];
$href = $matches[6];
}
\---
Les tableaux
Exemple de tableau simple. Les colonnes sont séparées par le caractère |.
| Pays | Capitale
| France | Paris
| Allemagne | Berlin
| Italie | Rome
Résultat affiché dans le navigateur :
Pays | Capitale |
France | Paris |
Allemagne | Berlin |
Italie | Rome |
La ligne d'en-tête peut être définie avec la notation suivante :
|--------------------
| Pays | Capitale
|--------------------
| France | Paris
| Allemagne | Berlin
| Italie | Rome
Résultat affiché dans le navigateur :
Pays | Capitale |
---|---|
France | Paris |
Allemagne | Berlin |
Italie | Rome |
Fusionner des colonnes
Un double || est utilisé pour fusionner des colonnes :
|--------------------
| Nom || Age
|--------------------
| John | Smith | 30
Résultat affiché dans le navigateur :
Nom | Age | |
---|---|---|
John | Smith | 30 |
Fusionner des lignes
Le caractère ^ est utilisé pour fusionner une ligne avec la ligne précédente :
|--------------------
| Pays | Langues
|--------------------
| France | Français
| Belgique | Français
| ^| Néerlandais
| Italie | Italien
| Suisse | Français
| ^| Italien
| ^| Allemand
Résultat affiché dans le navigateur :
Pays | Langues |
---|---|
France | Français |
Belgique | Français |
Néerlandais | |
Italie | Italien |
Suisse | Français |
Italien | |
Allemand |