initial commit

1 files changed, 64 insertions, 0 deletions

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
+---
+<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 ("&lt;!") a otwierającym delimiterem komentarza ("--"), ale jest dozwolona między zamykającym delimiterem komentarza ("--") i zamykającym delimiterem deklaracji znacznika ("&gt;"). 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">&lt;!-- poprawny komentarz HTML --&gt;
+&lt;!-- poprawny komentarz HTML -- &gt;
+</pre>
+<p>Poniżej przedstawiono nieprawidłowy komentarz HTML.</p>
+<pre class="eval">&lt;!-- niepoprawny -- komentarz HTML --&gt;
+</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 ::= '&lt;!--' ((Char - '-') | ('-' (Char - '-')))* '--&gt;'
+</pre>
+</blockquote>
+<p>Zgodnie z opisem gramatyki komentarzy w XML, komentarz ma postać</p>
+<pre class="eval">&lt;!-- znaki bez sąsiadujących kresek --&gt;
+</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">&lt;!-- poprawny komentarz xml/xhtml --&gt;
+</pre>
+<p>Poniżej przedstawiono nieprawidłowe komentarze XML i XHTML.</p>
+<pre class="eval">&lt;!-- nieprawidłowy -- komentarz xml --&gt;
+&lt;!-- nieprawidłowy komentarz xml ---&gt;
+&lt;!-- nieprawidłowy komentarz xml -- &gt;
+</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>