os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

r41125 -> r43126

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

Obtained from:	The FreeBSD German Documentation Project
This commit is contained in:
Johann Kois 2015-06-10 16:59:27 +00:00
parent bacf5ab5b3
commit 0caa36bdf9
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=46802
1 changed files with 44 additions and 135 deletions
Download patch file Download diff file Expand all files Collapse all files

179
de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml
View file

@ -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>
<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.root; <userinput>cd /usr/build</userinput></screen>
</step>
<screen>&prompt.user; <userinput>cd ~/doc/en_US.ISO8859-1/htdocs</userinput>
&prompt.user; <userinput>make all</userinput></screen>
<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>
<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>
<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>
<screen>&prompt.root; <userinput>cd /usr/build/en_US.ISO8859-1/htdocs</userinput></screen>
</step>
<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>
<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>cd /home/jru/doc/en_US.ISO8859-1/htdocs</userinput>
&prompt.root; <userinput>env DESTDIR=<replaceable>/usr/local/www</replaceable> make install</userinput></screen>
<screen>&prompt.root; <userinput>env DESTDIR=/usr/local/www make install</userinput></screen>
</step>
<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>
<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>
<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>