如何记录XML Schema？

Question

如何记录XML Schema？

3

我已经为我编写的应用程序开发了一个XML模式。现在，我想为最终用户记录有效的结构，但是我无法想出任何自然的方法来做到这一点。我看到过像xs3p这样的东西，它基本上将xsd模式转换为HTML表示形式，但是那对我来说不像好的文档；用户不应该需要知道关于模式的任何内容才能理解他可以做什么。

有什么想法如何记录这个？有任何程序/编辑器/图形解决方案或者简单的概念可以建立在此基础之上吗？

- lucas clemente

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Aravind Yarram · Accepted Answer

在我看来，最好的方法是使用专为此设计的 xsd:documentation 和 xsd:annotation（在使用xsd和设计/编写系统到系统接口方面有6年经验后）。这样XSD就是自描述的（就像您在源代码中拥有的Java文档）并且文档始终随XSD一起分发。请查看这里的示例以及在XML编辑器中如何显示文档。 alt text

如果您不想这样做，那么我建议您查看此帖子如何将xsd转换为人类可读的文档？。