使用没有标题页的块诊断图生成 Sphinx 文档

Question

我正在尝试使用 Sphinx 生成带有附带说明 table 的块诊断图，如 blockdiag 文档中 "desctable" here 下的示例中所述。我建立了一个非常简单的狮身人面像项目；主 .rst 文件中没有任何内容，除了：

.. blockdiag::
   :desctable:

   blockdiag {
      A -> B -> C;
      A [description = "browsers in each client"];
      B [description = "web server"];
      C [description = "database server"];
   }

当我运行 "make latexpdf" 时，它会生成一个包含所需图表和说明的 PDF 文件 table。但是，它也会生成很多不必要的页面，包括标题页、填充页和空的 table 内容。

我的问题是：有没有办法去掉填充页？我只想要图表和说明 table，在一页上，pdf 中没有其他内容。

formatting/headers/footers/filler 东西越少越好。我会避免使用 Sphinx，但 blockdiag 中的描述选项似乎只适用于 Sphinx。

免责声明：我是 Sphinx 的新手（一个小时前才开始尝试）。另外，我无法从 Sphinx 文档中弄清楚，但也许我只是没有搜索正确的术语。

任何帮助将不胜感激！

Answer 1

没关系，我想通了。在 conf.py 中，我只需要设置

latex_elements = {
'maketitle': '', 
'tableofcontents': '',
}

这会删除所有我想删除的填充页。

使用没有标题页的块诊断图生成 Sphinx 文档

Generating a Sphinx document with a blockdiag diagram without title pages

documentation-generation

pypi

python-sphinx