r38826 -> 38876 Update the build instructions for SVN.

svn path=/head/; revision=38900

de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml

@@ -29,7 +29,7 @@
 
      $FreeBSD$
      $FreeBSDde$
-     basiert auf: r38826
+     basiert auf: r38870
 -->
 
 <chapter id="the-website">
@@ -52,7 +52,7 @@
       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
+      des Subversion-Baums, f&uuml;r tempor&auml;ren Speicher zum Bau der
       Seiten sowie f&uuml;r die Installation der Webseiten
       ben&ouml;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&ouml;glichkeiten, an die f&uuml;r den Bau
+    <sect2 id="the-website-svn">
-      der Webseiten n&ouml;tigen Dateien zu gelangen:</para>
+      <title><command>svn</command> verwenden</title>
 
-    <itemizedlist>
+      <para>Um Dateien aus dem <literal>doc/</literal>
-      <listitem>
+	Subversion-Repository <quote>auszuchecken</quote>, muss
-	<para>Sie k&ouml;nnen <command>csup</command> verwenden, um eine
+	<command>svn</command> installiert sein.  Ist dies bei Ihnen noch
-	  lokale Kopie der Dateien von einem
+	nicht der Fall, k&ouml;nnen Sie dies entweder mit &man.pkg.add.1;
-	  <application>CVSup</application>-Server herunterzuladen.  Dies
+	oder &uuml;ber die &os; Ports-Sammlung nachholen:</para>
-	  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>
-      </listitem>
 
-      <listitem>
+      <screen>&prompt.root; <userinput><command>cd /usr/ports/devel/subversion</command></userinput>
-	<para>Alternativ verwenden Sie <command>cvsup</command> im
+&prompt.root; <userinput><command>make</command> <maketarget>install clean</maketarget></userinput></screen>
-	  <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>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">
+      <para>Um alle zum Bau der Webseite ben&ouml;tigten Quellen
-      <title>Die einfache Methode: <command>csup</command>
+	auszuchecken, f&uuml;hren Sie den folgenden Befehl aus:</para>
-	verwenden</title>
 
-      <para><command>csup</command> ist Teil des &os;-Basissystems
+      <screen>&prompt.root; <userinput><command>svn checkout svn://svn.FreeBSD.org/doc/head/ <replaceable>/usr/build</replaceable></command></userinput></screen>
-	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>#
+      <tip>
-# This file checks out all collections required to rebuild
+	<para>Falls Sie <command>svn</command> nicht als Benutzer
-# the FreeBSD website
+	  <username>root</username> ausf&uuml;hren, stellen Sie bitte
-#
+	  zuvor sicher, dass Sie in das Verzeichnis <filename
-# Use the nearest CVSup mirror
+          class="directory">/usr/build</filename> schreiben d&uuml;rfen.
-# listed at http://www.freebsd.org/doc/handbook/mirrors.html.
+	  Ist dies nicht m&ouml;glich, so m&uuml;ssen Sie hier ein
+	  anderes Zielverzeichnis angeben, in das die Quellen der
+	  Webseite gespeichert werden sollen.</para>
+      </tip>
 
-*default host=<replaceable>cvsup10.FreeBSD.org</replaceable>
+      <para>Nachdem <command>svn</command> seine Arbeit beendet hat,
-*default base=/var/db
+	befindet sich die komplette &os;-Webseite im Verzeichnis
-*default prefix=<replaceable>/usr/build</replaceable>
+	<filename class="directory">/usr/build</filename> (oder in dem
-*default release=cvs tag=.
+	von Ihnen angegebenen Verzeichnis).  Haben Sie ein alternatives
-*default delete use-rel-suffix
+	Verzeichis angegeben, m&uuml;ssen Sie <filename
-*default compress
+	class="directory">/usr/build</filename> in den folgenden
-
+	Ausf&uuml;hrung durch Ihr gew&auml;hltes Zielverzeichnis
-# This will retrieve the entire doc branch of the FreeBSD repository.
+	ersetzen.</para>
-
-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
-	<literal>doc/www</literal>-<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>net/cvsup-without-gui</filename> installieren.</para>
-
-      <note>
-	<para>Um <filename>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 Webseiten bauen</title>
 
-    <para>Nachdem Sie eine der beiden Methoden erfolgreich
+    <para>Nachdem Sie die Quellen der Webseite erfolgreich
-      ausgef&uuml;hrt haben, k&ouml;nnen Sie mit dem Bau der Webseiten
+      heruntergeladen haben, k&ouml;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&uuml;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
+	  <filename class="directory">en_US.ISO8859-1/htdocs</filename>,
-	  inzwischen verlassen haben.</para>
+	  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>
@@ -348,27 +180,6 @@ cvsroot-doc</programlisting>
     <title>Umgebungsvariablen</title>
 
     <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&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>
-
       <varlistentry>
 	<term><makevar>ENGLISH_ONLY</makevar></term>
 
@@ -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>.
+	    Verzeichnisses <filename
-	    Alle Dokumente des
+	    class="directory">en_US.ISO8859-1/htdocs</filename>.
-	    <filename class="directory">doc</filename>-Verzeichnisses
+	    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&uuml;r die durch diese Variable festgelegten Sprachen
 	    gebaut und im Verzeichnis
-	    <filename class="directory">www</filename> installiert.
+	    <filename
-	    Alle weiteren Sprachen (ausgenommen Englisch) werden
+	    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>