Date: Sat, 26 May 2012 15:53:17 +0000 (UTC) From: Johann Kois <jkois@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r38900 - head/de_DE.ISO8859-1/books/fdp-primer/the-website Message-ID: <201205261553.q4QFrHqq086135@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201205261553.q4QFrHqq086135>