reStructuredText styles

Question

Я нашел this guide для rst2pdf, чтобы узнать, как создать файл reStructuredText в полученном pdf-документе. Имея следующий в моей JSON таблице стилей, например, успешно применяются к документу всего:

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

Как особый стиль применяется только к определенному классу? Например, как я могу применить конкретный шрифт к классу h1? Мое непосредственное затруднение связано с тем, что я не уверен, действительно ли это называется h1, H1, header1 или Header1.

Answer 1

rst2pdf.py manual не очень информативно относится к названиям стилей. Тем не менее, в разделе Стили (глава 8) имеет следующий пример:

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

Таким образом, кажется, что heading1 является соответствующим именем стиля.

Одна вещь, чтобы отметить, что

Если ваш документ требует стиль, который не определен в таблице стилей, он будет выдавать предупреждение и использовать Bodytext вместо этого.

Предположим, что вы не получаете никаких предупреждений при создании документа, стили должны быть установлены в таблице стилей по умолчанию, поэтому ознакомьтесь с этим, чтобы получить представление о используемых именах стилей.

Вы можете сделать rst2pdf распечатать таблицу стилей по умолчанию с помощью

rst2pdf --print-stylesheet 

Если вы хотите добавить стили, просто создать таблицу стилей (или взять стандартную таблицу стилей и изменить его) и передать его с опцией -s

rst2pdf mydoc.txt -s mystyles.txt