Kako komentirati vrstico v XML

Programer, ki dela s programsko kodo

Za razliko od HTML, oznake XML zagotavljajo opisne podrobnosti o vsebini in ne vizualnih navodil za njeno prikazovanje.

Zasluga slike: RossHelen/iStock/GettyImages

XML zagotavlja označevalni jezik za shranjevanje podatkov in njihovo prenašanje z ene lokacije na drugo. Tako kot HTML uporablja navadno besedilo, ki ga lahko urejate v kateri koli aplikaciji, ki piše datoteke TXT. Za razliko od HTML, oznake XML zagotavljajo opisne podrobnosti o vsebini in ne vizualnih navodil za njeno prikazovanje. Ko definirate oznake XML za karakterizacijo niza informacij, lahko uporabite komentarje za prikaz dveh namen vašega dela: razložiti ga in izpustiti njegove dele iz kode drugih aplikacij proces. Če že poznate sintakso komentarja HTML, poznate tudi ekvivalent XML.

Če želite komentirati eno vrstico v kodi XML, vstavite kazalec na začetek vrstice, ki jo želite komentirati. Vnesite a simbol manj kot, ki mu sledita klicaj in dva pomišljaja. Premaknite kazalec na konec vrstice in nato vnesite dva pomišljaja, ki jima sledi simbol več kot.

Video dneva

Če je vaša vrstica sestavljena iz izjave »Uporabite ta razdelek za izdelavo opisa mačk, ki jih je mogoče posvojiti«, je videti takole z obema oznakama komentarjev na mestu:

Prebrati boste želeli svoj komentar, da preverite, ali ne vsebuje nobenih primerov dveh zaporednih pomišljajev, razen v uvodnih in končnih oznakah komentarjev. Zaporedni pomišljaji sprožijo lažni signal konca komentarja, ki moti vašo skladnjo.

Namesto da komentirate samo eno vrstico, boste morda morali komentirati cel del kode XML. Če želite to narediti, vstavite kazalec v prazno vrstico nad odsekom kode XML, ki ga želite komentirati, in nato vnesite simbol manj kot, ki mu sledita klicaj in dva pomišljaja.

Če želite končati komentar, premaknite kazalec navzdol na prazno vrstico za odsekom kode XML, ki ga komentirate. Vrsta dva pomišljaja, ki jima sledi simbol več kot. Ko so komentarji na mestu, je del kode XML videti takole:

Ponovno boste želeli prebrati razdelek s komentarji, da preverite, ali ne vsebuje komentarja v vrsticah, ki ste jih komentirali. Ugnezdeni komentarji predstavljajo napako v XML.

Ko komentirate, si zapomnite nekaj osnovnih pravil sintakse XML. XML ne dovoljuje uporabe znaka manj kot v svoji kodi, razen kot del začetne oznake komentarja. Če želite znak vključiti v karkoli razen v oznako komentarja, ga vnesite kot referenca entitete, kodirano zaporedje, ki se spremeni v določen znak, ko aplikacija razčleni vaš XML.

Vsaka referenca entitete se začne z ampersandom in konča s podpičjem. Med tema dvema znakoma referenca entitete za simbol manj kot vsebuje male črke »lt« brez narekovajev in ločil. Simbol več kot ne predstavlja nedovoljenega znaka v XML, vendar je dobra praksa, da uporabite tudi njegovo referenco entitete, ki vključuje črke "gt."

Upoštevajte tudi, da vaš XML ne bo pravilno razčlenjen, če svojih komentarjev ne odprete in zaprete pravilno ali jih postavite okoli odseka kode, ki vsebuje ID.