diff --git a/de_DE.ISO8859-1/books/fdp-primer/book.sgml b/de_DE.ISO8859-1/books/fdp-primer/book.sgml
index 7e5472ed9b..460b6fc302 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/book.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/book.sgml
@@ -1,303 +1,303 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML, HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/book.sgml,v 1.20 2008/10/10 06:52:19 jkois Exp $
-     basiert auf: 1.31
+     $FreeBSDde: de-docproj/books/fdp-primer/book.sgml,v 1.21 2008/12/14 18:34:06 jkois Exp $
+     basiert auf: 1.32
 -->
 
 <!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
 <!ENTITY % books.ent PUBLIC "-//FreeBSD//ENTITIES DocBook FreeBSD Books Entity Set//DE">
 %books.ent;
 <!ENTITY % chapters SYSTEM "chapters.ent">
 %chapters;
 <!ENTITY % not.published "INCLUDE">
 ]>
 
 <book lang="de">
   <bookinfo>
     <title>Die Fibel f&uuml;r neue Mitarbeiter des
       FreeBSD-Dokumentationsprojekts</title>
 
     <copyright>
       <year>1998</year>
       <year>1999</year>
       <year>2000</year>
       <year>2001</year>
       <year>2002</year>
       <year>2003</year>
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <year>2008</year>
       <holder>The FreeBSD Documentation Project</holder>
     </copyright>
 
     <copyright>
       <year>1998</year>
       <year>1999</year>
       <year>2000</year>
       <year>2001</year>
       <year>2002</year>
       <year>2003</year>
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <year>2008</year>
       <holder>The FreeBSD German Documentation Project</holder>
     </copyright>
 
     <pubdate role="rcs">$FreeBSD$</pubdate>
 
     <releaseinfo>$FreeBSD$</releaseinfo>
 
     &bookinfo.legalnotice;
 
     <abstract>
       <para>Vielen Dank f&uuml;r Ihr Interesse und Ihre Mitarbeit an
         der FreeBSD-Dokumentation. Jeder Beitrag ist f&uuml;r uns sehr
         wichtig.</para>
 
       <para>In dieser Fibel wird von der eingesetzten Software bis hin
         zu den Vorstellungen des FreeBSD-Dokumentationsprojekts alles
         behandelt, was Sie wissen m&uuml;ssen, wenn Sie sich am
         FreeBSD-Dokumentationsprojekt beteiligen wollen.</para>
 
       <para>Bitte beachten Sie, dass diese Fibel
         <emphasis>jederzeit</emphasis> unter Bearbeitung und noch
         nicht vollst&auml;ndig ist.</para>
     </abstract>
   </bookinfo>
 
   <preface id="preface">
     <title>Benutzungshinweise</title>
 
     <sect1 id="preface-prompts">
       <title>Die Eingabeaufforderungen</title>
 
       <para>Die folgende Tabelle zeigt die normale Eingabeaufforderung
         des Systems und die Eingabeaufforderung des Superusers. Die in
         diesem Buch vorkommenden Beispiele benutzen die jeweilige
         Eingabeaufforderung, um zu zeigen, unter welchem Benutzer die
         Beispiele ausgef&uuml;hrt werden sollten.</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Benutzer</entry>
 	      <entry>Eingabeaufforderung</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><username>Normaler Benutzer</username></entry>
 	      <entry>&prompt.user;</entry>
 	    </row>
 
 	    <row>
 	      <entry><username>Superuser</username></entry>
 	      <entry>&prompt.root;</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
     </sect1>
 
     <sect1 id="preface-conventions">
       <title>Typographische Festlegungen</title>
 
       <para>Um die Lesbarkeit zu erh&ouml;hen, werden in diesem
         Dokument die im folgenden genannten typographischen
         Festlegungen verwendet:</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Bedeutung</entry>
 
 	      <entry>Beispiel</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>Kommandonamen</entry>
 
 	      <entry>Geben Sie <command>ls -a</command> ein, um alle
 		Dateien anzuzeigen.</entry>
 	    </row>
 
 	    <row>
 	      <entry>Datei- und Verzeichnisnamen</entry>
 
 	      <entry>Bearbeiten Sie die Datei
 		<filename>.login</filename>.</entry>
 	    </row>
 
 	    <row>
 	     <entry>Bildschirmein- und ausgaben</entry>
 
 	     <entry><screen>You have mail.</screen></entry>
 	    </row>
 
 	    <row>
 	      <entry>Referenzen auf Hilfeseiten</entry>
 
 	      <entry>Mit &man.su.1; k&ouml;nnen Sie sich als ein anderer
                 Benutzer anmelden.</entry>
 	    </row>
 
 	    <row>
 	      <entry>Benutzer- und Gruppennamen</entry>
 
 	      <entry>Ich bin <username>root</username>, ich darf
                 das.</entry>
 	    </row>
 
 	    <row>
 	      <entry>Hervorhebungen</entry>
 
 	      <entry>Hier <emphasis>m&uuml;ssen</emphasis> Sie
                 vorsichtig sein.</entry>
 	    </row>
 
 	    <row>
 	      <entry>Argumente auf der Kommandozeile, die durch
                 existierende Namen, Dateien oder Variablen ersetzt
                 werden m&uuml;ssen</entry>
 
 	      <entry>Dateien k&ouml;nnen Sie mit dem Befehl
                 <command>rm
                   <filename><replaceable>Dateiname</replaceable></filename></command>
                 l&ouml;schen.</entry>
 	    </row>
 
 	    <row>
 	      <entry>Umgebungsvariablen</entry>
 
 	      <entry><envar>$HOME</envar> ist Ihr
                 Benutzerverzeichnis.</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
     </sect1>
 
     <sect1 id="preface-notes">
       <title>Anmerkungen, Tips, wichtige Hinweise, Warnungen und
         Beispiel</title>
 
       <para>An einigen Stellen innerhalb dieses Buchs werden
         wichtige oder n&uuml;tzliche Hinweise gegeben, die besonders
         hervorgehoben sind. Hier ein kurzer &Uuml;berblick &uuml;ber
         die verwendeten Darstellungen.</para>
 
       <note>
 	<para>Anmerkungen werden so dargestellt. Sie enthalten
           Informationen die Sie nur zu lesen brauchen, wenn Sie direkt
           davon betroffen sind.</para>
       </note>
 
       <tip>
         <para>Tipps sind Informationen, die vielleicht hilfreich sein
           k&ouml;nnten oder aufzeigen, wie bestimmte Dinge einfacher
           zu bewerkstelligen sind.</para>
       </tip>
 
       <important>
         <para>Besonders wichtige Punkte werden so hervorgehoben. Meist
           enthalten sie Hinweise auf vielleicht zus&auml;tzlich auszuf&uuml;hrende
           Schritte oder Dinge, die besonders zu beachten sind.</para>
       </important>
 
       <warning>
         <para>Warnungen werden wie dieser Abschnitt dargestellt und
           weisen auf m&ouml;gliche Sch&auml;den hin, die entstehen
           k&ouml;nnen, falls die beschriebenen Schritte nicht genau
           befolgt oder Hinweise nicht beachtet werden. Die Palette der
           m&ouml;glichen Sch&auml;den reicht von Hardwaresch&auml;den
           bis hin zu Datendatenverlust durch ein versehentliches
           L&ouml;schen von wichtigen Dateien oder ganzen
           Verzeichnissen.</para>
       </warning>
 
       <example>
 	<title>Ein Beispiel</title>
 
         <para>Beispiele, die so wie hier dargestellt werden, enthalten
           meist kleine &Uuml;bungen, die nachvollzogen werden sollten,
           um das vorher beschriebene besser zu verinnerlichen oder mit
           den erzeugten Ausgaben vertraut zu werden.</para>
       </example>
     </sect1>
 
     <sect1 id="preface-acknowledgements">
       <title>Danksagungen</title>
 
       <para>Ich m&ouml;chte mich bei Sue Blake, Patrick Durusau, Jon
         Hamilton, Peter Flynn und Christopher Maden bedanken, die sich
         die Zeit genommen haben, die fr&uuml;hen Entw&uuml;rfe dieses
         Dokuments zu lesen und viele hilfreiche Hinweise und
         Ratschl&auml;ge gegeben haben.</para>
     </sect1>
   </preface>
 
   &chap.overview;
   &chap.tools;
   &chap.sgml-primer;
   &chap.sgml-markup;
   &chap.stylesheets;
   &chap.structure;
   &chap.doc-build;
   &chap.the-website;
   &chap.translations;
   &chap.writing-style;
   &chap.psgml-mode;
   &chap.see-also;
 
   &app.examples;
 
 <!--
   &index;
 -->
 </book>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.sgml b/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.sgml
index b41a5877b3..de4e32c364 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.sgml
@@ -1,348 +1,348 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/overview/chapter.sgml,v 1.13 2005/08/15 13:35:10 jkois Exp $
-     basiert auf: 1.23
+     $FreeBSDde: de-docproj/books/fdp-primer/overview/chapter.sgml,v 1.14 2008/12/14 18:34:06 jkois Exp $
+     basiert auf: 1.24
 
 -->
 
 <chapter id="overview">
   <title>&Uuml;berblick</title>
 
   <para>Herzlich Willkommen beim FreeBSD-Dokumentationsprojekt.
     Qualitativ hochwertige Dokumentation ist ein wichtiger
     Erfolgsfaktor und sehr bedeutend f&uuml;r die Verbreitung von
     FreeBSD. Die wichtigste Quelle daf&uuml;r ist das
     FreeBSD-Dokumentationsprojekt (FDP). Jeder Beitrag, der zu diesem
     Projekt geleistet wird, ist ungemein wertvoll.</para>
 
   <para>Es ist das Anliegen dieser Fibel, den Leser mit dem FDP
     vertraut zu machen und zu erkl&auml;ren, <emphasis>wie das FDP
       organisiert ist</emphasis>, <emphasis>wie man selber Dokumente
       erstellt und an das FDP einreicht</emphasis> und <emphasis>wie
       die verf&uuml;gbaren Werkzeuge effektiv beim Schreiben
       eingesetzt werden k&ouml;nnen</emphasis>.</para>
 
   <para>Wie jedes Opensourceprojekt, ist auch das FDP auf die Mithilfe
     vieler angewiesen. Deshalb ist jeder herzlich eingeladen
     mitzuarbeiten. Die daf&uuml;r erforderlichen Voraussetzungen sind
     gering und es gibt keine Verpflichtung eine bestimmte Menge an
     Dokumenten pro Monat oder Jahr beizusteuern. Das Einzige was Sie
     tun m&uuml;ssen, ist sich auf der Mailingliste &a.doc; einzutragen.</para>
 
   <para>Nach dem Lesen der FDP-Fibel sollte man wissen:</para>
 
   <itemizedlist>
     <listitem>
       <para>welche Dokumente durch das FDP betreut werden,</para>
     </listitem>
 
     <listitem>
       <para>wie man SGML-Dokumente liest und den SGML-Quellcode der
         durch das FDP betreuten Dokumente versteht,</para>
     </listitem>
 
     <listitem>
       <para>wie man selbst &Auml;nderungen an Dokumenten vornehmen
         kann und</para>
     </listitem>
 
     <listitem>
       <para>wie man &Auml;nderungen zur Begutachtung durch das FDP
         einreichen kann.</para>
     </listitem>
   </itemizedlist>
 
   <sect1 id="overview-doc">
     <title>Die FreeBSD-Dokumentationsreihe</title>
 
     <para>Das FDP umfa&szlig;t vier verschiedene Kategorien:</para>
 
     <variablelist>
       <varlistentry>
         <term>Hilfeseiten</term>
 
         <listitem>
           <para>Die englischen Hilfeseiten wurden nicht vom FDP
             geschrieben, da sie ein Teil des Basissystems sind. Jedoch
             k&ouml;nnen bzw. wurden bereits Teile von existierenden
             Hilfeseiten umformuliert, um sie verst&auml;ndlicher zu
             machen oder um Fehler zu beheben.</para>
 
           <para>F&uuml;r die &Uuml;bersetzung der Hilfeseiten des
             Systems in die verschiedenen Sprachen sind die einzelnen
             &Uuml;bersetzergruppen verantwortlich. Alle dabei
             entstandenen &Uuml;bersetzungen geh&ouml;ren zum
             FDP.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term>Die FAQ</term>
 
         <listitem>
           <para>Das Ziel der FAQ ist es, Fragen, die auf den
             verschiedenen Maillinglisten und in Newsgruppen
             regelm&auml;&szlig;ig diskutiert werden, nach einem
             einfachen  Frage- und Antwort-Muster zu behandeln. Das
             schlie&szlig;t nicht aus, das auf bestimmte Fragen
             ausf&uuml;hrlich und umfassend eingegangen wird.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term>Das Handbuch</term>
 
         <listitem>
           <para>Das Ziel des Handbuches ist es, die
             umfassende Quelle und Referenz im Netz f&uuml;r
             FreeBSD-Benutzer zu sein.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
          <term>Die Webseite</term>
 
          <listitem>
           <para>Die Webseite <ulink
               url="&url.base;/index.html">http://www.FreeBSD.org</ulink>
             und ihre vielen Spiegel auf der ganzen Welt vertreten das
             FreeBSD-Projekt im WWW. F&uuml;r viele Menschen
             ist sie der erste Kontakt mit FreeBSD.</para>
 	</listitem>
       </varlistentry>
     </variablelist>
 
     <para>Jede dieser vier Kategorien wird im FreeBSD-CVS-Baum
       verwaltet. Das bedeutet, dass alle &Auml;nderungen an den
       Dateien f&uuml;r jeden verf&uuml;gbar sind und jeder sich
       mittels eines Programms wie <application>CVSup</application>
       oder <application>CTM</application> eine lokale Kopie der
       Dokumentation anlegen kann.</para>
 
     <para>Parallel zum FDP haben viele Menschen Anleitungen
       geschrieben und Webseiten mit Bezug zu FreeBSD erstellt. Einige
       davon werden im CVS-Archiv verwaltet, sofern der Autor dem
       zugestimmt hat. In anderen F&auml;llen hat sich der Autor
       entschlossen, seine Dokumentation au&szlig;erhalb des zentralen
       FreeBSD-CVS-Archivs zu verwalten. Das FDP bem&uuml;ht sich, so
       viele Verweise wie m&ouml;glich auf solche Quellen
       bereitzustellen.</para>
   </sect1>
 
   <sect1 id="overview-before">
     <title>Bevor es losgeht</title>
 
     <para>Zum Verst&auml;ndnis der folgenden Kapitel sollte folgendes
       bereits bekannt sein:</para>
 
     <itemizedlist>
       <listitem>
         <para>Wie eine aktuelle Kopie der FreeBSD-Dokumentation
           entweder auf Basis des FreeBSD-CVS-Archivs mittels
           <application>CVS</application>,
           <application>CTM</application> oder
           <application>CVSup</application> angelegt und gepflegt wird,
           oder wie mit <application>CVSup</application> eine frische
           Kopie des CVS-Archivs heruntergeladen wird.</para>
       </listitem>
 
       <listitem>
         <para>Wie neue Programme mit Hilfe des
           FreeBSD-Portsystems oder mittels &man.pkg.add.1;
           heruntergeladen und installiert werden.</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 id="overview-quick-start">
     <title>Der Schnellstart</title>
 
     <para>Falls man einfach loslegen m&ouml;chte und sich sicher genug
       f&uuml;hlt, um alles weitere erst bei Bedarf nachzusehen, kann
       man einfach den folgenden Anweisungen folgen:</para>
 
     <procedure>
       <step>
         <para>Zuerst mu&szlig; der Metaport <filename
             role="package">textproc/docproj</filename> auf dem
           betreffenden Arbeitsrechner installiert werden.</para>
 
 	<screen>&prompt.root; <userinput>cd /usr/ports/textproc/docproj</userinput>
 &prompt.root; <userinput>make JADETEX=no install</userinput></screen>
       </step>
 
       <step>
         <para>Anschlie&szlig;end sollte eine lokale Kopie des
           FreeBSD-<filename>doc</filename>-Verzeichnisbaumes angelegt
           werden. Hierf&uuml;r kann man entweder auf
           <application>CVSup</application> im
           <literal>checkout</literal>-Modus zur&uuml;ckgreifen oder
           mittels <application>cvs</application> eine komplette Kopie
           des CVS-Archivs anlegen.</para>
 
         <para>Wenn man lieber mit einer Kopie des CVS-Archivs arbeiten
           m&ouml;chte, werden als Minimum die Verzeichnisse
           <filename>doc/share</filename> und
           <filename>doc/de_DE.ISO8859-1/share</filename>
           ben&ouml;tigt.</para>
 
 	<screen>&prompt.user; <userinput>cvs checkout doc/share</userinput>
 &prompt.user; <userinput>cvs checkout doc/de_DE.ISO8859-1/share</userinput></screen>
 
         <para>F&uuml;r den Fall, dass ausreichend Platz auf der
           Festplatte vorhanden ist, kann auch eine eine
           vollst&auml;ndige Arbeitskopie des gesamten CVS-Baumes anlegt
           werden.</para>
 
 	<screen>&prompt.user; <userinput>cvs checkout doc</userinput></screen>
       </step>
 
       <step>
         <para>Sollte geplant sein, ein existierendes Buch oder einen
           existierenden Artikel zu &auml;ndern, mu&szlig;
           nat&uuml;rlich noch zus&auml;tzlich das betreffende
           Verzeichnis aus dem CVS-Archiv geholt werden. Soll hingegen
           ein neues Buch oder ein neuer Artikel geschrieben werden,
           empfiehlt es sich, auf bestehende B&uuml;cher und Artikel
           zur&uuml;ckzugreifen und diese als Vorlage zu nutzen.</para>
 
 	<para>Ein Artikel &uuml;ber die Konfiguration eines VPNs
 	  zwischen FreeBSD und Windows&nbsp;2000 kann wie
 	  folgt erstellt werden:</para>
 
 	<procedure>
 	  <step>
 	    <para>Zuerst wird das Verzeichnis
               <filename>articles</filename> aus dem FreeBSD-CVS-Archiv
               lokal angelegt:</para>
 
 	    <screen>&prompt.user; <userinput>cvs checkout doc/de_DE.ISO8859-1/articles</userinput></screen>
 	  </step>
 
 	  <step>
             <para>Anschlie&szlig;end kopiert man einen bereits
               existierenden Artikel und nutzt ihn als Vorlage. In
               diesem Beispiel soll der neue Artikel im Verzeichnis
               <filename>vpn-w2k</filename> liegen:</para>
 
 	    <screen>&prompt.user; <userinput>cd doc/de_DE.ISO8859-1/articles</userinput>
 &prompt.user; <userinput>cp -R committers-guide vpn-w2k</userinput></screen>
 	  </step>
 	</procedure>
 
 	<para>Bereits exisitierende Dokumente, die ge&auml;ndert
 	  werden sollen, k&ouml;nnen direkt aus dem CVS-Archiv
 	  geholt werden.  Das folgende Beispiel zeigt das
 	  f&uuml;r die FAQ aus dem Verzeichnis
           <filename>doc/de_DE.ISO8859-1/books/faq</filename>:</para>
 
 	<screen>&prompt.user; <userinput>cvs checkout doc/de_DE.ISO8859-1/books/faq</userinput></screen>
       </step>
 
       <step>
         <para>Jetzt k&ouml;nnen die <filename>.sgml</filename> Dateien
           mit einem beliebigen Texteditor bearbeitet werden.</para>
       </step>
 
       <step>
         <!--?
         Vielleicht besser als Befehl auf der Kommandozeile
         darstellen?
         Oliver Fischer
         -->
         <para>Danach ist <command>make</command> mit dem Ziel
           <maketarget>lint</maketarget> aufzurufen, um das gesamte
           Dokument auf Auszeichnungsfehler hin zu untersuchen, ohne
           dass zeitaufw&auml;ndige Transformationen vorgenommen
           werden.</para>
 
 	<screen>&prompt.user; <userinput>make lint</userinput></screen>
 
         <!--?
         Glossar sollte vorhanden sein. Darin dann erkl&auml;ren,
         was mit Ziel- und Quelldokument gemeint ist.
         Oliver Fischer
         -->
 
 	<para>Soll anschlie&szlig;end das Zieldokument erstellt
           werden, kann mit Hilfe der Variable
           <varname>FORMATS</varname> bestimmt werden, welche
           Ausgabeformate erzeugt werden sollen. Unterst&uuml;tzt werden
           momentan <literal>html</literal>,
           <literal>html-split</literal>, <literal>txt</literal>,
           <literal>ps</literal>, <literal>pdf</literal> und
           <literal>rtf</literal>. Die aktuelle Liste der
           unterst&uuml;tzten Formate befindet sich am Anfang der Datei
           <filename>doc/share/mk/doc.docbook.mk</filename>. Bei der
           Verwendung dieser Variable ist es wichtig, darauf zu achten,
           dass die Angabe der gew&uuml;nschten Formate in
           Anf&uuml;hrungszeichen eingeschlossen wird, sofern mehr als
           nur ein Format gleichzeitig erstellt werden soll.</para>
 
         <para>Wenn das Dokument beispielsweise nach
           <literal>HTML</literal> konvertiert werden soll, kann dies
           so vorgenommen werden:</para>
 
 	<screen>&prompt.user; <userinput>make FORMATS=html</userinput></screen>
 
         <para>Soll es hingegen in den Formaten <literal>html</literal>
           und <literal>txt</literal> erzeugt werden,
           kann man entweder
           &man.make.1; zweimal hintereinander aufrufen:</para>
 
 	<screen>&prompt.user; <userinput>make FORMATS=html</userinput>
 &prompt.user; <userinput>make FORMATS=txt</userinput></screen>
 
         <para>oder beide Formate mit einem Aufruf von &man.make.1;
           erzeugen:</para>
 
 	<screen>&prompt.user; <userinput>make FORMATS="html txt"</userinput></screen>
       </step>
 
       <step>
         <para>Zum Schlu&szlig; m&uuml;ssen die &Auml;nderungen an das
           FDP mittels &man.send-pr.1; eingesandt werden.</para>
       </step>
     </procedure>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
 
diff --git a/de_DE.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml b/de_DE.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
index 094e3aed96..6ece8429b0 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
@@ -1,3012 +1,3004 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/sgml-markup/chapter.sgml,v 1.21 2007/07/30 19:50:04 jkois Exp $
+     $FreeBSDde: de-docproj/books/fdp-primer/sgml-markup/chapter.sgml,v 1.24 2008/12/14 18:34:06 jkois Exp $
 
