如何将xsd转换为人类可读的文档?

我们有几个基于XML的接口,在XSD模式中有很好的logging。 接口现在将公开可用,我们想为它们创build参考文档。

有没有一种工具可以自动将XSD文件转换为更可读的格式?

x3sp可能会做你想要的: http ://xml.fiforms.org/xs3p/

将其插入到XSD的顶部

<?xml version="1.0" encoding="UTF-8"?> <?xml-stylesheet type="text/xsl" href="xs3p.xsl"?> 

然后,您可以使用Web浏览器直接查看XSD文件。 Web浏览器使用指定的XSLT进行HTML转换。

您不需要XSL处理器,但是像xs3p这样的样式表不会使用这种方法生成链接。 我使用的Firefox浏览器,IE8似乎没有用。

我已经尝试了这些xsl样式表: https : //sourceforge.net/projects/xs3p/files/xs3p-1.1.3.zip/download http://crism.maden.org/consulting/pub/xsl/xsd2html.xsl

我想我更喜欢xs3p。

oXygen拥有非常好的XSD架构文档工具 ,可以通过选项和额外的CSS文件轻松定制。

我之前没有使用它,但DocFlex / XML是一个带有名为XSD Doc的XSD文档组件的XML文档工具,看起来很有趣。

正如在其他答案中指出的那样,XSD只是一个XML文件,所以可以编写一个自定义的XSLT来生成您喜欢的任何文档输出。

一个XSLT脚本可以完成这项工作。

如果您不希望使用通用工具来logging您的模式,那么可能性相当不错。 模式文档工具(我最熟悉XML Spy中的工具)旨在使模式可读。 从你的描述来看,这听起来并不是你想要的; 你想要的是用你架构中的信息作为软件文档的基础。

当我需要这样做的时候,我采取的方法是deviseHTML,看起来像我需要的文档看,然后找出我需要抓住的模式中的信息来填充它。 使用它作为模板,使用XSLT从模式中获取相关信息非常简单。

我在过去使用我在Freshmeat.net上find的名为xsddoc的工具生成了文档。 现在查看它(直接链接),我发现它已经被开发人员用一个名为xnsdoc的工具取代了。 较新的一个免费供开放源码项目使用,但是如果您使用的是商业产品,则可能需要对其进行许可。 如果在“xsddoc”横幅下发布的最新版本适合您的用途,那么您可以使用该版本。

它生成的文档具有Javadoc的外观和风格,并允许在样式表中进行一定程度的控制。

如果您准备深入研究Sandcastle的复杂性,我强烈推荐XML Schema Documenter ,它是Sandcastle帮助文件生成器的插件。

可能的输出与Sandcastle相同:网站,HTML帮助(CHM)文件, MS帮助2内容, MS帮助查看器1 …

它不应该很难转换(或提前写)为docbook格式。