将 XSD 文档转换为 DocBook答案

【问题标题】：Convert XSD documentation into DocBook将 XSD 文档转换为 DocBook
【发布时间】：2011-03-14 16:21:25
【问题描述】：

我一直在寻找一个模板来实现这一点。显然，只有oXygen 等商业应用程序才能做到这一点。

有没有免费的工具可以做到这一点？或者至少有一个基础模板来自定义而不是从头开始编写它会很棒。

我在 SO 中找到的最接近的提示是 not very promising。

【问题讨论】：

【解决方案1】：

首先，OxygenXML 有一个免费试用许可证，它不会以任何方式为您的输出添加水印。应该是最快的方法了。尽管如此，我还是有点好奇，为什么特别是 Docbook - 它是一种不适合最终用户用户消费的中间格式，我想你的想法是你想从中生成一个漂亮的 PDF 和 HTML？如果是这样的话，这不是一个糟糕的计划。此外，编写自己的 XSL 样式表也不是很多工作，您只需要映射： complexType 和 simpleType 和 element 到 db:section xs:name 到 db:title 和 xd:annotation 到 para 然后您可以使用免费工具（如 saxon 和 docbook 工具包）进行处理。

【讨论】：

您的猜测是正确的，使用 DocBook 获取 PDF 和 HTML ot。我得到了一个自定义的 XSL 样式表。但是，当您拥有复杂/填充的模式结构或诸如“xs:choice”之类的东西时，事情就会变得模糊。