2010-06-02 55 views
1

我正在寻找使用wiki(更喜欢mediawiki,但不是req。)作为开发人员生成的文档(用户指南,发行说明,应用笔记,勘误表等)从协作/易于更新观点维基似乎是一个很好的匹配,但是因为这个文档最终会发送给客户,所以我们希望能够将文档以其最终状态(例如,发布周期期间)导出到不再包括历史记录的静态版本。有哪些wiki工具可以从wiki中生成可发布的用户文档?

理想情况下,导出会将文档保留为非程序员可轻松更新的格式(即文档文档或HTML)。

如果细节订购和目录等细节可用,或者事后添加容易,这将是一件好事。

是否提供具有这些功能的工具?

回答

1

听起来你需要在你的开发周期中采取步骤,将你的HTML维基内容和“documentify”他们 - doc/pdf/html以简化交付。如果这是正确的,你可以尝试像DocmosisJODConverter这可以作为引擎来做转换。最后一步是如何整合它并让它自动提取你的wiki内容以转换成文档。

0

我有点困惑。

如果您想要像HTML一样正式发布文档,用户将如何继续编辑? (使用DumpHTML生成HTML)。

如果您希望以Wiki格式发送文档并允许用户继续编辑,那么为什么不直接复制数据库并在某个点删除更改历史记录呢? AFAIK MediaWiki对此有一些支持。

+0

而不是用户,技术作家和评论家。该过程将运行如下代码:开发代码和doc - >分支代码和导出doc(此时文档不再位于wiki中,但仍可能在分支的生命周期中更新)。 – tletnes 2010-06-02 16:33:27

0

一个选项是Mylyn WikiText,某些Eclipse项目使用该选项生成Eclipse文档from the Eclipse wiki(基于mediawiki)。 WikiText还支持其他wiki标记(trac,textile等)和其他输出格式(docbook,HTML等)。

0

在MoinMoin Wiki中,您可以导出到DocBook。 DocBook可以转换为专业外观的PDF。

0

DokuWiki使用纯文本文件作为存储后端,可以将其作为文档简单复制到项目中。

0

首先,不要打折MediaWiki具有永久链接功能。所以,如果你允许读者访问你的wiki,你可以给他们发送一个URL为特定版本的页面

替代品 - 您可以打印PDF。维基百科使用Collection扩展名,但有others

最后,如果你使用Firefox并希望客户端解决方案,使用PrintPDF

相关问题