From 09cc69c5c5787479084a89dcb96d142bfbfc6f32 Mon Sep 17 00:00:00 2001 From: Johann Kois Date: Sat, 26 May 2012 15:53:17 +0000 Subject: [PATCH] r38826 -> 38876 Update the build instructions for SVN. --- .../books/fdp-primer/the-website/chapter.sgml | 281 +++--------------- 1 file changed, 47 insertions(+), 234 deletions(-) diff --git a/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml b/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml index 6e29b2016c..e5a3d39323 100644 --- a/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml +++ b/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.sgml @@ -29,7 +29,7 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r38826 + basiert auf: r38870 --> @@ -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. @@ -67,222 +67,53 @@ &prompt.root; pkg_delete jade-1.1 - Sie haben zwei Möglichkeiten, an die für den Bau - der Webseiten nötigen Dateien zu gelangen: + + <command>svn</command> verwenden - - - Sie können csup verwenden, um eine - lokale Kopie der Dateien von einem - CVSup-Server herunterzuladen. Dies - ist die einfachste Methode, da Sie keine zusätzlichen - Programme installieren müssen. Das im nächsten - Abschnitt beschriebene supfile 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. - + Um Dateien aus dem doc/ + Subversion-Repository auszuchecken, muss + svn 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: - - Alternativ verwenden Sie cvsup im - cvs-Modus, um ein lokales - CVS-Repository zu erzeugen und - zu verwalten. Dazu müssen Sie zwar ein zusätzliches - Programm (net/cvsup-without-gui) 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;-CVS-Repository zu - committen. - - + &prompt.root; cd /usr/ports/devel/subversion +&prompt.root; make install clean - - Die einfache Methode: <command>csup</command> - verwenden + Um alle zum Bau der Webseite benötigten Quellen + auszuchecken, führen Sie den folgenden Befehl aus: - csup ist Teil des &os;-Basissystems - und wird inzwischen von den meisten Benutzern zur - Aktualisierung der Ports-Sammlung verwendet. Das folgende - supfile kann dazu verwendet werden, um - die zum Bau der Webseiten benötigten Dateien - auszuchecken: + &prompt.root; svn checkout svn://svn.FreeBSD.org/doc/head/ /usr/build - # -# 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. + + Falls Sie svn nicht als Benutzer + root ausführen, stellen Sie bitte + zuvor sicher, dass Sie in das Verzeichnis /usr/build 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. + -*default host=cvsup10.FreeBSD.org -*default base=/var/db -*default prefix=/usr/build -*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 - - Ändern Sie den Eintrag default host - in einen CVSup-Spiegelserver in - Ihrer Nähe, bevor Sie mit dem Checkout beginnen. - Außerdem sollten Sie den Eintrag - default prefix ändern, wenn Sie die - ausgecheckten Dateien an einem anderen Ort speichern wollen. - Danach speichern Sie die Datei beispielsweise als - doc-www-supfile - ab und führen den folgenden Befehl aus: - - &prompt.root; csup doc-www-supfile - - Nachdem dieser Befehl ausgeführt wurde, finden Sie - drei neue Verzeichnisse, - doc/, - www/ sowie - ports/ im Verzeichnis, - das Sie durch den Eintrag default prefix - (in unserem Beispiel /usr/build) - 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. + Nachdem svn seine Arbeit beendet hat, + befindet sich die komplette &os;-Webseite im Verzeichnis + /usr/build (oder in dem + von Ihnen angegebenen Verzeichnis). Haben Sie ein alternatives + Verzeichis angegeben, müssen Sie /usr/build in den folgenden + Ausführung durch Ihr gewähltes Zielverzeichnis + ersetzen. Das ist alles. Sie können nun mit dem Bau der Webseiten beginnen. - - - Die flexible Methode: Ein lokales - <literal>doc/www</literal>-<application>CVS</application>-Repository - verwenden - - Diese Methode bietet Ihnen (wie bereits erwähnt), mehr - Flexibilität, Sie müssen aber den Port oder das Paket - net/cvsup-without-gui installieren. - - - Um net/cvsup-without-gui - über die Ports-Sammlung zu installieren, muss - zusätzlich der Port lang/ezm3 (ein Modula 3-Compiler) - installiert werden. Die Installation dieses Ports ist sehr - zeitintensiv, daher ist es in der Regel am einfachsten, - CVSup als Paket (Package) zu - installieren. - - - CVSup besitzt einen speziellen - cvs-Modus, mit dem Sie ,v-Dateien - (aus denen ein CVS-Repository - besteht) auschecken können. Dies ist mit - csup derzeit noch nicht möglich. - Weiterführende Informationen zu - CVSup finden Sie im Abschnitt Synchronisation - der Quellen des &os;-Handbuchs. - - Das supfile im folgenden Beispiel - checkt alle cvs-Sammlungen aus, die Sie für den Bau der - Webseiten benötigen und speichert Sie in einem lokalen - CVS-Repository: - - # -# 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=cvsup10.FreeBSD.org -*default base=/var/db -*default prefix=/usr/dcvs -*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 - - Ändern Sie den Eintrag default host - in einen CVSup-Spiegelserver in - Ihrer Nähe, bevor Sie mit dem Checkout beginnen. - Außerdem sollten Sie den Eintrag - default prefix ändern, wenn Sie die - ausgecheckten Dateien an einem anderen Ort speichern wollen. - Danach speichern Sie die Datei beispielsweise als - doc-www-cvsfile - ab und führen den folgenden Befehl aus: - - &prompt.root; cvsup doc-www-cvsfile - - Zusätzlich sollten Sie die Umgebungsvariable - CVSROOT in den Startdateien Ihrer Shell - setzen. Dazu nehmen Sie beispielsweise den folgenden - Eintrag in die Datei ~/.cshrc auf - (wenn Sie die csh einsetzen): - - setenv CVSROOT /usr/dcvs - - Wenn Sie diese Variable gesetzt haben, können Sie die - Option (siehe weiter unten) weglassen, wenn - Sie cvs-Operationen im Repository - ausführen: - - 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 cvsup seine Arbeit beendet hat, - können Sie die Dateien in das Verzeichnis, in dem Sie die - Webseiten bauen wollen, auschecken: - - &prompt.root; mkdir /usr/build -&prompt.root; cd /usr/build -&prompt.root; cvs /usr/dcvs co doc www ports - - Der letzte Befehl entspricht dem Auschecken der Dateien - von einem CVSup-Server mit - csup. Danach haben Sie ein - Bau-Verzeichis analog zur - csup-Methode. - - cvsup erlaubt es Ihnen auch, Ihr - CVS-Repository regelmäßig - zu aktualisieren. Im Gegensatz zum ersten Aufruf dauern diese - Aktualisierungen in der Regel nur wenige Minuten. - Die Webseiten bauen - Nachdem Sie eine der beiden Methoden erfolgreich - ausgeführt haben, können Sie mit dem Bau der Webseiten + 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 /usr/build, @@ -297,11 +128,12 @@ cvsroot-doc Sie starten den Bau der Webseiten, indem Sie in das - Unterverzeichnis www/en + Unterverzeichnis en_US.ISO8859-1/htdocs wechseln und dort den Befehl &man.make.1; all ausführen. - &prompt.root; cd www/en + &prompt.root; cd en_US.ISO8859-1/htdocs &prompt.root; make all @@ -313,10 +145,10 @@ cvsroot-doc Wechseln Sie wieder in das Verzeichnis - en, falls Sie dieses - inzwischen verlassen haben. + en_US.ISO8859-1/htdocs, + falls Sie dieses inzwischen verlassen haben. - &prompt.root; cd /usr/build/www/en + &prompt.root; cd /usr/build/en_US.ISO8859-1/htdocs @@ -348,27 +180,6 @@ cvsroot-doc Umgebungsvariablen - - CVSROOT - - - Der Ort des CVS-Baums. Sie sollten diese Variable - setzen, wenn Sie die - CVSup-Methode verwenden. - - &prompt.root; CVSROOT=/usr/dcvs; export CVSROOT - - CVSROOT ist eine Umgebungsvariable. Sie - müssen sie daher auf der Kommandozeile oder in Ihren - .dot-Dateien (beispielsweise in - ~/.profile) setzen. Die genaue - Syntax hängt von der von Ihnen eingesetzten Shell - (das letzte Beispiel gilt nur für die - bash und bash-ähnliche - Shells) ab. - - - ENGLISH_ONLY @@ -395,9 +206,10 @@ cvsroot-doc Ist diese Variable gesetzt und nicht leer, bauen und installieren die Makefiles nur die HTML-Seiten des - Verzeichnisses www. - Alle Dokumente des - doc-Verzeichnisses + Verzeichnisses en_US.ISO8859-1/htdocs. + Alle Dokumente des Verzeichnisses + en_US.ISO8859-1 (Handbuch, FAQ, Artikel) werden dabei ignoriert: &prompt.root; make WEB_ONLY=YES all install @@ -411,11 +223,12 @@ cvsroot-doc Ist diese Variable gesetzt, wird die Dokumentation nur für die durch diese Variable festgelegten Sprachen gebaut und im Verzeichnis - www installiert. - Alle weiteren Sprachen (ausgenommen Englisch) werden + /usr/build + installiert. Alle weiteren Sprachen (ausgenommen Englisch) werden ignoriert. Dazu ein Beispiel: - &prompt.root; make WEB_LANG="el es hu nl" all install + &prompt.root; make WEB_LANG="el_GR.ISO8859-7 es_ES.ISO8859-1 hu_HU.ISO8859-2 nl_NL.ISO8859-1" all install