reStructuredText

1. Présentation

reStructuredText est un autre format de présentation au même titre que Markdown. Il est un peu moins populaire que Markdown, mais propose certaines options qui sont absentes de Markdown.

La documentation officielle est très complète : http://docutils.sourceforge.net/rst.html#reference-documentation

La présentation de la syntaxe de reStructuredText sera plus succincte, car il convient à des usages plus poussés que Markdown et son apprentissage dépasse le cadre de ce livre. Il convient juste de garder à l’esprit que les possibilités de reStructuredText vont bien au-delà des quelques exemples ci-dessous.

Les fichiers reStructuredText portent généralement l’extension .rst.

2. Éléments de syntaxe

a. Titres

Pour les titres, il faut souligner ceux avec une suite de caractères. Ces caractères peuvent être nombreux. Voici la liste, conseillée par la documentation officielle, des caractères utilisables pour définir les titres : = - ` : . ’ " ~ ^ _ * + #

Voici un exemple composé de plusieurs titres :

Titre de niveau 1 
=================== 
 
Titre de niveau 2 
---------------------- 
 
Titre de niveau 1 
=================== 

La hiérarchie des titres n’est pas définie par le format, c’est-à-dire que reStructuredText va directement choisir les niveaux qui conviennent. Pour le premier titre qu’il...

Pour consulter la suite, découvrez le livre suivant :
couv_EP2GIT.png
60-signet.svg
En version papier
20-ecran_lettre.svg
En version numérique
41-logo_abonnement.svg
En illimité avec l'abonnement ENI
130-boutique.svg
Sur la boutique officielle ENI
Précédent
Markdown
Suivant
Outils pour travailler avec Markdown