svn commit: r46802 - head/de_DE.ISO8859-1/books/fdp-primer/the-website
Johann Kois <[email protected]>
| Newsgroups | gmane.os.freebsd.devel.cvs.doc |
|---|---|
| Message-ID | <[email protected]> |
Author: jkois
Date: Wed Jun 10 16:59:27 2015
New Revision: 46802
URL: https://svnweb.freebsd.org/changeset/doc/46802
Log:
r41125 -> r43126
MFde: Resync the chapter "the website" of the fdp-primer
Obtained from: The FreeBSD German Documentation Project
Modified:
head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml
Modified: head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml
==============================================================================
--- head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml Wed Jun 10 16:21:47 2015 (r46801)
+++ head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml Wed Jun 10 16:59:27 2015 (r46802)
@@ -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 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>
-
- <screen>&prompt.root; <userinput>cd /usr/build</userinput></screen>
- </step>
-
- <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>
+ <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.user; <userinput>cd ~/doc/en_US.ISO8859-1/htdocs</userinput>
+&prompt.user; <userinput>make all</userinput></screen>
+
+ <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>
-
- <screen>&prompt.root; <userinput>cd /usr/build/en_US.ISO8859-1/htdocs</userinput></screen>
- </step>
-
- <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>env DESTDIR=/usr/local/www make install</userinput></screen>
- </step>
-
- <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>
+ <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>
+
+ <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>
+
+ <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>
+
+ <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>
+
+ <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</u
<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</u
<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>
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"