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以上述方式。所以，如果它在日食中有效，那就足够了:)。

Answer 1

尝试使用h {<br/>作为换行符，List<ul><li>item</li></ul>作为列表项。

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

Answer 2

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

如何格式化XSD文档？

2 个答案: