文档管理

Question

我们正在为我们的几个软件应用程序编写文档。这些文档有一些共同的内容片段（例如公司简介等）。

我需要找到一些不错的软件，让我们能够一致地管理这些文档的格式。最好是可以编辑一些全局样式偏好，然后每次发布文档时，它都应该反映更新后的样式。

另外，文档由多个片段组成（公司介绍等公共部分以及产品特定或文档特定部分）。如果能够选择所需的片段并从中组装文档，那就太好了。

有人有这方面的经验吗？

Answer 1

您可以使用模板和自动更新文档样式同步模板的样式格式。

要定义可重复使用的内容片段，请查看使用自动文本。

Answer 2

我对奥地利某公司的帮助和手册有特别好的体验，请参阅公司网站。我们从 2004 年就开始使用它了，它在发布方面比 Word 更灵活。主题以 XML 格式存储，可以通过脚本生成。可以使用 CVS 或 SVN 轻松对文件进行版本控制。

我们使用一个包含 2000 多个主题的大项目来生成单一语言的单个产品手册。一些产品包括其他产品（例如，我们的项目管理解决方案附带查询编辑器，它也作为单独的产品提供）。通过构建变量，我们可以控制在特定产品手册中包含哪些内容。

我们还从主要语言中衍生出英语版本。帮助和手册项目由 OmegaT 处理，OmegaT 是一种计算机辅助翻译工具，开源，但类似于 Trados 或 Memoq。比较荷兰语版手册（基础语言）和翻译版本

一切都可以通过 Apache Ant 构建文件运行。