xml - 如何格式化 XSD 文档？

Question

问题:

我有一个包含文档的 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 中工作，那就足够了:)

Answer 1

将您的文档嵌入 <![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) 测试