Index: head/de_DE.ISO8859-1/books/fdp-primer/Makefile
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/Makefile	(revision 46772)
+++ head/de_DE.ISO8859-1/books/fdp-primer/Makefile	(revision 46773)
@@ -1,52 +1,54 @@
 #
 # $FreeBSD$
 # $FreeBSDde$
-# basiert auf: r38826
+# basiert auf: r42410
 #
 # Build the FreeBSD Documentation Project Primer.
 #
 MAINTAINER=de-bsd-translators@de.FreeBSD.org
 
 DOC?= book
 
 FORMATS?= html-split html
 
 INSTALL_COMPRESSED?= gz
 INSTALL_ONLY_COMPRESSED?=
 
 #
 # SRCS lists the individual XML files that make up the document. Changes
 # to any of these files will force a rebuild
 #
 
 # XML content
 SRCS=  book.xml
 SRCS+= overview/chapter.xml
-SRCS+= psgml-mode/chapter.xml
-SRCS+= see-also/chapter.xml
-SRCS+= sgml-markup/chapter.xml
-SRCS+= sgml-primer/chapter.xml
-SRCS+= stylesheets/chapter.xml
+SRCS+= tools/chapter.xml
+SRCS+= working-copy/chapter.xml
 SRCS+= structure/chapter.xml
 SRCS+= doc-build/chapter.xml
 SRCS+= the-website/chapter.xml
-SRCS+= tools/chapter.xml
+SRCS+= xml-primer/chapter.xml
+SRCS+= xhtml-markup/chapter.xml
+SRCS+= docbook-markup/chapter.xml
+SRCS+= stylesheets/chapter.xml
 SRCS+= translations/chapter.xml
 SRCS+= writing-style/chapter.xml
+SRCS+= editor-config/chapter.xml
+SRCS+= see-also/chapter.xml
 
 SRCS+= examples/appendix.xml
 
 # Images from the cross-document image library
 IMAGES_LIB=	callouts/1.png
 IMAGES_LIB+=	callouts/2.png
 IMAGES_LIB+=	callouts/3.png
 IMAGES_LIB+=	callouts/4.png
 IMAGES_LIB+=	callouts/5.png
 
 # Entities
 SRCS+= chapters.ent
 
 URL_RELPREFIX?=	../../../..
 DOC_PREFIX?=	${.CURDIR}/../../..
 
 .include "${DOC_PREFIX}/share/mk/doc.project.mk"
Index: head/de_DE.ISO8859-1/books/fdp-primer/book.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/book.xml	(revision 46772)
+++ head/de_DE.ISO8859-1/books/fdp-primer/book.xml	(revision 46773)
@@ -1,269 +1,279 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
 	"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
 <!ENTITY % chapters SYSTEM "chapters.ent">
 %chapters;
 ]>
 <!-- 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.xml,v 1.24 2012/03/25 14:39:26 bcr Exp $
-     basiert auf: r40986
+     $FreeBSDde$
+     basiert auf: r44895
 -->
 <book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="de">
   <info><title>Die Fibel für neue Mitarbeiter des
       FreeBSD-Dokumentationsprojekts</title>
-    
 
+    <author><orgname>The FreeBSD Documentation Project</orgname></author>
+
     <copyright>
-      <year>1998-2012</year>
+      <year>1998-2014</year>
       <holder>The FreeBSD Documentation Project</holder>
     </copyright>
 
     <copyright>
-      <year>1998-2012</year>
+      <year>1998-2015</year>
       <holder>The FreeBSD German Documentation Project</holder>
     </copyright>
 
     <pubdate role="rcs">$FreeBSD$</pubdate>
 
     <releaseinfo>$FreeBSD$</releaseinfo>
 
     &legalnotice;
 
     <abstract>
       <para>Vielen Dank für Ihr Interesse und Ihre Mitarbeit an
-        der FreeBSD-Dokumentation. Jeder Beitrag ist für uns sehr
-        wichtig.</para>
+        der FreeBSD-Dokumentation.  Wir freuen uns über jeden Beitrag.</para>
 
-      <para>In dieser Fibel wird von der eingesetzten Software bis hin
-        zu den Vorstellungen des FreeBSD-Dokumentationsprojekts alles
-        behandelt, was Sie wissen müssen, wenn Sie sich am
-        FreeBSD-Dokumentationsprojekt beteiligen wollen.</para>
+      <para>Diese Fibel enthält die Informationen, die Sie für die
+	Mitarbeit am FreeBSD-Dokumentationsprojekt (auch als
+	<acronym>FDP</acronym> bekannt) benötigen.  Diese reichen von
+	verpflichtender und optionaler Software bis hin zur Philosophie
+	des FreeBSD-Dokumentationsprojekts.</para>
 
       <para>Bitte beachten Sie, dass diese Fibel
         <emphasis>jederzeit</emphasis> unter Bearbeitung und noch
-        nicht vollständig ist.</para>
+        nicht vollständig ist.  Falls Sie einen Fehler finden, würden
+	wir uns freuen, wenn Sie uns darüber informieren.</para>
     </abstract>
   </info>
 
   <preface xml:id="preface">
     <title>Benutzungshinweise</title>
 
     <sect1 xml: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ührt werden sollten.</para>
+      <para>Die folgende Tabelle enthält die Eingabeaufforderung eines
+	normalen Benutzers sowie die des Superusers. Die in
+        diesem Buch verwendeten Beispiele benutzen die jeweilige
+        Eingabeaufforderung, um zu zeigen, als welcher Benutzer die
+        Beispiele ausgeführt werden.</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Benutzer</entry>
 	      <entry>Eingabeaufforderung</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><systemitem class="username">Normaler Benutzer</systemitem></entry>
 	      <entry>&prompt.user;</entry>
 	    </row>
 
 	    <row>
 	      <entry><systemitem class="username">Superuser</systemitem></entry>
 	      <entry>&prompt.root;</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
     </sect1>
 
     <sect1 xml:id="preface-conventions">
       <title>Typographische Festlegungen</title>
 
       <para>Um die Lesbarkeit zu erhö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
 		<filename>.login</filename>.</entry>
 	    </row>
 
 	    <row>
-	     <entry>Bildschirmein- und ausgaben</entry>
+	     <entry>Bildschirmausgaben</entry>
 
 	     <entry><screen>You have mail.</screen></entry>
 	    </row>
 
 	    <row>
+	     <entry>Bildschirmein- und ausgaben</entry>
+
+	    <entry><screen>&prompt.user; <userinput>date +"The time is %H:%M"</userinput>
+The time is 09:18</screen></entry>
+	    </row>
+
+	    <row>
 	      <entry>Referenzen auf Hilfeseiten</entry>
 
 	      <entry>Mit &man.su.1; können Sie sich als ein anderer
                 Benutzer anmelden.</entry>
 	    </row>
 
 	    <row>
 	      <entry>Benutzer- und Gruppennamen</entry>
 
-	      <entry>Ich bin <systemitem class="username">root</systemitem>, ich darf
-                das.</entry>
+	      <entry>Ich bin <systemitem class="username">root</systemitem>,
+	        ich darf das.</entry>
 	    </row>
 
 	    <row>
 	      <entry>Hervorhebungen</entry>
 
 	      <entry>Hier <emphasis>müssen</emphasis> Sie
                 vorsichtig sein.</entry>
 	    </row>
 
 	    <row>
-	      <entry>Argumente auf der Kommandozeile, die durch
-                existierende Namen, Dateien oder Variablen ersetzt
-                werden müssen</entry>
+	      <entry>Text, der vom Benutzer durch seine Eingaben ersetzt
+		werden muss</entry>
 
-	      <entry>Dateien können Sie mit dem Befehl
-                <command>rm
-                  Dateiname</command>
-                löschen.</entry>
+	      <entry>Um die Hilfeseiten nach einem bestimmten Begriff zu
+		durchsuchen, geben Sie
+		<command>man -k <replaceable>Suchbegriff</replaceable></command>
+		ein.</entry>
 	    </row>
 
 	    <row>
 	      <entry>Umgebungsvariablen</entry>
 
 	      <entry><envar>$HOME</envar> ist Ihr
                 Benutzerverzeichnis.</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
     </sect1>
 
     <sect1 xml:id="preface-notes">
       <title>Anmerkungen, Tipps, wichtige Hinweise, Warnungen und
         Beispiel</title>
 
       <para>An einigen Stellen innerhalb dieses Buchs werden
         wichtige oder nützliche Hinweise gegeben, die besonders
         hervorgehoben sind. Hier ein kurzer Überblick ü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ö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ätzlich auszuführende
           Schritte oder Dinge, die besonders zu beachten sind.</para>
       </important>
 
       <warning>
         <para>Warnungen werden wie dieser Abschnitt dargestellt und
           weisen auf mögliche Schäden hin, die entstehen
           können, falls die beschriebenen Schritte nicht genau
           befolgt oder Hinweise nicht beachtet werden. Die Palette der
           möglichen Schäden reicht von Hardwareschäden
           bis hin zu Datendatenverlust durch ein versehentliches
           Lö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 Übungen, die nachvollzogen werden sollten,
           um das vorher beschriebene besser zu verinnerlichen oder mit
           den erzeugten Ausgaben vertraut zu werden.</para>
       </example>
     </sect1>
 
     <sect1 xml:id="preface-acknowledgements">
       <title>Danksagungen</title>
 
       <para>Ich möchte mich bei Sue Blake, Patrick Durusau, Jon
         Hamilton, Peter Flynn und Christopher Maden bedanken, die sich
         die Zeit genommen haben, die frühen Entwürfe dieses
         Dokuments zu lesen und viele hilfreiche Hinweise und
         Ratschläge gegeben haben.</para>
     </sect1>
   </preface>
 
   &chap.overview;
   &chap.tools;
-  &chap.xml-primer;
-  &chap.xml-markup;
-  &chap.stylesheets;
+  &chap.working-copy;
   &chap.structure;
   &chap.doc-build;
   &chap.the-website;
+  &chap.xml-primer;
+  &chap.xhtml-markup;
+  &chap.docbook-markup;
+  &chap.stylesheets;
   &chap.translations;
   &chap.writing-style;
-  &chap.psgml-mode;
+  &chap.editor-config;
   &chap.see-also;
 
   &app.examples;
 
   <index/>
 </book>
Index: head/de_DE.ISO8859-1/books/fdp-primer/chapters.ent
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/chapters.ent	(revision 46772)
+++ head/de_DE.ISO8859-1/books/fdp-primer/chapters.ent	(revision 46773)
@@ -1,28 +1,30 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!--
      Creates entities for each chapter in the Documentation Project Primer.
      Each entity is named chap.foo, where foo is the value of the id
      attribute on that chapter, and corresponds to the name of the
       directory in which that chapter's .xml file is stored.
 
      Chapters should be listed in the order in which they are referenced.
 
      $FreeBSD$
      $FreeBSDde$
-     basiert auf: r38826
+     basiert auf: r42410
 -->
 
 <!ENTITY chap.overview		SYSTEM "overview/chapter.xml">
-<!ENTITY chap.xml-primer	SYSTEM "sgml-primer/chapter.xml">
 <!ENTITY chap.tools		SYSTEM "tools/chapter.xml">
-<!ENTITY chap.xml-markup       SYSTEM "sgml-markup/chapter.xml">
-<!ENTITY chap.stylesheets	SYSTEM "stylesheets/chapter.xml">
+<!ENTITY chap.working-copy      SYSTEM "working-copy/chapter.xml">
 <!ENTITY chap.structure         SYSTEM "structure/chapter.xml">
+<!ENTITY chap.doc-build		SYSTEM "doc-build/chapter.xml">
 <!ENTITY chap.the-website	SYSTEM "the-website/chapter.xml">
+<!ENTITY chap.xml-primer	SYSTEM "xml-primer/chapter.xml">
+<!ENTITY chap.xhtml-markup      SYSTEM "xhtml-markup/chapter.xml">
+<!ENTITY chap.docbook-markup    SYSTEM "docbook-markup/chapter.xml">
+<!ENTITY chap.stylesheets	SYSTEM "stylesheets/chapter.xml">
 <!ENTITY chap.translations	SYSTEM "translations/chapter.xml">
 <!ENTITY chap.writing-style	SYSTEM "writing-style/chapter.xml">
-<!ENTITY chap.psgml-mode	SYSTEM "psgml-mode/chapter.xml">
+<!ENTITY chap.editor-config	SYSTEM "editor-config/chapter.xml">
 <!ENTITY chap.see-also		SYSTEM "see-also/chapter.xml">
-<!ENTITY chap.doc-build		SYSTEM "doc-build/chapter.xml">
 
 <!ENTITY app.examples		SYSTEM "examples/appendix.xml">
Index: head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml	(revision 46772)
+++ head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml	(revision 46773)
@@ -1,540 +1,499 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- Copyright (c) 1999 Neil Blakey-Milner, 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 THE AUTHOR "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$
-     basiert auf: r39631
+     basiert auf: r44068
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="doc-build">
   <info><title>Die Erzeugung der Zieldokumente</title>
     <authorgroup>
       <author><personname><firstname>Johann</firstname><surname>Kois</surname></personname><contrib>Übersetzt von </contrib></author>
     </authorgroup>
   </info>
 
   
 
   <para>Dieses Kapitels erklärt detailliert,
     <emphasis>wie der Bau der Dokumentation organisiert
-    ist</emphasis> und <emphasis>wie Sie diesen Prozess beeinflussen
-    können</emphasis>.</para>
+    ist</emphasis> und wie Sie diesen Prozess mit &man.make.1;
+    beeinflussen können.</para>
 
-  <para>Nachdem Sie dieses Kapitel gelesen haben, werden Sie:</para>
-
-  <itemizedlist>
-    <listitem>
-      <para>Wissen, wie Sie (unter Verwendung der im Kapitel <link linkend="tools">SGML-Werkzeuge</link> beschriebenen Tools)
-	die FDP-Dokumentation selbst bauen können.</para>
-    </listitem>
-
-    <listitem>
-      <para>In der Lage sein, sowohl die
-	<application>make</application>-Anweisungen der für
-	jedes Dokument benötigten <filename>Makefile</filename>s
-	als auch die Anweisungen der projektweiten Vorgaben der Datei
-	<filename>doc.project.mk</filename> zu lesen und zu
-	verstehen.</para>
-    </listitem>
-
-    <listitem>
-      <para>Den Bau der Dokumentation über
-	<application>make</application>-Variablen und
-	<application>make</application>-Target anpassen
-	können.</para>
-    </listitem>
-  </itemizedlist>
-
   <sect1 xml:id="doc-build-toolset">
-    <title>Für den Bau der FreeBSD-Dokumentation benötigte
+    <title>Für den Bau der &os;-Dokumentation benötigte
       Werkzeuge</title>
 
-    <para>Zusätzlich zu den im Kapitel <link linkend="tools">XML-Werkzeuge</link> beschriebenen
-      Werkzeugen benötigen Sie noch folgende Programme:</para>
+    <para>Die folgende Werkzeuge werden benötigt, um die
+      <acronym>FDP</acronym>-Dokumente zu bauen und zu installieren.</para>
 
     <itemizedlist>
       <listitem>
-	<para>Das wichtigste Werkzeug zum Bau der Dokumentation ist
-	  <application>make</application>, genauer
+	<para>Das wichtigste Werkzeug ist &man.make.1;, genauer
 	  <application>Berkeley Make</application>.</para>
       </listitem>
 
       <listitem>
 	<para>Der Bau von Paketen erfolgt unter FreeBSD mit
-	  <application>pkg_create</application>.  Wenn Sie ein
-	  anderes Betriebssystem als FreeBSD einsetzen, müssen
-	  Sie entweder ohne Pakete auskommen oder den Quellcode
-	  selbst kompilieren.</para>
+	  &man.pkg.create.1;.</para>
       </listitem>
 
       <listitem>
-	<para><application>gzip</application> dient zur Erstellung
-	  komprimierter Versionen der Dokumentation.  Unterstützt
-	  werden sowohl <application>bzip2</application>- als auch
-	  <application>zip</application>-Archive.  Wollen Sie Pakete
-	  der Dokumentation erstellen, benötigen Sie auch noch
-	  <application>tar</application>.</para>
+	<para>&man.gzip.1; dient zur Erstellung
+	  komprimierter Versionen der Dokumentation. &man.bzip2.1; wird
+	  ebenfalls unterstützt.  Wollen Sie Pakete der Dokumentation
+	  erstellen, benötigen Sie auch &man.tar.1;.</para>
       </listitem>
 
       <listitem>
-	<para>Mit <application>install</application> installieren
-	  Sie in der Standardeinstellung die Dokumentation auf Ihrem
-	  System.  Es gibt aber auch alternative Wege, die Dokumentation
-	  zu installieren.</para>
+	<para>Mit &man.install.1; installieren Sie die Dokumentation auf
+	  Ihrem System.</para>
       </listitem>
     </itemizedlist>
  </sect1>
 
   <sect1 xml:id="doc-build-makefiles">
     <title>Die <filename>Makefile</filename>s des Dokumentationsbaums
       verstehen</title>
 
-    <para>Innerhalb des FreeBSD Documentation Projects gibt es drei
+    <para>Innerhalb des &os; Documentation Projects gibt es drei
       verschiedene Arten von <filename>Makefile</filename>s:</para>
 
     <itemizedlist>
       <listitem>
 	<para>Ein <link linkend="sub-make">
 	  <filename>Makefile</filename></link> in einem
 	  Unterverzeichnis gibt Anweisungen an dessen Dateien und
 	  Unterverzeichnisse weiter.</para>
       </listitem>
 
       <listitem>
 	<para>Ein <link linkend="doc-make">
 	  Dokument-<filename>Makefile</filename></link> beschreibt das
 	  Dokument, das aus dem Inhalt des jeweiligen Verzeichnisses
 	  gebaut werden soll.</para>
       </listitem>
 
       <listitem>
 	<para><link linkend="make-includes">
 	  <application>Make</application>-Includes</link> sind der
 	  "Klebstoff", der für den Bau der Dokumentation
 	  erforderlich ist.  In der Regel heissen diese Dokumente
-	  <filename>doc.xxx.mk</filename>.</para>
+	  <filename>doc.<replaceable>xxx</replaceable>.mk</filename>.</para>
       </listitem>
     </itemizedlist>
 
     <sect2 xml:id="sub-make">
       <title>Unterverzeichnis-<filename>Makefile</filename>s</title>
 
       <para>Derartige <filename>Makefile</filename>s sind in der Regel
 	wie folgt aufgebaut:</para>
 
       <programlisting>SUBDIR =articles
 SUBDIR+=books
 
 COMPAT_SYMLINK = en
 
 DOC_PREFIX?= ${.CURDIR}/..
 .include "${DOC_PREFIX}/share/mk/doc.project.mk"</programlisting>
 
       <para>Die ersten vier nicht-leeren Zeilen definieren die
-	<application>make</application>-Variablen
+	&man.make.1;-Variablen
 	<varname>SUBDIR</varname>, <varname>COMPAT_SYMLINK</varname>,
 	und <varname>DOC_PREFIX</varname>.</para>
 
-      <para>Die erste <varname>SUBDIR</varname>-Anweisung weist
+      <para>Die <varname>SUBDIR</varname>-Anweisung weist
 	(ebenso wie die <varname>COMPAT_SYMLINK</varname>-Anweisung)
 	einer Variable einen Wert zu und überschreibt dabei
 	deren ursprünglichen Wert.</para>
 
       <para>Die zweite <varname>SUBDIR</varname>-Anweisung zeigt,
 	wie man den aktuellen Wert einer Variable ergänzen
 	kann.  Nach der Ausführung dieser Anweisung hat die
 	Variable <varname>SUBDIR</varname> den Wert
 	<literal>articles books</literal>.</para>
 
       <para>Die Anweisung <varname>DOC_PREFIX</varname> zeigt, wie
 	man einer Variable einen Wert zuweist (vorausgesetzt, die
 	Variable ist nicht bereits definiert).  Eine derartige
 	Anweisung ist beispielsweise sinnvoll, wenn sich
 	<varname>DOC_PREFIX</varname> nicht dort befindet, wo es
 	vom <filename>Makefile</filename> erwartet wird.
 	Durch das Setzen dieser Variable kann der korrekte Wert an
 	das Makefile übergeben werden.</para>
 
       <para>Was heißt dies nun konkret?  Mit den
 	<varname>SUBDIR</varname>-Anweisungen legen Sie fest, welche
 	Unterverzeichnisse beim Bau der Dokumentation eingeschlossen
 	werden müssen.</para>
 
       <para><varname>COMPAT_SYMLINK</varname> wird zur Erstellung
 	von symbolischen Links zwischen den jeweiligen Dokumentsprachen
 	und deren offizieller Kodierung benötigt (so wird
 	beispielsweise <filename>doc/en</filename> nach
 	<filename>en_US.ISO-8859-1</filename> verlinkt).</para>
 
       <para><varname>DOC_PREFIX</varname> gibt den Pfad zum
 	Wurzelverzeichnis des Quellcode-Baums des FreeBSD Documentation
 	Projects an.  Diese Vorgabe kann jederzeit durch einen eigenen
 	Wert ersetzt werden.  Bei <varname>.CURDIR</varname> handelt es
