Rst2pdf:Shinx-定义自定义样式的文件格式混乱

Question

我对多个资源说以不同的方式定义自定义PDF样式感到困惑。它的文件格式是什么(.styles或.json(？

这是我目前的文件夹结构：

/home/sachin/Workspace/Sootballs/pa-amr/docs/.rst2pdf/config/rst2pdf.conf

# This is an example config file. Modify and place in ~/.rst2pdf/config
[general]
# A comma-separated list of custom stylesheets. Example:
# A comma-separated list of custom stylesheets. Example:
# stylesheets="fruity.json,a4paper.json,verasans.json"
stylesheets="paamr.json"
# A colon-separated list of folders to search for stylesheets. Example:
# stylesheet_path="~/styles:/usr/share/styles"
# stylesheet_path="~/Workspace/Sootballs/pa-amr/docs/paamr.style"
stylesheet_path="../styles/paamr.style"   //CONFUSED HERE: Is this how to define styles?

在paamr.style-定义我的自定义样式。

# List any fonts you would like to embed in the PDF here
embeddedFonts: []
# Default page setup.  Can be overridden by including other
# stylesheets with -s
pageSetup:
size: A4
width: null
height: null
margin-top: 2cm
margin-bottom: 2cm
margin-left: 2cm
margin-right: 2cm
margin-gutter: 0cm
spacing-header: 5mm
spacing-footer: 5mm

或者我应该在/home/sachin/Workspace/Sootballs/pa-amr/docs/_styles/paamr.json中定义我的自定义样式吗

{
"fontsAlias": {
"stdFont": "Times-Roman",
"stdBold": "Times-Bold",
"stdItalic": "Times-Italic",
"stdBoldItalic": "Times-BoldItalic"
}
}

Answer 1

这在不同版本之间发生了变化。v0.99以后的版本使用json格式，但您也可以使用yaml，这可能更容易操作和编辑。文档还没有很好地更新，但我正在积极使用该工具(免责声明，我现在也是维护人员之一(，如果有用的话，我可以回答更多问题。