☰

Sphinx：覆盖文档类

tag-icon • tag-icon document-classes sphinx
Sphinx：覆盖文档类

我用来Sphinx生成多输出文档（Epub、HTML、LaTeX）。如何更改使用 documentclass？

以下代码片段（在我看来）应该覆盖所使用的类，但结果是

% Generated by Sphinx.
\def\sphinxdocclass{scrbook}
\documentclass[,]{sphinxmanual}

这是我的代码conf.py：

latex_elements = {
     'papersize': '',
     'fontpkg': '',
     'fncychap': '',
     'maketitle': '',
     'pointsize': '',
     'preamble': '',
     'releasename': "",
     'babel': '',
     'printindex': '',
     'fontenc': '',
     'docclass':'scrbook',
     'inputenc': '',
     'classoptions': '',
     'utf8extra': '',
 }

这手动的说，它不应该被覆盖，因为其他宏负责设置它。有解决方法吗？

答案1

看着https://github.com/basespace/basespace-python-sdk/blob/master/doc/latex/sphinxmanual.cls看来该类只是加载指定的类，\sphinxdocclass所以生成的代码看起来没问题。

答案2

这来得很晚，但也许有帮助......

我正在运行 sphinx 1.8.2

不要将 docclass 放入latex_elements变量字典，但将其放入latex_docclass字典，包含键 'howto' 和 'manual'。示例代码：

latex_docclass = {
   'howto': 'yourclass1',
   'manual': 'yourclass2',
}

看：https://www.sphinx-doc.org/en/1.8/usage/configuration.html#confval-latex_docclass

相关内容