-	sich um eine in <application>make</application> eingebaute
+	sich um eine in  &man.make.1; eingebaute
 	Variable, die den Pfad des aktuellen Verzeichnisses
 	enthält.</para>
 
       <para>Die letzte Zeile bindet <filename>doc.project.mk</filename>,
-	die zentrale, projektweite <application>make</application>-Datei
-	des FreeBSD Documentation Projects, in den Bau ein.  Diese Datei
+	die zentrale, projektweite &man.make.1;-Datei
+	des &os; Documentation Projects, in den Bau ein.  Diese Datei
 	enthält den "Klebstoff", der die diversen Variablen in
 	Anweisungen zum Bau der Dokumentation konvertiert.</para>
 
     </sect2>
     <sect2 xml:id="doc-make">
       <title>Dokument-<filename>Makefile</filename>s</title>
 
       <para>Diese <filename>Makefile</filename>s definieren diverse
 	<application>make</application>-Variablen mit Vorgaben
 	zum Bau der im Verzeichnis enthaltenen Dokumentation.</para>
 
       <para>Dazu ein Beispiel:</para>
 
       <programlisting>MAINTAINER=nik@FreeBSD.org
 
 DOC?= book
 
 FORMATS?= html-split html
 
 INSTALL_COMPRESSED?= gz
 INSTALL_ONLY_COMPRESSED?=
 
 # SGML content
 SRCS=  book.xml
 
 DOC_PREFIX?= ${.CURDIR}/../../..
 
 .include "$(DOC_PREFIX)/share/mk/docproj.docbook.mk"</programlisting>
 
       <para>Die Variable <varname>MAINTAINER</varname> ist von
 	zentraler Bedeutung.  Sie legt fest, wer für ein
 	bestimmtes Dokument des FreeBSD Documentation Projects
 	verantwortlich ist.</para>
 
       <para><varname>DOC</varname> (ohne die Erweiterung
 	<filename>.xml</filename>) ist der Name des Hauptdokuments des
 	Verzeichnisses, in dem sich das Makefile befindet.  Mit
 	<varname>SRCS</varname>-Anweisungen geben Sie alle Dokumente an,
 	aus denen das Dokument besteht.  Zusätzlich binden Sie
 	damit wichtige Dateien ein, deren Änderung einen erneuten
 	Bau der Dokumentation erforderlich macht.</para>
 
       <para>Mit <varname>FORMATS</varname> geben Sie an, in welchen
 	Formaten die Dokumentation gebaut werden soll.
 	<varname>INSTALL_COMPRESSED</varname> enthält die
 	Standardvorgaben, die beim Bau komprimierter Pakte der
 	Dokumentation verwendet werden sollen.  Der Variable
 	<varname>INSTALL_ONLY_COMPRESS</varname> (die in der
 	Voreinstellung leer ist) wird nur dann ein Wert zugewiesen,
 	wenn ausschließlich komprimierte Pakete der Dokumentation
 	erstellt werden sollen.</para>
 
-      <note>
-	<para>Die Zuweisung von Werten an verschiedene Variablen wurde
-	  bereits im Abschnitt <link linkend="sub-make">Unterverzeichnis-Makefiles</link>
-	  behandelt.</para>
-      </note>
-
       <para>Die Variable <varname>DOC_PREFIX</varname> und die
 	verschiedenen Include-Anweisungen sollten Ihnen ebenfalls
 	bereits vertraut sein.</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="make-includes">
-    <title><application>Make</application>-Includes des FreeBSD
-      Documentation Projects</title>
+    <title>&man.make.1;-Includes des &os; Documentation Projects</title>
 
     <para>Diese Dateien lassen sich am besten verstehen, indem man sich
       deren Inhalt näher ansieht.  Konkret handelt es sich dabei
       um folgende Dateien:</para>
 
     <itemizedlist>
       <listitem>
 	<para><filename>doc.project.mk</filename> ist die
 	  Haupt-Include-Datei, die bei Bedarf alle folgenden
 	  Include-Dateien enthält.</para>
       </listitem>
 
       <listitem>
 	<para><filename>doc.subdir.mk</filename> sorgt dafür, dass
 	  alle benötigten Verzeichnisse (und Unterverzeichnisse)
 	  beim Bau der Dokumentation durchlaufen werden.</para>
       </listitem>
 
       <listitem>
 	<para><filename>doc.install.mk</filename> definiert Variablen,
 	  die die Installation der Dokumentation beeinflussen.</para>
       </listitem>
 
       <listitem>
 	<para><filename>doc.docbook.mk</filename> wird verwendet, wenn
 	  die Variable <varname>DOCFORMAT</varname> den Wert
 	  <literal>docbook</literal> hat und die Variable
 	  <varname>DOC</varname> gesetzt ist.</para>
       </listitem>
     </itemizedlist>
 
     <sect2>
       <title><filename>doc.project.mk</filename></title>
 
       <para>Diese Datei hat folgenden Aufbau:</para>
 
       <programlisting>DOCFORMAT?=	docbook
 MAINTAINER?=	doc@FreeBSD.org
 
 PREFIX?=	/usr/local
 PRI_LANG?=	en_US.ISO8859-1
 
 .if defined(DOC)
 .if ${DOCFORMAT} == "docbook"
 .include "doc.docbook.mk"
 .endif
 .endif
 
 .include "doc.subdir.mk"
 .include "doc.install.mk"</programlisting>
 
       <sect3>
 
 	<title>Variablen</title>
 
 	<para><varname>DOCFORMAT</varname> und <varname>MAINTAINER</varname>
 	  enthalten Standardwerte, falls ihnen über das
 	  Dokument-Makefile keine anderen Werte zugewiesen werden.</para>
 
 	<para>Bei <varname>PREFIX</varname> handelt es sich um das
 	  Präfix, unter dem die zum Bau der Dokumentation
 	  erforderlichen <link linkend="tools">SGML-Werkzeuge</link>
 	  installiert sind.  In der Regel handelt es sich dabei um
 	  <filename>/usr/local</filename>.</para>
 
 	<para><varname>PRI_LANG</varname> sollte auf die Sprache und
 	  Kodierung eingestellt werden, die unter den Leser der
 	  Dokumentation am häufigsten verwendet wird.  Diese
 	  Variable hat den Standardwert "US English".</para>
 
 	<note>
-	  <para><varname>PRI_LANG</varname> beeinflusst in keinster
-	    Weise, welche Dokumente gebaut werden können oder
+	  <para><varname>PRI_LANG</varname> beeinflusst nicht,
+	    welche Dokumente gebaut werden können oder
 	    sollen.  Diese Variable wird lediglich dazu verwendet,
 	    häufig verwendete Dokumente in das Wurzelverzeichnis
 	    der installierten Dokumentation zu verlinken.</para>
 	</note>
       </sect3>
 
       <sect3>
 	<title>Bedingungen</title>
 
 	<para>Die Zeile <literal>.if defined(DOC)</literal> ist ein
