From owner-svn-doc-all@freebsd.org Mon Feb 13 21:03:06 2017 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id A52F6CDD162; Mon, 13 Feb 2017 21:03:06 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 6DC331A6E; Mon, 13 Feb 2017 21:03:06 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v1DL35EO050239; Mon, 13 Feb 2017 21:03:05 GMT (envelope-from jkois@FreeBSD.org) Received: (from jkois@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v1DL35ju050237; Mon, 13 Feb 2017 21:03:05 GMT (envelope-from jkois@FreeBSD.org) Message-Id: <201702132103.v1DL35ju050237@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: jkois set sender to jkois@FreeBSD.org using -f From: Johann Kois Date: Mon, 13 Feb 2017 21:03:05 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r49985 - in head/de_DE.ISO8859-1/books/fdp-primer: . the-website X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 13 Feb 2017 21:03:06 -0000 Author: jkois Date: Mon Feb 13 21:03:05 2017 New Revision: 49985 URL: https://svnweb.freebsd.org/changeset/doc/49985 Log: MFde: - Resync the FDP primer chapter "the-website". - Update FreeBSDde copyright for 2017 Modified: head/de_DE.ISO8859-1/books/fdp-primer/book.xml head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml Modified: head/de_DE.ISO8859-1/books/fdp-primer/book.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/book.xml Mon Feb 13 19:44:18 2017 (r49984) +++ head/de_DE.ISO8859-1/books/fdp-primer/book.xml Mon Feb 13 21:03:05 2017 (r49985) @@ -49,7 +49,7 @@ - 1998-2016 + 1998-2017 The FreeBSD German Documentation Project 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 Mon Feb 13 19:44:18 2017 (r49984) +++ head/de_DE.ISO8859-1/books/fdp-primer/the-website/chapter.xml Mon Feb 13 21:03:05 2017 (r49985) @@ -30,7 +30,7 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r43126 + basiert auf: r49811 --> Die Webseite @@ -39,122 +39,255 @@ - - Die Webseiten bauen + 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). - 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 - ~/doc, - in dem sich bereits alle benötigten Dateien befinden. - - 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. + + Umgebungsvariablen - &prompt.user; cd ~/doc/en_US.ISO8859-1/htdocs -&prompt.user; make all + 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. - 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. + 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. - - - Installieren der Webseiten auf Ihrem Server - - 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. - - 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. - - &prompt.root; cd /home/jru/doc/en_US.ISO8859-1/htdocs -&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: - - &prompt.root; find /usr/local/www -ctime 3 -delete - + + + DESTDIR - - Umgebungsvariablen + + DESTDIR 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 - 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: + Default: Nicht definiert. Baue die Webseite inklusive + aller Übersetzungen. - &prompt.root; make ENGLISH_ONLY="" all install clean + ENGLISH_ONLY=yes: Baue nur die + englischen Dokumente und ignoriere alle Übersetzungen. - + WEB_ONLY - Ist diese Variable gesetzt und nicht leer, bauen und - installieren die Makefiles nur die - HTML-Seiten des - Verzeichnisses en_US.ISO8859-1/htdocs. - Alle anderen Dokumente des Verzeichnisses - en_US.ISO8859-1 - (wie Handbuch, FAQ, Artikel) werden dabei ignoriert: + Default: Nicht definiert. Baue sowohl die Webseite als + auch alle Bücher und Artikel. - &prompt.root; make WEB_ONLY=YES all install + 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 - Ist diese Variable gesetzt, wird die Dokumentation nur - für die durch diese Variable festgelegten Sprachen - gebaut und im Verzeichnis - ~/doc - gebaut und danach installiert. Alle weiteren Sprachen - (ausgenommen Englisch) werden ignoriert. Dazu ein Beispiel: + 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: - &prompt.root; make WEB_LANG="el_GR.ISO8859-7 es_ES.ISO8859-1 hu_HU.ISO8859-2 nl_NL.ISO8859-1" all install + WEB_LANG="de_DE.ISO8859-1 fr_FR.ISO8859-1" - - WEB_ONLY, ENGLISH_ONLY, - WEB_LANG sind Variablen für &man.make.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 + + Ä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