xsd - xs:documentation 可能包含 HTML 标记吗？

Question

我的目标是为我的网络服务制作程序员手册。有许多工具可以直接从 XSD 源代码生成手册，并且这些工具被<xs:documentation>大量使用。

所以我在我的 XSD 中添加了尽可能多的<xs:documentation>标签。

问题：可能<xs:documentation>包含 HTML 代码，例如超链接？形式上，它可能在 HTML 包含是有效的 XML 时。但是上面提到的手动生成器等第三方工具会支持这些内容吗？

Answer 1

xs3p支持文档元素中的 HTML 标记。HTML 内容必须是格式良好的 XML，HTML 标记应http://www.w3.org/1999/xhtml声明命名空间：

<xs:元素 ...>
  <xs:注解>
    <xs:文档>
      这是
      <code xmlns="http://www.w3.org/1999/xhtml">源代码<code>
      例子
    </xs:文档>
  </xs:注解>
</xs:元素>

Answer 2

xs:documentation 可以包含 XHTML 吗？是的，可能。也就是说，模式文档的模式允许这样做。

工具会用它做一些有用的事情吗？有些会这样做（至少我为在浏览器中显示 XSD 模式文档而编写的样式表会这样做），有些可能不会。如果您想使用的工具不能很好地处理 xs:documentation 元素中的 XHTML，请向开发人员或供应商提出问题。