-     basiert auf: 1.74
+     basiert auf: 1.77
 -->
 
 <chapter id="sgml-markup">
   <title>SGML-Dokumente erstellen</title>
 
   <para>In diesem Kapitel werden die beiden vom FDP eingesetzen
     Auszeichnungssprachen HTML und DocBook behandelt. Hierbei
     beschr&auml;nkt sich dieses Kapitel auf die Elemente, die bei der
     t&auml;glichen Arbeit am ehesten zum Einsatz kommen werden.</para>
 
   <para>Beide Sprachen besitzen eine gro&szlig;e Anzahl von Elementen.
     Das erschwert es, das richtige Element in der richtigen Situation
     auszuw&auml;hlen. Aus diesem Grund werden zu jedem Element auch
     immer Beispiele angeboten, die den richtigen Einsatz des Elements
     verdeutlichen sollen.</para>
 
   <para>Es ist nicht das Ziel dieses Kapitels m&ouml;glichst viele
     Elemente beider Sprachen zu behandeln &ndash; dies w&auml;re nur
     eine Wiederholung der eigentlichen Sprachreferenz. Sofern es
     Unklarheiten zur Verwendung einzelner Elemente und Auszeichnung
     von bestimmten Sachverhalten gibt, k&ouml;nnen diese an &a.doc;
     geschickt werden.</para>
 
   <note>
     <title>Flu&szlig;- kontra Blockelemente</title>
 
     <!--@todo
     Fussnote bzgl. der UEbersetzung von "inline" einfuegen.
     Oliver Fischer
     -->
 
     <para>Wenn im folgenden von
       <emphasis>Flu&szlig;elementen</emphasis> die Rede ist, sind
       damit Elemente gemeint, die in einem Blockelement auftreten
       k&ouml;nnen und keinen Zeilenumbruch hervorrufen.
       <emphasis>Blockelemente</emphasis> hingegen erzeugen unter
       anderem einen Zeilenumbruch<footnote><para>Die englische
           Bezeichnung <foreignphrase>inline element</foreignphrase>
           wurde in Anlehnung an das Wort <quote>Flie&szlig;text</quote>
           mit <quote>Flu&szlig;element</quote>
           &uuml;bersetzt.</para></footnote>.</para>
   </note>
 
   <sect1 id="sgml-markup-html">
     <title>HTML</title>
 
     <para>HTML, die <foreignphrase>HyperText Markup
       Language</foreignphrase>, ist die Auszeichnungssprache des
       Internets.  Weitere Informationen zu HTML finden sich unter
       <ulink url="http://www.w3.org/"></ulink>.</para>
 
     <para>Sie kommt bei der Erstellung der Webseiten des
       FreeBSD-Projektes zum Einsatz. F&uuml;r technische Dokumentationen
       sollte HTML jedoch nicht eingesetzt werden, da DocBook eine
       gr&ouml;&szlig;ere und bessere Auswahl an Elementen bietet. Folglich
       sollte HTML nur f&uuml;r die FreeBSD-Webseiten verwendet werden.</para>
 
     <para>Die HTML-Spezifikation liegt bis jetzt in mehreren Versionen
       vor: 1, 2, 3.0, 3.2 und (die aktuelle) 4.0. Von letzterer
       existieren zwei Varianten: <quote>streng</quote> (HTML 4.0
       Strict) und <quote>locker</quote> (HTML 4.0
       Transitional).</para>
 
     <para>Die HTML-DTDs  sind &uuml;ber den Port <filename
         role="package">textproc/html</filename> verf&uuml;gbar und werden
       automatisch als Teil des Metaports <filename
         role="package">textproc/docproj</filename>
       mitinstalliert.</para>
 
     <sect2>
       <title>Formale &Ouml;ffentliche Bezeichner</title>
 
       <!--@todo  Optimierungskandidat. Oliver Fischer -->
       <para>Da es mehrere Version von HTML gibt, existieren auch
         mehrere F&Ouml;Ps,  zu denen  ein HTML-Dokument konform
         erkl&auml;rt werden kann. Die Mehrzahl der sich auf der
         FreeBSD-Webseite befindenen HTML-Seiten sind zu der lockeren
         Version von HTML 4.0 konform.</para>
 
       <programlisting>PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"</programlisting>
     </sect2>
 
     <sect2>
       <title>Die Elemente <sgmltag>head</sgmltag> und
         <sgmltag>body</sgmltag></title>
 
       <para>Ein HTML-Dokument unterteilt sich normalerweise in zwei
         Bereiche: <quote>head</quote> und <quote>body</quote>. Der
         Kopf (<foreignphrase>head</foreignphrase>) enth&auml;lt  Metadaten
         wie den Dokumententitel und Angaben zum Autor. Der Rumpf
         (<foreignphrase>body</foreignphrase>) umfa&szlig;t den eigentlichen
         Dokumenteninhalt, der f&uuml;r den Leser bestimmt ist. In einem
         HTML-Dokument werden diese Bereiche &uuml;ber die Elemente
         <sgmltag>head</sgmltag> und <sgmltag>body</sgmltag>
         voneinander abgegrenzt. Beide sind Kinder des Wurzelelementes
         <sgmltag>html</sgmltag>.</para>
 
       <example>
 	<title>Die Struktur eines HTML-Dokumentes</title>
 
 	<programlisting>&lt;html>
   &lt;head>
     &lt;title><replaceable>Der Dokumententitel</replaceable>&lt;/title>
   &lt;/head>
 
   &lt;body>
 
     &hellip;
 
   &lt;/body>
 &lt;/html></programlisting>
       </example>
     </sect2>
 
     <sect2>
       <title>Blockelemente</title>
 
       <sect3>
 	<title>&Uuml;berschriften</title>
 
         <para>HTML kennt sechs verschiedene Elemente, mit denen
           &Uuml;berschriften ausgezeichnet werden k&ouml;nnen. Das  bekannteste
           Element ist <sgmltag>h1</sgmltag>, das sich am Anfang der
           &Uuml;berschriftenhierarchie befindet. <sgmltag>h1</sgmltag>
           folgen die &Uuml;berschriftenelemente <sgmltag>h2</sgmltag> bis
           <sgmltag>h6</sgmltag>. Der Inhalt von
           <sgmltag>h<replaceable>N</replaceable></sgmltag> stellt den
           Text der  &Uuml;berschrift dar.</para>
 
 	<example>
 	  <title><sgmltag>h1</sgmltag>, <sgmltag>h2</sgmltag>&hellip;</title>
 
 	  <para>F&uuml;gen Sie in eine der existierenden &Uuml;bungsdateien folgendes ein:</para>
 
 	  <programlisting><![ RCDATA [<h1>Erstes Kapitel</h1>
 
 <!-- Hier steht die Einf&uuml;hrung -->
 
 <h2>Das ist die &Uuml;berschrift des ersten Kapitels</h2>
 
 <!-- Hier steht der Inhalt des ersten Kapitels -->
 
 <h3>Das ist die &Uuml;berschrift des ersten Unterkapitels</h3>
 
 <!-- Hier steht der Inhalt des ersten Unterkapitels -->
 
 <h2>Das ist die &Uuml;berschrift des zweiten Kapitels</h2>
 
 <!-- Hier steht der Inhalt des zweiten Kapitels -->]]></programlisting>
 	</example>
 
         <para>Eine HTML-Seite sollte immer nur eine &Uuml;berschrift
           <sgmltag>h1</sgmltag> haben. Dieser &Uuml;berschrift k&ouml;nnen
           beliebig viele Kapitel mit einer &Uuml;berschrift
           <sgmltag>h2</sgmltag> folgen, die selbst wiederum eine
           beliebige Anzahl von Kapiteln mit einer &Uuml;berschrift
           <sgmltag>h3</sgmltag> enthalten k&ouml;nnen. Diese
           Verschachtelung setzt sich bis zu Kapiteln mit einer
           <sgmltag>h6</sgmltag>-&Uuml;berschrift fort. Es sollte vermieden
           werden, Elemente in der &Uuml;berschriftenhierarchie
           auszulassen.</para>
 
 	<example>
 	  <title>Falsche Verschachtelung von &Uuml;berschriften</title>
 
 	  <para>F&uuml;gen Sie in eine der existierenden &Uuml;bungsdateien folgendes ein:</para>
 
 	  <programlisting><![ RCDATA [<h1>Erstes Kapitel</h1>
 
 <!-- Allgemeines zum Dokument -->
 
 <h3>Unterkapitel</h3>
 
 <!-- h3 folgt direkt auf h1. h2 wurde ausgelassen -->]]></programlisting>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Abs&auml;tze</title>
 
 	<para>Abs&auml;tze k&ouml;nnen in HTML mit Hilfe des Elementes
           <sgmltag>p</sgmltag> ausgezeichnet werden.</para>
 
 	<example>
 	  <title>Abs&auml;tze mit dem Element <sgmltag>p</sgmltag></title>
 
 	  <para>F&uuml;gen Sie in eine der existierenden &Uuml;bungsdateien folgendes ein:</para>
 
 	  <programlisting><![ RCDATA [<p>Das hier, das ist ein Absatz. Abs&auml;tze k&ouml;nnen
   andere Elemente enhalten.</p>]]></programlisting>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Blockzitate</title>
 
 	<para>Ein Blockzitat ist ein etwas umfangreicheres Zitat aus
           einem anderen Text, das nicht zum aktuellen Absatz
           geh&ouml;rt.</para>
 
 	<example>
 	  <title>Blockzitat</title>
 
           <para>F&uuml;gen Sie in eine der existierenden &Uuml;bungsdateien
             folgendes ein:</para>
 
 	  <programlisting><![ RCDATA [<blockquote>
   <p>Artikel 1: Menschenw&uuml;rde; Grundrechtsbindung der
     staatlichen Gewalt</p>
 
   <ol>
     <li>
       <p>Die W&uuml;rde des Menschen ist unantastbar. Sie zu achten
         und zu sch&uuml;tzen ist Verpflichtung aller staatlichen
         Gewalten.</p>
     </li>
     <li>
       <p>Das Deutsche Volk bekennt sich darum zu unverletzlichen
         und unver&auml;u&szlig;erlichen Menschenrechten als Grundlage jeder
         menschlichen Gemeinschaft, des Friedens und der
         Gerechtigkeit in der Welt.</p>
     </li>
     <li>
       <p>Die nachfolgenden Grundrechte binden Gesetzgebung,
         vollziehende Gewalt und Rechtsprechung als
         unmittelbar geltendes Recht.</p>
     </li>
   </ol>
 </blockquote>]]></programlisting>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Listen</title>
 
         <para>HTML kennt drei Arten von Listen: sortierte, unsortierte
           und Definitionslisten. Ein Eintrag in einer sortierten Liste
           wird &uuml;blicherweise mit einer Nummer versehen, Eintr&auml;ge in
           unsortierten Listen hingegen mit einem Aufz&auml;hlungspunkt.
           Definitionslisten wiederum bestehen aus zwei Teilen: Der
           erste enth&auml;lt den Begriff der definiert werden soll und der
           zweite dessen Erl&auml;uterung.</para>
 
         <para>Sortierte Listen werden mit dem Element
           <sgmltag>ol</sgmltag> (f&uuml;r
           <foreignphrase><emphasis>o</emphasis>rdered
             <emphasis>l</emphasis>ist</foreignphrase>) ausgezeichnet,
           unsortierte Listen mit <sgmltag>ul</sgmltag> (f&uuml;r
           <foreignphrase><emphasis>u</emphasis>nordered
             <emphasis>l</emphasis>ist</foreignphrase>) und
           Definitionslisten mit <sgmltag>dl</sgmltag>.</para>
 
 
         <para>Listenpunkte sortierter und unsortierter Listen werden
           mit dem Element <sgmltag>li</sgmltag>  ausgezeichnet,
           welches Text oder andere Blockelemente enthalten kann.
           Begriffe, die in einer Definitionslisten enthalten sind,
           werden mit dem Element <sgmltag>dt</sgmltag> (f&uuml;r
           <foreignphrase><emphasis>d</emphasis>efinition
             <emphasis>t</emphasis>erm</foreignphrase>) ausgezeichnet.
           Die Erkl&auml;rung zu diesem Begriff wird mit Hilfe des Elementes
           <sgmltag>dd</sgmltag> (f&uuml;r <foreignphrase>definition
             description</foreignphrase>) markiert. So wie
           <sgmltag>li</sgmltag>, kann das Element
           <sgmltag>dd</sgmltag> ebenfalls andere Blockelemente
           aufnehmen.</para>
 
 	<example>
 	  <title>Listen mit <sgmltag>ul</sgmltag> und
             <sgmltag>ol</sgmltag> erstellen</title>
 
 	  <para>F&uuml;gen Sie in eine der existierenden &Uuml;bungsdateien
             folgendes ein:</para>
 
 	  <programlisting><![ RCDATA [<p>Jetzt folgt eine unsortierte Liste. Wahrscheinlich werden
   die einzelnen Eintr&auml;ge mit einem vorangehenden Punkt dargestellt.</p>
 
 <ul>
   <li>Erster Eintrag</li>
 
   <li>Zweiter Eintrag</li>
 
   <li>Dritter Eintrag</li>
 </ul>
 
 <p>Die zweite Liste ist sortiert und ihre Eintr&auml;ge bestehen aus mehreren Abs&auml;tzen.
   Jeder Listeneintrag ist nummeriert.</p>
 
 <ol>
   <li><p>Das ist der erste Eintrag mit nur einem Absatz.</p></li>
 
   <li><p>Das ist der erste Absatz des zweiten Eintrags.</p>
 
     <p>Und das ist der zweite Absatz des zweiten Eintrags.</p></li>
 
   <li><p>Der dritte Eintrag besteht ebenfalls nur aus einem Eintrag.</p></li>
 </ol>]]></programlisting>
 	</example>
 
 	<example>
 	  <title>Definitionslisten mit <sgmltag>dl</sgmltag> erstellen</title>
 
           <para>F&uuml;gen Sie in eine der existierenden &Uuml;bungsdateien folgendes ein:</para>
 
 	  <programlisting><![ RCDATA [<dl>
   <dt>Erster Begriff</dt>
 
   <dd><p>Erster Absatz der Erkl&auml;rung</p>
 
     <p>Zweiter Absatz der Erkl&auml;rung.</p></dd>
 
   <dt>Zweiter Begriff</dt>
 
   <dd><p>Erster Absatz der Erkl&auml;rung.</p></dd>
 
   <dt>Dritter Begriff</dt>
 
   <dd>Erster Absatz der Erkl&auml;rung zum dritten Begriff.</dd>
 </dl>]]></programlisting>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Vorformatierter Text</title>
 
         <!--@todo Bezeichnung ,,Schrift mit fester Laufweite'' Richtig?
               Oliver Fischer, 21.03.04 -->
         <para>In einigen F&auml;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 HTML-Spezifikation ist daf&uuml;r das Element
           <sgmltag>pre</sgmltag> vorgesehen, welches daf&uuml;r sorgt, dass
           Zeilenumbr&uuml;che erhalten bleiben und Leerzeichen nicht
           zusammengefa&szlig;t werden. Browser verwenden f&uuml;r den
 	  Inhalt des Elementes <sgmltag>pre</sgmltag>
 	  &uuml;blicherweise eine Fixschrift.</para>
 
 	<example>
 	  <title>Vorformatierten Text mit <sgmltag>pre</sgmltag> erstellen</title>
 
           <para>Der Originaltext einer E-Mail l&auml;&szlig;t sich beispielsweise
             wie folgt einbinden:</para>
 
 	  <!--<para>You could use <sgmltag>pre</sgmltag> to mark up an e-mail
 	    message;</para>-->
 
 	  <programlisting><![ RCDATA [<pre>  From: nik@FreeBSD.org
   To: freebsd-doc@FreeBSD.org
   Subject: Neue Version verf&uuml;gbar
 
   Es ist eine neue Version der Fibel f&uuml;r neue Mitarbeiter am
   FreeBSD-Dokumentationsprojekt verf&uuml;gbar:
 
     &lt;URL:http://people.FreeBSD.org/~nik/primer/index.html&gt;
 
   Kommentare und Anmerkungen sind willkommen.
 
   N</pre>]]></programlisting>
 
 	  <para>Beachten Sie, dass <literal>&lt;</literal> und
 	    <literal>&amp;</literal> nach wie vor als Sonderzeichen
 	    erkannt werden.  Daher wird in diesem Beispiel auch
 	    <literal>&amp;lt;</literal> an Stelle von
 	    <literal>&lt;</literal> verwendet.  Aus dem gleichen
 	    Grund wurde auch <literal>&amp;gt;</literal> an Stelle
 	    von <literal>&gt;</literal> verwendet.  Achten Sie also
 	    stets auf Sonderzeichen, wenn Sie normalen Text
 	    aus E-Mails, Programmcode oder einer anderen Quelle
 	    kopieren.</para>
 
 	</example>
       </sect3>
 
       <sect3>
 	<title>Tabellen</title>
 
 	<note>
           <para>Die meisten Textbrowser, beispielsweise Lynx, k&ouml;nnen
             Tabellen nicht besonders gut darstellen. Deshalb sollten
             Auszeichnungsalternativen in Betracht gezogen werden, um
             eine angemessene Darstellung sicherzustellen.</para>
 	</note>
 
         <para>Tabellen lassen sich in HTML mit Hilfe des Elements
           <sgmltag>table</sgmltag> auszeichnen. Eine Tabelle setzt
           sich aus einer oder mehreren Zeilen (<sgmltag>tr</sgmltag>)
           zusammen, von denen jede mindestens eine Zelle
           (<sgmltag>td</sgmltag>) enth&auml;lt. Zellen k&ouml;nnen wiederum
           andere Blockelemente, wie Abs&auml;tze oder Listen, enthalten.
           Auch k&ouml;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 <sgmltag>p</sgmltag> zu umschlie&szlig;en.</para>
 
 	<example>
 	  <title>Einfache Tabelle mit <sgmltag>table</sgmltag></title>
 
 	  <para>F&uuml;gen Sie in eine der existierenden &Uuml;bungsdateien folgendes ein:</para>
 
 	  <programlisting><![ RCDATA [<p>Eine einfache 2x2 Tabelle.</p>
 
 <table>
   <tr>
     <td>Obere linke Zelle</td>
 
     <td>Obere rechte Zelle</td>
   </tr>
 
   <tr>
     <td>Untere linke Zelle</td>
 
     <td>Untere rechte Zelle</td>
   </tr>
 </table>]]></programlisting></example>
 
         <para>HTML kennt die M&ouml;glichkeit, dass sich eine
           Zelle mehrere Zeilen und/oder Spalten erstrecken kann.
           Sollen beispielsweise mehrere Spalten zusammenfassen werden,
           kann dies mit mit Hilfe des Attributes
           <literal>colspan</literal> erreicht werden, indem man ihm
           die Anzahl der zusammenzufassenden Spalten zuweist.
           &Auml;hnliches gilt f&uuml;r die Zusammenfassung von Zeilen:
           Hierf&uuml;r wird dem Attribut <literal>rowspan</literal>
           die Anzahl der zusammenzufassenden Zeilen zugewiesen.</para>
 
 	<example>
 	  <title>Anwendung des Attributes <literal>rowspan</literal></title>
 
 	  <programlisting><![ RCDATA [<p>Diese Tabelle besteht aus einer langen Zelle auf der
   linken Seite und zwei kleineren Zellen auf der rechten.</p>
 
 <table>
   <tr>
     <td rowspan="2">Lang und d&uuml;nn</td>
   </tr>
 
   <tr>
     <td>Obere Zelle</td>
 
     <td>Untere Zelle</td>
   </tr>
 </table>]]></programlisting>
 	</example>
 
 	<example>
 	  <title>Anwendung des Attributes <literal>colspan</literal></title>
 
 	  <programlisting><![ RCDATA [<p>Eine breite Zeile oben und zwei schmalere Zeilen
   darunter.</p>
 
 <table>
   <tr>
     <td colspan="2">Obere Zelle</td>
   </tr>
   <tr>
     <td>Linke untere Zelle</td>
 
     <td>Rechte untere Zelle</td>
   </tr>
 </table>]]></programlisting>
 	</example>
 
 	<example>
 	  <title>Gemeinsame Anwendung der Attrbute <literal>rowspan</literal> und
 	    <literal>colspan</literal></title>
 
 	  <programlisting><![ RCDATA [<p>Eine Tablle mit 3-mal-3 Zellen. Oben links
   werden 2 mal 2 Zelle zusammengezogen.</p>
 
 <table>
   <tr>
     <td colspan="2" rowspan="2">Gro&szlig;e obere linke Zelle</td>
 
     <td>Obere rechte Zelle</td>
   </tr>
 
   <tr>
     <!-- Da sich die zusammengefa&szlig;te Zelle &uuml;ber zwei Zeilen
          erstreckt, befindet sich das die durch dieses <td>
          definierte Zelle ganz rechts. -->
 
     <td>Mittlere rechte Zelle</td>
   </tr>
 
   <tr>
     <td>Untere linke Zelle</td>
 
     <td>Untere mittlere Zelle</td>
 
     <td>Untere rechte Zelle</td>
   </tr>
 </table>]]></programlisting>
 	</example>
       </sect3>
     </sect2>
 
     <sect2>
       <title>Flu&szlig;elemente</title>
 
       <sect3>
 	<title>Hervorheben von Information</title>
 
         <para>Sollen sich bestimmte Informationen von anderen optisch
           abheben, kann dies mit den HTML-Tags
           <sgmltag>strong</sgmltag> und <sgmltag>em</sgmltag> erreicht
           werden. <sgmltag>strong</sgmltag> stellt dabei eine
           st&auml;rkere Hervorhebung  als <sgmltag>em</sgmltag> dar,
           wobei mit <sgmltag>strong</sgmltag> ausgezeichnete Elemente
           fett und mit <sgmltag>em</sgmltag> ausgezeichnete Elemente
           kursiv dargestellt werden. Allerdings ist diese Aussage
           nicht verl&auml;&szlig;lich, da die Darstellung vom Browser
           abh&auml;ngig ist.</para>
 
 	<example>
 	  <title>Text mit <sgmltag>em</sgmltag> und <sgmltag>strong</sgmltag>
             hervorheben</title>
 
 	  <programlisting><![ RCDATA [<p><em>Dieses</em> Wort ist hervorgehoben,
   w&auml;hrend <strong>dieses noch st&auml;rker hervorgehoben ist.</p>]]></programlisting>
         </example>
       </sect3>
 
       <sect3>
         <!--? Was ist typografisch richtig: schr&auml;g oder kursiv?
               Oliver Fischer -->
         <title>Fett- und Schr&auml;gschrift</title>
 
         <para>Da mittels HTML auch Festlegungen &uuml;ber die
           Darstellung getroffen werden k&ouml;nnen, gibt es die
           M&ouml;glichkeit direkt zu bestimmen, dass bestimmte
           Inhalte fett oder kursiv dargestellt werden sollen. Mit
           <sgmltag>b</sgmltag> eingefa&szlig;te Inhalte werden fett
           und mit <sgmltag>i</sgmltag> eingefa&szlig;te kursiv
           dargestellt.</para>
 
 	<example>
 	  <title>Text mit <sgmltag>b</sgmltag> und <sgmltag>i</sgmltag>
             formatieren</title>
 
 	  <programlisting><![ RCDATA [<p><b>Dieses</b> Wort wird fett dargestellt,
 w&auml;hrend <i>dieses</i> kursiv dargestellt wird.</p>]]></programlisting>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Nicht-proportionale Schrift f&uuml;r Texte</title>
 
         <para>Der Tag <sgmltag>tt</sgmltag> erlaubt es,
           Text in einer schreibmaschinen&auml;hnlichen
           Schrift darzustellen.</para>
 
 	<example>
 	  <title>Nicht-proportionale Schrift mit
             <sgmltag>tt</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<p>Dieses Dokument wurde urspr&uuml;nglich von
   Nik Clayton geschrieben. Nick Clayton kann unter der E-Mail-Adresse
   <tt>nik@FreeBSD.org</tt> erreicht werden.</p>]]></programlisting>
 
 	</example>
       </sect3>
 
       <sect3>
 	<title>&Auml;nderung der Schriftgr&ouml;&szlig;e</title>
 
         <para>HTML bietet auch M&ouml;glichkeiten, um Einflu&szlig;
           auf die Schriftgr&ouml;&szlig;e zu nehmen, das hei&szlig;t,
           zu bestimmen, ob die Schrift gr&ouml;&szlig;er oder kleiner
           als die Standardschrift dargestellt werden soll. Es gibt
           drei verschiedene Wege, dies zu erreichen:</para>
 
 	<orderedlist>
 	  <listitem>
             <para>Mittels der Tags <sgmltag>big</sgmltag> und
               <sgmltag>small</sgmltag> kann die
               Darstellungsgr&ouml;&szlig;e des eingeschlossenen Textes
               vergr&ouml;&szlig;ert respektive verkleinert werden.
               HTML erlaubt es zudem, diese Tags zu verschachteln, so
               dass auch <literal>&lt;big&gt;&lt;big&gt;Das ist
                 wesentlich
                 gr&ouml;&szlig;er.&lt;/big&gt;&lt;/big&gt;</literal>
               geschrieben werden kann.</para>
 	  </listitem>
 
 	  <listitem>
             <para>Das gleiche Ergebnis kann &uuml;ber die Zuweisung der
               Werte <literal>1</literal> und <literal>-1</literal> an
               das Attribut <sgmltag role="attribute">size</sgmltag>
               des Tags <sgmltag>font</sgmltag> erreicht werden. Diese
               Vorgehensweise sollte allerdings als veraltet betrachtet
               werden, da der Einsatz eines CSS hierf&uuml;r die bessere
               L&ouml;sung darstellt.</para>
 	  </listitem>
 
 	  <listitem>
             <para>&Uuml;ber die Zuweisung von absoluten Werten im Bereich
               von <literal>1</literal> bis <literal>7</literal> an das
               Attribut <literal>size</literal> des Tags
               <sgmltag>font</sgmltag> <footnote>
                 <para>Der Standardwert f&uuml;r <literal>size</literal> ist
                   <literal>3</literal>.</footnote>. Diese
               Herangehensweise ist ebenfalls veraltet und sollte nicht
               mehr angewandt werden.</para>
 	  </listitem>
 	</orderedlist>
 
 	<example>
 	  <title>Schriftgr&ouml;&szlig;e &auml;ndern mit
             <sgmltag>big</sgmltag>, <sgmltag>small</sgmltag> und
             <sgmltag>font</sgmltag></title>
 
 	  <para>Die folgenden HTML-Schnipsel bewirken alle das gleiche:</para>
 
 	  <programlisting><![ RCDATA [<p>Dieser Text ist <small>etwas kleiner</small>. Dieser
   jedoch <big>ein wenig gr&ouml;&szlig;er</big>.</p>
 
 <p>Dieser Text ist <font size="-1">etwas kleiner</font>. Dieser
   jedoch <font size="+1">ein wenig gr&ouml;&szlig;er</font>.</p>
 
 <p>Dieser Text ist <font size="2">etwas kleiner</font>. Dieser
   jedoch <font size="4">ein wenig gr&ouml;&szlig;er</font>.</p>]]></programlisting>
 	</example>
       </sect3>
     </sect2>
 
     <sect2 id="links">
       <title>Links</title>
 
       <note>
 	<para>Bei Links handelt es sich ebenfalls Flu&szlig;elemente.</para>
       </note>
 
       <sect3>
 	<title>Auf andere Dokumente im WWW verweisen</title>
 
 	<para>Um auf ein anderes Dokument im WWW zu verweisen,
 	  m&uuml;ssen Sie die URL dieses Dokuments kennen.</para>
 
         <para>Links auf andere Dokumente im WWW werden in HTML durch
           den Tag <sgmltag>a</sgmltag> und dessen Attribute <sgmltag
             role="attribute">href</sgmltag>, das die Zieladresse
           enth&auml;lt, angelegt. Der Inhalt des Elementes wird selbst
           zum Link und seine Darstellung erfolgt verschieden vom
           &uuml;brigen Text. Meist geschieht das durch eine andere
           Schriftfarbe oder dadurch, dass der Linktext
           unterstrichen wird.</para>
 
 	<example>
 	  <title><literal>&lt;a href="..."&gt;</literal> benutzen</title>
 
 	  <programlisting><![ RCDATA [<p>Weitere Informationen stehen auf der
   <a href="http://www.FreeBSD.org/">FreeBSD-Webseite</a> zur Verf&uuml;gung.</p>]]></programlisting>
 	</example>
 
         <para>Beim Aufruf dieses Links wird das referenzierte Dokument vom
           Browser geladen und mit dessen Seitenanfang dargestellt.</para>
       </sect3>
 
       <sect3>
 	<title>Auf bestimmte Dokumentenabschnitte verweisen</title>
 
         <para>HTML unterst&uuml;tzt neben einfachen Links auch solche, die
           auf einen bestimmten Abschnitt innerhalb eines Dokumentes
           verweisen. Dazu m&uuml;ssen die Abschnitte, auf die verwiesen
           werden soll, mit Hilfe von sogenannten <quote>Ankern</quote>
           markiert werden. Diese Anker k&ouml;nnen ebenfalls mit Hilfe des
           Tags <sgmltag>a</sgmltag> gesetzt werden, nur das anstelle
           von <sgmltag role="attribute">href</sgmltag> das Attribut
           <sgmltag role="attribute">name</sgmltag> gesetzt werden
           muss.</para>
 
 	<example>
 	  <title>Anwendung von <literal>&lt;a name="..."&gt;</literal></title>
 
 	  <programlisting><![ RCDATA [<p><a name="absatz1">Auf</a> diesen Absatz kann mit
   Hilfe seines Namens (<tt>absatz1</tt>) verwiesen werden.</p>]]></programlisting>
 	</example>
 
         <para>Um auf einen so gekennzeichneten Abschnitt zu verweisen,
           muss die URL des Dokumentes um das Zeichen
           <literal>#</literal> und den Namen des Zielankers erweitert
           werden.</para>
 
 	<example>
 	  <title>Auf einen  Abschnitt eines anderen Dokumentes
             verweisen</title>
 
           <para>F&uuml;r dieses Beispiel wird davon ausgegangen, dass der mit
             <literal>absatz1</literal> gekennzeichnete Absatz sich in
             der HTML-Datei <filename>foo.html</filename>
             befindet.</para>
 
 	  <programlisting><![ RCDATA [<p>Weitere Informationen k&ouml;nnen im
   <a href="foo.html#absatz1">ersten Absatz</a> der Datei
   <tt>foo.html</tt> gefunden werden.</p>]]></programlisting>
 	</example>
 
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-markup-docbook">
     <title>Die DocBook DTD</title>
 
     <para>DocBook wurde urspr&uuml;glich von HaL Computer Systems and
       O'Reilly &amp; Associates als DTD f&uuml;r das Erstellen von
       technischen Dokumenten entwickelt
 
       <footnote><para>Einen kurzen historischen Abriss finden Sie unter
         <ulink
         url="http://www.oasis-open.org/committees/docbook/intro.shtml"></ulink>.</para>
       </footnote>.
 
       Seit 1998 wird es vom <ulink
       url="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=docbook">
       DocBook Technical Committee</ulink> gewartet.  DocBook ist sehr
       stark auf die Beschreibung von Inhalten, und nicht auf die
       Darstellung des Inhalts ausgerichtet.  Damit steht es im Gegensatz
       zu LinuxDoc und HTML.</para>
 
     <note>
       <title>Formelle und informelle Elemente</title>
 
       <para>Einige Elemente der DocBook DTD sind in zwei Varianten
         vorhanden: <emphasis>formell</emphasis> und
         <emphasis>informell</emphasis>. &Uuml;blicherweise besitzt die
         formelle Variante einen Titel, dem der eigentliche
         Elementeninhalt folgt. Die informelle Variante hingegen hat
         keinen Titel.</para>
     </note>
 
-    <para>Die DocBook DTD ist in der Portssammlung im Port <filename
+    <para>Die DocBook DTD ist in der Ports-Sammlung im Port <filename
         role="package">textproc/docbook</filename> enthalten und wird
-      bei der Installation von <filename
+      bei der Installation des Metaports <filename
         role="package">textproc/docproj</filename> automatisch
       mitinstalliert.</para>
 
     <sect2>
       <title>Die FreeBSD-Erweiterungen</title>
 
       <para>F&uuml;r das FDP wurde die DocBook DTD durch das
         FreeBSD-Dokumentationsproject um zus&auml;tzliche Elemente
         erweitert, um damit pr&auml;zisiere
         Auszeichnungsm&ouml;glichkeiten zur Verf&uuml;gung zu haben.
         Sofern im folgenden FreeBSD-spezifische Elemente genutzt
         werden, wird explizit darauf hingewiesen werden.</para>
 
       <para>Wenn nachfolgend im Text der Begriff
         <quote>DocBook</quote> verwendet wird, ist damit die durch das
         FDP erweiterte Version der DocBook DTD gemeint.</para>
 
       <note>
         <para>Die durch das FDP vorgenommenen Erweiterungen sind nicht
           FreeBSD-spezifisch. Sie wurden lediglich vorgenommen, da sie
           f&uuml;r die Arbeit des FDPs als n&uuml;tzlich erschienen.
           F&uuml;r den Fall, das in den anderen *nix-Lagern (NetBSD,
           OpenBSD, Linux,&hellip;) Interesse daran besteht, gemeinsam
           eine Standarderweiterung f&uuml;r die DocBook DTD zu
           entwickeln, kann mit dem &a.doceng; Verbindung aufgenommen
           werden.</para>
       </note>
 
       <para>Zum jetzigen Zeitpunkt sind die FreeBSD-Erweiterungen
