Gras italique dans ReStructuredText
J'écris de la documentation en utilisant le format Rest (REST) pour la génération ultérieure de pages web en utilisant Sphinx, et je ne trouve pas de moyen d'écrire du texte "gras italique".
Il y a des marqueurs de la soi-disant 'accent' (italique) et 'accent' (gras) texte. Ils sont *italic text* et **bold text** respectivement. J'ai également lu dans une documentation sur ce format que ces marqueurs de formatage ne peuvent pas être simplement "imbriqués". C'est-à-dire que le ***text*** (ou ** *text* **) ne produit pas le gras italique texte.
Néanmoins, il devrait probablement y avoir un moyen de produire un texte souligné à la fois avec des marqueurs gras et italiques, car il est une pratique répandue de marquer des morceaux de texte de cette façon.
3 réponses
Bien que Markdown supporte l'imbrication gras et italique, reStructuredText ne le fait pas (c'est l'un des rares cas où Markdown est plus puissant, car il n'y a aucun moyen de représenter les italiques gras dans reStructuredText).
Recette pour la sortie HTML.
my.rst:
.. role:: red
:class: red
.. role:: bolditalic
:class: bolditalic
:red:`WARNING` :bolditalic:`Don't be stupid!`
my.css:
.red { color: red; }
.bolditalic {
font-weight: bold;
font-style: italic;
}
Construire par:
rst2html --strip-comments --halt warning --stylesheet=my.css my.rst my.html
Dans sphinx, cela est possible grâce aux rôles custome: vous créez un style en css, et faites un rôle pointant vers ce style. Voici un exemple complet de travail de texte souligné: sphinx-dev thread .
Modifier :
Voici un bon exemple: Reste barré