Date: Sun, 7 Apr 2013 13:28:29 +0000 (UTC) From: Benedict Reuschling <bcr@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41390 - in head/de_DE.ISO8859-1/books/fdp-primer: . doc-build examples overview psgml-mode see-also sgml-markup sgml-primer structure stylesheets the-website tools translations writing... Message-ID: <201304071328.r37DSTqT058226@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: bcr Date: Sun Apr 7 13:28:28 2013 New Revision: 41390 URL: http://svnweb.freebsd.org/changeset/doc/41390 Log: Resync the FDP primer. Minor adjustments and typo fixes included. Patches submitted by: Bjoern Heidotting Obtained from: The FreeBSD German Documentation Project Modified: head/de_DE.ISO8859-1/books/fdp-primer/book.xml head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/examples/appendix.xml head/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/psgml-mode/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/see-also/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/sgml-markup/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/structure/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/translations/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/writing-style/chapter.xml Modified: head/de_DE.ISO8859-1/books/fdp-primer/book.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/book.xml Sun Apr 7 02:55:16 2013 (r41389) +++ head/de_DE.ISO8859-1/books/fdp-primer/book.xml Sun Apr 7 13:28:28 2013 (r41390) @@ -38,7 +38,7 @@ $FreeBSD$ $FreeBSDde: de-docproj/books/fdp-primer/book.xml,v 1.24 2012/03/25 14:39:26 bcr Exp $ - basiert auf: r38826 + basiert auf: r40986 --> <book lang="de"> @@ -142,7 +142,7 @@ <row> <entry>Datei- und Verzeichnisnamen</entry> - <entry>Bearbeiten Sie die Datei + <entry>Bearbeiten Sie <filename>.login</filename>.</entry> </row> @@ -196,7 +196,7 @@ </sect1> <sect1 id="preface-notes"> - <title>Anmerkungen, Tips, wichtige Hinweise, Warnungen und + <title>Anmerkungen, Tipps, wichtige Hinweise, Warnungen und Beispiel</title> <para>An einigen Stellen innerhalb dieses Buchs werden Modified: head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml Sun Apr 7 02:55:16 2013 (r41389) +++ head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml Sun Apr 7 13:28:28 2013 (r41390) @@ -30,7 +30,7 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r38845 + basiert auf: r39631 --> <chapter id="doc-build"> @@ -82,12 +82,12 @@ Werkzeuge</title> <para>Zusätzlich zu den im Kapitel <link - linkend="tools">SGML-Werkzeuge</link> beschriebenen + linkend="tools">XML-Werkzeuge</link> beschriebenen Werkzeugen benötigen Sie noch folgende Programme:</para> <itemizedlist> <listitem> - <para>Das wichtigste Werzeug zum Bau der Dokumentation ist + <para>Das wichtigste Werkzeug zum Bau der Dokumentation ist <application>make</application>, genauer <application>Berkeley Make</application>.</para> </listitem> @@ -179,7 +179,7 @@ DOC_PREFIX?= ${.CURDIR}/.. Variable <makevar>SUBDIR</makevar> den Wert <literal>articles books</literal>.</para> - <para>Die Anweisung <makevar>DOC_PREFIX</makevar> zweigt, wie + <para>Die Anweisung <makevar>DOC_PREFIX</makevar> zeigt, wie man einer Variable einen Wert zuweist (vorausgesetzt, die Variable ist nicht bereits definiert). Eine derartige Anweisung ist beispielsweise sinnvoll, wenn sich @@ -304,7 +304,7 @@ DOC_PREFIX?= ${.CURDIR}/../../.. <listitem> <para><filename>doc.docbook.mk</filename> wird verwendet, wenn die Variable <makevar>DOCFORMAT</makevar> den Wert - <literal>docbook</literal> hat und und die Variable + <literal>docbook</literal> hat und die Variable <makevar>DOC</makevar> gesetzt ist.</para> </listitem> </itemizedlist> @@ -502,7 +502,7 @@ PRI_LANG?= en_US.ISO8859-1 <itemizedlist> <listitem> <para><literal>exists</literal> gibt "wahr" zurück, wenn - wenn die angegebene Datei bereits existiert.</para> + die angegebene Datei bereits existiert.</para> </listitem> <listitem> Modified: head/de_DE.ISO8859-1/books/fdp-primer/examples/appendix.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/examples/appendix.xml Sun Apr 7 02:55:16 2013 (r41389) +++ head/de_DE.ISO8859-1/books/fdp-primer/examples/appendix.xml Sun Apr 7 13:28:28 2013 (r41390) @@ -30,13 +30,13 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r38847 + basiert auf: r39632 --> <appendix id="examples"> <title>Beispiele</title> - <para>In diesem Anhang sind SGML-Beispieldokumente und Befehle + <para>In diesem Anhang sind XML-Beispieldokumente und Befehle enthalten, die zeigen, wie man aus DocBook-Dokumenten verschiedene Ausgabeformate erzeugen kann. Sofern alle Werkzeuge für das Dokumentationsprojekt ordnungsgemäß installiert wurden, @@ -51,7 +51,7 @@ <application>svn</application> doc-Repository und online unter <ulink url="http://svnweb.FreeBSD.org/doc/"></ulink>; verfügbar.</para> - <para>Um Irritationen zu vermeiden, bauen die SGML-Beispiele auf der + <para>Um Irritationen zu vermeiden, bauen die XML-Beispiele auf der 4.1er Standard-DocBook DTD anstatt auf der erweiterten FreeBSD-Variante auf. Ebenso werden die Standardstylesheets von Norman Welsh, anstatt der angepassten Stylesheets des @@ -274,7 +274,7 @@ <title>Ein DocBook-Dokument nach Postscript umwandeln</title> <para>Um eine Postscript-Ausgabe zu erzeugen, muss zuerst - die SGML-Quelle in eine &tex;-Datei umgewandelt werden.</para> + die XML-Quelle in eine &tex;-Datei umgewandelt werden.</para> <screen>&prompt.user; <userinput>jade -V tex-backend \ <co id="examples-co-jade-3-tex-backend"/> -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-3-catalog"/> Modified: head/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.xml Sun Apr 7 02:55:16 2013 (r41389) +++ head/de_DE.ISO8859-1/books/fdp-primer/overview/chapter.xml Sun Apr 7 13:28:28 2013 (r41390) @@ -30,7 +30,7 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r38854 + basiert auf: r41125 --> @@ -55,7 +55,7 @@ <primary>Mitgliedschaft</primary> </indexterm> - <para>Wie jedes Opensourceprojekt, ist auch das FDP auf die Mithilfe + <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 @@ -88,7 +88,7 @@ <sect1 id="overview-doc"> <title>Die FreeBSD-Dokumentationsreihe</title> - <para>Das FDP umfaßt vier verschiedene Kategorien:</para> + <para>Das FDP umfasst vier verschiedene Kategorien:</para> <variablelist> <varlistentry> @@ -114,7 +114,7 @@ <listitem> <para>Das Ziel der FAQ ist es, Fragen, die auf den - verschiedenen Maillinglisten und in Newsgruppen + 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 @@ -148,12 +148,12 @@ <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 - <literal>svn://svn.FreeBSD.org/doc/</literal> erreichen + <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 - <literal>svn://svn.FreeBSD.org/base/</literal> erreichen + <literal>https://svn.FreeBSD.org/base/</literal>; erreichen können.</para> <para>Das bedeutet, dass alle Änderungen an den @@ -225,15 +225,26 @@ <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 svn://svn.FreeBSD.org/doc/head/share head/share</userinput> -&prompt.user; <userinput>svn checkout svn://svn.FreeBSD.org/doc/head/en_US.ISO8859-1/share head/en_US.ISO8859-1/share</userinput></screen> +&prompt.user; <userinput>svn checkout <replaceable>https://svn0.us- +east.FreeBSD.org</replaceable>/doc/head/share head/share</userinput> +&prompt.user; <userinput>svn checkout <replaceable>https://svn0.us- +east.FreeBSD.org</replaceable>/doc/head/en_US.ISO8859-1/share head/en_US.ISO8859-1/share</userinput></screen> <para>Für den Fall, dass ausreichend Platz auf der - Festplatte vorhanden ist, kann auch eine eine + Festplatte vorhanden ist, kann auch eine vollständige Arbeitskopie des gesamten Subversion-Baumes anlegt werden.</para> - <screen>&prompt.user; <userinput>svn checkout svn://svn.FreeBSD.org/doc/head head</userinput></screen> + <screen>&prompt.user; <userinput>svn checkout <replaceable>https://svn0.us- +east.FreeBSD.org</replaceable>/doc/head head</userinpunt></screen> + + <note> + <para><ulink url="https://svn0.us-east.FreeBSD.org/">svn0.us-east.FreeBSD.org</ulink>; + ist ein öffentlicher Server. Wählen Sie einen Mirror + in Ihrer Nähe und überprüfen Sie das Serverzertifikat + auf der Seite <ulink url="&url.books.handbook;/svn-mirrors.html">Subversion + mirror sites</ulink>.</para> + </note> </step> <step> @@ -255,7 +266,8 @@ <filename>articles</filename> aus dem FreeBSD-CVS-Archiv lokal angelegt:</para> - <screen>&prompt.user; <userinput>svn checkout svn://svn.FreeBSD.org/doc/head/en_US.ISO8859-1/articles</userinput></screen> + <screen>&prompt.user; <userinput>svn checkout <replaceable>https://svn0.us- +east.FreeBSD.org</replaceable>/doc/head/en_US.ISO8859-1/articles</userinput></screen> </step> <step> @@ -269,13 +281,14 @@ </step> </procedure> - <para>Bereits exisitierende Dokumente, die geändert + <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 svn://svn.FreeBSD.org/doc/head/en_US.ISO8859-1/books/faq</userinput></screen> + <screen>&prompt.user; <userinput>svn checkout <replaceable>https://svn0.us- +east.FreeBSD.org</replaceable>/doc/head/en_US.ISO8859-1/books/faq</userinput></screen> </step> <step> @@ -339,7 +352,7 @@ </step> <step> - <para>Zum Schluß müssen die Änderungen an das + <para>Zum Schluss müssen die Änderungen an das FDP mittels &man.send-pr.1; eingesandt werden.</para> </step> </procedure> Modified: head/de_DE.ISO8859-1/books/fdp-primer/psgml-mode/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/psgml-mode/chapter.xml Sun Apr 7 02:55:16 2013 (r41389) +++ head/de_DE.ISO8859-1/books/fdp-primer/psgml-mode/chapter.xml Sun Apr 7 13:28:28 2013 (r41390) @@ -30,7 +30,7 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r38826 + basiert auf: r39632 Anmerkungen: Dieser Text wurde nach dem Lesen von "Technisches Schreiben @@ -70,7 +70,7 @@ Funktion Start- und Endtag des neuen Elements ein. Sofern das eingefügte Element laut DTD andere Elemente enthalten muß, werden diese ebenfalls - miteingefügt.</para> + eingefügt.</para> <para>Falls Sie unsicher sind, wie der Name des gewünschten Elements lautet oder welche Elemente an der Modified: head/de_DE.ISO8859-1/books/fdp-primer/see-also/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/see-also/chapter.xml Sun Apr 7 02:55:16 2013 (r41389) +++ head/de_DE.ISO8859-1/books/fdp-primer/see-also/chapter.xml Sun Apr 7 13:28:28 2013 (r41390) @@ -30,14 +30,14 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r38826 + basiert auf: r39631 --> <chapter id="see-also"> <title>Weiterführende Quellen</title> <para>In dieser Fibel werden absichtlich nicht alle Aspekte von - SGML, der erwähnten DTDs und des + XML, der erwähnten DTDs und des FreeBSD-Dokumentationsprojekts behandelt. Interessierten werden daher die nachfolgenden Quellen empfohlen.</para> @@ -58,22 +58,15 @@ </itemizedlist> </sect1> - <sect1 id="see-also-sgml"> - <title>SGML</title> + <sect1 id="see-also-xml"> + <title>XML</title> <itemizedlist> <listitem> - <para><ulink url="http://www.oasis-open.org/cover/">Die - SGML/XML-Webseite</ulink>, eine umfangreiche Quelle zu - SGML.</para> + <para><ulink url="http://www.w3.org/XML/">W3C's + XML-Webseite</ulink>, eine umfangreiche Quelle zu + XML.</para> </listitem> - - <listitem> - <para><ulink - url="http://www-sul.stanford.edu/tools/tutorials/html2.0/gentle.html">Gentle - introduction to SGML</ulink></para> - </listitem> - </itemizedlist> </sect1> <sect1 id="see-also-html"> Modified: head/de_DE.ISO8859-1/books/fdp-primer/sgml-markup/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/sgml-markup/chapter.xml Sun Apr 7 02:55:16 2013 (r41389) +++ head/de_DE.ISO8859-1/books/fdp-primer/sgml-markup/chapter.xml Sun Apr 7 13:28:28 2013 (r41390) @@ -30,14 +30,14 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r38851 + basiert auf: r39632 --> -<chapter id="sgml-markup"> - <title>SGML-Dokumente erstellen</title> +<chapter id="xml-markup"> + <title>XML-Dokumente erstellen</title> - <para>In diesem Kapitel werden die beiden vom FDP eingesetzen - Auszeichnungssprachen HTML und DocBook behandelt. Hierbei + <para>In diesem Kapitel werden die beiden vom FDP eingesetzten + Auszeichnungssprachen XHTML und DocBook behandelt. Hierbei beschränkt sich dieses Kapitel auf die Elemente, die bei der täglichen Arbeit am ehesten zum Einsatz kommen werden.</para> @@ -62,7 +62,7 @@ Oliver Fischer --> - <para>Wenn im folgenden von + <para>Wenn im Folgenden von <emphasis>Flußelementen</emphasis> die Rede ist, sind damit Elemente gemeint, die in einem Blockelement auftreten können und keinen Zeilenumbruch hervorrufen. @@ -74,64 +74,64 @@ übersetzt.</para></footnote>.</para> </note> - <sect1 id="sgml-markup-html"> - <title>HTML</title> + <sect1 id="xml-markup-xhtml"> + <title>XHTML</title> - <para>HTML, die <foreignphrase>HyperText Markup - Language</foreignphrase>, ist die Auszeichnungssprache des - Internets. Weitere Informationen zu HTML finden sich unter + <para>XHTML ist die XML Version der HyperText Markup Language, + der Auszeichnungssprache der Wahl im World Wide Web. + Weitere Informationen zu XHTML finden sich unter <ulink url="http://www.w3.org/"></ulink>.</para>; - <para>Sie kommt bei der Erstellung der Webseiten des + <para>XHTML kommt bei der Erstellung der Webseiten des FreeBSD-Projektes zum Einsatz. Für technische Dokumentationen - sollte HTML jedoch nicht eingesetzt werden, da DocBook eine + sollte XHTML jedoch nicht eingesetzt werden, da DocBook eine größere und bessere Auswahl an Elementen bietet. Folglich - sollte HTML nur für die FreeBSD-Webseiten verwendet werden.</para> + sollte XHTML nur für die FreeBSD-Webseiten verwendet werden.</para> <para>Die HTML-Spezifikation liegt bis jetzt in mehreren Versionen - vor: 1, 2, 3.0, 3.2 und (die aktuelle) 4.0. Von letzterer - existieren zwei Varianten: <quote>streng</quote> (HTML 4.0 - Strict) und <quote>locker</quote> (HTML 4.0 - Transitional).</para> + vor: 1, 2, 3.0, 3.2, 4.0 sowie eine XML konforme Version namens + XHTML in seiner neuesten Version XHTML 1.0 (verfügbar als + <emphasis>strict</emphasis> und <emphasis>transitional</emphasis> + Variante.</para> - <para>Die HTML-DTDs sind über den Port <filename - role="package">textproc/html</filename> verfügbar und werden + <para>Die XHTML-DTDs sind über den Port <filename + role="package">textproc/xhtml</filename> verfügbar und werden automatisch als Teil des Metaports <filename role="package">textproc/docproj</filename> - mitinstalliert.</para> + installiert.</para> <sect2> <title>Formale Öffentliche Bezeichner</title> <!--@todo Optimierungskandidat. Oliver Fischer --> - <para>Da es mehrere Version von HTML gibt, existieren auch - mehrere FÖPs, zu denen ein HTML-Dokument konform + <para>Da es mehrere Version von XHTML gibt, existieren auch + mehrere FÖPs, zu denen ein XHTML-Dokument konform erklärt werden kann. Die Mehrzahl der sich auf der - FreeBSD-Webseite befindenen HTML-Seiten sind zu der lockeren - Version von HTML 4.0 konform.</para> + FreeBSD-Webseite befindenden XHTML-Seiten sind zu der lockeren + Version von XHTML 1.0 konform.</para> - <programlisting>PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"</programlisting> + <programlisting>PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"</programlisting> </sect2> <sect2> <title>Die Elemente <sgmltag>head</sgmltag> und <sgmltag>body</sgmltag></title> - <para>Ein HTML-Dokument unterteilt sich normalerweise in zwei + <para>Ein XHTML-Dokument unterteilt sich normalerweise in zwei Bereiche: <quote>head</quote> und <quote>body</quote>. Der Kopf (<foreignphrase>head</foreignphrase>) enthält Metadaten wie den Dokumententitel und Angaben zum Autor. Der Rumpf - (<foreignphrase>body</foreignphrase>) umfaßt den eigentlichen + (<foreignphrase>body</foreignphrase>) umfasst den eigentlichen Dokumenteninhalt, der für den Leser bestimmt ist. In einem - HTML-Dokument werden diese Bereiche über die Elemente + XHTML-Dokument werden diese Bereiche über die Elemente <sgmltag>head</sgmltag> und <sgmltag>body</sgmltag> voneinander abgegrenzt. Beide sind Kinder des Wurzelelementes <sgmltag>html</sgmltag>.</para> <example> - <title>Die Struktur eines HTML-Dokumentes</title> + <title>Die Struktur eines XHTML-Dokumentes</title> - <programlisting><html> + <programlisting><html xmlns="http://www.w3.org/1999/xhtml">; <head> <title><replaceable>Der Dokumententitel</replaceable></title> </head> @@ -151,7 +151,7 @@ <sect3> <title>Überschriften</title> - <para>HTML kennt sechs verschiedene Elemente, mit denen + <para>XHTML kennt sechs verschiedene Elemente, mit denen Überschriften ausgezeichnet werden können. Das bekannteste Element ist <sgmltag>h1</sgmltag>, das sich am Anfang der Überschriftenhierarchie befindet. <sgmltag>h1</sgmltag> @@ -182,7 +182,7 @@ <!-- Hier steht der Inhalt des zweiten Kapitels -->]]></programlisting> </example> - <para>Eine HTML-Seite sollte immer nur eine Überschrift + <para>Eine XHTML-Seite sollte immer nur eine Überschrift <sgmltag>h1</sgmltag> haben. Dieser Überschrift können beliebig viele Kapitel mit einer Überschrift <sgmltag>h2</sgmltag> folgen, die selbst wiederum eine @@ -211,7 +211,7 @@ <sect3> <title>Absätze</title> - <para>Absätze können in HTML mit Hilfe des Elementes + <para>Absätze können in XHTML mit Hilfe des Elementes <sgmltag>p</sgmltag> ausgezeichnet werden.</para> <example> @@ -220,7 +220,7 @@ <para>Fügen Sie in eine der existierenden Übungsdateien folgendes ein:</para> <programlisting><![CDATA[<p>Das hier, das ist ein Absatz. Absätze können - andere Elemente enhalten.</p>]]></programlisting> + andere Elemente enthalten.</p>]]></programlisting> </example> </sect3> @@ -266,7 +266,7 @@ <sect3> <title>Listen</title> - <para>HTML kennt drei Arten von Listen: sortierte, unsortierte + <para>XHTML kennt drei Arten von Listen: sortierte, unsortierte und Definitionslisten. Ein Eintrag in einer sortierten Liste wird üblicherweise mit einer Nummer versehen, Einträge in unsortierten Listen hingegen mit einem Aufzählungspunkt. @@ -361,10 +361,10 @@ <para>In einigen Fällen ist es gewollt, dass die Formatierung eines Textes im Quelldokument erhalten bleibt, damit der Leser diesen genau so sieht, wie ihn der Autor erstellt hat. - In der HTML-Spezifikation ist dafür das Element + In der XHTML-Spezifikation ist dafür das Element <sgmltag>pre</sgmltag> vorgesehen, welches dafür sorgt, dass Zeilenumbrüche erhalten bleiben und Leerzeichen nicht - zusammengefaßt werden. Browser verwenden für den + zusammengefasst werden. Browser verwenden für den Inhalt des Elementes <sgmltag>pre</sgmltag> üblicherweise eine Fixschrift.</para> @@ -414,7 +414,7 @@ eine angemessene Darstellung sicherzustellen.</para> </note> - <para>Tabellen lassen sich in HTML mit Hilfe des Elements + <para>Tabellen lassen sich in XHTML mit Hilfe des Elements <sgmltag>table</sgmltag> auszeichnen. Eine Tabelle setzt sich aus einer oder mehreren Zeilen (<sgmltag>tr</sgmltag>) zusammen, von denen jede mindestens eine Zelle @@ -446,10 +446,10 @@ </tr> </table>]]></programlisting></example> - <para>HTML kennt die Möglichkeit, dass sich eine + <para>XHTML kennt die Möglichkeit, dass sich eine Zelle mehrere Zeilen und/oder Spalten erstrecken kann. Sollen beispielsweise mehrere Spalten zusammenfassen werden, - kann dies mit mit Hilfe des Attributes + kann dies mit Hilfe des Attributes <literal>colspan</literal> erreicht werden, indem man ihm die Anzahl der zusammenzufassenden Spalten zuweist. Ähnliches gilt für die Zusammenfassung von Zeilen: @@ -497,7 +497,7 @@ <title>Gemeinsame Anwendung der Attrbute <literal>rowspan</literal> und <literal>colspan</literal></title> - <programlisting><![CDATA[<p>Eine Tablle mit 3-mal-3 Zellen. Oben links + <programlisting><![CDATA[<p>Eine Tabelle mit 3-mal-3 Zellen. Oben links werden 2 mal 2 Zelle zusammengezogen.</p> <table> @@ -508,7 +508,7 @@ </tr> <tr> - <!-- Da sich die zusammengefaßte Zelle über zwei Zeilen + <!-- Da sich die zusammengefasste Zelle über zwei Zeilen erstreckt, befindet sich das die durch dieses <td> definierte Zelle ganz rechts. --> @@ -541,8 +541,13 @@ wobei mit <sgmltag>strong</sgmltag> ausgezeichnete Elemente fett und mit <sgmltag>em</sgmltag> ausgezeichnete Elemente kursiv dargestellt werden. Allerdings ist diese Aussage - nicht verläßlich, da die Darstellung vom Browser - abhängig ist.</para> + nicht verlässlich, da die Darstellung vom Browser + abhängig ist. In der Praxis ist es so, dass Webseiten + nur strukturelle und semantische Informationen enthalten + und Stylesheets später auf diese Informationen + angewendet werden. Beachten Sie also die Semantik und + nicht die Formatierung wenn Sie mit diesen + Tags arbeiten.</para> <example> <title>Text mit <sgmltag>em</sgmltag> und <sgmltag>strong</sgmltag> @@ -554,28 +559,6 @@ </sect3> <sect3> - <!--? Was ist typografisch richtig: schräg oder kursiv? - Oliver Fischer --> - <title>Fett- und Schrägschrift</title> - - <para>Da mittels HTML auch Festlegungen über die - Darstellung getroffen werden können, gibt es die - Möglichkeit direkt zu bestimmen, dass bestimmte - Inhalte fett oder kursiv dargestellt werden sollen. Mit - <sgmltag>b</sgmltag> eingefaßte Inhalte werden fett - und mit <sgmltag>i</sgmltag> eingefaßte kursiv - dargestellt.</para> - - <example> - <title>Text mit <sgmltag>b</sgmltag> und <sgmltag>i</sgmltag> - formatieren</title> - - <programlisting><![CDATA[<p><b>Dieses</b> Wort wird fett dargestellt, -während <i>dieses</i> kursiv dargestellt wird.</p>]]></programlisting> - </example> - </sect3> - - <sect3> <title>Nicht-proportionale Schrift für Texte</title> <para>Der Tag <sgmltag>tt</sgmltag> erlaubt es, @@ -592,68 +575,6 @@ während <i>dieses</i> kursiv dargestellt </example> </sect3> - - <sect3> - <title>Änderung der Schriftgröße</title> - - <para>HTML bietet auch Möglichkeiten, um Einfluß - auf die Schriftgröße zu nehmen, das heißt, - zu bestimmen, ob die Schrift größer oder kleiner - als die Standardschrift dargestellt werden soll. Es gibt - drei verschiedene Wege, dies zu erreichen:</para> - - <orderedlist> - <listitem> - <para>Mittels der Tags <sgmltag>big</sgmltag> und - <sgmltag>small</sgmltag> kann die - Darstellungsgröße des eingeschlossenen Textes - vergrößert respektive verkleinert werden. - HTML erlaubt es zudem, diese Tags zu verschachteln, so - dass auch <literal><big><big>Das ist - wesentlich - größer.</big></big></literal> - geschrieben werden kann.</para> - </listitem> - - <listitem> - <para>Das gleiche Ergebnis kann über die Zuweisung der - Werte <literal>1</literal> und <literal>-1</literal> an - das Attribut <sgmltag role="attribute">size</sgmltag> - des Tags <sgmltag>font</sgmltag> erreicht werden. Diese - Vorgehensweise sollte allerdings als veraltet betrachtet - werden, da der Einsatz eines CSS hierfür die bessere - Lösung darstellt.</para> - </listitem> - - <listitem> - <para>Über die Zuweisung von absoluten Werten im Bereich - von <literal>1</literal> bis <literal>7</literal> an das - Attribut <literal>size</literal> des Tags - <sgmltag>font</sgmltag> <footnote> - <para>Der Standardwert für <literal>size</literal> ist - <literal>3</literal>.</para></footnote>. Diese - Herangehensweise ist ebenfalls veraltet und sollte nicht - mehr angewandt werden.</para> - </listitem> - </orderedlist> - - <example> - <title>Schriftgröße ändern mit - <sgmltag>big</sgmltag>, <sgmltag>small</sgmltag> und - <sgmltag>font</sgmltag></title> - - <para>Die folgenden HTML-Schnipsel bewirken alle das gleiche:</para> - - <programlisting><![CDATA[<p>Dieser Text ist <small>etwas kleiner</small>. Dieser - jedoch <big>ein wenig größer</big>.</p> - -<p>Dieser Text ist <font size="-1">etwas kleiner</font>. Dieser - jedoch <font size="+1">ein wenig größer</font>.</p> - -<p>Dieser Text ist <font size="2">etwas kleiner</font>. Dieser - jedoch <font size="4">ein wenig größer</font>.</p>]]></programlisting> - </example> - </sect3> </sect2> <sect2 id="links"> @@ -692,18 +613,18 @@ während <i>dieses</i> kursiv dargestellt <sect3> <title>Auf bestimmte Dokumentenabschnitte verweisen</title> - <para>HTML unterstützt neben einfachen Links auch solche, die + <para>XHTML unterstützt neben einfachen Links auch solche, die auf einen bestimmten Abschnitt innerhalb eines Dokumentes verweisen. Dazu müssen die Abschnitte, auf die verwiesen werden soll, mit Hilfe von sogenannten <quote>Ankern</quote> markiert werden. Diese Anker können ebenfalls mit Hilfe des Tags <sgmltag>a</sgmltag> gesetzt werden, nur das anstelle - von <sgmltag role="attribute">href</sgmltag> das Attribut - <sgmltag role="attribute">name</sgmltag> gesetzt werden + von <literal>href</literal> das Attribut + <literal>name</literal> gesetzt werden muss.</para> <example> - <title>Anwendung von <literal><a name="..."></literal></title> + <title>Anwendung von <literal><a id="..."></literal></title> <programlisting><![CDATA[<p><a name="absatz1">Auf</a> diesen Absatz kann mit Hilfe seines Namens (<tt>absatz1</tt>) verwiesen werden.</p>]]></programlisting> @@ -720,7 +641,7 @@ während <i>dieses</i> kursiv dargestellt <para>Für dieses Beispiel wird davon ausgegangen, dass der mit <literal>absatz1</literal> gekennzeichnete Absatz sich in - der HTML-Datei <filename>foo.html</filename> + der XHTML-Datei <filename>foo.html</filename> befindet.</para> <programlisting><![CDATA[<p>Weitere Informationen können im @@ -732,10 +653,10 @@ während <i>dieses</i> kursiv dargestellt </sect2> </sect1> - <sect1 id="sgml-markup-docbook"> + <sect1 id="xml-markup-docbook"> <title>Die DocBook DTD</title> - <para>DocBook wurde ursprüglich von HaL Computer Systems and + <para>DocBook wurde ursprünglich von HaL Computer Systems und O'Reilly & Associates als DTD für das Erstellen von technischen Dokumenten entwickelt @@ -749,7 +670,7 @@ während <i>dieses</i> kursiv dargestellt DocBook Technical Committee</ulink> gewartet. DocBook ist sehr stark auf die Beschreibung von Inhalten, und nicht auf die Darstellung des Inhalts ausgerichtet. Damit steht es im Gegensatz - zu LinuxDoc und HTML.</para> + zu LinuxDoc und XHTML.</para> <note> <title>Formelle und informelle Elemente</title> @@ -758,7 +679,7 @@ während <i>dieses</i> kursiv dargestellt vorhanden: <emphasis>formell</emphasis> und <emphasis>informell</emphasis>. Üblicherweise besitzt die formelle Variante einen Titel, dem der eigentliche - Elementeninhalt folgt. Die informelle Variante hingegen hat + Elementinhalt folgt. Die informelle Variante hingegen hat keinen Titel.</para> </note> @@ -766,7 +687,7 @@ während <i>dieses</i> kursiv dargestellt role="package">textproc/docbook</filename> enthalten und wird bei der Installation des Metaports <filename role="package">textproc/docproj</filename> automatisch - mitinstalliert.</para> + installiert.</para> <sect2> <title>Die FreeBSD-Erweiterungen</title> @@ -807,7 +728,7 @@ während <i>dieses</i> kursiv dargestellt Erstellung von Bezeichnern für DocBook-Erweiterungen lautet der Bezeichner der erweiterten FreeBSD-Variante:</para> - <programlisting>PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN"</programlisting> + <programlisting>PUBLIC "-//FreeBSD//DTD DocBook V4.2-Based Extension//EN"</programlisting> </sect2> <sect2 id="docbookstructure"> @@ -835,7 +756,7 @@ während <i>dieses</i> kursiv dargestellt dem Artikel oder Buch geht, wird unterhalb der hier genannten Elemente eingefügt.</para> - <para>Vom Aufbau her ist ein Artikel ist einfacher strukturiert + <para>Vom Aufbau her ist ein Artikel einfacher strukturiert als ein Buch. So kann ein Artikel beispielsweise keine Kapitel (<sgmltag>chapter</sgmltag>) enthalten. Stattdessen kann der Inhalt eines Artikels nur durch die schon bekannten @@ -854,11 +775,11 @@ während <i>dieses</i> kursiv dargestellt enthalten können.</para> <para>Alle <ulink url="&url.base;/de/docs.html">Tutorien von - FreeBSD</ulink> sind als Artikel verfaßt, während + FreeBSD</ulink> sind als Artikel verfasst, während hingegen die <ulink url="&url.books.faq;/index.html">FreeBSD-FAQ</ulink> und das <ulink url="&url.books.handbook;/index.html">FreeBSD-Handbuch</ulink> als - Bücher verfaßt wurden.</para> + Bücher verfasst wurden.</para> <sect3> <title>Bücher schreiben</title> @@ -975,7 +896,7 @@ während <i>dieses</i> kursiv dargestellt </chapter>]]></programlisting> </example> - <para>Kapitel können nicht leer sein. Nebem einem + <para>Kapitel können nicht leer sein. Neben einem <sgmltag>title</sgmltag>-Element müssen sie weiteren Inhalt beinhalten. Falls ein leeres Kapitel benötig wird, kann dies durch das Einfügen eines leeren Absatzes @@ -1068,7 +989,7 @@ während <i>dieses</i> kursiv dargestellt <title>Bücher mittels <sgmltag>part</sgmltag> unterteilen</title> - <para>In den Fällen, in denen die Unteilung eines Buches in + <para>In den Fällen, in denen die Unterteilung eines Buches in Kapitel nicht ausreichend ist, können mehrere Kapitel mit dem Element <sgmltag>part</sgmltag> zu einem Teil zusammengefasst werden.</para> @@ -1212,7 +1133,7 @@ während <i>dieses</i> kursiv dargestellt Warnungen), <sgmltag>caution</sgmltag> (für besonders ernstzunehmende Warnungen) und <sgmltag>important</sgmltag> (für wichtige Anmerkungen) ausgezeichnet werden. Trifft - keines dieser Element für die auszuzeichnende Stelle + keines dieser Elemente für die auszuzeichnende Stelle zu, sollte diese mit dem Element <sgmltag>sidebar</sgmltag> ausgezeichnet werden.</para> @@ -1400,12 +1321,12 @@ während <i>dieses</i> kursiv dargestellt <programlisting><![CDATA[<para>Am Ende sollte Ihr Programm wie folgt aussehen:</para> -<programlisting>#include &lt;stdio.h&gt; +<programlisting>#include &lt;stdio.h&gt; <co id="co-ex-include"/> -int +int <co id="co-ex-return"/> main(void) { - printf("Hallo Welt!\n"); + printf("Hallo Welt!\n"); <co id="co-ex-printf"/> }</programlisting>]]></programlisting> <para>Die spitzen Klammern der @@ -1417,12 +1338,12 @@ main(void) <para>Am Ende sollte Ihr Programm wie folgt aussehen:</para> - <programlisting>#include <stdio.h> + <programlisting>#include <stdio.h> <co id="co-ex-include"/> -int +int <co id="co-ex-return"/> main(void) { - printf("Hallo Welt!\n"); + printf("Hallo Welt!\n"); <co id="co-ex-printf"/> }</programlisting> </example> </sect3> @@ -1659,7 +1580,7 @@ main(void) <listitem> <para>Eingabeaufforderungen des Rechners - (Betriebssysten, Shell oder Anwendung) sind ein häufig + (Betriebssystem, Shell oder Anwendung) sind ein häufig auftretender Teil dessen, was der Benutzer auf dem Bildschirm zu sehen bekommt. Sie sollten mit <sgmltag>prompt</sgmltag> ausgezeichnet werden.</para> @@ -1667,7 +1588,7 @@ main(void) <para>Ein Spezialfall sind die beiden Eingabeaufforderungen der Shell für normale Benutzer und den Superuser <username>root</username>. - Jedesmal wenn auf eine von diesen beiden Nutzerrollen + Jedes mal wenn auf eine von diesen beiden Nutzerrollen hingewiesen werden soll, sollte entweder <literal>&prompt.root;</literal> oder <literal>&prompt.user;</literal> eingesetzt @@ -1767,7 +1688,7 @@ This is the file called 'foo2'</screen> <title>Das Element <sgmltag>emphasis</sgmltag></title> <programlisting><![CDATA[<para>FreeBSD ist zweifelslos <emphasis>das</emphasis> führende - Unix-artige Bestriebssystem für die Intel-Plattform.</para>]]></programlisting> + Unix-artige Betriebssystem für die Intel-Plattform.</para>]]></programlisting> <para>Darstellung:</para> @@ -1887,7 +1808,7 @@ This is the file called 'foo2'</screen> von einem Programm (in einem bestimmten Fall) akzeptierten Optionen genannt werden müssen.</para> - <para>Schlußendlich ist es oft gewünscht, zu einem + <para>Schlussendlich ist es oft gewünscht, zu einem Befehl dessen Abschnitt der Manualseiten im Unix-üblichen Stil <quote>Befehl(Zahl)</quote> anzugeben.</para> @@ -1905,7 +1826,7 @@ This is the file called 'foo2'</screen> <para>Diese Art auf Befehle zu verweisen kann sehr ermüdent sein. Daher gibt es einen Satz von - <link linkend="sgml-primer-general-entities">Allgemeinen + <link linkend="xml-primer-general-entities">Allgemeinen Entitäten</link>, der diese Arbeit erleichtert. Er ist in der Datei <filename>doc/share/xml/man-refs.ent</filename> enhalten @@ -1924,7 +1845,7 @@ This is the file called 'foo2'</screen> <!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"> %man; … ]></programlisting> - <para>Um Befehle innerhalb des Fließtextes auszuzeichen, + <para>Um Befehle innerhalb des Fließtextes auszuzeichnen, kann das Element <sgmltag>command</sgmltag> genutzt werden. Die Optionen eines Befehles können mit Hilfe von <sgmltag>option</sgmltag> ausgezeichnet werden.</para> @@ -1946,7 +1867,7 @@ This is the file called 'foo2'</screen> <example> <title>Anwendungen, Befehle und Optionen</title> - <programlisting><![CDATA[<para><application>Sendmail</application> ist der verbreitetste + <programlisting><![CDATA[<para><application>Sendmail</application> ist der verbreiteteste UNIX-Mailserver.</para> <para><application>Sendmail</application> besteht aus den Programmen @@ -2092,7 +2013,7 @@ This is the file called 'foo2'</screen> <para>Allerdings besteht nicht immer diese Wahlmöglichkeit. Einige Geräte, wie zum Beispiel - Netzwerkkartenm haben keinen Eintrag unter + Netzwerkkarten haben keinen Eintrag unter <filename>/dev</filename> oder werden anders dargestellt.</para> @@ -2103,7 +2024,7 @@ This is the file called 'foo2'</screen> <programlisting><![CDATA[<para>Unter FreeBSD wird die serielle Datenübertragung über <devicename>sio</devicename> abgewickelt, das unterhalb von <filename>/dev</filename> eine Reihe von Einträgen anlegt. - Zu diesen Einträgen behören beispielsweise + Zu diesen Einträgen gehören beispielsweise <filename>/dev/ttyd0</filename> und <filename>/dev/cuaa0</filename>.</para> @@ -2111,7 +2032,7 @@ This is the file called 'foo2'</screen> <devicename>ed0</devicename> nicht unterhalb von <filename>/dev</filename>.</para> - <para>Unter MS-DOS wird das erste Diskettelaufwerk als + <para>Unter MS-DOS wird das erste Diskettenlaufwerk als <devicename>a:</devicename> bezeichnet. FreeBSD bezeichnet es als <filename>/dev/fd0</filename>.</para>]]></programlisting> @@ -2162,7 +2083,7 @@ This is the file called 'foo2'</screen> <listitem> <para>Ohne Rollenattribut stellt der umschlossene Text - einen normlen Rechnernamen wie + einen normalen Rechnernamen wie <literal>freefall</literal> oder <literal>wcarchive</literal> dar. Wenn es gewünscht ist, kann mittels @@ -2347,13 +2268,13 @@ This is the file called 'foo2'</screen> <para>Üblicherweise wird, wenn das Ziel <maketarget>all</maketarget> aufgerufen wird, die gesamte Anwendung neu erstellt. Der Aufruf - des Zieles <maketarget>clean</maketarget> veranlaßt das + des Zieles <maketarget>clean</maketarget> veranlasst das Löschen aller temporären Dateien (zum Beispiel <filename>.o</filename>), die während der Übersetzung erzeugt wurden.</para> <para>Das genaue Verhalten von <maketarget>clean</maketarget> - kann von einer Reihe von Variablen beeinflußt werden. + kann von einer Reihe von Variablen beeinflusst werden. Stellvertretend seien hier <makevar>CLOBBER</makevar> und <makevar>RECURSE</makevar> genannt.</para>]]></programlisting> @@ -2374,7 +2295,7 @@ This is the file called 'foo2'</screen> <para>Das genaue Verhalten von <maketarget>clean</maketarget> kann von einer Reihe von - Variablen beeinflußt werden. Stellvertretend seien + Variablen beeinflusst werden. Stellvertretend seien hier <makevar>CLOBBER</makevar> und <makevar>RECURSE</makevar> genannt.</para> </example> @@ -2403,7 +2324,7 @@ This is the file called 'foo2'</screen> <programlisting><![CDATA[<para>Die Zeile <literal>maxusers 10</literal> in der Kernelkonfigurationsdatei beeinflußt die Größe vieler Systemtabellen und kann als ungefähr als Richtwert dafür - gelten, wie viele paralle Anmeldungen das System handhaben + gelten, wie viele parallele Anmeldungen das System handhaben kann.</para>]]></programlisting> <para>Darstellung:</para> @@ -2609,7 +2530,7 @@ This is the file called 'foo2'</screen> </itemizedlist> <para>Das folgende Beispiel soll das bisher geschriebene - illustrieren. Angenommen es liegt eine einzubindene Grafik + illustrieren. Angenommen es liegt eine einzubindende Grafik in der Datei <filename>bild1</filename> vor, die die Darstellung eines As in einem Rechteck enthält. Die ASCII-Alternative könnte so ausgezeichnet werden:</para> @@ -2651,7 +2572,7 @@ This is the file called 'foo2'</screen> stellen.</para> <para>Wichtig ist, dass die erste und die letzte - Zeile sich gleichauf mit dem öffenden und dem + Zeile sich gleichauf mit dem öffnenden und dem schließenden Tag befindet. Dadurch wird sichergestellt, dass keine unnötigen Leerzeichen in die Ausgabe aufgenommen werden.</para> @@ -2708,7 +2629,7 @@ IMAGES+= bild3.png <para>Wenn Sie Ihre Dokumentation in mehrere kleine Dateien aufspalten (siehe - <xref linkend="sgml-primer-include-using-gen-entities"/>), + <xref linkend="xml-primer-include-using-gen-entities"/>), müssen Sie sorgfältig vorgehen.</para> <para>Angenommen es handelt sich um ein Buch, dessen drei @@ -2721,7 +2642,7 @@ IMAGES+= bild3.png Falle gilt es jedoch zu beachten, dass die Pfade der Grafikdateien in der Variable <makevar>IMAGES</makevar> und in den <sgmltag>imagedata</sgmltag>-Elementen immer auch den - Verzeichnisnamen mitenthalten.</para> + Verzeichnisnamen enthalten.</para> <para>Soll beispielsweise die Datei <filename>kapitel1/bild1.png</filename> in das in Modified: head/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml Sun Apr 7 02:55:16 2013 (r41389) +++ head/de_DE.ISO8859-1/books/fdp-primer/sgml-primer/chapter.xml Sun Apr 7 13:28:28 2013 (r41390) @@ -40,12 +40,12 @@ Oliver Fischer --> -<chapter id="sgml-primer"> - <title>Die SGML-Fibel</title> +<chapter id="xml-primer"> + <title>Die XML-Fibel</title> - <para>Die Mehrzahl der Dokumente des FDPs sind in SGML geschrieben. + <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 SGML-Quellen liest und versteht. + 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> @@ -53,7 +53,7 @@ Oliver Fischer url="http://www.galassi.org/mark/mydocs/docbook-intro/docbook-intro.html">Get Going With DocBook</ulink></quote>.</para> - <sect1 id="sgml-primer-overview"> + <sect1 id="xml-primer-overview"> <title>Überblick</title> <para>In den guten alten Zeiten war der Umgang mit @@ -64,7 +64,7 @@ Oliver Fischer Schnickschnack.</para> *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201304071328.r37DSTqT058226>