Kaip komentuoti XML žymų bloką?
T. y. kaip toliau pateiktame kode galiu komentuoti <staticText>
ir viską, kas yra jo viduje?
<detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
</band>
</detail>
Galėčiau naudoti <!-- staticText-->
, bet tai tik pavienėms žymėms (kiek žinau), kaip //
Java ir C. Norėčiau kažko panašaus į tai, kaip /** komentaras **/
gali būti naudojamas Java ir C, kad galėčiau komentuoti ilgesnius XML kodo blokus.
Tokį komentarų stilių galite naudoti keliose eilutėse (jis yra ir HTML).
<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>
Jei klausiate, nes gavote klaidų su <!-- -->
sintakse, tai greičiausiai CDATA skirsnis (ir ten esanti ]]>
dalis), kuris yra komentaro viduryje. Tai neturėtų daryti skirtumo, tačiau kartais idealus ir realus pasaulis gali būti gana skirtingi (ypač kai kalbama apie XML apdorojimą).
Pabandykite pakeisti ir ]]>
:
<!--detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]--><!--]></text>
</staticText>
</band>
</detail-->
Kitas dalykas, kuris ateina į galvą: Jei XML turinyje yra du brūkšneliai, komentaras iš karto baigiasi:
<!-- <a> This is strange -- but true!</a> -->
--------------------------^ comment ends here
Tai gana dažna klaida. Ji paveldėta iš SGML komentarų tvarkymo būdo. (Skaitykite XML specifikaciją šia tema)