cvs commit: de-docproj/books/fdp-primer/the-website chapter.sgml

From: Johann Kois <jkois(at)doc.bsdgroup.de>
Date: Sat, 23 Aug 2008 16:45:23 GMT

jkois 2008-08-23 16:45:23 UTC

FreeBSD German Documentation Repository

  Modified files:
    books/fdp-primer/the-website chapter.sgml
  Log:
  MFen 1.23->1.26

  Revision Changes Path
  1.7 +270 -65 de-docproj/books/fdp-primer/the-website/chapter.sgml

  Index: chapter.sgml
  ===================================================================
  RCS file: /home/cvs/de-docproj/books/fdp-primer/the-website/chapter.sgml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -I$FreeBSDde.*$ -r1.6 -r1.7
  --- chapter.sgml 10 Nov 2007 17:21:27 -0000 1.6
  +++ chapter.sgml 23 Aug 2008 16:45:23 -0000 1.7
  @@ -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ötigen mindestens 200 MB freien Speicherplatz.
  - Dieser Platz wird von den SGML-Werkzeugen, den nötigen Teilen
  - des CVS-Baums, für temporären Speicher zum Bau der Seiten
  - sowie für die Installation der Webseiten benötigt. Sind
  - die SGML-Werkzeuge und der CVS-Baum bereits installiert, reichen
  - etwa 100 MB an freiem Speicherplatz aus.</para>
  + <para>Sorgen Sie für genügend Plattenplatz (zwischen
  + 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
  + Seiten sowie für die Installation der Webseiten
  + benö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ötigen die
  - Verzeichnisse www, doc sowie ports des CVS-Baums (und
  - natü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>Die unbedingt nötigen cvsup-Sammlungen sind
  - <literal>www</literal>, <literal>doc-all</literal>,
  - <literal>cvs-base</literal>, sowie
  - <literal>ports-base</literal>.</para>
  -
  - <para>Diese Sammlungen benötigen etwa 105 MB an freiem
  - Speicherplatz.</para>
  -
  - <para>Der komplette CVS-Baum - inklusive <literal>src</literal>,
  - <literal>doc</literal>, <literal>www</literal>, und
  - <literal>ports</literal> - umfasst derzeit etwa 940 MB.</para>
  + <para>Sie haben zwei Möglichkeiten, an die für den Bau
  + der Webseiten nötigen Dateien zu gelangen:</para>
  +
  + <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>
  +
  + <note>
  + <para>Seit &os; 6.2-RELEASE ist &man.csup.1; Teil des
  + &os;-Basissystems. Verwenden Sie eine ältere
  + &os;-Version, müssen Sie <filename
  + role="package">net/csup</filename> über die
  + Ports-Sammlung installieren.</para>
  + </note>
  + </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
  + role="package">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>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
  + doc/www-<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 role="package">net/cvsup-without-gui</filename>
  + installieren.</para>
  +
  + <note>
  + <para>Um <filename role="package">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

----------------------------------------------
Diff block truncated. (Max lines = 200)
----------------------------------------------

To Unsubscribe: send mail to majordomo(at)de.FreeBSD.org
with "unsubscribe de-cvs-doc" in the body of the message
Received on Sat 23 Aug 2008 - 18:45:40 CEST