reStructuredText样式

Question

我找到了rst2pdf的这个指南,以了解如何在生成的pdf文档中设置reStructuredText文件的样式.例如,在我的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