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-clefs html 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