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 53576) +++ head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml (revision 53577) @@ -1,293 +1,293 @@ Die Webseite JohannKoisÜbersetzt von Die &os; Webseite ist Teil der &os;-Dokumentation. Die Dateien der englischen Webseite befinden sich im Unterverzeichnis en_US.ISO8859-1/htdocs des Dokumentationsbaum (in diesem Beispiel unter ~/doc). Umgebungsvariablen Sie haben die Möglichkeit, über Umgebungsvariablen festzulegen, welchen Teil der Webseite Sie bauen wollen und in welches Verzeichnis Sie die fertige Webseite installieren wollen. Beim Bau der Webseiten (durch &man.make.1;) wird angenommen, dass definierte Variablen gesetzt sind (dies gilt auch dann, wenn die Variable leer ist!). Die folgenden Beispiele zeigen die empfohlene Definition und Nutzung der möglichen Variablen. Wenn Sie diese Variablen auf andere Werte oder Methoden setzen, kann es zu überraschenden Ergebnissen kommen. - - DESTDIR + + DOCDIR - DESTDIR legt fest, in welches Verzeichnis die fertig + DOCDIR legt fest, in welches Verzeichnis die fertig gebaute Webseite installiert werden soll. Diese Variable wird am besten durch &man.env.1; oder durch die Shell-eigene Methode zum setzen von Variablen, also setenv für &man.csh.1; oder export für &man.sh.1;. ENGLISH_ONLY Default: Nicht definiert. Baue die Webseite inklusive aller Übersetzungen. ENGLISH_ONLY=yes: Baue nur die englischen Dokumente und ignoriere alle Übersetzungen. WEB_ONLY Default: Nicht definiert. Baue sowohl die Webseite als auch alle Bücher und Artikel. WEB_ONLY=yes: Baue oder installiere nur die HTML-Seiten im Verzeichis en_US.ISO8859-1/htdocs. Ignoriere alle anderen Verzeichnisse und Dokumente, Bücher und Artikel. WEB_LANG Default: Nicht definiert. Baue die Webseite in allen verfügbaren Sprachen. Geben Sie die Sprachen (durch Leerzeichen getrennt) an, in denen Sie die Webseite bauen und/oder installieren wollen. Die Namen der zu bauenden Sprachen entsprechen dabei den Namen der Dokumentwurzelverzeichnisse. Wollen Sie beispielsweise die deutschen und französischen Dokumente einschließen: WEB_LANG="de_DE.ISO8859-1 fr_FR.ISO8859-1" WEB_ONLY, WEB_LANG und ENGLISH_ONLY 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. Die Webseiten bauen Nachdem Sie die Quellen der Webseite erfolgreich heruntergeladen haben, können Sie mit dem Bau der Webseite beginnen. Die Installation der Webseiten wird als root ausgeführt, weil die Berechtigungen des Webserver-Verzeichnisses den Schreibzugriff für normale Benutzer verhindern. Zu Testzwecken können die Dateien auch als normaler Benutzer in ein temporäres Verzeichnis installiert werden. In den folgenden Beispielen werden die Webseiten durch den Benutzer jru in dessen Heimatverzeichnis, also unter /usr/home/jru/doc, gebaut. 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 Installation der Ports-Sammlung. Die komplette Webseite und alle Dokumente bauen Bauen Sie die Webseite und alle Dokumente. Die erzeugten Dateien verbleiben dabei im Dokumentationsbaum: &prompt.user; cd ~/doc/en_US.ISO8859-1/htdocs/ &prompt.user; make all Nur die englische Webseite bauen Bauen Sie nur die englische Webseite als Benutzer jru und installieren Sie die erzeugten Dateien nach /tmp/www, um die Webseite testen zu können: &prompt.user; cd ~/doc/en_US.ISO8859-1/htdocs/ -&prompt.user; env DESTDIR=/tmp/www make ENGLISH_ONLY=yes WEB_ONLY=yes all install +&prompt.user; env DOCDIR=/tmp/www make ENGLISH_ONLY=yes WEB_ONLY=yes all install Änderungen an statischen Dateien können Sie einfach testen, indem Sie die geänderten Dateien in Ihrem Webbrowser aufrufen. Haben Sie Seite wie eben gezeigt gebaut, können Sie sich die geänderte Startseite ganz einfach anzeigen lassen: &prompt.user; firefox /tmp/www/data/index.html Änderungen an dynamischen Dateien können allerdings nur auf einem Webserver (der auf dem lokalen System läuft) getestet werden. Nachdem Sie die Website wie weiter oben gezeigt gebaut haben, können Sie www/apache24 mit folgender Konfigurationsdatei /usr/local/etc/apache24/httpd.conf starten und Ihre Änderungen testen: # httpd.conf for testing the FreeBSD website Define TestRoot "/tmp/www/data" # directory for configuration files ServerRoot "/usr/local" Listen 80 # minimum required modules LoadModule authz_core_module libexec/apache24/mod_authz_core.so LoadModule mime_module libexec/apache24/mod_mime.so LoadModule unixd_module libexec/apache24/mod_unixd.so LoadModule cgi_module libexec/apache24/mod_cgi.so LoadModule dir_module libexec/apache24/mod_dir.so # run the webserver as user and group User www Group www ServerAdmin you@example.com ServerName fbsdtest # deny access to all files <Directory /> AllowOverride none Require all denied </Directory> # allow access to the website directory DocumentRoot "${TestRoot}" <Directory "${TestRoot}"> Options Indexes FollowSymLinks AllowOverride None Require all granted </Directory> # prevent access to .htaccess and .htpasswd files <Files ".ht*"> Require all denied </Files> ErrorLog "/var/log/httpd-error.log" LogLevel warn # set up the CGI script directory <Directory "${TestRoot}/cgi"> AllowOverride None Options None Require all granted Options +ExecCGI AddHandler cgi-script .cgi </Directory> Include etc/apache24/Includes/*.conf Starten Sie den Webserver wie folgt: &prompt.root; service apache24 onestart Die Webseite ist danach unter der Adresse erreichbar. Beachten Sie aber, dass viele Links auf die echte &os;-Webseite zeigen. Daher werden diese Links die externe Seite aufrufen und nicht Ihre lokale Testversion. Um dies zu verhindern und einen kompletten lokalen Test Ihrer lokalen Seite durchzuführen, müssen Sie DNS temporär umkonfigurieren, damit www.FreeBSD.org als localhost oder als Ihre lokale IP-Adresse aufgelöst wird. Die Webseite bauen und installieren Bauen Sie die Webseite und alle Dokumente als Benutzer jru. Installieren Sie die erzeugten Dateien als root in das Standardverzeichnis, also nach /root/public_html: &prompt.user; cd ~/doc/en_US.ISO8859-1/htdocs &prompt.user; make all &prompt.user; su - Password: &prompt.root; cd /usr/home/jru/doc/en_US.ISO8859-1/htdocs &prompt.root; 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: &prompt.root; find /usr/local/www -ctime 3 -delete