r38826 -> 38876 Update the build instructions for SVN.
This commit is contained in:
Johann Kois
parent
55c3faca6f
commit
09cc69c5c5
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=38900
1 changed files with 47 additions and 234 deletions
|
|
@ -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>
|
||||
<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>
|
||||
|
||||
<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>
|
||||
<screen>&prompt.root; <userinput><command>cd /usr/ports/devel/subversion</command></userinput>
|
||||
&prompt.root; <userinput><command>make</command> <maketarget>install clean</maketarget></userinput></screen>
|
||||
|
||||
<sect2 id="the-website-csup">
|
||||
<title>Die einfache Methode: <command>csup</command>
|
||||
verwenden</title>
|
||||
<para>Um alle zum Bau der Webseite benötigten Quellen
|
||||
auszuchecken, führen Sie den folgenden Befehl aus:</para>
|
||||
|
||||
<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>
|
||||
<screen>&prompt.root; <userinput><command>svn checkout svn://svn.FreeBSD.org/doc/head/ <replaceable>/usr/build</replaceable></command></userinput></screen>
|
||||
|
||||
<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.
|
||||
<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>
|
||||
|
||||
*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>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>
|
||||
|
|
@ -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ü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>
|
||||
|
||||
|
|
@ -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>
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue