Kaip komentuoti eilutę XML

Programuotojas, dirbantis su programos kodu

Skirtingai nuo HTML, XML žymos pateikia aprašomąją informaciją apie turinį, o ne vaizdines jo rodymo instrukcijas.

Vaizdo kreditas: RossHelen / iStock / GettyImages

XML suteikia žymėjimo kalbą duomenims saugoti ir perduoti iš vienos vietos į kitą. Kaip ir HTML, jame naudojamas paprastas tekstas, kurį galite redaguoti bet kurioje programoje, kuri rašo TXT failus. Skirtingai nuo HTML, XML žymos pateikia aprašomąją informaciją apie turinį, o ne vaizdines jo rodymo instrukcijas. Kai apibrėžiate XML žymas informacijos rinkiniui apibūdinti, galite naudoti komentarus, kad pateiktumėte du savo darbo tikslais: paaiškinti jį ir praleisti jo dalis iš kodo, kurį naudoja kitos programos procesas. Jei jau žinote HTML komentarų sintaksę, žinote ir XML atitikmenį.

Jei norite pakomentuoti vieną XML kodo eilutę, įterpkite žymeklį eilutės, kurią norite komentuoti, pradžioje. Įveskite a mažesnis nei simbolis, po kurio rašomas šauktukas ir du brūkšniai. Perkelkite žymeklį į eilutės pabaigą ir įveskite du brūkšneliai, po kurių rašomas simbolis didesnis nei.

Dienos vaizdo įrašas

Jei jūsų eilutę sudaro teiginys „Naudokite šią skiltį, kad sukurtumėte įvaikintų kačių aprašymą“, ji atrodo taip, kai yra įdėtos abi komentarų žymos:

Turėsite perskaityti savo komentarą, kad įsitikintumėte, jog jame nėra dviejų iš eilės einančių brūkšnių atvejų, išskyrus jo atidarymo ir uždarymo komentarų žymas. Iš eilės brūkšneliai suaktyvina klaidingą komentaro pabaigos signalą, kuris sutrikdo jūsų sintaksę.

Užuot komentavęs vieną eilutę, gali tekti komentuoti visą XML kodo skyrių. Norėdami tai padaryti, įveskite žymeklį ant tuščios eilutės virš XML kodo dalies, kurią norite komentuoti, ir įveskite mažesnis nei simbolis, po kurio rašomas šauktukas ir du brūkšniai.

Norėdami baigti komentarą, perkelkite žymeklį žemyn į tuščią eilutę po komentuojamo XML kodo skyriaus. Tipas du brūkšneliai, po kurių rašomas simbolis didesnis nei. Su komentarais XML kodo dalis atrodo taip:

Dar kartą norėsite perskaityti komentuojamą skiltį, kad įsitikintumėte, jog joje nėra komentaro jūsų pakomentuotose eilutėse. Įdėtieji komentarai yra XML klaida.

Komentuodami atsiminkite keletą pagrindinių XML sintaksės taisyklių. XML kode neleidžia naudoti mažesnio nei simbolio, išskyrus kaip įžanginės komentaro žymos dalį. Norėdami įtraukti simbolį į bet ką, išskyrus komentaro žymą, įveskite jį kaip subjekto nuoroda, užkoduota seka, kuri virsta konkrečiu simboliu, kai programa analizuoja jūsų XML.

Kiekvieno subjekto nuoroda prasideda ampersandu ir baigiasi kabliataškiu. Tarp šių dviejų simbolių objekto nuorodoje, skirtoje mažesniam nei simboliui, yra mažosios raidės „lt“ be kabučių ir skyrybos ženklų. Simbolis didesnis nei nėra neteisėtas XML simbolis, tačiau gera praktika taip pat naudoti jo objekto nuorodą, kurią sudaro raidės „gt“.

Taip pat atminkite, kad jei nepavyks tinkamai atidaryti ir uždaryti komentarų arba sudėti juos aplink kodo skyrių, kuriame yra ID, jūsų XML nebus tinkamai išanalizuotas.