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 :
En version papier
En version numérique
En illimité avec l'abonnement ENI
Sur la boutique officielle ENI
Conditions générales d'utilisationCopyright - © Editions ENI ||Politique de protection des données du groupe ENI