ReST barrato

È ansible inserire il testo in Restructured Text?

Qualcosa che ad esempio viene visualizzato come tag quando viene convertito in HTML, come: ReSTructuredText

Ho controllato meglio i documenti, come suggerito da Ville Säävuori, e ho deciso di aggiungere il barrato in questo modo:

 .. role:: strike :class: strike 

Nel documento, questo può essere applicato come segue:

 :strike:`This text is crossed out` 

Quindi nel mio file css ho una voce:

 .strike { text-decoration: line-through; } 

Ci sono almeno tre modi per farlo:

 .. role:: strike An example of :strike:`strike through text`. .. container:: strike Here the full block of test is striked through. An undecorated paragraph. .. class:: strike This paragraph too is is striked through. .. admonition:: cancelled :class: strike I strike through cancelled text. 

Dopo aver applicato rst2html ottieni:

 

An example of strike through text.

Here the full block of test is striked through.

An undecorated paragraph.

This paragraph too is is striked through.

cancelled

I strike through cancelled text.

Li usi con uno stile

 .strike { text-decoration: line-through; } 

Qui ho preso la direttiva di admonition come esempio ma qualsiasi direttiva che permetta l’opzione :class: farebbe.

Poiché genera una span la direttiva di role è l’unica che consente di applicare il tuo stile a una parte di un paragrafo.

È ridondante aggiungere un avvertimento di class a una direttiva chiamata anche strike , come suggerito da Gozzilli, perché il nome della direttiva è la class predefinita per l’output html.

Ho controllato queste syntax sia con rest2html con Sphinx . Ma mentre tutto funziona come previsto con rest2html la direttiva di class fallisce con Sphinx . Devi sostituirlo con

 .. rst-class:: strike This paragraph too is is striked through. 

Questo è affermato solo in una piccola nota a piè di pagina di Sphinx reSt Primer .

Secondo le specifiche ufficiali non esiste una direttiva per il mark- to barrato in ReST.

Tuttavia, se l’ambiente consente: raw: role o sei in grado di scrivere i tuoi ruoli, puoi scrivere un plugin personalizzato per questo.

Ho trovato le altre risposte molto utili. Non ho molta familiarità con Sphinx ma lo sto usando per un progetto. Anch’io volevo l’abilità di strike-through e ho lavorato sulla base delle risposte precedenti. Per essere chiari, ho aggiunto il mio ruolo di barrato come menzionato da gozzilli, ma l’ho salvato nella mia conf.py usando la variabile rst_prolog come discusso nel thread di overflow dello stack qui . Questo significa che questo ruolo è disponibile per tutti i tuoi file di rest.

Ho quindi esteso il modello HTML di base come descritto sopra creando layout.html all’interno di _templates all’interno della mia directory di origine. I contenuti di questo file sono:

 {% extends "!layout.html" %} {% set css_files = css_files + ["_static/myStyle.css"] %} 

Questo include fondamentalmente un file CSS personalizzato per tutti i documenti HTML predefiniti.

Infine, nella mia directory _static all’interno della mia directory di origine ho incluso il file myStyle.css che contiene:

 .strike { text-decoration: line-through; } 

Quali altre risposte hanno già fornito.

Sto semplicemente scrivendo questa risposta in quanto non era ovvio per me con la mia limitata esperienza Sphinx che i file da modificare.