问题:
我有一个包含文档的 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 中工作,那就足够了:)
最佳答案
将您的文档嵌入 <![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) 测试
关于xml - 如何格式化 XSD 文档?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/11105118/