-	  Beispiel für eine
-	  <application>make</application>-Bedingung, die (analog zum
+	  Beispiel für eine &man.make.1;-Bedingung, die (analog zum
 	  Einsatz in anderen Programmen) festlegt, was geschehen soll,
 	  wenn eine Bedingung "wahr" oder "falsch" ist.
 	  <literal>defined</literal> ist eine Funktion, die
 	  zurückgibt, ob die angegebene Variable existiert oder
 	  nicht.</para>
 
 	<para><literal>.if ${DOCFORMAT} == "docbook"</literal> testet,
 	  ob die Variable <varname>DOCFORMAT</varname> den Wert
 	  <literal>"docbook"</literal> hat.  Ist dies der Fall, wird
 	  <filename>doc.docbook.mk</filename> mit in den Bau
 	  aufgenommen.</para>
 
 	<para>Die zwei <literal>.endif</literal>s schließen die
 	  zwei weiter oben definierten Bedingungen.</para>
       </sect3>
     </sect2>
 
     <sect2>
       <title><filename>doc.subdir.mk</filename></title>
 
       <para>Den Inhalt dieser Datei hier zu beschreiben, würde
 	zu weit führen.  Sie sollten aber nach dem Lesen der
 	vorangegangenen Abschnitte und der folgenden Ausführungen
 	in der Lage sein, Inhalt und Aufgabe dieser Datei zu
 	verstehen.</para>
 
       <sect3>
 	<title>Variablen</title>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><varname>SUBDIR</varname> legt die Unterverzeichnisse
 	      fest, deren Inhalt beim Bau der Dokumentation inkludiert
 	      werden muss.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>Mit <varname>ROOT_SYMLINKS</varname> wird der Name der
 	      Verzeichnisse angegeben, die von ihrer tatsächlichen
 	      Position aus in das Wurzelverzeichnis, unter dem die
 	      Dokumentation installiert wird, verlinkt werden sollen.
 	      Vorausgesetzt, bei der verwendeten Sprache handelt es sich
 	      um die primäre Sprache (die über
 	      <varname>PRI_LANG</varname> festgelegt wird).</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>COMPAT_SYMLINK</varname> wird im Abschnitt
 	      <link linkend="sub-make">Unterverzeichnis-Makefile</link>s
 	      beschrieben.</para>
 	  </listitem>
 	</itemizedlist>
       </sect3>
 
       <sect3>
 	<title>Targets und Makros</title>
 
 	<para>Abhängigkeiten
 	  (<foreignphrase>Dependencies</foreignphrase>) werden
 	  folgendermaßen definiert:
-	  <literal>target
-	  abhaengigkeit1 abhaengigkeit2 ...</literal>.
+	  <literal><replaceable>target</replaceable>
+	  <replaceable>abhaengigkeit1 abhaengigkeit2 ...</replaceable></literal>.
 	  Um <literal>target</literal> zu bauen, müssen Sie zuvor
 	  die angegebenen Abhängigkeiten bauen.</para>
 
 	<para>Daran anschließend können Anweisungen zum
 	  Bau des angegebenen Targets folgen, falls der
 	  Konvertierungsprozess zwischen dem Target und seinen
 	  Abhängigkeiten nicht bereits früher definiert
 	  wurde oder falls die Konvertierung nicht der
 	  Standardkonvertierungsmethode entspricht.</para>
 
 	<para>Die spezielle Abhängigkeit <literal>.USE</literal>
 	  definiert das Äquivalent eines Makros.</para>
 
 <programlisting>_SUBDIRUSE: .USE
 .for entry in ${SUBDIR}
 	@${ECHO} "===&gt; ${DIRPRFX}${entry}"
 	@(cd ${.CURDIR}/${entry} &amp;&amp; \
 	${MAKE} ${.TARGET:S/realpackage/package/:S/realinstall/install/} DIRPRFX=${DIRPRFX}${entry}/ )
 .endfor</programlisting>
 
 	<para>In diesem Beispiel kann <buildtarget>_SUBDIRUSE</buildtarget>
 	  nun als Makro, welches die angegebenen Befehle ausführt,
 	  verwendet werden, indem es im Makefile als Abhängigkeit
 	  angegeben wird.</para>
 
 	<para>Was unterscheidet dieses Makro nun von beliebigen anderen
 	  Targets?  Der Hauptunterschied ist, dass es
 	  <emphasis>nach</emphasis> den Anweisungen der Bauprozedur,
 	  in der es als Abhängigkeit angegeben ist, ausgeführt
 	  wird.  Außerdem ändert es die Variable
 	  <varname>.TARGET</varname> (die den Namen des aktuell gebauten
 	  Targets enthält) nicht.</para>
 
 <programlisting>clean: _SUBDIRUSE
 	rm -f ${CLEANFILES}</programlisting>
 
 	<para>In diesem Beispiel führt <buildtarget>clean</buildtarget>
 	  das Makro <buildtarget>_SUBDIRUSE</buildtarget> aus, nachdem es
 	  den Befehl <command>rm -f ${CLEANFILES}</command> erfolgreich
 	  ausgeführt hat.  Dadurch löscht
 	  <buildtarget>clean</buildtarget> zwar beim Wechsel in ein neues
 	  <emphasis>Unterverzeichnis</emphasis> beim Bau erstellte
 	  Dateien, aber nicht beim Wechsel aus einem Unterverzeichnis
 	  in ein übergeordnetes Verzeichnis.</para>
 
 	<sect4>
 	  <title>Vorhandene Targets</title>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para><buildtarget>install</buildtarget> und
 		<buildtarget>package</buildtarget> arbeiten nacheinander
 		alle Unterverzeichnisse ab und rufen dabei jeweils ihre
 		realen Versionen (<buildtarget>realinstall</buildtarget>
 		beziehungsweise <buildtarget>realpackage</buildtarget>)
 		auf.</para>
 	    </listitem>
 
 	    <listitem>
 	      <para><buildtarget>clean</buildtarget> entfernt alle
 		Dateien, die beim Bau der Dokumentation erzeugt wurden
 		(dies sowohl im aktuellen Verzeichnis als auch in allen
 		Unterverzeichnissen).  <buildtarget>cleandir</buildtarget>
 		hat die gleiche Aufgabe, würde aber zusätzlich
 		die Objekt-Verzeichnisse löschen (falls diese
 		existieren).</para>
 	    </listitem>
 	  </itemizedlist>
 	</sect4>
       </sect3>
 
       <sect3>
 	<title>Weitere Bedingungen</title>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><literal>exists</literal> gibt "wahr" zurück, wenn
 	      die angegebene Datei bereits existiert.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><literal>empty</literal> gibt "wahr" zurück, wenn
 	      die angegebene Variable leer ist.</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><literal>target</literal> gibt "wahr" zurück, wenn
 	      das angegebene Target noch nicht existiert.</para>
 	  </listitem>
 	</itemizedlist>
       </sect3>
 
       <sect3>
 	<title>Schleifenkonstrukte in
 	  <command>make (.for)</command></title>
 
 	<para><literal>.for</literal> erlaubt es, bestimmte
 	  Anweisungen für jedes Element einer Variable zu
 	  wiederholen, indem dieser Variable in jedem Durchlauf
 	  der Schleife das jeweilige Element der untersuchten Liste
 	  zugewiesen wird.</para>
 
 <programlisting>_SUBDIRUSE: .USE
 .for entry in ${SUBDIR}
 	@${ECHO} "===&gt; ${DIRPRFX}${entry}"
 	@(cd ${.CURDIR}/${entry} &amp;&amp; \
 	${MAKE} ${.TARGET:S/realpackage/package/:S/realinstall/install/} DIRPRFX=${DIRPRFX}${entry}/ )
 .endfor</programlisting>
 
 	<para>Falls das Verzeichnis <varname>SUBDIR</varname> leer ist,
 	  würde in unserem Beispiel keine Aktion erfolgen.
 	  Enthält das Verzeichnis hingegen ein oder mehrere
 	  Elemente, werden die Anweisungen zwischen
 	  <literal>.for</literal> und <literal>.endfor</literal>
 	  für jedes Element ausgeführt, wobei
 	  <varname>entry</varname> durch das jeweilige Element ersetzt
 	  werden würde.</para>
       </sect3>
     </sect2>
   </sect1>
 </chapter>
Index: head/de_DE.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml	(nonexistent)
+++ head/de_DE.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml	(revision 46773)
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- Copyright (c) 2013 Warren Block
+    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 THE AUTHOR "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$
+     basiert auf:
+-->
+
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="docbook-markup">
+  <title>DocBook Markup (noch nicht übersetzt)</title>
+
+  <para>Dieses Kapitel ist noch nicht übersetzt.  Lesen Sie daher bitte
+    das <link
+    xlink:href="&url.books.fdp-primer.en;/docbook-markup.html">Original in
+    englischer Sprache</link>.  Wenn Sie bei der Übersetzung
+    mithelfen wollen, schicken Sie bitte eine E-Mail
+    an &a.de.translators;.</para>
+</chapter>

Property changes on: head/de_DE.ISO8859-1/books/fdp-primer/docbook-markup/chapter.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+FreeBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/xml
\ No newline at end of property
Index: head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml	(nonexistent)
+++ head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml	(revision 46773)
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- Copyright (c) 2013 Warren Block
+    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 THE AUTHOR "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$
+     basiert auf:
+-->
+
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="editor-config">
+  <title>Editor Configuration (noch nicht übersetzt)</title>
+
+  <para>Dieses Kapitel ist noch nicht übersetzt.  Lesen Sie daher bitte
+    das <link
+    xlink:href="&url.books.fdp-primer.en;/editor-config.html">Original in
+    englischer Sprache</link>.  Wenn Sie bei der Übersetzung
+    mithelfen wollen, schicken Sie bitte eine E-Mail
+    an &a.de.translators;.</para>
+</chapter>

Property changes on: head/de_DE.ISO8859-1/books/fdp-primer/editor-config/chapter.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+FreeBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/xml
\ No newline at end of property
Index: head/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.xml	(revision 46772)
+++ head/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.xml	(revision 46773)
@@ -1,357 +1,272 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- 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$
-     basiert auf: r41125
+     basiert auf: r46642
 
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="overview">
   <title>Überblick</title>
 
-  <para>Herzlich Willkommen beim FreeBSD-Dokumentationsprojekt.
-    Qualitativ hochwertige Dokumentation ist ein wichtiger
-    Erfolgsfaktor und sehr bedeutend für die Verbreitung von
-    FreeBSD. Die wichtigste Quelle dafür ist das
-    FreeBSD-Dokumentationsprojekt (FDP). Jeder Beitrag, der zu diesem
-    Projekt geleistet wird, ist ungemein wertvoll.</para>
+  <para>Herzlich Willkommen beim FreeBSD-Dokumentationsprojekt
+    (auch nur <acronym>FDP</acronym> genannt). Qualitativ hochwertige
+    Dokumentation ist sehr wichtig für den Erfolg von &os;.  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ä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ügbaren Werkzeuge effektiv beim Schreiben
-    eingesetzt werden können</emphasis>.</para>
+  <para>Dieses Dokument macht den Leser mit dem
+    <acronym>FDP</acronym> vertraut und erklärt, wie man
+    selbst Dokumente erstellt und einreicht und wie die verfügbaren
+    Werkzeuge effektiv beim Schreiben eingesetzt werden
+    können.</para>
 
-  <indexterm>
-    <primary>Mitgliedschaft</primary>
-  </indexterm>
+  <para>Jeder kann zum <acronym>FDP</acronym> beitragen.  Die einzige
+    Voraussetzung ist die Bereitschaft, helfen zu wollen.</para>
 
-  <para>Wie jedes Open-Source-Projekt, ist auch das FDP auf die Mithilfe
-    vieler angewiesen. Deshalb ist jeder herzlich eingeladen
-    mitzuarbeiten. Die dafü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üssen, ist sich auf der Mailingliste &a.doc; einzutragen.</para>
+  <para>Nach dem Lesen dieses Dokuments werden Sie in der Lage sein,</para>
 
-  <para>Nach dem Lesen der FDP-Fibel sollte man wissen:</para>
-
   <itemizedlist>
     <listitem>
-      <para>welche Dokumente durch das FDP betreut werden,</para>
+      <para>die vom <acronym>FDP</acronym> betreuten Dokumente zu
+	erkennen,</para>
     </listitem>
 
     <listitem>
-      <para>wie man SGML-Dokumente liest und den SGML-Quellcode der
-        durch das FDP betreuten Dokumente versteht,</para>
+      <para>die benötigten Dokumentations-Werkzeuge und Dateien
+	zu installieren,</para>
     </listitem>
 
     <listitem>
-      <para>wie man selbst Änderungen an Dokumenten vornehmen
-        kann und</para>
+      <para>Änderungen an der Dokumentation vorzunehmen,</para>
     </listitem>
 
     <listitem>
-      <para>wie man Änderungen zur Begutachtung durch das FDP
-        einreichen kann.</para>
+      <para>Änderungen zur Begutachtung durch das FDP
+        einreichen können.</para>
     </listitem>
   </itemizedlist>
 
   <sect1 xml:id="overview-doc">
     <title>Die FreeBSD-Dokumentationsreihe</title>
 
     <para>Das FDP umfasst vier verschiedene Kategorien:</para>
 
-    <variablelist>
-      <varlistentry>
-        <term>Manualpages</term>
-
+    <itemizedlist>
         <listitem>
-          <para>Die englischen Manualpages wurden nicht vom FDP
-            geschrieben, da sie ein Teil des Basissystems sind. Jedoch
-            können bzw. wurden bereits Teile von existierenden
-            Manualpages umformuliert, um sie verständlicher zu
-            machen oder um Fehler zu beheben.</para>
-
-          <para>Für die Übersetzung der Manualpages des
-            Systems in die verschiedenen Sprachen sind die einzelnen
-            Übersetzergruppen verantwortlich. Alle dabei
-            entstandenen Übersetzungen gehören zum
-            FDP.</para>
+          <para><emphasis>Handbook:</emphasis>  Das Handbuch ist die
+	    umfassende Quelle und Referenz für &os;-Benutzer.</para>
         </listitem>
-      </varlistentry>
 
-      <varlistentry>
-        <term>Die FAQ</term>
-
         <listitem>
-          <para>Das Ziel der FAQ ist es, Fragen, die auf den
-            verschiedenen Mailinglisten und in Newsgruppen
-            regelmäßig diskutiert werden, nach einem
-            einfachen  Frage- und Antwort-Muster zu behandeln. Das
-            schließt nicht aus, das auf bestimmte Fragen
-            ausführlich und umfassend eingegangen wird.</para>
+	  <para><emphasis>FAQ:</emphasis>  Eine Sammlung von kurzen
+	    Fragen und Antworten zu Themen, die auf den
+            verschiedenen Mailinglisten und in auf &os; spezialisierten
+	    Foren regelmäßig diskutiert werden.  Lange und komplizierte
+	    Antworten werden Sie hier nicht finden.</para>
         </listitem>
-      </varlistentry>
 
-      <varlistentry>
-        <term>Das Handbuch</term>
-
         <listitem>
-          <para>Das Ziel des Handbuches ist es, die
-            umfassende Quelle und Referenz im Netz für
-            FreeBSD-Benutzer zu sein.</para>
+	  <para><emphasis>Manualpages:</emphasis>  Die englischen
+	    Manualpages werden normalerweise nicht vom FDP
+            geschrieben, da sie ein Teil des Basissystems sind. Jedoch
+            können bzw. wurden bereits Teile von existierenden
+            Manualpages umformuliert, um sie verständlicher zu
+            machen oder um Fehler zu beheben.</para>
         </listitem>
-      </varlistentry>
 
-      <varlistentry>
-         <term>Die Webseite</term>
-
          <listitem>
-          <para>Die Webseite <link xlink:href="&url.base;/index.html">http://www.FreeBSD.org</link>
-            und ihre vielen Spiegel auf der ganzen Welt vertreten das
-            FreeBSD-Projekt im WWW. Für viele Menschen
-            ist sie der erste Kontakt mit FreeBSD.</para>
+	  <para><emphasis>Die Webseite:</emphasis>  Die Hauptpräsenz
+	    von &os; im Internet, zu erreichen unter <link
+	    xlink:href="http://www.freebsd.org/index.html">http://www.FreeBSD.org</link>
+            oder einem der zahlreichen Spiegelserver.  Für viele Menschen
+            ist sie der erste Kontakt mit &os;.</para>
 	</listitem>
-      </varlistentry>
-    </variablelist>
+    </itemizedlist>
 
+    <para>Übersetzer-Teams sind für die Übersetzung des Handbuchs und
+      der Webseite in verschiedene Sprachen verantwortlich.  Manualpages
+      werden derzeit nicht übersetzt.</para>
+
     <para>Die Quellen für die FreeBSD-Website, das &os; Handbuch
-      sowie die &os; FAQ werden im <literal>doc/</literal>
-      Subversion-Repository von &os; verwaltet, das Sie über
+      sowie die &os; <acronym>FAQ</acronym> werden im
+      Dokumentations-Repository von &os; verwaltet, das Sie über
       <literal>https://svn.FreeBSD.org/doc/</literal> erreichen
       können.</para>
 
-    <para>Manualpages werden im <literal>src/</literal>
-      Subversion-Repository von &os; verwaltet, das Sie über
+    <para>Manualpages werden von &os; im einem eigenen
+      Quellcode-Repository verwaltet, das Sie über
       <literal>https://svn.FreeBSD.org/base/</literal> erreichen
       können.</para>
 
-    <para>Das bedeutet, dass alle Änderungen an den
-      Dateien für jeden verfügbar sind und sich jeder
-      mit <application>svn</application> eine lokale Kopie der
-      Dokumentation anlegen kann.</para>
+   <para>Committ-Nachrichten des <acronym>FDP</acronym>
+      sind über <application>svn</application> abrufbar und werden
+      zusätzlich unter
+      <uri xlink:href="&a.svn-doc-all.url;">&a.svn-doc-all.url;</uri>
+      archiviert.</para>
 
-    <para>Parallel zum FDP haben viele Menschen Anleitungen
+    <para>Beide Repositories sind auch über ein Web-Interface erreichbar:
+      <link xlink:href="https://svnweb.FreeBSD.org/doc/"></link> sowie
+      <link xlink:href="https://svnweb.FreeBSD.org/base/"></link>.</para>
+
+    <para>Viele Menschen haben &os;-spezifische Anleitungen
       geschrieben und Webseiten mit Bezug zu FreeBSD erstellt. Einige
       davon werden im Subversion-Archiv verwaltet, sofern der Autor dem
       zugestimmt hat. In anderen Fällen hat sich der Autor
       entschlossen, seine Dokumentation außerhalb des zentralen
-      FreeBSD-Archivs zu verwalten. Das FDP bemüht sich, so
-      viele Verweise wie möglich auf solche Quellen
+      FreeBSD-Archivs zu verwalten. Das <acronym>FDP</acronym> bemüht sich,
+      so viele Verweise wie möglich auf solche Quellen
       bereitzustellen.</para>
   </sect1>
 
-  <sect1 xml:id="overview-before">
-    <title>Bevor es losgeht</title>
-
-    <para>Zum Verständnis der folgenden Kapitel sollte folgendes
-      bereits bekannt sein:</para>
-
-    <itemizedlist>
-      <listitem>
-        <para>Wie eine aktuelle lokale Kopie des FreeBSD
-	  Subversion-Repository mit Hilfe von
-	  <application>svn</application> angelegt und gepflegt
-	  werden kann.</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 xml:id="overview-quick-start">
-    <title>Der Schnellstart</title>
+    <title>Schnellstart</title>
 
-    <para>Falls man einfach loslegen möchte und sich sicher genug
-      fühlt, um alles weitere erst bei Bedarf nachzusehen, kann
-      man einfach den folgenden Anweisungen folgen:</para>
+    <para>Dieser Abschnitt beschreibt, was Sie tun müssen, bevor
+      Sie Änderungen an der &os;-Dokumentation vornehmen können.
+      Abonnieren Sie die Mailingliste &a.doc;.  Einige Mitglieder dieser
+      Mailingliste sind auch auf dem <acronym>IRC</acronym>-Kanal
+      <literal>#bsddocs</literal> auf <link
+      xlink:href="http://www.efnet.org/">EFnet</link> erreichbar.  Nehmen
+      Sie mit Ihnen Kontakt auf, wenn Sie Fragen oder Probleme bei
+      der Arbeit an der &os;-Dokumentation haben.</para>
 
     <procedure>
       <step>
-        <para>Zuerst muß der Metaport <package>textproc/docproj</package> auf dem
-          betreffenden Arbeitsrechner installiert werden.</para>
+	<para></para>
+      </step>
 
-	<screen>&prompt.root; <userinput>cd /usr/ports/textproc/docproj</userinput>
-&prompt.root; <userinput>make JADETEX=no install</userinput></screen>
+      <step>
+	<para>Installieren Sie den Metaport
+	  <package>textproc/docproj</package> als Port oder Paket, um
+	  automatisch alle für die Arbeit an der Dokumentation benötigten
+	  Werkzeuge zu installieren.</para>
       </step>
 
       <step>
-        <para>Laden Sie mit <application>svn</application> eine lokale
-	  Kopie des FreeBSD-<filename>doc</filename>-Verzeichnisbaumes
-	  herunter.</para>
+	<para>Installieren Sie eine lokale Arbeitskopie der Dokumentation
+	  von einem Spiegelserver des &os;-Repository nach
+	  <filename>~/doc</filename> (lesen Sie dazu
+	  auch <xref linkend="working-copy"/>).</para>
 
-        <para>Selbst wenn Sie nur über eine geringe Bandbreite
-	  oder wenig freien Plattenplatz verfügen, müssen Sie
-	  mindestens die Verzeichnisse <filename>head/share</filename>
-	  sowie
-	  <filename>head/language/share</filename>
-	  auschecken, um an der Dokumentation arbeiten zu können.
-	  Dazu ein Beispiel:</para>
+	<screen>&prompt.user; <userinput>svn checkout https://<replaceable>svn0.us-west.FreeBSD.org</replaceable>/doc/head <replaceable>~/doc</replaceable></userinput></screen>
+      </step>
 
-	<screen>&prompt.user; <userinput>mkdir -p head/share</userinput>
-&prompt.user; <userinput>mkdir -p head/en_US.ISO8859-1/share</userinput>
-&prompt.user; <userinput>svn checkout https://svn0.us-
-east.FreeBSD.org/doc/head/share head/share</userinput>
-&prompt.user; <userinput>svn checkout https://svn0.us-
-east.FreeBSD.org/doc/head/en_US.ISO8859-1/share head/en_US.ISO8859-1/share</userinput></screen>
+      <step>
+	<para>Ihr Texteditor sollte für die Arbeit an der
+	  &os;-Dokumentation wie folgt konfiguriert sein:</para>
 
-        <para>Für den Fall, dass ausreichend Platz auf der
-          Festplatte vorhanden ist, kann auch eine
-          vollständige Arbeitskopie des gesamten Subversion-Baumes
-          anlegt werden.</para>
+	  <itemizedlist>
+	    <listitem>
+	      <para>Zeilenumbruch nach 70 Zeichen.</para>
+	    </listitem>
+	    <listitem>
+	      <para>Tabstop auf 2 Zeichen.</para>
+	    </listitem>
+	    <listitem>
+	      <para>8 Leerzeichen sollen durch einen Tabstop ersetzt
+		werden.</para>
+	    </listitem>
+	  </itemizedlist>
 
-  <screen>&prompt.user; <userinput>svn checkout https://svn0.us-
-east.FreeBSD.org/doc/head head</userinput></screen>
-
-	<note>
-    	  <para><link xlink:href="https://svn0.us-east.FreeBSD.org/">svn0.us-east.FreeBSD.org</link>
-      	  ist ein öffentlicher Server. Wählen Sie einen Mirror
-          in Ihrer Nähe und überprüfen Sie das Serverzertifikat
-          auf der Seite <link xlink:href="&url.books.handbook;/svn-mirrors.html">Subversion
-          mirror sites</link>.</para>
-	</note>	      
+	  <para>Konfigurationen für einige häufig verwendete Editoren
+	    finden Sie im <xref linkend="writing-style"/>.</para>
       </step>
 
       <step>
-        <para>Sollte geplant sein, ein existierendes Buch oder einen
-          existierenden Artikel zu ändern, muß
-          natürlich noch zusä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ücher und Artikel
-          zurückzugreifen und diese als Vorlage zu nutzen.</para>
+	<para>Aktualisieren Sie Ihre lokale Arbeitskopie:</para>
 
-	<para>Ein Artikel über die Konfiguration eines VPNs
-	  zwischen FreeBSD und Windows&nbsp;2000 kann wie
-	  folgt erstellt werden:</para>
+	<screen>&prompt.user; <userinput>svn up <replaceable>~/doc</replaceable></userinput></screen>
+      </step>
 
-	<procedure>
-	  <step>
-	    <para>Zuerst wird das Verzeichnis
-              <filename>articles</filename> aus dem FreeBSD-CVS-Archiv
-              lokal angelegt:</para>
+      <step>
+	<para>Bearbeiten Sie die Datei.  Bevor Sie umfangreiche Änderungen
+	  an einer Datei vornehmen, kündigen Sie die geplanten Änderungen
+	  bitte auf der Mailingliste an.</para>
 
-      <screen>&prompt.user; <userinput>svn checkout https://svn0.us-
-east.FreeBSD.org/doc/head/en_US.ISO8859-1/articles</userinput></screen>
-	  </step>
+	<para>Eine Auflistung häufig verwendeter Tags und
+	  Entities finden Sie in <xref linkend="xhtml-markup"/> und
+	  in <xref linkend="docbook-markup"/>.</para>
+      </step>
 
-	  <step>
-            <para>Anschließ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>
+      <step>
+	<para>Nachdem Sie Ihre Änderungen vorgenommen haben, prüfen
+	  Sie diese auf potentielle Probleme:</para>
 
-	    <screen>&prompt.user; <userinput>cd head/en_US.ISO8859-1/articles</userinput>
-&prompt.user; <userinput>svn export committers-guide vpn-w2k</userinput></screen>
-	  </step>
-	</procedure>
+	<screen>&prompt.user; <userinput>igor -R filename.xml | less -RS</userinput></screen>
 
-	<para>Bereits existierende Dokumente, die geändert
-	  werden sollen, können direkt aus dem CVS-Archiv
-	  geholt werden.  Das folgende Beispiel zeigt das
-	  für die FAQ aus dem Verzeichnis
-          <filename>head/en_US.ISO8859-1/books/faq</filename>:</para>
-
-  <screen>&prompt.user; <userinput>svn checkout https://svn0.us-
-east.FreeBSD.org/doc/head/en_US.ISO8859-1/books/faq</userinput></screen>
+	<para>Werden Fehler gemeldet, editieren Sie die Datei erneut.
+	  Speichern Sie das Ergebnis und fühen Sie den Test erneut aus.
+	  Wiederholen Sie dies solange, bis keine Fehler mehr gemeldet
+	  werden.</para>
       </step>
 
       <step>
-        <para>Jetzt können die <filename>.xml</filename> Dateien
-          mit einem beliebigen Texteditor bearbeitet werden.</para>
+	<para>Bauen Sie die Dokumentation <emphasis>immer</emphasis>,
+	  bevor Sie Änderungen einreichen.  Dazu führen Sie
+	  <userinput>make</userinput> im Hauptverzeichnis des
+	  Dokuments aus, dass Sie gerade bearbeiten.  Um beispielsweise
+	  die deutsche Version des &os;-Handbuchs als einzelne
+	  <acronym>HTML</acronym>-Dateien zu bauen, führen Sie
+	  <userinput>make</userinput> im Verzeichnis
+	  <filename>de_DE.ISO8859-1/books/handbook/</filename> aus.
+	  Durch diesen Schritt wird sichergestellt, dass Ihre
+	  Änderungen den Bau der Dokumentation nicht wegen eines
+	  Fehlers abbrechen.</para>
       </step>
 
       <step>
-        <!--?
-        Vielleicht besser als Befehl auf der Kommandozeile
-        darstellen?
-        Oliver Fischer
-        -->
-        <para>Danach ist <command>make</command> mit dem Ziel
-          <buildtarget>lint</buildtarget> aufzurufen, um das gesamte
-          Dokument auf Auszeichnungsfehler hin zu untersuchen, ohne
-          dass zeitaufwändige Transformationen vorgenommen
-          werden.</para>
+	<para>Wenn Ihre Änderungen abgeschlossen und erfolgreich
+	  getestet wurden, erzeugen Sie eine
+	  <quote>Differenzdatei</quote>-Datei mit
+	  Ihren Änderungen:</para>
 
-	<screen>&prompt.user; <userinput>make lint</userinput></screen>
+	<screen>&prompt.user; <userinput>cd ~/doc</userinput>
+&prompt.user; <userinput>svn diff &gt; <replaceable>bsdinstall</replaceable>.diff.txt</userinput></screen>
 
-        <!--?
-        Glossar sollte vorhanden sein. Darin dann erklären,
-        was mit Ziel- und Quelldokument gemeint ist.
-        Oliver Fischer
-        -->
-
-	<para>Soll anschließend das Zieldokument erstellt
-          werden, kann mit Hilfe der Variable
-          <varname>FORMATS</varname> bestimmt werden, welche
-          Ausgabeformate erzeugt werden sollen. Unterstü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ützten Formate befindet sich am Anfang der Datei
-          <filename>head/share/mk/doc.docbook.mk</filename>. Bei der
-          Verwendung dieser Variable ist es wichtig, darauf zu achten,
-          dass die Angabe der gewünschten Formate in
-          Anfü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>
+	<para>Geben Sie der Differenzdatei einen aussagekräftigen Namen.
+	  Im angegebenen Bespiel wurden Änderungen im Abschnitt
+	  <filename>bsdinstall</filename> des Handbuchs vorgenommen.</para>
       </step>
 
       <step>
-        <para>Zum Schluss müssen die Änderungen an das
-          FDP mittels &man.send-pr.1; eingesandt werden.</para>
-      </step>
+	<para>Reichen Sie Ihre Änderungen über das webbasierte <link
+	  xlink:href="&url.base;/support.html#gnats">Problembericht-Formular</link>
+	  ein.  Geben Sie eine kurze Beschreibung in der Form
+	  <emphasis>[patch] <replaceable>kurze Beschreibung des Problems</replaceable></emphasis>
+	  ein.  Als Kategorie wählen Sie <literal>docs</literal>
+	  und als Klasse <literal>doc-bug</literal>.  Danach geben
+	  Sie eine Beschreibung Ihrer Änderungen ein sowie eventuelle
+	  weitere wichtige Punkte.  Verwenden Sie danach den Button
+	  <guibutton>[&nbsp;Browse...&nbsp;]</guibutton>, um Ihre
+	  Differenzdatei hochzuladen.</para>
+	</step>
     </procedure>
   </sect1>
 </chapter>
Index: head/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml	(revision 46772)
+++ head/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml	(nonexistent)
@@ -1,1916 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- 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$
-     basiert auf: r38826
--->
-<!--?
-o SGML-Kontext sollte besser mit Umgebung uebersetzt werden.
-
-Oliver Fischer
-
--->
-<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="xml-primer">
-  <title>Die XML-Fibel</title>
-
-  <para>Die Mehrzahl der Dokumente des FDPs sind in XML geschrieben.
-    Ziel dieses Kapitels ist es, genau zu erklären, was
-    das bedeutet und wie man die XML-Quellen liest und versteht.
-    Ebenso werden die in den Quellen genutzten Kniffe erklärt,
-    auf die man beim Lesen der Dokumente stoßen wird.</para>
-
-  <para>Teile dieses Kapitels basieren auf Mark Galassis <quote><link xlink:href="http://www.galassi.org/mark/mydocs/docbook-intro/docbook-intro.html">Get
-    Going With DocBook</link></quote>.</para>
-
-  <sect1 xml:id="xml-primer-overview">
-    <title>Ü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ür viele Zwecke war dies allerdings nicht ausreichend.
-      Von einem maschinenlesbaren 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ähnlichen</quote> Schrift auf dem
-      Bildschirm dargestellt werden, der Ausdruck soll jedoch in
-      <quote>Schrägschrift</quote> oder in einer beliebigen anderen
-      Darstellungsform erfolgen.</para>
-
-    <para>Anfänglich gab es die Hoffnung, dass die
-      Künstliche Intelligenz (KI) helfen würde, dieses Ziel
-      zu erreichen. Computer sollte den Text lesen und dazu in der Lage
-      sein, selbstständig wichtige Formulierungen, Dateinamen,
-      Benutzereingaben oder Beispiele zu erkennen.  Leider verlief die
-      Entwicklung in diesem Bereich nicht wie gewünscht und Computer
-      benötigen nach wie vor etwas Unterstützung, bevor sie
-      Texte vernünftig verarbeiten können.</para>
-
-    <para>Genauer gesagt, man muss ihnen sagen, was was ist. Sehen
-      wir uns folgende Zeilen an:</para>
-
-      <blockquote>
-	<para>Löschen Sie <filename>/tmp/foo</filename> mittels &man.rm.1;.</para>
-
-	<screen>&prompt.user; <userinput>rm /tmp/foo</userinput></screen>
-      </blockquote>
-
-    <para>Es fä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ächsischen Sprachraum wird von
-            <quote>markup</quote>
-            gesprochen.</para></footnote></quote> bedeutet, dass
-      sich der Wert eines Textes erhöht, aber auch seine Kosten.
-      Durch Auszeichnungen wird einem Dokument zusätzlicher Text
-      hinzugefügt, der aber von dem eigentlichen Dokumenteninhalt
-      auf eine bestimmte Art und Weise unterschieden werden kann, so
-      dass Programme die Auszeichnung erkennen können und
-      mittels dieser Informationen während der Verarbeitung in
-      der Lage sind, Entscheidungen zu treffen. Texteditoren
-      kö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ätzlich abgelegten Informationen erhöhen den Wert
-      des Dokuments. Allerdings muss diese Arbeit in den meisten
-      Fällen von einem Menschen getan werden &ndash; wären
-      Maschinen dazu fähig, wären zusätzliche
-      Auszeichnungselemente unnötig. Der damit verbundene Aufwand
-      <emphasis>erhö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><![CDATA[
-<para>Lö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ü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ürlich kann es keine universelle
-      Auszeichnungssprache geben und eine einzige mag nicht
-      ausreichend für alle möglichen Anwendungsfälle
-      sein. Eine  Sprache für technische Dokumente wird sich
-      wahrscheinlich stark von einer für Kochrezepte
-      unterscheiden. Die universelle Lösung ist eine
-      Basissprache, mit deren Hilfe weitere Sprachen entwickelt werden
-      können &ndash; eine
-      <emphasis>Meta-Auszeichnungssprache</emphasis> also.</para>
-
-    <para>Genau diese Anforderung wird von der Standard Generalized
-      Markup Language (<abbrev>SGML</abbrev>) erfüllt. Mit ihrer
-      Hilfe wurden viele andere Auszeichnungssprachen 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ögliche Reihenfolge
-      und Verschachtelung sowie weitere Informationen
-      festgelegt.</para>
-
-      <!-- Der letzte Satz dieses Absatzes muss noch übersetzt werden.
-      Ich habe keine gute Übersetzung dafü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 xml:id="xml-primer-validating">Eine DTD ist eine
-      <emphasis>vollständige</emphasis> Definition aller
-      möglichen Sprachelemente, ihrer
-      Reihenfolge<footnote><para>Bei natürlichen Sprachen spricht
-          man vom Satzbau  &ndash; demjenigen Konstrukt, das unter
-          anderem die Position des Subjekts, Objekts und
-          Prädikats in einem Satz festlegt.</para></footnote>,
-      optionaler Elemente und so weiter und so weiter. Dank dieser
-      recht formalen Festlegung ist es möglich,
-      SGML-<emphasis>Parser</emphasis> zu entwickeln, die sowohl ein
-      Dokument  als auch seine DTD einlesen und anhand dieser DTD
-      prüfen kö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
-        überprüft lediglich die korrekte Syntax des
-        Dokuments, dass heißt, ob nur gültige
-        Auszeichnungselemente verwendet wurden und ihre Reihenfolge
-        stimmt. Dabei wird <emphasis>nicht</emphasis> geprüft, ob
-        die Elemente der DTD <emphasis>sinngemäß</emphasis>
-        verwandt wurden. Sollten beispielsweise alle Dateinamen als
-        Funktionsnamen ausgezeichnet worden sein, so würde der
-        Parser keinen Fehler signalisieren. Formaler ausgedrückt:
-        Der Parser prüft die Syntax, aber nicht die
-        Semantik.</para>
-      </note>
-
-    <para>Es ist anzunehmen, dass, wenn man selber vor hat
-      Dokumentation für das FDP zu schreiben, der
-      größte Teil davon mit Hilfe von HTML oder DocBook
-      geschrieben werden wird. Aus diesem Grunde wird an dieser Stelle
-      nicht erklärt, wie eine DTD entwickelt wird.</para>
-    </sect1>
-
-    <sect1 xml:id="xml-primer-elements">
-    <title>Von Elementen, Tags und Attributen</title>
-
-    <!-- Bei der Ü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ä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ä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ält nun
-      Kapitel, die wiederum selbst als Elemente bezeichnet werden
-      können. Jedes einzelne Kapitel enthält weitere
-      Elemente. So gibt es beispielsweise Absätze, Zitate und
-      Fuß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öchte, kann man sich das als
-      <quote>Unterteilung</quote><footnote><para>Im
-          angelsächsischen 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ätze, Fuß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ö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ählt werden, um zu
-      bestimmen, zu welchem Element die einzelnen Inhalte
-      gehören. In SGML-basierten Auszeichnungssprachen wie HTML
-      und DocBook  werden dafü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ö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ürlich auch unterschiedlich benannt sein werden.</para>
-
-    <para>Der Starttag für ein imaginäres Element mit dem
-      Namen <replaceable>elementname</replaceable> ist
-      <tag>&lt;<replaceable>elementname</replaceable>&gt;</tag>.
-      Sein Gegenstück, der schließende Endtag, ist
-      <tag>&lt;/<replaceable>elementname</replaceable>&gt;</tag>.</para>
-
-    <example>
-      <title>Verwendung eines Elements (Start- und Endtag)</title>
-
-      <para>HTML kennt das Element <tag>p</tag>, um
-        festzulegen, dass ein bestimmter abgegrenzter Bereich
-        einen Absatz darstellt. Dieses Element hat sowohl einen Start-
-        als auch einen Endtag.</para>
-
-      <programlisting><![CDATA[<p>Das ist ein Absatz. Er beginnt mit Starttag
-  für das Element 'p' und endet mit dem Endtag für
-  das Element 'p'.</p>
-
-<p>Das ist ein etwas kürzerer Absatz.</p>]]></programlisting>
-    </example>
-
-    <para>Elemente mü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ötigt.</para>
-
-    <example>
-      <title>Verwendung eines Elements (nur Starttag)</title>
-
-      <para>In HTML kann man mit dem Element <tag>hr</tag>
-        festlegen, dass an einer bestimmten Stelle eine
-        horizontale Linie angezeigt werden soll. Da dieses Element
-        keinen Inhalt umschließ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önnen andere Elemente enthalten.  Im
-      anfangs erwähnten Buch enthielt das Buch-Element
-      alle Kapitel-Elemente, die wiederum alle Absatz-Elemente
-      enthielten und so fort.</para>
-
-    <example>
-      <title>Verschachtelte Elemente: <tag>em</tag></title>
-
-      <programlisting><![CDATA[<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ö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ä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 <tag>p</tag></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 <tag>p</tag></quote>
-        gesprochen, ist damit das gesamte Element gemeint.</para>
-
-      <para>Diese Unterscheidung ist sicherlich subtil. Trotzdem
-        sollte man sie sich vergegenwärtigen.</para>
-    </important>
-
-    <para>Elemente können selber Attribute haben, die aus einem
-      Namen und einem Wert bestehen.  Die Attribute haben die Aufgabe,
-      dem Element zusätzliche Informationen hinzuzufügen.
-      Denkbar sind hier Festlegungen über die Darstellung,
-      Bezeichner, über die das Element eindeutig identifiziert
-      werden kann, oder beliebige andere Informationen.</para>
-
-    <para>Elementattribute werden in den <emphasis>Starttag</emphasis>
-      eingefügt und haben die Form
-      <literal>Attributename="Wert"</literal>.</para>
-
-    <para>Bei einigen HTML-Versionen kennt das Element
-      <tag>p</tag> das Attribut <tag>align</tag>, 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><![CDATA[<p align="left">Die Verwendung des align-Attributs
-  für diesen Absatz ist überflü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ält Attributwert doppelte Anführungszeichen
-      (<literal>"</literal>), wird der Wert in einfachen
-      Anführungszeichen eingeschlossen.</para>
-
-    <example>
-      <title>Attribute mit einfachen Anführungszeichen</title>
-
-      <programlisting><![CDATA[<p align='right'>Ich stehe rechts!</p>]]></programlisting>
-    </example>
-
-
-    <para>Manchmal können die Anführungszeichen um den
-      Attributwert weggelassen werden.  Allerdings sind die Regeln,
-      die festlegen wann dies zulässig ist, sehr spitzfindig.
-      Am besten schließen Sie Attributwerte
-      <emphasis>immer</emphasis> in Anführungszeichen ein.</para>
-
-    <para>Die Informationen ü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
-      <package>textproc/docproj</package> installiert
-      werden, bringen ihre eigenen Katalogvarianten mit, zudem pflegt
-      das FDP seine  eigenen Kataloge. Beide Katalogarten müssen
-      von allen Programmen gefunden werden können.</para>
-
-    <sect2>
-      <title>Was dafür getan werden muss;&hellip;</title>
-
-      <para>Damit die Beispiele dieser Fibel ausgeführt werden
-        kö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
-            <package>textproc/docproj</package>
-            über das FreeBSD-Portsystem. <package>textproc/docproj</package> ist ein
-            <emphasis>Metaport</emphasis>, der alle vom FDP
-            benötigten Programme und Daten aus dem Netz laden und
-            installieren sollte.</para>
-        </step>
-
-        <step>
-          <para>Anschließend muss in den Shellkonfigurationsdateien die
-            Variable <envar>SGML_CATALOG_FILES</envar>
-            <footnote><simpara>Sofern man nicht an der deutschen
-                Dokumentation arbeitet, müssen die
-                Verzeichnisangaben entsprechend angepasst
-                werden.</simpara>
-              </footnote> gesetzt werden.</para>
-
-            <example xml:id="xml-primer-envars">
-              <title><filename>.profile</filename>, für &man.sh.1; und
-                &man.bash.1; Benutzer</title>
-
-	    <programlisting>SGML_ROOT=/usr/local/share/xml
-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/xml/catalog:$SGML_CATALOG_FILES
-SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/xml/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ür &man.csh.1;- und
-              &man.tcsh.1;-Benutzer</title>
-
-            <programlisting>setenv SGML_ROOT /usr/local/share/xml
-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/xml/catalog:$SGML_CATALOG_FILES
-setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/xml/catalog:$SGML_CATALOG_FILES
-setenv SGML_CATALOG_FILES /usr/doc/de_DE.ISO8859-1/share/xml/catalog:$SGML_CATALOG_FILES</programlisting>
-            </example>
-
-          <para>Damit die Änderungen wirksam werden, meldet man
-            sich ab und anschließend wieder an &ndash; oder man
-            führt die obigen Anweisungen direkt in der Shell
-            aus und setzt so die benötigten Umgebungsvariablen.</para>
-
-        </step>
-      </procedure>
-
-      <procedure>
-        <step>
-          <para>Nun sollte man eine Datei
-            <filename>beispiel.xml</filename> anlegen, die den
-            folgenden Text enthält:</para>
-
-            <programlisting><![CDATA[<!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ü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 <package>textproc/docproj</package>
-            ist <command>onsgmls</command> - ein <link linkend="xml-primer-validating">validierender Parser</link>.
-            <command>onsgmls</command> liest ein Dokument entsprechend einer SGML-DTD
-            ein und gibt anschließend ein Element-Structure-Information-Set
-            (ESIS) aus. Allerdings ist das an dieser Stelle nicht weiter
-            wichtig.</para>
-
-          <para>Wird <command>onsgmls</command> mit der Option <option>-s</option>
-            aufgerufen, werden nur Fehlermeldungen ausgegeben. Dadurch
-            kann leicht geprüft werden, ob ein Dokument gültig
-            ist oder nicht.</para>
-
-          <para>So prüft man mit <command>onsgmls</command>, ob die neuangelegte
-            Beispieldatei gültig ist:</para>
-
-            <screen>&prompt.user; <userinput>onsgmls -s beispiel.xml</userinput></screen>
-
-          <para>Sofern das Beispiel korrekt abgetippt wurde, wird sich
-            <command>onsgmls</command> ohne jegliche Ausgabe beenden. Das bedeutet,
-            dass das Dokument erfolgreich validiert werden konnte
-            und somit gültig ist.</para>
-        </step>
-
-        <step>
-          <para>Jetzt sollten die Tags <tag>title</tag> und
-            <tag>/title</tag> aus dem Dokument gelöscht
-            und das Dokument erneut validiert werden:</para>
-
-            <screen>&prompt.user; <userinput>onsgmls -s beispiel.xml</userinput>
-onsgmls:beispiel.xml:5:4:E: character data is not allowed here
-onsgmls:beispiel.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
-
-          <para>Die Fehlermeldungen, die von <command>onsgmls</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>onsgmls</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 über die
-                    Art des Fehlers informiert. <literal>I</literal>
-                    steht für eine informelle Meldung,
-                    <literal>W</literal> für eine Warnung und
-                    <literal>E</literal> für Fehler<footnote>
-                      <para>Nicht immer besteht eine Meldung aus
-                        fünf Spalten. Die Ausgabe von
-                        <command>onsgmls -sv</command> ist
-                        beispielsweise <literal>onsgmls:I: SP version
-                          "1.3"</literal> (natürlich
-                        abhängig von der Version). Wie man sehen
-                        kann, handelt es sich hier um eine informelle
-                        Meldung.</para>
-                    </footnote> und <literal>X</literal> fü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 <tag>title</tag>
-            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 <tag>head</tag>
-            auftreten kann.</para>
-
-          <para>Der zweite Fehler wurde dadurch verursacht, dass
-            das Element <tag>head</tag> ein
-            Element <tag>title</tag> enthalten
-            <emphasis>muss</emphasis> und <command>onsgmls</command>
-            nicht berücksichtigt, dass dieser Fehler auf dem
-            vorhergehenden beruht. Es wird lediglich festgestellt,
-            dass der Endtag von <tag>head</tag> auftritt,
-	    obwohl nicht alle notwendigen Elemente vorhanden sind.</para>
-        </step>
-
-        <step>
-		<para>Zum Schluss sollte der Tag
-            <tag>title</tag> wieder in die Beispieldatei
-            eingefügt werden.</para>
-          </step>
-        </procedure>
-    </sect2>
-  </sect1>
-
-  <sect1 xml:id="xml-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önnen SGML-Parser die verwendete DTD
-      feststellen und prüfen, ob das Dokument zu ihr konform ist.</para>
-
-    <para>Üblicherweise steht diese Information in einer Zeile,
-      die als DOCTYPE-Deklaration bezeichnet wird.</para>
-
-
-    <para>Eine Deklaration für ein HTML-Dokument, das nach den
-      Vorgaben der DTD fü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 ü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ür
-            den Dokumententyp ist.</para>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry>
-        <term><literal>html</literal></term>
-
-        <listitem>
-          <para>Nennt das erste <link linkend="xml-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 Ö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üsselwort <literal>PUBLIC</literal>
-            gehört nicht zum öffentlichen Bezeichner,
-            sondern legt fest, wie ein SGML-Parser die DTD finden
-            kann. Alternative Wege eine DTD zu referenzieren werden
-            <link linkend="xml-primer-fpi-alternatives">später
-              gezeigt</link>.</para>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry>
-        <term><literal>&gt;</literal></term>
-
-        <listitem>
-          <para>Schließt den mit <literal>&lt;!</literal> begonnenen
-            Ausdruck ab.</para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-    <sect2>
-      <title>Formale Öffentliche Bezeichner</title>
-
-      <!--? -->
-      <note>
-        <para>Dieser Abschnitt braucht nicht unbedingt zu gelesen zu
-          werden. Dennoch ist es empfehlenswert, da er nützliche
-          Hintergrundinformationen enthält, die hilfreich sein
-          können, falls der SGML-Prozessor die genutzte DTD nicht
-          finden kann.</para>
-      </note>
-
-      <para>Jeder öffentliche Bezeichner muss eine bestimmte Syntax
-        haben, die wie folgt lautet:</para>
-
-      <!-- Oliver Fischer: Ich habe hier Owner mit Besitzer uebersetzt.
-      Mein Gefühl sagt mir, dass dies nicht 100% richtig ist.
-      Vielleicht ist Aussteller bessert? -->
-
-      <programlisting>"<replaceable>Besitzer</replaceable>//<replaceable>Schlüsselwort</replaceable> <replaceable>Beschreibung</replaceable>//<replaceable>Sprache</replaceable>"</programlisting>
-
-      <variablelist>
-        <varlistentry>
-          <term><replaceable>Besitzer</replaceable></term>
-
-          <listitem>
-            <para>Nennt den Besitzer des öffentlichen Bezeichners.</para>
-
-            <para>Falls diese Zeichenkette mit <quote>ISO</quote>
-              beginnt, gehört der Bezeichner dem ISO-Komitee.
-              Der Bezeichner <literal>"ISO 8879:1986//ENTITIES Greek
-                Symbols//EN"</literal> nennt <quote>ISO
-                8879:1986</quote> als den Besitzer des Satzes von
-              Entitäten für griechische Zeichen. ISO
-              8879:1986 ist die ISO-Bezeichnung für den
-              SGML-Standard.</para>
-
-
-            <!--? Die Formulierung gefällt mir nicht. Oliver Fischer -->
-            <para>Beginnt die Zeichenkette nicht mit
-              <quote>ISO</quote>, sieht sie entweder so
-              <literal>-//Besitzer</literal>
-              oder so
-              <literal>+//Besitzer</literal>
-              aus. Beide Varianten unterscheiden sich also nur durch
-              das anfängliche <literal>+</literal> bzw.
-              <literal>-</literal>.</para>
-
-            <para>Sofern am Anfang ein <literal>-</literal> steht, ist
-              der Bezeichner nicht öffentlich registriert, steht
-              hingegen ein <literal>+</literal> am Anfang, ist er
-              registriert.</para>
-
-
-            <!--? Vielleicht besser: Wie Namen registeriert werden?
-            Oliver Fischer -->
-            <!--? Mit der Übersetzung des letzten Satzes bin ich mir
-            nicht sicher.... Das muss irgendwie besser ausgedrückt
-            werden.... -->
-
-            <para>Im ISO-Standard ISO 9070:1991 wurde festgelegt, wie
-              registrierte Namen erzeugt werden können. Unter
-              anderem können sie von den Bezeichnungen von
-              ISO-Publikationen, von ISBN-Nummern oder einer
-              Organisationsbezeichnungen entsprechend ISO 6523
-              abgeleitet werden. Anträge für neue offiziell
-              registrierte Bezeichner werden vom ISO-Komitee 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üsselwort</replaceable></term>
-
-          <listitem>
-            <para>Es gibt verschiedene Schlüsselwörter mit
-              denen man die Art der gegebenen Informationen beschreiben
-              kann. Einige der üblichsten sind
-              <literal>DTD</literal>, <literal>ELEMENT</literal>,
-              <literal>ENTITIES</literal> und <literal>TEXT</literal>.
-              <literal>DTD</literal> wird nur für Dateien mit
-              DTDs verwandt, <literal>ELEMENT</literal> findet
-              für Dateien mit Fragmenten von DTDs Verwendung, die
-              nur Deklarationen für Entitäten und Elemente
-              enthalten. <literal>TEXT</literal> wird für
-              SGML-Inhalte (Texte und Tags) verwendet.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term><replaceable>Beschreibung</replaceable></term>
-
-          <listitem>
-            <para>Eine frei wählbare Beschreibung des Inhalts der
-              referenzierten Datei. Mö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ür
-              die Datei verwendete Sprache nennt.
-              <literal>EN</literal> steht hier für Englisch,
-              <literal>DE</literal> für Deutsch.</para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-
-      <sect3>
-        <title>Die <filename>catalog</filename>-Dateien</title>
-
-        <para>Wenn man die oben beschriebene Syntax für
-          Bezeichner verwendet und ein Dokument durch einen
-          SGML-Prozessor schickt, muss dieser die
-          Möglichkeit haben, den Bezeichner auf eine real
-          existierende Datei abzubilden, die die benötigte DTD
-          enthält.</para>
-
-        <para>Einer der möglichen Wege hierfür sind
-          Katalogdateien. Eine solche Datei, die üblicherweise
-          <filename>catalog</filename> heißt, besteht aus
-          einzelnen Zeilen, die Bezeichner auf Dateinamen abbilden.
-          Enthä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über feststellen, dass die
-          benötigte DTD in der Datei <filename>strict.dtd</filename>
-          im Unterverzeichnis <filename>4.0</filename>
-          des Verzeichnisses des Katalogs zu finden ist.</para>
-
-        <para>Ein gutes Beispiel für einen Katalog ist
-          <filename>/usr/local/share/xml/html/catalog</filename>.
-          Diese Datei enthält den Katalog für alle HTML
-          DTDs, die im Zuge der Installation von <package>textproc/docproj</package> installiert
-          wurden.</para>
-
-      </sect3>
-
-      <sect3>
-        <title>Die Variable <envar>SGML_CATALOG_FILES</envar></title>
-
-        <para>Natürlich muss einem SGML-Prozessor noch
-          mitgeteilt werden können, wo er seine Kataloge finden
-          kann. Viele Programme bieten hierfür
-          Kommandozeilenoptionen an, über die man einen oder
-          mehrere Kataloge angeben kann.</para>
-
-        <para>Zusätzlich besteht noch die Möglichkeit mit
-          der Umgebungsvariablen <envar>SGML_CATALOG_FILES</envar> auf
-          SGML-Kataloge zu verweisen. Die Einträge von
-          <envar>SGML_CATALOG_FILES</envar> müssen aus den
-          vollständigen Pfadnamen der Kataloge, jeweils durch
-          Komma getrennt, bestehen.</para>
-
-
-        <!--? Stimmt die Formulierung? Oliver Fischer -->
-        <para>Üblicherweise werden die folgenden Kataloge über
-            <envar>SGML_CATALOG_FILES</envar> für
-          die Arbeit an den Dokumenten des FDPs eingebunden:</para>
-
-        <itemizedlist>
-          <listitem>
-            <para><filename>/usr/local/share/xml/docbook/4.1/catalog</filename></para>
-          </listitem>
-
-          <listitem>
-            <para><filename>/usr/local/share/xml/html/catalog</filename></para>
-          </listitem>
-
-          <listitem>
-            <para><filename>/usr/local/share/xml/iso8879/catalog</filename></para>
-          </listitem>
-
-          <listitem>
-            <para><filename>/usr/local/share/xml/jade/catalog</filename></para>
-          </listitem>
-        </itemizedlist>
-
-        <para>Allerdings sollte das
-          <link linkend="xml-primer-envars">schon geschehen
-            sein</link>.</para>
-
-      </sect3>
-    </sect2>
-
-    <sect2 xml:id="xml-primer-fpi-alternatives">
-      <title>Alternativen zu Formalen Öffentlichen Bezeichnern</title>
-
-      <para>Anstatt mit einem Bezeichner die zum Dokument
-        gehörende DTD zu referenzieren, kann auch explizit auf
-        die Datei der DTD verwiesen werden.</para>
-
-      <para>Die Syntax der DOCTYPE-Deklaration ist in diesem Falle
-        anders:</para>
-      <!--<para>The syntax for this is slightly different:</para>-->
-
-      <programlisting><![CDATA[<!DOCTYPE html SYSTEM "/pfad/zur/dokumenten.dtd">]]></programlisting>
-
-      <para>Das Schlü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 öffentliche Bezeichner aus
-        Gründen der Portabilitä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ötigte DTD auf anderen Systemen genau
-        unter dem gleichen Pfad verfügbar ist.</para>
-
-    </sect2>
-  </sect1>
-
-  <sect1 xml:id="xml-primer-xml-escape">
-    <title>Die Rückkehr zu SGML</title>
-
-    <para>An einer früheren Stelle wurde erwähnt, dass
-      man SGML nur benötigt, falls man selbst eine DTD entwickeln
-      möchte. Genaugenommen ist das nicht 100%ig richtig. Einige
-      Teile der SGML-Syntax können auch in normalen Dokumenten
-      verwendet werden, falls dies gewünscht oder notwendig
-      ist.</para>
-
-    <para>In diesem Falle muss dafü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="xml-primer-doctype-declaration">DOCTYPE-Deklaration</link>
-      ein gutes Beispiel für SGML, das in Dokumenten verwendet
-      werden muss&hellip;</para>
-
-  </sect1>
-
-  <sect1 xml:id="xml-primer-comments">
-    <title>Kommentare</title>
-
-    <para>Kommentare sind SGML-Konstrukte, die normalerweise nur
-      in DTDs gültig sind. Dennoch ist es, wie in
-      <xref linkend="xml-primer-xml-escape"/> gezeigt,
-      mö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 öffnet er einen Kommentar, mit
-      seinem zweiten schließt er ihn wieder.</para>
-
-    <example>
-      <title>Beispiele für Kommentare in SGML</title>
-
-      <programlisting>&lt;!-- Testkommentar --&gt;</programlisting>
-
-      <programlisting>
-&lt;!&hyphen;- Text innerhalb eines Kommentars -&hyphen;&gt;
-
-6lt;!&hyphen;- Ein anderer Kommentar    -&hyphen;&gt;
-
-6lt;!&hyphen;- So können mehrzeilige Kommentare
-     genutzt werden -&hyphen;&gt;
-
-&lt;!&hyphen;- Eine andere Möglichkeit für -&hyphen;
-  &hyphen;- mehrzeilige Kommentare.     -&hyphen;&gt;</programlisting>
-    </example>
-
-    <para>Hat man früher schon Erfahrungen mit HTML gesammelt,
-      wird man vielleicht andere Regeln fü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>
-&lt;!&hyphen;- Innerhalb eines Kommentars -&hyphen;
-
-     DIES IST NICHT TEIL EINES KOMMENTARS
-
-  &hyphen;- Wieder innerhalb eines Kommentars -&hyphen;&gt;</programlisting>
-
-      <para>SGML-Parser wü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ültiges SGML handelt, kann
-        diese Zeile zur verwirrenden  Fehlermeldungen führen.</para>
-
-      <programlisting>&lt;!&hyphen;&hyphen;&hyphen;&hyphen;&hyphen; Eine wirklich schlechte Idee  &hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&gt;</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>&lt;!&hyphen;-===================================================-&hyphen;&gt;</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übungen&hellip;</title>
-
-      <procedure>
-        <step>
-          <para>Zur Übung können Sie einige Kommentare in
-            die Datei <filename>beispiel.xml</filename> einfügen
-            und überprüfen, ob die Datei nun noch erfolgreich
-            von <command>onsgmls</command> validiert werden kann.</para>
-        </step>
-
-        <step>
-          <para>Zu Testzwecken sollten Sie
-            auch noch ein paar fehlerhafte Kommentare hinzufügen
-            und sich die resultierenden Fehlermeldungen von
-	    <command>onsgmls</command> ansehen.</para>
-        </step>
-      </procedure>
-    </sect2>
-  </sect1>
-
-  <sect1 xml:id="xml-primer-entities">
-    <title>Entitäten</title>
-
-    <para>Entitäten stellen einen Mechanismus dar, mit dem
-      einzelnen Dokumententeilen  ein Name zugewiesen werden kann.
-      Findet ein SGML-Parser während des Parsens eine
-      Entität, ersetzt er diese durch den ihr zugewiesenen
-      Inhalt.</para>
-
-    <para>Dadurch steht eine einfache Möglichkeit zur
-      Verfügung, mit der  variabler Inhalt in SGML-Dokumenten
-      eingebunden werden kann. Zusätzlich sind Entitäten der
-      einzige Weg, über den eine Datei in eine andere Datei mit
-      SGML-Mitteln eingebunden werden kann.</para>
-
-    <para>Es werden zwei Arten von Entitäten unterschieden:
-      <emphasis>Allgemeine Entitäten</emphasis> und
-      <emphasis>Parameterentitäten</emphasis>.</para>
-
-    <sect2 xml:id="xml-primer-general-entities">
-      <title>Allgemeine Entitäten</title>
-
-      <para>Allgemeine Entitäten können nur in
-	Dokumenten benutzt werden.  Sie können zwar im
-	SGML-Kontext definiert aber dort nicht benutzt
-	werden.  Vergleichen Sie dies mit
-        Im <link linkend="xml-primer-parameter-entities">Parameterentitäten</link>.</para>
-
-      <para>Jede allgemeine Entität hat einen Namen, über
-        den sie angesprochen werden kann, um den von ihr
-        referenzierten Inhalt in ein Dokument einzubinden. Dafür
-        muss an der betreffenden Stelle der Namen der
-        Entität per
-        <literal>&amp;entitaetenname;</literal>
-        einfügt werden. Eine Entität
-        <literal>current.version</literal> könnte beispielsweise
-        durch die aktuelle Versionsnummer eines Programms ersetzt
-        werden. Man könnte also schreiben:</para>
-
-      <!--?
-      Der vorhergehende Satz ist nicht 100% sinngemaeß 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 ändert, muss
-	nur die Entität angepasst und anschließend
-	das Dokument neu erzeugt werden.</para>
-
-      <para>Eine weitere Einsatzmöglichkeit für Allgemeine
-        Entitäten ist das Einbinden von Zeichen, die auf andere
-        Weise nicht in ein SGML-Dokument eingefügt werden
-        könnten. Ein Beispiel für solche Zeichen sind
-        <literal>&lt;</literal> und <literal>&amp;</literal>, die
-        normalerweise nicht direkt in
-        SGML-Dokumenten erlaubt sind. Stöß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ät gefunden zu haben.</para>
-
-      <para>Wenn eines der beiden Zeichen benötigt wird, werden
-	daher die allgemeinen Entitäten <literal>&amp;lt;</literal>
-	und <literal>&amp;amp;</literal> verwendet.</para>
-
-      <para>Allgemeine Entitäten können nur in einem
-        SGML-Kontext definiert werden. Üblich ist es, dies direkt
-        nach der DOCTYPE-Deklaration zu tun:</para>
-
-      <example>
-        <title>Allgemeine Entitä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ä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 über DOCTYPE genannte DTD erweitern möchte.</para>
-
-      </example>
-    </sect2>
-
-    <sect2 xml:id="xml-primer-parameter-entities">
-      <title>Parameterentitäten</title>
-
-      <para>Genau wie <link linkend="xml-primer-general-entities">Allgemeine
-          Entitäten</link> werden Parameterentitäten
-        eingesetzt um wiederverwendbare Inhaltsteile mit Namen zu
-        versehen. Im Gegensatz zu Allgemeinen Entitäten
-        können sie aber nur innerhalb eines <link linkend="xml-primer-xml-escape">SGML-Kontextes</link>
-        genutzt werden.</para>
-
-      <para>Die Definition von Parameterentitäten erfolgt
-        ähnlich zu der Allgemeiner Entitäten. Sie werden
-        lediglich mit
-        <literal>%entitaetenname;</literal>
-        anstelle von
-        <literal>&amp;entitaetenname;</literal>
-        referenziert<footnote>
-          <para>Es wird das Prozentzeichen anstelle des
-            kaufmännischen Unds verwendet.</para>
-        </footnote>. Wichtig ist, dass das
-        <literal>%</literal>-Zeichen zwischen
-        <literal>ENTITY</literal> und dem Entitätennamen ein Teil
-        der Definition ist.</para>
-
-      <example>
-        <title>Parameterentitä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">
-]>]]></programlisting>
-        </example>
-
-        <!--? Noch nicht übersetzt. Oliver Fischer -->
-        <!--<para>This may not seem particularly useful.  It will be.</para>-->
-      </sect2>
-
-    <sect2>
-      <title>Fingerübungen&hellip;</title>
-
-      <procedure>
-        <step>
-          <para>Fügen Sie in <filename>beispiel.xml</filename>
-            eine Allgemeine Entität ein.</para>
-
-            <programlisting><![CDATA[<!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ündig
-      ausgerichtet.</p>
-
-    <p>Die aktuelle Version ist: &amp;version;</p>
-  </body>
-</html>]]></programlisting>
-        </step>
-
-        <step>
-          <para>Validieren Sie diese Datei mit
-            <command>onsgmls</command></para>
-        </step>
-
-        <step>
-          <para>Öffnen Sie nun <filename>beispiel.xml</filename>
-            mit Ihrem Webbrowser. Es kann notwendig sein, dass
-            Sie die Datei vorher in <filename>beispiel.html</filename>
-            umbenennen müssen, damit die Datei auch als
-            HTML-Dokument erkannt wird.</para>
-
-          <para>Nur wenn Sie einen sehr modernen Browser haben, werden
-            Sie sehen kö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ö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ätte
-                vermeiden können.</para>
-            </footnote>.</para>
-        </step>
-
-        <step>
-          <para>Die Lösung hierfür ist, das Dokument zu
-            <emphasis>normalisieren</emphasis>. Zu diesem Zweck liest
-            ein Normer <!--? Sehr freie Übersetzung. Oliver -->
-            das Dokument ein und gibt anschließend semantisch
-            gleichwertiges SGML wieder aus, dass auf verschiedene
-            Arten transformiert worden sein kann. Eine dieser
-            möglichen Transformationen ist das Ersetzen der
-            Referenzen auf Entitäten mit dem von ihnen
-            präsentierten Inhalt.</para>
-
-          <para>Versuchen Sie, die Beispieldatei mittels
-            <command>osgmlnorm</command> zu normalisieren:</para>
-
-            <screen>&prompt.user; <userinput>osgmlnorm beispiel.xml &gt; beispiel.html</userinput></screen>
-
-          <para>Anschließend sollten Sie eine normalisierte
-            Version, dass heißt eine, bei der die
-            Entitäten gegen ihren Inhalt ersetzt wurden, in der
-            Datei <filename>beispiel.html</filename> finden. Diese
-            Datei können Sie sich nun mit Ihrem Browser
-            ansehen.</para>
-
-        </step>
-
-        <step>
-          <para>Wenn Sie sich die Ausgaben von <command>osgmlnorm</command>
-            ansehen, werden Sie feststellen, dass
-            die DOCTYPE-Deklaration am Anfang der Datei nicht mehr
-            enthalten ist. Möchten Sie die Deklaration behalten,
-            muss <command>osgmlnorm</command> mit der Option
-            <option>-d</option> aufrufen werden:</para>
-
-          <screen>&prompt.user; <userinput>osgmlnorm -d beispiel.xml &gt; beispiel.html</userinput></screen>
-        </step>
-      </procedure>
-    </sect2>
-  </sect1>
-
-  <sect1 xml:id="xml-primer-include">
-    <title>Dateien mit Entitäten einbinden</title>
-
-    <!--?
-    Dieser kleine Absatz klingt ziemlich hölzern.
-    Oliver Fischer
-    -->
-
-    <para>Sowohl <link linkend="xml-primer-general-entities">Allgemeine</link> als
-      auch <link linkend="xml-primer-parameter-entities">Parameterentitäten</link>
-      sind nützliche Helfer, wenn es darum geht, eine Datei in
-      eine andere einzubinden.</para>
-
-    <sect2 xml:id="xml-primer-include-using-gen-entities">
-      <title>Dateien mit Allgemeinen Entitä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.xml</filename>,
-        <filename>kapitel2.xml</filename> usw.) abgelegt und
-        über eine Datei <filename>buch.xml</filename> sollen
-        alle physischen Dateien wieder mit der Hilfe von
-        Entitäten zu einem logischen Dokument
-        zusammengeführt werden.</para>
-
-      <para>Damit der Inhalt der Dateien mit Entitäten
-	eingebunden werden kann, muss die Deklaration der
-        Entitäten das Schlüsselwort
-        <literal>SYSTEM</literal> enthalten. SGML-Parser werden so
-        angewiesen, den Inhalt der referenzierten Datei als Wert
-        für die jeweilige Entität zu nehmen.</para>
-
-      <example>
-        <title>Dateien mit Allgemeinen Entitäten einbinden</title>
-
-        <programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
-<!ENTITY kapitel.1 SYSTEM "kapitel1.xml">
-<!ENTITY kapitel.2 SYSTEM "kapitel2.xml">
-<!ENTITY kapitel.3 SYSTEM "kapitel3.xml">
-]>
-
-<html>
-
-  &amp;kapitel.1;
-  &amp;kapitel.2;
-  &amp;kapitel.3;
-</html>]]></programlisting>
-      </example>
-
-      <warning>
-        <para>Wenn man Allgemeine Entitäten benutzt, um andere
-          Dateien einzubinden, dürfen diese Dateien
-          (<filename>kapitel1.xml</filename>,
-          <filename>kapitel2.xml</filename>, ...)
-          <emphasis>keine</emphasis> eigene DOCTYPE-Deklaration
-          haben.</para>
-      </warning>
-    </sect2>
-
-    <sect2>
-      <title>Dateien mit Parameterentitäten einbinden</title>
-
-      <para>Wie bereits festgestellt, können
-        Parameterentitäten nur innerhalb eines SGML-Kontexts
-        genutzt werden. Warum möchte man aber Dateien innerhalb
-        eines SGML-Kontexts einbinden? Der Vorteil liegt in der
-        Möglichkeit, die Deklaration von Entitäten in eine
-        andere Datei auslagern zu kö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öglichkeit wäre es, die dafür notwendigen
-        Entitäten am Anfang jedes Buches einzeln festzulegen
-        &ndash; was allerdings mit der Zeit unhandlich und
-        fehlerträchtig wird.</para>
-
-      <para>Alternativ bietet sich dazu an, die Deklarationen in eine
-        separate Datei auszulagern und deren Inhalt anschließend
-        in beide Bücher über Parameterentitäten
-        einzubinden.</para>
-
-      <example>
-        <title>Dateien mit Parameterentitäten einbinden</title>
-
-        <para>Zuerst werden die Entitäten in einer separaten
-          Datei namens <filename>kapitel.ent</filename> deklariert.
-          <filename>kapitel.ent</filename> enthält für
-          dieses Beispiel die folgenden Zeilen:</para>
-
-        <programlisting><![CDATA[<!ENTITY kapitel.1 SYSTEM "kapitel1.xml">
-<!ENTITY kapitel.2 SYSTEM "kapitel2.xml">
-<!ENTITY kapitel.3 SYSTEM "kapitel3.xml">]]></programlisting>
-
-        <para>Im zweiten Schritt fügt man in beide Bücher
-          eine Parameterentität ein, die den Inhalt von
-          <filename>kapitel.ent</filename> referenziert, und lädt
-          über diese dann die Deklarationen. Anschließend
-          können die so geladenen Entitäten wie gewohnt
-          genutzt werden.</para>
-
-	<programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
-<!ENTITY % kapitel SYSTEM "kapitel.ent">
-%kapitel;
-]>
-
-<html>
-  &amp;kapitel.1;
-  &amp;kapitel.2;
-  &amp;kapitel.3;
-</html>]]></programlisting>
-      </example>
-    </sect2>
-
-    <sect2>
-      <title>Fingerübungen&hellip;</title>
-
-        <sect3>
-          <title>Binden Sie Dateien über Allgemeine Entitäten ein</title>
-
-          <procedure>
-            <step>
-              <para>Legen Sie drei Dateien (<filename>absatz1.xml</filename>,
-                <filename>absatz2.xml</filename> und <filename>absatz3.xml</filename>)
-                mit jeweils einer Zeile wie
-
-                <!--     <para>Create three files, <filename>para1.xml</filename>,
-                <filename>para2.xml</filename>, and
-                <filename>para3.xml</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>Ändern Sie <filename>beispiel.xml</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.xml">
-<!ENTITY absatz2 SYSTEM "absatz2.xml">
-<!ENTITY absatz3 SYSTEM "absatz3.xml">
-]>
-
-<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.xml</filename> normalisieren:</para>
-
-            <screen>&prompt.user; <userinput>osgmlnorm -d beispiel.xml &gt; beispiel.html</userinput></screen>
-          </step>
-
-          <step>
-            <para>Öffnen Sie <filename>beispiel.html</filename>
-              nun mit einem Webbrowser und vergewissern Sie sich,
-              dass der Inhalt der Dateien
-              <filename>absatzN.xml</filename>
-              in <filename>beispiel.html</filename> übernommen
-              wurde.</para>
-          </step>
-	</procedure>
-      </sect3>
-
-      <sect3>
-	<title>Binden Sie Dateien mit Parameterentitäten ein</title>
-
-	<note>
-	  <para>Hierfür müssen Sie die vorherige Fingerübung gemacht haben.</para>
-	</note>
-
-	<procedure>
-	  <step>
-	    <para>Ändern Sie <filename>beispiel.xml</filename> so
-              ab, dass es wie folgt aussieht:</para>
-
-	    <programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
-<!ENTITY % entitaeten SYSTEM "entitaeten.xml"> %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.xml</filename> an,
-                die folgenden Inhalt hat:</para>
-
-            <programlisting><![CDATA[<!ENTITY version "1.1">
-<!ENTITY absatz1 SYSTEM "absatz1.xml">
-<!ENTITY absatz2 SYSTEM "absatz2.xml">
-<!ENTITY absatz3 SYSTEM "absatz3.xml">]]></programlisting>
-          </step>
-
-          <step>
-            <para>Erzeugen Sie die Datei
-              <filename>beispiel.html</filename>, indem Sie
-              <filename>beispiel.xml</filename> normalisieren:</para>
-
-            <screen>&prompt.user; <userinput>osgmlnorm -d beispiel.xml &gt; beispiel.html</userinput></screen>
-          </step>
-
-          <step>
-            <para>Öffnen Sie <filename>beispiel.html</filename>
-              nun mit einem Webbrowser und vergewissern Sie sich,
-              dass der Inhalt der Dateien
-              <filename>absatzN.xml</filename>
-              in <filename>beispiel.html</filename> übernommen
-              wurde.</para>
-          </step>
-        </procedure>
-      </sect3>
-    </sect2>
-  </sect1>
-
-  <sect1 xml:id="xml-primer-marked-sections">
-    <title>Markierte Bereiche</title>
-
-    <para>SGML erlaubt es, dass bestimmte Dokumentabschnitte
-      wä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Ü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ÜSSELWORT</replaceable> legt fest, wie der
-      <quote>markierte Inhalt</quote> durch einen SGML-Prozessor
-      wä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ß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üsselworte für markierte Bereiche</title>
-
-      <sect3>
-        <title><literal>CDATA</literal> und <literal>RCDATA</literal></title>
-
-        <para>Die Schlüsselworte <literal>CDATA</literal> und
-          <literal>RCDATA</literal> bestimmen das
-          <emphasis>Inhaltsmodell</emphasis> für markierte
-          Bereiche. Dadurch ist es möglich, vom Standardmodell
-          abzuweichen.</para>
-
-        <para>Ein SGML-Prozessor muss wä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ützlichsten Inhaltsmodelle. <!--? Die richtige
-          Uebersetzung ist Buchstabendaten. Oliver Fischer -->
-          <literal>CDATA</literal> steht fü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örigen Dokumentenbereich nur
-          <quote>gewö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ür
-          Entitätenreferenzen und Zeichendaten<footnote><para>auf
-              Englisch
-              <foreignphrase>Entity references and character
-                data</foreignphrase></para></footnote>. Für einen
-          Bereich mit diesem Inhaltsmodell, wird ein Parser davon
-          ausgehen, dass er sowohl Zeichen als auch
-          Enitätenreferenzen finden kann. <literal>&lt;</literal>
-          verliert hier zwar auch seine besondere Bedeutung, doch
-          <literal>&amp;</literal> wird weiterhin als Anfang einer
-          Entität interpretiert.</para>
-
-        <para>Nützlich ist das <literal>CDATA</literal>-Modell
-          vor allem dann, wenn es darum geht Texte eins-zu-eins zu
-          übernehmen, in denen <literal>&lt;</literal> und
-          <literal>&amp;</literal> gehäuft
-          auftreten. Zwar kann man solche Texte ü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ällen
-          einfacher sein, fü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ü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ültig ist,
-            muss auf andere Weise sichergestellt werden. Denkbar ist
-            beispielsweise, es in einem separaten Dokument zu
-            erstellen, dort zu prüfen und erst dann in das
-            eigentliche Dokument einzufügen.</para>
-        </note>
-          <!-- The nesting of CDATA within the next example is disgusting -->
-
-        <example>
-          <title>CDATA als Inhaltsmodell für markierte Bereiche</title>
-
-          <programlisting>&lt;para&gt;Das ist ein Beispiel, wie man einen Text,
-  der viele <literal>&amp;lt;</literal>- und <literal>&amp;amp;</literal>-
-  Entitäten enthält, in ein Dokument einbinden kann.
-  Das Beispiel selbst, das sich innerhalb des markierten Bereiches befindet,
-  ist ein HTML-Fragment. Der diesen Text umschließende Tag, beginnend mit
-  mit <tag>para</tag> und endend mit <tag>/para</tag>, stammt aus der DocBook DTD.&lt;/para&gt;
-
-&lt;programlisting&gt;
-  &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ä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&gt;</programlisting>
-
-          <para>Liest  man die Quellen dieser Fibel, wird man
-            feststellen, dass diese Technik durchgängig
-            angewandt wurde.</para>
-
-        </example>
-      </sect3>
-
-      <sect3>
-	<title><literal>INCLUDE</literal> und
-	  <literal>IGNORE</literal></title>
-
-        <para>Das Schlüsselwort <literal>INCLUDE</literal> legt
-          fest, dass der Inhalt des betreffenden Abschnittes
-          mitverarbeitet wird. Demgegenüber bestimmt
-          <literal>IGNORE</literal>, dass er ignoriert wird,
-          dass heißt, dass er bei der Verarbeitung
-          ü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ür sich alleine ist <literal>IGNORE</literal> als
-          Anweisung nicht besonders nü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="xml-primer-parameter-entities">Parameterentitäten</link>,
-          steht so ein  Weg zur Verfügung, um dessen Anwendung
-          besser  steuern zu können. Zwar können
-          Parameterentitäten nur in einem SGML-Kontext einsetzt
-          werden, da aber markierte Bereiche ebenfalls SGML-Konstrukte
-          sind, ist diese Einschrä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ätzliche Informationen enthalten, kann dies mit
-          einem Trick erreicht werden.</para>
-
-        <para>Man definiert eine Parameterentitä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üsselwort die zuvor definierte
-          Parameterentität ein.</para>
-
-        <para>Soll anstelle der digitalen die gedruckte Variante
-          produziert werden, muss lediglich der Entität
-          <literal>IGNORE</literal> als Wert zugewiesen und das
-          Ursprungsdokument erneut durch den SGML-Prozessor geschickt
-          werden.</para>
-
-        <example>
-          <title>Kontrolle von markierten Bereichen über
-            Parameterentitäten</title>
-
-	  <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
-&lt;!ENTITY % digitale.kopie "INCLUDE"&gt;
-]]&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ät geändert werden.</para>
-
-	  <programlisting>&lt;!ENTITY % digitale.kopie "IGNORE"&gt;</programlisting>
-
-          <para>Bei der Verarbeitung wird als Schlüsselwort in
-            beiden Fällen der von
-            <literal>%digitale.kopie</literal> repräsentierte
-            Wert verwendet. Im ersten Fall wird der Inhalt des
-            markierten Bereichs mitverarbeitet, im zweiten Fall
-            nicht.</para>
-
-	</example>
-      </sect3>
-    </sect2>
-
-    <sect2>
-      <title>Fingerübung&hellip;</title>
-
-      <procedure>
-	<step>
-          <para>Legen Sie eine neue Datei
-            <filename>abschnitt.xml</filename> an, die folgenden
-            Inhalt hat:</para>
-
-	  <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
-&lt;!ENTITY % text.ausgabe "INCLUDE"&gt;
-]&gt;
-
-&lt;html&gt;
-  &lt;head&gt;
-    &lt;title&gt;Ein Beispiel mit markierten Abschnitten&lt;/title&gt;
-  &lt;/head&gt;
-
-  &lt;body&gt;
-    &lt;p&gt;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&gt;
-
-    &lt;![ IGNORE [
-    &lt;p&gt;Dieser Absatz wird NICHT in der Ausgabe enthalten sein.&lt;/p&gt;
-    ]]&gt;
-
-    &lt;![ <![CDATA[%text.ausgabe]]> [
-     &lt;p&gt;Dieser Absatz wird in Abhängigkeit von <literal>%text.ausgabe</literal>
-       mitausgegeben.&lt;/p&gt;
-    ]]&gt;
-  &lt;/body&gt;
-&lt;/html&gt;</programlisting>
-        </step>
-
-        <step>
-          <para>Normalisieren Sie den Inhalt dieser Datei mit Hilfe
-            von <command>osgmlnorm</command> und sehen Sie sich das
-            Ergebnis an.  Achten Sie dabei darauf, welche Absätze
-            enthalten beziehungsweise nicht enthalten sind und was aus
-            den <literal>CDATA</literal>-Bereichen geworden ist.</para>
-	</step>
-
-        <step>
-          <para>Ä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>osgmlnorm</command> und vergleichen die Ausgabe mit
-            der vom ersten <command>osgmlnorm</command> Lauf.</para>
-
-        </step>
-      </procedure>
-    </sect2>
-  </sect1>
-
-  <sect1 xml:id="xml-primer-conclusion">
-    <title>Schlussbemerkung</title>
-
-    <para>Aus Platzgründen, und um der Verständlichkeit
-      Willen, wurden viele Gesichtspunkte nicht in aller Tiefe
-      beziehungsweise gar nicht besprochen. Trotzdem sollte in den
-      bisherigen Kapiteln genügend Wissen über SGML
-      vermittelt worden sein, um den Aufbau der Dokumentation des FDPs
-      zu verstehen.</para>
-
-  </sect1>
-</chapter>

