Jak zakomentovat řádek v XML

Programátor pracující s programovým kódem

Na rozdíl od HTML poskytují značky XML spíše popisné podrobnosti o obsahu než vizuální pokyny pro jeho zobrazení.

Kredit obrázku: RossHelen/iStock/GettyImages

XML poskytuje značkovací jazyk pro ukládání dat a jejich přenos z jednoho místa na druhé. Stejně jako HTML používá prostý text, který můžete upravovat v jakékoli aplikaci, která zapisuje soubory TXT. Na rozdíl od HTML poskytují značky XML spíše popisné podrobnosti o obsahu než vizuální pokyny pro jeho zobrazení. Když definujete značky XML pro charakterizaci sady informací, můžete použít komentáře k zobrazení dvou účely v rámci vaší práce: vysvětlit to a vynechat jeho části z kódu jiných aplikací proces. Pokud již znáte syntaxi komentáře HTML, znáte také ekvivalent XML.

Pokud chcete okomentovat jeden řádek v kódu XML, vložte kurzor na začátek řádku, který chcete okomentovat. Typ a symbol menší než následovaný vykřičníkem a dvěma pomlčkami. Přesuňte kurzor na konec řádku a zadejte dvě pomlčky následované symbolem větší než.

Video dne

Pokud se váš řádek skládá z prohlášení „Použijte tuto sekci k vytvoření popisu adoptovatelných koček“, vypadá to takto s oběma tagy komentáře:

Budete si chtít přečíst svůj komentář, abyste si ověřili, že neobsahuje žádné výskyty dvou po sobě jdoucích pomlček kromě jeho úvodní a závěrečné značky komentáře. Po sobě jdoucí pomlčky spouští falešný signál konce komentáře, který narušuje vaši syntaxi.

Spíše než jen komentovat jeden řádek, možná budete muset zakomentovat celou část kódu XML. Chcete-li to provést, vložte kurzor na prázdný řádek nad část kódu XML, kterou chcete okomentovat, a zadejte a symbol menší než následovaný vykřičníkem a dvěma pomlčkami.

Chcete-li komentář ukončit, přesuňte kurzor dolů na prázdný řádek za částí kódu XML, kterou komentujete. Typ dvě pomlčky následované symbolem větší než. S vloženými komentáři vypadá část kódu XML takto:

Znovu si budete chtít přečíst svou komentovanou sekci, abyste si ověřili, že v řádcích, které jste okomentovali, neobsahuje komentář. Vnořené komentáře představují chybu v XML.

Při vytváření komentářů nezapomeňte na několik základních pravidel syntaxe XML. XML neumožňuje použití znaku menší než ve svém kódu, s výjimkou části úvodní značky komentáře. Chcete-li znak zahrnout do čehokoli kromě značky komentáře, zadejte jej jako odkaz na entitu, kódovaná sekvence, která se změní na konkrétní znak, když aplikace analyzuje váš XML.

Odkaz na každou entitu začíná ampersandem a končí středníkem. Mezi těmito dvěma znaky obsahuje odkaz na entitu pro symbol menší než malá písmena „lt“ bez uvozovek a interpunkce. Symbol větší než nepředstavuje v XML neplatný znak, ale je dobrým zvykem použít také odkaz na jeho entitu, který obsahuje písmena „gt“.

Vězte také, že pokud se vám nepodaří otevřít a zavřít komentáře správně nebo je umístíte kolem části kódu, která obsahuje ID, vaše XML nebude správně analyzováno.