Bold w reStructuredText

Question

piszę jakąś dokumentację w formacie reStructuredText (rest) dla późniejszej generacji strony internetowej przy użyciu Sphinx, i nie mogę znaleźć sposób, aby napisać „Bold” tekst.

Istnieją markery do tak zwanego „naciskiem” (kursywa) i „naciskiem” (bold) tekstu. Są to odpowiednio *italic text* i **bold text**. Czytałem również w niektórych dokumentach tego formatu, że te znaczniki formatowania nie mogą być po prostu "zagnieżdżone". To znaczy. ***text*** (lub ** *text* **) nie generuje pogrubionego kursywy w języku angielskim.

Prawdopodobnie powinien istnieć jakiś sposób na podkreślenie tekstu za pomocą pogrubionych i kursywnych znaczników, ponieważ jest to powszechna praktyka znakowania fragmentów tekstu w ten sposób.

Answer 1

Choć Markdown nie obsługuje pogrubienie i kursywa gniazdowania, reStructuredText robi (jest to jeden z nielicznych przypadków, gdzie Markdown jest bardziej wydajny, ponieważ nie ma sposobu, aby reprezentować pogrubioną kursywą w reStructuredText).

https://gist.github.com/1855764

Answer 2

W sfinks jest to możliwe poprzez role logo klienta: Tworzysz styl CSS i dokonać rolę wskazując tym stylu. Oto pełny przykład działania podkreślonego tekstu: sphinx-dev thread.

Edit:

Oto dobry przykład: ReST strikethrough

Answer 3

Przepis na wyjście HTML.

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; 
} 

budowy przez:

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