Sommaire

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 ...