Date: Wed, 10 Jun 2015 16:59:27 +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: r46802 - head/de_DE.ISO8859-1/books/fdp-primer/the-website Message-ID: <201506101659.t5AGxRUB032536@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201506101659.t5AGxRUB032536>