XMLでのコードコメントの書き方を解説

XMLのコメントは、HTMLのコメントと似ています。コメントは、XMLコードの行を明確にしたり、理解したりするために使用されます。

コメントには、関連するリンク、情報、用語などを含めることができます。コメントは、XML コードではなく、ソースコードにのみ表示されます。コメントは、XMLコードのどこにでも表示することができます。

構文
コメントは < で始まる! -- で始まり -->で終わる、例えば <! --catalog last updated 2016-02-14 -->のようになります。
コメントは、文書タイプ定義（DTD）を含む文書の前文、文書の後、またはテキストコンテンツに表示することができます。コメントは、属性値には表示できません。タグの中には入れられません。
パーサーは、> に遭遇した時点でアノテーションが終了したとみなし、その後は通常のXMLとして処理を進めます。そのため、アノテーションの中に>という文字列は現れません。この制限を除けば、CDATAセクションのように、XMLの任意の文字をアノテーションに含めることができます。このように、XMLアノテーションは、パーサーが見る出力ストリームから、文書の内容を削除することなく削除することができる。
タグの一時的な削除には、以下のアノテーションを使用することができます。

例
以下は、XML文書でアノテーションを使用する場合のデモ例です。

備考

の間の文字列はコメントとみなされます。## XMLアノテーションのルール XMLアノテーションのルールは、以下の通りです。
- XML宣言の前にコメントを表示することはできません。
- コメントは文書内のどこにでも表示することができます。
- コメントは、属性値には表示できません。
- コメントを他のコメントの中に入れ子にすることはできません。

HTMLでは、コメントはスクリプトやスタイルシートを隠すために使うことができます。XMLでこの方法を使うには、注釈を取得し、注釈の内容を抽出し、マークアップ文字をチェックし、再解析しなければならないかもしれません。この例では、CDATAセクションを使用するのがよいでしょう。