Textile, comment ça marche ?

Cette page a pour seul et unique but d'expliquer brièvement le fonctionnement de Textile, le langage de mise en forme utilisé sur le site.

Il y a 2 façons de mettre en forme une partie de texte avec Textile:

MENU:

Le formatage Inline

Les balises rapides

Les balises simplifiées vous permettent de formater votre texte, le rendant gras, emphasé ou petit, par exemple. La liste des opérateurs à votre disposition sont :

Type Balise Syntaxe Effet
Strong * *exemple* exemple
Gras ** **exemple** exemple
Emphase _ _exemple_ exemple
Italique __ __exemple__ exemple
Plus grand ++ ++exemple++ exemple
Plus petit -- --exemple-- exemple
Barré - -exemple- exemple
Inséré + +exemple+ exemple
Exposant ^ ^exemple^ exemple
Indice ~ ~exemple~ exemple
Span % %exemple% exemple
Code @ @exemple@ exemple

Par exemple, je suis un __gentil poulet__, donnerait à l'affichage je suis un gentil poulet.

Les liens hypertexte

Un lien est réalisé de la manière suivante:

"Ceci est un très joli lien":http://www.exemple.com

Et apparaitra de la sorte:

Ceci est un très joli lien

Attribut "title"

Pour ajouter un titre à votre lien (qui sera affiché quand le curseur passera sur ce lien), procédez de cette manière:

"Ceci est un très joli lien(Ahahah mais qu'il est beau)":http://www.exemple.com

Résultat: Ceci est un très joli lien

Les images

Pour insérer une image dans votre texte, placez simplement des ! de chaque coté de son url.

Ainsi !http://www.google.fr/intl/fr_fr/images/logo.gif! donnera:

Texte alternatif

Vous pouvez aller plus loin en ajoutant un texte alternatif, qui sera utilisé si votre image n'est pas affichée pour une raison ou pour une autre.

Placez simplement le texte entre parenthèses, à l'intérieur des !

!image.jpg (Texte alternatif)!

Redimensionnement

Vous pouvez également redimensionner votre image, les exemples suivant spécifient une largeur de 10 et une hauteur de 20:

!image.jpg 10x20!
!image.jpg 10w 20h!
!image.jpg 20h 10w!

Liens & images

Enfin, pour spécifier une image en tant que lien hypertexte, combinez les 2 styles:

!image.jpg!:http://www.google.fr

Les acronymes

Les acronymes sont des sigles qu'on utilise comme un mot ordinaire.

Pour définir un acronyme dans votre texte, placez simplement sa définition entre parenthèse juste derrière.

Exemple: Le XHTML(eXtensible HyperText Markup Language), c'est bien ^^ donnera: Le XHTML, c'est bien ^^

Glyphes

Textile remplace certains caractères de votre texte en leurs entités numériques équivalentes. Ceci comprend entre autres:

Le formatage en blocs

Présentation

Textile traite votre texte en le divisant en plusieurs blocs.
Chaque bloc est identifié par une "signature" (toujours présente en début de ligne) et est séparé des autres blocs par une ligne vide.

Autrement dit, pour ouvrir un bloc de texte, vous spécifiez sa signature en tout début de ligne, et pour le refermer, vous passez simplement une ligne.

Par exemple pour spécifier un titre H3, procédez comme suit:

h3. Voici mon titre.

Une fois la ligne suivante sautée, on quitte le bloc de titre H3.

Si cependant vous ne désirez pas quitter le bloc en cours alors qu'il vous faut sauter une ligne (ce qui peut arriver, la vie est faite d'imprévus), il vous suffit d'utiliser 2 points plutôt qu'un seul dans la signature (par exemple bq.. plutôt que bq.).
De cette manière, le bloc continue jusqu'à la prochaine signature rencontrée.

bq.. Ceci est une citation.
Elle continue...

Elle continue encore...

p. Paf ! Une nouvelle signature ! Le bloc bq s'arrête !

Le positionnement des blocs

Il est possible de jouer sur l'alignement des blocs de texte (p. ou autres). Il suffit d'intercaler l'indicatif de positionnement avant le . de la signature.

Comme ça:

p<.
aligné à gauche
p>.
aligné à droite
p=.
centré
p<>.
justifié
p(., p((.
indentation à gauche de 1em, 2em, etc.
p)., p)).
indentation à droite de 1em, 2em, etc.

Les titres

On place un titre en utilisant la signature "hn", où "n" prend une valeur située entre 1 et 6 (autrement dit h1, h2, h3, h4, h5 ou h6 :p).

