From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../znaczenie_poprawnego_komentowania/index.html | 64 ++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 files/pl/web/html/znaczenie_poprawnego_komentowania/index.html (limited to 'files/pl/web/html/znaczenie_poprawnego_komentowania') diff --git a/files/pl/web/html/znaczenie_poprawnego_komentowania/index.html b/files/pl/web/html/znaczenie_poprawnego_komentowania/index.html new file mode 100644 index 0000000000..fe5b67106a --- /dev/null +++ b/files/pl/web/html/znaczenie_poprawnego_komentowania/index.html @@ -0,0 +1,64 @@ +--- +title: Znaczenie poprawnego komentowania +slug: Web/HTML/Znaczenie_poprawnego_komentowania +tags: + - HTML + - Wszystkie_kategorie +translation_of: Learn/HTML/Introduction_to_HTML/Getting_started#HTML_comments +--- +

 

+

Znaczenie poprawnego komentowania

+

Podczas tworzenia HTML w trybie standardów, niepoprawnie sformatowane komentarze mogą zepsuć twe strony, powodując wykomentowanie części lub całości ich treści. Podczas tworzenia XHTML lub XML, niepoprawne komentarze spowodują, że twoje dokumenty nie będą mogły w ogóle zostać wyświetlone.

+

HTML 4.01

+

+ + Z Rekomendacji W3C dla HTML 4.01, Sekcji 3.2.4 - Komentarze: +

+

Biała spacja nie jest dozwolona między otwierającym delimiterem deklaracji znacznika ("<!") a otwierającym delimiterem komentarza ("--"), ale jest dozwolona między zamykającym delimiterem komentarza ("--") i zamykającym delimiterem deklaracji znacznika (">"). Pospolitym błędem jest umieszczanie łańcucha kresek ("---") wewnątrz komentarza. Twórcy powinni unikać wstawiania wewnątrz komentarza dwóch lub więcej sąsiadujących kresek.

+

Przykłady

+

Poniżej przedstawiono prawidłowe komentarze HTML.

+
<!-- poprawny komentarz HTML -->
+<!-- poprawny komentarz HTML -- >
+
+

Poniżej przedstawiono nieprawidłowy komentarz HTML.

+
<!-- niepoprawny -- komentarz HTML -->
+
+

XML

+

+ + Z Rekomendacji W3C dla XML 1.0, Sekcji 2.5 - Komentarze: +

+
+ Definicja: Komentarze mogą pojawiać się w dokumencie gdziekolwiek poza innymi znacznikami; ponadto mogą pojawiać się wewnątrz deklaracji typu dokumentu w miejscach dozwolonych przez gramatykę. Nie wchodzą w skład danych znakowych dokumentu; procesor XML może, choć nie musi, umożliwić aplikacji wydobywać tekst komentarzy. W celu zapewnienia kompatybilności, łańcuch "--" (podwójna kreska) nie może występować wewnątrz komentarzy. Odwołania do parametrów encji nie mogą być rozpoznawane wewnątrz komentarzy. + 
[15] Comment ::= '<!--' ((Char - '-') | ('-' (Char - '-')))* '-->'
+
+
+

Zgodnie z opisem gramatyki komentarzy w XML, komentarz ma postać

+
<!-- znaki bez sąsiadujących kresek -->
+
+

Przykłady

+

Poniżej przedstawiono prawidłowy komentarz XML i XHTML.

+
<!-- poprawny komentarz xml/xhtml -->
+
+

Poniżej przedstawiono nieprawidłowe komentarze XML i XHTML.

+
<!-- nieprawidłowy -- komentarz xml -->
+<!-- nieprawidłowy komentarz xml --->
+<!-- nieprawidłowy komentarz xml -- >
+
+

Lektury uzupełniające

+ +
+

Informacje o dokumencie

+ +
+
+  
-- cgit v1.2.3-54-g00ecf