7

问题：

我有一个包含文档的 xsd 架构，例如：

<xs:element name="Tag" type="XTag">
  <xs:annotation>
    <xs:documentation>
      Do like this:
       - foo
       - bar
    </xs:documentation>
  </xs:annotation>
</xs:element>

当我在 Eclipse 中查看文档时，空白被截断为一个空格，所以我最终得到：

Do like this: - foo - bar

当文档不仅仅是一点注释时，这自然会限制可读性。例如，在 javadoc 中，可以使用一个 html 标签来格式化文档

问题：

有没有办法格式化文档，至少只是添加换行符？

一些细节：

我在 Eclipse 中做所有事情。我编写的 XSD 已添加到 中preferences -> XML -> XML catalog，因此我可以在 XML 编辑器中获得内容帮助和查看文档。

它是一个内部工具，唯一可以预见的查看文档的地方是通过 Eclipse 以上述方式。所以如果它在eclipse中工作，那就足够了:)

4

2 回答 2

6

将您的文档嵌入<![CDATA[ ]]>并使用 html 表达式。下面的示例应该正确呈现。

<xs:annotation>
    <xs:documentation>
    <![CDATA[
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.<br/>
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. 
<p><b>Duis aute</b> irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. </p>
<br/>
<b>Excepteur sint occaecat cupidatat non proident,<br/>
<ul>
    <li>sunt in culpa qui officia</li> 
    <li>deserunt mollit anim</li>
    <li>id est laborum.</li>
</ul>
    ]]>
    </xs:documentation>
</xs:annotation>

使用 Spring Tool Suite v3.6.4 (Eclipse 4.4.2) 测试

于 2015-12-29T19:16:43.770 回答
3

尝试将 html<br/>用于换行符和List<ul><li>item</li></ul>列表项。

不确定您是否应该嵌入“正在建设”的动画 GIF 甚至表格。它在记录 xsd 并使用 oXygen XML 编辑器创建相应的 xml 时对我有用。

于 2012-12-21T13:47:25.867 回答