Property changes on: head/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml
___________________________________________________________________
Deleted: svn:keywords
## -1 +0,0 ##
-FreeBSD=%H
\ No newline at end of property
Deleted: svn:mime-type
## -1 +0,0 ##
-text/sgml
\ No newline at end of property
Index: head/de_DE.ISO8859-1/books/fdp-primer/working-copy/chapter.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/working-copy/chapter.xml	(nonexistent)
+++ head/de_DE.ISO8859-1/books/fdp-primer/working-copy/chapter.xml	(revision 46773)
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- Copyright (c) 2013 Warren Block
+    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 THE AUTHOR "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$
+     basiert auf:
+-->
+
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="working-copy">
+  <title>The Working Copy (noch nicht übersetzt)</title>
+
+  <para>Dieses Kapitel ist noch nicht übersetzt.  Lesen Sie daher bitte
+    das <link
+    xlink:href="&url.books.fdp-primer.en;/working-copy.html">Original in
+    englischer Sprache</link>.  Wenn Sie bei der Übersetzung
+    mithelfen wollen, schicken Sie bitte eine E-Mail
+    an &a.de.translators;.</para>
+</chapter>

Property changes on: head/de_DE.ISO8859-1/books/fdp-primer/working-copy/chapter.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+FreeBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/xml
\ No newline at end of property
Index: head/de_DE.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml	(nonexistent)
+++ head/de_DE.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml	(revision 46773)
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- Copyright (c) 2013 Warren Block
+    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 THE AUTHOR "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$
+     basiert auf:
+-->
+
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="xhtml-markup">
+  <title>XHMTL Markup (noch nicht übersetzt)</title>
+
+  <para>Dieses Kapitel ist noch nicht übersetzt.  Lesen Sie daher bitte
+    das <link
+    xlink:href="&url.books.fdp-primer.en;/xhtml-markup.html">Original in
+    englischer Sprache</link>.  Wenn Sie bei der Übersetzung
+    mithelfen wollen, schicken Sie bitte eine E-Mail
+    an &a.de.translators;.</para>
+</chapter>

