stylesheet - 重构文本样式

Question

我找到了 this guide为 rst2pdf了解如何在生成的 pdf 文档中设置 reStructuredText 文件的样式。例如，在我的 JSON 样式表中包含以下内容，它已成功应用于整个文档:

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

特定样式如何仅应用于特定类？例如，如何将特定字体应用到 h1类(class)？我的直接困难源于这样一个事实，即我不确定它是否真的被称为 h1 , H1 , header1 , 或 Header1 .

Answer 1

rst2pdf.py manual关于样式名称的信息似乎不是很丰富。但是，样式部分(第 8 章)有这个例子:

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

所以似乎 heading1是适当的样式名称。

需要注意的一件事是

If your document requires a style that is not defined in your stylesheet, it will print a warning and use bodytext instead.

因此，假设您在生成文档时没有收到任何警告，则必须在默认样式表中设置样式，因此请查看此文件以了解所使用的样式名称。

您可以使用 rst2pdf 打印默认样式表

rst2pdf --print-stylesheet

如果要添加样式，只需创建一个样式表，(或采用标准样式表并修改它)并使用 -s 选项传递它

rst2pdf mydoc.txt -s mystyles.txt