stili ReStructuredText

Question

Ho trovato this guide per rst2pdf per informazioni su come impostare un file di reStructuredText nel documento PDF risultante. Avente la seguente nel mio JSON foglio di stile, per esempio, viene applicato con successo al documento tutta:

"pageSetup" : { 
    "size": "A4", 
    "width": null, 
    "height": null, 
    "margin-top": "2cm", 
    [...] 
    "margin-gutter": "0cm" 
} 

Come è un particolare stile applicato solo a una classe specifica? Ad esempio, come posso applicare un font particolare alla classe h1? La mia difficoltà immediata deriva dal fatto che non sono sicuro se sia effettivamente chiamato h1, H1, header1 o Header1.

Answer 1

Il rst2pdf.py manual non sembra molto informativo per quanto riguarda i nomi di stile. Tuttavia, la sezione su Styles (capitolo 8) ha questo esempio:

["heading1" , { 
    "parent": "normal", 
    "fontName": "Tuffy_Bold", 
    "fontSize": 18, 
    "keepWithNext": true, 
    "spaceAfter": 6 
}], 

Così sembra che heading1 è il nome dello stile appropriato.

Una cosa da notare è che

Se il documento richiede uno stile che non è definito nel foglio di stile, si stamperà un avvertimento e utilizzare bodytext invece.

Quindi presumendo che non si ottengano avvisi durante la generazione del documento, gli stili devono essere impostati nel foglio di stile predefinito, quindi dare un'occhiata a questo per avere un'idea dei nomi di stile utilizzati.

È possibile effettuare rst2pdf stampare il foglio di stile predefinito utilizzando

rst2pdf --print-stylesheet 

Se si desidera aggiungere gli stili, basta creare un foglio di stile, (o prendere il foglio di stile di serie e modificarlo) e passarlo con l'opzione -s

rst2pdf mydoc.txt -s mystyles.txt