7

問題：

次のようなドキュメントが含まれた xsd スキーマがあります。

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

Eclipse でドキュメントを表示すると、空白が 1 つのスペースに切り捨てられるため、次のようになります。

Do like this: - foo - bar

これは、ドキュメンテーションがちょっとしたメモ以上のものである場合、当然読みやすさを制限します。たとえば、javadoc では、html タグを 1 つ使用してドキュメントをフォーマットできます。

質問：

少なくとも改行を追加するだけで、ドキュメントをフォーマットする方法はありますか?

いくつかの詳細:

私はEclipseですべてをやっています。XSD i write が に追加されたpreferences -> XML -> XML catalogので、コンテンツ アシストを取得し、XML エディターでドキュメントを表示できます。

これは内部ツールであり、ドキュメントが表示される唯一の予見可能な場所は、上記の方法で Eclipse を使用することです。したがって、Eclipseで機能する場合は、それで十分です:)

4

2 に答える 2

3

<br/>改行やList<ul><li>item</li></ul>リスト項目のような html を使用してみてください。

ただし、「作成中」のアニメーション GIF やテーブルを埋め込む必要があるかどうかはわかりません。xsd を文書化し、oXygen XML エディターを使用して対応する xml を作成している間、それは私にとってはうまくいきました。

于 2012-12-21T13:47:25.867 に答える