Sphinx 乳胶输出文件名

Question

在运行sphinx-build -b latex ... 时，Sphinx 会将*.tex 文件写入某个输出目录。 *.tex 文件的名称似乎以某种方式源自 conf.py 中设置的 project 标题。

我想将 Sphinx Latex 生成集成到我的构建系统中。对于依赖管理，我需要知道生成的*.tex 文件的确切名称。

有什么方法可以确定生成文件的名称，而无需将该名称硬编码到构建系统中？或者有没有办法手动设置这个名字（不改变project变量）？

Answer 1

根据 mzjn 的建议和Sphinx docs 中的说明，可以通过conf.py 中的latex_documents 选项设置*.tex 和*.pdf 文件的名称。

规范的用例可能是在conf.py的末尾添加以下内容。

#...
latex_documents = [('index', 'doc.tex', project, author, 'manual')]

这最终会产生一个文件doc.pdf。