Property changes on: head/de_DE.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+FreeBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/xml
\ No newline at end of property
Index: head/de_DE.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml
===================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml	(nonexistent)
+++ head/de_DE.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml	(revision 46773)
@@ -0,0 +1,1916 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- 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$
+     basiert auf: r38826
+-->
+<!--?
+o SGML-Kontext sollte besser mit Umgebung uebersetzt werden.
+
+Oliver Fischer
+
+-->
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="xml-primer">
+  <title>Die XML-Fibel</title>
+
+  <para>Die Mehrzahl der Dokumente des FDPs sind in XML geschrieben.
+    Ziel dieses Kapitels ist es, genau zu erklären, was
+    das bedeutet und wie man die XML-Quellen liest und versteht.
+    Ebenso werden die in den Quellen genutzten Kniffe erklärt,
+    auf die man beim Lesen der Dokumente stoßen wird.</para>
+
+  <para>Teile dieses Kapitels basieren auf Mark Galassis <quote><link xlink:href="http://www.galassi.org/mark/mydocs/docbook-intro/docbook-intro.html">Get
+    Going With DocBook</link></quote>.</para>
+
+  <sect1 xml:id="xml-primer-overview">
+    <title>Ü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ür viele Zwecke war dies allerdings nicht ausreichend.
+      Von einem maschinenlesbaren 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ähnlichen</quote> Schrift auf dem
+      Bildschirm dargestellt werden, der Ausdruck soll jedoch in
+      <quote>Schrägschrift</quote> oder in einer beliebigen anderen
+      Darstellungsform erfolgen.</para>
+
+    <para>Anfänglich gab es die Hoffnung, dass die
+      Künstliche Intelligenz (KI) helfen würde, dieses Ziel
+      zu erreichen. Computer sollte den Text lesen und dazu in der Lage
+      sein, selbstständig wichtige Formulierungen, Dateinamen,
+      Benutzereingaben oder Beispiele zu erkennen.  Leider verlief die
+      Entwicklung in diesem Bereich nicht wie gewünscht und Computer
+      benötigen nach wie vor etwas Unterstützung, bevor sie
+      Texte vernünftig verarbeiten können.</para>
+
+    <para>Genauer gesagt, man muss ihnen sagen, was was ist. Sehen
+      wir uns folgende Zeilen an:</para>
+
+      <blockquote>
+	<para>Löschen Sie <filename>/tmp/foo</filename> mittels &man.rm.1;.</para>
+
+	<screen>&prompt.user; <userinput>rm /tmp/foo</userinput></screen>
+      </blockquote>
+
+    <para>Es fä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ächsischen Sprachraum wird von
+            <quote>markup</quote>
+            gesprochen.</para></footnote></quote> bedeutet, dass
+      sich der Wert eines Textes erhöht, aber auch seine Kosten.
+      Durch Auszeichnungen wird einem Dokument zusätzlicher Text
+      hinzugefügt, der aber von dem eigentlichen Dokumenteninhalt
+      auf eine bestimmte Art und Weise unterschieden werden kann, so
+      dass Programme die Auszeichnung erkennen können und
+      mittels dieser Informationen während der Verarbeitung in
+      der Lage sind, Entscheidungen zu treffen. Texteditoren
+      kö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ätzlich abgelegten Informationen erhöhen den Wert
+      des Dokuments. Allerdings muss diese Arbeit in den meisten
+      Fällen von einem Menschen getan werden &ndash; wären
+      Maschinen dazu fähig, wären zusätzliche
+      Auszeichnungselemente unnötig. Der damit verbundene Aufwand
+      <emphasis>erhö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><![CDATA[
+<para>Lö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ü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ürlich kann es keine universelle
+      Auszeichnungssprache geben und eine einzige mag nicht
+      ausreichend für alle möglichen Anwendungsfälle
+      sein. Eine  Sprache für technische Dokumente wird sich
+      wahrscheinlich stark von einer für Kochrezepte
+      unterscheiden. Die universelle Lösung ist eine
+      Basissprache, mit deren Hilfe weitere Sprachen entwickelt werden
+      können &ndash; eine
+      <emphasis>Meta-Auszeichnungssprache</emphasis> also.</para>
+
+    <para>Genau diese Anforderung wird von der Standard Generalized
+      Markup Language (<abbrev>SGML</abbrev>) erfüllt. Mit ihrer
+      Hilfe wurden viele andere Auszeichnungssprachen 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ögliche Reihenfolge
+      und Verschachtelung sowie weitere Informationen
+      festgelegt.</para>
+
+      <!-- Der letzte Satz dieses Absatzes muss noch übersetzt werden.
+      Ich habe keine gute Übersetzung dafü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 xml:id="xml-primer-validating">Eine DTD ist eine
+      <emphasis>vollständige</emphasis> Definition aller
+      möglichen Sprachelemente, ihrer
+      Reihenfolge<footnote><para>Bei natürlichen Sprachen spricht
+          man vom Satzbau  &ndash; demjenigen Konstrukt, das unter
+          anderem die Position des Subjekts, Objekts und
+          Prädikats in einem Satz festlegt.</para></footnote>,
+      optionaler Elemente und so weiter und so weiter. Dank dieser
+      recht formalen Festlegung ist es möglich,
+      SGML-<emphasis>Parser</emphasis> zu entwickeln, die sowohl ein
+      Dokument  als auch seine DTD einlesen und anhand dieser DTD
+      prüfen kö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
+        überprüft lediglich die korrekte Syntax des
+        Dokuments, dass heißt, ob nur gültige
+        Auszeichnungselemente verwendet wurden und ihre Reihenfolge
+        stimmt. Dabei wird <emphasis>nicht</emphasis> geprüft, ob
+        die Elemente der DTD <emphasis>sinngemäß</emphasis>
+        verwandt wurden. Sollten beispielsweise alle Dateinamen als
+        Funktionsnamen ausgezeichnet worden sein, so würde der
+        Parser keinen Fehler signalisieren. Formaler ausgedrückt:
+        Der Parser prüft die Syntax, aber nicht die
+        Semantik.</para>
+      </note>
+
+    <para>Es ist anzunehmen, dass, wenn man selber vor hat
+      Dokumentation für das FDP zu schreiben, der
+      größte Teil davon mit Hilfe von HTML oder DocBook
+      geschrieben werden wird. Aus diesem Grunde wird an dieser Stelle
+      nicht erklärt, wie eine DTD entwickelt wird.</para>
+    </sect1>
+
+    <sect1 xml:id="xml-primer-elements">
+    <title>Von Elementen, Tags und Attributen</title>
+
+    <!-- Bei der Ü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ä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ä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ält nun
+      Kapitel, die wiederum selbst als Elemente bezeichnet werden
+      können. Jedes einzelne Kapitel enthält weitere
+      Elemente. So gibt es beispielsweise Absätze, Zitate und
+      Fuß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öchte, kann man sich das als
+      <quote>Unterteilung</quote><footnote><para>Im
+          angelsächsischen 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ätze, Fuß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ö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ählt werden, um zu
+      bestimmen, zu welchem Element die einzelnen Inhalte
+      gehören. In SGML-basierten Auszeichnungssprachen wie HTML
+      und DocBook  werden dafü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ö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ürlich auch unterschiedlich benannt sein werden.</para>
+
+    <para>Der Starttag für ein imaginäres Element mit dem
+      Namen <replaceable>elementname</replaceable> ist
+      <tag>&lt;<replaceable>elementname</replaceable>&gt;</tag>.
+      Sein Gegenstück, der schließende Endtag, ist
+      <tag>&lt;/<replaceable>elementname</replaceable>&gt;</tag>.</para>
+
+    <example>
+      <title>Verwendung eines Elements (Start- und Endtag)</title>
+
+      <para>HTML kennt das Element <tag>p</tag>, um
+        festzulegen, dass ein bestimmter abgegrenzter Bereich
+        einen Absatz darstellt. Dieses Element hat sowohl einen Start-
+        als auch einen Endtag.</para>
+
+      <programlisting><![CDATA[<p>Das ist ein Absatz. Er beginnt mit Starttag
+  für das Element 'p' und endet mit dem Endtag für
+  das Element 'p'.</p>
+
+<p>Das ist ein etwas kürzerer Absatz.</p>]]></programlisting>
+    </example>
+
+    <para>Elemente mü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ötigt.</para>
+
+    <example>
+      <title>Verwendung eines Elements (nur Starttag)</title>
+
+      <para>In HTML kann man mit dem Element <tag>hr</tag>
+        festlegen, dass an einer bestimmten Stelle eine
+        horizontale Linie angezeigt werden soll. Da dieses Element
+        keinen Inhalt umschließ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önnen andere Elemente enthalten.  Im
+      anfangs erwähnten Buch enthielt das Buch-Element
+      alle Kapitel-Elemente, die wiederum alle Absatz-Elemente
+      enthielten und so fort.</para>
+
+    <example>
+      <title>Verschachtelte Elemente: <tag>em</tag></title>
+
+      <programlisting><![CDATA[<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ö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ä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 <tag>p</tag></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 <tag>p</tag></quote>
+        gesprochen, ist damit das gesamte Element gemeint.</para>
+
+      <para>Diese Unterscheidung ist sicherlich subtil. Trotzdem
+        sollte man sie sich vergegenwärtigen.</para>
+    </important>
+
+    <para>Elemente können selber Attribute haben, die aus einem
+      Namen und einem Wert bestehen.  Die Attribute haben die Aufgabe,
+      dem Element zusätzliche Informationen hinzuzufügen.
+      Denkbar sind hier Festlegungen über die Darstellung,
+      Bezeichner, über die das Element eindeutig identifiziert
+      werden kann, oder beliebige andere Informationen.</para>
+
+    <para>Elementattribute werden in den <emphasis>Starttag</emphasis>
+      eingefügt und haben die Form
+      <literal>Attributename="Wert"</literal>.</para>
+
+    <para>Bei einigen HTML-Versionen kennt das Element
+      <tag>p</tag> das Attribut <tag>align</tag>, 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><![CDATA[<p align="left">Die Verwendung des align-Attributs
+  für diesen Absatz ist überflü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ält Attributwert doppelte Anführungszeichen
+      (<literal>"</literal>), wird der Wert in einfachen
+      Anführungszeichen eingeschlossen.</para>
+
+    <example>
+      <title>Attribute mit einfachen Anführungszeichen</title>
+
+      <programlisting><![CDATA[<p align='right'>Ich stehe rechts!</p>]]></programlisting>
+    </example>
+
+
+    <para>Manchmal können die Anführungszeichen um den
+      Attributwert weggelassen werden.  Allerdings sind die Regeln,
+      die festlegen wann dies zulässig ist, sehr spitzfindig.
+      Am besten schließen Sie Attributwerte
+      <emphasis>immer</emphasis> in Anführungszeichen ein.</para>
+
+    <para>Die Informationen ü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
+      <package>textproc/docproj</package> installiert
+      werden, bringen ihre eigenen Katalogvarianten mit, zudem pflegt
+      das FDP seine  eigenen Kataloge. Beide Katalogarten müssen
+      von allen Programmen gefunden werden können.</para>
+
+    <sect2>
+      <title>Was dafür getan werden muss;&hellip;</title>
+
+      <para>Damit die Beispiele dieser Fibel ausgeführt werden
+        kö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
+            <package>textproc/docproj</package>
+            über das FreeBSD-Portsystem. <package>textproc/docproj</package> ist ein
+            <emphasis>Metaport</emphasis>, der alle vom FDP
+            benötigten Programme und Daten aus dem Netz laden und
+            installieren sollte.</para>
+        </step>
+
+        <step>
+          <para>Anschließend muss in den Shellkonfigurationsdateien die
+            Variable <envar>SGML_CATALOG_FILES</envar>
+            <footnote><simpara>Sofern man nicht an der deutschen
+                Dokumentation arbeitet, müssen die
+                Verzeichnisangaben entsprechend angepasst
+                werden.</simpara>
+              </footnote> gesetzt werden.</para>
+
+            <example xml:id="xml-primer-envars">
+              <title><filename>.profile</filename>, für &man.sh.1; und
+                &man.bash.1; Benutzer</title>
+
+	    <programlisting>SGML_ROOT=/usr/local/share/xml
+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/xml/catalog:$SGML_CATALOG_FILES
+SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/xml/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ür &man.csh.1;- und
+              &man.tcsh.1;-Benutzer</title>
+
+            <programlisting>setenv SGML_ROOT /usr/local/share/xml
+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/xml/catalog:$SGML_CATALOG_FILES
+setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/xml/catalog:$SGML_CATALOG_FILES
+setenv SGML_CATALOG_FILES /usr/doc/de_DE.ISO8859-1/share/xml/catalog:$SGML_CATALOG_FILES</programlisting>
+            </example>
+
+          <para>Damit die Änderungen wirksam werden, meldet man
+            sich ab und anschließend wieder an &ndash; oder man
+            führt die obigen Anweisungen direkt in der Shell
+            aus und setzt so die benötigten Umgebungsvariablen.</para>
+
+        </step>
+      </procedure>
+
+      <procedure>
+        <step>
+          <para>Nun sollte man eine Datei
+            <filename>beispiel.xml</filename> anlegen, die den
+            folgenden Text enthält:</para>
+
+            <programlisting><![CDATA[<!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ü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 <package>textproc/docproj</package>
+            ist <command>onsgmls</command> - ein <link linkend="xml-primer-validating">validierender Parser</link>.
+            <command>onsgmls</command> liest ein Dokument entsprechend einer SGML-DTD
+            ein und gibt anschließend ein Element-Structure-Information-Set
+            (ESIS) aus. Allerdings ist das an dieser Stelle nicht weiter
+            wichtig.</para>
+
+          <para>Wird <command>onsgmls</command> mit der Option <option>-s</option>
+            aufgerufen, werden nur Fehlermeldungen ausgegeben. Dadurch
+            kann leicht geprüft werden, ob ein Dokument gültig
+            ist oder nicht.</para>
+
+          <para>So prüft man mit <command>onsgmls</command>, ob die neuangelegte
+            Beispieldatei gültig ist:</para>
+
+            <screen>&prompt.user; <userinput>onsgmls -s beispiel.xml</userinput></screen>
+
+          <para>Sofern das Beispiel korrekt abgetippt wurde, wird sich
+            <command>onsgmls</command> ohne jegliche Ausgabe beenden. Das bedeutet,
+            dass das Dokument erfolgreich validiert werden konnte
+            und somit gültig ist.</para>
+        </step>
+
+        <step>
+          <para>Jetzt sollten die Tags <tag>title</tag> und
+            <tag>/title</tag> aus dem Dokument gelöscht
+            und das Dokument erneut validiert werden:</para>
+
+            <screen>&prompt.user; <userinput>onsgmls -s beispiel.xml</userinput>
+onsgmls:beispiel.xml:5:4:E: character data is not allowed here
+onsgmls:beispiel.xml:6:8:E: end tag for "HEAD" which is not finished</screen>
+
+          <para>Die Fehlermeldungen, die von <command>onsgmls</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>onsgmls</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 über die
+                    Art des Fehlers informiert. <literal>I</literal>
+                    steht für eine informelle Meldung,
+                    <literal>W</literal> für eine Warnung und
+                    <literal>E</literal> für Fehler<footnote>
+                      <para>Nicht immer besteht eine Meldung aus
+                        fünf Spalten. Die Ausgabe von
+                        <command>onsgmls -sv</command> ist
+                        beispielsweise <literal>onsgmls:I: SP version
+                          "1.3"</literal> (natürlich
+                        abhängig von der Version). Wie man sehen
+                        kann, handelt es sich hier um eine informelle
+                        Meldung.</para>
+                    </footnote> und <literal>X</literal> fü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 <tag>title</tag>
+            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 <tag>head</tag>
+            auftreten kann.</para>
+
+          <para>Der zweite Fehler wurde dadurch verursacht, dass
+            das Element <tag>head</tag> ein
+            Element <tag>title</tag> enthalten
+            <emphasis>muss</emphasis> und <command>onsgmls</command>
+            nicht berücksichtigt, dass dieser Fehler auf dem
+            vorhergehenden beruht. Es wird lediglich festgestellt,
+            dass der Endtag von <tag>head</tag> auftritt,
+	    obwohl nicht alle notwendigen Elemente vorhanden sind.</para>
+        </step>
+
+        <step>
+		<para>Zum Schluss sollte der Tag
+            <tag>title</tag> wieder in die Beispieldatei
+            eingefügt werden.</para>
+          </step>
+        </procedure>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="xml-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önnen SGML-Parser die verwendete DTD
+      feststellen und prüfen, ob das Dokument zu ihr konform ist.</para>
+
+    <para>Üblicherweise steht diese Information in einer Zeile,
+      die als DOCTYPE-Deklaration bezeichnet wird.</para>
+
+
+    <para>Eine Deklaration für ein HTML-Dokument, das nach den
+      Vorgaben der DTD fü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 ü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ür
+            den Dokumententyp ist.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><literal>html</literal></term>
+
+        <listitem>
+          <para>Nennt das erste <link linkend="xml-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 Ö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üsselwort <literal>PUBLIC</literal>
+            gehört nicht zum öffentlichen Bezeichner,
+            sondern legt fest, wie ein SGML-Parser die DTD finden
+            kann. Alternative Wege eine DTD zu referenzieren werden
+            <link linkend="xml-primer-fpi-alternatives">später
+              gezeigt</link>.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><literal>&gt;</literal></term>
+
+        <listitem>
+          <para>Schließt den mit <literal>&lt;!</literal> begonnenen
+            Ausdruck ab.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+    <sect2>
+      <title>Formale Öffentliche Bezeichner</title>
+
+      <!--? -->
+      <note>
+        <para>Dieser Abschnitt braucht nicht unbedingt zu gelesen zu
+          werden. Dennoch ist es empfehlenswert, da er nützliche
+          Hintergrundinformationen enthält, die hilfreich sein
+          können, falls der SGML-Prozessor die genutzte DTD nicht
+          finden kann.</para>
+      </note>
+
+      <para>Jeder öffentliche Bezeichner muss eine bestimmte Syntax
+        haben, die wie folgt lautet:</para>
+
+      <!-- Oliver Fischer: Ich habe hier Owner mit Besitzer uebersetzt.
+      Mein Gefühl sagt mir, dass dies nicht 100% richtig ist.
+      Vielleicht ist Aussteller bessert? -->
+
+      <programlisting>"<replaceable>Besitzer</replaceable>//<replaceable>Schlüsselwort</replaceable> <replaceable>Beschreibung</replaceable>//<replaceable>Sprache</replaceable>"</programlisting>
+
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>Besitzer</replaceable></term>
+
+          <listitem>
+            <para>Nennt den Besitzer des öffentlichen Bezeichners.</para>
+
+            <para>Falls diese Zeichenkette mit <quote>ISO</quote>
+              beginnt, gehört der Bezeichner dem ISO-Komitee.
+              Der Bezeichner <literal>"ISO 8879:1986//ENTITIES Greek
+                Symbols//EN"</literal> nennt <quote>ISO
+                8879:1986</quote> als den Besitzer des Satzes von
+              Entitäten für griechische Zeichen. ISO
+              8879:1986 ist die ISO-Bezeichnung für den
+              SGML-Standard.</para>
+
+
+            <!--? Die Formulierung gefällt mir nicht. Oliver Fischer -->
+            <para>Beginnt die Zeichenkette nicht mit
+              <quote>ISO</quote>, sieht sie entweder so
+              <literal>-//Besitzer</literal>
+              oder so
+              <literal>+//Besitzer</literal>
+              aus. Beide Varianten unterscheiden sich also nur durch
+              das anfängliche <literal>+</literal> bzw.
+              <literal>-</literal>.</para>
+
+            <para>Sofern am Anfang ein <literal>-</literal> steht, ist
+              der Bezeichner nicht öffentlich registriert, steht
+              hingegen ein <literal>+</literal> am Anfang, ist er
+              registriert.</para>
+
+
+            <!--? Vielleicht besser: Wie Namen registeriert werden?
+            Oliver Fischer -->
+            <!--? Mit der Übersetzung des letzten Satzes bin ich mir
+            nicht sicher.... Das muss irgendwie besser ausgedrückt
+            werden.... -->
+
+            <para>Im ISO-Standard ISO 9070:1991 wurde festgelegt, wie
+              registrierte Namen erzeugt werden können. Unter
+              anderem können sie von den Bezeichnungen von
+              ISO-Publikationen, von ISBN-Nummern oder einer
+              Organisationsbezeichnungen entsprechend ISO 6523
+              abgeleitet werden. Anträge für neue offiziell
+              registrierte Bezeichner werden vom ISO-Komitee 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üsselwort</replaceable></term>
+
+          <listitem>
+            <para>Es gibt verschiedene Schlüsselwörter mit
+              denen man die Art der gegebenen Informationen beschreiben
+              kann. Einige der üblichsten sind
+              <literal>DTD</literal>, <literal>ELEMENT</literal>,
+              <literal>ENTITIES</literal> und <literal>TEXT</literal>.
+              <literal>DTD</literal> wird nur für Dateien mit
+              DTDs verwandt, <literal>ELEMENT</literal> findet
+              für Dateien mit Fragmenten von DTDs Verwendung, die
+              nur Deklarationen für Entitäten und Elemente
+              enthalten. <literal>TEXT</literal> wird für
+              SGML-Inhalte (Texte und Tags) verwendet.</para>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
+          <term><replaceable>Beschreibung</replaceable></term>
+
+          <listitem>
+            <para>Eine frei wählbare Beschreibung des Inhalts der
+              referenzierten Datei. Mö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ür
+              die Datei verwendete Sprache nennt.
+              <literal>EN</literal> steht hier für Englisch,
+              <literal>DE</literal> für Deutsch.</para>
+          </listitem>
+        </varlistentry>
+      </variablelist>
+
+      <sect3>
+        <title>Die <filename>catalog</filename>-Dateien</title>
+
+        <para>Wenn man die oben beschriebene Syntax für
+          Bezeichner verwendet und ein Dokument durch einen
+          SGML-Prozessor schickt, muss dieser die
+          Möglichkeit haben, den Bezeichner auf eine real
+          existierende Datei abzubilden, die die benötigte DTD
+          enthält.</para>
+
+        <para>Einer der möglichen Wege hierfür sind
+          Katalogdateien. Eine solche Datei, die üblicherweise
+          <filename>catalog</filename> heißt, besteht aus
+          einzelnen Zeilen, die Bezeichner auf Dateinamen abbilden.
+          Enthä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über feststellen, dass die
+          benötigte DTD in der Datei <filename>strict.dtd</filename>
+          im Unterverzeichnis <filename>4.0</filename>
+          des Verzeichnisses des Katalogs zu finden ist.</para>
+
+        <para>Ein gutes Beispiel für einen Katalog ist
+          <filename>/usr/local/share/xml/html/catalog</filename>.
+          Diese Datei enthält den Katalog für alle HTML
+          DTDs, die im Zuge der Installation von <package>textproc/docproj</package> installiert
+          wurden.</para>
+
+      </sect3>
+
+      <sect3>
+        <title>Die Variable <envar>SGML_CATALOG_FILES</envar></title>
+
+        <para>Natürlich muss einem SGML-Prozessor noch
+          mitgeteilt werden können, wo er seine Kataloge finden
+          kann. Viele Programme bieten hierfür
+          Kommandozeilenoptionen an, über die man einen oder
+          mehrere Kataloge angeben kann.</para>
+
+        <para>Zusätzlich besteht noch die Möglichkeit mit
+          der Umgebungsvariablen <envar>SGML_CATALOG_FILES</envar> auf
+          SGML-Kataloge zu verweisen. Die Einträge von
+          <envar>SGML_CATALOG_FILES</envar> müssen aus den
+          vollständigen Pfadnamen der Kataloge, jeweils durch
+          Komma getrennt, bestehen.</para>
+
+
+        <!--? Stimmt die Formulierung? Oliver Fischer -->
+        <para>Üblicherweise werden die folgenden Kataloge über
+            <envar>SGML_CATALOG_FILES</envar> für
+          die Arbeit an den Dokumenten des FDPs eingebunden:</para>
+
+        <itemizedlist>
+          <listitem>
+            <para><filename>/usr/local/share/xml/docbook/4.1/catalog</filename></para>
+          </listitem>
+
+          <listitem>
+            <para><filename>/usr/local/share/xml/html/catalog</filename></para>
+          </listitem>
+
+          <listitem>
+            <para><filename>/usr/local/share/xml/iso8879/catalog</filename></para>
+          </listitem>
+
+          <listitem>
+            <para><filename>/usr/local/share/xml/jade/catalog</filename></para>
+          </listitem>
+        </itemizedlist>
+
+        <para>Allerdings sollte das
+          <link linkend="xml-primer-envars">schon geschehen
+            sein</link>.</para>
+
+      </sect3>
+    </sect2>
+
+    <sect2 xml:id="xml-primer-fpi-alternatives">
+      <title>Alternativen zu Formalen Öffentlichen Bezeichnern</title>
+
+      <para>Anstatt mit einem Bezeichner die zum Dokument
+        gehörende DTD zu referenzieren, kann auch explizit auf
+        die Datei der DTD verwiesen werden.</para>
+
+      <para>Die Syntax der DOCTYPE-Deklaration ist in diesem Falle
+        anders:</para>
+      <!--<para>The syntax for this is slightly different:</para>-->
+
+      <programlisting><![CDATA[<!DOCTYPE html SYSTEM "/pfad/zur/dokumenten.dtd">]]></programlisting>
+
+      <para>Das Schlü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 öffentliche Bezeichner aus
+        Gründen der Portabilitä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ötigte DTD auf anderen Systemen genau
+        unter dem gleichen Pfad verfügbar ist.</para>
+
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="xml-primer-xml-escape">
+    <title>Die Rückkehr zu SGML</title>
+
+    <para>An einer früheren Stelle wurde erwähnt, dass
+      man SGML nur benötigt, falls man selbst eine DTD entwickeln
+      möchte. Genaugenommen ist das nicht 100%ig richtig. Einige
+      Teile der SGML-Syntax können auch in normalen Dokumenten
+      verwendet werden, falls dies gewünscht oder notwendig
+      ist.</para>
+
+    <para>In diesem Falle muss dafü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="xml-primer-doctype-declaration">DOCTYPE-Deklaration</link>
+      ein gutes Beispiel für SGML, das in Dokumenten verwendet
+      werden muss&hellip;</para>
+
+  </sect1>
+
+  <sect1 xml:id="xml-primer-comments">
+    <title>Kommentare</title>
+
+    <para>Kommentare sind SGML-Konstrukte, die normalerweise nur
+      in DTDs gültig sind. Dennoch ist es, wie in
+      <xref linkend="xml-primer-xml-escape"/> gezeigt,
+      mö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 öffnet er einen Kommentar, mit
+      seinem zweiten schließt er ihn wieder.</para>
+
+    <example>
+      <title>Beispiele für Kommentare in SGML</title>
+
+      <programlisting>&lt;!-- Testkommentar --&gt;</programlisting>
+
+      <programlisting>
+&lt;!&hyphen;- Text innerhalb eines Kommentars -&hyphen;&gt;
+
+6lt;!&hyphen;- Ein anderer Kommentar    -&hyphen;&gt;
+
+6lt;!&hyphen;- So können mehrzeilige Kommentare
+     genutzt werden -&hyphen;&gt;
+
+&lt;!&hyphen;- Eine andere Möglichkeit für -&hyphen;
+  &hyphen;- mehrzeilige Kommentare.     -&hyphen;&gt;</programlisting>
+    </example>
+
+    <para>Hat man früher schon Erfahrungen mit HTML gesammelt,
+      wird man vielleicht andere Regeln fü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>
+&lt;!&hyphen;- Innerhalb eines Kommentars -&hyphen;
+
+     DIES IST NICHT TEIL EINES KOMMENTARS
+
+  &hyphen;- Wieder innerhalb eines Kommentars -&hyphen;&gt;</programlisting>
+
+      <para>SGML-Parser wü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ültiges SGML handelt, kann
+        diese Zeile zur verwirrenden  Fehlermeldungen führen.</para>
+
+      <programlisting>&lt;!&hyphen;&hyphen;&hyphen;&hyphen;&hyphen; Eine wirklich schlechte Idee  &hyphen;&hyphen;&hyphen;&hyphen;&hyphen;&gt;</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>&lt;!&hyphen;-===================================================-&hyphen;&gt;</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übungen&hellip;</title>
+
+      <procedure>
+        <step>
+          <para>Zur Übung können Sie einige Kommentare in
+            die Datei <filename>beispiel.xml</filename> einfügen
+            und überprüfen, ob die Datei nun noch erfolgreich
+            von <command>onsgmls</command> validiert werden kann.</para>
+        </step>
+
+        <step>
+          <para>Zu Testzwecken sollten Sie
+            auch noch ein paar fehlerhafte Kommentare hinzufügen
+            und sich die resultierenden Fehlermeldungen von
+	    <command>onsgmls</command> ansehen.</para>
+        </step>
+      </procedure>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="xml-primer-entities">
+    <title>Entitäten</title>
+
+    <para>Entitäten stellen einen Mechanismus dar, mit dem
+      einzelnen Dokumententeilen  ein Name zugewiesen werden kann.
+      Findet ein SGML-Parser während des Parsens eine
+      Entität, ersetzt er diese durch den ihr zugewiesenen
+      Inhalt.</para>
+
+    <para>Dadurch steht eine einfache Möglichkeit zur
+      Verfügung, mit der  variabler Inhalt in SGML-Dokumenten
+      eingebunden werden kann. Zusätzlich sind Entitäten der
+      einzige Weg, über den eine Datei in eine andere Datei mit
+      SGML-Mitteln eingebunden werden kann.</para>
+
+    <para>Es werden zwei Arten von Entitäten unterschieden:
+      <emphasis>Allgemeine Entitäten</emphasis> und
+      <emphasis>Parameterentitäten</emphasis>.</para>
+
+    <sect2 xml:id="xml-primer-general-entities">
+      <title>Allgemeine Entitäten</title>
+
+      <para>Allgemeine Entitäten können nur in
+	Dokumenten benutzt werden.  Sie können zwar im
+	SGML-Kontext definiert aber dort nicht benutzt
+	werden.  Vergleichen Sie dies mit
+        Im <link linkend="xml-primer-parameter-entities">Parameterentitäten</link>.</para>
+
+      <para>Jede allgemeine Entität hat einen Namen, über
+        den sie angesprochen werden kann, um den von ihr
+        referenzierten Inhalt in ein Dokument einzubinden. Dafür
+        muss an der betreffenden Stelle der Namen der
+        Entität per
+        <literal>&amp;entitaetenname;</literal>
+        einfügt werden. Eine Entität
+        <literal>current.version</literal> könnte beispielsweise
+        durch die aktuelle Versionsnummer eines Programms ersetzt
+        werden. Man könnte also schreiben:</para>
+
+      <!--?
+      Der vorhergehende Satz ist nicht 100% sinngemaeß 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 ändert, muss
+	nur die Entität angepasst und anschließend
+	das Dokument neu erzeugt werden.</para>
+
+      <para>Eine weitere Einsatzmöglichkeit für Allgemeine
+        Entitäten ist das Einbinden von Zeichen, die auf andere
+        Weise nicht in ein SGML-Dokument eingefügt werden
+        könnten. Ein Beispiel für solche Zeichen sind
+        <literal>&lt;</literal> und <literal>&amp;</literal>, die
+        normalerweise nicht direkt in
+        SGML-Dokumenten erlaubt sind. Stöß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ät gefunden zu haben.</para>
+
+      <para>Wenn eines der beiden Zeichen benötigt wird, werden
+	daher die allgemeinen Entitäten <literal>&amp;lt;</literal>
+	und <literal>&amp;amp;</literal> verwendet.</para>
+
+      <para>Allgemeine Entitäten können nur in einem
+        SGML-Kontext definiert werden. Üblich ist es, dies direkt
+        nach der DOCTYPE-Deklaration zu tun:</para>
+
+      <example>
+        <title>Allgemeine Entitä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ä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 über DOCTYPE genannte DTD erweitern möchte.</para>
+
+      </example>
+    </sect2>
+
+    <sect2 xml:id="xml-primer-parameter-entities">
+      <title>Parameterentitäten</title>
+
+      <para>Genau wie <link linkend="xml-primer-general-entities">Allgemeine
+          Entitäten</link> werden Parameterentitäten
+        eingesetzt um wiederverwendbare Inhaltsteile mit Namen zu
+        versehen. Im Gegensatz zu Allgemeinen Entitäten
+        können sie aber nur innerhalb eines <link linkend="xml-primer-xml-escape">SGML-Kontextes</link>
+        genutzt werden.</para>
+
+      <para>Die Definition von Parameterentitäten erfolgt
+        ähnlich zu der Allgemeiner Entitäten. Sie werden
+        lediglich mit
+        <literal>%entitaetenname;</literal>
+        anstelle von
+        <literal>&amp;entitaetenname;</literal>
+        referenziert<footnote>
+          <para>Es wird das Prozentzeichen anstelle des
+            kaufmännischen Unds verwendet.</para>
+        </footnote>. Wichtig ist, dass das
+        <literal>%</literal>-Zeichen zwischen
+        <literal>ENTITY</literal> und dem Entitätennamen ein Teil
+        der Definition ist.</para>
+
+      <example>
+        <title>Parameterentitä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">
+]>]]></programlisting>
+        </example>
+
+        <!--? Noch nicht übersetzt. Oliver Fischer -->
+        <!--<para>This may not seem particularly useful.  It will be.</para>-->
+      </sect2>
+
+    <sect2>
+      <title>Fingerübungen&hellip;</title>
+
+      <procedure>
+        <step>
+          <para>Fügen Sie in <filename>beispiel.xml</filename>
+            eine Allgemeine Entität ein.</para>
+
+            <programlisting><![CDATA[<!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ündig
+      ausgerichtet.</p>
+
+    <p>Die aktuelle Version ist: &amp;version;</p>
+  </body>
+</html>]]></programlisting>
+        </step>
+
+        <step>
+          <para>Validieren Sie diese Datei mit
+            <command>onsgmls</command></para>
+        </step>
+
+        <step>
+          <para>Öffnen Sie nun <filename>beispiel.xml</filename>
+            mit Ihrem Webbrowser. Es kann notwendig sein, dass
+            Sie die Datei vorher in <filename>beispiel.html</filename>
+            umbenennen müssen, damit die Datei auch als
+            HTML-Dokument erkannt wird.</para>
+
+          <para>Nur wenn Sie einen sehr modernen Browser haben, werden
+            Sie sehen kö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ö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ätte
+                vermeiden können.</para>
+            </footnote>.</para>
+        </step>
+
+        <step>
+          <para>Die Lösung hierfür ist, das Dokument zu
+            <emphasis>normalisieren</emphasis>. Zu diesem Zweck liest
+            ein Normer <!--? Sehr freie Übersetzung. Oliver -->
+            das Dokument ein und gibt anschließend semantisch
+            gleichwertiges SGML wieder aus, dass auf verschiedene
+            Arten transformiert worden sein kann. Eine dieser
+            möglichen Transformationen ist das Ersetzen der
+            Referenzen auf Entitäten mit dem von ihnen
+            präsentierten Inhalt.</para>
+
+          <para>Versuchen Sie, die Beispieldatei mittels
+            <command>osgmlnorm</command> zu normalisieren:</para>
+
+            <screen>&prompt.user; <userinput>osgmlnorm beispiel.xml &gt; beispiel.html</userinput></screen>
+
+          <para>Anschließend sollten Sie eine normalisierte
+            Version, dass heißt eine, bei der die
+            Entitäten gegen ihren Inhalt ersetzt wurden, in der
+            Datei <filename>beispiel.html</filename> finden. Diese
+            Datei können Sie sich nun mit Ihrem Browser
+            ansehen.</para>
+
+        </step>
+
+        <step>
+          <para>Wenn Sie sich die Ausgaben von <command>osgmlnorm</command>
+            ansehen, werden Sie feststellen, dass
+            die DOCTYPE-Deklaration am Anfang der Datei nicht mehr
+            enthalten ist. Möchten Sie die Deklaration behalten,
+            muss <command>osgmlnorm</command> mit der Option
+            <option>-d</option> aufrufen werden:</para>
+
+          <screen>&prompt.user; <userinput>osgmlnorm -d beispiel.xml &gt; beispiel.html</userinput></screen>
+        </step>
+      </procedure>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="xml-primer-include">
+    <title>Dateien mit Entitäten einbinden</title>
+
+    <!--?
+    Dieser kleine Absatz klingt ziemlich hölzern.
+    Oliver Fischer
+    -->
+
+    <para>Sowohl <link linkend="xml-primer-general-entities">Allgemeine</link> als
+      auch <link linkend="xml-primer-parameter-entities">Parameterentitäten</link>
+      sind nützliche Helfer, wenn es darum geht, eine Datei in
+      eine andere einzubinden.</para>
+
+    <sect2 xml:id="xml-primer-include-using-gen-entities">
+      <title>Dateien mit Allgemeinen Entitä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.xml</filename>,
+        <filename>kapitel2.xml</filename> usw.) abgelegt und
+        über eine Datei <filename>buch.xml</filename> sollen
+        alle physischen Dateien wieder mit der Hilfe von
+        Entitäten zu einem logischen Dokument
+        zusammengeführt werden.</para>
+
+      <para>Damit der Inhalt der Dateien mit Entitäten
+	eingebunden werden kann, muss die Deklaration der
+        Entitäten das Schlüsselwort
+        <literal>SYSTEM</literal> enthalten. SGML-Parser werden so
+        angewiesen, den Inhalt der referenzierten Datei als Wert
+        für die jeweilige Entität zu nehmen.</para>
+
+      <example>
+        <title>Dateien mit Allgemeinen Entitäten einbinden</title>
+
+        <programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
+<!ENTITY kapitel.1 SYSTEM "kapitel1.xml">
+<!ENTITY kapitel.2 SYSTEM "kapitel2.xml">
+<!ENTITY kapitel.3 SYSTEM "kapitel3.xml">
+]>
+
+<html>
+
+  &amp;kapitel.1;
+  &amp;kapitel.2;
+  &amp;kapitel.3;
+</html>]]></programlisting>
+      </example>
+
+      <warning>
+        <para>Wenn man Allgemeine Entitäten benutzt, um andere
+          Dateien einzubinden, dürfen diese Dateien
+          (<filename>kapitel1.xml</filename>,
+          <filename>kapitel2.xml</filename>, ...)
+          <emphasis>keine</emphasis> eigene DOCTYPE-Deklaration
+          haben.</para>
+      </warning>
+    </sect2>
+
+    <sect2>
+      <title>Dateien mit Parameterentitäten einbinden</title>
+
+      <para>Wie bereits festgestellt, können
+        Parameterentitäten nur innerhalb eines SGML-Kontexts
+        genutzt werden. Warum möchte man aber Dateien innerhalb
+        eines SGML-Kontexts einbinden? Der Vorteil liegt in der
+        Möglichkeit, die Deklaration von Entitäten in eine
+        andere Datei auslagern zu kö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öglichkeit wäre es, die dafür notwendigen
+        Entitäten am Anfang jedes Buches einzeln festzulegen
+        &ndash; was allerdings mit der Zeit unhandlich und
+        fehlerträchtig wird.</para>
+
+      <para>Alternativ bietet sich dazu an, die Deklarationen in eine
+        separate Datei auszulagern und deren Inhalt anschließend
+        in beide Bücher über Parameterentitäten
+        einzubinden.</para>
+
+      <example>
+        <title>Dateien mit Parameterentitäten einbinden</title>
+
+        <para>Zuerst werden die Entitäten in einer separaten
+          Datei namens <filename>kapitel.ent</filename> deklariert.
+          <filename>kapitel.ent</filename> enthält für
+          dieses Beispiel die folgenden Zeilen:</para>
+
+        <programlisting><![CDATA[<!ENTITY kapitel.1 SYSTEM "kapitel1.xml">
+<!ENTITY kapitel.2 SYSTEM "kapitel2.xml">
+<!ENTITY kapitel.3 SYSTEM "kapitel3.xml">]]></programlisting>
+
+        <para>Im zweiten Schritt fügt man in beide Bücher
+          eine Parameterentität ein, die den Inhalt von
+          <filename>kapitel.ent</filename> referenziert, und lädt
+          über diese dann die Deklarationen. Anschließend
+          können die so geladenen Entitäten wie gewohnt
+          genutzt werden.</para>
+
+	<programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
+<!ENTITY % kapitel SYSTEM "kapitel.ent">
+%kapitel;
+]>
+
+<html>
+  &amp;kapitel.1;
+  &amp;kapitel.2;
+  &amp;kapitel.3;
+</html>]]></programlisting>
+      </example>
+    </sect2>
+
+    <sect2>
+      <title>Fingerübungen&hellip;</title>
+
+        <sect3>
+          <title>Binden Sie Dateien über Allgemeine Entitäten ein</title>
+
+          <procedure>
+            <step>
+              <para>Legen Sie drei Dateien (<filename>absatz1.xml</filename>,
+                <filename>absatz2.xml</filename> und <filename>absatz3.xml</filename>)
+                mit jeweils einer Zeile wie
+
+                <!--     <para>Create three files, <filename>para1.xml</filename>,
+                <filename>para2.xml</filename>, and
+                <filename>para3.xml</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>Ändern Sie <filename>beispiel.xml</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.xml">
+<!ENTITY absatz2 SYSTEM "absatz2.xml">
+<!ENTITY absatz3 SYSTEM "absatz3.xml">
+]>
+
+<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.xml</filename> normalisieren:</para>
+
+            <screen>&prompt.user; <userinput>osgmlnorm -d beispiel.xml &gt; beispiel.html</userinput></screen>
+          </step>
+
+          <step>
+            <para>Öffnen Sie <filename>beispiel.html</filename>
+              nun mit einem Webbrowser und vergewissern Sie sich,
+              dass der Inhalt der Dateien
+              <filename>absatzN.xml</filename>
+              in <filename>beispiel.html</filename> übernommen
+              wurde.</para>
+          </step>
+	</procedure>
+      </sect3>
+
+      <sect3>
+	<title>Binden Sie Dateien mit Parameterentitäten ein</title>
+
+	<note>
+	  <para>Hierfür müssen Sie die vorherige Fingerübung gemacht haben.</para>
+	</note>
+
+	<procedure>
+	  <step>
+	    <para>Ändern Sie <filename>beispiel.xml</filename> so
+              ab, dass es wie folgt aussieht:</para>
+
+	    <programlisting><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
+<!ENTITY % entitaeten SYSTEM "entitaeten.xml"> %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.xml</filename> an,
+                die folgenden Inhalt hat:</para>
+
+            <programlisting><![CDATA[<!ENTITY version "1.1">
+<!ENTITY absatz1 SYSTEM "absatz1.xml">
+<!ENTITY absatz2 SYSTEM "absatz2.xml">
+<!ENTITY absatz3 SYSTEM "absatz3.xml">]]></programlisting>
+          </step>
+
+          <step>
+            <para>Erzeugen Sie die Datei
+              <filename>beispiel.html</filename>, indem Sie
+              <filename>beispiel.xml</filename> normalisieren:</para>
+
+            <screen>&prompt.user; <userinput>osgmlnorm -d beispiel.xml &gt; beispiel.html</userinput></screen>
+          </step>
+
+          <step>
+            <para>Öffnen Sie <filename>beispiel.html</filename>
+              nun mit einem Webbrowser und vergewissern Sie sich,
+              dass der Inhalt der Dateien
+              <filename>absatzN.xml</filename>
+              in <filename>beispiel.html</filename> übernommen
+              wurde.</para>
+          </step>
+        </procedure>
+      </sect3>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="xml-primer-marked-sections">
+    <title>Markierte Bereiche</title>
+
+    <para>SGML erlaubt es, dass bestimmte Dokumentabschnitte
+      wä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Ü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ÜSSELWORT</replaceable> legt fest, wie der
+      <quote>markierte Inhalt</quote> durch einen SGML-Prozessor
+      wä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ß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üsselworte für markierte Bereiche</title>
+
+      <sect3>
+        <title><literal>CDATA</literal> und <literal>RCDATA</literal></title>
+
+        <para>Die Schlüsselworte <literal>CDATA</literal> und
+          <literal>RCDATA</literal> bestimmen das
+          <emphasis>Inhaltsmodell</emphasis> für markierte
+          Bereiche. Dadurch ist es möglich, vom Standardmodell
+          abzuweichen.</para>
+
+        <para>Ein SGML-Prozessor muss wä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ützlichsten Inhaltsmodelle. <!--? Die richtige
+          Uebersetzung ist Buchstabendaten. Oliver Fischer -->
+          <literal>CDATA</literal> steht fü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örigen Dokumentenbereich nur
+          <quote>gewö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ür
+          Entitätenreferenzen und Zeichendaten<footnote><para>auf
+              Englisch
+              <foreignphrase>Entity references and character
+                data</foreignphrase></para></footnote>. Für einen
+          Bereich mit diesem Inhaltsmodell, wird ein Parser davon
+          ausgehen, dass er sowohl Zeichen als auch
+          Enitätenreferenzen finden kann. <literal>&lt;</literal>
+          verliert hier zwar auch seine besondere Bedeutung, doch
+          <literal>&amp;</literal> wird weiterhin als Anfang einer
+          Entität interpretiert.</para>
+
+        <para>Nützlich ist das <literal>CDATA</literal>-Modell
+          vor allem dann, wenn es darum geht Texte eins-zu-eins zu
+          übernehmen, in denen <literal>&lt;</literal> und
+          <literal>&amp;</literal> gehäuft
+          auftreten. Zwar kann man solche Texte ü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ällen
+          einfacher sein, fü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ü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ültig ist,
+            muss auf andere Weise sichergestellt werden. Denkbar ist
+            beispielsweise, es in einem separaten Dokument zu
+            erstellen, dort zu prüfen und erst dann in das
+            eigentliche Dokument einzufügen.</para>
+        </note>
+          <!-- The nesting of CDATA within the next example is disgusting -->
+
+        <example>
+          <title>CDATA als Inhaltsmodell für markierte Bereiche</title>
+
+          <programlisting>&lt;para&gt;Das ist ein Beispiel, wie man einen Text,
+  der viele <literal>&amp;lt;</literal>- und <literal>&amp;amp;</literal>-
+  Entitäten enthält, in ein Dokument einbinden kann.
+  Das Beispiel selbst, das sich innerhalb des markierten Bereiches befindet,
+  ist ein HTML-Fragment. Der diesen Text umschließende Tag, beginnend mit
+  mit <tag>para</tag> und endend mit <tag>/para</tag>, stammt aus der DocBook DTD.&lt;/para&gt;
+
+&lt;programlisting&gt;
+  &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ä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&gt;</programlisting>
+
+          <para>Liest  man die Quellen dieser Fibel, wird man
+            feststellen, dass diese Technik durchgängig
+            angewandt wurde.</para>
+
+        </example>
+      </sect3>
+
+      <sect3>
+	<title><literal>INCLUDE</literal> und
+	  <literal>IGNORE</literal></title>
+
+        <para>Das Schlüsselwort <literal>INCLUDE</literal> legt
+          fest, dass der Inhalt des betreffenden Abschnittes
+          mitverarbeitet wird. Demgegenüber bestimmt
+          <literal>IGNORE</literal>, dass er ignoriert wird,
+          dass heißt, dass er bei der Verarbeitung
+          ü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ür sich alleine ist <literal>IGNORE</literal> als
+          Anweisung nicht besonders nü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="xml-primer-parameter-entities">Parameterentitäten</link>,
+          steht so ein  Weg zur Verfügung, um dessen Anwendung
+          besser  steuern zu können. Zwar können
+          Parameterentitäten nur in einem SGML-Kontext einsetzt
+          werden, da aber markierte Bereiche ebenfalls SGML-Konstrukte
+          sind, ist diese Einschrä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ätzliche Informationen enthalten, kann dies mit
+          einem Trick erreicht werden.</para>
+
+        <para>Man definiert eine Parameterentitä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üsselwort die zuvor definierte
+          Parameterentität ein.</para>
+
+        <para>Soll anstelle der digitalen die gedruckte Variante
+          produziert werden, muss lediglich der Entität
+          <literal>IGNORE</literal> als Wert zugewiesen und das
+          Ursprungsdokument erneut durch den SGML-Prozessor geschickt
+          werden.</para>
+
+        <example>
+          <title>Kontrolle von markierten Bereichen über
+            Parameterentitäten</title>
+
+	  <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
+&lt;!ENTITY % digitale.kopie "INCLUDE"&gt;
+]]&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ät geändert werden.</para>
+
+	  <programlisting>&lt;!ENTITY % digitale.kopie "IGNORE"&gt;</programlisting>
+
+          <para>Bei der Verarbeitung wird als Schlüsselwort in
+            beiden Fällen der von
+            <literal>%digitale.kopie</literal> repräsentierte
+            Wert verwendet. Im ersten Fall wird der Inhalt des
+            markierten Bereichs mitverarbeitet, im zweiten Fall
+            nicht.</para>
+
+	</example>
+      </sect3>
+    </sect2>
+
+    <sect2>
+      <title>Fingerübung&hellip;</title>
+
+      <procedure>
+	<step>
+          <para>Legen Sie eine neue Datei
+            <filename>abschnitt.xml</filename> an, die folgenden
+            Inhalt hat:</para>
+
+	  <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
+&lt;!ENTITY % text.ausgabe "INCLUDE"&gt;
+]&gt;
+
+&lt;html&gt;
+  &lt;head&gt;
+    &lt;title&gt;Ein Beispiel mit markierten Abschnitten&lt;/title&gt;
+  &lt;/head&gt;
+
+  &lt;body&gt;
+    &lt;p&gt;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&gt;
+
+    &lt;![ IGNORE [
+    &lt;p&gt;Dieser Absatz wird NICHT in der Ausgabe enthalten sein.&lt;/p&gt;
+    ]]&gt;
+
+    &lt;![ <![CDATA[%text.ausgabe]]> [
+     &lt;p&gt;Dieser Absatz wird in Abhängigkeit von <literal>%text.ausgabe</literal>
+       mitausgegeben.&lt;/p&gt;
+    ]]&gt;
+  &lt;/body&gt;
+&lt;/html&gt;</programlisting>
+        </step>
+
+        <step>
+          <para>Normalisieren Sie den Inhalt dieser Datei mit Hilfe
+            von <command>osgmlnorm</command> und sehen Sie sich das
+            Ergebnis an.  Achten Sie dabei darauf, welche Absätze
+            enthalten beziehungsweise nicht enthalten sind und was aus
+            den <literal>CDATA</literal>-Bereichen geworden ist.</para>
+	</step>
+
+        <step>
+          <para>Ä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>osgmlnorm</command> und vergleichen die Ausgabe mit
+            der vom ersten <command>osgmlnorm</command> Lauf.</para>
+
+        </step>
+      </procedure>
+    </sect2>
+  </sect1>
+
+  <sect1 xml:id="xml-primer-conclusion">
+    <title>Schlussbemerkung</title>
+
+    <para>Aus Platzgründen, und um der Verständlichkeit
+      Willen, wurden viele Gesichtspunkte nicht in aller Tiefe
+      beziehungsweise gar nicht besprochen. Trotzdem sollte in den
+      bisherigen Kapiteln genügend Wissen über SGML
+      vermittelt worden sein, um den Aufbau der Dokumentation des FDPs
+      zu verstehen.</para>
+
+  </sect1>
+</chapter>

Property changes on: head/de_DE.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+FreeBSD=%H
\ No newline at end of property
Added: svn:mime-type
## -0,0 +1 ##
+text/sgml
\ No newline at end of property