python - wiki/docbook/latex文档模板系统

Question

我正在寻找一个文档模板系统，或者更确切地说，我将创建一个。它应该支持以下功能:

• 创建 PDF 和 HTML 输出
• 支持大型复杂 (LaTeX) 公式
• 文档之间的引用
• 引用书目
• 模板将由 Python 脚本填充

我尝试过 LaTeX 与各种 TeX-to-HTML 转换器，但我对结果不满意。我用DocBook有一段时间了，但是我觉得编辑DocBook不好写，对公式的支持也不够。

主要问题是，这个系统的用户会不知道 LaTeX 语法或 DocBook。我已经考虑过为这些用户提供一种使用 Wiki 语法进行编辑的替代方案(由 Python 转换为 LaTeX)。

让我们总结一下:我希望至少从 LaTeX 和 Wiki 输入中输出 HTML 和 PDF。 DocBook 可以用作中间格式。

有没有人遇到过类似的问题，或者可以就我应该使用哪些工具和哪些文件格式给我建议？

Answer 1

我们使用狮身人面像:https://www.sphinx-doc.org

它几乎完成了所有这些工作。

您的 python 脚本或您的用户或任何人(我无法理解这个问题)可以使用 RST markup 创建内容(这可能是最简单的标记语言)。您通过 Sphinx 运行它并获得 HTML 和 Latex。