0

XMLがどのように見えるかをユーザーに理解させる簡単な方法として、XMLコメントのコード例ブロックを使用しています。これは非常に大まかな解決策であり、最終的にはxml文字列のXMLスキーマがユーザーに提供されます。ただし、今のところ、この情報をdoxygenベースのドキュメントで提供するだけです。

たとえば、私は次のようなものを持っています：

/// <example>
/// <code>
///   <!-- xml will go below this comment, but I can't display the comment! -->
/// </code>
/// </example>

ドキュメントを見ると、コメントのある行は空白行として表示されます。

&lt;とでエスケープしようとしましたが&gt;、使用しようとしましたが<CDATA[<!-- comment -->]]>、成功しませんでした。エスケープシーケンスはそのまま表示されCDATA、文字データが表示されないことを除いて、そのまま表示されます。

ここで何が恋しかったですか？:)

編集-これはIntellisenseが情報をレンダリングする際の問題ではないことを明確にする必要があります。DoxygenによってCHMに（HTMLヘルプワークショップを介して）レンダリングされたときに、XMLコメントが正しく表示されるようにしたいと思います。

4

2 に答える 2

1

XMLソースがどこに表示されているのかわかりませんが、関数またはクラスのドキュメントにありますか？verbatimその場合は、XMLを\endverbatimタグでラップしてみてください。次の例の場合

/** A test class with some XML in the documentation.

 \verbatim
 <example>
 <code>
   <!-- xml will go below this comment, but I can't display the comment! -->
 </code>
 </example>
 \endverbatim
*/
class Test
    ...

私はdoxygen出力を取得します：

ここに画像の説明を入力してください

于 2012-05-15T09:21:25.583 に答える
1

&lt;andでエスケープしようとしたとき&gt;、この構文を使用しましたか?

/// <example>
/// <code>
///   &lt;!-- xml will go below this comment, but I can't display the comment! --&gt;
/// </code>
/// </example>

これは IntelliSense で機能しますが、他の場所で機能しない理由がわかりません。

IntelliSense のスクリーンショット

編集：次のバージョンを試していただけますか？

/// <example>
/// <pre lang='xml'> 
///   &lt;!-- xml will go below this comment, but I can't display the comment! --&gt;
/// </pre> 
/// </example>
于 2012-05-14T18:33:37.297 に答える