Websiteentwicklung: XHTML: Kommentare

Aus Wikibooks

Websiteentwicklung XHTML Kommentare

Als XML-basierte Sprache erbt XHTML die XML-Syntax für Kommentare:

 <!-- Das ist der Kommentar -->

Kommentare dürfen auch mehrzeilig sein:

 <!--
     Dieser
     Kommentar
     ist
     mehrzeilig
 -->

Wie ein mehrzeiliger Kommentar gestaltet werden sollte, schreibt XML nicht vor. Es erweist sich jedoch als hilfreich, die Zeichenfolge für das Kommentarende bei mehrzeiligen Kommentaren am Beginn einer neuen Zeile statt am Ende der vorherigen Zeile zu platzieren und den Kommentarinhalt einzurücken, da man sonst eventuell das Kommentarende übersieht:

 Ein Text über Kommentare
 <!-- Dieser Kommentar
 ist mehrzeilig -->
 Dieser Text gehört wieder zum Text.

[Bearbeiten] Wozu dienen Kommentare?

Kommentare dienen dazu, Informationen im Dokument so unterzubringen, dass sie beim normalen Betrachten nicht sichtbar und beim normalen Verarbeiten ignoriert werden.

Insbesondere in langen, großen XHTML-Dokumenten kann der sinnvolle Einsatz von Kommentaren die Arbeit mit dem Dokument enorm erleichtern, indem man entsprechende Stellen im Dokument mit Kommentaren markiert, z.B. mit <!-- Kopfzeile -->, <!-- Navigationsleiste -->, <!-- Dokumentinhalt --> und <!-- Fußzeile --> an den entsprechenden Stellen.

Zudem lassen sich Kommentare hervorragend dazu verwenden, Teile einer Webseite vorübergehend zu deaktivieren, ohne sie gleich aus dem Dokument zu löschen:

<!-- z.Z. keine Demo <p><a href="demo">Demo-Version zum ausprobieren</a></p>-->

[Bearbeiten] Wo sind Kommentare erlaubt?

Kommentare dürfen an fast jeder beliebigen Stelle eines Dokuments stehen.

An folgenden Stellen dürfen Kommentare stehen:

• Innerhalb von Elementen
• Nach der XML-Deklaration
• Vor und nach der Dokumenttypdeklaration
• Im internen Subset der Dokumenttypdefinition
• Am Ende des Dokuments nach dem Dokumentelement (meist das </html>-Element)

An folgenden Stellen dürfen Kommentare nicht stehen:

• Kommentare dürfen nicht in einem Tag mit Ausnahme im Dokumenttypdeklarationstag innerhalb des internen Subsets der Dokumenttypdeklaration stehen.
• Kommentare dürfen nicht vor einer dem Dokument eventuell voranstehenden XML-Deklaration stehen.

[Bearbeiten] Was ist zu beachten?

Beim Einsatz von Kommentaren ist folgendes zu beachten:

• Kommentare dürfen die Zeichenfolge "--" nicht enthalten. Folgender Kommentar ist also ungültig: <!-- Test -- Test -->
• Kommentare werden durch die nächste Zeichenfolge --> abgeschlossen.
• Daraus ergibt sich, dass Kommentare in XHTML nicht geschachtelt werden können.

sowie:

• Kommentare sind keine Sicherheitsfunktion. Der Inhalt von Kommentaren wird zwar bei der Darstellung der Webseite nicht angezeigt, ist jedoch dennoch vorhanden. Ein Benutzer kann die Kommentare jederzeit mit Funktionen wie "Ansicht -> Quelltext anzeigen" (Bezeichnung je nach Browser unterschiedlich) sichtbar machen.

[Bearbeiten] Hinweise und Richtlinien zum Einsatz von Kommentaren

Kommentare sollten sinnvoll eingesetzt werden und den Menschen, die den Quelltext bearbeiten, die Bearbeitung erleichtern. Zu viele Kommentare sind ebenso wenig hilfreich wie zu wenige. Kommentieren Sie nur Wesentliches, z.B. wichtige Bereiche des Dokuments oder ungewöhnliche, schwierig verständliche Formatierungen, die speziell in jenem Dokument auftreten.

[Bearbeiten] Formatierungsvorschlag für Kommentare

Einige professionelle X(HT)ML-Entwickler haben aus der Software-Entwicklung mit Sprachen wie C oder Java die folgenden Konvention für Kommentare übernommen:

• Der Inhalt mehrzeiliger Kommentare wird eingerückt.
• Die Folgezeilen mehrzeiliger Kommentare beginnen mit -.
• Das Kommentarende steht einzeln auf einer neuen Zeile.

Beispiel:

 <!-- Dies ist ein
   - mehrzeiliger
   - Kommentar
   -->

Wenn man sich an diese Konvention hält, ist ein Kommentar besonders gut als solcher erkennbar. Das ist vor allem dann nützlich, wenn der Kommentar dazu dient, einen Teil der Webseite vorübergehend auszublenden:

 <!-- Zur Zeit nicht verwendet, weil Demo nicht verfügbar:
   - <p>
   -     <img src="test.png" alt="test" />
   -     Testen Sie das Produkt mit einer <a href="demo">Demo-Version</a>
   - </p>
   -->

Im Vergleich zu

 <!-- Zur Zeit nicht verwendet, weil Demo nicht verfügbar:
 <p>
     <img src="test.png" alt="test" />
     Testen Sie das Produkt mit einer <a href="demo">Demo-Version</a>
 </p>
 -->

[Bearbeiten] Definition gemäß W3C

XHTML-Kommentare werden in Kapitel 2.5 der XML-Spezifikation als BNF-Produktion 15 wie folgt definiert:

[15] Comment ::= '<!--' ((Char - '-') | ('-' (Char - '-')))* '-->'

Die Produktion sagt aus, dass

• ein Kommentar mit der Zeichenfolge <!-- beginnt,
• eine beliebig lange, auch leere Zeichenfolge aus sämtliche in XML erlaubten Zeichen mit Ausnahme mehrerer aufeinanderfolgender --Zeichen enthalten darf und
• mit der Zeichenfolge --> endet.

[Bearbeiten] Weblinks

• Extensible Markup Language (XML) 1.0, 2.5 Comments
• Extensible Markup Language (XML) 1.0 Deutsche Übersetzung, 2.5 Kommentare

Zurück zu Spezielle Bereiche im Text | Hoch zu XHTML | Vor zu Kopfdaten / Meta-Angaben