Стили reStructuredText

Question

Я нашел это руководство для 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 Руководство не кажется очень информативным в отношении названий стилей. Тем не менее, раздел о стилях (глава 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