Xml 如何格式化XSD文档?
问题: 我有一个包含文档的xsd模式,如:Xml 如何格式化XSD文档?,xml,xsd,Xml,Xsd,问题: 我有一个包含文档的xsd模式,如: <xs:element name="Tag" type="XTag"> <xs:annotation> <xs:documentation> Do like this: - foo - bar </xs:documentation> </xs:annotation> </xs:element> 当文档不仅仅是一个小注
<xs:element name="Tag" type="XTag">
<xs:annotation>
<xs:documentation>
Do like this:
- foo
- bar
</xs:documentation>
</xs:annotation>
</xs:element>
当文档不仅仅是一个小注释时,这自然会限制可读性。例如,在javadoc中,可以使用一个html标记来格式化文档
问题:
有没有办法格式化文档,至少是添加换行符
一些细节:
我在Eclipse中做所有的事情。我编写的XSD被添加到首选项->XML->XML目录中
,因此我可以在XML编辑器中获得内容帮助并查看文档
它是一个内部工具,可以预见的唯一查看文档的地方就是通过Eclipse以上述方式查看文档。因此,如果它在eclipse中工作,就足够了:)尝试使用类似于
的html作为换行符,使用List- 项作为列表项
不确定是否应该嵌入“正在构建”的动画GIF,甚至是表格。
在我编写xsd文档并使用oXygen xml编辑器创建相应的xml时,它对我起到了作用。将文档嵌入
并使用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工具套件v3.6.4(Eclipse4.4.2)进行测试。它适用于某些标记,例如,
和
,但不适用于在Eclipse工具提示中显示不变的
。一个重要的注意事项是,必须避开括号,因此
变成br/
。如果你不这么做,Eclipse将跳过标签和它的内容。这听起来是一个很好的解决方案,但我自己无法再确认。如果其他人可以确认这是有效的,我会接受这是正确的答案。我正在使用DocFlex/XML生成我的XSD文档,因此这不起作用。
<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>