2012-08-16 44 views
29

Estoy escribiendo algunos documentos utilizando el formato ReStructuredText (ReST) para la última generación de páginas web con Sphinx, y no encuentro la forma de escribir texto en "negrita cursiva".negrita cursiva en ReStructuredText

Hay marcadores para el llamado 'énfasis' (cursiva ) y 'fuerte énfasis' (negrita) texto. Son *italic text* y **bold text** respectivamente. También leí en algunos documentos sobre este formato que estos marcadores de formato no pueden ser simplemente "anidados". Es decir. el ***text*** (o ** *text* **) no produce el negrita cursiva texto.

Todavía debe haber alguna manera de producir un texto enfatizado tanto con marcadores en negrita como en cursiva, ya que es una práctica generalizada marcar partes de texto de esa manera.

Respuesta

17

no Aunque Markdown soporta anidación en negrita y cursiva, reStructuredText hace (este es uno de los raros casos en que Markdown es más potente, ya que no hay manera de representar en negrita y cursiva reStructuredText).

https://gist.github.com/1855764

+6

uno de los casos raros, pero importante! – Dacav

+5

No, esto es incorrecto ("no hay forma de representar negrita y cursiva en reStructuredText"). En realidad, hay varios métodos diferentes (como lo señalaron otros encuestados). Sin embargo, aceptaré que es desafortunado que no se admita "fuera de la caja" por medio de triple '*' a cada lado de la cadena ... – mac

8

En esfinge esto es posible a través de roles atención al cliente al: Haces un estilo en CSS, y hacer un papel que apunta a ese estilo. Aquí hay un ejemplo completo de trabajo de texto subrayado: sphinx-dev thread.

Editar:

He aquí un buen ejemplo: ReST strikethrough

8

Receta para la salida 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; 
} 

Construir por:

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