Hvordan kommentere en linje i XML

Programmerer som jobber med programkode

I motsetning til HTML, gir XML-tagger beskrivende detaljer om innhold i stedet for visuelle instruksjoner for å vise det.

Bildekreditt: RossHelen/iStock/GettyImages

XML gir et markup-språk for lagring av data og formidling fra ett sted til et annet. Som HTML bruker den ren tekst som du kan redigere i alle programmer som skriver TXT-filer. I motsetning til HTML, gir XML-tagger beskrivende detaljer om innhold i stedet for visuelle instruksjoner for å vise det. Når du definerer XML-koder for å karakterisere et sett med informasjon, kan du bruke kommentarer til å vise to formål med arbeidet ditt: å forklare det, og å utelate deler av det fra koden som andre applikasjoner prosess. Hvis du allerede kjenner HTML-kommentarsyntaksen, kjenner du også XML-ekvivalenten.

Hvis du vil kommentere en enkelt linje i XML-koden, setter du inn markøren på begynnelsen av en linje du vil kommentere ut. Skriv a mindre enn-symbol etterfulgt av et utropstegn og to bindestreker. Flytt markøren til slutten av linjen og skriv deretter to streker etterfulgt av et større enn-symbol.

Dagens video

Hvis linjen din består av setningen "Bruk denne delen til å lage en beskrivelse av adopterbare katter," ser det slik ut med begge kommentartaggene på plass:

Du bør lese kommentaren din for å bekrefte at den ikke inneholder noen forekomster av to påfølgende bindestreker annet enn i åpnings- og avslutningskommentartaggene. Påfølgende bindestreker utløser et falskt slutt-på-kommentar-signal som forstyrrer syntaksen din.

I stedet for å bare kommentere en enkelt linje, må du kanskje kommentere en hel del av XML-koden. For å gjøre dette, sett inn markøren på en tom linje over delen av XML-koden du vil kommentere og skriv deretter inn en mindre enn-symbol etterfulgt av et utropstegn og to bindestreker.

For å avslutte kommentaren, flytt markøren ned til en tom linje etter delen av XML-koden du kommenterer ut. Type to streker etterfulgt av et større enn-symbol. Med kommentarer på plass, ser en del av XML-koden slik ut:

Igjen bør du lese den kommenterte delen for å bekrefte at den ikke inneholder en kommentar innenfor linjene du kommenterte ut. Nestede kommentarer utgjør en feil i XML.

Når du legger inn kommentarer, husk noen få grunnleggende XML-syntaksregler. XML tillater ikke bruk av mindre enn-tegnet i koden, bortsett fra som en del av en åpningskommentartag. For å inkludere tegnet i noe annet enn en kommentarkode, skriv det inn som en enhetsreferanse, en kodet sekvens som blir til et spesifikt tegn når et program analyserer XML-en din.

Hver enhetsreferanse begynner med et og-tegn og slutter med semikolon. Mellom disse to tegnene inneholder enhetsreferansen for mindre enn-symbolet de små bokstavene "lt", uten anførselstegn og tegnsetting. Større enn-symbolet utgjør ikke et ulovlig tegn i XML, men det er god praksis å bruke enhetsreferansen også, som inkluderer bokstavene "gt."

Vær også oppmerksom på at hvis du ikke klarer å åpne og lukke kommentarene dine på riktig måte, eller plasserer dem rundt en kodedel som inneholder en ID, vil ikke XML-en din analyseres riktig.