reStructuredText风格

Question

我找到了本指南 for rst2pdf，以了解如何在生成的pdf文档中设置reStructuredText文件的样式。例如，在我的JSON样式表中，它成功地应用于整个文档：

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

如何将特定的样式仅应用于特定的类？例如，如何将特定字体应用于h1类？我现在遇到的困难来自这样一个事实:我不确定它到底是h1、H1、header1还是Header1。

Answer 1

在样式名称方面，手册似乎信息不多。然而，关于样式的一节(第8章)有这样的例子：

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

因此，heading1似乎是合适的样式名称。

有一点要注意的是

如果文档需要样式表中未定义的样式，它将打印警告并使用正文。

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

可以让rst2pdf打印默认样式表。

rst2pdf --print-stylesheet

如果要添加样式，只需创建样式表(或接受标准样式表并对其进行修改)并将其传递给-s选项。

rst2pdf mydoc.txt -s mystyles.txt