Kā komentēt XML tagu bloku?
T. i., kā es varu komentēt <staticText>
un visu, kas tajā atrodas, zemāk redzamajā kodā?
<detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
</band>
</detail>
Es varētu izmantot <!-- staticText-->
, bet tas attiecas tikai uz atsevišķiem tagiem (cik man zināms), piemēram, //
Java un C. Es gribētu kaut ko līdzīgu tam, kā Java un C izmanto /** komentārus **/
, lai es varētu komentēt garākus XML koda blokus.
Šādu komentāru stilu var izmantot vairākās rindās (tas pastāv arī HTML formātā).
<detail>
<band height="20">
<!--
Hello,
I am a multi-line XML comment
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
-->
</band>
</detail>
Ja jūs jautājat, jo jums ir kļūdas ar <!-- -->
sintaksi, tas, visticamāk, ir CDATA sadaļā (un tur ]]>
daļa), kas tad atrodas komentāra vidū. Tam nevajadzētu būt nekādai atšķirībai, taču ideālā un reālā pasaule dažkārt var būt diezgan atšķirīgas (īpaši XML apstrādē).
Pamēģiniet mainīt arī ]]>
:
<!--detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]--><!--]></text>
</staticText>
</band>
</detail-->
Vēl viena lieta, kas nāk prātā: Ja XML saturs kaut kur satur divus defisi, komentārs uzreiz beidzas:
<!-- <a> This is strange -- but true!</a> -->
--------------------------^ comment ends here
Tas ir diezgan izplatīts slazds. Tas ir pārmantots no SGML komentāru apstrādes veida. (Lasiet XML specifikāciju par šo tēmu).