Index: head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml =================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml (revision 46801) +++ head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml (revision 46802) @@ -1,252 +1,161 @@ Die Webseite JohannKoisÜbersetzt von - - - - Vorbereitung - - 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. - - - 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: - - &prompt.root; pkg_delete jade-1.1 - - - - <command>svn</command> verwenden - - 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: - - &prompt.root; cd /usr/ports/devel/subversion -&prompt.root; make install clean - - Um alle zum Bau der Webseite benötigten Quellen - auszuchecken, führen Sie den folgenden Befehl aus: - -&prompt.root; svn checkout https://svn0.us- -east.FreeBSD.org/doc/head/ /usr/build - - svn0.us-east.FreeBSD.org - ist ein öffentlicher Server. Wählen Sie einen Mirror in Ihrer - Nähe und überprüfen Sie das Serverzertifikat aus der Liste - Subversion - mirror sites. - - - 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. - - - 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 Webseiten bauen 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, + ~/doc, in dem sich bereits alle benötigten Dateien befinden. - - - Wechseln Sie in das Bau-Verzeichis. + Sie starten den Bau der Webseiten, indem Sie in das + Unterverzeichnis en_US.ISO8859-1/htdocs + des Dokumentationsbaums (in unserem Beispiel also unter + ~/doc) wechseln und dort den Befehl + make all ausführen. - &prompt.root; cd /usr/build - + &prompt.user; cd ~/doc/en_US.ISO8859-1/htdocs +&prompt.user; make all - - Sie starten den Bau der Webseiten, indem Sie in das - Unterverzeichnis en_US.ISO8859-1/htdocs - wechseln und dort den Befehl - &man.make.1; all ausführen. - - &prompt.root; cd en_US.ISO8859-1/htdocs -&prompt.root; make all - - + + Der Bau der Webseiten erfordert die Datei INDEX + der Ports-Sammlung und schlägt fehl, wenn + /usr/ports nicht existiert. Der einfachste + Weg, dies zu vermeiden, ist die Installatin der Ports-Sammlung. + Installieren der Webseiten auf Ihrem Server - - - Wechseln Sie wieder in das Verzeichnis - en_US.ISO8859-1/htdocs, - falls Sie dieses inzwischen verlassen haben. + Führen Sie make install aus und setzen Sie + die Variable DESTDIR auf das Verzeichnis, in das + Sie die Webseiten installieren wollen. Die daraus resultierenden + Dateien werden unter $DESTDIR/data installiert, + was als die document root ihres Webservers konfiguriert sein + sollte. - &prompt.root; cd /usr/build/en_US.ISO8859-1/htdocs - + Die Installation der Webseiten wird als + root ausgeführt, weil die + Berechtigungen des Webserver-Verzeichnisses den Schreibzugriff für + normale Benutzer verhindern. Im folgenden Beispiel wurden die + Webseiten durch den Benutzer jru in dessen Heimatverzeichnis, + also unter /usr/home/jru/doc gebaut. - - Führen Sie &man.make.1; install - aus und setzen Sie die Variable DESTDIR auf - das Verzeichnis, in das Sie die Webseiten installieren - wollen. Die daraus resultierenden Dateien werden unter $DESTDIR/data installiert, was als die - document root ihres Webservers konfiguriert sein sollte. + &prompt.root; cd /home/jru/doc/en_US.ISO8859-1/htdocs +&prompt.root; env DESTDIR=/usr/local/www make install - &prompt.root; env DESTDIR=/usr/local/www make install - + 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: - - 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: - - &prompt.root; find /usr/local/www -ctime 3 -print0 | xargs -0 rm - - + &prompt.root; find /usr/local/www -ctime 3 -delete Umgebungsvariablen ENGLISH_ONLY Ist diese Variable gesetzt und nicht leer, bauen und installieren die Makefiles ausschließlich die englischen Dokumente. Sämtliche Übersetzungen werden dabei ignoriert. Dazu ein Beispiel: &prompt.root; make ENGLISH_ONLY=YES all install Wenn Sie die Variable ENGLISH_ONLY deaktivieren und alle Webseiten inklusive aller Übersetzungen bauen wollen, setzen Sie die Variable ENGLISH_ONLY auf einen leeren Wert: &prompt.root; make ENGLISH_ONLY="" all install clean WEB_ONLY Ist diese Variable gesetzt und nicht leer, bauen und - installieren die Makefiles nur die HTML-Seiten des + installieren die Makefiles nur die + HTML-Seiten des Verzeichnisses en_US.ISO8859-1/htdocs. - Alle Dokumente des Verzeichnisses + Alle anderen Dokumente des Verzeichnisses en_US.ISO8859-1 - (Handbuch, FAQ, Artikel) werden dabei ignoriert: + (wie Handbuch, FAQ, Artikel) werden dabei ignoriert: &prompt.root; make WEB_ONLY=YES all install WEB_LANG Ist diese Variable gesetzt, wird die Dokumentation nur für die durch diese Variable festgelegten Sprachen gebaut und im Verzeichnis - /usr/build - installiert. Alle weiteren Sprachen (ausgenommen Englisch) werden - ignoriert. Dazu ein Beispiel: + ~/doc + gebaut und danach installiert. Alle weiteren Sprachen + (ausgenommen Englisch) werden ignoriert. Dazu ein Beispiel: &prompt.root; make WEB_LANG="el_GR.ISO8859-7 es_ES.ISO8859-1 hu_HU.ISO8859-2 nl_NL.ISO8859-1" all install - - - NOPORTSCVS - - - Ist diese Variable gesetzt, checken die Makefiles keine - Dateien aus dem Ports-CVS-Repository aus. Stattdessen werden - die Dateien aus dem Verzeichnis - /usr/ports - (oder aus dem Verzeichnis, auf das die Variable - PORTSBASE zeigt) verwendet. - - WEB_ONLY, ENGLISH_ONLY, WEB_LANG und NOPORTSCVS - sind Variablen für Makefiles. + sind Variablen für &man.make.1;. Diese werden entweder in /etc/make.conf, in Makefile.inc oder als Umgebungsvariablen auf der Kommandozeile oder in Ihrer Konfigurationsdatei gesetzt.