reStructuredText风格

Question

我发现this guide为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 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