MFde: Update the German FDP primer.

doc/de_DE.ISO8859-1/books/fdp-primer/book.sgml                  fixes only
doc/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml   1.23 -> 1.26

Obtained from:  The FreeBSD German Documentation Project
This commit is contained in:
Johann Kois 2008-08-23 17:04:11 +00:00
parent c88ad75208
commit b93b8c2b66
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=32728
2 changed files with 283 additions and 65 deletions

View file

@ -28,7 +28,7 @@
POSSIBILITY OF SUCH DAMAGE.
$FreeBSD$
$FreeBSDde: de-docproj/books/fdp-primer/book.sgml,v 1.18 2007/03/18 17:14:15 jkois Exp $
$FreeBSDde: de-docproj/books/fdp-primer/book.sgml,v 1.19 2008/08/23 16:52:56 jkois Exp $
basiert auf: 1.29
-->
@ -45,8 +45,6 @@
<title>Die Fibel f&uuml;r neue Mitarbeiter des
FreeBSD-Dokumentationsprojekts</title>
<corpauthor>The FreeBSD German Documentation Project</corpauthor>
<copyright>
<year>1998</year>
<year>1999</year>
@ -60,6 +58,21 @@
<holder>The FreeBSD Documentation Project</holder>
</copyright>
<copyright>
<year>1998</year>
<year>1999</year>
<year>2000</year>
<year>2001</year>
<year>2002</year>
<year>2003</year>
<year>2004</year>
<year>2005</year>
<year>2006</year>
<year>2007</year>
<year>2008</year>
<holder>The FreeBSD German Documentation Project</holder>
</copyright>
<pubdate role="rcs">$FreeBSD$</pubdate>
<releaseinfo>$FreeBSD$</releaseinfo>

View file

