From owner-svn-doc-all@FreeBSD.ORG Wed Jun 10 16:59:28 2015 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 34A0C443; Wed, 10 Jun 2015 16:59:28 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::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 161991E2E; Wed, 10 Jun 2015 16:59:28 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t5AGxRYX032537; Wed, 10 Jun 2015 16:59:27 GMT (envelope-from jkois@FreeBSD.org) Received: (from jkois@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t5AGxRUB032536; Wed, 10 Jun 2015 16:59:27 GMT (envelope-from jkois@FreeBSD.org) Message-Id: <201506101659.t5AGxRUB032536@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: jkois set sender to jkois@FreeBSD.org using -f From: Johann Kois Date: Wed, 10 Jun 2015 16:59:27 +0000 (UTC) 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 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.20 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: Wed, 10 Jun 2015 16:59:28 -0000 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 --> Die Webseite @@ -39,139 +39,60 @@ - - - - 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. - - &prompt.root; cd /usr/build - - - - 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 - - + 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.user; cd ~/doc/en_US.ISO8859-1/htdocs +&prompt.user; 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. - - &prompt.root; cd /usr/build/en_US.ISO8859-1/htdocs - - - - 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; env DESTDIR=/usr/local/www make install - - - - 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 - - + 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 @@ -203,11 +124,12 @@ east.FreeBSD.org/doc/head/ /usr/build 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 @@ -220,31 +142,18 @@ east.FreeBSD.org/doc/head/ /usr/buildIst 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.