Erstellung der Seiten

Erstellung der Seiten
	Webseiten erstellen mit DocBook

Die einzelnen Seiten der Website werden in einzelnen XML-Dateien gehalten. Es handelt sich bei den Dateien um leicht erweiterte Simplified DocBook-Dokumente, für die „-//Norman Walsh//DTD Website V2.3//EN“ als Pulic ID und die URL der DTD, z.B. „http://docbook.sourceforge.net/release/website/2.3/website.dtd“ als System ID angegeben werden.

Das Wurzel-Element ist webpage und hier ist Wichtig, dass jedes webpage-Element auf der ganzen Site eine global eindeutige id hat. Das ist nötig, um Verlinkungen innerhalb einer Site zu ermöglichen. Anstatt eines zu erwartenden webpageinfo gibt es einen head, der zwingend erforderlich ist und neben dem obligatorischen title auch script und style enthalten kann. Der nachfolgende Inhalt ist ganz normaler Simplified DocBook-Markup.

Links und Verknüpfungen

Externe Links werden in der Website DTD über ulink realisiert, bei internen Links ist das etwas komplizierter. Dabei greift man auf olink und nicht geparste Entitäten zurück. Dabei empfieht sich folgendes Vorgehen:

Erzeugen Sie eine Entität, die das Sprungziel identifiziert, z.B.
```
<!ENTITY linking SYSTEM "olink.xml" NDATA XML>
```
der Name der Entität ist dabei unwichtig und kann beliebig gewählt werden, aber achten Sie darauf, dass die System ID eine gültige absolute URL oder ein relativer Pfad ist.

Jetzt muss in jedes Dokument, welches auf die Datei olink.xml verweisen soll die Doctype-Deklaration so erweitert werden, dass die Entität in dieser Datei bekannt ist. Die Doctype-Deklaration sähe dann in etwa so aus:

<!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.3//EN"
          SYSTEM "http://docbook.sourceforge.net/release/website/2.3/website.dtd [
<!ENTITY linking SYSTEM "olink.xml" NDATA XML>
]>

Wenn auf mehrere Dateien verwiesen werden soll, so müssen natürlich mehrere Entitäten eingefügt werden

An den Stellen im Dokument, an denen der Link eingefügt werden soll, setzen Sie jetzt das Element olink ein. Es enthält die Linkbeschriftung als Text und mit dem Attribut targetdocent wird die Entität, die auf das Zieldokument verweist angesprochen.
```
<olink targetdocent="linking">link text</olink>
```
Wenn Sie eine ganz bestimmte Stelle im Zieldokument ansprechen möchten, so geben Sie ihr eine id und verwenden im olink das Attribut localinfo, um diese id anzusprechen.

Dieses Vorgehen stellt sicher, dass auch bei wechselnden Dateinamen und Verzeichnisstrukturen immer auf die richtige Datei verwiesen wird.

Beispiel 4.3. Eine einzelne Webseite

<?xml version="1.0" encoding="UTF-8"?>
PUBLIC "-//Norman Walsh//DTD Website V2.3//EN"
 SYSTEM "http://docbook.sourceforge.net/release/website/2.3/website.dtd">
<webpage id="website">
<head>
<title>Dokumentationen mit DocBook-XML</title>
</head>
<para>
  Dies ist die offizizelle Seite zu Lars Trieloffs Tutorium
<quote>Dokumentationen mit DocBook-XML</quote>
. Auf dieser Seite finden Sie
  neben dem Tutorium auch Links zu 
  verwendeter Software und weiteren Ressourcen.
</para>
</webpage>