r41125 -> r43126

MFde:	Resync the chapter "the website" of the fdp-primer

Obtained from:	The FreeBSD German Documentation Project

1 files changed, 50 insertions, 141 deletions

diff --git a/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml b/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml
index baa7956300..b9d985c82b 100644
--- a/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml
+++ b/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml
@@ -30,7 +30,7 @@
 
      $FreeBSD$
      $FreeBSDde$
-     basiert auf: r41125
+     basiert auf: r43126
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="the-website">
   <info><title>Die Webseite</title>
@@ -39,139 +39,60 @@
     </authorgroup>
   </info>
 
-  
-
-  <sect1 xml:id="the-website-prep">
-    <title>Vorbereitung</title>
-
-    <para>Sorgen Sie für genügend Plattenplatz (zwischen
-      200 und 500&nbsp;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 Subversion-Baums, für temporären Speicher zum Bau der
-      Seiten sowie für die Installation der Webseiten
-      benötigt.</para>
-
-    <note>
-      <para>Stellen Sie sicher, dass Ihre Dokumentationsports aktuell
-	sind.  Wenn Sie sich nicht sicher sind, entfernen Sie die alten
-	Ports mit &man.pkg.delete.1;, bevor Sie die neue Version
-	installieren.  Derzeit wird unter anderem jade-1.2 vorausgesetzt.
-	Haben Sie beispielsweise jade-1.1 installiert, deinstallieren Sie
-	es mit:</para>
-
-      <screen>&prompt.root; <userinput>pkg_delete jade-1.1</userinput></screen>
-    </note>
-
-    <sect2 xml:id="the-website-svn">
-      <title><command>svn</command> verwenden</title>
-
-      <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>cd /usr/ports/devel/subversion</userinput>
-&prompt.root; <userinput>make install clean</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>svn checkout https://svn0.us-
-east.FreeBSD.org/doc/head/ /usr/build</userinput></screen>
-
-      <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 aus der Liste
-	<link xlink:href="&url.books.handbook;/svn-mirrors.html">Subversion
-	mirror sites</link>.</para>
-
-      <tip>
-	<para>Falls Sie <command>svn</command> nicht als Benutzer
-	  <systemitem class="username">root</systemitem> ausführen, stellen Sie bitte
-	  zuvor sicher, dass Sie in das Verzeichnis <filename>/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>/usr/build</filename> (oder in dem
-	von Ihnen angegebenen Verzeichnis).  Haben Sie ein alternatives
-	Verzeichis angegeben, müssen Sie <filename>/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>
-  </sect1>
-
   <sect1 xml:id="the-website-build">
     <title>Die Webseiten bauen</title>
 
     <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>/usr/build</filename>,
+      <filename role="directory"><replaceable>~/doc</replaceable></filename>,
       in dem sich bereits alle benötigten Dateien befinden.</para>
 
-    <procedure>
-      <step>
-	<para>Wechseln Sie in das Bau-Verzeichis.</para>
-
-	<screen>&prompt.root; <userinput>cd /usr/build</userinput></screen>
-      </step>
-
-      <step>
-	<para>Sie starten den Bau der Webseiten, indem Sie in das
-	  Unterverzeichnis <filename>en_US.ISO8859-1/htdocs</filename>
-	  wechseln und dort den Befehl
-	  &man.make.1; <buildtarget>all</buildtarget> ausführen.</para>
-
-	<screen>&prompt.root; <userinput>cd en_US.ISO8859-1/htdocs</userinput>
-&prompt.root; <userinput>make all</userinput></screen>
-      </step>
-    </procedure>
+    <para>Sie starten den Bau der Webseiten, indem Sie in das
+      Unterverzeichnis <filename>en_US.ISO8859-1/htdocs</filename>
+      des Dokumentationsbaums (in unserem Beispiel also unter
+      <filename>~/doc</filename>) wechseln und dort den Befehl
+      <command>make all</command> ausführen.</para>
+
+    <screen>&prompt.user; <userinput>cd ~/doc/en_US.ISO8859-1/htdocs</userinput>
+&prompt.user; <userinput>make all</userinput></screen>
+
+    <tip>
+      <para>Der Bau der Webseiten erfordert die Datei <filename>INDEX</filename>
+	der Ports-Sammlung und schlägt fehl, wenn
+	<filename>/usr/ports</filename> nicht existiert.  Der einfachste
+	Weg, dies zu vermeiden, ist die Installatin der <link
+	xlink:href="&url.books.handbook;/ports.html#ports-tree">Ports-Sammlung</link>.</para>
+    </tip>
   </sect1>
 
   <sect1 xml:id="the-website-install">
     <title>Installieren der Webseiten auf Ihrem Server</title>
 
-    <procedure>
-      <step>
-	<para>Wechseln Sie wieder in das Verzeichnis
-	  <filename>en_US.ISO8859-1/htdocs</filename>,
-	  falls Sie dieses inzwischen verlassen haben.</para>
-
-	<screen>&prompt.root; <userinput>cd /usr/build/en_US.ISO8859-1/htdocs</userinput></screen>
-      </step>
-
-      <step>
-	<para>Führen Sie &man.make.1; <buildtarget>install</buildtarget>
-	 aus und setzen Sie die Variable <varname>DESTDIR</varname> auf
-	 das Verzeichnis, in das Sie die Webseiten installieren
-	 wollen.  Die daraus resultierenden Dateien werden unter <filename>$DESTDIR/data</filename> installiert, was als die
-	 document root ihres Webservers konfiguriert sein sollte.</para>
-
-	<screen>&prompt.root; <userinput>env DESTDIR=/usr/local/www make install</userinput></screen>
-      </step>
-
-      <step>
-	<para>Wenn Sie die Webseiten bereits früher in dieses
-	  Verzeichnis installiert haben, wurden während der
-	  Installation keine veralteten Seiten entfernt.  Wenn
-	  Sie die Webseiten beispielsweise täglich neu bauen
-	  und installieren, findet und entfernt der folgende Befehl
-	  alle Dateien, die in den letzten drei Tagen nicht aktualisiert
-	  wurden:</para>
-
-	<screen>&prompt.root; <userinput>find /usr/local/www -ctime 3 -print0 | xargs -0 rm</userinput></screen>
-      </step>
-    </procedure>
+   <para>Führen Sie <command>make install</command> aus und setzen Sie
+    die Variable <varname>DESTDIR</varname> auf das Verzeichnis, in das
+    Sie die Webseiten installieren wollen.  Die daraus resultierenden
+    Dateien werden unter <filename>$DESTDIR/data</filename> installiert,
+    was als die document root ihres Webservers konfiguriert sein
+    sollte.</para>
+
+    <para>Die Installation der Webseiten wird als
+      <systemitem class="username">root</systemitem> ausgeführt, weil die
+      Berechtigungen des Webserver-Verzeichnisses den Schreibzugriff für
+      normale Benutzer verhindern.  Im folgenden Beispiel wurden die
+      Webseiten durch den Benutzer <systemitem
+      class="username">jru</systemitem> in dessen Heimatverzeichnis,
+      also unter <filename>/usr/home/jru/doc</filename> gebaut.</para>
+
+    <screen>&prompt.root; <userinput>cd /home/jru/doc/en_US.ISO8859-1/htdocs</userinput>
+&prompt.root; <userinput>env DESTDIR=<replaceable>/usr/local/www</replaceable> make install</userinput></screen>
+
+    <para>Veraltete (und nicht mehr verwendete) Dateien werden während
+      der Installation nicht automatisch entfernt.  Der folgende Befehl
+      findet (und löscht) alle Dateien im Installationsverzeichnis, die
+      in den letzten drei Tagen nicht aktualisiert wurden:</para>
+
+    <screen>&prompt.root; <userinput>find <replaceable>/usr/local/www</replaceable> -ctime 3 -delete</userinput></screen>
   </sect1>
 
   <sect1 xml:id="the-website-env">
@@ -203,11 +124,12 @@ east.FreeBSD.org/doc/head/ /usr/build</userinput></screen>
 
 	<listitem>
 	  <para>Ist diese Variable gesetzt und nicht leer, bauen und
-	    installieren die Makefiles nur die HTML-Seiten des
+	    installieren die Makefiles nur die
+	    <acronym>HTML</acronym>-Seiten des
 	    Verzeichnisses <filename>en_US.ISO8859-1/htdocs</filename>.
-	    Alle Dokumente des Verzeichnisses
+	    Alle anderen Dokumente des Verzeichnisses
 	    <filename>en_US.ISO8859-1</filename>
-	    (Handbuch, FAQ, Artikel) werden dabei ignoriert:</para>
+	    (wie Handbuch, FAQ, Artikel) werden dabei ignoriert:</para>
 
 	  <screen>&prompt.root; <userinput>make WEB_ONLY=YES all install</userinput></screen>
 	</listitem>
@@ -220,31 +142,18 @@ east.FreeBSD.org/doc/head/ /usr/build</userinput></screen>
 	  <para>Ist diese Variable gesetzt, wird die Dokumentation nur
 	    für die durch diese Variable festgelegten Sprachen
 	    gebaut und im Verzeichnis
-	    <filename>/usr/build</filename>
-	    installiert.  Alle weiteren Sprachen (ausgenommen Englisch) werden
-	    ignoriert. Dazu ein Beispiel:</para>
+	    <filename role="directory"><replaceable>~/doc</replaceable></filename>
+	    gebaut und danach installiert.  Alle weiteren Sprachen
+	    (ausgenommen Englisch) werden ignoriert. Dazu ein Beispiel:</para>
 
 	  <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>
-
-      <varlistentry>
-	<term><varname>NOPORTSCVS</varname></term>
-
-	<listitem>
-	  <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>
-	</listitem>
-      </varlistentry>
     </variablelist>
 
     <para><varname>WEB_ONLY</varname>, <varname>ENGLISH_ONLY</varname>,
       <varname>WEB_LANG</varname> und <varname>NOPORTSCVS</varname>
-      sind Variablen für Makefiles.
+      sind Variablen für &man.make.1;.
       Diese werden entweder in <filename>/etc/make.conf</filename>, in
       <filename>Makefile.inc</filename> oder als Umgebungsvariablen auf
       der Kommandozeile oder in Ihrer Konfigurationsdatei gesetzt.</para>