-        nicht Bestandteil der Portssammlung. Sie werden im
-        FreeBSD-CVS-Archiv (<ulink
+        nicht Bestandteil der Ports-Sammlung. Sie werden im
+        &os;-CVS-Archiv (<ulink
           url="http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/share/sgml/freebsd.dtd">doc/share/sgml/freebsd.dtd</ulink>)
         verwaltet.</para>
     </sect2>
 
     <sect2>
       <title>Formelle &Ouml;ffentliche Bezeichner</title>
 
       <para>In &Uuml;bereinstimmung mir der DocBook-Richtlinie zur
         Erstellung von Bezeichnern f&uuml;r DocBook-Erweiterungen lautet
         der Bezeichner der erweiterten FreeBSD-Variante:</para>
 
       <programlisting>PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN"</programlisting>
     </sect2>
 
     <sect2 id="docbookstructure">
       <title>Die Struktur von DocBook-Dokumenten</title>
 
       <para>DocBook erlaubt es, Dokumente auf verschiedene Weise zu
         strukturieren. Innerhalb des FDPs werden haupts&auml;chlich zwei
         Arten von DocBook-Dokumenten verwendet: Buch und Artikel.
         Beide unterscheiden sich darin, dass ein Buch auf der obersten
         Ebene durch <sgmltag>chapter</sgmltag>-Elemente strukturiert
         wird. Sollte das noch nicht ausreichend sein, k&ouml;nnen die
         einzelnen Kapitel eines Buches mit Hilfe des Elementes
         <sgmltag>part</sgmltag> in Teile aufgespalten werden. Das
-        Handbuch zum Beispiel ist auf diese Weise aufgebaut.</para>
+        Handbuch ist beispielsweise auf diese Weise aufgebaut.</para>
 
       <para>Kapitel (<sgmltag>chapter</sgmltag>) k&ouml;nnen weiterhin in
         Unterkapitel unterteilt werden. Diese werden durch die
         Elemente <sgmltag>sect1</sgmltag>  ausgezeichnet. Soll ein
         Unterkapitel selbst weitere Unterkapitel enthalten, kann das
         &uuml;ber das Element <sgmltag>sect2</sgmltag> geschehen. Diese
         Unterteilung kann bis zur Tiefe von f&uuml;nf Unterkapiteln &ndash;
         &uuml;ber die Elemente <sgmltag>sect3</sgmltag>,
         <sgmltag>sect4</sgmltag> und <sgmltag>sect5</sgmltag> &ndash;
         fortgef&uuml;hrt werden. Der eigentliche Inhalt, um den es ja in
         dem Artikel oder Buch geht, wird unterhalb der hier genannten
         Elemente eingef&uuml;gt.</para>
 
       <para>Vom Aufbau her ist ein Artikel ist einfacher strukturiert
         als ein Buch. So kann ein Artikel beispielsweise keine Kapitel
         (<sgmltag>chapter</sgmltag>) enthalten. Stattdessen kann der
         Inhalt eines Artikels nur durch die schon bekannten
         <sgmltag>sect<replaceable>N</replaceable></sgmltag>-Elemente
         in einen oder mehrere Abschnitte gegliedert werden.
 	&Uuml;berlegen Sie sich vor dem Schreiben eines Textes,
         ob der zu schreibende Text am
         besten als Buch oder als Artikel angelegt wird. Artikel eignen
         sich besser f&uuml;r Texte, die nicht in mehrere Kapitel
         aufgeteilt werden m&uuml;ssen und mit einem Umfang von
         ungef&auml;hr 20 bis 25&nbsp;Seiten vergleichsweise kurz sind.
         Nat&uuml;rlich ist das nur eine Richtlinie. B&uuml;cher sind
         dementsprechend am besten f&uuml;r lange Texte geeignet, die
         sich sinnvoll in Kapitel unterteilen lassen und
         m&ouml;glichweiser noch Anh&auml;nge und &auml;hnliches
         enthalten k&ouml;nnen.</para>
 
       <para>Alle <ulink url="&url.base;/de/docs.html">Tutorien von
           FreeBSD</ulink> sind als Artikel verfa&szlig;t, w&auml;hrend
         hingegen die <ulink
         url="&url.books.faq;/index.html">FreeBSD-FAQ</ulink> und das <ulink
         url="&url.books.handbook;/index.html">FreeBSD-Handbuch</ulink> als
         B&uuml;cher verfa&szlig;t wurden.</para>
 
       <sect3>
 	<title>B&uuml;cher schreiben</title>
 
         <para>Der Inhalt eines Buches wird in einem
           <sgmltag>book</sgmltag>-Element abgelegt.  Neben dem
 	  Textteil des Buches kann dieses Element weitergehende
 	  Informationen &uuml;ber das Buch selbst,
 	  wie Meta-Informationen zum Erstellen eines
 	  Stichwortverzeichnisses oder zus&auml;tzliche
 	  Inhalte zum Erstellen einer Titelei, enthalten.  Diese
 	  zus&auml;tzlichen Inhalte sollten in einem
           <sgmltag>bookinfo</sgmltag>-Element abgelegt werden.</para>
 
 	<example>
 	  <title>Buchvorlage <sgmltag>book</sgmltag> mit
             <sgmltag>bookinfo</sgmltag></title>
 
 	  <!-- Can't put this in a marked section because of the
                replaceable elements -->
 	  <programlisting>&lt;book>
   &lt;bookinfo>
     &lt;title><replaceable>Titel</replaceable>&lt;/title>
     &lt;author>
       &lt;firstname><replaceable>Vorname</replaceable>&lt;/firstname>
       &lt;surname><replaceable>Nachname</replaceable>&lt;/surname>
       &lt;affiliation>
         &lt;address>&lt;email><replaceable>E-Mail-Adresse</replaceable>&lt;/email>&lt;/address>
       &lt;/affiliation>
     &lt;/author>
 
     &lt;copyright>
       &lt;year><replaceable>1998</replaceable>&lt;/year>
       &lt;holder role="mailto:<replaceable>E-Mail-Adresse</replaceable>"><replaceable>Vollst&auml;ndiger Name</replaceable>&lt;/holder>
     &lt;/copyright>
 
     &lt;releaseinfo>&#36;FreeBSD&#36;&lt;/releaseinfo>
 
     &lt;abstract>
       &lt;para><replaceable>Kurze Zusammenfassung des Buchinhaltes.</replaceable>&lt;/para>
     &lt;/abstract>
   &lt;/bookinfo>
 
   &hellip;
 
 &lt;/book></programlisting>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Artikel schreiben</title>
 
         <para>Der Inhalt eines Artikels wird in einem
           <sgmltag>article</sgmltag>-Element abgelegt.  Neben
 	  dem Textteil kann dieses Element weitere Teile,
 	  wie Meta-Informationen zum Erstellen eines
 	  Stichwortverzeichnisses oder zus&auml;tzliche
 	  Inhalte zum Erstellen einer Titelei, enthalten.
           Analog zu einem Buch, sollten diese Informationen in einem
           <sgmltag>articleinfo</sgmltag>-Element abgelegt
           werden.</para>
 
 	<example>
 	  <title>Artikelvorlage <sgmltag>article</sgmltag> mit
             <sgmltag>articleinfo</sgmltag></title>
 
 	  <!-- Can't put this in a marked section because of the
                replaceable elements -->
 	  <programlisting>&lt;article>
   &lt;articleinfo>
     &lt;title><replaceable>Titel</replaceable>&lt;/title>
 
     &lt;author>
       &lt;firstname><replaceable>Vorname</replaceable>&lt;/firstname>
       &lt;surname><replaceable>Nachname</replaceable>&lt;/surname>
       &lt;affiliation>
         &lt;address>&lt;email><replaceable>E-Mail-Adresse</replaceable>&lt;/email>&lt;/address>
       &lt;/affiliation>
     &lt;/author>
 
     &lt;copyright>
       &lt;year><replaceable>1998</replaceable>&lt;/year>
       &lt;holder role="mailto:<replaceable>E-Mail-Adresse</replaceable>"><replaceable>Vollst&auml;ndiger Name</replaceable>&lt;/holder>
     &lt;/copyright>
 
     &lt;releaseinfo>&#36;FreeBSD&#36;&lt;/releaseinfo>
 
     &lt;abstract>
       &lt;para><replaceable>Kurze Zusammenfassung des Artikelinhalts.</replaceable>&lt;/para>
     &lt;/abstract>
   &lt;/articleinfo>
 
   &hellip;
 
 &lt;/article></programlisting>
 	</example>
       </sect3>
 
       <sect3>
         <title>Kapitel</title>
 
         <para>Kapitel werden mit dem
           <sgmltag>chapter</sgmltag>-Element angelegt und m&uuml;ssen ein
           <sgmltag>title</sgmltag>-Element enthalten. Verwendet werden
           k&ouml;nnen sie nur in B&uuml;chern.</para>
 
 	<example>
 	  <title>Ein einfaches Kapitel</title>
 
 	  <programlisting><![ RCDATA [<chapter>
   <title>Kapitel&uuml;berschrift</title>
 
   &hellip;
 </chapter>]]></programlisting>
 	</example>
 
         <para>Kapitel k&ouml;nnen nicht leer sein. Nebem einem
           <sgmltag>title</sgmltag>-Element m&uuml;ssen sie weiteren Inhalt
           beinhalten. Falls ein leeres Kapitel ben&ouml;tig wird, kann dies
           durch das Einf&uuml;gen eines leeren Absatzes
           (<sgmltag>para</sgmltag>) erreicht werden.</para>
 
 	<example>
 	  <title>Ein leeres Kapitel</title>
 
 	  <programlisting><![ CDATA [<chapter>
   <title>Das ist ein leeres Kapitel</title>
 
   <para></para>
 </chapter>]]></programlisting>
 	</example>
       </sect3>
 
       <sect3 id="unterkapitel">
 	<title>Unterkapitel</title>
 
         <!-- Bei der Uebersetzung dieser Stelle bin ich
              bewusst vom Original abgewichen, da ich die
              Begriffe Kapitel und Kapitel anstatt
              Kapitel und Abschnitt benutze. Eine
              originalgetreue Uebersetzung wuerde somit an dieser
              Stelle nur zu Verwirrung fuehren.
              Oliver Fischer, 14.04.2004 -->
 
         <para>B&uuml;cher werden auf der obersten Gliederungsebene
           durch <sgmltag>chapter</sgmltag>-Elemente in Kapitel
           unterteilt. Eine weitergehende Untergliederung kann durch
           das Anlegen von Unterkapiteln erreicht werden. Im Gegensatz
           zu Kapiteln, die durch <sgmltag>chapter</sgmltag>-Elemente
           ausgezeichnet werden, erfolgt die Auszeichnung von
           Unterkapitel mit dem Element
           <sgmltag>sect<replaceable>n</replaceable></sgmltag>. Das
           <replaceable>n</replaceable> in Elementnamen trifft eine
           Aussage &uuml;ber die Gliederungstiefe, auf der sich das
           Unterkapitel befindet. Ein  <sgmltag>sect1</sgmltag>-Element
           kann mehrere Elemente vom Typ <sgmltag>sect2</sgmltag>
           enthalten, die die Unterkapitel der
           n&auml;chsten Gliederungsebene darstellen.
           <sgmltag>sect5</sgmltag> ist das letzte Element, das auf
           diese Art zur Gliederung eingesetzt werden kann.</para>
 
 	<example>
 	  <title>Unterkapitel</title>
 
 	  <programlisting><![ RCDATA [<chapter>
   <title>Ein Beispielkapitel</title>
 
   <para>Ein beliebiger Text.</para>
 
   <sect1>
     <title>Erster Abschnitt (1.1)</title>
 
     &hellip;
   </sect1>
 
   <sect1>
     <title>Zweiter Abschnitt (1.2)</title>
 
     <sect2>
       <title>Erster Unterabschnitt (1.2.1)</title>
 
       <sect3>
         <title>Erster Unterunterabschnitt (1.2.1.1)</title>
 
          &hellip;
       </sect3>
     </sect2>
 
     <sect2>
       <title>Zweiter Unterabschnitt (1.2.2)</title>
 
       &hellip;
     </sect2>
   </sect1>
 </chapter>]]></programlisting>
 	</example>
 
 	<note>
           <para>Die Unterkapitel dieses Beispiels wurden zu
             Demonstrationszwecken manuell durchnummeriert. In
             <quote>normalen</quote> Dokumenten wird diese Aufgabe von
             den Stylesheets &uuml;bernommen.</para>
 	</note>
       </sect3>
 
       <sect3>
 	<title>B&uuml;cher mittels <sgmltag>part</sgmltag>
           unterteilen</title>
 
         <para>In den F&auml;llen, in denen die Unteilung eines Buches in
           Kapitel nicht ausreichend ist, k&ouml;nnen mehrere
 	  Kapitel mit dem Element <sgmltag>part</sgmltag> zu
 	  einem Teil zusammengefasst werden.</para>
 
 	<programlisting><![ RCDATA [<part>
   <title>Einf&uuml;hrung</title>
 
   <chapter>
     <title>&Uuml;berblick</title>
 
      &hellip;
   </chapter>
 
   <chapter>
     <title>Was ist FreeBSD?</title>
 
     &hellip;
   </chapter>
 
   <chapter>
     <title>Die Geschichte von FreeBSD</title>
 
     &hellip;
   </chapter>
 </part>]]></programlisting>
       </sect3>
     </sect2>
 
     <sect2>
       <title>Blockelemente</title>
 
       <sect3>
 	<title>Abs&auml;tze</title>
 
 	<para>DocBook kennt drei Arten von Abs&auml;tzen: Abs&auml;tze
           mit &Uuml;berschrift (<sgmltag>formalpara</sgmltag>),
           normale Abs&auml;tze (<sgmltag>para</sgmltag>) und einfache
           Abs&auml;tze (<sgmltag>simpara</sgmltag>).</para>
 
         <para>Normale Abs&auml;tze und einfache Abs&auml;tze
           unterscheiden sich dadurch, dass innerhalb von
           <sgmltag>para</sgmltag> Blockelemente erlaubt sind,
           innerhalb von <sgmltag>simpara</sgmltag> hingegen nicht. Es
           ist empfehlenswert, <sgmltag>para</sgmltag> den Vorzug
           zu geben.</para>
 
 	<example>
 	  <title>Absatz mit <sgmltag>para</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<para>Das ist ein Absatz. Abs&auml;tze k&ouml;nnen fast jedes andere
   Element aufnehmen.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
 	 <para>Das ist ein Absatz. Abs&auml;tze k&ouml;nnen fast jedes andere
             Element aufnehmen.</para>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Blockzitate</title>
 
         <para>Blockzitate sind textlich umfangreichere Zitate aus
           einem anderen Text, die nicht innerhalb des aktuellen
           Absatzes angezeigt werden sollen. Wahlweise k&ouml;nnen
           Blockzitate eine &Uuml;berschrift haben und die Zitatquelle
           nennen.</para>
 
 	<example>
 	  <title><sgmltag>blockquote</sgmltag></title>
 
 	  <programlisting><![ CDATA [<para>Ein Auszug aus dem Grundgesetz:</para>
 
 <blockquote>
   <title>Menschenw&uuml;rde; Grundrechtsbindung der staatlichen Gewalt</title>
 
   <attribution>Aus dem Grundgesetz</attribution>
 
   <orderedlist>
     <listitem>
       <para>Die W&uuml;rde des Menschen ist unantastbar. Sie zu achten
         und zu sch&uuml;tzen ist Verpflichtung aller staatlichen
         Gewalten.</para>
     </listitem>
     <listitem>
       <para>Das Deutsche Volk bekennt sich darum zu unverletzlichen
         und unver&auml;u&szlig;erlichen Menschenrechten als Grundlage jeder
         menschlichen Gemeinschaft, des Friedens und der
         Gerechtigkeit in der Welt.</para>
     </listitem>
     <listitem>
       <para>Die nachfolgenden Grundrechte binden Gesetzgebung,
         vollziehende Gewalt und Rechtsprechung als
         unmittelbar geltendes Recht.</para>
     </listitem>
   </orderedlist>
 </blockquote>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <blockquote>
             <title>Menschenw&uuml;rde; Grundrechtsbindung der
               staatlichen Gewalt</title>
 
             <attribution>Aus dem Grundgesetz</attribution>
 
             <orderedlist>
               <listitem>
                 <para>Die W&uuml;rde des Menschen ist unantastbar. Sie
                   zu achten und zu sch&uuml;tzen ist Verpflichtung
                   aller staatlichen Gewalten.</para>
               </listitem>
               <listitem>
                 <para>Das Deutsche Volk bekennt sich darum zu
                   unverletzlichen und unver&auml;u&szlig;erlichen
                   Menschenrechten als Grundlage jeder menschlichen
                   Gemeinschaft, des Friedens und der Gerechtigkeit in
                   der Welt.</para>
               </listitem>
               <listitem>
                 <para>Die nachfolgenden Grundrechte binden
                   Gesetzgebung, vollziehende Gewalt und Rechtsprechung
                   als unmittelbar geltendes Recht.</para>
               </listitem>
             </orderedlist>
           </blockquote>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Tipps, Anmerkungen, Warnungen, wichtige Informationen
           und Randbemerkungen</title>
 
         <para>In bestimmten F&auml;llen kann es n&uuml;tzlich sein,
           dem Leser zus&auml;tzliche Informationen zu geben, die sich
           vom Haupttext abheben, damit der Leser sie besser wahrnimmt.
           Abh&auml;ngig von der Art der Information, k&ouml;nnen
           solche Stellen mit einem der Elemente <sgmltag>tip</sgmltag>
           (f&uuml;r Tipps), <sgmltag>note</sgmltag> (f&uuml;r
           Anmerkungen), <sgmltag>warning</sgmltag> (f&uuml;r
           Warnungen), <sgmltag>caution</sgmltag> (f&uuml;r besonders
           ernstzunehmende Warnungen) und <sgmltag>important</sgmltag>
           (f&uuml;r wichtige Anmerkungen) ausgezeichnet werden. Trifft
           keines dieser Element f&uuml;r die auszuzeichnende Stelle
           zu, sollte diese mit dem Element <sgmltag>sidebar</sgmltag>
           ausgezeichnet werden.</para>
 
         <para>Da die richtige Einordnung einer auszuzeichnenden
           Textstelle nicht immer leicht zu treffen ist, werden in der
           DocBook-Dokumentation folgende Empfehlungen gegeben:</para>
 
 	<itemizedlist>
 	  <listitem>
             <para>Eine Anmerkung (<sgmltag>note</sgmltag>) ist eine
               Information, die von jedem Leser beachtet werden
               sollte.</para>
 	  </listitem>
 
 	  <listitem>
             <para>Eine wichtige Anmerkung
               (<sgmltag>important</sgmltag>) eine Variation einer
               Anmerkung.</para>
 	  </listitem>
 
 	  <listitem>
             <para>Eine Warnung (<sgmltag>warning</sgmltag>)
               betrifft einen m&ouml;glichen Hardwareschaden
               oder weist auf eine Gefahr f&uuml;r Leib und Leben
               hin.</para>
           </listitem>
 
 	  <listitem>
 	    <para>Eine besonders ernstzunehmende Warnung
               (<sgmltag>caution</sgmltag>) betrifft einen m&ouml;glichen
               Datenverlust oder Softwareschaden.</para>
 	  </listitem>
         </itemizedlist>
 
 	<example>
 	  <title><sgmltag>warning</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<warning>
   <para>Wenn Sie FreeBSD auf Ihrer Festplatte installieren,
     kann es sein, da&amp;szlig; Sie Windows nie mehr benutzen wollen.</para>
 </warning>]]></programlisting>
         </example>
 
-	 <!-- Need to do this outside of the example -->
+	<para>Eine Warnung wird wie folgt dargestellt:</para>
+
 	<warning>
           <para>Wenn Sie FreeBSD auf Ihrer Festplatte installieren,
             kann es sein, dass Sie Windows nie mehr benutzen wollen.</para>
 	</warning>
       </sect3>
 
       <sect3>
 	<title>Listen und Handlungsanweisungen</title>
 
         <para>Listen sind ein oft gebrauchtes Hilfsmittel, wenn es
           darum geht, Informationen f&uuml;r den Benutzer
           &uuml;bersichtlich darzustellen oder eine Abfolge von
           Arbeitsschritten zu beschreiben, die notwendig sind, um ein
           bestimmtes Ziel zu erreichen. Zur Auszeichnung von Listen
           stellt DocBook die Elemente <sgmltag>itemizedlist</sgmltag>,
           <sgmltag>orderedlist</sgmltag> und
           <sgmltag>procedure</sgmltag> zur Verf&uuml;gung.<footnote>
             <para>DocBook kennt noch andere Elemente f&uuml;r die
               Auszeichnung von Listen, die an dieser Stelle jedoch
               nicht behandelt werden.</para>
           </footnote>.</para>
 
         <para><sgmltag>itemizedlist</sgmltag> und
           <sgmltag>orderedlist</sgmltag> &auml;hneln sehr stark ihren
           HTML-Gegenst&uuml;cken <sgmltag>ul</sgmltag> und
           <sgmltag>ol</sgmltag>. Beide Listenarten m&uuml;ssen
           mindestens ein Element <sgmltag>listitem</sgmltag>
           enthalten.  Das <sgmltag>listitem</sgmltag> Element
           muss mindestens ein weiteres Blockelement
           enthalten.</para>
 
         <para><sgmltag>procedure</sgmltag> unterscheidet sich ein
           wenig von den vorhergehenden. Es enth&auml;lt
           <sgmltag>step</sgmltag>-Elemente, die wiederum
           <sgmltag>step</sgmltag>- oder
           <sgmltag>substel</sgmltag>-Elemente enthalten k&ouml;nnen.
           Ein <sgmltag>step</sgmltag>-Element kann nur Blockelemente
           aufnehmen.</para>
 
 	<example>
 	  <title><sgmltag>itemizedlist</sgmltag>,
             <sgmltag>orderedlist</sgmltag> und
             <sgmltag>procedure</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<itemizedlist>
   <listitem>
     <para>Das ist das erste Listenelement.</para>
   </listitem>
 
   <listitem>
     <para>Das ist das zweite Listenelement.</para>
   </listitem>
 </itemizedlist>
 
 <orderedlist>
   <listitem>
     <para>Das ist das erste Aufz&auml;hlungselement.</para>
   </listitem>
 
   <listitem>
     <para>Das ist das zweite Aufz&auml;hlungselement.</para>
   </listitem>
 </orderedlist>
 
 <procedure>
   <step>
     <para>Machen Sie zuerst dies.</para>
   </step>
 
   <step>
     <para>Und dann machen Sie das..</para>
   </step>
 
   <step>
     <para>Und jetzt noch das&hellip;</para>
   </step>
 </procedure>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <itemizedlist>
             <listitem>
               <para>Das ist das erste Listenelement.</para>
             </listitem>
 
             <listitem>
               <para>Das ist das zweite Listenelement.</para>
             </listitem>
           </itemizedlist>
 
           <orderedlist>
             <listitem>
               <para>Das ist das erste Aufz&auml;hlungselement.</para>
             </listitem>
 
             <listitem>
               <para>Das ist das zweite Aufz&auml;hlungselement.</para>
             </listitem>
           </orderedlist>
         </example>
 
         <procedure>
           <step>
             <para>Machen Sie zuerst dies.</para>
           </step>
 
           <step>
             <para>Und dann machen Sie das..</para>
           </step>
 
           <step>
             <para>Und jetzt noch das&hellip;</para>
           </step>
         </procedure>
       </sect3>
 
       <sect3>
 	<title>Dateiinhalte auszeichnen</title>
 
         <para>Technische Dokumente enthalten oft auch
           Konfigurationsbeispiele oder Quellcodeschnipsel. Zur
           Auszeichnung dieser Inhalte, stellt Docbook das Element
           <sgmltag>programmlisting</sgmltag> zur Verf&uuml;gung. Im
           Gegensatz zu anderen DocBook-Elementen wird der
           Elementinhalt von <sgmltag>programmlisting</sgmltag>
           <emphasis>nicht</emphasis>  normalisiert, das hei&szlig;t,
           dass alle Leerzeichen, Tabulatoren und
           Zeilenumbr&uuml;che unver&auml;ndert &uuml;bernommen werden.
           Aus diesem Grund ist es unter anderem wichtig, dass
           sich der &ouml;ffende Tag in der selben Zeile wie der Anfang
           des darzustellenden Textes befindet. Gleiches gilt f&uuml;r
           den schlie&szlig;enden Tag: Er muss sich am Ende der
           letzten Zeile befinden. Wird das nicht beachtet, kann es
           sein, dass unerwartete Leerzeichen und Leerzeilen in
           der Ausgabe auftauchen.</para>
 
 	<example>
 	  <title><sgmltag>programlisting</sgmltag></title>
 
 	  <programlisting><![ RCDATA[<para>Am Ende sollte Ihr Programm wie folgt
   aussehen:</para>
 
 <programlisting>#include &amp;lt;stdio.h&amp;gt;
 
 int
 main(void)
 {
     printf("Hallo Welt!\n");
 }</programlisting>]]></programlisting>
 
           <para>Die spitzen Klammern der
             <literal>#include</literal>-Anweisung k&ouml;nnen nicht direkt
             verwendet werden, sondern m&uuml;ssen &uuml;ber ihre Entit&auml;ten
             eingebunden werden.</para>
 
 	  <para>Darstellung:</para>
 
 	  <para>Am Ende sollte Ihr Programm wie folgt aussehen:</para>
 
 	  <programlisting>#include &lt;stdio.h&gt;
 
 int
 main(void)
 {
     printf("Hallo Welt!\n");
 }</programlisting>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Textanmerkungen</title>
 
         <para>Textanmerkungen<footnote><para>
               auf Englisch:
               <foreignphrase>callout</foreignphrase></para></footnote>
           sind ein Mechanismus, um auf bestimmte Stellen in einem
           vorhergehenden Beispiel oder Text zu verweisen.</para>
 
         <para>Um solche Verweise anzulegen, m&uuml;ssen die betreffenden
           Stellen in den Beispielen
           (<sgmltag>programlisting</sgmltag>,
           <sgmltag>literallayout</sgmltag>, &hellip;) mit
           <sgmltag>co</sgmltag>-Elementen markiert werden, wobei jedes
           Element ein eindeutiges <literal>id</literal>-Attribut
           besitzen muss. Anschlie&szlig;end sollte ein
           <sgmltag>calloutlist</sgmltag>-Element eingef&uuml;gt werden,
           dessen Elemente sich auf die <sgmltag>co</sgmltag>-Elemente
           des Beispiels beziehen und die jeweiligen Anmerkungen
           enthalten.</para>
 
 	<example>
 	  <title>Das <sgmltag>co</sgmltag>- und das
             <sgmltag>calloutlist</sgmltag>-Element</title>
 
 	  <programlisting><![ RCDATA[<para>Am Ende sollte Ihr Programm wie folgt
   aussehen:</para>
 
 <programlisting>#include &amp;lt;stdio.h&amp;gt; <co id="co-ex-include">
 
 int <co id="co-ex-return">
 main(void)
 {
     printf("Hallo Welt\n"); <co id="co-ex-printf">
 }</programlisting>
 
 <calloutlist>
   <callout arearefs="co-ex-include">
     <para>Bindet die Headerdatei <filename>stdio.h</filename> ein.</para>
   </callout>
 
   <callout arearefs="co-ex-return">
     <para>Bestimmt den Typ des R&uuml;ckgabewertes von <function>main()</function>.</para>
   </callout>
 
   <callout arearefs="co-ex-printf">
     <para>Ruft die Funktion <function>printf()</function> auf, die
       <literal>Hallo Welt!</literal> auf der Standardausgabe ausgibt</para>
   </callout>
 </calloutlist>]]></programlisting>
 
             <para>Darstellung:</para>
 
           <para>Am Ende sollte Ihr Programm wie folgt aussehen:</para>
 
           <programlisting>#include &amp;lt;stdio.h&amp;gt; <co id="co-ex-include">
 
 int <co id="co-ex-return">
 main(void)
 {
     printf("Hallo Welt\n"); <co id="co-ex-printf">
 }</programlisting>
 
           <calloutlist>
             <callout arearefs="co-ex-include">
               <para>Bindet die Headerdatei <filename>stdio.h</filename> ein.</para>
             </callout>
 
             <callout arearefs="co-ex-return">
               <para>Bestimmt den Typ des R&uuml;ckgabewertes von <function>main()</function>.</para>
             </callout>
 
             <callout arearefs="co-ex-printf">
               <para>Ruft die Funktion <function>printf()</function> auf, die
                 <literal>Hallo Welt!</literal> auf der Standardausgabe ausgibt</para>
             </callout>
           </calloutlist>
         </example>
       </sect3>
 
       <sect3>
 	<title>Tabellen</title>
 
         <para>Im Gegensatz zu HTML ist es nicht notwendig, Tabellen zu
           Layoutzwecken einzusetzen, da die Layoutaufgabe von den
           Stylesheets &uuml;bernommen wird. Stattdessen sollten Tabellen
           nur f&uuml;r die Auszeichnung von Daten in Tabellenform genutzt
           werden.</para>
 
         <para>Vereinfacht betrachtet (f&uuml;r Details sollte die
           DocBook-Dokumentation zu Rate gezogen werden) besteht eine
           Tabelle, die entweder als formelle oder als informelle
           Tabelle angelegt werden kann, aus einem
           <sgmltag>table</sgmltag>-Element. Dieses Element selbst
           beinhaltet mindestens ein Element <sgmltag>tgroup</sgmltag>,
           das &uuml;ber ein Attribut die Spaltenanzahl der Tabelle
           bestimmt. Innerhalb des Elementes <sgmltag>tgroup</sgmltag>
           kann sich ein Element <sgmltag>thead</sgmltag> mit den
           Spalten&uuml;berschriften  und ein Element
           <sgmltag>tbody</sgmltag> mit dem eigentlichen Tabelleninhalt
           befinden. Beide Elemente beinhalten
           <sgmltag>row</sgmltag>-Elemente, die wiederum
           <sgmltag>entry</sgmltag>-Elemente beinhalten. Jedes
           <sgmltag>entry</sgmltag>-Element stellt eine einzelne
           Tabellenzelle dar.</para>
 
 	<example>
 	  <title>Tabellen mittels <sgmltag>informaltable</sgmltag>
             auszeichnen</title>
 
-	  <programlisting><![ RCDATA [<informaltable frame="none" pgwide="1">
+	  <programlisting><![ RCDATA [<informaltable pgwide="1">
   <tgroup cols="2">
     <thead>
       <row>
         <entry>Spalten&uuml;berschrift 1</entry>
         <entry>Spalten&uuml;berschrift 2</entry>
       </row>
     </thead>
 
     <tbody>
       <row>
         <entry>Zeile 1, Spalte 1</entry>
         <entry>Zeile 1, Spalte 2</entry>
       </row>
 
       <row>
         <entry>Zeile 2, Spalte 1</entry>
         <entry>Zeile 2, Spalte 2</entry>
       </row>
     </tbody>
   </tgroup>
 </informaltable>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
-	  <informaltable frame="none" pgwide="1">
+	  <informaltable pgwide="1">
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>Spalten&uuml;berschrift 1</entry>
 		  <entry>Spalten&uuml;berschrift 2</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry>Zeile 1, Spalte 1</entry>
 		  <entry>Zeile 1, Spalte 2</entry>
 		</row>
 
 		<row>
 		  <entry>Zeile 2, Spalte 1</entry>
 		  <entry>Zeile 2, Spalte 2</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </informaltable>
 	</example>
 
         <para>Verwenden Sie stets das Attribut <literal>pgwide</literal>
 	  mit dem Wert <literal>1</literal>, wenn Sie das Element
 	  <sgmltag>informaltable</sgmltag> benutzen.  Ein Bug des
 	  Internet Explorers verhindert ansonsten die korrekte
 	  Darstellung dieser Tabellen.</para>
 
 	<para>Soll die Tabelle keinen Rand haben, kann das Attribut
           <literal>frame</literal> mit dem Wert
           <literal>none</literal> dem Element
           <sgmltag>informaltable</sgmltag> hinzugef&uuml;gt werden
 	  (<literal>&lt;informaltable frame="none"&gt;</literal>)).</para>
 
 	<example>
 	  <title>Tabelle mit Attribut
             <literal>frame="none"</literal></title>
 
 	  <para>Darstellung:</para>
 
 	  <informaltable frame="none" pgwide="1">
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>Spalten&uuml;berschrift 1</entry>
 		  <entry>Spalten&uuml;berschrift 2</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry>Zeile 1,  Spalte 1</entry>
 		  <entry>Zeile 1,  Spalte 2</entry>
 		</row>
 
 		<row>
 		  <entry>Zeile 2, Spalte 1</entry>
 		  <entry>Zeile 2, Spalte 2</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </informaltable>
 	</example>
       </sect3>
 
       <sect3>
         <title>Beispiele f&uuml;r den Leser</title>
 
         <para>Oft gilt es, f&uuml;r dem Benutzer Beispiele
           zu geben, die er dann selber nachvollziehen soll. Meist
           handelt es sich dabei um interaktive Dialoge zwischen Mensch
           und Maschine: Der Benutzer gibt einen Befehl ein und
           erh&auml;lt eine Antwort vom System. Ein Satz
           von speziellen Elementen und Entit&auml;ten unterst&uuml;tzt
           den Autor bei der Auszeichnung solcher Textstellen:</para>
 
 	<variablelist>
 	  <varlistentry>
 	    <term><sgmltag>screen</sgmltag></term>
 
 	    <listitem>
               <para>Gedacht zur Auszeichnung von Bildschirminhalten.
                 Im Unterschied zu anderen Elementen werden Leerzeichen
                 innerhalb des Elementes <sgmltag>screen</sgmltag>
                 unver&auml;ndert &uuml;bernommen.</para>
 	    </listitem>
 	  </varlistentry>
 
 	  <varlistentry>
 	    <term><sgmltag>prompt</sgmltag>,
               <literal>&amp;prompt.root;</literal> und
               <literal>&amp;prompt.user;</literal></term>
 
 	    <listitem>
               <para>Eingabeaufforderungen des Rechners
                 (Betriebssysten, Shell oder Anwendung) sind ein h&auml;ufig
                 auftretender Teil dessen, was der Benutzer auf dem
                 Bildschirm zu sehen bekommt. Sie sollten mit
                 <sgmltag>prompt</sgmltag> ausgezeichnet werden.</para>
 
               <para>Ein Spezialfall sind die beiden
                 Eingabeaufforderungen der Shell f&uuml;r normale
                 Benutzer und den Superuser <username>root</username>.
                 Jedesmal wenn auf eine von diesen beiden Nutzerrollen
                 hingewiesen werden soll, sollte entweder
                 <literal>&amp;prompt.root;</literal> oder
                 <literal>&amp;prompt.user;</literal> eingesetzt
                 werden. Beide Entit&auml;ten k&ouml;nnen auch
                 au&szlig;erhalb von <sgmltag>screen</sgmltag>
                 verwendet werden.</para>
 
 	      <note>
                 <para><literal>&amp;prompt.root;</literal> und
                   <literal>&amp;prompt.user;</literal> sind
                   FreeBSD-spezifische Erweiterungen der DocBook DTD
                   und nicht in der originalen DocBook DTD
                   enthalten.</para>
 	      </note>
 	    </listitem>
 	  </varlistentry>
 
 	  <varlistentry>
 	    <term><sgmltag>userinput</sgmltag></term>
 
 	    <listitem>
               <para>Das Element <sgmltag>userinput</sgmltag> ist
                 f&uuml;r die Auszeichnung von Benutzereingaben
                 gedacht.</para>
 	    </listitem>
 	  </varlistentry>
 	</variablelist>
 
 	<example>
 	  <title><sgmltag>screen</sgmltag>, <sgmltag>prompt</sgmltag>
             und <sgmltag>userinput</sgmltag></title>
 
 	  <programlisting><![ CDATA [<screen>&prompt.user; <userinput>ls -1</userinput>
 foo1
 foo2
 foo3
 &prompt.user; <userinput>ls -1 | grep foo2</userinput>
 foo2
 &prompt.user; <userinput>su</userinput>
 <prompt>Password: </prompt>
 &prompt.root; <userinput>cat foo2</userinput>
 This is the file called 'foo2'</screen>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <screen>&prompt.user; <userinput>ls -1</userinput>
 foo1
 foo2
 foo3
 &prompt.user; <userinput>ls -1 | grep foo2</userinput>
 foo2
 &prompt.user; <userinput>su</userinput>
 <prompt>Password: </prompt>
 &prompt.root; <userinput>cat foo2</userinput>
 This is the file called 'foo2'</screen>
 	</example>
 
 	<note>
           <para>Obgleich der Inhalt der Datei
             <filename>foo2</filename> in dem obigen Beispiel angezeigt
             wird, sollte dieser nicht mit
             <sgmltag>programlisting</sgmltag> ausgezeichnet werden.
             Vielmehr sollte <sgmltag>programlisting</sgmltag> einzig
             und allein f&uuml;r die Darstellung von Dateifragmenten
             au&szlig;erhalb von Benutzeraktionen gew&auml;hlt
             werden.</para>
 	</note>
       </sect3>
     </sect2>
 
     <sect2>
       <title>Flu&szlig;elemente</title>
 
       <sect3>
 	<title>Hervorhebungen</title>
 
         <para>Wenn es darum geht bestimmte W&ouml;rter oder Textstellen
           hervorzuheben, sollte daf&uuml;r das Element
           <sgmltag>emphasis</sgmltag> verwendet werden. Das so
           ausgezeichnete Text wird dann kursiv oder fett dargestellt;
           im Falle einer Sprachausgabe w&uuml;rde es anders betont
           werden.</para>
 
         <para>Im Gegensatz zu den HTML mit seinen Elementen
           <sgmltag>b</sgmltag> und <sgmltag>i</sgmltag>, kennt DocBook
           keinen Weg, um diese Darstellung zu
           &auml;ndern<footnote><para>Anmerkung des
               &Uuml;bersetzers: Hier sollte man sich noch einmal ins
               Ged&auml;chtnis rufen, dass mittels der DocBook DTD nur
               Inhalte ausgezeichnet werden und nicht das Layout
               bestimmt wird.</para></footnote>. Handelt es sich bei
           dem darzustellenden um eine wichtige Information, kann
           alternativ <sgmltag>important</sgmltag> verwendet
           werden.</para>
 
 	<example>
 	  <title>Das Element <sgmltag>emphasis</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<para>FreeBSD ist zweifelslos <emphasis>das</emphasis> f&uuml;hrende
   Unix-artige Bestriebssystem f&uuml;r die Intel-Plattform.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>FreeBSD ist zweifelslos <emphasis>das</emphasis> f&uuml;hrende
             Unix-artige Bestriebssystem f&uuml;r die Intel-Plattform.</para>
 
 	</example>
       </sect3>
 
       <sect3>
 	<title>Zitate</title>
 
         <para>Um einen Auszug aus einer anderen Quelle zu zitieren
           oder kenntlich zu machen, dass eine bestimmte Wendung
           im &uuml;bertragenen Sinne zu verstehen ist, kann der
           betreffende Text mit Hilfe des Elementes
           <sgmltag>quote</sgmltag> ausgezeichnet werden. Innerhalb von
           <sgmltag>quote</sgmltag> k&ouml;nnen die meisten der
           normalerweise zur Verf&uuml;gung stehenden Elemente genutzt
           werden.</para>
 
 	<example>
 	  <title>Richtig zitieren</title>
 
 	  <programlisting><![ RCDATA [<para>Es sollte immer sichergestellt werden, dass die Suche die Grenzen
   zwischen <quote>lokaler und &ouml;ffentlicher Administration</quote>
   (RFC 1535) einh&auml;lt.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>Es sollte immer sichergestellt werden, das die Suche
             die Grenzen zwischen <quote>lokaler und &ouml;ffentlicher
               Administration</quote> (RFC 1535) einh&auml;lt.</para>
 
 	</example>
       </sect3>
 
       <sect3>
 	<title>Tasten, Maustasten und Tastenkombinationen</title>
 
 	<para>Das Element <sgmltag>keycap</sgmltag> beschreibt
 	  eine bestimmte Taste der Tastatur.
           F&uuml;r die Auszeichnung von Maustasten
           steht analog das Element <sgmltag>mousebutton</sgmltag> zur
           Verf&uuml;gung. Mit Hilfe von <sgmltag>keycombo</sgmltag>
           k&ouml;nnen beliebige Tasten- und Maustastenkombinationen
           beschrieben werden.</para>
 
         <para>Das Element <sgmltag>keycombo</sgmltag> besitzt ein
           Attribut <literal>action</literal>, dem einer der Werte
           <literal>click</literal>, <literal>double-click</literal>,
           <literal>other</literal>, <literal>press</literal>,
           <literal>seq</literal> oder <literal>simul</literal>
           zugewiesen werden kann. Die letzten beiden Werte deuten an,
           dass die genannte Kombination nacheinander oder
           gleichzeitig gedr&uuml;ckt werden soll. Die Stylesheets
           f&uuml;gen zwischen die einzelnen Unterelemente von
           <sgmltag>keycombo</sgmltag> <quote>+</quote>-Zeichen
           ein.</para>
 
 
 	<example>
 	  <title>Tasten, Maustasten und Tastenkombinationen</title>
 
           <para>Diese Eingaben zeichnen Sie wie folgt aus:</para>
 
 	  <programlisting><![ RCDATA [<para>Mit der Tastenkombination <keycombo action="simul"><keycap>Alt</keycap>
   <keycap>F1</keycap></keycombo> kann auf die zweite virtuelle Konsole
   umgeschaltet werden.</para>
 
 <para>Um <command>vi</command> zu beenden, ohne die &Auml;nderungen zu
   speichern, muss <keycombo action="seq"><keycap>Esc</keycap>
   <keycap>:</keycap><keycap>q</keycap><keycap>!</keycap>
   </keycombo> eingegeben werden.</para>
 
 <para>Der Fenstermanager ist so konfiguriert, dass mittels
   <keycombo action="simul"><keycap>Alt</keycap>
   <mousebutton>rechter Maustaste</mousebutton> </keycombo>
    Fenster verschoben werden k&ouml;nnen.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>Mit der Tastenkombination <keycombo
               action="simul"><keycap>Alt</keycap>
               <keycap>F1</keycap></keycombo> kann auf die zweite
             virtuelle Konsole umgeschaltet werden.</para>
 
           <para>Um <command>vi</command> zu beenden, ohne die
             &Auml;nderungen zu speichern, muss <keycombo
               action="seq"><keycap>Esc</keycap>
               <keycap>:</keycap><keycap>q</keycap><keycap>!</keycap>
             </keycombo> eingegeben werden.</para>
 
           <para>Der Fenstermanager ist so konfiguriert, dass mittels
             <keycombo action="simul"><keycap>Alt</keycap>
               <mousebutton>rechter Maustaste</mousebutton>
             </keycombo>
             Fenster verschoben werden k&ouml;nnen.</para>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Anwendungen, Befehle, Optionen und Hilfeseiten</title>
 
         <para>Oft besteht die Notwendigkeit auf bestimmte Anwendungen
           und Befehle zu verweisen. Der Unterschied zwischen einer
           Anwendung und einem Befehl liegt darin, dass eine
           Anwendung ein einzelnes oder eine Gruppe von Programmen ist,
           mit denen eine bestimmte Aufgabe erledigt werden kann. Ein
           Befehl hingegen ist der Name eines Programmes, dass der
           Benutzer aufrufen kann<footnote><para>Der Befehl
               <command>mozilla</command> startet das Programm
               <application>mozilla</application>.</para>
           </footnote>.</para>
 
         <para>Desweiteren kann es auch vorkommen, dass die
           von einem Programm (in einem bestimmten Fall)
           akzeptierten Optionen genannt werden m&uuml;ssen.</para>
 
         <para>Schlu&szlig;endlich ist es oft gew&uuml;nscht, zu einem
           Befehl dessen Abschnitt der Manualseiten im
           Unix-&uuml;blichen Stil <quote>Befehl(Zahl)</quote>
           anzugeben.</para>
 
         <para>Anwendungsnamen k&ouml;nnen mit <sgmltag>application</sgmltag>
           ausgezeichnet werden.</para>
 
 	<para>Befehle k&ouml;nnen zusammen mit der betreffenden
           Hilfeseite &uuml;ber das DocBook-Element
           <sgmltag>citerefentry</sgmltag> ausgezeichnet werden.
           <sgmltag>citerefentry</sgmltag> muss zwei weitere
           Elemente enthalten: <sgmltag>refentrytitle</sgmltag>,
           f&uuml;r den Befehlsnamen, und <sgmltag>manvolnum</sgmltag>,
           f&uuml;r die Kategorie der Hilfeseite.</para>
 
         <para>Diese Art auf Befehle zu verweisen kann sehr
           erm&uuml;dent sein. Daher gibt es einen Satz von
           <link linkend="sgml-primer-general-entities">Allgemeinen
             Entit&auml;ten</link>, der diese Arbeit erleichtert. Er
           ist in der  Datei
           <filename>doc/share/sgml/man-refs.ent</filename> enhalten
           und kann &uuml;ber den folgenden Bezeichner eingebunden
           werden:</para>
 
         <programlisting>PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"</programlisting>
 
         <para>Jede Entit&auml;t in dieser Datei ist wie folgt aufgebaut:
           <literal>&amp;man.<replaceable>Hilfeseite</replaceable>.<replaceable>Kategorie</replaceable>;</literal>.</para>
 
         <para>Der Anfang eines Dokumentes, das diese Entit&auml;ten
           einbindet, k&ouml;nnte so aussehen:</para>
 
 	<programlisting>&lt;!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
 &lt;!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"&gt;
 %man; &hellip; ]&gt;</programlisting>
 
         <para>Um Befehle innerhalb des Flie&szlig;textes auszuzeichen,
           kann das Element <sgmltag>command</sgmltag> genutzt werden.
           Die Optionen eines Befehles k&ouml;nnen mit Hilfe von
           <sgmltag>option</sgmltag> ausgezeichnet werden.</para>
 
         <para>Wenn man sich mehrmals hintereinander auf den gleichen
           Befehl bezieht, sollte man beim ersten Auftreten die Notation
           <literal>&amp;man.<replaceable>command</replaceable>.<replaceable>section</replaceable>;</literal>
           verwenden.  F&uuml;r alle folgenden Referenzen sollte hingegen
           <sgmltag>command</sgmltag> verwendet werden.  Dadurch
           verbessert sich das Erscheinungsbild, insbesondere von HTML,
           deutlich.</para>
 
         <para>Die Unterscheidung zwischen <sgmltag>command</sgmltag>
           und <sgmltag>application</sgmltag> kann schwer sein, und
           manchmal ist die Entscheidung, welches Element das richtige
           ist, nicht leicht.  Das folgende Beispiel soll diese
           Unterscheidung erleichtern.</para>
 
 	<example>
 	  <title>Anwendungen, Befehle und Optionen</title>
 
 	  <programlisting><![ RCDATA [<para><application>Sendmail</application> ist der verbreitetste
   UNIX-Mailserver.</para>
 
 <para><application>Sendmail</application> besteht aus den Programmen
   <citerefentry>
     <refentrytitle>sendmail</refentrytitle>
     <manvolnum>8</manvolnum>
-  </citerefentry>, &amp;man.mailq.8;, und &amp;man.newaliases.8;.</para>
+  </citerefentry>, &amp;man.mailq.1;, und &amp;man.newaliases.1;.</para>
 
 <para>Mittels der Option <option>-bp</option> kann
   <citerefentry><refentrytitle>sendmail</refentrytitle>
     <manvolnum>8</manvolnum>
   </citerefentry> den Status der Mailwarteschlange ausgeben.
   Der Status der Mailwarteschlange kann durch den Befehl
   <command>sendmail -bp</command> &uuml;berpr&uuml;ft werden.</para>]]></programlisting>
 
 
           <para>Darstellung:</para>
 
           <para><application>Sendmail</application> ist der
             verbreitetste UNIX-Mailserver.</para>
 
           <para><application>Sendmail</application> besteht aus den
             Programmen
             <citerefentry>
               <refentrytitle>sendmail</refentrytitle>
               <manvolnum>8</manvolnum>
             </citerefentry>,
-            <citerefentry>
-	      <refentrytitle>mailq</refentrytitle>
-	      <manvolnum>8</manvolnum>
-	    </citerefentry> und
-            <citerefentry>
-	      <refentrytitle>newaliases</refentrytitle>
-	      <manvolnum>8</manvolnum>
-	    </citerefentry>.</para>
+            &man.mailq.1; sowie &man.newaliases.1;.</para>
 
           <para>Mittels der Option <option>-bp</option> kann
             <citerefentry><refentrytitle>sendmail</refentrytitle>
               <manvolnum>8</manvolnum>
             </citerefentry> den Status der Mailwarteschlange ausgeben.
             Der Status der Mailwarteschlange kann durch den Befehl
             <command>sendmail -bp</command> &uuml;berpr&uuml;ft
             werden.</para>
 	</example>
 
 	<note>
 	  <para>Die Schreibweise
             <literal>&amp;man.<replaceable>Hilfeseite</replaceable>.<replaceable>Kategorie</replaceable>;</literal>
             ist leichter lesbar.</para>
         </note>
       </sect3>
 
       <sect3>
 	<title>Dateien, Verzeichnisse und Erweiterungen</title>
 
         <para>Immer wenn in einem Text der Name einer Datei, eines
           Verzeichnisses oder eine Dateierweiterung vorkommt, sollte
           die betreffende Stelle mit dem Element
           <sgmltag>filename</sgmltag> ausgezeichnet werden.</para>
 
 	<example>
 	  <title>Das Element <sgmltag>filename</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<para>Die SGML-Quellen des
 	    englischen Handbuches befinden sich im Verzeichnis
 	    <filename
 	    class="directory">/usr/doc/en/handbook/</filename>. In
 	    diesem Verzeichnis befindet sich eine Datei
 	    <filename>handbook.sgml</filename>. Desweiteren sollte
 	    sich eine Datei mit dem Namen
 	    <filenname>Makefile</filename> zusammen mit mehreren
 	    Dateien mit der Endung <filename>.ent</filename> in diesem
 	    Verzeichnis befinden.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>Die SGML-Quellen des englischen Handbuches befinden
             sich im Verzeichnis
             <filename>/usr/doc/en/handbook/</filename>. In diesem
             Verzeichnis befindet sich eine Datei
             <filename>handbook.sgml</filename>. Desweiteren sollte
             sich eine Datei mit dem Namen
             <filename>Makefile</filename> zusammen mit mehreren
             Dateien mit der Endung <filename>.ent</filename> in diesem
             Verzeichnis befinden.</para>
 
 	</example>
       </sect3>
 
       <sect3>
         <title>Portnamen</title>
 
 	<note>
 	  <title>FreeBSD-Erweiterung</title>
 
 	  <para>Die hier genannten Elemente sind Bestandteil der
             FreeBSD-Erweiterung f&uuml;r DocBook und sind nicht in der
             originalen DocBook DTD enthalten.</para>
 	</note>
 
         <para>An einigen Stellen ist es notwendig, den Namen eines
-          Ports aus FreeBSDs Portssammlung in Dokumenten zu verwenden.
+          Ports aus FreeBSDs Ports-Sammlung in Dokumenten zu verwenden.
           In diesem Fall sollte ebenfalls das Element
           <sgmltag>filename</sgmltag> eingesetzt werden, dabei aber
           dem Element  das  Attribut <literal>role</literal> mit dem
           Wert <literal>package</literal> zugewiesen werden. Da die
-          Portssammlung an jeder beliebigen Stelle im Dateisystem
+          Ports-Sammlung an jeder beliebigen Stelle im Dateisystem
           installiert werden kann, sollte <sgmltag>filename</sgmltag>
           nur die Kategorie und den Namen des Ports enthalten, aber
           nicht das Verzeichnis
           <filename>/usr/ports</filename>.</para>
 
         <example>
           <title>Portsnamen und das Element <sgmltag>filename</sgmltag></title>
 
           <programlisting><![ RCDATA [<para>Wenn Sie Ihr Netz und dessen Datenverkehr analysieren
   m&ouml;chten, dann installieren Sie bitte den Port <filename
   role="package">net/ethereal</filename>.</para>]]></programlisting>
 
           <para>Darstellung:</para>
 
           <para>Wenn Sie Ihr Netz und dessen Datenverkehr analysieren
             m&ouml;chten, dann installieren Sie bitte den Port <filename
               role="package">net/ethereal</filename>.</para>
         </example>
       </sect3>
 
       <sect3>
 	<title>Ger&auml;tedateien unterhalb von
           <filename>/dev</filename></title>
 
 	<note>
 	  <title>FreeBSD-Erweiterung</title>
 
 	  <para>Die hier genannten Elemente sind Bestandteil der
             FreeBSD-Erweiterung f&uuml;r DocBook und sind nicht in der
             originalen DocBook DTD enthalten.</para>
 	</note>
 
         <para>Wird in einem Dokument Bezug auf Ger&auml;tedateien
           unterhalb von <filename class="directory">dev</filename>
           genommen, dann gibt es zwei M&ouml;glichkeiten diese
           auszuzeichnen. Zum einen kann man sich auf das Ger&auml;t
           beziehen, so wie es unter <filename>/dev</filename> zu
           finden ist, und zum anderen kann man sich auf den
           Ger&auml;tenamen beziehen, wie es innerhalb des Kerns
           verwendet wird. F&uuml;r letztere M&ouml;glichkeit sollte
           das Element <sgmltag>devicename</sgmltag> genutzt
           werden.</para>
 
         <para>Allerdings besteht nicht immer diese
           Wahlm&ouml;glichkeit. Einige Ger&auml;te, wie zum Beispiel
           Netzwerkkartenm haben keinen Eintrag unter
           <filename>/dev</filename> oder werden anders
           dargestellt.</para>
 
 	<example>
 	  <title>Ger&auml;tenamen per <sgmltag>devicename</sgmltag>
             auszeichnen</title>
 
 	  <programlisting><![ RCDATA [<para>Unter FreeBSD wird die serielle Daten&uuml;bertragung &uuml;ber
   <devicename>sio</devicename> abgewickelt, das unterhalb von
   <filename>/dev</filename> eine Reihe von Eintr&auml;gen anlegt.
   Zu diesen Eintr&auml;gen beh&ouml;ren beispielsweise
   <filename>/dev/ttyd0</filename> und
   <filename>/dev/cuaa0</filename>.</para>
 
   <para>Andererseits erscheinen Ger&auml;te wie beispielsweise
     <devicename>ed0</devicename> nicht unterhalb von
     <filename>/dev</filename>.</para>
 
   <para>Unter MS-DOS wird das erste Diskettelaufwerk als
     <devicename>a:</devicename> bezeichnet.  FreeBSD
      bezeichnet es als <filename>/dev/fd0</filename>.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>Unter FreeBSD wird die serielle Daten&uuml;bertragung
             &uuml;ber <devicename>sio</devicename> abgewickelt, das
             unterhalb von <filename>/dev</filename> eine Reihe von
             Eintr&auml;gen anlegt. Zu diesen Eintr&auml;gen
             beh&ouml;ren beispielsweise
             <filename>/dev/ttyd0</filename> und
             <filename>/dev/cuaa0</filename>.</para>
 
           <para>Andererseits erscheinen Ger&auml;te wie beispielsweise
             <devicename>ed0</devicename> nicht unterhalb von
             <filename>/dev</filename>.
 
           <para>Unter MS-DOS wird das erste Diskettelaufwerk als
             <devicename>a:</devicename> bezeichnet. FreeBSD bezeichnet
             es als <filename>/dev/fd0</filename>.</para>
 
 	</example>
       </sect3>
 
       <sect3>
 	<title>Rechner, Domains, IP-Adressen und mehr</title>
 
 	<note>
 	  <title>FreeBSD-Erweiterung</title>
 
 	  <para>Die hier genannten Elemente sind Bestandteil der
             FreeBSD-Erweiterung f&uuml;r DocBook und sind nicht in der
             originalen DocBook DTD enthalten.</para>
 	</note>
 
 
 	<para>Bezeichner f&uuml;r Rechner k&ouml;nnen in Abh&auml;ngigkeit
           der Bezeichnungsweise auf verschiedene Art und Weise
           ausgezeichnet werden. Gemeinsam ist allen, dass sie
           das Element <sgmltag>hostid</sgmltag>  benutzen. &Uuml;ber das
           Attribut <literal>role</literal> wird die Art des Bezeichners
           genauer bestimmt.</para>
 
 	<variablelist>
 	  <varlistentry>
             <term>Kein Rollenattribut oder
               <literal>role="hostname"</literal></term>
 
 	    <listitem>
               <para>Ohne Rollenattribut stellt der umschlossene Text
                 einen normlen Rechnernamen wie
                 <literal>freefall</literal> oder
                 <literal>wcarchive</literal> dar. Wenn es
                 gew&uuml;nscht ist, kann mittels
                 <literal>role="hostname"</literal> explizit angegeben
                 werden, dass es sich um einen Rechnernamen
                 handelt.</para>
 	    </listitem>
 	  </varlistentry>
 
 	  <varlistentry>
 	    <term><literal>role="domainname"</literal></term>
 
 	    <listitem>
               <para>Ein Domainname wie <literal>FreeBSD.org</literal>
                 oder <literal>ngo.org.uk</literal>. Er enth&auml;lt keinen
                 Rechnernamen.</para>
 	    </listitem>
 	  </varlistentry>
 
 	  <varlistentry>
 	    <term><literal>role="fqdn"</literal></term>
 
 	    <listitem>
               <para>Vollqualifizierter Domainname wie
                 <literal>www.FreeBSD.org</literal>. Enth&auml;lt sowohl
                 einen Domainnamen als auch einen Rechnernamen.</para>
 	    </listitem>
 	  </varlistentry>
 
 	  <varlistentry>
 	    <term><literal>role="ipaddr"</literal></term>
 
 	    <listitem>
               <para>Eine IP-Adresse, meistens als durch Doppelpunkte
                 getrenntes Tupel von vier Zahlen dargestellt.</para>
 	    </listitem>
 	  </varlistentry>
 
           <varlistentry>
             <term><literal>role="ip6addr"</literal></term>
 
             <listitem>
               <para>Eine IPv6-Adresse.</para>
             </listitem>
           </varlistentry>
 
 	  <varlistentry>
 	    <term><literal>role="netmask"</literal></term>
 
 	    <listitem>
               <para>Eine Netzwerkmaske, dargestellt als ein durch
                 Doppelpunkte getrenntes Vierzahlentupel, einer Hexzahl
                 oder als ein <literal>/</literal>, dem eine Zahl
                 folgt.</para>
 	    </listitem>
 	  </varlistentry>
 
 	  <varlistentry>
 	    <term><literal>role="mac"</literal></term>
 
 	    <listitem>
               <para>Eine MAC-Adresse, dargestellt durch zweistellige
                 Hexzahlen, die durch Doppelpunkte getrennt
                 sind.</para>
 	    </listitem>
 	  </varlistentry>
 	</variablelist>
 
 	<example>
 	  <title><literal>role</literal> und
             <sgmltag>hostid</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<para>Der lokale Rechner kann immer &uuml;ber den Namen
   <hostid>localhost</hostid>  angesprochen werden, dem immer
   die IP-Adresse
   <hostid role="ipaddr">127.0.0.1</hostid> zugeordnet ist.</para>
 
   <para>Zur Domain <hostid role="domainname">FreeBSD.org</hostid>
     geh&ouml;ren verschiedene Rechner, inklusive <hostid
     role="fqdn">freefall.FreeBSD.org</hostid> und <hostid
-    role="fqdn">bento.FreeBSD.org</hostid>.</para>
+    role="fqdn">pointyhat.FreeBSD.org</hostid>.</para>
 
   <para>Wenn eine IP-Adresse einer Netzwerkkarte zugeordnet wird,
     was mit der Hilfe von <command>ifconfig</command> geschieht,
     sollte <emphasis>immer</emphasis> die Netzmaske
     <hostid role="netmask">255.255.255.255</hostid>, die auch
     hexadezimal als <hostid role="netmask">0xffffffff</hostid>
     abgegeben werden kann, benutzt werden.</para>
 
   <para>Die MAC-Adresse ist f&uuml;r jede existierende Netzwerkkarte
     auf der Welt eindeutig. Eine typische MAC-Adresse ist
     beispielsweise <hostid
     role="mac">08:00:20:87:ef:d0</hostid>.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>Der lokale Rechner kann immer &uuml;ber den Namen
             <hostid>localhost</hostid> angesprochen werden, dem immer
             die IP-Adresse <hostid role="ipaddr">127.0.0.1</hostid>
             zugeordnet ist.</para>
 
           <para>Zur Domain <hostid
               role="domainname">FreeBSD.org</hostid> geh&ouml;ren
             verschieden Rechner, inklusive <hostid
               role="fqdn">freefall.FreeBSD.org</hostid> und <hostid
               role="fqdn">bento.FreeBSD.org</hostid>.</para>
 
           <para>Wenn eine IP-Adresse einer Netzwerkkarte zugeordnet
             wird, was mit der Hilfe von <command>ifconfig</command>
             geschieht, sollte <emphasis>immer</emphasis> die Netzmaske
             <hostid role="netmask">255.255.255.255</hostid>, die auch
             hexadezimal als <hostid role="netmask">0xffffffff</hostid>
             abgegeben werden kann, benutzt werden.</para>
 
           <para>Die MAC-Adresse ist f&uuml;r jede existierende
             Netzwerkkarte auf der Welt eindeutig. Eine typische
             MAC-Adresse ist beispielsweise <hostid
               role="mac">08:00:20:87:ef:d0</hostid>.</para>
 	</example>
       </sect3>
 
       <sect3>
 	<title>Benutzernamen</title>
 
 	<note>
 	  <title>FreeBSD-Erweiterung</title>
 
 	  <para>Die hier genannten Elemente sind Bestandteil der
             FreeBSD-Erweiterung f&uuml;r DocBook und sind nicht in der
             originalen DocBook DTD enthalten.</para>
 	</note>
 
         <para>Namen von Benutzern, wie
           <literal>root</literal> oder <literal>bib</literal>,
           k&ouml;nnen mit dem Element <sgmltag>username</sgmltag>
           ausgezeichnet werden.</para>
 
 	<example>
 	  <title>Das Element <sgmltag>username</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<para>F&uuml;r die meisten Administrationsaufgaben m&uuml;ssen
     Sie als <username>root</username> angemeldet sein.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
 	  <para>F&uuml;r die meisten Administrationsaufgaben m&uuml;ssen Sie als
             <username>root</username> angemeldet sein.</para>
 
 	</example>
       </sect3>
 
       <sect3>
 	<title>Beschreibung von <filename>Makefile</filename>s</title>
 
 	<note>
 	  <title>FreeBSD-Erweiterung</title>
 
 	  <para>Die hier genannten Elemente sind Bestandteil der
             FreeBSD-Erweiterung f&uuml;r DocBook und sind nicht in der
             originalen DocBook DTD enthalten.</para>
 	</note>
 
         <para>Zur Beschreibung von Teilen einer Makedatei stehen die
           beiden Elemente <sgmltag>marketarget</sgmltag> und
           <sgmltag>makevar</sgmltag> zur Verf&uuml;gung.
           <sgmltag>maketarget</sgmltag> bezeichnet ein Ziel eines
           <filename>Makefile</filename>s, das als Parameter beim
           Aufruf von <command>make</command> angegeben werden kann.
           <sgmltag>makevar</sgmltag> hingegen bezeichnet eine
           Variable, die entweder in einem
           <filename>Makefile</filename> definiert oder
           <command>make</command> auf der Befehlszeile &uuml;bergeben
           werden kann, um so den Bauprozess zu beeinflussen.</para>
 
       <example>
 	  <title><sgmltag>maketarget</sgmltag> und
             <sgmltag>makevar</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<para>Zwei &uuml;bliche Ziele in einem <filename>Makefile</filename>
   sind <maketarget>all</maketarget> und
   <maketarget>clean</maketarget>.</para>
 
 <para>&Uuml;blicherweise wird, wenn das Ziel <maketarget>all</maketarget>
   aufgerufen wird, die gesamte Anwendung neu erstellt. Der Aufruf
   des Zieles <maketarget>clean</maketarget> veranla&szlig;t das
   L&ouml;schen aller tempor&auml;ren Dateien (zum Beispiel
   <filename>.o</filename>), die w&auml;hrend der &Uuml;bersetzung erzeugt
   wurden.</para>
 
 <para>Das genaue Verhalten von <maketarget>clean</maketarget>
   kann von einer Reihe von Variablen beeinflu&szlig;t werden.
   Stellvertretend seien hier <makevar>CLOBBER</makevar> und
   <makevar>RECURSE</makevar> genannt.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>Zwei &uuml;bliche Ziele in einem
             <filename>Makefile</filename> sind
             <maketarget>all</maketarget> und
             <maketarget>clean</maketarget>.</para>
 
           <para>&Uuml;blicherweise wird, wenn das Ziel
             <maketarget>all</maketarget> aufgerufen wird, die gesamte
             Anwendung neu erstellt. Der Aufruf des Zieles
             <maketarget>clean</maketarget> veranla&szlig;t das
             L&ouml;schen aller tempor&auml;ren Dateien (zum Beispiel
             <filename>.o</filename>), die w&auml;hrend der
             &Uuml;bersetzung erzeugt wurden.</para>
 
           <para>Das genaue Verhalten von
             <maketarget>clean</maketarget> kann von einer Reihe von
             Variablen beeinflu&szlig;t werden. Stellvertretend seien
             hier <makevar>CLOBBER</makevar> und
             <makevar>RECURSE</makevar> genannt.</para>
 	</example>
     </sect3>
 
       <sect3>
       <title>Text buchstabengetreu &uuml;bernehmen</title>
 
         <para>F&uuml;r das Handbuch ist es oft notwendig, Textausschnitte
           buchstabengetreu darzustellen. Hierbei kann es sich um Texte
           handeln, die aus einer anderen Datei stammen oder die der
           Leser eins-zu-eins aus dem Handbuch kopieren k&ouml;nnen
           soll.</para>
 
       <para>In einigen F&auml;llen ist zu diesem Zwecke
       <sgmltag>programlisting</sgmltag> ausreichend, jedoch nicht
       immer. So ist <sgmltag>programlisting</sgmltag> zum Beispiel
-      nicht einsetzbar, wenn es darum geht einen Auszug aus einer
+      nicht einsetzbar, wenn es darum geht, einen Auszug aus einer
       Datei innerhalb eines Absatzes einzuf&uuml;gen. In solchen F&auml;llen
       sollte das Element <sgmltag>literal</sgmltag> zum Einsatz
       kommen.</para>
 
       <example>
       <title><sgmltag>literal</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<para>Die Zeile <literal>maxusers 10</literal> in der
   Kernelkonfigurationsdatei beeinflu&szlig;t die Gr&ouml;&szlig;e vieler
   Systemtabellen und kann als ungef&auml;hr als Richtwert daf&uuml;r
   gelten, wie viele paralle Anmeldungen das System handhaben
   kann.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>Die Zeile <literal>maxusers 10</literal> in der
             Kernelkonfigurationsdatei beeinflu&szlig;t die Gr&ouml;&szlig;e vieler
             Systemtabellen und kann als ungef&auml;hr als Richtwert daf&uuml;r
             gelten, wie viele paralle Anmeldungen das System handhaben
             kann.</para>
 	</example>
       </sect3>
 
       <sect3>
         <title>Benutzerspezifische Eingaben darstellen</title>
 
         <!--@todo Klingt ein wenig kompiliziert.
               Oliver Fischer -->
 
 	<para>Es kommt oft vor, dass der Leser Beispiele,
 	  Dateinamen oder Kommandozeilen ver&auml;ndern muss.
           F&uuml;r einen solchen Anwendungsfall
           ist das Element <sgmltag>replaceable</sgmltag> gedacht. Es
           kann <emphasis>innerhalb</emphasis> von anderen Elementen
           genutzt werden, um die Teile auszuzeichnen, die es zu
           ersetzen gilt.</para>
 
 	<example>
 	  <title>Das Element <sgmltag>replaceable</sgmltag></title>
 
-	  <programlisting><![ RCDATA [<informalexample>
-  <screen>&prompt.user; <userinput>man <replaceable>command</replaceable></userinput></screen>
-</informalexample>]]></programlisting>
+	<programlisting><![ CDATA [<screen>&prompt.user; <userinput>man <replaceable>command</replaceable></userinput></screen>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
 	  <informalexample>
 	    <screen>&prompt.user; <userinput>man <replaceable>command</replaceable></userinput></screen>
 	  </informalexample>
 
           <para>Dieses Beispiel zeigt, dass nur der Text mit
             <sgmltag>replaceable</sgmltag> umschlossen werden soll,
             den der Benutzer einzusetzen hat. S&auml;mtlicher anderer
             Text sollte wie &uuml;blich ausgezeichnet werden.</para>
 
 	  <programlisting><![ RCDATA [<para>Die Zeile
   <literal>maxusers <replaceable>n</replaceable></literal>
   in der Kernelkonfigurationsdatei bestimmt die Gr&ouml;&szlig;e vieler Systemtabellen
   und stellt einen groben Richtwert daf&uuml;r dar, wie viele gleichzeitige Anmeldungen
   das System unterst&uuml;tzt.</para>
 
 <para>F&uuml;r einen Arbeitsplatzrechner stellt <literal>32</literal> einen guten
   Wert f&uuml;r <replaceable>n</replaceable> dar.</para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
           <para>Die Zeile <literal>maxusers
               <replaceable>n</replaceable></literal> in der
             Kernelkonfigurationsdatei bestimmt die Gr&ouml;&szlig;e
             vieler Systemtabellen und stellt einen groben Richtwert
             daf&uuml;r dar, wie viele gleichzeitige Anmeldungen das
             System unterst&uuml;tzt.</para>
 
           <para>F&uuml;r einen Arbeitsplatzrechner stellt
             <literal>32</literal> einen guten Wert f&uuml;r
             <replaceable>n</replaceable> dar.</para>
 	</example>
       </sect3>
 
       <sect3>
         <title>Fehlermeldungen des Systems darstellen</title>
 
         <para>In manchen F&auml;llen kann es n&ouml;tig sein,
           Fehlermeldungen darzustellen, die von FreeBSD erzeugt werden
           k&ouml;nnen. F&uuml;r solche F&auml;lle ist das Element
           <sgmltag>errorname</sgmltag> vorgesehen.</para>
 
         <example>
           <title>Das Element <sgmltag>errorname</sgmltag></title>
 
 	  <programlisting><![ RCDATA [ <screen><errorname>Panic: cannot mount root</errorname></screen> ]]></programlisting>
 
 
           <para>Darstellung:</para>
 
           <informalexample>
             <screen><errorname>Panic: cannot mount root</errorname></screen>
           </informalexample>
         </example>
       </sect3>
     </sect2>
     <sect2>
       <title>Bilder und Grafiken</title>
 
       <important>
         <para>Die Verwendung von Grafiken innerhalb der Dokumentation
           ist momentan noch in einem experimentellen Stadium. Es ist
           daher wahrscheinlich, dass sich die hier beschriebenen
           Mechanismen noch &auml;ndern werden.</para>
 
         <para>F&uuml;r die Verwendung von Grafiken ist es notwendig,
           den Port <filename
             role="package">graphics/ImageMagick</filename>
           zus&auml;tzlich zu installieren, da er
           <emphasis>nicht</emphasis> vom Port <filename
             role="package">textproc/docproj</filename> mitinstalliert
           wird.</para>
 
         <para>Das beste Beispiel f&uuml;r den Einsatz von Grafiken ist
           der unter
           <filename>doc/en_US.ISO8859-1/articles/vm-design/</filename>
           zu findene Artikel <quote>Design elements of the FreeBSD VM
             system</quote>. Falls beim Lesen der folgenden Kapitel
           Fragen unbeantwortet oder unklar bleiben, empfiehlt es sich,
           die unter dem genannten Verzeichnis befindlichen Dateien zu
           studieren und anhand ihrer zu verstehen, wie alles
           zusammenh&auml;ngt. Es empfiehlt sich, den Artikel in
           verschiedenen Ausgabeformaten zu erzeugen, da man so sehen
           kann, wie die Grafiken in Abh&auml;ngigkeit vom
           Ausgabemedium angeordnet werden.</para>
       </important>
 
       <sect3>
 	<title>Unterst&uuml;tze Grafikformate</title>
 
         <para>Zur Zeit werden nur zwei Grafikformate unterst&uuml;tzt.
           Welches von beiden Formaten zum Einsatz kommen sollte,
           h&auml;ngt von der Art der Grafik ab.</para>
 
         <para>F&uuml;r Bilder, die vorrangig Vektorelemente wie
           Netzwerkdiagramme, Zeitlinien und &auml;hnliches beinhalten,
           sollte Encapsulated Postscript als Format gew&auml;hlt
           werden. Wichtig ist es in diesem Fall, dass die
           Grafikdatei die Endung <filename>.eps</filename> hat.
           F&uuml;r Bitmapgrafiken, wie zum Beispiel Bildschirmfotos,
           steht das  Portable Network Grafic Format zur
           Verf&uuml;gung. In diesem Fall, sollte die Grafikdatei immer
           die Endung <filename>.png</filename> haben.</para>
 
         <para>In das CVS-Archiv sollten <emphasis>nur</emphasis>
           Grafiken in diesen beiden Formaten &uuml;bernommen
           werden.</para>
 
         <para>Es sollte darauf sehr darauf geachtet werden, das
           richtige Format f&uuml;r das richtige Bild zu w&auml;hlen.
           Erwartungsgem&auml;&szlig; wird es Dokumente geben, die eine
           Mischung aus PNG- und EPS-Grafiken enthalten. In solchen
           F&auml;llen, stellen die Makedateien die Verwendung des
           richtigen Formats in Abh&auml;ngigkeit vom Ausgabeformat
           sicher. <emphasis>Deshalb sollte die gleiche Grafik niemals
             in zwei unterschiedlichen Formaten in das CVS-Archiv
             &uuml;bernommen werden</emphasis>.</para>
 
 	<important>
           <para>Es ist absehbar, dass das Dokumentationsprojekt
             in Zukunft das Scalable Vector Graphic-Format (SVG) als
             Standardformat f&uuml;r Vektorgrafiken &uuml;bernehmen
             wird. Zum jetzigen Zeitpunkt ist dieser Wechsel noch nicht
             m&ouml;glich, da der Stand der jetzigen SVG-Anwendungen
             noch nicht den daf&uuml;r notwendigen Erfordernissen
             entspricht.</para>
 	</important>
 
       </sect3>
 
       <sect3>
 	<title>DocBook-Elemente f&uuml;r den Grafikeinsatz</title>
 
         <para>Das Auszeichnen von Bildern mittels DocBook ist relativ
           einfach. Zuerst wird ein
           <sgmltag>mediaobject</sgmltag>-Element eingef&uuml;gt, das
           als Container f&uuml;r medienspezifische Elemente fungieren
           kann. F&uuml;r die Zwecke des FDPs sind das die Elemente
           <sgmltag>imageobject</sgmltag> und
           <sgmltag>textobject</sgmltag>.</para>
 
         <para>In das <sgmltag>mediaobject</sgmltag>-Element sollten
           ein Element vom Typ <sgmltag>imageobject</sgmltag> und zwei
           <sgmltag>textobject</sgmltag>-Elemente eingef&uuml;gt
           werden. Das <sgmltag>imageobject</sgmltag>-Element verweist
           auf die eigentliche Grafikdatei. Dabei ist allerdings nur
           der Dateipfad ohne Erweiterung anzugegeben. Die
           <sgmltag>textobject</sgmltag>-Elemente werden daf&uuml;r
           genutzt, Texte aufzunehmen, die dem Leser anstelle des
           Bildes oder zusammen mit dem Bild angezeigt werden.</para>
 
         <para>Dies kann unter zwei Umst&auml;nden geschehen:</para>
 
         <itemizedlist>
 	  <listitem>
             <para>Wenn ein Dokument als HTML-Datei durch einem Browser
               angezeigt wird. In diesem Falle muss jeder Grafik
               ein Alternativtext zugeordnet werden, der dem Leser
               angezeigt werden kann. Meist ist das notwendig, wenn der
               Browser die Grafik noch nicht geladen hat oder wenn der
               Benutzer den Mauszeiger &uuml;ber die Grafik
               f&uuml;hrt.</para>
 	  </listitem>
 
 	  <listitem>
             <para>Wenn das Dokument als Textdatei gelesen wird. Da in
               einer Textdatei keine Grafiken angezeigt werden k&ouml;nnen,
               sollte es f&uuml;r die Grafik eine Textentsprechung geben,
               die alternativ angezeigt werden kann.</para>
 	  </listitem>
 	</itemizedlist>
 
         <para>Das folgende Beispiel soll das bisher geschriebene
           illustrieren. Angenommen es liegt eine einzubindene Grafik
           in der Datei <filename>bild1</filename> vor, die  die
           Darstellung eines As in einem Rechteck enth&auml;lt. Die
           ASCII-Alternative k&ouml;nnte so ausgezeichnet werden:</para>
 
 	<programlisting>&lt;mediaobject>
   &lt;imageobject>
     &lt;imagedata fileref="bild1"> <co id="co-image-ext">
   &lt;/imageobject>
   &lt;textobject>
     &lt;literallayout class="monospaced">+ - - - - - - - - - - - - - - -+ <co id="co-image-literal">
 |       A       |
 +- - - - - - - - - - - - - - -+&lt;/literallayout>
   &lt;/textobject>
   &lt;textobject>
     &lt;phrase>Ein Bild&lt;/phrase> <co id="co-image-phrase">
   &lt;/textobject>
 &lt;/mediaobject></programlisting>
 
 	<calloutlist>
 	  <callout arearefs="co-image-ext">
             <para>Innerhalb vom Element <sgmltag>imageobject</sgmltag>
               befindet sich ein Element <sgmltag>imagedata</sgmltag>,
               welches mit Hilfe des Attributes
               <literal>fileref</literal> den Namen der Grafikdatei
               (ohne Erweiterung) angibt. Die Bestimmung der
               Dateierweiterung wird von den Stylesheets
               &uuml;bernommen.</para>
 	  </callout>
 
 	  <callout arearefs="co-image-literal">
             <para>Das erste <sgmltag>textobject</sgmltag>-Element
               enth&auml;lt ein <sgmltag>literallayout</sgmltag>-Element,
               dessen Attribut <literal>class</literal> den Wert
               <literal>monospaced</literal> zugewiesen bekommt. Der
               Inhalt dieses Elements wird genutzt, wenn das Dokument
               in Textform ausgegeben wird. An dieser Stelle hat der
               Autor die M&ouml;glichkeit seine
               <quote>Textzeichenk&uuml;nste</quote> unter Beweis zu
               stellen.</para>
 
             <para>Wichtig ist, dass die erste und die letzte
               Zeile sich gleichauf mit dem &ouml;ffenden und dem
               schlie&szlig;enden Tag befindet. Dadurch wird
               sichergestellt, dass keine unn&ouml;tigen
               Leerzeichen in die Ausgabe aufgenommen werden.</para>
 	  </callout>
 
 	  <callout arearefs="co-image-phrase">
             <para>Das zweite <sgmltag>textobject</sgmltag>-Element
               sollte lediglich ein <sgmltag>phrase</sgmltag>-Element
               enthalten. Wird das Dokument nach HTML konvertiert, wird
               dessen Inhalt f&uuml;r das Attribut
               <literal>alt</literal> des <sgmltag>img</sgmltag>-Tags
               verwendet.</para>
 	  </callout>
 	</calloutlist>
       </sect3>
 
       <sect3>
 	<title>Die <filename>Makefile</filename>-Eintr&auml;ge</title>
 
         <para>Alle in einem Dokument verwendeten Grafiken m&uuml;ssen in
           dem zugeh&ouml;rigen Makefile in der Variable
           <makevar>IMAGES</makevar> enthalten sein.
           <makevar>IMAGES</makevar> sollte immer die Namen der
           <emphasis>Quellgrafiken</emphasis> enthalten. Werden in
           einem Dokument beispielsweise die drei Grafiken
           <filename>bild1.eps</filename>,
           <filename>bild2.png</filename> und
           <filename>bild3.png</filename> referenziert, sollte das
           <filename>Makefile</filename> die folgende Zeile
           enthalten:</para>
 
         <programlisting>&hellip;
 IMAGES= bild1.eps bild2.png bild3.png
 &hellip;</programlisting>
 
 	<para>Eine andere M&ouml;glichkeit w&auml;re:</para>
 
 	<programlisting>&hellip;
 IMAGES=  bild1.eps
 IMAGES+= bild2.png
 IMAGES+= bild3.png
 &hellip;</programlisting>
 
 
         <para>Es kann nicht oft genug betont werden: Welche
           Grafikdateien f&uuml;r das zu erzeugende Dokument ben&ouml;tigt
           werden, wird von dem Makefiles bestimmt.
           <makevar>IMAGES</makevar> darf nur die Originaldateien
           enthalten.</para>
       </sect3>
 
       <sect3>
 	<title>Grafiken und Kapitel in Unterverzeichnissen</title>
 
 	<para>Wenn Sie Ihre Dokumentation in mehrere kleine
 	  Dateien aufspalten (siehe
 	  <xref linkend="sgml-primer-include-using-gen-entities">),
 	  m&uuml;ssen Sie sorgf&auml;ltig vorgehen.</para>
 
         <para>Angenommen es handelt sich um ein Buch, dessen drei
           Kapitel in separaten Verzeichnissen angelegt wurden
           (<filename>kapitel1/kapitel.sgml</filename>,
           <filename>kapitel2/kapitel.sgml</filename> und
           <filename>kapitel3/kapitel.sgml</filename>). Enthalten die
           Kapitel Grafiken, empfiehlt es sich, diese in den gleichen
           Verzeichnisses abzulegen, wie die Kapitel selbst. In diesem
           Falle gilt es jedoch zu beachten, dass die Pfade der
           Grafikdateien in der Variable <makevar>IMAGES</makevar> und
           in den <sgmltag>imagedata</sgmltag>-Elementen immer auch den
           Verzeichnisnamen mitenthalten.</para>
 
         <para>Soll beispielsweise die Datei
           <filename>kapitel1/bild1.png</filename> in das in
           <filename>kapitel1/kapitel.sgml</filename> enthaltene
           Kapitel eingebunden werden, sollte dies so erfolgen:</para>
 
 	<programlisting>&lt;mediaobject>
   &lt;imageobject>
     &lt;imagedata fileref="kapitel1/bild1"> <co id="co-image-dir">
   &lt;/imageobject>
 
   &hellip;
 &lt;/mediaobject></programlisting>
 
 	<calloutlist>
 	  <callout arearefs="co-image-dir">
             <para><literal>fileref</literal> muss den
               Datei- und den Verzeichnisnamen enthalten.</para>
           </callout>
 	</calloutlist>
 
         <para>Das <filename>Makefile</filename> muss dementsprechend
           die Zeile
 
 	<programlisting>&hellip;
 IMAGES=  kapitel1/bild1.png
 &hellip;</programlisting>
 
           enthalten.</para>
 
         <para>Wird dies beachtet, sollte es zu keinen Problemen
           kommen.</para>
       </sect3>
     </sect2>
 
     <sect2>
       <title>Querverweise</title>
 
       <note>
 	<para>Querverweise sind auch Flu&szlig;elemente.</para>
       </note>
 
       <sect3>
 	<title>Querverweise innerhalb eines Dokumentes</title>
 
 
         <para>Um innerhalb eines Dokumentes Verweise anzulegen, muss
           angegeben werden, von welcher Textstelle aus wohin verwiesen
           werden soll.</para>
 
         <para>Jedes DocBook-Element besitzt ein Attribut
           <literal>id</literal>, &uuml;ber das seinem Element ein
           eindeutiger Bezeichner zugewiesen werden kann.</para>
 
 
         <!-- ?: Mit diesem Absatz bin ich gar nicht zu frieden! -->
         <para>In den meisten F&auml;llen werden Querverweise nur zu
           Kapiteln gesetzt. Die <sgmltag>chaper</sgmltag>- und
           <sgmltag>sect*</sgmltag>-Elemente sollten aus diesem Grunde
           ein gesetztes <literal>id</literal>-Attribut
           besitzen.</para>
 
 	<example>
 	  <title><sgmltag>chapter</sgmltag> und <sgmltag>section</sgmltag>
             mit dem Attribut <literal>id</literal></title>
 	  <!--<title><literal>id on chapters and sections</literal></title>-->
 
 	  <programlisting><![ RCDATA [<chapter id="kapitel1">
   <title>Einf&uuml;hrung</title>
 
   <para>Das ist eine Einf&uuml;hrung. Sie enth&auml;lt ein Unterkapitel, das
     ebenfalls einen eigenen Bezeichner hat.</para>
 
   <sect1 id="kapitel1-unterkapitel1">
     <title>Unterkapitel 1</title>
 
     <para>Das ist ein Unterkapitel.</para>
   </sect1>
 </chapter>]]></programlisting>
 	</example>
 
         <para>Als Wert f&uuml;r das Attribut <literal>id</literal>
           sollte immer ein selbsterkl&auml;render Bezeichner gew&auml;hlt
           werden. Zudem ist es notwendig, dass dieser Bezeichner
           innerhalb des Dokumentes eindeutig ist. Im obigen Beispiel
           wurde der Bezeichner f&uuml;r das Unterkapitel gebildet,
           indem der Bezeichner des &uuml;bergeordneten Kapitels um den
           Titel des Unterkapitels erweitert wurde. Diese
           Vorgehensweise hilft sicherzustellen, dass Bezeichner
           eindeutig sind und bleiben.</para>
 
         <para>Manchmal soll jedoch nicht auf den Anfang eines Kapitels
           verwiesen werden, sondern zum Beispiel auf eine Stelle in
           einem Absatz oder auf ein bestimmtes Beispiel. In solchen
           F&auml;llen kann an der Stelle, auf die verwiesen werden
           soll, das Element <sgmltag>anchor</sgmltag> mit gesetztem
           Attribut <literal>id</literal> eingef&uuml;gt werden.
           <sgmltag>anchor</sgmltag> kann selber keinen weiteren Inhalt
           aufnehmen.</para>
 
 	<example>
 	  <title>Querverweise und das Element
             <sgmltag>anchor</sgmltag></title>
 
 	  <programlisting><![ RCDATA [<para>Dieser Absatz enth&auml;lt ein
   <anchor id="absatz1">Ziel f&uuml;r Querverweise, was jedoch keine
   Auswirkung auf dessen Darstellung hat.</para>]]></programlisting>
 	</example>
 
         <para>Zum Anlegen des eigentlichen Querverweises selbst kann
           eines der beiden Elemente <sgmltag>xref</sgmltag> oder
           <sgmltag>link</sgmltag> genutzt werden. Beide besitzen das
           Attribut <literal>linkend</literal>, dem der
           <literal>id</literal>-Wert des Verweiszieles zugewiesen
           wird. Ob sich das Ziel vor oder nach dem Verweis befindet,
           spielt keine Rolle.</para>
 
         <para><sgmltag>xref</sgmltag> und <sgmltag>link</sgmltag>
           unterscheiden sich jedoch hinsichtlich der Art und Weise,
           auf die der Text erzeugt wird, auf dem der Querverweis
           liegt. Kommt <sgmltag>xref</sgmltag> zum Einsatz, hat der
           Autor keine Kontrolle dar&uuml;ber &ndash; der Text wird
           automatisch f&uuml;r ihn erzeugt.</para>
 
 
 	<example>
 	  <title>Einsatz von <sgmltag>xref</sgmltag></title>
 
           <!-- @todo Das englische Original sollte um
                      einen Link zu dem Beispiel erweitert werden. -->
           <para>F&uuml;r dieses Beispiel wird davon ausgegangen, dass sich
             folgendes Textfragment irgendwo innerhalb eines Dokumentes
             auftaucht, dass das vorherige
             <literal>id</literal>-Beispiel enth&auml;lt.</para>
 
 
 	  <programlisting><![ RCDATA [<para>Weitere Informationen gibt
   es im <xref linkend="kapitel1">.</para>
 
 <para>Genauere Informationen k&ouml;nnen im
   <xref linkend="kapitel1-unterkapitel1"> gefunden werden.</para>]]></programlisting>
 
           <para>Der Verweistext wird automatisch von den Stylesheets
             erzeugt und so hervorgehoben, dass ersichtlich ist,
             dass es sich bei dem Text um einen Verweis
             handelt.</para>
 
 	  <blockquote>
 	    <para>Weitere Informationen k&ouml;nnen in der
                 <emphasis>Einf&uuml;hrung</emphasis> gefunden
                 werden.</para>
 
               <para>Genauere Informationen k&ouml;nnen im
                 <emphasis>Unterkapitel 1</emphasis> gefunden
                 werden.</para>
 	  </blockquote>
 	</example>
 
         <para>Der Text, auf dem der HTML-Link f&uuml;r den Querverweis
           liegt, wurde von den Kapitel&uuml;berschriften
           &uuml;bernommen.</para>
 
 	<note>
           <para>Das bedeutet, dass es <emphasis>nicht
               m&ouml;glich</emphasis> ist, mit der Hilfe von
             <sgmltag>xref</sgmltag> einen Querverweis zu einer mit
             <sgmltag>anchor</sgmltag> gekennzeichneten Stelle
             anzulegen. Da <sgmltag>anchor</sgmltag>  keinen Inhalt
             aufnehmen kann, k&ouml;nnen die Stylesheets nicht
             automatisch einen Text f&uuml;r den Verweis
             erzeugen.</para>
         </note>
 
         <para>M&ouml;chte man selber den f&uuml;r den Verweis
           benutzten Text bestimmen k&ouml;nnen, sollte das Element
           <sgmltag>link</sgmltag> verwendet werden. Im Gegensatz zu
           <sgmltag>xref</sgmltag> kann <sgmltag>link</sgmltag> Inhalt
           aufnehmen, der dann f&uuml;r den Verweis verwendet
           wird.</para>
 
 
 	<example>
 	  <title><sgmltag>link</sgmltag> beutzen</title>
 
           <para>F&uuml;r dieses Beispiel wird davon ausgegangen, dass
             es sich in dem Dokument befindet, das auch
             das <literal>id</literal>-Beispiel enth&auml;lt.</para>
 
 	  <programlisting><![ RCDATA [<para>Weitere Informationen k&ouml;nnen
   im <link linkend="kapitel1">ersten Kapitel</link> gefunden
   werden.</para>
 
 <para>Genauere Informationen k&ouml;nnen in
   <link linkend="kapitel1-unterkapitel1">diesem</link> Kapitel
   gefunden werden.</para>]]></programlisting>
 
           <para>Aus diesem SGML-Fragment w&uuml;rden die Stylesheets
             folgendes generieren (der hervorgehobene Text deutet den
             erzeugten Verweis an):</para>
 
 	  <blockquote>
             <para>Weitere Informationen k&ouml;nnen im <emphasis>ersten
                 Kapitel</emphasis> gefunden werden.</para>
 
             <para>Genauere Informationen k&ouml;nnen in
               <emphasis>diesem</emphasis> Kapitel gefunden
               werden.</para>
           </blockquote>
 	</example>
 
 	<note>
           <para>Das letzte Beispiel ist schlecht. Es sollten niemals
             W&ouml;rter wie <quote>dieses</quote> oder
             <quote>hier</quote> als Linktext benutzt werden. Solche
             W&ouml;rter zwingen den Leser dazu, den Kontext des
             Verweises zu lesen, um zu verstehen, wohin der Verweis
             f&uuml;hrt.</para>
 	</note>
 
 	<note>
           <para>Mit dem Element <sgmltag>link</sgmltag>
             <emphasis>kann</emphasis> auf mit
             <sgmltag>anchor</sgmltag> gekennzeichnete Stellen im
             Dokument verwiesen werden, da der Inhalt von
             <sgmltag>link</sgmltag> als Text f&uuml;r den Querverweise
             genutzt wird.</para>
 	</note>
       </sect3>
 
       <sect3>
 	<title>Verweise auf Dokumente im WWW</title>
 
         <para>Das Anlegen von Verweisen auf externe Dokumente ist
           wesentlich einfacher &ndash; solange die URL des zu
           referenzierenden Dokumentes bekannt ist. Um von einem
           bestimmten Textabschnitt auf das gew&uuml;nschte externe
           Dokument zu verweisen, muss die jeweilige Stelle mit
           dem Element <sgmltag>ulink</sgmltag> ausgezeichnet werden.
           Mittels des Attributes <literal>url</literal> kann die
           Adresse des Zieldokumentes angegeben werden. Bei der
           Umformung des Quelldokumentes in die verschiedenen
           Ausgabeformate wird der sich zwischen Start- und Endtag
           befindliche Text f&uuml;r den Verweis &uuml;bernommen, den
           der Leser aufrufen kann.</para>
 
 
 	<example>
 	  <title>Verweise mit <sgmltag>ulink</sgmltag></title>
 
           <!-- @todo Welchen Fall erforder anstatt? -->
 	  <programlisting><![ RCDATA [<para>Nat&uuml;rlich ist es m&ouml;glich, anstatt diesen Text
   weiterzulesen, sofort die
   <ulink url="&url.base;/de/index.html">FreeBSD-Homepage</ulink>
   aufzurufen.<para>]]></programlisting>
 
 	  <para>Darstellung:</para>
 
 	  <para>Nat&uuml;rlich ist es m&ouml;glich, anstatt diesen Text
             weiterzulesen, sofort die <ulink
             url="&url.base;/de/index.html">FreeBSD-Homepage</ulink>
             aufzurufen.<para>
 
 
 	</example>
       </sect3>
     </sect2>
   </sect1>
 </chapter>
 
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml b/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
index 13047befac..2ab00ca754 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
@@ -1,1970 +1,1970 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML, HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/sgml-primer/chapter.sgml,v 1.21 2008/10/31 21:09:02 jkois Exp $
-     basiert auf: 1.48
+     $FreeBSDde: de-docproj/books/fdp-primer/sgml-primer/chapter.sgml,v 1.22 2008/12/14 18:34:06 jkois Exp $
+     basiert auf: 1.49
 -->
 
 <!--?
 o SGML-Kontext sollte besser mit Umgebung uebersetzt werden.
 
 Oliver Fischer
 
 -->
 
 <chapter id="sgml-primer">
   <title>Die SGML-Fibel</title>
 
   <para>Die Mehrzahl der Dokumente des FDPs sind in SGML geschrieben.
     Ziel dieses Kapitels ist es, genau zu erkl&auml;ren, was
     das bedeutet und wie man die SGML-Quellen liest und versteht.
     Ebenso werden die in den Quellen genutzten Kniffe erkl&auml;rt,
     auf die man beim Lesen der Dokumente sto&szlig;en wird.</para>
 
   <para>Teile dieses Kapitels basieren auf Mark Galassis <quote><ulink
         url="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html">Get
         Going With DocBook</ulink></quote>.</para>
 
   <sect1 id="sgml-primer-overview">
     <title>&Uuml;berblick</title>
 
     <para>In den guten alten Zeiten war der Umgang mit
       <quote>elektronischem</quote> Text einfach. Man musste
       lediglich wissen, welcher Zeichensatz (ASCII, EBCDIC oder ein
       anderer) vorlag. Text war einfach Text und sah so aus, wie man
       ihn sah. Keine Extras, keine Formatierungen und kein sonstiger
       Schnickschnack.</para>
 
     <para>F&uuml;r viele Zwecke war dies allerdings nicht ausreichend.
       Von einem machinenlesbaren Text wird erwartet, dass er auch von
       Maschinen gelesen und intelligent weiterverarbeitet werden kann.
       Einzelne Stellen sollen hervorgehoben werden, andere sollen in ein
       Glossar aufgenommen werden oder auf andere Textstellen
       verweisen. Dateinamen wiederum sollen in einer
       <quote>schreibmaschinen&auml;hnlichen</quote> Schrift auf dem
       Bildschirm dargestellt werden, der Ausdruck soll jedoch in
       <quote>Schr&auml;gschrift</quote> oder in einer beliebigen anderen
       Darstellungsform erfolgen.</para>
 
     <para>Anf&auml;nglich gab es die Hoffnung, dass die
       K&uuml;nstliche Intelligenz (KI) helfen w&uuml;rde, dieses Ziel
       zu erreichen. Computer sollte den Text lesen und dazu in der Lage
       sein, selbstst&auml;ndig wichtige Formulierungen, Dateinamen,
       Benutzereingaben oder Beispiele zu erkennen.  Leider verlief die
       Entwicklung in diesem Bereich nicht wie gew&uuml;nscht und Computer
       ben&ouml;tigen nach wie vor etwas Unterst&uuml;tzung, bevor sie
       Texte vern&uuml;nftig verarbeiten k&ouml;nnen.</para>
 
     <para>Genauer gesagt, man muss ihnen sagen, was was ist. Sehen
       wir uns folgende Zeilen an:</para>
 
       <blockquote>
 	<para>L&ouml;schen Sie <filename>/tmp/foo</filename> mittels &man.rm.1;.</para>
 
 	<screen>&prompt.user; <userinput>rm /tmp/foo</userinput></screen>
       </blockquote>
 
     <para>Es f&auml;llt uns leicht, zu erkennen, was ein Dateiname, ein
       einzugebender Befehl oder ein Verweis auf eine Hilfeseite ist. Das
       kann ein Computer, der einen Text verarbeitet, nicht. Aus diesem
       Grund ist es notwendig, Texte mit weiteren Informationen
       <quote>auszuzeichnen</quote>.</para>
 
     <para>Der Begriff <quote>Auszeichnung<footnote> <para>Im
             angels&auml;chischschen Sprachraum wird von
             <quote>markup</quote>
             gesprochen.</para></footnote></quote> bedeutet, dass
       sich der Wert eines Textes erh&ouml;ht, aber auch seine Kosten.
       Durch Auszeichnungen wird einem Dokument zus&auml;tzlicher Text
       hinzugef&uuml;gt, der aber von dem eigentlichen Dokumenteninhalt
       auf eine bestimmte Art und Weise unterschieden werden kann, so
       dass Programme die Auszeichnung erkennen k&ouml;nnen und
       mittels dieser Informationen w&auml;hrend der Verarbeitung in
       der Lage sind, Entscheidungen zu treffen. Texteditoren
       k&ouml;nnen diese Auszeichnungselemente vor dem Benutzer
       verbergen, um zu vermeiden, dass er durch sie abgelenkt
       wird.</para>
 
     <!--<para><quote>Markup</quote> is commonly used to describe <quote>adding
     value</quote> or <quote>increasing cost</quote>.  The term takes on both
     these meanings when applied to text.  Markup is additional text included
     in the document, distinguished from the document's content in some way,
     so that programs that process the document can read the markup and use
     it when making decisions about the document.  Editors can hide the
     markup from the user, so the user is not distracted by it.</para>-->
 
 
     <para>Die durch die Auszeichnungselemente im Textdokument
       zus&auml;tzlich abgelegten Informationen erh&ouml;hen den Wert
       des Dokuments. Allerdings muss diese Arbeit in den meisten
       F&auml;llen von einem Menschen getan werden &ndash; w&auml;ren
       Maschinen dazu f&auml;hig, w&auml;ren zus&auml;tzliche
       Auszeichnungselemente unn&ouml;tig. Der damit verbundene Aufwand
       <emphasis>erh&ouml;ht die Kosten</emphasis>, die durch die
       Erstellung des Dokuments entstehen.</para>
 
     <para>Das etwas weiter oben gegebene Beispiel sieht im Quelltext
       so aus:</para>
 
     <programlisting><![ RCDATA [
 <para>L&ouml;schen Sie <filename>/tmp/foo</filename> mittels &man.rm.1;.</para>
 
 <screen>&prompt.user; <userinput>rm /tmp/foo</userinput></screen>]]></programlisting>
 
     <para>Die Auszeichnungselemente sind deutlich vom eigentlichen
       Inhalt zu unterscheiden.</para>
 
     <para>Die Einf&uuml;hrung von Auszeichnungselementen setzt voraus,
       dass festgelegt wird, welche Bedeutung einzelne Elemente haben
       und wie diese interpretiert werden.  Sie brauchen daher eine
       Auszeichnungssprache, der Sie folgen, wenn Sie eigene
       Dokumente verfassen.</para>
 
     <para>Nat&uuml;rlich kann es keine universelle
       Auszeichnungssprache geben und eine einzige mag nicht
       ausreichend f&uuml;r alle m&ouml;glichen Anwendungsf&auml;lle
       sein. Eine  Sprache f&uuml;r technische Dokumente wird sich
       wahrscheinlich stark von einer f&uuml;r Kochrezepte
       unterscheiden. Die universelle L&ouml;sung ist eine
       Basissprache, mit deren Hilfe weitere Sprachen entwickelt werden
       k&ouml;nnen &ndash; eine
       <emphasis>Meta-Auszeichungssprache</emphasis> also.</para>
 
     <para>Genau diese Anforderung wird von der Standard Generalized
       Markup Language (<abbrev>SGML</abbrev>) erf&uuml;llt. Mit ihrer
       Hilfe wurden viele andere Auszeichungssprachen wie
       beispielsweise HTML und DocBook, welche beide von FDP genutzt
       werden, entwickelt.</para>
 
     <para>Die eigentliche Sprachdefinition erfolgt in einer
       Dokumenten-Typ-Definition (DTD). Innerhalb dieser DTD werden die
       Namen der einzelnen Elemente, deren m&ouml;gliche Reihenfolge
       und Verschachtelung sowie weitere Informationen
       festgelegt.</para>
 
       <!-- Der letzte Satz dieses Absatzes muss noch &uuml;bersetzt werden.
       Ich habe keine gute &Uuml;bersetzung daf&uuml;r bis jetzt
       gefunden. Oliver Fischer -->
 
       <!--<para>Each language definition is more properly called a Document Type
       Definition (DTD).  The DTD specifies the name of the elements that can
       be used, what order they appear in (and whether some markup can be used
       inside other markup) and related information.  A DTD is sometimes
       referred to as an <emphasis>application</emphasis> of SGML.</para>-->
 
     <para id="sgml-primer-validating">Eine DTD ist eine
       <emphasis>vollst&auml;ndige</emphasis> Definition aller
       m&ouml;glichen Sprachelemente, ihrer
       Reihenfolge<footnote><para>Bei nat&uuml;rlichen Sprachen spricht
           man vom Satzbau  &ndash; demjenigen Konstrukt, das unter
           anderem die Position des Subjekts, Objekts und
           Pr&auml;dikats in einem Satz festlegt.</para></footnote>,
       optionaler Elemente und so weiter und so weiter. Dank dieser
       recht formalen Festlegung ist es m&ouml;glich,
       SGML-<emphasis>Parser</emphasis> zu entwickeln, die sowohl ein
       Dokument  als auch seine DTD einlesen und anhand dieser DTD
       pr&uuml;fen k&ouml;nnen, ob das Dokument allen Anforderungen der
       DTD entspricht. Dieser Vorgang wird allgemein als
       <emphasis>Validierung des Dokuments</emphasis>
       bezeichnet.</para>
 
     <note>
       <para>Das Validieren eines SGML-Dokuments gegen eine DTD
         &uuml;berpr&uuml;ft lediglich die korrekte Syntax des
         Dokuments, dass hei&szlig;t, ob nur g&uuml;ltige
         Auszeichnungselemente verwendet wurden und ihre Reihenfolge
         stimmt. Dabei wird <emphasis>nicht</emphasis> gepr&uuml;ft, ob
         die Elemente der DTD <emphasis>sinngem&auml;&szlig;</emphasis>
         verwandt wurden. Sollten beispielsweise alle Dateinamen als
         Funktionsnamen ausgezeichnet worden sein, so w&uuml;rde der
         Parser keinen Fehler signalisieren. Formaler ausgedr&uuml;ckt:
         Der Parser pr&uuml;ft die Syntax, aber nicht die
         Semantik.</para>
       </note>
 
     <para>Es ist anzunehmen, dass, wenn man selber vor hat
       Dokumentation f&uuml;r das FDP zu schreiben, der
       gr&ouml;&szlig;te Teil davon mit Hilfe von HTML oder DocBook
       geschrieben werden wird. Aus diesem Grunde wird an dieser Stelle
       nicht erkl&auml;rt, wie eine DTD entwickelt wird.</para>
     </sect1>
 
     <sect1 id="sgml-primer-elements">
     <title>Von Elementen, Tags und Attributen</title>
 
     <!-- Bei der &Uuml;bersetzung des ersten Satzes bin ich mir nicht
       sicher, ob es einee bessere gibt. Oliver Fischer -->
 
     <para>Alle in SGML geschriebenen DTDs haben bestimmte gemeinsame
       Eigenschaften. Das ist nicht verwunderlich, da sich die hinter
       SGML stehende Idee unweigerlich bemerkbar macht. <!--?
       Kandidat fuer ein Umformulierung. Oliver Fischer --> Zwei der
       markantesten Merkmale dieser Idee sind die Begriffe
       <emphasis>Inhalt</emphasis> und
       <emphasis>Element</emphasis>.</para>
 
     <!--<para>All the DTDs written in SGML share certain characteristics.  This is
     hardly surprising, as the philosophy behind SGML will inevitably show
     through. One of the most obvious manifestations of this philosophy is
     that of <emphasis>content</emphasis> and
     <emphasis>elements</emphasis>.</para>-->
 
     <!--? Vielleicht sollte man nicht von Elementen sondern von Teilen
     sprechen. Oliver Fischer -->
 
     <!--?
     Hier muss die endlose Rekursion noch besser zum Ausdruck kommen.
     -->
     <para>Von einem Dokument, unabh&auml;ngig, ob es sich um  eine
       einzelne Webseite oder ein langes Buch handelt, wird angenommen,
       dass es einen wie auch immer gearteten Inhalt hat. Dieser
       l&auml;sst sich selbst wiederum in Teilelemente
       aufspalten, die ebenso zerlegbar sind. Durch die Aufnahme von
       Auszeichnungselementen in einen Text, werden diese einzelnen
       Elemente eindeutig benannt und voneinander abgegrenzt.</para>
 
       <!--<para>Your documentation (whether it is a single web page, or a lengthy
       book) is considered to consist of content.  This content is then divided
       (and further subdivided) into elements.  The purpose of adding markup is
       to name and identify the boundaries of these elements for further
       processing.</para>-->
 
     <!--? Begriff Element erscheint hier ploetzlich. Sollte
     besser eingefuehrt werden. Oliver Fischer -->
 
     <para>Nimmt man zum Beispiel ein typisches Buch, so kann man es
       auf der obersten Ebene als ein Ganzes, als ein Element
       betrachten. Dieses <quote>Buch</quote>-Element enth&auml;lt nun
       Kapitel, die wiederum selbst als Elemente bezeichnet werden
       k&ouml;nnen. Jedes einzelne Kapitel enth&auml;lt weitere
       Elemente. So gibt es beispielsweise Abs&auml;tze, Zitate und
       Fu&szlig;noten. Jeder Absatz kann wiederum selbst Elemente
       enthalten, die helfen, den Absatzinhalt als direkte Rede oder
       als Namen eines der Protagonisten einer Geschichte zu
       identifizieren.</para>
 
     <para>Wenn man m&ouml;chte, kann man sich das als
       <quote>Unterteilung</quote><footnote><para>Im
           angels&auml;chsichen Sprachraum wird hier von
           <quote>chunking</quote> gesprochen.</para></footnote> des
       Inhalts vorstellen. Auf der obersten Ebene gibt es ein Element:
       das Buch selbst. Schaut man ein wenig tiefer, findet man weitere
       Teilelemente: die einzelnen Kapitel. Diese sind wiederum
       unterteilt in Abs&auml;tze, Fu&szlig;noten, Namen und so weiter
       und so weiter.</para>
 
     <para>Anzumerken ist an dieser Stelle, dass das eben gesagte
       ohne weiteres auf jeden Inhaltstyp angewandt werden kann, auch
       ohne dass von <acronym>SGML</acronym> die Rede ist. Man
       k&ouml;nnte beispielsweise einfach verschiedene Stifte nehmen
       und einen Ausdruck dieser Fibel vor sich hinlegen und dann mit
       verschiedenen Farben die einzelnen Abschnitte des Buchinhalts
       markieren.</para>
 
     <para>Leider gibt es  keinen elektronischen Stift, um das zu tun.
       Deshalb muss ein anderer Weg gew&auml;hlt werden, um zu
       bestimmen, zu welchem Element die einzelnen Inhalte
       geh&ouml;ren. In SGML-basierten Auszeichnungssprachen wie HTML
       und DocBook  werden daf&uuml;r so genannte
       <emphasis>Tags</emphasis> eingesetzt.</para>
 
     <para>Mit einem solchen Tag wird eindeutig festgelegt, wo ein
       bestimmtes Element beginnt und wo es endet. <emphasis>Allerdings
         geh&ouml;rt der Tag selber nicht zum Element.</emphasis> Er
       legt lediglich die Grenzen des Elements fest. Da jede DTD mit dem Ziel
       entwickelt wurde, einen speziellen Inhaltstyp auszuzeichnen,
       wird jede DTD verschiedene Elemente kennen, die daher
       nat&uuml;rlich auch unterschiedlich benannt sein werden.</para>
 
     <para>Der Starttag f&uuml;r ein imagin&auml;res Element mit dem
       Namen <replaceable>elementname</replaceable> ist
       <sgmltag>&lt;<replaceable>elementname</replaceable>&gt;</sgmltag>.
       Sein Gegenst&uuml;ck, der schlie&szlig;ende Endtag, ist
       <sgmltag>&lt;/<replaceable>elementname</replaceable>&gt;</sgmltag>.</para>
 
     <example>
       <title>Verwendung eines Elements (Start- und Endtag)</title>
 
       <para>HTML kennt das Element <sgmltag>p</sgmltag>, um
         festzulegen, dass ein bestimmter abgegrenzter Bereich
         einen Absatz darstellt. Dieses Element hat sowohl einen Start-
         als auch einen Endtag.</para>
 
       <programlisting><![ RCDATA [<p>Das ist ein Absatz. Er beginnt mit Starttag
   f&uuml;r das Element 'p' und endet mit dem Endtag f&uuml;r
   das Element 'p'.</p>
 
 <p>Das ist ein etwas k&uuml;rzerer Absatz.</p>]]></programlisting>
     </example>
 
     <para>Elemente m&uuml;ssen nicht notwendigerweise einen Endtag
       haben. Ebenso ist es nicht notwendig, dass Elemente einen
       Inhalt haben. Beispielsweise kann in HTML-Dokumenten mittels
       eines speziellen Elements festgelegt werden, dass eine
       horizontale Linie an einer bestimmten Stelle erscheinen soll. Da
       dieses Element offensichtlich keinen Inhalt hat, wird auch kein
       Endtag ben&ouml;tigt.</para>
 
     <example>
       <title>Verwendung eines Elements (nur Starttag)</title>
 
       <para>In HTML kann man mit dem Element <sgmltag>hr</sgmltag>
         festlegen, dass an einer bestimmten Stelle eine
         horizontale Linie angezeigt werden soll. Da dieses Element
         keinen Inhalt umschlie&szlig;t, hat es nur einen
         Starttag.</para>
 
       <programlisting><![ CDATA [<p>Das ist ein Abschnitt.</p>
 
 <hr>
 
 <p>Das ist ein weiterer Absatz. Eine horizontale Linie
   trennt ihn vom vorherigen Absatz.</p>]]></programlisting>
     </example>
 
     <para>Elemente k&ouml;nnen andere Elemente enthalten.  Im
       anfangs erw&auml;hnten Buch enthielt das Buch-Element
       alle Kapitel-Elemente, die wiederum alle Absatz-Elemente
       enthielten und so fort.</para>
 
     <example>
       <title>Verschachtelte Elemente: <sgmltag>em</sgmltag></title>
 
       <programlisting><![ RCDATA [<p>Das ist ein einfacher <em>Abschnitt</em>, in dem
   einige <em>Worte</em> <em>hervorgehoben</em> wurden.]]></programlisting>
     </example>
 
     <para>Welche Elemente andere Elemente enthalten k&ouml;nnen und
       welche das sind, wird innerhalb der DTD eines Dokuments
       festgelegt.</para>
 
     <!--
     <para>The DTD will specify the rules detailing which elements can contain
     other elements, and exactly what they can contain.</para>
     -->
 
     <important>
       <para>Viele Leute sind oft verwirrt, wenn es um die richtige
         Benutzung der Begriffe Tag und Element geht. Im Ergebnis werden
         sie oft so genutzt, als w&auml;ren sie austauschbar.
         Allerdings sind sie das nicht.</para>
 
       <para>Ein Element ist ein konzeptioneller Teil eines Dokuments
         und hat einen festgelegten Anfang und ein festgelegtes
 	Ende. Ein Tag hingegen markiert die Stelle, an der ein Element
 	beginnt und endet.</para>
 
       <para>Wenn in diesem Dokument vom <quote>Tag <sgmltag>p</sgmltag></quote>
         gesprochen wird, ist damit der Text
         gemeint, der aus den drei Zeichen <literal>&lt;</literal>,
         <literal>p</literal> und <literal>&gt;</literal> besteht. Wird
         hingegen von dem <quote>Element <sgmltag>p</sgmltag></quote>
         gesprochen, ist damit das gesamte Element gemeint.</para>
 
       <para>Diese Unterscheidung ist sicherlich subtil. Trotzdem
         sollte man sie sich vergegenw&auml;rtigen.</para>
     </important>
 
     <para>Elemente k&ouml;nnen selber Attribute haben, die aus einem
       Namen und einem Wert bestehen.  Die Attribute haben die Aufgabe,
       dem Element zus&auml;tzliche Informationen hinzuzuf&uuml;gen.
       Denkbar sind hier Festlegungen &uuml;ber die Darstellung,
       Bezeichner, &uuml;ber die das Element eindeutig identifiziert
       werden kann, oder beliebige andere Informationen.</para>
 
     <para>Elementattribute werden in den <emphasis>Starttag</emphasis>
       eingef&uuml;gt und haben die Form
       <literal><replaceable>Attributename</replaceable>="<replaceable>Wert</replaceable>"</literal>.</para>
 
     <para>Bei einigen HTML-Versionen kennt das Element
       <sgmltag>p</sgmltag> das Attribut <sgmltag>align</sgmltag>, mit
       dessen Hilfe die Textausrichtung eines Absatzes bestimmt werden
       kann.</para>
 
     <para><literal>align</literal> akzeptiert einen von vier
       vorgegebenen Werten: <literal>left</literal>,
       <literal>center</literal>, <literal>right</literal> und
       <literal>justify</literal>. Ist <literal>align</literal> nicht
       angegeben, wird vom Standardwert <literal>left</literal>
       ausgegangen.</para>
 
     <example>
       <title>Elemente mit Attributen nutzen</title>
 
       <programlisting><![ RCDATA [<p align="left">Die Verwendung des align-Attributs
   f&uuml;r diesen Absatz ist &uuml;berfl&uuml;ssig, da left
   der Standardwert ist.</p>
 
 <p align="center">Dieser Absatz wird hoffentlich mittig dargestellt.</p>]]></programlisting>
     </example>
 
     <para>Einige Attribute akzeptieren nur bestimmte Werte, wie
       beispielsweise <literal>left</literal> oder
       <literal>justify</literal>. Andere akzeptieren jeden beliebigen
       Wert. Enth&auml;lt Attributwert doppelte Anf&uuml;hrungszeichen
       (<literal>"</literal>), wird der Wert in einfachen
       Anf&uuml;hrungszeichen eingeschlossen.</para>
 
     <example>
       <title>Attribute mit einfachen Anf&uuml;hrungszeichen</title>
 
       <programlisting><![ CDATA [<p align='right'>Ich stehe rechts!</p>]]></programlisting>
     </example>
 
 
     <para>Manchmal k&ouml;nnen die Anf&uuml;hrungszeichen um den
       Attributwert weggelassen werden.  Allerdings sind die Regeln,
       die festlegen wann dies zul&auml;ssig ist, sehr spitzfindig.
       Am besten schlie&szlig;en Sie Attributwerte
       <emphasis>immer</emphasis> in Anf&uuml;hrungszeichen ein.</para>
 
     <para>Die Informationen &uuml;ber Attribute, Elemente und Tags
       sind in SGML-Katalogen abgelegt und werden von den verschiedenen
       Werkzeugen des Dokumentationsprojektes genutzt, um die
       geschriebenen Dokumente zu validieren. Die Programme die durch
       <filename role="package">textproc/docproj</filename> installiert
       werden, bringen ihre eigenen Katalogvarianten mit, zudem pflegt
       das FDP seine  eigenen Kataloge. Beide Katalogarten m&uuml;ssen
       von allen Programmen gefunden werden k&ouml;nnen.</para>
 
     <sect2>
       <title>Was daf&uuml;r getan werden muss;&hellip;</title>
 
       <para>Damit die Beispiele dieser Fibel ausgef&uuml;hrt werden
         k&ouml;nnen, ist es notwendig, dass einige Programme auf
         dem Rechner installiert sind und das eine Umgebungsvariable
         korrekt gesetzt wird.</para>
 
       <procedure>
         <step>
           <para>Der erste Schritt ist die Installation des Ports
             <filename role="package">textproc/docproj</filename>
             &uuml;ber das FreeBSD-Portsystem. <filename
               role="package">textproc/docproj</filename> ist ein
             <emphasis>Metaport</emphasis>, der alle vom FDP
             ben&ouml;tigten Programme und Daten aus dem Netz laden und
             installieren sollte.</para>
         </step>
 
         <step>
           <para>Anschlie&szlig;end muss in den Shellkonfigurationsdateien die
             Variable <envar>SGML_CATALOG_FILES</envar>
             <footnote><simpara>Sofern man nicht an der deutschen
                 Dokumentation arbeitet, m&uuml;ssen die
                 Verzeichnisangaben entsprechend angepasst
                 werden.</simpara>
               </footnote> gesetzt werden.</para>
 
             <example id="sgml-primer-envars">
               <title><filename>.profile</filename>, f&uuml;r &man.sh.1; und
                 &man.bash.1; Benutzer</title>
 
               <programlisting>SGML_ROOT=/usr/local/share/sgml
 SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog
 SGML_CATALOG_FILES=${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=/usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=/usr/doc/de_DE.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES
 export SGML_CATALOG_FILES</programlisting>
             </example>
             <!--?
               Hier muesste geprueft werden, ob sich die letzten beiden Zeilen
               vertragen oder nicht. Gibt es Entitaeten, die in beiden
               vorhanden sind, aber unterschiedliche Uebersetzungen haben?
 
               Oliver Fischer
             -->
 
           <example>
             <title><filename>.cshrc</filename>, f&uuml;r &man.csh.1;- und
               &man.tcsh.1;-Benutzer</title>
 
             <programlisting>setenv SGML_ROOT /usr/local/share/sgml
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES /usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES /usr/doc/de_DE.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES</programlisting>
             </example>
 
           <para>Damit die &Auml;nderungen wirksam werden, meldet man
             sich ab und anschlie&szlig;end wieder an &ndash; oder man
             f&uuml;hrt die obigen Anweisungen direkt in der Shell
             aus und setzt so die ben&ouml;tigten Umgebungsvariablen.</para>
 
         </step>
       </procedure>
 
       <procedure>
         <step>
           <para>Nun sollte man eine Datei
             <filename>beispiel.sgml</filename> anlegen, die den
             folgenden Text enth&auml;lt:</para>
 
             <programlisting><![ RCDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 
 <html>
   <head>
     <title>Eine Beispieldatei in HTML</title>
   </head>
 
   <body>
     <p>Das ist ein Absatz mit etwas Text.</p>
 
     <p>Das ist ein Absatz mit anderem Text.</p>
 
     <p align="right">Dieser Absatz wird rechtsb&uuml;ndig
       ausgerichtet.</p>
   </body>
 </html>]]></programlisting>
         </step>
 
         <step>
           <para>Nachdem die Datei abgespeichert wurde, kann sie
             mit Hilfe eines SGML-Parsers validiert werden.</para>
 
           <para>Bestandteil von <filename role="package">textproc/docproj</filename>
             ist <command>nsgmls</command> - ein <link
             linkend="sgml-primer-validating">validierender Parser</link>.
             <command>nsgmls</command> liest ein Dokument entsprechend einer SGML-DTD
             ein und gibt anschlie&szlig;end ein Element-Structure-Information-Set
             (ESIS) aus. Allerdings ist das an dieser Stelle nicht weiter
             wichtig.</para>
 
           <para>Wird <command>nsgmls</command> mit der Option <option>-s</option>
             aufgerufen, werden nur Fehlermeldungen ausgegeben. Dadurch
             kann leicht gepr&uuml;ft werden, ob ein Dokument g&uuml;ltig
             ist oder nicht.</para>
 
           <para>So pr&uuml;ft man mit <command>nsgmls</command>, ob die neuangelegte
             Beispieldatei g&uuml;ltig ist:</para>
 
             <screen>&prompt.user; <userinput>nsgmls -s beispiel.sgml</userinput></screen>
 
           <para>Sofern das Beispiel korrekt abgetippt wurde, wird sich
             <command>nsgmls</command> ohne jegliche Ausgabe beenden. Das bedeutet,
             dass das Dokument erfolgreich validiert werden konnte
             und somit g&uuml;ltig ist.</para>
         </step>
 
         <step>
           <para>Jetzt sollten die Tags <sgmltag>title</sgmltag> und
             <sgmltag>/title</sgmltag> aus dem Dokument gel&ouml;scht
             und das Dokument erneut validiert werden:</para>
 
             <screen>&prompt.user; <userinput>nsgmls -s beispiel.sgml</userinput>
 nsgmls:beispiel.sgml:5:4:E: character data is not allowed here
 nsgmls:beispiel.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
 
           <para>Die Fehlermeldungen, die von <command>nsgmls</command>
 	    ausgegeben werden, sind in durch Doppelpunkte getrennte
 	    Spalten unterteilt.</para>
 
           <informaltable frame="none" pgwide="1">
             <tgroup cols="2">
               <thead>
                 <row>
                   <entry>Spalte</entry>
                   <entry>Bedeutung</entry>
                 </row>
               </thead>
 
               <tbody>
                 <row>
                   <entry>1</entry>
                   <entry>Der Name des Programms, das den Fehler
                     meldet. Hier wird immer <literal>nsgmls</literal>
                     stehen.</entry>
                 </row>
 
                 <row>
                   <entry>2</entry>
                   <entry>Der Name der fehlerhaften Datei.</entry>
                 </row>
 
                 <row>
                   <entry>3</entry>
                   <entry>Die Zeilennummer des Fehlers.</entry>
                 </row>
 
                 <row>
                   <entry>4</entry>
                     <entry>Die Spaltenummer des Fehlers.</entry>
                 </row>
 
                 <row>
                   <entry>5</entry>
                   <entry>Ein einbuchstabiger Code, der &uuml;ber die
                     Art des Fehlers informiert. <literal>I</literal>
                     steht f&uuml;r eine informelle Meldung,
                     <literal>W</literal> f&uuml;r eine Warnung und
                     <literal>E</literal> f&uuml;r Fehler<footnote>
                       <para>Nicht immer besteht eine Meldung aus
                         f&uuml;nf Spalten. Die Ausgabe von
                         <command>nsgmls -sv</command> ist
                         beispielsweise <literal>nsgmls:I: SP version
                           "1.3"</literal> (nat&uuml;rlich
                         abh&auml;ngig von der Version). Wie man sehen
                         kann, handelt es sich hier um eine informelle
                         Meldung.</para>
                     </footnote> und <literal>X</literal> f&uuml;r
                     einen Querverweis. Bei den oben stehenden Ausgaben
                     handelt es sich also um Fehlermeldungen.</entry>
                   </row>
 
                 <row>
                   <entry>6</entry>
                   <entry>Die Meldung.</entry>
                 </row>
               </tbody>
             </tgroup>
           </informaltable>
 
           <para>Durch das Weglassen des Tags <sgmltag>title</sgmltag>
             sind zwei unterschiedliche Fehler entstanden.</para>
 
           <para>Der erste Fehler besagt, dass Inhalt (in diesem
             Falle Zeichen anstatt eines Starttags) an einer Stelle
             gefunden wurde, an der der Parser etwas anderes erwartet
             hat. Genauer gesagt wurde der Starttag eines Elements
             erwartet, das innerhalb von <sgmltag>head</sgmltag>
             auftreten kann.</para>
 
           <para>Der zweite Fehler wurde dadurch verursacht, dass
             das Element <sgmltag>head</sgmltag> ein
             Element <sgmltag>title</sgmltag> enthalten
             <emphasis>muss</emphasis> und <command>nsgmls</command>
             nicht ber&uuml;cksichtigt, dass dieser Fehler auf dem
             vorhergehenden beruht. Es wird lediglich festgestellt,
             dass der Endtag von <sgmltag>head</sgmltag> auftritt,
 	    obwohl nicht alle notwendigen Elemente vorhanden sind.</para>
         </step>
 
         <step>
           <para>Zum Schlu&szlig; sollte der Tag
             <sgmltag>title</sgmltag> wieder in die Beispieldatei
             eingef&uuml;gt werden.</para>
           </step>
         </procedure>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-doctype-declaration">
     <!--? Oliver Fischer: Man sollte mal feststellen, welche Bezeichung
     von w3c.de oder so hier verwendet wird.-->
     <title>Die DOCTYPE-Deklaration</title>
 
     <para>Am Anfang jedes Dokuments muss der Name der dem
       Dokument zugrundeliegenden DTD angegeben werden. Mit Hilfe
       dieser Information k&ouml;nnen SGML-Parser die verwendete DTD
       feststellen und pr&uuml;fen, ob das Dokument zu ihr konform ist.</para>
 
     <para>&Uuml;blicherweise steht diese Information in einer Zeile,
       die als DOCTYPE-Deklaration bezeichnet wird.</para>
 
 
     <para>Eine Deklaration f&uuml;r ein HTML-Dokument, das nach den
       Vorgaben der DTD f&uuml;r HTML 4.0 geschrieben wurde, sieht so
       aus:</para>
 
     <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN">]]></programlisting>
 
     <para>und besteht aus verschiedenen Teilen.</para>
 
     <!--<para>That line contains a number of different components.</para>-->
 
     <!--?
     Hier bin ich mir nicht sicher, ob ich genau &uuml;bersetzt habe oder
     das Orginal sprachlich ungenau ist. Man sollte hier mal
     in den Standardspezikationen nachschlagen und gegebenenfalls
     das Orginal korrigieren.
     Oliver Fischer
     -->
 
     <variablelist>
       <varlistentry>
         <term><literal>&lt;!</literal></term>
 
         <listitem>
           <para>Die Zeichenkette <literal>&lt;!</literal> dient hier
             als <emphasis>Indikator</emphasis>, dass es sich bei
             diesem Ausdruck um eine SGML-Deklaration handelt und diese
             Zeile den Dokumententyp festlegt.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><literal>DOCTYPE</literal></term>
 
         <listitem>
           <para>Zeigt an, dass dies die SGML-Deklaration f&uuml;r
             den Dokumententyp ist.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><literal>html</literal></term>
 
         <listitem>
           <para>Nennt das erste <link
               linkend="sgml-primer-elements">Element</link>, das im
             Dokument auftaucht.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><literal>PUBLIC "-//W3C//DTD HTML 4.0//EN"</literal></term>
 
         <listitem>
           <para>Nennt den Formalen &Ouml;ffentlichen Bezeichner
             <footnote>
               <simpara>auf Englisch <foreignphrase>Formal Public
                   Identifier (FPI) </foreignphrase></simpara>
             </footnote> der DTD des Dokuments. Diese Information wird
             von SGML-Parsern ausgewertet, um die von dem Dokument
             referenzierte DTD zu bestimmen.</para>
 
           <para>Das Schl&uuml;sselwort <literal>PUBLIC</literal>
             geh&ouml;rt nicht zum &ouml;ffentlichen Bezeichner,
             sondern legt fest, wie ein SGML-Parser die DTD finden
             kann. Alternative Wege eine DTD zu referenzieren werden
             <link linkend="sgml-primer-fpi-alternatives">sp&auml;ter
               gezeigt</link>.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><literal>&gt;</literal></term>
 
         <listitem>
           <para>Schlie&szlig;t den mit <literal>&lt;!</literal> begonnenen
             Ausdruck ab.</para>
         </listitem>
       </varlistentry>
     </variablelist>
 
     <sect2>
       <title>Formale &Ouml;ffentliche Bezeichner</title>
 
       <!--? -->
       <note>
         <para>Dieser Abschnitt braucht nicht unbedingt zu gelesen zu
           werden. Dennoch ist es empfehlenswert, da er n&uuml;tzliche
           Hintergrundinformationen enth&auml;lt, die hilfreich sein
           k&ouml;nnen, falls der SGML-Prozessor die genutzte DTD nicht
           finden kann.</para>
       </note>
 
       <para>Jeder &ouml;ffentliche Bezeichner muss eine bestimmte Syntax
         haben, die wie folgt lautet:</para>
 
       <!-- Oliver Fischer: Ich habe hier Owner mit Besitzer uebersetzt.
       Mein Gef&uuml;hl sagt mir, dass dies nicht 100% richtig ist.
       Vielleicht ist Aussteller bessert? -->
 
       <programlisting>"<replaceable>Besitzer</replaceable>//<replaceable>Schl&uuml;sselwort</replaceable> <replaceable>Beschreibung</replaceable>//<replaceable>Sprache</replaceable>"</programlisting>
 
       <variablelist>
         <varlistentry>
           <term><replaceable>Besitzer</replaceable></term>
 
           <listitem>
             <para>Nennt den Besitzer des &ouml;ffentlichen Bezeichners.</para>
 
             <para>Falls diese Zeichenkette mit <quote>ISO</quote>
               beginnt, geh&ouml;rt der Bezeichner dem ISO-Kommitee.
               Der Bezeichner <literal>"ISO 8879:1986//ENTITIES Greek
                 Symbols//EN"</literal> nennt <quote>ISO
                 8879:1986</quote> als den Besitzer des Satzes von
               Entit&auml;ten f&uuml;r griechische Zeichen. ISO
               8879:1986 ist die ISO-Bezeichnung f&uuml;r den
               SGML-Standard.</para>
 
 
             <!--? Die Formulierung gef&auml;llt mir nicht. Oliver Fischer -->
             <para>Beginnt die Zeichenkette nicht mit
               <quote>ISO</quote>, sieht sie entweder so
               <literal>-//<replaceable>Besitzer</replaceable></literal>
               oder so
               <literal>+//<replaceable>Besitzer</replaceable></literal>
               aus. Beide Varianten unterscheiden sich also nur durch
               das anf&auml;ngliche <literal>+</literal> bzw.
               <literal>-</literal>.</para>
 
             <para>Sofern am Anfang ein <literal>-</literal> steht, ist
               der Bezeichner nicht &ouml;ffentlich registriert, steht
               hingegen ein <literal>+</literal> am Anfang, ist er
               registriert.</para>
 
 
             <!--? Vielleicht besser: Wie Namen registeriert werden?
             Oliver Fischer -->
             <!--? Mit der &Uuml;bersetzung des letzten Satzes bin ich mir
             nicht sicher.... Das muss irgendwie besser ausgedr&uuml;ckt
             werden.... -->
 
             <para>Im ISO-Standard ISO 9070:1991 wurde festgelegt, wie
               registrierte Namen erzeugt werden k&ouml;nnen. Unter
               anderem k&ouml;nnen sie von den Bezeichnungen von
               ISO-Publikationen, von ISBN-Nummern oder einer
               Organisationsbezeichnungen entsprechend ISO 6523
               abgeleitet werden. Antr&auml;ge f&uuml;r neue offiziell
               registrierte Bezeichner werden vom ISO-Kommitee an das
               American National Standards Institute (ANSI)
               weitergeleitet.</para>
 
 
 
             <!--?
             Eine Zeichenkette kann kein Besitzer sein.
             Wie koennte man das besser ausdruecken?
             -->
 
             <para>Da das FreeBSD-Projekt seine Bezeichner nicht hat
               registrieren lassen, ist der Besitzer
               <literal>-//FreeBSD</literal>. Unter anderem kann man
               daran auch sehen, dass das W3C sich nicht hat
               registrieren lassen.</para>
 
           </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><replaceable>Schl&uuml;sselwort</replaceable></term>
 
           <listitem>
             <para>Es gibt verschiedene Schl&uuml;sselw&ouml;rter mit
               denen man die Art der gegebenen Informationen beschreiben
               kann. Einige der &uuml;blichsten sind
               <literal>DTD</literal>, <literal>ELEMENT</literal>,
               <literal>ENTITIES</literal> und <literal>TEXT</literal>.
               <literal>DTD</literal> wird nur f&uuml;r Dateien mit
               DTDs verwandt, <literal>ELEMENT</literal> findet
               f&uuml;r Dateien mit Fragmenten von DTDs Verwendung, die
               nur Deklarationen f&uuml;r Entit&auml;ten und Elemente
               enthalten. <literal>TEXT</literal> wird f&uuml;r
               SGML-Inhalte (Texte und Tags) verwendet.</para>
           </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><replaceable>Beschreibung</replaceable></term>
 
           <listitem>
             <para>Eine frei w&auml;hlbare Beschreibung des Inhalts der
               referenzierten Datei. M&ouml;glich sind hier
               Versionsnummern oder ein kurzer und sinnvoller Text, der
               innerhalb der SGML-Welt eindeutig ist.</para>
 
           </listitem>
         </varlistentry>
 
         <varlistentry>
           <term><replaceable>Sprache</replaceable></term>
 
           <listitem>
             <para>Ein ISO-Code aus zwei Buchstaben, der die f&uuml;r
               die Datei verwendete Sprache nennt.
               <literal>EN</literal> steht hier f&uuml;r Englisch,
               <literal>DE</literal> f&uuml;r Deutsch.</para>
           </listitem>
         </varlistentry>
       </variablelist>
 
       <sect3>
         <title>Die <filename>catalog</filename>-Dateien</title>
 
         <para>Wenn man die oben beschriebene Syntax f&uuml;r
           Bezeichner verwendet und ein Dokument durch einen
           SGML-Prozessor schickt, muss dieser die
           M&ouml;glichkeit haben, den Bezeichner auf eine real
           existierende Datei abzubilden, die die ben&ouml;tigte DTD
           enth&auml;lt.</para>
 
         <para>Einer der m&ouml;glichen Wege hierf&uuml;r sind
           Katalogdateien. Eine solche Datei, die &uuml;blicherweise
           <filename>catalog</filename> hei&szlig;t, besteht aus
           einzelnen Zeilen, die Bezeichner auf Dateinamen abbilden.
           Enth&auml;lt ein Katalog beispielsweise die Zeile</para>
 
         <programlisting>PUBLIC "-//W3C//DTD HTML 4.0//EN"             "4.0/strict.dtd"</programlisting>
 
         <para>kann ein SGML-Prozessor dar&uuml;ber feststellen, dass die
           ben&ouml;tigte DTD in der Datei <filename>strict.dtd</filename>
           im Unterverzeichnis <filename class="directory">4.0</filename>
           des Verzeichnisses des Katalogs zu finden ist.</para>
 
         <para>Ein gutes Beispiel f&uuml;r einen Katalog ist
           <filename>/usr/local/share/sgml/html/catalog</filename>.
           Diese Datei enth&auml;lt den Katalog f&uuml;r alle HTML
           DTDs, die im Zuge der Installation von <filename
             role="package">textproc/docproj</filename> installiert
           wurden.</para>
 
       </sect3>
 
       <sect3>
         <title>Die Variable <envar>SGML_CATALOG_FILES</envar></title>
 
         <para>Nat&uuml;rlich muss einem SGML-Prozessor noch
           mitgeteilt werden k&ouml;nnen, wo er seine Kataloge finden
           kann. Viele Programme bieten hierf&uuml;r
           Kommandozeilenoptionen an, &uuml;ber die man einen oder
           mehrere Kataloge angeben kann.</para>
 
         <para>Zus&auml;tzlich besteht noch die M&ouml;glichkeit mit
           der Umgebungsvariablen <envar>SGML_CATALOG_FILES</envar> auf
           SGML-Kataloge zu verweisen. Die Eintr&auml;ge von
           <envar>SGML_CATALOG_FILES</envar> m&uuml;ssen aus den
           vollst&auml;ndigen Pfadnamen der Kataloge, jeweils durch
           Komma getrennt, bestehen.</para>
 
 
         <!--? Stimmt die Formulierung? Oliver Fischer -->
         <para>&Uuml;blicherweise werden die folgenden Kataloge &uuml;ber
             <envar>SGML_CATALOG_FILES</envar> f&uuml;r
           die Arbeit an den Dokumenten des FDPs eingebunden:</para>
 
         <itemizedlist>
           <listitem>
             <para><filename>/usr/local/share/sgml/docbook/4.1/catalog</filename></para>
           </listitem>
 
           <listitem>
             <para><filename>/usr/local/share/sgml/html/catalog</filename></para>
           </listitem>
 
           <listitem>
             <para><filename>/usr/local/share/sgml/iso8879/catalog</filename></para>
           </listitem>
 
           <listitem>
             <para><filename>/usr/local/share/sgml/jade/catalog</filename></para>
           </listitem>
         </itemizedlist>
 
         <para>Allerdings sollte das
           <link linkend="sgml-primer-envars">schon geschehen
             sein</link>.</para>
 
       </sect3>
     </sect2>
 
     <sect2 id="sgml-primer-fpi-alternatives">
       <title>Alternativen zu Formalen &Ouml;ffentlichen Bezeichnern</title>
 
       <para>Anstatt mit einem Bezeichner die zum Dokument
         geh&ouml;rende DTD zu referenzieren, kann auch explizit auf
         die Datei der DTD verwiesen werden.</para>
 
       <para>Die Syntax des DOCTYPE-Deklaration ist in diesem Falle
         anders:</para>
       <!--<para>The syntax for this is slightly different:</para>-->
 
       <programlisting><![ RCDATA [<!DOCTYPE html SYSTEM "/pfad/zur/dokumenten.dtd">]]></programlisting>
 
       <para>Das Schl&uuml;sselwort <literal>SYSTEM</literal> legt
         fest, dass ein SGML-Prozessor die DTD auf
         <quote>systemspezifische</quote> Art und Weise bestimmen soll.
         Meistens, aber nicht immer, wird so auf eine Datei im
         Dateisystem verwiesen.</para>
 
       <para>Allerdings sollte man &ouml;ffentliche Bezeichner aus
         Gr&uuml;nden der Portabilit&auml;t bevorzugen, da man so
         nicht eine Kopie der DTD mit dem Dokument selber verteilen
         muss, beziehungsweise da man, wenn man mit
         <literal>SYSTEM</literal> arbeitet, nicht davon ausgehen kann,
         dass  die ben&ouml;tigte DTD auf anderen Systemen genau
         unter dem gleichen Pfad verf&uuml;gbar ist.</para>
 
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-sgml-escape">
     <title>Die R&uuml;ckkehr zu SGML</title>
 
     <para>An einer fr&uuml;heren Stelle wurde erw&auml;hnt, dass
       man SGML nur ben&ouml;tigt, falls man selbst eine DTD entwickeln
       m&ouml;chte. Genaugenommen ist das nicht 100%ig richtig. Einige
       Teile der SGML-Syntax k&ouml;nnen auch in normalen Dokumenten
       verwendet werden, falls dies gew&uuml;nscht oder notwendig
       ist.</para>
 
     <para>In diesem Falle muss daf&uuml;r Sorge getragen werden,
       dass ein SGML-Prozessor feststellen kann, dass ein
       bestimmter Abschnitt des Inhalts SGML ist, das er verarbeiteten
       muss.</para>
 
     <para>Solche SGML-Abschnitte werden mittels
       <literal>&lt;!&nbsp;...&nbsp;&gt;</literal> in Dokumenten
       besonders gekennzeichnet. Alles, was sich zwischen diesen
       Begrenzungen befindet, ist SGML, wie es auch in DTDs gefunden
       werden kann.</para>
 
     <para>Demnach ist die <link
         linkend="sgml-primer-doctype-declaration">DOCTYPE-Deklaration</link>
       ein gutes Beispiel f&uuml;r SGML, das in Dokumenten verwendet
       werden muss&hellip;</para>
 
   </sect1>
 
   <sect1 id="sgml-primer-comments">
     <title>Kommentare</title>
 
     <para>Kommentare sind SGML-Konstrukte, die normalerweise nur
       in DTDs g&uuml;ltig sind. Dennoch ist es, wie in
       <xref linkend="sgml-primer-sgml-escape"> gezeigt,
       m&ouml;glich Fragmente mit SGML-Syntax in Dokumenten zu
       verwenden.</para>
 
     <para>Zum Abgrenzen von SGML-Kommentaren wird ein doppelter
       Bindestrich <quote><literal>--</literal></quote> verwendet. Mit
       seinem ersten Auftreten &ouml;ffnet er einen Kommentar, mit
       seinem zweiten schlie&szlig;t er ihn wieder.</para>
 
     <example>
       <title>Beispiele f&uuml;r Kommentare in SGML</title>
 
       <programlisting>&lt;!-- Testkommentar --></programlisting>
 
       <programlisting><![ RCDATA [
 <!-- Text innerhalb eines Kommentars -->
 
 <!-- Ein anderer Kommentar    -->
 
 <!-- So k&ouml;nnen mehrzeilige Kommentare
      genutzt werden -->
 
 <!-- Eine andere M&ouml;glichkeit f&uuml;r --
   -- mehrzeilige Kommentare.     -->]]></programlisting>
     </example>
 
     <!--? Noch zu uebersetzen. Oliver Fischer -->
     <![ %output.print; [
       <important>
 	<title>Es sind zwei Bindestriche</title>
 
 	<para>Es gibt ein Problem mit den PostScript- oder
 	  PDF-Versionen dieses Dokuments.  Das obige Beispiel
 	  zeigt vielleicht nur einen Bindestrich (<literal>-</literal>)
 	  hinter <literal>&lt;!</literal> und vor
 	  <literal>&gt;</literal>.</para>
 
 	<para>Es <emphasis>m&uuml;ssen</emphasis> zwei Bindestriche
 	  und <emphasis>nicht</emphasis> nur einer benutzt werden.
 	  Die PostScript- und PDF-Versionen haben vielleicht
 	  beide Bindestriche zu einem l&auml;ngeren Strich, dem
 	  <emphasis>em-dash</emphasis>, zusammengefasst.</para>
 
 	<para>Die HTML-, nur-Text und RTF-Versionen dieses Dokuments
 	  sind nicht von diesem Problem betroffen.</para>
       </important>
     ]]>
 
     <para>Hat man fr&uuml;her schon Erfahrungen mit HTML gesammelt,
       wird man vielleicht andere Regeln f&uuml;r den Gebrauch von
       Kommentaren kennengelernt haben. Beispielsweise wird oft
       angenommen, dass Kommentare mit <literal>&lt;!--</literal>
       begonnen und nur mit <literal>--&gt;</literal> beendet
       werden.</para>
 
     <para>Dies ist <emphasis>nicht</emphasis> der Fall. Viele
       Webbrowser haben fehlerhafte HTML-Parser, die dies akzeptieren.
       Die SGML-Parser, die vom FDP verwendet werden, halten sich
       strenger an die SGML-Spezifikation und verwerfen Dokumente mit
       solchen Fehlern.</para>
 
     <example>
       <title>Fehlerhafte SGML-Kommentare</title>
 
       <programlisting><![ RCDATA [
 <!-- Innerhalb eines Kommentars --
 
      DIES IST NICHT TEIL EINES KOMMENTARS
 
   -- Wieder innerhalb eines Kommentars -->]]></programlisting>
 
       <para>SGML-Parser w&uuml;rden die mittlere Zeile wie folgt
         interpretieren:</para>
       <!--<para>The SGML parser will treat this as though it were actually;</para>-->
 
       <programlisting>&lt;!DIES IST NICHT TEIL EINES KOMMENTARS&gt;</programlisting>
 
       <para>Da es sich hierbei nicht um g&uuml;ltiges SGML handelt, kann
         diese Zeile zur verwirrenden  Fehlermeldungen f&uuml;hren.</para>
 
       <programlisting><![ CDATA [<!--------------- Eine wirklich schlechte Idee  --------------->]]></programlisting>
 
       <para>Wie das Beispiel zeigt, sollten solche Kommentare
         tunlichst vermieden werden.</para>
 
       <!--<para>As the example suggests, <emphasis>do not</emphasis> write
       comments like that.</para>-->
 
       <programlisting><![ RCDATA [<!--===================================================-->]]></programlisting>
 
       <para>Ein solcher Kommentar ist (ein wenig) besser, kann aber
         jemanden, der mit SGML noch nicht so vertraut ist,
         verwirren.</para>
 
     </example>
 
     <sect2>
       <title>Finger&uuml;bungen&hellip;</title>
 
       <procedure>
         <step>
           <para>Zur &Uuml;bung k&ouml;nnen Sie einige Kommentare in
             die Datei <filename>beispiel.sgml</filename> einf&uuml;gen
             und &uuml;berpr&uuml;fen, ob die Datei nun noch erfolgreich
             von <command>nsgmls</command> validiert werden kann.</para>
         </step>
 
         <step>
           <para>Zu Testzwecken sollten Sie
             auch noch ein paar fehlerhafte Kommentare hinzuf&uuml;gen
             und sich die resultierenden Fehlermeldungen von
 	    <command>nsgmls</command> ansehen.</para>
         </step>
       </procedure>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-entities">
     <title>Entit&auml;ten</title>
 
     <para>Entit&auml;ten stellen einen Mechanismus dar, mit dem
       einzelnen Dokumententeilen  ein Name zugewiesen werden kann.
       Findet ein SGML-Parser w&auml;hrend des Parsens eine
       Entit&auml;t, ersetzt er diese durch den ihr zugewiesenen
       Inhalt.</para>
 
     <para>Dadurch steht eine einfache M&ouml;glichkeit zur
       Verf&uuml;gung, mit der  variabler Inhalt in SGML-Dokumenten
       eingebunden werden kann. Zus&auml;tzlich sind Entit&auml;ten der
       einzige Weg, &uuml;ber den eine Datei in eine andere Datei mit
       SGML-Mitteln eingebunden werden kann.</para>
 
     <para>Es werden zwei Arten von Entit&auml;ten unterschieden:
       <emphasis>Allgemeine Entit&auml;ten</emphasis> und
       <emphasis>Parameterentit&auml;ten</emphasis>.</para>
 
     <sect2 id="sgml-primer-general-entities">
       <title>Allgemeine Entit&auml;ten</title>
 
       <para>Allgemeine Entit&auml;ten k&ouml;nnen nur in
 	Dokumenten benutzt werden.  Sie k&ouml;nnen zwar im
 	SGML-Kontext definiert aber dort nicht benutzt
 	werden.  Vergleichen Sie dies mit
         Im <link linkend="sgml-primer-parameter-entities">Parameterentit&auml;ten</link>.</para>
 
       <para>Jede allgemeine Entit&auml;t hat einen Namen, &uuml;ber
         den sie angesprochen werden kann, um den von ihr
         referenzierten Inhalt in ein Dokument einzubinden. Daf&uuml;r
         muss an der betreffenden Stelle der Namen der
         Entit&auml;t per
         <literal>&amp;<replaceable>entitaetenname</replaceable>;</literal>
         einf&uuml;gt werden. Eine Entit&auml;t
         <literal>current.version</literal> k&ouml;nnte beispielsweise
         durch die aktuelle Versionsnummer eines Programms ersetzt
         werden. Man k&ouml;nnte also schreiben:</para>
 
       <!--?
       Der vorhergehende Satz ist nicht 100% sinngemae&szlig; uebersetzt.
       Klingt zudem doof.
       Oliver Fischer
       -->
 
       <!--<para>Each general entity has a name.  When you want to reference a
       general entity (and therefore include whatever text it represents in
       your document), you write
       <literal>&amp;<replaceable>entity-name</replaceable>;</literal>.  For
       example, suppose you had an entity called
       <literal>current.version</literal> which expanded to the current
           version number of your product.  You could write;</para>-->
 
       <programlisting><![ CDATA [<para>Die aktuelle Version des
   Programms ist &current.version;.</para>]]></programlisting>
 
       <para>Wenn sich die Versionsnummer &auml;ndert, muss
 	nur die Entit&auml;t angepasst und anschlie&szlig;end
 	das Dokument neu erzeugt werden.</para>
 
       <para>Eine weitere Einsatzm&ouml;glichkeit f&uuml;r Allgemeine
         Entit&auml;ten ist das Einbinden von Zeichen, die auf andere
         Weise nicht in ein SGML-Dokument eingef&uuml;gt werden
         k&ouml;nnten. Ein Beispiel f&uuml;r solche Zeichen sind
         <literal>&lt;</literal> und <literal>&amp;</literal>, die
         normalerweise nicht direkt in
         SGML-Dokumenten erlaubt sind. St&ouml;&szlig;t ein SGML-Parser
         bei seiner Arbeit auf das Symbol <literal>&lt;</literal>,
         nimmt er an, dass der Anfang eines Start- oder Endtags
         gefunden wurde. Bei einem <literal>&amp;</literal> wird er
         annehmen, den Anfang einer Entit&auml;t gefunden zu haben.</para>
 
       <para>Wenn eines der beiden Zeichen ben&ouml;tigt wird, werden
 	daher die allgemeinen Entit&auml;ten <literal>&amp;lt;</literal>
 	und <literal>&amp;amp;</literal> verwendet.</para>
 
       <para>Allgemeine Entit&auml;ten k&ouml;nnen nur in einem
         SGML-Kontext definiert werden. &Uuml;blich ist es, dies direkt
         nach der DOCTYPE-Deklaration zu tun:</para>
 
       <example>
         <title>Allgemeine Entit&auml;ten festlegen</title>
 
         <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY current.version    "3.0-RELEASE">
 <!ENTITY last.version       "2.2.7-RELEASE">
 ]>]]></programlisting>
 
         <para>Wichtig ist an dieser Stelle, dass die
           DOCTYPE-Deklaration durch eine eckige Klammer am Ende der
           ersten Zeile erweitert wurde. Die beiden Entit&auml;ten
           selber werden in den folgenden zwei Zeilen definiert, bevor
           in der letzten Zeile die eckige Klammer und die
           DOCTYPE-Deklaration wieder geschlossen werden.</para>
 
         <!--?
         UEbersetzung mit dem Orginal vergleichen und nach einer
         besseren UEbersetzung suchen.
         -->
 
         <para>Die eckigen Klammern sind notwendig um festzulegen, dass
           man die &uuml;ber DOCTYPE genannte DTD erweitern m&ouml;chte.</para>
 
       </example>
     </sect2>
 
     <sect2 id="sgml-primer-parameter-entities">
       <title>Parameterentit&auml;ten</title>
 
       <para>Genau wie <link
           linkend="sgml-primer-general-entities">Allgemeine
           Entit&auml;ten</link> werden Parameterentit&auml;ten
         eingesetzt um wiederverwendbare Inhaltsteile mit Namen zu
         versehen. Im Gegensatz zu Allgemeinen Entit&auml;ten
         k&ouml;nnen sie aber nur innerhalb eines <link
           linkend="sgml-primer-sgml-escape">SGML-Kontextes</link>
         genutzt werden.</para>
 
       <para>Die Definition von Parameterentit&auml;ten erfolgt
         &auml;hnlich zu der Allgemeiner Entit&auml;ten. Sie werden
         lediglich mit
         <literal>%<replaceable>entitaetenname</replaceable>;</literal>
         anstelle von
         <literal>&amp;<replaceable>entitaetenname</replaceable>;</literal>
         referenziert<footnote>
           <para>Es wird das Prozentzeichen anstelle des
             kaufm&auml;nnischen Unds verwendet.</para>
         </footnote>. Wichtig ist, dass das
         <literal>%</literal>-Zeichen zwischen
         <literal>ENTITY</literal> und dem Entit&auml;tennamen ein Teil
         der Definition ist.</para>
 
       <example>
         <title>Parameterentit&auml;ten festlegen</title>
 
         <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY % param.etwas "etwas">
 <!ENTITY % param.text "Text">
 <!ENTITY % param.neu  "%param.etwas mehr %param.text">
 
 <!-- %param.neu ist jetzt "etwas mehr Text" -->
 ]>]]></programlisting>
         </example>
 
         <!--? Noch nicht &uuml;bersetzt. Oliver Fischer -->
         <!--<para>This may not seem particularly useful.  It will be.</para>-->
       </sect2>
 
     <sect2>
       <title>Finger&uuml;bungen&hellip;</title>
 
       <procedure>
         <step>
           <para>F&uuml;gen Sie in <filename>beispiel.sgml</filename>
             eine Allgemeine Entit&auml;t ein.</para>
 
             <programlisting><![ RCDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
 <!ENTITY version "1.1">
 ]>
 
 <html>
   <head>
     <title>Eine HTML-Beispieldatei</title>
   </head>
 
   <body>
     <p>Das ist ein Absatz mit etwas Text.</p>
 
     <p>Das ist ein Absatz mit anderem Text.</p>
 
     <p align="right">Dieser Absatz wird rechtsb&uuml;ndig
       ausgerichtet.</p>
 
     <p>Die aktuelle Version ist: &amp;version;</p>
   </body>
 </html>]]></programlisting>
         </step>
 
         <step>
           <para>Validieren Sie diese Datei mit
             <command>nsgmls</command></para>
         </step>
 
         <step>
           <para>&Ouml;ffnen Sie nun <filename>beispiel.sgml</filename>
             mit Ihrem Webbrowser. Es kann notwendig sein, dass
             Sie die Datei vorher in <filename>beispiel.html</filename>
             umbenennen m&uuml;ssen, damit die Datei auch als
             HTML-Dokument erkannt wird.</para>
 
           <para>Nur wenn Sie einen sehr modernen Browser haben, werden
             Sie sehen k&ouml;nnen, dass
             <literal>&amp;version;</literal> durch die Versionsnummer
             ersetzt wurde. Leider haben die meisten Webbrowser
             sehr einfache SGML-Parser, die nicht richtig mit SGML
             umgehen k&ouml;nnen<footnote>
               <para>Eigentlich ist das eine Schande. Man stelle sich
                 vor, welche Probleme und Hacks, wie beispielsweise
                 Server Side Includes, man an dieser Stelle h&auml;tte
                 vermeiden k&ouml;nnen.</para>
             </footnote>.</para>
         </step>
 
         <step>
           <para>Die L&ouml;sung hierf&uuml;r ist, das Dokument zu
             <emphasis>normalisieren</emphasis>. Zu diesem Zweck liest
             ein Normer <!--? Sehr freie &Uuml;bersetzung. Oliver -->
             das Dokument ein und gibt anschlie&szlig;end semantisch
             gleichwertiges SGML wieder aus, dass auf verschiedene
             Arten transformiert worden sein kann. Eine dieser
             m&ouml;glichen Transformationen ist das Ersetzen der
             Referenzen auf Entit&auml;ten mit dem von ihnen
             pr&auml;sentierten Inhalt.</para>
 
           <para>Versuchen Sie, die Beispieldatei mittels
             <command>sgmlnorm</command> zu normalisieren:</para>
 
             <screen>&prompt.user; <userinput>sgmlnorm beispiel.sgml > beispiel.html</userinput></screen>
 
           <para>Anschlie&szlig;end sollten Sie eine normalisierte
             Version, dass hei&szlig;t eine, bei der die
             Entit&auml;ten gegen ihren Inhalt ersetzt wurden, in der
             Datei <filename>beispiel.html</filename> finden. Diese
             Datei k&ouml;nnen Sie sich nun mit Ihrem Browser
             ansehen.</para>
 
         </step>
 
         <step>
           <para>Wenn Sie sich die Ausgaben von <command>sgmlnorm</command>
             ansehen, werden Sie feststellen, dass
             die DOCTYPE-Deklaration am Anfang der Datei nicht mehr
             enthalten ist. M&ouml;chten Sie die Deklaration behalten,
             muss <command>sgmlnorm</command> mit der Option
             <option>-d</option> aufrufen werden:</para>
 
           <screen>&prompt.user; <userinput>sgmlnorm -d beispiel.sgml > beispiel.html</userinput></screen>
         </step>
       </procedure>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-include">
     <title>Dateien mit Entit&auml;ten einbinden</title>
 
     <!--?
     Dieser kleine Absatz klingt ziemlich h&ouml;lzern.
     Oliver Fischer
     -->
 
     <para>Sowohl <link
         linkend="sgml-primer-general-entities">Allgemeine</link> als
       auch <link
         linkend="sgml-primer-parameter-entities">Parameterentit&auml;ten</link>
       sind n&uuml;tzliche Helfer, wenn es darum geht, eine Datei in
       eine andere einzubinden.</para>
 
     <sect2 id="sgml-primer-include-using-gen-entities">
       <title>Dateien mit Allgemeinen Entit&auml;ten einbinden</title>
 
       <para>Angenommen man hat ein Buch geschrieben, dessen Inhalt
         auf mehrere Dateien aufgeteilt und mittels SGML
         ausgezeichnet. Jedes Kapitel wurde dazu in einer eigenen Datei
         (<filename>kapitel1.sgml</filename>,
         <filename>kapitel2.sgml</filename> usw.) abgelegt und
         &uuml;ber eine Datei <filename>buch.sgml</filename> sollen
         alle physischen Dateien wieder mit der Hilfe von
         Entit&auml;ten zu einem logischen Dokument
         zusammengef&uuml;hrt werden.</para>
 
       <para>Damit der Inhalt der Dateien mit Entit&auml;ten
 	eingebunden werden kann, muss die Deklaration der
         Entit&auml;ten das Schl&uuml;sselwort
         <literal>SYSTEM</literal> enthalten. SGML-Parser werden so
         angewiesen, den Inhalt der referenzierten Datei als Wert
         f&uuml;r die jeweilige Entit&auml;t zu nehmen.</para>
 
       <example>
         <title>Dateien mit Allgemeinen Entit&auml;ten einbinden</title>
 
         <programlisting><![ RCDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY kapitel.1 SYSTEM "kapitel1.sgml">
 <!ENTITY kapitel.2 SYSTEM "kapitel2.sgml">
 <!ENTITY kapitel.3 SYSTEM "kapitel3.sgml">
 <!-- Und so weiter... -->
 ]>
 
 <html>
   <!-- Jetzt werden die Kapitel &uuml;ber die Entit&auml;ten eingebunden -->
 
   &amp;kapitel.1;
   &amp;kapitel.2;
   &amp;kapitel.3;
 </html>]]></programlisting>
       </example>
 
       <warning>
         <para>Wenn man Allgemeine Entit&auml;ten benutzt, um andere
           Dateien einzubinden, d&uuml;rfen diese Dateien
           (<filename>kapitel1.sgml</filename>,
           <filename>kapitel2.sgml</filename>, ...)
           <emphasis>keine</emphasis> eigene DOCTYPE-Deklaration
           haben.</para>
       </warning>
     </sect2>
 
     <sect2>
       <title>Dateien mit Parameterentit&auml;ten einbinden</title>
 
       <para>Wie bereits festgestellt, k&ouml;nnen
         Parameterentit&auml;ten nur innerhalb eines SGML-Kontexts
         genutzt werden. Warum m&ouml;chte man aber Dateien innerhalb
         eines SGML-Kontexts einbinden? Der Vorteil liegt in der
         M&ouml;glichkeit, die Deklaration von Entit&auml;ten in eine
         andere Datei auslagern zu k&ouml;nnen, wodurch diese leichter
         wiederverwendbar sind.</para>
 
       <para>Angenommen das Buch aus dem vorherigen Kapitel besteht aus
         sehr vielen Kapiteln und diese sollen auch in einem anderen
         Buch, aber in einer anderen Reihenfolge, verwendet werden.
         Eine M&ouml;glichkeit w&auml;re es, die daf&uuml;r notwendigen
         Entit&auml;ten am Anfang jedes Buches einzeln festzulegen
         &ndash; was allerdings mit der Zeit unhandlich und
         fehlertr&auml;chtig wird.</para>
 
       <para>Alternativ bietet sich dazu an, die Deklarationen in eine
         separate Datei auszulagern und deren Inhalt anschlie&szlig;end
         in beide B&uuml;cher &uuml;ber Parameterentit&auml;ten
         einzubinden.</para>
 
       <example>
         <title>Dateien mit Parameterentit&auml;ten einbinden</title>
 
         <para>Zuerst werden die Entit&auml;ten in einer separaten
           Datei namens <filename>kapitel.ent</filename> deklariert.
           <filename>kapitel.ent</filename> enth&auml;lt f&uuml;r
           dieses Beispiel die folgenden Zeilen:</para>
 
         <programlisting><![ CDATA [<!ENTITY kapitel.1 SYSTEM "kapitel1.sgml">
 <!ENTITY kapitel.2 SYSTEM "kapitel2.sgml">
 <!ENTITY kapitel.3 SYSTEM "kapitel3.sgml">]]></programlisting>
 
         <para>Im zweiten Schritt f&uuml;gt man in beide B&uuml;cher
           eine Parameterentit&auml;t ein, die den Inhalt von
           <filename>kapitel.ent</filename> referenziert, und l&auml;dt
           &uuml;ber diese dann die Deklarationen. Anschlie&szlig;end
           k&ouml;nnen die so geladenen Entit&auml;ten wie gewohnt
           genutzt werden.</para>
 
 	<programlisting><![ RCDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!-- Definieren einer Parameterentit&auml;t um die Allgemeinen Entit&auml;ten f&uuml;r -->
 <!-- die Kapitel laden zu k&ouml;nnen                                        -->
 <!ENTITY % kapitel SYSTEM "kapitel.ent">
 
 <!-- Nun wird der Inhalt der referenzierten Datei geladen -->
 %kapitel;
 ]>
 
 <html>
   &amp;kapitel.1;
   &amp;kapitel.2;
   &amp;kapitel.3;
 </html>]]></programlisting>
       </example>
     </sect2>
 
     <sect2>
       <title>Finger&uuml;bungen&hellip;</title>
 
         <sect3>
           <title>Binden Sie Dateien &uuml;ber Allgemeine Entit&auml;ten ein</title>
 
           <procedure>
             <step>
               <para>Legen Sie drei Dateien (<filename>absatz1.sgml</filename>,
                 <filename>absatz2.sgml</filename> und <filename>absatz3.sgml</filename>)
                 mit jeweils einer Zeile wie
 
                 <!--     <para>Create three files, <filename>para1.sgml</filename>,
                 <filename>para2.sgml</filename>, and
                 <filename>para3.sgml</filename>.</para>-->
 
                 <!--<para>Put content similar to the following in each file;</para>-->
 
                 <programlisting><![ CDATA [<p>Erster Absatz.</p>]]></programlisting>
                 an.</para>
 	  </step>
 
 	  <step>
 	    <para>&Auml;ndern Sie <filename>beispiel.sgml</filename> so
               ab, dass sie wie folgt aussieht:</para>
 
               <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY version "1.1">
 <!ENTITY absatz1 SYSTEM "absatz1.sgml">
 <!ENTITY absatz2 SYSTEM "absatz2.sgml">
 <!ENTITY absatz3 SYSTEM "absatz3.sgml">
 ]>
 
 <html>
   <head>
     <title>Eine HTML-Beispieldatei</title>
   </head>
 
   <body>
     <p>Die aktuelle Version dieses Dokuments ist &version;</p>
 
     &absatz1;
     &absatz2;
     &absatz3;
   </body>
 </html>]]></programlisting>
 	  </step>
 
 	  <step>
 	    <para>Erzeugen Sie nun die Datei
               <filename>beispiel.html</filename>, indem Sie
               <filename>beispiel.sgml</filename> normalisieren:</para>
 
             <screen>&prompt.user; <userinput>sgmlnorm -d beispiel.sgml > beispiel.html</userinput></screen>
           </step>
 
           <step>
             <para>&Ouml;ffnen Sie <filename>beispiel.html</filename>
               nun mit einem Webbrowser und vergewissern Sie sich,
               dass der Inhalt der Dateien
               <filename>absatz<replaceable>N</replaceable>.sgml</filename>
               in <filename>beispiel.html</filename> &uuml;bernommen
               wurde.</para>
           </step>
 	</procedure>
       </sect3>
 
       <sect3>
 	<title>Binden Sie Dateien mit Parameterentit&auml;ten ein</title>
 
 	<note>
 	  <para>Hierf&uuml;r m&uuml;ssen Sie die vorherige Finger&uuml;bung gemacht haben.</para>
 	</note>
 
 	<procedure>
 	  <step>
 	    <para>&Auml;ndern Sie <filename>beispiel.sgml</filename> so
               ab, dass es wie folgt aussieht:</para>
 
 	    <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 <!ENTITY % entitaeten SYSTEM "entitaeten.sgml"> %entitaeten;
 ]>
 
 <html>
   <head>
     <title>Eine HTML-Beispieldatei</title>
   </head>
 
   <body>
     <p>Die aktuelle Version dieses Dokuments ist &version;</p>
 
     &absatz1;
     &absatz2;
     &absatz3;
   </body>
 </html>]]></programlisting>
 	  </step>
 
           <step>
             <para>Legen Sie eine weitere Datei <filename>entitaeten.sgml</filename> an,
                 die folgenden Inhalt hat:</para>
 
             <programlisting><![ CDATA [<!ENTITY version "1.1">
 <!ENTITY absatz1 SYSTEM "absatz1.sgml">
 <!ENTITY absatz2 SYSTEM "absatz2.sgml">
 <!ENTITY absatz3 SYSTEM "absatz3.sgml">]]></programlisting>
           </step>
 
           <step>
             <para>Erzeugen Sie die Datei
               <filename>beispiel.html</filename>, indem Sie
               <filename>beispiel.sgml</filename> normalisieren:</para>
 
             <screen>&prompt.user; <userinput>sgmlnorm -d beispiel.sgml > beispiel.html</userinput></screen>
           </step>
 
           <step>
             <para>&Ouml;ffnen Sie <filename>beispiel.html</filename>
               nun mit einem Webbrowser und vergewissern Sie sich,
               dass der Inhalt der Dateien
               <filename>absatz<replaceable>N</replaceable>.sgml</filename>
               in <filename>beispiel.html</filename> &uuml;bernommen
               wurde.</para>
           </step>
         </procedure>
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-marked-sections">
     <title>Markierte Bereiche</title>
 
     <para>SGML erlaubt es, dass bestimmte Dokumentabschnitte
       w&auml;hrend der Verarbeitung besonders behandelt werden sollen.
       Diese Abschnitte werden als <quote>markierte Bereiche</quote>
       <footnote><para>auf Englisch <foreignphrase>marked
             sections</foreignphrase>
         </para></footnote>
         bezeichnet.</para>
 
     <example>
       <title>Aufbau eines markierten Bereiches</title>
 
       <programlisting>&lt;![ <replaceable>SCHL&Uuml;SSELWORT</replaceable> [
   Inhalt des markierten Bereiches
 ]]&gt;</programlisting>
     </example>
 
     <para>Da es sich bei markierten Bereichen um SGML-Konstrukte
       handelt, werden sie mit <literal>&lt;!</literal> eingeleitet.
       Der eigentliche Anfang des markierten Bereiches wird von der
       folgenden eckigen Klammer bestimmt. Das darauf folgende
       <replaceable>SCHL&Uuml;SSELWORT</replaceable> legt fest, wie der
       <quote>markierte Inhalt</quote> durch einen SGML-Prozessor
       w&auml;hrend der Verarbeitung behandelt werden soll. Der
       <quote>markierte</quote> Inhalt selbst beginnt erst nach der
       zweiten eckigen Klammer und erstreckt sich bis zu den zwei
       schlie&szlig;enden eckigen Klammern am Ende des Bereiches. Mit
       Hilfe des <literal>&gt;</literal> Zeichens wird der mit
       <literal>&lt;!</literal> begonnene SGML-Kontext wieder
       verlassen.</para>
 
     <sect2>
       <title>Schl&uuml;sselworte f&uuml;r markierte Bereiche</title>
 
       <sect3>
         <title><literal>CDATA</literal> und <literal>RCDATA</literal></title>
 
         <para>Die Schl&uuml;sselworte <literal>CDATA</literal> und
           <literal>RCDATA</literal> bestimmen das
           <emphasis>Inhaltsmodell</emphasis> f&uuml;r markierte
           Bereiche. Dadurch ist es m&ouml;glich, vom Standardmodell
           abzuweichen.</para>
 
         <para>Ein SGML-Prozessor muss w&auml;hrend der
           Verarbeitung eines Dokuments zu jedem Zeitpunkt wissen,
           welches <emphasis>Inhaltsmodell</emphasis> gerade anzuwenden
           ist.</para>
 
         <para>Was ist ein Inhaltsmodell? Kurz gesagt beschreibt das
           Inhaltsmodell, welche Art von Inhalt der Parser zu erwarten
           und wie er damit umzugehen hat.</para>
 
         <para>Bei <literal>CDATA</literal> und
           <literal>RCDATA</literal> handelt es sich wahrscheinlich um
           die n&uuml;tzlichsten Inhaltsmodelle. <!--? Die richtige
           Uebersetzung ist Buchstabendaten. Oliver Fischer -->
           <literal>CDATA</literal> steht f&uuml;r
           Zeichendaten<footnote>
             <para>auf Englisch <foreignphrase>character
                 data</foreignphrase></para></footnote>. Trifft ein
           Parser auf dieses Inhaltsmodell, wird er annehmen, dass
           sich im zugeh&ouml;rigen Dokumentenbereich nur
           <quote>gew&ouml;hnliche</quote> Zeichen befinden. Das
           bedeutet, dass <literal>&lt;</literal> und
           <literal>&amp;</literal> ihre besondere Bedeutung
           verlieren und als einfache Zeichen behandelt werden.</para>
 
         <para><literal>RCDATA</literal> steht f&uuml;r
           Entit&auml;tenreferenzen und Zeichendaten<footnote><para>auf
               Englisch
               <foreignphrase>Entity references and character
                 data</foreignphrase></para></footnote>. F&uuml;r einen
           Bereich mit diesem Inhaltsmodell, wird ein Parser davon
           ausgehen, dass er sowohl Zeichen als auch
           Enit&auml;tenreferenzen finden kann. <literal>&lt;</literal>
           verliert hier zwar auch seine besondere Bedeutung, doch
           <literal>&amp;</literal> wird weiterhin als Anfang einer
           Entit&auml;t interpretiert.</para>
 
         <para>N&uuml;tzlich ist das <literal>CDATA</literal>-Modell
           vor allem dann, wenn es darum geht Texte eins-zu-eins zu
           &uuml;bernehmen, in denen <literal>&lt;</literal> und
           <literal>&amp;</literal> geh&auml;uft
           auftreten. Zwar kann man solche Texte &uuml;berarbeiten und
           jedes <literal>&lt;</literal> durch ein
           <literal>&amp;lt;</literal> und jedes
           <literal>&amp;</literal> durch ein <literal>&amp;amp;</literal>
           ersetzen, doch es wird in den meisten F&auml;llen
           einfacher sein, f&uuml;r den betreffenden Text
           <literal>CDATA</literal> als Inhaltsmodell festzulegen. Ein
           SGML-Parser wird dann, sobald er auf
           <literal>&lt;</literal> oder <literal>&amp;</literal> trifft,
           diese als  Zeichen in einem Text betrachten.</para>
 
         <note>
           <para>Bei der Verwendung von <literal>CDATA</literal> und
             <literal>RCDATA</literal> als Inhaltsmodell f&uuml;r
             SGML-Beispiele, wie sie in diesem Dokument enthalten sind,
             muss bedacht werden, dass der Inhalt eines
             <literal>CDATA</literal>-Bereiches nicht validiert wird.
             dass das SGML in diesen Bereichen g&uuml;ltig ist,
             muss auf andere Weise sichergestellt werden. Denkbar ist
             beispielsweise, es in einem separaten Dokument zu
             erstellen, dort zu pr&uuml;fen und erst dann in das
             eigentliche Dokument einzuf&uuml;gen.</para>
         </note>
           <!-- The nesting of CDATA within the next example is disgusting -->
 
         <example>
           <title>CDATA als Inhaltsmodell f&uuml;r markierte Bereiche</title>
 
           <programlisting>&lt;para>Das ist ein Beispiel, wie man einen Text,
   der viele <literal>&amp;lt;</literal>- und <literal>&amp;amp;</literal>-
   Entit&auml;ten enth&auml;lt, in ein Dokument einbinden kann.
   Das Beispiel selbst, das sich innerhalb des markierten Bereiches befindet,
   ist ein HTML-Fragment. Der diesen Text umschlie&szlig;ende Tag, beginnend mit
   mit <sgmltag>para</sgmltag> und endend mit <sgmltag>/para</sgmltag>, stammt aus der DocBook DTD.&lt;/para>
 
 &lt;programlisting>
   &lt;![ RCDATA [  <![ CDATA [
     <p>Dieses Beispiel demonstriert die Verwendung von HTML-Elementen.
       Da spitze Klammern so oft vorkommen, ist es einfacher, das
       gesamte Beispiel als CDATA Abschnitt auszuweisen, als die
       entsprechenden Entit&auml;ten zu nutzen.</p>
 
     <ul>
       <li>Das ist ein Listenelement.</li>
       <li>Das ist ein zweites Listenelement.</li>
       <li>Das ist ein drittes Listenelement.</li>
     </ul>
 
     <p>Und das hier, das ist das Ende des Beispiels.</p>]]>
   ]]&gt;
 &lt;/programlisting></programlisting>
 
           <para>Liest  man die Quellen dieser Fibel, wird man
             feststellen, dass diese Technik durchg&auml;ngig
             angewandt wurde.</para>
 
         </example>
       </sect3>
 
       <sect3>
 	<title><literal>INCLUDE</literal> und
 	  <literal>IGNORE</literal></title>
 
         <para>Das Schl&uuml;sselwort <literal>INCLUDE</literal> legt
           fest, dass der Inhalt des betreffenden Abschnittes
           mitverarbeitet wird. Demgegen&uuml;ber bestimmt
           <literal>IGNORE</literal>, dass er ignoriert wird,
           dass hei&szlig;t, dass er bei der Verarbeitung
           &uuml;bergangen wird und in der Ausgabe nicht enthalten
           ist.</para>
 
 	<example>
 	  <title>Anwendung von <literal>INCLUDE</literal> und
             <literal>IGNORE</literal> in markierten
             Abschnitten</title>
 
 	  <programlisting>&lt;![ INCLUDE [
   Dieser Text wird verarbeitet und eingebunden.
 ]]&gt;
 
 &lt;![ IGNORE [
   Dieser Text wird weder verarbeitet noch eingebunden.
 ]]&gt;</programlisting>
           </example>
 
         <para>F&uuml;r sich alleine ist <literal>IGNORE</literal> als
           Anweisung nicht besonders n&uuml;tzlich, da ein Bereich, der
           von der Verarbeitung ausgenommen sein soll, auch
           auskommentiert werden kann.</para>
 
         <para>Kombiniert man <literal>IGNORE</literal> hingegen mit
           <link
             linkend="sgml-primer-parameter-entities">Parameterentit&auml;ten</link>,
           steht so ein  Weg zur Verf&uuml;gung, um dessen Anwendung
           besser  steuern zu k&ouml;nnen. Zwar k&ouml;nnen
           Parameterentit&auml;ten nur in einem SGML-Kontext einsetzt
           werden, da aber markierte Bereiche ebenfalls SGML-Konstrukte
           sind, ist diese Einschr&auml;nkung irrelevant.</para>
 
         <para>Soll beispielsweise ein und dasselbe Dokument in zwei
           unterschiedlichen Varianten produziert werden, einer
           gedruckten und einer digitalen, und soll nur die digitale
           zus&auml;tzliche Informationen enthalten, kann dies mit
           einem Trick erreicht werden.</para>
 
         <para>Man definiert eine Parameterentit&auml;t, der man als
           Wert die Zeichenkette <literal>INCLUDE</literal> zuweist und
           deklariert den betreffenden Bereich, der nur in der
           digitalen Variante erscheinen soll, als markierten Abschnitt
           und setzt als Schl&uuml;sselwort die zuvor definierte
           Parameterentit&auml;t ein.</para>
 
         <para>Soll anstelle der digitalen die gedruckte Variante
           produziert werden, muss lediglich der Entit&auml;t
           <literal>IGNORE</literal> als Wert zugewiesen und das
           Ursprungsdokument erneut durch den SGML-Prozessor geschickt
           werden.</para>
 
         <example>
           <title>Kontrolle von markierten Bereichen &uuml;ber
             Parameterentit&auml;ten</title>
 
           <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 &lt;!ENTITY % digitale.kopie "INCLUDE">
 ]]&gt;
 
 ...
 
 &lt;![ %digitale.kopie [
   Dieser Satz sollte nur in der digitalen Version enthalten sein.
 ]]&gt;</programlisting>
 
           <para>Bei der Produktion der gedruckten Variante muss
             der Wert der Entit&auml;t ge&auml;ndert werden.</para>
 
 	  <programlisting>&lt;!ENTITY % digitale.kopie "IGNORE"></programlisting>
 
           <para>Bei der Verarbeitung wird als Schl&uuml;sselwort in
             beiden F&auml;llen der von
             <literal>%digitale.kopie</literal> repr&auml;sentierte
             Wert verwendet. Im ersten Fall wird der Inhalt des
             markierten Bereichs mitverarbeitet, im zweiten Fall
             nicht.</para>
 
 	</example>
       </sect3>
     </sect2>
 
     <sect2>
       <title>Finger&uuml;bung&hellip;</title>
 
       <procedure>
 	<step>
           <para>Legen Sie eine neue Datei
             <filename>abschnitt.sgml</filename> an, die folgenden
             Inhalt hat:</para>
 
 	  <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
 &lt;!ENTITY % text.ausgabe "INCLUDE">
 ]&gt;
 
 &lt;html>
   &lt;head>
     &lt;title>Ein Beispiel mit markierten Abschnitten&lt;/title>
   &lt;/head>
 
   &lt;body>
     &lt;p>Dieser Absatz &lt;![ CDATA [beinhaltet viele &lt;
       Zeichen (&lt; &lt; &lt; &lt; &lt;). Weshalb es einfacher ist,
       ihn als CDATA Bereich auszuweisen. ]]&gt;&lt;/p>
 
     &lt;![ IGNORE [
     &lt;p>Dieser Absatz wird NICHT in der Ausgabe enthalten sein.&lt;/p>
     ]]&gt;
 
     &lt;![ <![ CDATA [%text.ausgabe]]> [
      &lt;p>Dieser Absatz wird in Abh&auml;ngigkeit von <literal>%text.ausgabe</literal>
        mitausgegeben.&lt;/p>
     ]]&gt;
   &lt;/body>
 &lt;/html></programlisting>
         </step>
 
         <step>
           <para>Normalisieren Sie den Inhalt dieser Datei mit Hilfe
             von <command>sgmlnorm</command> und sehen Sie sich das
             Ergebnis an.  Achten Sie dabei darauf, welche Abs&auml;tze
             enthalten beziehungsweise nicht enthalten sind und was aus
             den <literal>CDATA</literal>-Bereichen geworden ist.</para>
 	</step>
 
         <step>
           <para>&Auml;ndern Sie die Definition von
             <literal>text.ausgabe</literal> so, dass es den
             Wert <literal>IGNORE</literal> zugewiesen bekommt.
             Verarbeiten Sie dann die Datei erneut mit
             <command>sgmlnorm</command> und vergleichen die Ausgabe mit
             der vom ersten <command>sgmlnorm</command> Lauf.</para>
 
         </step>
       </procedure>
     </sect2>
   </sect1>
 
   <sect1 id="sgml-primer-conclusion">
     <title>Schlu&szlig;bemerkung</title>
 
     <para>Aus Platzgr&uuml;nden, und um der Verst&auml;ndlichkeit
       Willen, wurden viele Gesichtspunkte nicht in aller Tiefe
       beziehungsweise gar nicht besprochen. Trotzdem sollte in den
       bisherigen Kapiteln gen&uuml;gend Wissen &uuml;ber SGML
       vermittelt worden sein, um den Aufbau der Dokumentation des FDPs
       zu verstehen.</para>
 
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml b/de_DE.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml
index 6b33b11db9..7ddf6a0b01 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml
@@ -1,109 +1,109 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/stylesheets/chapter.sgml,v 1.5 2007/03/18 17:57:45 jkois Exp $
-     basiert auf: 1.13
+     $FreeBSDde: de-docproj/books/fdp-primer/stylesheets/chapter.sgml,v 1.6 2008/12/14 18:34:07 jkois Exp $
+     basiert auf: 1.14
 -->
 
 <chapter id="stylesheets">
   <chapterinfo>
     <authorgroup>
       <author>
 	<firstname>Johann</firstname>
 	<surname>Kois</surname>
 	<contrib>&Uuml;bersetzt von </contrib>
       </author>
     </authorgroup>
   </chapterinfo>
 
   <title>Stylesheets</title>
 
   <para>SGML legt nicht fest, wie ein Dokument am Monitor oder auf einem
     Ausdruck dargestellt werden soll.  F&uuml;r diese Aufgabe wurden
     spezielle Sprachen entwickelt, die Formatvorlagen (die sogenannten
     <foreignphrase>Stylesheets</foreignphrase>) f&uuml;r die Darstellung
     der Inhalte definieren.  Zu diesen Sprachen geh&ouml;ren
     beispielsweise DynaText, Panorama, SPICE, JSSS, FOSI, CSS, DSSSL
     und andere mehr.</para>
 
   <para>DocBook verwendet in DSSSL geschriebene Stylesheets.  HTML
     verwendet hingegen in CSS geschriebene Stylesheets.</para>
 
   <sect1 id="stylesheets-dsssl">
     <title>DSSSL</title>
 
     <para>Das Documentation Project verwendet eine anpasste Version der
       von Norm Walsh entwickelten modularen DocBook-Stylesheets, die
       &uuml;ber den Port <filename
       role="package">textproc/dsssl-docbook-modular</filename>
       installiert werden k&ouml;nnen.</para>
 
     <para>Die FreeBSD-Modifikationen sind hingegen nicht in der
       Ports-Sammlung enthalten, sondern befinden sich im
       Quellcode-Repository des Documentation Projects in der Datei
       <filename>doc/share/sgml/freebsd.dsl</filename>.  Diese Datei
       ist umfassend kommentiert und mit Beispielen versehen.
       Dadurch k&ouml;nnen Sie einfach nachvollziehen, wie die
       urspr&uuml;nglichen Stylesheets vom FreeBSD Documentation
       Project angepasst wurden.</para>
   </sect1>
 
   <sect1 id="stylesheets-css">
     <title>CSS</title>
 
     <para>Cascading Stylesheets (CSS) erlauben es, Elementen eines
       HTML-Dokuments Formatangaben (wie Schriftart, Gr&ouml;&szlig;e,
       Schriftfarbe und andere mehr) zuzuweisen, ohne das HTML-Dokument
       mit diesen Informationen zu &uuml;berfrachten.</para>
 
     <sect2>
       <title>Die DocBook-Dokumente</title>
 
       <para>The FreeBSD DSSSL-Stylesheets enthalten eine Referenz auf
         ein Stylesheet namens <filename>docbook.css</filename>, das sich
         im gleichen Verzeichnis wie die HTML-Dateien befindet.  Diese
         projektweite CSS-Datei wird automatisch von
         <filename>doc/share/misc/docbook.css</filename> kopiert und
         installiert, wenn DocBook-Dokumente nach HTML konvertiert
         werden.</para>
     </sect2>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
