In diesem Kapitel werden die beiden vom FDP eingesetzten Auszeichnungssprachen XHTML und DocBook behandelt. Hierbei beschränkt sich dieses Kapitel auf die Elemente, die bei der täglichen Arbeit am ehesten zum Einsatz kommen werden.
Beide Sprachen besitzen eine große Anzahl von Elementen. Das erschwert es, das richtige Element in der richtigen Situation auszuwählen. Aus diesem Grund werden zu jedem Element auch immer Beispiele angeboten, die den richtigen Einsatz des Elements verdeutlichen sollen.
Es ist nicht das Ziel dieses Kapitels möglichst viele Elemente beider Sprachen zu behandeln – dies wäre nur eine Wiederholung der eigentlichen Sprachreferenz. Sofern es Unklarheiten zur Verwendung einzelner Elemente und Auszeichnung von bestimmten Sachverhalten gibt, können diese an FreeBSD documentation project geschickt werden.
Wenn im Folgenden von Flußelementen die Rede ist, sind damit Elemente gemeint, die in einem Blockelement auftreten können und keinen Zeilenumbruch hervorrufen. Blockelemente hingegen erzeugen unter anderem einen Zeilenumbruch[11].
XHTML ist die XML Version der HyperText Markup Language, der Auszeichnungssprache der Wahl im World Wide Web. Weitere Informationen zu XHTML finden sich unter http://www.w3.org/.
XHTML kommt bei der Erstellung der Webseiten des FreeBSD-Projektes zum Einsatz. Für technische Dokumentationen sollte XHTML jedoch nicht eingesetzt werden, da DocBook eine größere und bessere Auswahl an Elementen bietet. Folglich sollte XHTML nur für die FreeBSD-Webseiten verwendet werden.
Die HTML-Spezifikation liegt bis jetzt in mehreren Versionen vor: 1, 2, 3.0, 3.2, 4.0 sowie eine XML konforme Version namens XHTML in seiner neuesten Version XHTML 1.0 (verfügbar als strict und transitional Variante.
Die XHTML-DTDs sind über den Port textproc/xhtml
verfügbar und werden
automatisch als Teil des Metaports textproc/docproj
installiert.
Da es mehrere Version von XHTML gibt, existieren auch mehrere FÖPs, zu denen ein XHTML-Dokument konform erklärt werden kann. Die Mehrzahl der sich auf der FreeBSD-Webseite befindenden XHTML-Seiten sind zu der lockeren Version von XHTML 1.0 konform.
Ein XHTML-Dokument unterteilt sich normalerweise in zwei
Bereiche: „head“ und „body“. Der
Kopf (head) enthält Metadaten
wie den Dokumententitel und Angaben zum Autor. Der Rumpf
(body) umfasst den eigentlichen
Dokumenteninhalt, der für den Leser bestimmt ist. In einem
XHTML-Dokument werden diese Bereiche über die Elemente
head
und body
voneinander abgegrenzt. Beide sind Kinder des Wurzelelementes
html
.
Der Dokumententitel
</title>
</head>
<body>
…
</body>
</html>XHTML kennt sechs verschiedene Elemente, mit denen
Überschriften ausgezeichnet werden können. Das bekannteste
Element ist h1
, das sich am Anfang der
Überschriftenhierarchie befindet. h1
folgen die Überschriftenelemente h2
bis
h6
. Der Inhalt von
h
stellt den
Text der Überschrift dar.N
h1
, h2
…Fügen Sie in eine der existierenden Übungsdateien folgendes ein:
Eine XHTML-Seite sollte immer nur eine Überschrift
h1
haben. Dieser Überschrift können
beliebig viele Kapitel mit einer Überschrift
h2
folgen, die selbst wiederum eine
beliebige Anzahl von Kapiteln mit einer Überschrift
h3
enthalten können. Diese
Verschachtelung setzt sich bis zu Kapiteln mit einer
h6
-Überschrift fort. Es sollte vermieden
werden, Elemente in der Überschriftenhierarchie
auszulassen.
Fügen Sie in eine der existierenden Übungsdateien folgendes ein:
Absätze können in XHTML mit Hilfe des Elementes
p
ausgezeichnet werden.
p
Fügen Sie in eine der existierenden Übungsdateien folgendes ein:
Ein Blockzitat ist ein etwas umfangreicheres Zitat aus einem anderen Text, das nicht zum aktuellen Absatz gehört.
Fügen Sie in eine der existierenden Übungsdateien folgendes ein:
XHTML kennt drei Arten von Listen: sortierte, unsortierte und Definitionslisten. Ein Eintrag in einer sortierten Liste wird üblicherweise mit einer Nummer versehen, Einträge in unsortierten Listen hingegen mit einem Aufzählungspunkt. Definitionslisten wiederum bestehen aus zwei Teilen: Der erste enthält den Begriff der definiert werden soll und der zweite dessen Erläuterung.
Sortierte Listen werden mit dem Element
ol
(für
ordered
list) ausgezeichnet,
unsortierte Listen mit ul
(für
unordered
list) und
Definitionslisten mit dl
.
Listenpunkte sortierter und unsortierter Listen werden
mit dem Element li
ausgezeichnet,
welches Text oder andere Blockelemente enthalten kann.
Begriffe, die in einer Definitionslisten enthalten sind,
werden mit dem Element dt
(für
definition
term) ausgezeichnet.
Die Erklärung zu diesem Begriff wird mit Hilfe des Elementes
dd
(für definition
description) markiert. So wie
li
, kann das Element
dd
ebenfalls andere Blockelemente
aufnehmen.
ul
und
ol
erstellenFügen Sie in eine der existierenden Übungsdateien folgendes ein:
dl
erstellenFügen Sie in eine der existierenden Übungsdateien folgendes ein:
In einigen Fällen ist es gewollt, dass die Formatierung
eines Textes im Quelldokument erhalten bleibt, damit der
Leser diesen genau so sieht, wie ihn der Autor erstellt hat.
In der XHTML-Spezifikation ist dafür das Element
pre
vorgesehen, welches dafür sorgt, dass
Zeilenumbrüche erhalten bleiben und Leerzeichen nicht
zusammengefasst werden. Browser verwenden für den
Inhalt des Elementes pre
üblicherweise eine Fixschrift.
pre
erstellenDer Originaltext einer E-Mail läßt sich beispielsweise wie folgt einbinden:
Beachten Sie, dass <
und
&
nach wie vor als Sonderzeichen
erkannt werden. Daher wird in diesem Beispiel auch
<
an Stelle von
<
verwendet. Aus dem gleichen
Grund wurde auch >
an Stelle
von >
verwendet. Achten Sie also
stets auf Sonderzeichen, wenn Sie normalen Text
aus E-Mails, Programmcode oder einer anderen Quelle
kopieren.
Die meisten Textbrowser, beispielsweise Lynx, können Tabellen nicht besonders gut darstellen. Deshalb sollten Auszeichnungsalternativen in Betracht gezogen werden, um eine angemessene Darstellung sicherzustellen.
Tabellen lassen sich in XHTML mit Hilfe des Elements
table
auszeichnen. Eine Tabelle setzt
sich aus einer oder mehreren Zeilen (tr
)
zusammen, von denen jede mindestens eine Zelle
(td
) enthält. Zellen können wiederum
andere Blockelemente, wie Absätze oder Listen, enthalten.
Auch können sie auch andere Tabellen aufnehmen, wobei die
Verschachtelungstiefe unbegrenzt ist. Soll die Tabellenzelle
nur einen Textabsatz enthalten, ist es nicht notwendig den
Text mit einem p
zu umschließen.
table
Fügen Sie in eine der existierenden Übungsdateien folgendes ein:
XHTML kennt die Möglichkeit, dass sich eine
Zelle mehrere Zeilen und/oder Spalten erstrecken kann.
Sollen beispielsweise mehrere Spalten zusammenfassen werden,
kann dies mit Hilfe des Attributes
colspan
erreicht werden, indem man ihm
die Anzahl der zusammenzufassenden Spalten zuweist.
Ähnliches gilt für die Zusammenfassung von Zeilen:
Hierfür wird dem Attribut rowspan
die Anzahl der zusammenzufassenden Zeilen zugewiesen.
rowspan
colspan
rowspan
und
colspan
Sollen sich bestimmte Informationen von anderen optisch
abheben, kann dies mit den HTML-Tags
strong
und em
erreicht
werden. strong
stellt dabei eine
stärkere Hervorhebung als em
dar,
wobei mit strong
ausgezeichnete Elemente
fett und mit em
ausgezeichnete Elemente
kursiv dargestellt werden. Allerdings ist diese Aussage
nicht verlässlich, da die Darstellung vom Browser
abhängig ist. In der Praxis ist es so, dass Webseiten
nur strukturelle und semantische Informationen enthalten
und Stylesheets später auf diese Informationen
angewendet werden. Beachten Sie also die Semantik und
nicht die Formatierung wenn Sie mit diesen
Tags arbeiten.
em
und strong
hervorhebenBei Links handelt es sich ebenfalls Flußelemente.
Um auf ein anderes Dokument im WWW zu verweisen, müssen Sie die URL dieses Dokuments kennen.
Links auf andere Dokumente im WWW werden in HTML durch
den Tag a
und dessen Attribute href
, das die Zieladresse
enthält, angelegt. Der Inhalt des Elementes wird selbst
zum Link und seine Darstellung erfolgt verschieden vom
übrigen Text. Meist geschieht das durch eine andere
Schriftfarbe oder dadurch, dass der Linktext
unterstrichen wird.
<a href="...">
benutzenBeim Aufruf dieses Links wird das referenzierte Dokument vom Browser geladen und mit dessen Seitenanfang dargestellt.
XHTML unterstützt neben einfachen Links auch solche, die
auf einen bestimmten Abschnitt innerhalb eines Dokumentes
verweisen. Dazu müssen die Abschnitte, auf die verwiesen
werden soll, mit Hilfe von sogenannten „Ankern“
markiert werden. Diese Anker können ebenfalls mit Hilfe des
Tags a
gesetzt werden, nur das anstelle
von href
das Attribut
name
gesetzt werden
muss.
<a id="...">
Um auf einen so gekennzeichneten Abschnitt zu verweisen,
muss die URL des Dokumentes um das Zeichen
#
und den Namen des Zielankers erweitert
werden.
Für dieses Beispiel wird davon ausgegangen, dass der mit
absatz1
gekennzeichnete Absatz sich in
der XHTML-Datei foo.html
befindet.
[11] Die englische Bezeichnung inline element wurde in Anlehnung an das Wort „Fließtext“ mit „Flußelement“ übersetzt.
Wenn Sie Fragen zu FreeBSD haben, schicken Sie eine E-Mail an
<de-bsd-questions@de.FreeBSD.org>.
Wenn Sie Fragen zu dieser Dokumentation haben, schicken Sie eine E-Mail an
<de-bsd-translators@de.FreeBSD.org>.