L'altra risposta qui accenna a quello che volevo fare, ma assume una certa conoscenza dettagliata su fogli di stile in docutils. Ecco una spiegazione libro di cucina:
Nel file RST, dichiarare il ruolo una volta, quindi utilizzarlo:
.. role:: red
This text is :red:`colored red` and so is :red:`this`
allora avete bisogno di un file di foglio di stile. In primo luogo, utilizzare Python per copiare il foglio di stile predefinito dal pacchetto docutils:
python
import os.path
import shutil
import docutils.writers.html4css1 as h
shutil.copy(os.path.dirname(h.__file__)+"/html4css1.css","my.css")
Poi modificare my.css per aggiungere le personalizzazioni alla fine:
.red {
color: red;
}
Creare un file di configurazione docutils denominato " docutils.conf ":
[html4css1 writer]
stylesheet-path: my.css
embed-stylesheet: yes
uso rst2html.py per convertire il documento:
rst2html.py my_document.rst > my_document.html
Se non si desidera utilizzare docutils.conf, è possibile specificare il foglio di stile ogni volta che si esegue rst2html:
rst2html.py --stylesheet my.css my_document.rst > my_document.html
per quanto ne so, non c'è modo di specificare il foglio di stile nel file RST.
E 'possibile definire globalmente il ruolo una volta in conf.py invece di definirlo in tutti i primi file in cui è usato? – locke14