允许可重用​​性和Markdown支持的文档系统？

Question

我正在研究保持项目的不同文档系统。最近我一直在使用DITA和DITA OT，但它的复杂性使我想要自己拍摄。

是否有任何系统提供以下功能：

• Markdown支持
• 可重复使用的内容（我可以参考之前定义的段落或术语）
• 本地化支持
• 优选地，免费或开源
• 优选地，允许多输出

我希望我可以使用Pandoc，但它似乎不支持可重复使用的内容。

编辑：我刚刚为此编写了自己的库：https://github.com/gjtorikian/markdown_conrefs

Answer 1

如果你不介意reStructuredText而不是降价，Sphynx值得一看。

Answer 2

您可以使用pandoc + pre或post处理器。

通过这种方式，您可以轻松实现代码段重用。

Answer 3

这是一个让我心动的话题。那里有很多Markdown处理器选项，但在撰写本文时，这些更多是针对这个持久性问题的个人解决方案。我们都会感到沮丧，在短期内提供帮助并分享。

挑战在于将其扩展到为了目的和规模而建造的东西。这是我过去几年把焦点转移到哪里的地方。这包括首先在Red Hat的一个技术写作团队内部开发PressGang CCMS，然后受到启发，分拆Corilla，一个专门的技术写作初创公司，构建您需要的工具。

PressGang（原型）

请参考PressGang CCMS项目，了解我们在红帽上所做的工作，以构建解决此问题的工具。首席工程师做了run-through video，你可以在Vimeo上看到，如果你想尝试，我已经创建了一个公共Amazon AMI。它没有得到维护，但它都是开源的。

它是一个相对较大的堆栈，大部分都是用Java编写的，但在查看这个空间中的开源项目时非常有用。但有偏见，我建议......

Corilla（产品）

我们共同创建Corilla作为一家开源公司，专注于将内容重用和协作的元素与Markdown和Asciidoc轻松结合在一起。我花了数年时间编写DocBook XML，并快速构建了自己的snippets for Sublime Text，以最大限度地减少该标记中创作的巨大开销。潮流当然是转折。我们需要更简单的写入方式，我们需要它们可被发现，可重用，并允许整个团队以他们需要的格式生成内容。

我鼓励您参与测试，因为技术写作和开发人员社区正在推动项目，并且我们一起解决问题。能够资源化并将其推向市场比获得不完整的处理器链更有价值。我去过那里，是时候我们做得更多了。