h3. Ceci est un titre h3, est-il beau !

Donne:

Ceci est un titre h3, est-il beau !

Les citations

Pour placer une citation quelconque, il vous suffit d'utiliser la signature "bq." en début de ligne. Vous pouvez également la faire suivre de :"l'auteur de la citation" afin d'en indiquer la source.

Par exemple:

bq. Le boss de Valkyrie Profile 2 est Nelson Monfort...
Tout le monde le savait.

Donnera:

Le boss de Valkyrie Profile 2 est Nelson Monfort...
Tout le monde le savait.

Et:

bq.:"Chupon" Il parait qu'on peut affronter Rabbi Jacob dans la Seraphic Gate de VP1...

Donnera:

Il parait qu'on peut affronter Rabbi Jacob dans la Seraphic Gate de VP1...

Le texte préformaté

Il peut vous arriver de devoir écrire du texte préformaté, donc les espaces intercaractères sont constants et les caractères < et > transformés en entités HTML.

Pour cela, il vous suffit d'utiliser la signature "pre.".

Ainsi:

pre. Ceci est du texte préformaté. Incroyable !

Donnera:

Ceci est du texte préformaté. Incroyable !

Le code

Dérivé du texte préformaté, vous pouvez écrire du code source en utilisant la signature "bc.", vous pouvez spécifiez le langage utilisé en rajoutant celui-ci entre crochets [] dans la signature.

Exemples:

bc[php]. votre code php ici...
bc[python]. votre code python ici...
bc[de carte bleue]. votre code de carte bleue ici... << non ça c'est faux, ça ne marchera pas.

Définition de listes

Il est très facile et rapide d'insérer une liste en Textile.

Les listes non-ordonnées

Il suffit de faire précéder chaque item de votre liste par une astérisque *.

* Rouge
* Vert
* Jaune
* Caterpillar

Donnera:

Vous pouvez également imbriquer des listes en définissant des sous-niveaux:

* Couleurs
** Rouge
** Vert
*** Caca d'oie
*** Pomme
** Jaune
* Type de véhicule
** Caterpillar
** Moissonneuse-batteuse

Les listes ordonnées

Elles fonctionnent de la même manière, mais en utilisant des dièses #.

# objet 1
## objet 1.a
## objet 1.b
## objet 1.c
# objet 2
#...

Donnera:

  1. objet 1
    1. objet 1.a
    2. objet 1.b
    3. objet 1.c
  2. objet 2
  3. ...

Vous pouvez également combiner des listes ordonnées et non ordonnées:

* Pour écrire comme il faut, il vous faut :
*# lire tous les jours
*# écrire tous les jours
*# et X
* Ahah.

Notez qu'il n'y a pas d'espace entre le * et le #

Résultat:

Listes de définitions

Pour insérer une liste de définitions, procédez comme suit avec la signature "dl.":

dl. name:Sir Lancelot of Camelot.
quest:To seek the Holy Grail.
color:Blue.

Qui devient:

name
Sir Lancelot of Camelot.
quest
To seek the Holy Grail.
color
Blue.

Les tableaux

Il n'y a rien de plus facile que de réaliser un tableau tout simple :

|a|b|c|
|1|2|3|

Ceci sera traité pour un rendu comme suit :

a b c
1 2 3

Les notes

Une note est obtenue en utilisant la signature "fn" suivie par un nombre.

Exemple:

fn1. Ceci est la première note.

Affichera ceci:

1 Ceci est la première note.

Cette note peut être référencée n'importe où dans le texte suivant la syntaxe :

Ceci est une référence[1] à la première note.

Qui devient:

Ceci est une référence1 à la première note.

Echappement

Si vous ne voulez pas que Textile traite un de vos blocs, enfermez-le simplement dans des "==" :

p. Paragraphe normal

==
p. Portion échappée ; ne sera pas du tout traitée par Textile.
==

p. Retour à la normale.

Ceci peut aussi être utilisé inline, en désactivant temporairement le formatage :

p. Voici ==*un test*== d'échappement.

Donnera:

Voici un *test* d'échappement.

Et non:

Voici un test d'échappement

Ending

Voilà qui clôt cette brève page d'aide au langage Textile. Vous trouverez plus d'informations (mais attention, c'est également plus technique) sur cette page traduite avec brio par Lordjidane, ainsi qu'ICI et LA.

J'espère que vous avez effectué un agréable voyage et je vous rappelle que des boutiques de souvenirs seront disponibles à la sortie.

Chupon