Kā komentēt rindiņu XML formātā

Programmētājs strādā ar programmas kodu

Atšķirībā no HTML, XML tagi sniedz aprakstošu informāciju par saturu, nevis vizuālus norādījumus tā parādīšanai.

Attēla kredīts: RossHelen/iStock/GettyImages

XML nodrošina iezīmēšanas valodu datu glabāšanai un pārsūtīšanai no vienas vietas uz citu. Tāpat kā HTML, tas izmanto vienkāršu tekstu, ko var rediģēt jebkurā lietojumprogrammā, kas raksta TXT failus. Atšķirībā no HTML, XML tagi sniedz aprakstošu informāciju par saturu, nevis vizuālus norādījumus tā parādīšanai. Definējot XML tagus, lai raksturotu informācijas kopu, varat izmantot komentārus, lai apkalpotu divus jūsu darba mērķiem: izskaidrot to un izlaist tā daļas no koda, ko izmanto citas lietojumprogrammas process. Ja jūs jau zināt HTML komentāru sintaksi, jūs zināt arī XML ekvivalentu.

Ja vēlaties komentēt vienu rindiņu XML kodā, ievietojiet kursoru tās rindas sākumā, kuru vēlaties komentēt. Ierakstiet a simbols mazāks par, kam seko izsaukuma zīme un divas domuzīmes. Pārvietojiet kursoru uz rindas beigām un pēc tam ierakstiet divas domuzīmes, kam seko simbols “lielāks par”..

Dienas video

Ja jūsu rinda sastāv no paziņojuma "Izmantojiet šo sadaļu, lai izveidotu adoptējamu kaķu aprakstu", tā izskatās šādi, ja ir ievietotas abas komentāru atzīmes:

Vēlēsities izlasīt savu komentāru, lai pārliecinātos, ka tajā nav nevienas divas secīgas domuzīmes, izņemot komentāru sākuma un aizvēršanas tagus. Secīgas domuzīmes aktivizē nepatiesu komentāra beigu signālu, kas izjauc jūsu sintaksi.

Tā vietā, lai komentētu tikai vienu rindiņu, jums, iespējams, būs jākomentē vesela XML koda sadaļa. Lai to izdarītu, ievietojiet kursoru tukšā rindiņā virs XML koda sadaļas, kuru vēlaties komentēt, un pēc tam ierakstiet simbols mazāks par, kam seko izsaukuma zīme un divas domuzīmes.

Lai beigtu komentāru, pārvietojiet kursoru uz leju uz tukšu rindiņu aiz XML koda sadaļas, kuru komentējat. Tips divas domuzīmes, kam seko simbols “lielāks par”.. Ar komentāriem XML koda sadaļa izskatās šādi:

Vēlreiz vēlēsities izlasīt savu komentēto sadaļu, lai pārbaudītu, vai tajā nav komentāru rindās, kuras komentējāt. Ligzdotie komentāri ir XML kļūda.

Sniedzot komentārus, atcerieties dažus pamata XML sintakses noteikumus. XML neļauj savā kodā izmantot rakstzīmi, kas ir mazāka par rakstzīmi, izņemot kā daļu no sākuma komentāra taga. Lai iekļautu rakstzīmi jebko, izņemot komentāra tagu, ievadiet to kā entītijas atsauce, kodēta secība, kas pārvēršas par konkrētu rakstzīmi, kad lietojumprogramma parsē jūsu XML.

Katra entītijas atsauce sākas ar un beidzas ar semikolu. Starp šīm divām rakstzīmēm entītijas atsauce uz simbolu "mazāks par" satur mazos burtus "lt" bez pēdiņām un pieturzīmēm. Simbols “lielāks par” nav uzskatāms par nelikumīgu rakstzīmi XML, taču ir laba prakse izmantot arī tā entītijas atsauci, kas ietver burtus “gt”.

Ņemiet vērā arī to, ka, ja neizdodas pareizi atvērt un aizvērt komentārus vai ievietot tos ap koda sadaļu, kurā ir ID, jūsu XML netiks pareizi parsēts.