Fett kursiv in ReStructuredText

Question

Ich schreibe einige Dokumentation mit ReStructuredText (ReST) -Format für die spätere Web-Seite Generation mit Sphinx, und ich kann keine Möglichkeit finden, einige "fett kursiv" Text zu schreiben.

Es gibt Marker für die so genannte 'Betonung' (kursiv) und 'starke Betonung' (fett) Text. Sie sind *italic text* bzw. **bold text**. Ich habe auch in einer Dokumentation zu diesem Format gelesen, dass diese Formatierungsmarker nicht einfach "verschachtelt" werden können. I.e. die ***text*** (oder ** *text* **) produziert nicht die bold italic Text.

Noch sollte es wahrscheinlich einen Weg geben, einen Text zu produzieren, der sowohl mit kursiven als auch kursiven Markierungen hervorgehoben wird, da es eine weitverbreitete Praxis ist, Textstücke auf diese Weise zu markieren.

Answer 1

Obwohl Abschlag Verschachtelung fett und kursiv unterstützt, reStructuredText nicht (dies ist eine der seltenen Fälle, in denen Abschlag stärker ist, da es keine Möglichkeit fett und kursiv in reStructuredText darzustellen ist).

https://gist.github.com/1855764

Answer 2

In Sphinx ist dies möglich durch custome Rollen: Sie machen einen Stil in CSS, und eine Rolle in diesem Stil zeigt machen. Hier ist ein voll funktionsfähiges Beispiel für unterstrichenen Text: sphinx-dev thread.

bearbeiten:

Hier ist ein gutes Beispiel: ReST strikethrough

Answer 3

Rezept für HTML-Ausgabe.

my.rst:

.. role:: red 
    :class: red 

.. role:: boltitalic 
    :class: boltitalic 

:red:`WARNING` :boltitalic:`Don't be stupid!` 

my.css:

.red { color: red; } 
.boltitalic { 
    font-weight: bold; 
    font-style: italic; 
} 

Erstellen von:

rst2html --strip-comments --halt warning --stylesheet=my.css my.rst my.html