wiki / docbook / latex文档模板系统

时间:2010-01-04 10:28:17

标签: python html latex documentation-generation docbook

我正在搜索文档模板系统,或者更确切地说是创建一个。 它应该支持以下功能:

  • 以PDF和HTML格式创建输出
  • 支持大型和&复杂(LaTeX)公式
  • 文件之间的参考
  • 书目
  • 模板将由Python脚本填写

我已尝试使用各种TeX-to-HTML转换器的LaTeX,但我对结果不满意。 我一直在使用DocBook,但我认为编辑DocBook并不容易编写,对公式的支持还不够。

主要问题是,该系统的用户将不知道LaTeX语法或DocBook。我已经考虑过这些用户的另一种选择,即使用Wiki语法(由Python转换为LaTeX)提供编辑可能性。

总结一下:我想从至少LaTeX和Wiki输入中获取HTML和PDF输出。 DocBook可以用作中间格式。

是否有人遇到过类似问题,或者可以就哪些工具以及我应该使用哪种文件格式给出建议?

4 个答案:

答案 0 :(得分:7)

我们使用sphinx:http://sphinx.pocoo.org

它几乎完成所有这些。

你的python脚本或你的用户或任何人(我不能按照这个问题)可以使用RST markup创建内容(这可能是最简单的标记语言)。你通过Sphinx运行它,你得到HTML和Latex。

答案 1 :(得分:1)

我创建了一个LaTeX预处理器和python模块,允许您在LaTeX文件中嵌入python或SQL。执行python和/或SQL并将输出折叠起来。

使用latex2html或latex2rtf,您可以使用LaTeX代码生成HTM和RTF。

我已在http://simson.net/pylatex/

为您发布了该内容

答案 2 :(得分:0)

Arbortext原生支持LaTeX。您可以发送发布引擎或打印作曲家LaTeX,它将直接传递给它。

它还支持许多其他组合语言,甚至可以像在InDesign中看到的那样进行页面布局操作(没有ID的头痛和开销)。

答案 3 :(得分:0)

我认为Asciidoc更适合您想要获得的目标。它是一种简单的标记语言,它允许使用乳胶公式,并生成Docbook文档,您可以从中进一步生成可读的HTML或Latex表示