reStructuredText style

Question

Znalazłem this guide dla rst2pdf, aby dowiedzieć się, jak stylizować plik reStructuredText w wynikowym dokumencie PDF. Uwzględniając następujące JSON w moim arkusza stylów, na przykład, jest z powodzeniem stosowana do dokumentu cały:

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

Jak to szczególny styl zastosowane tylko do określonej klasy? Na przykład, jak mogę zastosować konkretną czcionkę do klasy h1? Moja bezpośrednia trudność wynika z faktu, że nie jestem pewien, czy faktycznie jest on nazywany h1, H1, header1 lub Header1.

Answer 1

Numer rst2pdf.py manual nie wydaje się zbyt interesujący w odniesieniu do nazw stylów. Jednak sekcja na Styl (rozdział 8) ma następujący przykład:

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

Wygląda więc na to, że heading1 jest odpowiednia nazwa stylu.

Jedną rzeczą jest, aby pamiętać, że

Jeśli dokument wymaga styl, który nie jest zdefiniowany w arkuszu stylów, to wydrukować ostrzeżenie i zamiast używać bodytext.

Więc zakładając, że nie dostaniesz żadnych ostrzeżeń podczas generowania dokumentu style musi być ustawiony w domyślnym arkuszu stylów, więc spojrzeć przez to poczuć nazwami używanego stylu.

Można dokonać rst2pdf wydrukować domyślnego arkusza stylów przy użyciu

rst2pdf --print-stylesheet 

Jeśli chcesz dodać style, wystarczy utworzyć arkusz stylów (lub wziąć standardowego arkusza stylów i modyfikować) i przekazać go z opcją -s

rst2pdf mydoc.txt -s mystyles.txt