python - 从单个 Sphinx 配置生成多个不同 pdf 的任何方法

Question

我有一个关于项目的很好的 Sphinx 文档，我想扩展它以生成规范等文档。我想要生成 spec-for-foo.pdf

的 spec-for-foo.rst

Answer 1

解决方案是编辑 sphinx conf.py 文件中的 latex_documents 条目，该条目包含 latex 生成的所有文件的描述符.

此配置条目包含一个元组列表，其中包含:(源文件、目标 tex 文件、文档标题、作者和文档类:

latex_documents = [
   ('index', 'Kaskady.tex', u'Kaskady  Documentation',
    u'Author', 'manual'),
   ('profile', 'profiles.tex', u'Wyznaczanie profili', 
    u'Author', 'howto'),
]