svn commit: r38900 -
head/de_DE.ISO8859-1/books/fdp-primer/the-website
Johann Kois
jkois at FreeBSD.org
Sat May 26 15:53:17 UTC 2012
Author: jkois
Date: Sat May 26 15:53:17 2012
New Revision: 38900
URL: http://svn.freebsd.org/changeset/doc/38900
Log:
r38826 -> 38876 Update the build instructions for SVN.
Modified:
head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
Modified: head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
==============================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml Sat May 26 15:26:43 2012 (r38899)
+++ head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml Sat May 26 15:53:17 2012 (r38900)
@@ -29,7 +29,7 @@
$FreeBSD$
$FreeBSDde$
- basiert auf: r38826
+ basiert auf: r38870
-->
<chapter id="the-website">
@@ -52,7 +52,7 @@
200 und 500 MB). Der genaue Wert hängt davon ab,
welche Methode Sie zum Bau der Webseiten verwenden. Dieser
Platz wird von den SGML-Werkzeugen, den benötigten Teilen
- des CVS-Baums, für temporären Speicher zum Bau der
+ des Subversion-Baums, für temporären Speicher zum Bau der
Seiten sowie für die Installation der Webseiten
benötigt.</para>
@@ -67,222 +67,53 @@
<screen>&prompt.root; <userinput><command>pkg_delete</command> jade-1.1</userinput></screen>
</note>
- <para>Sie haben zwei Möglichkeiten, an die für den Bau
- der Webseiten nötigen Dateien zu gelangen:</para>
+ <sect2 id="the-website-svn">
+ <title><command>svn</command> verwenden</title>
- <itemizedlist>
- <listitem>
- <para>Sie kö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ätzlichen
- Programme installieren müssen. Das im nächsten
- Abschnitt beschriebene <filename>supfile</filename> lädt
- jeweils die aktuellste Version der benötigten Dateien
- herunter. Diese Methode ist ausreichend, wenn Sie die
- Webseiten nur lokal bauen wollen, aber keine Veränderungen
- committen wollen.</para>
- </listitem>
-
- <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üssen Sie zwar ein zusätzliches
- Programm (<filename>net/cvsup-without-gui</filename>) installieren,
- haben aber zusätzliche Möglichkeiten, etwa die
- Verwaltung verschiedener Revisionen der doc/www-Dateien und
- deren Historie. Außerdem erlaubt es diese Methode Ihnen,
- Verä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ö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>Ändern Sie den Eintrag <literal>default host</literal>
- in einen <application>CVSup</application>-Spiegelserver in
- Ihrer Nähe, bevor Sie mit dem Checkout beginnen.
- Außerdem sollten Sie den Eintrag
- <literal>default prefix</literal> ä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ü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ü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ür
- den Bau der Webseiten verwenden, achten Sie daher unbedingt
- darauf, dass Sie über genügend Plattenplatz auf dieser
- Partition verfügen.</para>
+ <para>Um Dateien aus dem <literal>doc/</literal>
+ Subversion-Repository <quote>auszuchecken</quote>, muss
+ <command>svn</command> installiert sein. Ist dies bei Ihnen noch
+ nicht der Fall, können Sie dies entweder mit &man.pkg.add.1;
+ oder über die &os; Ports-Sammlung nachholen:</para>
+
+ <screen>&prompt.root; <userinput><command>cd /usr/ports/devel/subversion</command></userinput>
+&prompt.root; <userinput><command>make</command> <maketarget>install clean</maketarget></userinput></screen>
+
+ <para>Um alle zum Bau der Webseite benötigten Quellen
+ auszuchecken, führen Sie den folgenden Befehl aus:</para>
+
+ <screen>&prompt.root; <userinput><command>svn checkout svn://svn.FreeBSD.org/doc/head/ <replaceable>/usr/build</replaceable></command></userinput></screen>
+
+ <tip>
+ <para>Falls Sie <command>svn</command> nicht als Benutzer
+ <username>root</username> ausführen, stellen Sie bitte
+ zuvor sicher, dass Sie in das Verzeichnis <filename
+ class="directory">/usr/build</filename> schreiben dürfen.
+ Ist dies nicht möglich, so müssen Sie hier ein
+ anderes Zielverzeichnis angeben, in das die Quellen der
+ Webseite gespeichert werden sollen.</para>
+ </tip>
+
+ <para>Nachdem <command>svn</command> seine Arbeit beendet hat,
+ befindet sich die komplette &os;-Webseite im Verzeichnis
+ <filename class="directory">/usr/build</filename> (oder in dem
+ von Ihnen angegebenen Verzeichnis). Haben Sie ein alternatives
+ Verzeichis angegeben, müssen Sie <filename
+ class="directory">/usr/build</filename> in den folgenden
+ Ausführung durch Ihr gewähltes Zielverzeichnis
+ ersetzen.</para>
<para>Das ist alles. Sie kö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
- <literal>doc/www</literal>-<application>CVS</application>-Repository
- verwenden</title>
-
- <para>Diese Methode bietet Ihnen (wie bereits erwähnt), mehr
- Flexibilität, Sie müssen aber den Port oder das Paket
- <filename>net/cvsup-without-gui</filename> installieren.</para>
-
- <note>
- <para>Um <filename>net/cvsup-without-gui</filename>
- über die Ports-Sammlung zu installieren, muss
- zusätzlich der Port <filename
- role="package">lang/ezm3</filename> (ein Modula 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önnen. Dies ist mit
- <application>csup</application> derzeit noch nicht möglich.
- Weiterfü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ür den Bau der
- Webseiten benö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>Ändern Sie den Eintrag <literal>default host</literal>
- in einen <application>CVSup</application>-Spiegelserver in
- Ihrer Nähe, bevor Sie mit dem Checkout beginnen.
- Außerdem sollten Sie den Eintrag
- <literal>default prefix</literal> ä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ü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ä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önnen Sie die
- Option <option>-d</option> (siehe weiter unten) weglassen, wenn
- Sie <command>cvs</command>-Operationen im Repository
- ausführen:</para>
-
- <para>Derzeit benötigen Sie für ein Repository, das
- nur die zum Bau der Webseiten nötigen Dateien enthält,
- mehr als 400 MB freien Plattenplatz. Der Bau der Webseiten
- erfordert temporär weitere 200 MB.
- Nachdem <command>cvsup</command> seine Arbeit beendet hat,
- kö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äß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 Webseiten bauen</title>
- <para>Nachdem Sie eine der beiden Methoden erfolgreich
- ausgeführt haben, können Sie mit dem Bau der Webseiten
+ <para>Nachdem Sie die Quellen der Webseite erfolgreich
+ heruntergeladen haben, können Sie mit dem Bau der Webseite
beginnen. In unserem Beispiel erfolgt der Bau im Verzeichnis
<filename
class="directory"><replaceable>/usr/build</replaceable></filename>,
@@ -297,11 +128,12 @@ cvsroot-doc</programlisting>
<step>
<para>Sie starten den Bau der Webseiten, indem Sie in das
- Unterverzeichnis <filename class="directory">www/en</filename>
+ Unterverzeichnis <filename
+ class="directory">en_US.ISO8859-1/htdocs</filename>
wechseln und dort den Befehl
&man.make.1; <maketarget>all</maketarget> ausführen.</para>
- <screen>&prompt.root; <userinput><command>cd</command> www/en</userinput>
+ <screen>&prompt.root; <userinput><command>cd</command> en_US.ISO8859-1/htdocs</userinput>
&prompt.root; <userinput><command>make</command> <maketarget>all</maketarget></userinput></screen>
</step>
</procedure>
@@ -313,10 +145,10 @@ cvsroot-doc</programlisting>
<procedure>
<step>
<para>Wechseln Sie wieder in das Verzeichnis
- <filename class="directory">en</filename>, falls Sie dieses
- inzwischen verlassen haben.</para>
+ <filename class="directory">en_US.ISO8859-1/htdocs</filename>,
+ falls Sie dieses inzwischen verlassen haben.</para>
- <screen>&prompt.root; <userinput><command>cd</command> <replaceable>/usr/build/www/en</replaceable></userinput></screen>
+ <screen>&prompt.root; <userinput><command>cd</command> <replaceable>/usr/build/en_US.ISO8859-1/htdocs</replaceable></userinput></screen>
</step>
<step>
@@ -349,27 +181,6 @@ cvsroot-doc</programlisting>
<variablelist>
<varlistentry>
- <term><envar>CVSROOT</envar></term>
-
- <listitem>
- <para>Der Ort des CVS-Baums. Sie sollten diese Variable
- setzen, wenn Sie die
- <application>CVSup</application>-Methode verwenden.</para>
-
- <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üssen sie daher auf der Kommandozeile oder in Ihren
- .dot-Dateien (beispielsweise in
- <filename>~/.profile</filename>) setzen. Die genaue
- Syntax hängt von der von Ihnen eingesetzten Shell
- (das letzte Beispiel gilt nur für die
- <application>bash</application> und bash-ähnliche
- Shells) ab.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term><makevar>ENGLISH_ONLY</makevar></term>
<listitem>
@@ -395,9 +206,10 @@ cvsroot-doc</programlisting>
<listitem>
<para>Ist diese Variable gesetzt und nicht leer, bauen und
installieren die Makefiles nur die HTML-Seiten des
- Verzeichnisses <filename class="directory">www</filename>.
- Alle Dokumente des
- <filename class="directory">doc</filename>-Verzeichnisses
+ Verzeichnisses <filename
+ class="directory">en_US.ISO8859-1/htdocs</filename>.
+ Alle Dokumente des Verzeichnisses
+ <filename class="directory">en_US.ISO8859-1</filename>
(Handbuch, FAQ, Artikel) werden dabei ignoriert:</para>
<screen>&prompt.root; <userinput><command>make</command> <makevar>WEB_ONLY=YES</makevar> <maketarget>all</maketarget> <maketarget>install</maketarget></userinput></screen>
@@ -411,11 +223,12 @@ cvsroot-doc</programlisting>
<para>Ist diese Variable gesetzt, wird die Dokumentation nur
für die durch diese Variable festgelegten Sprachen
gebaut und im Verzeichnis
- <filename class="directory">www</filename> installiert.
- Alle weiteren Sprachen (ausgenommen Englisch) werden
+ <filename
+ class="directory"><replaceable>/usr/build</replaceable></filename>
+ installiert. Alle weiteren Sprachen (ausgenommen Englisch) werden
ignoriert. Dazu ein Beispiel:</para>
- <screen>&prompt.root; <userinput>make WEB_LANG="el es hu nl" all install</userinput></screen>
+ <screen>&prompt.root; <userinput>make WEB_LANG="el_GR.ISO8859-7 es_ES.ISO8859-1 hu_HU.ISO8859-2 nl_NL.ISO8859-1" all install</userinput></screen>
</listitem>
</varlistentry>
More information about the svn-doc-all
mailing list