@ -28,8 +28,8 @@
POSSIBILITY OF SUCH DAMAGE.
$FreeBSD$
$FreeBSDde: de-docproj/books/fdp-primer/the-website/chapter.sgml,v 1.6 2007/11/10 17:21:27 miwi Exp $
basiert auf: 1.23
$FreeBSDde: de-docproj/books/fdp-primer/the-website/chapter.sgml,v 1.7 2008/08/23 16:45:23 jkois Exp $
basiert auf: 1.26
-->
<chapter id="the-website">
@ -48,12 +48,13 @@
<sect1 id="the-website-prep">
<title>Vorbereitung</title>
<para>Sie ben&ouml;tigen mindestens 200&nbsp;MB freien Speicherplatz.
Dieser Platz wird von den SGML-Werkzeugen, den n&ouml;tigen Teilen
des CVS-Baums, f&uuml;r tempor&auml;ren Speicher zum Bau der Seiten
sowie f&uuml;r die Installation der Webseiten ben&ouml;tigt. Sind
die SGML-Werkzeuge und der CVS-Baum bereits installiert, reichen
etwa 100&nbsp;MB an freiem Speicherplatz aus.</para>
<para>Sorgen Sie f&uuml;r gen&uuml;gend Plattenplatz (zwischen
200 und 500&nbsp;MB). Der genaue Wert h&auml;ngt davon ab,
welche Methode Sie zum Bau der Webseiten verwenden. Dieser
Platz wird von den SGML-Werkzeugen, den ben&ouml;tigten Teilen
des CVS-Baums, f&uuml;r tempor&auml;ren Speicher zum Bau der
Seiten sowie f&uuml;r die Installation der Webseiten
ben&ouml;tigt.</para>
<note>
<para>Stellen Sie sicher, dass Ihre Dokumentationsports aktuell
@ -63,57 +64,254 @@
Haben Sie beispielsweise jade-1.1 installiert, deinstallieren Sie
es mit:</para>
<screen>&prompt.root; <userinput>pkg_delete jade-1.1</userinput></screen>
<screen>&prompt.root; <userinput><command>pkg_delete</command> jade-1.1</userinput></screen>
</note>
<para>Legen Sie ein CVS-Repository an. Sie ben&ouml;tigen die
Verzeichnisse www, doc sowie ports des CVS-Baums (und
nat&uuml;rlich CVSROOT). Lesen Sie bitte den Abschnitt
<ulink url="&url.books.handbook;/synching.html#CVSUP">
Synchronisation der Quellen</ulink> des Handbuchs, der die
Spiegelung eines CVS-Baumes oder eines Teilbaumes
beschreibt.</para>
<para>Sie haben zwei M&ouml;glichkeiten, an die f&uuml;r den Bau
der Webseiten n&ouml;tigen Dateien zu gelangen:</para>
<para>Die unbedingt n&ouml;tigen cvsup-Sammlungen sind
<literal>www</literal>, <literal>doc-all</literal>,
<literal>cvs-base</literal>, sowie
<literal>ports-base</literal>.</para>
<itemizedlist>
<listitem>
<para>Sie k&ouml;nnen <command>csup</command> verwenden, um eine
lokale Kopie der Dateien von einem
<application>CVSup</application>-Server herunterzuladen. Dies
ist die einfachste Methode, da Sie keine zus&auml;tzlichen
Programme installieren m&uuml;ssen. Das im n&auml;chsten
Abschnitt beschriebene <filename>supfile</filename> l&auml;dt
jeweils die aktuellste Version der ben&ouml;tigten Dateien
herunter. Diese Methode ist ausreichend, wenn Sie die
Webseiten nur lokal bauen wollen, aber keine Ver&auml;nderungen
committen wollen.</para>
<para>Diese Sammlungen ben&ouml;tigen etwa 105&nbsp;MB an freiem
Speicherplatz.</para>
<note>
<para>Seit &os;&nbsp;6.2-RELEASE ist &man.csup.1; Teil des
&os;-Basissystems. Verwenden Sie eine &auml;ltere
&os;-Version, m&uuml;ssen Sie <filename
role="package">net/csup</filename> &uuml;ber die
Ports-Sammlung installieren.</para>
</note>
</listitem>
<para>Der komplette CVS-Baum - inklusive <literal>src</literal>,
<literal>doc</literal>, <literal>www</literal>, und
<literal>ports</literal> - umfasst derzeit etwa 940&nbsp;MB.</para>
<listitem>
<para>Alternativ verwenden Sie <command>cvsup</command> im
<quote>cvs</quote>-Modus, um ein lokales
<application>CVS</application>-Repository zu erzeugen und
zu verwalten. Dazu m&uuml;ssen Sie zwar ein zus&auml;tzliches
Programm (<filename
role="package">net/cvsup-without-gui</filename>) installieren,
haben aber zus&auml;tzliche M&ouml;glichkeiten, etwa die
Verwaltung verschiedener Revisionen der doc/www-Dateien und
deren Historie. Au&szlig;erdem erlaubt es diese Methode Ihnen,
Ver&auml;nderungen in das zentrale
&os;-<application>CVS</application>-Repository zu
committen.</para>
</listitem>
</itemizedlist>
<sect2 id="the-website-csup">
<title>Die einfache Methode: <command>csup</command>
verwenden</title>
<para><command>csup</command> ist Teil des &os;-Basissystems
und wird inzwischen von den meisten Benutzern zur
Aktualisierung der Ports-Sammlung verwendet. Das folgende
<filename>supfile</filename> kann dazu verwendet werden, um
die zum Bau der Webseiten ben&ouml;tigten Dateien
auszuchecken:</para>
<programlisting>#
# This file checks out all collections required to rebuild
# the FreeBSD website
#
# Use the nearest CVSup mirror
# listed at http://www.freebsd.org/doc/handbook/mirrors.html.
*default host=<replaceable>cvsup10.FreeBSD.org</replaceable>
*default base=/var/db
*default prefix=<replaceable>/usr/build</replaceable>
*default release=cvs tag=.
*default delete use-rel-suffix
*default compress
# This will retrieve the entire doc branch of the FreeBSD repository.
doc-all
# This will retrieve the files required for the website
www
# This will retrieve some basic ports info required for the build
ports-base</programlisting>
<para>&Auml;ndern Sie den Eintrag <literal>default host</literal>
in einen <application>CVSup</application>-Spiegelserver in
Ihrer N&auml;he, bevor Sie mit dem Checkout beginnen.
Au&szlig;erdem sollten Sie den Eintrag
<literal>default prefix</literal> &auml;ndern, wenn Sie die
ausgecheckten Dateien an einem anderen Ort speichern wollen.
Danach speichern Sie die Datei beispielsweise als
<filename><replaceable>doc-www-supfile</replaceable></filename>
ab und f&uuml;hren den folgenden Befehl aus:</para>
<screen>&prompt.root; <userinput><command>csup</command> <option>-g</option> <option>-L2</option> <replaceable>doc-www-supfile</replaceable></userinput></screen>
<para>Nachdem dieser Befehl ausgef&uuml;hrt wurde, finden Sie
drei neue Verzeichnisse,
<filename class="directory">doc/</filename>,
<filename class="directory">www/</filename> sowie
<filename class="directory">ports/</filename> im Verzeichnis,
das Sie durch den Eintrag <literal>default prefix</literal>
(in unserem Beispiel <filename
class="directory"><replaceable>/usr/build</replaceable></filename>)
festgelegt haben. Wir werden das gleiche Verzeichnis f&uuml;r
den Bau der Webseiten verwenden, achten Sie daher unbedingt
darauf, dass Sie &uuml;ber gen&uuml;gend Plattenplatz auf dieser
Partition verf&uuml;gen.</para>
<para>Das ist alles. Sie k&ouml;nnen nun mit dem
<link linkend="the-website-build">Bau der Webseiten</link>
beginnen.</para>
</sect2>
<sect2 id="the-website-cvsup">
<title>Die flexible Methode: Ein lokales
doc/www-<application>CVS</application>-Repository verwenden</title>
<para>Diese Methode bietet Ihnen (wie bereits erw&auml;hnt), mehr
Flexibilit&auml;t, Sie m&uuml;ssen aber den Port oder das Paket
<filename role="package">net/cvsup-without-gui</filename>
installieren.</para>
<note>
<para>Um <filename role="package">net/cvsup-without-gui</filename>
&uuml;ber die Ports-Sammlung zu installieren, muss
zus&auml;tzlich der Port <filename
role="package">lang/ezm3</filename> (ein Modula&nbsp;3-Compiler)
installiert werden. Die Installation dieses Ports ist sehr
zeitintensiv, daher ist es in der Regel am einfachsten,
<application>CVSup</application> als Paket (Package) zu
installieren.</para>
</note>
<para><application>CVSup</application> besitzt einen speziellen
<quote>cvs</quote>-Modus, mit dem Sie <quote>,v</quote>-Dateien
(aus denen ein <application>CVS</application>-Repository
besteht) auschecken k&ouml;nnen. Dies ist mit
<application>csup</application> derzeit noch nicht m&ouml;glich.
Weiterf&uuml;hrende Informationen zu
<application>CVSup</application> finden Sie im Abschnitt <ulink
url="&url.books.handbook;/synching.html#CVSUP">Synchronisation
der Quellen</ulink> des &os;-Handbuchs.</para>
<para>Das <filename>supfile</filename> im folgenden Beispiel
checkt alle cvs-Sammlungen aus, die Sie f&uuml;r den Bau der
Webseiten ben&ouml;tigen und speichert Sie in einem lokalen
<application>CVS</application>-Repository:</para>
<programlisting>#
# This file will create a local CVS repository
# with the collections required for a complete
# FreeBSD website rebuild. It should be used with
# cvsup *only* (csup will not work)
*default host=<replaceable>cvsup10.FreeBSD.org</replaceable>
*default base=/var/db
*default prefix=<replaceable>/usr/dcvs</replaceable>
*default release=cvs
*default delete use-rel-suffix
*default compress
# The following collections are needed
# for the website build
ports-base
doc-all
www
# These collections are needed
# for CVS functionality
cvsroot-common
cvsroot-ports
cvsroot-doc</programlisting>
<para>&Auml;ndern Sie den Eintrag <literal>default host</literal>
in einen <application>CVSup</application>-Spiegelserver in
Ihrer N&auml;he, bevor Sie mit dem Checkout beginnen.
Au&szlig;erdem sollten Sie den Eintrag
<literal>default prefix</literal> &auml;ndern, wenn Sie die
ausgecheckten Dateien an einem anderen Ort speichern wollen.
Danach speichern Sie die Datei beispielsweise als
<filename><replaceable>doc-www-cvsfile</replaceable></filename>
ab und f&uuml;hren den folgenden Befehl aus:</para>
<screen>&prompt.root; <userinput><command>cvsup</command> <option>-g</option> <option>-L2</option> <replaceable>doc-www-cvsfile</replaceable></userinput></screen>
<para>Zus&auml;tzlich sollten Sie die Umgebungsvariable
<envar>CVSROOT</envar> in den Startdateien Ihrer Shell
setzen. Dazu nehmen Sie beispielsweise den folgenden
Eintrag in die Datei <filename>~/.cshrc</filename> auf
(wenn Sie die <application>csh</application> einsetzen):</para>
<programlisting>setenv <envar>CVSROOT</envar> <replaceable>/usr/dcvs</replaceable></programlisting>
<para>Wenn Sie diese Variable gesetzt haben, k&ouml;nnen Sie die
Option <option>-d</option> (siehe weiter unten) weglassen, wenn
Sie <command>cvs</command>-Operationen im Repository
ausf&uuml;hren:</para>
<para>Derzeit ben&ouml;tigen Sie f&uuml;r ein Repository, das
nur die zum Bau der Webseiten n&ouml;tigen Dateien enth&auml;lt,
mehr als 400&nbsp;MB freien Plattenplatz. Der Bau der Webseiten
erfordert tempor&auml;r weitere 200&nbsp;MB.
Nachdem <command>cvsup</command> seine Arbeit beendet hat,
k&ouml;nnen Sie die Dateien in das Verzeichnis, in dem Sie die
Webseiten bauen wollen, auschecken:</para>
<screen>&prompt.root; <userinput><command>mkdir</command> <replaceable>/usr/build</replaceable></userinput>
&prompt.root; <userinput><command>cd</command> <replaceable>/usr/build</replaceable></userinput>
&prompt.root; <userinput><command>cvs</command> <option>-d</option> <replaceable>/usr/dcvs</replaceable> <option>-R</option> co <option>-AP</option> doc www ports</userinput></screen>
<para>Der letzte Befehl entspricht dem Auschecken der Dateien
von einem <application>CVSup</application>-Server mit
<application>csup</application>. Danach haben Sie ein
Bau-Verzeichis analog zur
<application>csup</application>-Methode.</para>
<para><command>cvsup</command> erlaubt es Ihnen auch, Ihr
<application>CVS</application>-Repository regelm&auml;&szlig;ig
zu aktualisieren. Im Gegensatz zum ersten Aufruf dauern diese
Aktualisierungen in der Regel nur wenige Minuten.</para>
</sect2>
</sect1>
<sect1 id="the-website-build">
<title>Die Internetseiten neu bauen</title>
<title>Die Webseiten bauen</title>
<para>Nachdem Sie eine der beiden Methoden erfolgreich
ausgef&uuml;hrt haben, k&ouml;nnen Sie mit dem Bau der Webseiten
beginnen. In unserem Beispiel erfolgt der Bau im Verzeichnis
<filename
class="directory"><replaceable>/usr/build</replaceable></filename>,
in dem sich bereits alle ben&ouml;tigten Dateien befinden.</para>
<procedure>
<step>
<para>Erzeugen und wechseln Sie in das Verzeichnis, in dem Sie
die Webseiten bauen wollen. Sie ben&ouml;tigen dazu mindestens
60&nbsp;MB freien Speicherplatz.</para>
<para>Wechseln Sie in das Bau-Verzeichis.</para>
<screen>&prompt.root; <userinput>mkdir /var/tmp/webbuild</userinput>
&prompt.root; <userinput>cd /var/tmp/webbuild</userinput></screen>
<screen>&prompt.root; <userinput><command>cd</command> <replaceable>/usr/build</replaceable></userinput></screen>
</step>
<step>
<para>Checken Sie die SGML-Dateien aus dem CVS-Baum aus.</para>
<para>Sie starten den Bau der Webseiten, indem Sie in das
Unterverzeichnis <filename class="directory">www/en</filename>
wechseln und dort den Befehl
&man.make.1; <maketarget>all</maketarget> ausf&uuml;hren.</para>
<screen>&prompt.root; <userinput>cvs -R co www doc</userinput></screen>
</step>
<step>
<para>Wechseln Sie ins Verzeichnis <filename
role="directory">www/en</filename> und
f&uuml;hren Sie &man.make.1; <maketarget>all</maketarget> aus,
um die Webseiten zu erzeugen.</para>
<screen>&prompt.root; <userinput>cd en</userinput>
&prompt.root; <userinput>make all</userinput></screen>
<screen>&prompt.root; <userinput><command>cd</command> www/en</userinput>
&prompt.root; <userinput><command>make</command> <maketarget>all</maketarget></userinput></screen>
</step>
</procedure>
</sect1>
@ -124,10 +322,10 @@
<procedure>
<step>
<para>Wechseln Sie wieder in das Verzeichnis
<filename>en</filename>, falls Sie dieses inzwischen
verlassen haben.</para>
<filename class="directory">en</filename>, falls Sie dieses
inzwischen verlassen haben.</para>
<screen>&prompt.root; <userinput>cd <replaceable>path</replaceable>/www/en</userinput></screen>
<screen>&prompt.root; <userinput><command>cd</command> <replaceable>/usr/build/www/en</replaceable></userinput></screen>
</step>
<step>
@ -136,7 +334,7 @@
das Verzeichnis, in das Sie die Webseiten installieren
wollen.</para>
<screen>&prompt.root; <userinput>make DESTDIR=<replaceable>/usr/local/www</replaceable> install</userinput></screen>
<screen>&prompt.root; <userinput><command>env</command> <makevar>DESTDIR</makevar>=<replaceable>/usr/local/www</replaceable> <command>make</command> <maketarget>install</maketarget></userinput></screen>
</step>
<step>
@ -148,7 +346,7 @@
alle Dateien, die in den letzten drei Tagen nicht aktualisiert
wurden:</para>
<screen>&prompt.root; <userinput>find <replaceable>/usr/local/www</replaceable> -ctime 3 -print0 | xargs -0 rm</userinput></screen>
<screen>&prompt.root; <userinput><command>find</command> <replaceable>/usr/local/www</replaceable> <option>-ctime</option> 3 <option>-print0</option> | <command>xargs</command> <option>-0</option> <command>rm</command></userinput></screen>
</step>
</procedure>
</sect1>
@ -161,9 +359,20 @@
<term><envar>CVSROOT</envar></term>
<listitem>
<para>Der Ort des CVS-Baums. Unbedingt notwendig.</para>
<para>Der Ort des CVS-Baums. Sie sollten diese Variable
setzen, wenn Sie die
<application>CVSup</application>-Methode verwenden.</para>
<screen><userinput>&prompt.root; CVSROOT=/home/ncvs; export CVSROOT</userinput></screen>
<screen><userinput>&prompt.root; <makevar>CVSROOT</makevar>=<replaceable>/usr/dcvs</replaceable>; <command>export</command> <makevar>CVSROOT</makevar></userinput></screen>
<para><envar>CVSROOT</envar> ist eine Umgebungsvariable. Sie
m&uuml;ssen sie daher auf der Kommandozeile oder in Ihren
.dot-Dateien (beispielsweise in
<filename>~/.profile</filename>) setzen. Die genaue
Syntax h&auml;ngt von der von Ihnen eingesetzten Shell
(das letzte Beispiel gilt nur f&uuml;r die
<application>bash</application> und bash-&auml;hnliche
Shells) ab.</para>
</listitem>
</varlistentry>
@ -176,14 +385,14 @@
englischen Dokumente. S&auml;mtliche &Uuml;bersetzungen
werden dabei ignoriert. Dazu ein Beispiel:</para>
<screen>&prompt.root; <userinput>make ENGLISH_ONLY=YES all install</userinput></screen>
<screen>&prompt.root; <userinput><command>make</command> <makevar>ENGLISH_ONLY=YES</makevar> <maketarget>all</maketarget> <maketarget>install</maketarget></userinput></screen>
<para>Wenn Sie die Variable <makevar>ENGLISH_ONLY</makevar>
deaktivieren und alle Webseiten inklusive aller
&Uuml;bersetzungen bauen wollen, setzen Sie die Variable
<makevar>ENGLISH_ONLY</makevar> auf einen leeren Wert:</para>
<screen>&prompt.root; <userinput>make ENGLISH_ONLY="" all install clean</userinput></screen>
<screen>&prompt.root; <userinput><command>make</command> <makevar>ENGLISH_ONLY=""</makevar> <maketarget>all</maketarget> <maketarget>install</maketarget> <maketarget>clean</maketarget></userinput></screen>
</listitem>
</varlistentry>
@ -193,10 +402,11 @@
<listitem>
<para>Ist diese Variable gesetzt und nicht leer, bauen und
installieren die Makefiles nur die HTML-Seiten des
www-Verzeichnisses. Alle Dokumente des doc-Verzeichnisses
www-Verzeichnisses. Alle Dokumente des
<filename class="directory">doc</filename>-Verzeichnisses
(Handbuch, FAQ, Artikel) werden dabei ignoriert:</para>
<screen>&prompt.root; <userinput>make WEB_ONLY=YES all install</userinput></screen>
<screen>&prompt.root; <userinput><command>make</command> <makevar>WEB_ONLY=YES</makevar> <maketarget>all</maketarget> <maketarget>install</maketarget></userinput></screen>
</listitem>
</varlistentry>
@ -207,18 +417,13 @@
<para>Ist diese Variable gesetzt, checken die Makefiles keine
Dateien aus dem Ports-CVS-Repository aus. Stattdessen werden
die Dateien aus dem Verzeichnis
<filename>/usr/ports</filename> (oder aus dem Verzeichnis,
auf das die Variable <envar>PORTSBASE</envar> zeigt)
verwendet.</para>
<filename class="directory">/usr/ports</filename>
(oder aus dem Verzeichnis, auf das die Variable
<envar>PORTSBASE</envar> zeigt) verwendet.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Bei <envar>CVSROOT</envar> handelt es sich um eine
Umgebungsvariable. Sie muss auf der Kommandozeile oder in der
Konfigurationsdatei <filename>~/.profile</filename> gesetzt
werden.</para>
<para><makevar>WEB_ONLY</makevar>, <makevar>ENGLISH_ONLY</makevar>
und <makevar>NOPORTSCVS</makevar> sind Variablen f&uuml;r Makefiles.
Diese werden entweder in <filename>/etc/make.conf</filename>, in