Jak skomentować linię w XML?

click fraud protection
Programista pracujący z kodem programu

W przeciwieństwie do HTML, tagi XML zawierają opisowe szczegóły dotyczące zawartości, a nie wizualne instrukcje dotyczące jej wyświetlania.

Źródło obrazu: RossHelen/iStock/GettyImages

XML zapewnia język znaczników do przechowywania danych i przenoszenia ich z jednego miejsca do drugiego. Podobnie jak HTML, używa zwykłego tekstu, który można edytować w dowolnej aplikacji, która zapisuje pliki TXT. W przeciwieństwie do HTML, tagi XML zawierają opisowe szczegóły dotyczące zawartości, a nie wizualne instrukcje dotyczące jej wyświetlania. Gdy definiujesz znaczniki XML, aby scharakteryzować zbiór informacji, możesz używać komentarzy, aby służyć dwóm osobom cele w Twojej pracy: wyjaśnienie tego i pominięcie jego części w kodzie, które inne aplikacje proces. Jeśli znasz już składnię komentarzy HTML, znasz również odpowiednik XML.

Jeśli chcesz zakomentować pojedynczy wiersz w kodzie XML, umieść kursor na początku wiersza, który chcesz zakomentować. Wpisz a mniej niż symbol, po którym następuje wykrzyknik i dwie myślniki

. Przesuń kursor na koniec linii, a następnie wpisz dwie myślniki, po których następuje symbol „większy niż”.

Wideo dnia

Jeśli Twój wiersz zawiera stwierdzenie „Użyj tej sekcji, aby stworzyć opis kotów, które można adoptować”, wygląda to tak z obydwoma tagami komentarza:

Przeczytaj komentarz, aby sprawdzić, czy nie zawiera on żadnych wystąpień dwóch kolejnych myślników innych niż w tagach otwierających i zamykających komentarz. Kolejne myślniki wywołują fałszywy sygnał końca komentarza, który zakłóca twoją składnię.

Zamiast komentować pojedynczy wiersz, konieczne może być zakomentowanie całej sekcji kodu XML. Aby to zrobić, umieść kursor w pustym wierszu nad sekcją kodu XML, którą chcesz zakomentować, a następnie wpisz a mniej niż symbol, po którym następuje wykrzyknik i dwie myślniki.

Aby zakończyć komentarz, przesuń kursor w dół do pustej linii za sekcją kodu XML, którą komentujesz. Rodzaj dwie myślniki, po których następuje symbol „większy niż”. Po umieszczeniu komentarzy sekcja kodu XML wygląda tak:

Ponownie będziesz chciał przeczytać sekcję z komentarzami, aby sprawdzić, czy nie zawiera komentarza w skomentowanych wierszach. Zagnieżdżone komentarze stanowią błąd w XML.

Dokonując komentarzy, pamiętaj o kilku podstawowych zasadach składni XML. XML nie pozwala na użycie znaku mniej niż w swoim kodzie, z wyjątkiem części otwierającego tagu komentarza. Aby dołączyć znak do czegokolwiek poza znacznikiem komentarza, wprowadź go jako odniesienie do jednostki, zakodowana sekwencja, która zamienia się w określony znak, gdy aplikacja analizuje kod XML.

Każde odwołanie do encji zaczyna się znakiem ampersand i kończy się średnikiem. Między tymi dwoma znakami odwołanie do encji symbolu mniejszego zawiera małe litery „lt”, bez cudzysłowów i znaków interpunkcyjnych. Symbol „większy niż” nie stanowi niedozwolonego znaku w XML, ale dobrą praktyką jest użycie również jego odwołania do jednostki, które zawiera litery „gt”.

Pamiętaj też, że jeśli nie otworzysz i nie zamkniesz poprawnie swoich komentarzy lub umieścisz je wokół sekcji kodu, która zawiera identyfikator, Twój kod XML nie zostanie poprawnie przeanalizowany.