用户指南使用什么文档系统
What documentation system to use for user guide
我目前正在尝试寻找具有以下功能的文档(用户指南)系统:
- 文本模式的文档文件(所以 svn 可以 diff/merge 它)
- 可以使用图像、table、交叉引用和 table
内容
- 导出为支持交叉引用的 pdf(或 .doc/.odt)
我尝试将 markdown 用于文档源文件,将 pandoc 用于 pdf 导出,但 markdown 不支持 tables。
非常感谢您提供的任何帮助。
对于这种情况,我们使用 Sphinx。
它可以从 reStructuredText 文件生成 html、pdf 和其他一些格式。
如果您想添加复杂的表格,请查看 list-table。
我将 TaX 用于电子和可打印文档
最常用的文档解决方案集可能是 Docbook 或 DITA 中的 XML。您当然可以在 SVN 中管理它们以及执行差异。它们都提供具有多种输出类型的处理工具链,包括 PDF 到 XSL FO。
我目前正在尝试寻找具有以下功能的文档(用户指南)系统:
- 文本模式的文档文件(所以 svn 可以 diff/merge 它)
- 可以使用图像、table、交叉引用和 table 内容
- 导出为支持交叉引用的 pdf(或 .doc/.odt)
我尝试将 markdown 用于文档源文件,将 pandoc 用于 pdf 导出,但 markdown 不支持 tables。
非常感谢您提供的任何帮助。
对于这种情况,我们使用 Sphinx。
它可以从 reStructuredText 文件生成 html、pdf 和其他一些格式。
如果您想添加复杂的表格,请查看 list-table。
我将 TaX 用于电子和可打印文档
最常用的文档解决方案集可能是 Docbook 或 DITA 中的 XML。您当然可以在 SVN 中管理它们以及执行差异。它们都提供具有多种输出类型的处理工具链,包括 PDF 到 XSL FO。