diff --git a/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.sgml b/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.sgml
index 5a2473acbd..6eea5f11f3 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.sgml
+++ b/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.sgml
@@ -1,332 +1,332 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML, HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      $FreeBSD$
-     $FreeBSDde: de-docproj/books/fdp-primer/tools/chapter.sgml,v 1.11 2008/10/19 16:57:36 jkois Exp $
-     basiert auf: 1.33
+     $FreeBSDde: de-docproj/books/fdp-primer/tools/chapter.sgml,v 1.12 2008/12/14 18:34:07 jkois Exp $
+     basiert auf: 1.34
 -->
 
 <chapter id="tools">
   <title>Die Werkzeuge</title>
 
   <para>Innerhalb des FDPs werden verschiedene Programme f&uuml;r die
     Verwaltung der FreeBSD-Dokumentation, ihrer Transformation in
     verschiede Formate und weitere Aufgaben eingesetzt. Wer an der
     FreeBSD-Dokumentation mitarbeiten m&ouml;chte, wird diese
     Programme ben&ouml;tigen.</para>
 
   <para>Doch dies ist kein Grund zur Angst, da alle notwendigen
     Programme als FreeBSD-Ports und fertige Pakete vorhanden sind,
     wodurch sich die Installation drastisch vereinfacht.</para>
 
   <para>Allerdings m&uuml;ssen diese Programme installiert werden,
     bevor alle Beispiele der folgenden Kapitel ausprobiert werden
     k&ouml;nnen.</para>
 
   <tip>
     <title>
       Wenn es m&ouml;glich ist, sollte der Port
       <filename role="package">textproc/docproj</filename>
       verwendet werden</title>
 
     <para>Durch die Installation des Ports <filename
         role="package">textproc/docproj</filename> kann die
       Installation vereinfacht und eine Menge Zeit gespart werden. Bei
       diesem Port handelt es sich um einen
       <emphasis>Metaport</emphasis>, der selbst keine Programme oder
       &auml;hnliches installiert. Stattdessen enth&auml;lt er eine
       Vielzahl von Abh&auml;ngigkeiten zu anderen Ports und setzt
       deren korrekte Installation voraus. Durch seine Installation
       <emphasis>sollten</emphasis> automatisch alle Pakete, die in
       diesem Kapitel genannt werden, auf den Rechner geladen und dort
       installiert werden.</para>
 
     <para>Ein nur unter bestimmten Umst&auml;nden ben&ouml;tigter Port
       ist das <application>JadeTeX</application>-Makro-Paket,
       das seinerseits eine
       &tex;-Installation voraussetzt. &tex; ist ein ziemlich gro&szlig;es
       Programmpaket und sollte nur installiert werden, sofern
       Zieldokumente im PostScript- oder PDF-Format generiert werden
       sollen.</para>
 
     <para>Um den Platz und die Zeit f&uuml;r die Installation von
       <application>JadeTeX</application> und &tex; zu sparen,
       mu&szlig; bei der Installation
       angeben werden, ob JadeTeX (und damit auch &tex;) installiert
       werden soll oder nicht.</para>
 
     <para>Daher sollte der docproj-Port entweder mit</para>
 
     <screen>&prompt.root; <userinput>make JADETEX=yes install</userinput></screen>
 
     <para>oder mit</para>
 
     <screen>&prompt.root; <userinput>make JADETEX=no install</userinput></screen>
 
     <para>installiert werden, je nachdem was gew&uuml;nscht wird.
       Alternativ k&ouml;nnen Sie auch direkt die Ports
       <filename role="package">textproc/docproj-jadetex</filename> oder
       <filename role="package">textproc/docproj-nojadetex</filename>
       installieren.  Die Variable <makevar>JADETEX</makevar> wird
       von diesen Ports automatisch entsprechend gesetzt.  Ohne
       <application>JadeTeX</application> k&ouml;nnen Sie nur die Formate
       HTML und ASCII erzeugen.  Die Formate PostScript und PDF
       erfordern <application>&tex;</application>.</para>
   </tip>
 
   <sect1 id="tools-mandatory">
     <title>Notwendige Werkzeuge</title>
 
     <sect2>
       <title>Software</title>
 
       <para>Die folgenden Programme sind notwendig, um sinnvoll
         an der FreeBSD-Dokumentation arbeiten und diese in andere
         Formate wie HTML, reinen Text und RTF umwandeln zu
         k&ouml;nnen.  Sie m&uuml;ssen diese aber nicht seperat
         installieren, da alle Programme automatisch durch den
         Metaport <filename
         role="package">textproc/docproj</filename> installiert
         werden.</para>
 
       <variablelist>
 	<varlistentry>
 	  <term><application>Jade</application> (<filename
               role="package">textproc/jade</filename>)</term>
 
 	  <listitem>
             <para>Eine DSSSL-Implementierung. Sie wird gebraucht, um
               Dokumente in andere Formate wie HTML und &tex; zu
               &uuml;bersetzen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><application>Tidy</application>
 	    (<filename role="package">www/tidy</filename>)</term>
 
 	  <listitem>
             <para>Ein Formatierer, mit dem man Teile der automatisch
               generierten HTML-Dateien neuformatieren kann, um ihre
               Lesbarkeit zu erh&ouml;hen.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><application>Links</application> (<filename
               role="package">www/links</filename>)</term>
 
 	  <listitem>
             <para>Ein Textbrowser, der HTML-Dateien in einfache Textdateien
               umwandeln kann.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><application>peps</application>
 	    (<filename role="package">graphics/peps</filename>)</term>
 
 	  <listitem>
             <para>Einige der Dokumente enthalten Grafiken, die nur im
               EPS-Format vorliegen. Damit diese von dem meisten
               Webbrowsern angezeigt werden k&ouml;nnen, m&uuml;ssen
               sie nach PNG konvertiert werden.</para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
 
     <sect2>
       <title>Die DTDs und die Entit&auml;ten</title>
 
       <para>Das FDP benutzt verschiedene DTDs und
         Entit&auml;tens&auml;tze, die installiert sein m&uuml;ssen,
         bevor mit der Arbeit an einem beliebigen Dokument begonnen
         werden kann.</para>
 
       <variablelist>
 	<varlistentry>
 	  <term>HTML DTD (<filename role="package">textproc/html</filename>)</term>
 
 	  <listitem>
             <para>HTML ist die bevorzugte <!-- ??? -->
               Auszeichnungssprache des World Wide Web und wird
               durchg&auml;ngig f&uuml;r die FreeBSD-Webseite
               genutzt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>DocBook DTD (<filename role="package">textproc/docbook</filename>)</term>
 
 	  <listitem>
             <para>DocBook ist als Auszeichnungssprache f&uuml;r
               technische Dokumentationen entwickelt worden. Die
               gesamte FreeBSD-Dokumentation wird mittels DocBook
               erstellt.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>ISO 8879-Entit&auml;ten
 	    (<filename role="package">textproc/iso8879</filename>)</term>
 
 	  <listitem>
             <para>19 der ISO 8879:1986-Zeichens&auml;tze, die von
               vielen DTDs ben&ouml;tigt werden. Darin enthalten sind
               mathematische Symbole, zus&auml;tzliche Zeichen, die
               f&uuml;r auf dem lateinischen beruhende Alphabete
               ben&ouml;tigt werden sowie griechische Zeichen.</para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
 
     <sect2>
       <title>Die Stilvorlagen</title>
 
       <para>Die Stilvorlagen werden w&auml;hrend der Transformation und
 	der Formatierung von Dokumenten, beispielsweise f&uuml;r die
 	Bildschirmdarstellung oder den Druck, benutzt.</para>
 
       <variablelist>
 	<varlistentry>
 	  <term>Modular DocBook Stylesheets (<filename
               role="package">textproc/dsssl-docbook-modular</filename>)</term>
 
 	  <listitem>
 	    <para>Die Modular DocBook Stylesheets werden
               ben&ouml;tigt, wenn mittels DocBook erstellte Dokumente
               in Formate wie HTML oder RTF konvertiert werden
               sollen.</para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
   </sect1>
 
   <sect1 id="tools-optional">
     <title>Optionale Werkzeuge</title>
 
     <para>Die in diesem Kapitel genannten Programme m&uuml;ssen nicht
       unbedingt installiert werden. Allerdings k&ouml;nnen sie die
       Arbeit an der Dokumentation erleichtern und die Anzahl an
       m&ouml;glichen Ausgabeformaten erh&ouml;hen.</para>
 
     <sect2>
       <title>Software</title>
 
       <variablelist>
 	<varlistentry>
 	  <term><application>JadeTeX</application> und
             <application>teTeX</application> (<filename
               role="package">print/jadetex</filename> und <filename
               role="package">print/teTeX</filename>)</term>
 
 	  <listitem>
             <para><application>Jade</application> und
               <application>teTeX</application> werden eingesetzt, um
               DocBook-Dokumente nach DVI, Postscript und PDF zu
               konvertieren. Hierf&uuml;r m&uuml;ssen die
               <application>JadeTeX</application> Makros installiert
               sein.</para>
 
             <para>Ist es nicht geplant, die Dokumente in einem dieser
               Formate zu erzeugen, wenn also HTML, Text und RTF
               ausreichend sind, brauchen
               <application>JadeTeX</application> und
               <application>teTeX</application> nicht installiert zu
               werden. Da die Installation von
               <application>teTeX</application> insgesamt 30 MB
               ben&ouml;tigt, kann so Zeit und Plattenplatz gespart
               werden.</para>
 
 
             <important>
               <para>Wird sich f&uuml;r die Installation von
                 <application>JadeTeX</application> und
                 <application>teTeX</application> entschieden,
                 mu&szlig; <application>teTeX</application>
                 anschlie&szlig;end noch eingerichtet werden. Die Datei
                 <filename>print/jadetex/pkg-message</filename>
                 enth&auml;lt detailierte Angaben zu den daf&uuml;r
                 notwendigen Schritten.</para>
             </important>
 
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><application>Emacs</application> oder
             <application>XEmacs</application> (<filename
               role="package">editors/emacs</filename> oder <filename
               role="package">editors/xemacs</filename>)</term>
 
 	  <listitem>
             <para>Beide Texteditoren haben einen speziellen Modus zur
               Bearbeitung von SGML-Dokumenten entsprechend den
               Vorgaben einer SGML-DTD. Zus&auml;tzlich bieten sie
               Funktionen an, mit denen sich der Tippaufwand reduzieren
               und Fehlerwahrscheinlichkeit senken
               l&auml;&szlig;t.</para>
 
 
             <!--? Kandidat f&uuml;r Optimierung Oliver Fischer -->
             <para>Nat&uuml;rlich mu&szlig; nicht mit einem dieser
               Texteditoren gearbeitet werden; jeder andere Editor kann
               daf&uuml;r genausogut genutzt werden, doch vielleicht
               wird die Arbeit durch sie als effektiver empfunden
               werden.</para>
 
             <!--? Der vorherige Satz ist auch nicht erste Sahne. -->
 	    <!--<para>You do not need to use them; any text editor can be used to
 	      edit marked up documents.  You may find they make you more
 	      efficient.</para>-->
 	  </listitem>
 	</varlistentry>
       </variablelist>
 
       <para>Sofern Sie Vorschl&auml;ge haben, welche andere
         Software f&uuml;r die Verarbeitung oder Bearbeitung von
         SGML-Dokumenten in diese Liste mitaufgenommen werden sollte,
         senden Sie diese bitte an &a.doceng;.</para>
     </sect2>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->