blob: fe5b67106a987f9c61f798918e6b8925e2672f7c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
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
---
<p> </p>
<h2 id="Znaczenie_poprawnego_komentowania" name="Znaczenie_poprawnego_komentowania">Znaczenie poprawnego komentowania</h2>
<p>Podczas tworzenia HTML w <a class="external" href="http://www.mozilla.org/docs/web-developer/quirks/doctypes.html">trybie standardów</a>, 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.</p>
<h3 id="HTML_4.01" name="HTML_4.01">HTML 4.01</h3>
<p>
<i>
Z <a class="external" href="http://www.w3.org/TR/html4/intro/sgmltut.html#h-3.2.4">Rekomendacji W3C dla HTML 4.01, Sekcji 3.2.4 - Komentarze</a>:</i>
</p>
<p>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.</p>
<h4 id="Przyk.C5.82ady" name="Przyk.C5.82ady">Przykłady</h4>
<p>Poniżej przedstawiono prawidłowe komentarze HTML.</p>
<pre class="eval"><!-- poprawny komentarz HTML -->
<!-- poprawny komentarz HTML -- >
</pre>
<p>Poniżej przedstawiono nieprawidłowy komentarz HTML.</p>
<pre class="eval"><!-- niepoprawny -- komentarz HTML -->
</pre>
<h3 id="XML" name="XML">XML</h3>
<p>
<i>
Z <a class="external" href="http://www.w3.org/TR/REC-xml#sec-comments">Rekomendacji W3C dla XML 1.0, Sekcji 2.5 - Komentarze</a>:</i>
</p>
<blockquote>
<b>Definicja:</b> 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.
<pre>[15] Comment ::= '<!--' ((Char - '-') | ('-' (Char - '-')))* '-->'
</pre>
</blockquote>
<p>Zgodnie z opisem gramatyki komentarzy w XML, komentarz ma postać</p>
<pre class="eval"><!-- znaki bez sąsiadujących kresek -->
</pre>
<h4 id="Przyk.C5.82ady_2" name="Przyk.C5.82ady_2">Przykłady</h4>
<p>Poniżej przedstawiono prawidłowy komentarz XML i XHTML.</p>
<pre class="eval"><!-- poprawny komentarz xml/xhtml -->
</pre>
<p>Poniżej przedstawiono nieprawidłowe komentarze XML i XHTML.</p>
<pre class="eval"><!-- nieprawidłowy -- komentarz xml -->
<!-- nieprawidłowy komentarz xml --->
<!-- nieprawidłowy komentarz xml -- >
</pre>
<h3 id="Lektury_uzupe.C5.82niaj.C4.85ce" name="Lektury_uzupe.C5.82niaj.C4.85ce">Lektury uzupełniające</h3>
<ul>
<li><a class="external" href="http://www.w3.org/TR/html4/intro/sgmltut.html#h-3.2.4">Rekomendacja HTML 4.01: 3.2.4 - Komentarze</a></li>
<li><a class="external" href="http://www.w3.org/TR/REC-xml#sec-comments">Rekomendacja XML: 2.5 - Komentarze</a></li>
<li><a class="external" href="http://bugzilla.mozilla.org/show_bug.cgi?id=144432">Błąd na Bugzilli nr 144432</a></li>
<li><a class="external" href="http://bugzilla.mozilla.org/show_bug.cgi?id=102127">Błąd na Bugzilli nr 102127</a></li>
</ul>
<div class="originaldocinfo">
<h3 id="Informacje_o_dokumencie" name="Informacje_o_dokumencie">Informacje o dokumencie</h3>
<ul>
<li>Ostatnia aktualizacja: 19 maj 2003</li>
<li>Copyright © 2001-2003 Netscape. All rights reserved.</li>
<li>Tłumaczenie: Krzysztof Jurewicz</li>
</ul>
</div>
<div class="noinclude">
</div>
|
