Les raccourcis typographiques


Pour faciliter la mise en page des documents publiés avec SPIP, le système propose un certain nombre de « raccourcis typographiques » destinés à :

  • simplifier l'utilisation par des utilisateurs ne connaissant pas le code HTML
  • faciliter le traitement automatique de la mise en page.

Paragraphes et retours à la ligne

Pour créer des paragraphes, il suffit de sauter une ligne.

Pour faire un simple retour à la ligne, il faut mettre un
_ (underscore) suivi d'un espace au début de la ligne suivante.

Gras et italique

On indique simplement du texte en italique en le plaçant entre des accolades simples : ...{du texte en italique}... .
On indique du texte en gras en le plaçant entre des accolades doubles : ...{{du texte en gras}}... .

Intertitres

Les intertitres sont des titres à l'intérieur d'un texte permettant d'en indiquer la structure (comme ceux présents sur cette page). Dans SPIP, on les indique très simplement en les plaçant entre des accolades triples : {{{Un titre de partie}}} .

Trait de séparation horizontal

Il est très simple d'insérer un trait de séparation horizontal sur toute la largeur du texte : il suffit de placer une ligne ne contenant qu'une succession d'au moins quatre tirets, ainsi :
----
donnera :


Listes

On peut fabriquer des listes dans SPIP : il suffit de revenir à la ligne et de commencer la nouvelle ligne avec un tiret (« - »).
Notez : ici un simple retour à la ligne suffit (on peut faire des énumérations dans le même paragraphe) ; mais si l'on « saute » une ligne avant la ligne commençant par un tiret, une ligne vide est affichée avant l'énumération. Exemple :

bla bla
bla bla

bla bla

Les liens hypertextes

On fabriquera facilement un lien hypertexte avec le code suivant : [texte du lien->URL]
SPIP est une initiative d'[uZine->http://www.uzine.net/].
devient :
SPIP est une initiative d'uZine.

L'URL peut être une adresse absolue (commençant, comme ici, par http://), une adresse relative (vers une autre page du même site), un lien vers un document utilisant un protocole de l'internet (ftp://...), une adresse email (mailto:minirezo@rezo.net)...

Liens hypertextes à l'intérieur du site
Ce même système de liens hypertextes facilite, de plus, la création de liens à l'intérieur de votre site sous SPIP. La seule subtilité consiste à repérer le numéro de l'article, de la rubrique, ou de la brève vers laquelle vous voulez mener votre lien hypertexte : lorsque vous « visitez », dans l'espace privé, un article, une brève ou une rubrique, la colonne de gauche contient un pavé indiquant, en gros caractères, ce numéro. C'est ce numéro que vous allez indiquer dans le lien hypertexte :

  • Lien vers l'article 342 : [l'article->art342]
    pour sa part, [->art342] affichera le titre de l'article 342 avec un lien vers cet article.
  • Rubriques : [->rub12]
  • Brèves : [->br65]
  • Auteurs : [->aut13]
  • Mots-clés : [->mot32]
  • Sites : [->site1]

Notes de bas de page

Une note de bas de page est, habituellement, signalée par un numéro placé à l'intérieur du texte, numéro repris en bas de page et proposant un complément d'information.

Dans SPIP, cette fonctionnalité (assez lourde à gérer manuellement en HTML) est automatisée : les notes sont numérotées par SPIP, qui gère également des liens hypertextes à l'intérieur du document pour passer directement de l'appel de note au texte de la note correspondante, et vice-versa. Une note de bas de page est indiquée, dans SPIP, entre doubles crochets :
Une note [[Voici un complément d'information.]] de bas de page.
donnera :
Une note [1] de bas de page. (le numéro 1 sera incrémenté automatiquement pour chaque nouvelle note).

Tableaux

Pour réaliser des tableaux dans SPIP, il suffit de faire des lignes dont les « cases » sont séparées par le symbole « | » (pipe ou trait vertical), lignes commençant et se terminant par des traits verticaux. Il est impératif de laisser des lignes vides avant et après ce tableau.
Par exemple :

| {{Nom}} | {{Prénom}} | {{Age}} |
| Marso | Ben | 23 ans |
| Capitaine | | non connu |
| Philant | Philippe | 46 ans |
| Cadoc | Bébé | 4 mois |

donnera :

Nom Prénom Age
Marso Ben 23 ans
Capitaine non connu
Philant Philippe 46 ans
Cadoc Bébé 4 mois
Voilà tous les raccourcis qu'il vous faudra connaitre, pour "bien" débuter avec SPIP. Mais il en existe d'autres que vous retrouverez dans l'interface d'administration : l'aide en ligne.
[1] Voici un complément d'information.