有哪些维基工具可以从维基生成可发布的用户文档？ [英] What wiki tools exist to generate shippable user doc from a wiki?

问题描述

我正在研究使用wiki（更喜欢mediawiki，但不是一个要求）作为开发人员生成的文档（用户指南，发行说明，应用笔记，错误等）的存储库，来自协作/更新观点一个维基似乎是一个很好的搭配，但是由于本文档将最终发送给客户，我们希望能够将文档的最终状态（例如在发布周期中）导出到不再包含历史记录的静态版本。

I am looking into using a wiki (prefer mediawiki, but not a req.) as the repository for developer generated documentation (User Guides, Release Notes, Application Notes, Errata, etc.) from a collaborative/easy-to-update point of view a wiki seems like a good match, however since this documentation will ultimately ship to customers we want to be able to export the documents in their final state (e.g. during the release cycle) to static versions that no longer include histories.

理想情况下，导出将以非程序员轻松完成更新的形式（即Word文档或清晰的HTML）保留文档。

Ideally the export would leave the document in a form (i.e. word doc, or legible HTML) where updates could be easily made by a non-programmer.

如果细节订购和目录可用，或者事后可以轻松添加，那将是很好的。

It would be good if niceties like section ordering and table of contents were available, or easy to add after the fact.

是否有任何具有这些功能的工具可用？

Are any tools with features like these available?

推荐答案

这听起来像您的开发周期中需要一个步骤，将HTML wiki内容和doc创建他们 - doc / pdf / html以更简单的交付。如果是这样，您可以尝试 Docmosis 或 JODConverter ，可以充当引擎进行转换。最后一步将是如何整合，并自动提取您的维基内容转换为文档。

It sounds like you need a step in your dev cycle that will take your HTML wiki contents and "documentify" them - doc/pdf/html for simpler delivery. If that's right, you could try something like Docmosis or JODConverter which can act as engines to do the conversion. The last step would be working out how to integrate it and have it automatically extract your wiki content to transform into a document.

这篇关于有哪些维基工具可以从维基生成可发布的用户文档？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！