Index: head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml =================================================================== --- head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml +++ head/de_DE.ISO8859-1/books/handbook/cutting-edge/chapter.xml @@ -5,7 +5,7 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r44504 + basiert auf: r44673 --> &os; aktualisieren @@ -742,125 +742,86 @@ Dokumentation ein wichtiger Bestandteil des &os; Betriebssystems. Obwohl eine aktuelle Version der &os; - Dokumentation jederzeit auf der &os; Webseite - verfügbar ist, verfügen manche Benutzer nur über eine langsame - oder überhaupt keine Netzwerkverbindung. Es gibt mehrere - Möglichkeiten, die lokale Kopie der Dokumentation durch die - aktuelle &os;-Dokumentationssammlung zu aktualisieren. - - - Verwenden von <application>Subversion</application> um - die Dokumentation zu aktualisieren - - Die Dokumentationsquellen von &os; können mittels - svn aktualisiert werden. Dieser - Abschnitt beschreibt: + Dokumentation jederzeit auf der &os; Webseite ( + http://www.freebsd.org/doc/) verfügbar ist, kann es + nützlich sein, eine lokale Kopie der &os; Webseite, Handbücher, + FAQ und Artikel zu haben. + + Dieser Abschnitt beschreibt, wie Sie die &os; Dokumentation + über die Quellen oder die &os; Ports-Sammlung aktuell + halten. + + Informationen zum Bearbeiten und Einreichen von Korrekturen + finden Sie in der Fibel für + neue Mitarbeiter des + &os;-Dokumentationsprojekts. - - - Die Installation der Dokumentations-Werkzeugsammlung, - welche die Werkzeuge enthält, die nötig sind, um die &os; - Dokumentation aus den Quellen neu zu erstellen. - + + Die &os;-Dokumentation aus den Quellen + installieren - - Das Herunterladen einer Kopie der - Dokumentationsquellen nach /usr/doc, - unter Verwendung von - svn. - + Der Bau der &os; Dokumentation aus den Quellen erfordert + einige Werkzeuge, die nicht Teil des Basissystems sind. Die + erforderlichen Werkzeuge, darunter auch + svn, können über den Port oder das + Paket textproc/docproj installiert + werden. - - Den Bau der &os; Dokumentation aus den Quellen und - die Installation unter - /usr/share/doc. - + Benutzen Sie nach der Installation + svn, um eine saubere Kopie der + Dokumentationsquellen zu holen: + + &prompt.root; svn checkout https://svn.FreeBSD.org/doc/head /usr/doc + + Es dauert eine Weile, bis die Quellen das allererste Mal + heruntergeladen werden. Lassen Sie den Vorgang laufen, bis es + fertig ist. - - Manche der Optionen zum Erstellen, die vom System zum - Bauen der Dokumentation unterstützt werden, z.B. die - Optionen welche nur ein paar der unterschiedlichen - Sprachübersetzungen der Dokumentation erstellen oder die - Optionen, die ein bestimmtes Ausgabeformat - auswählen. - - - - - - <application>svn</application> und die Werkzeugsammlung - der Dokumentation installieren - - Die Erstellung der &os; Dokumentation aus den Quellen - benötigt eine große Anzahl an Werkzeugen, die nicht Teil des - &os; Basissystems sind, da sie eine große Menge - Plattenplatz verbrauchen und nicht von allen &os;-Anwendern - benötigt werden. Sie sind daher nur für diejenigen Benutzer - sinnvoll, die aktiv neue Dokumentation für &os; schreiben - oder häufig die Dokumentation aus den Quellen - aktualisieren. - - Alle benötigten Werkzeuge, einschließlich - svn sind im Meta-Port - textproc/docproj vorhanden, der - vom &os; Documentation Project entwickelt wurde. + Zukünftige Aktualisierungen der Dokumentationsquellen + können wie folgt durchgeführt werden: - - Wenn Sie die Dokumentation nicht als &postscript; oder PDF - benötigen, können Sie alternativ die Installation des - textproc/docproj-nojadetex-Ports - in Erwägung ziehen. Diese Version der - Dokumentations-Werkzeugsammlung enthält alles ausser das - teTeX-Textsatzsystem. - teTeX ist eine sehr grosse Sammlung an - Werkzeugen, deshalb ist es vernünftig, deren Installation - auszulassen, wenn die Ausgabe von PDF nicht unbedingt gebraucht - wird. - - + &prompt.root; svn update /usr/doc - - Die Dokumentationsquellen aktualisieren + Sobald ein aktueller Schnappschuss der + Dokumentationsquellen nach /usr/doc + heruntergeladen wurde, ist alles bereit für eine + Aktualisierung der bestehenden Dokumentation. - In diesem Beispiel wird svn - verwendet, um eine saubere Kopie der Dokumentationsquellen - über das HTTPS-Protokoll zu holen: + Eine komplette Aktualisierung aller Sprachen kann durch + folgende Eingabe erreicht werden: - &prompt.root; svn checkout https://svn.freebsd.org/doc/head/doc/head /usr/doc + &prompt.root; cd /usr/doc +&prompt.root; make install clean - Benutzen Sie dazu einen der Spiegel aus Subversion Mirror Sites. + Wenn nur eine Aktualisierung einer bestimmten Sprache + gewünscht wird, kann make in einem + sprachspezifischen Unterverzeichnis von + /usr/doc aufgerufen werden: - Es dauert eine Weile, wenn die Dokumentationsquellen das allererste - Mal heruntergeladen werden. Lassen Sie es laufen, bis es fertig - ist. + &prompt.root; cd /usr/doc/en_US.ISO8859-1 +&prompt.root; make install clean - Zukünftige Aktualisierungen der Dokumentationsquellen - können wie folgt durchgeführt werden: + Alternativ kann der folgende Befehl in + /usr/doc oder einem sprachspezifischen + Unterverzeichnis abgesetzt werden, um die Dokumentation zu + aktualisieren: - &prompt.root; svn update /usr/doc + &prompt.root; make update - Nachdem die Quellen einmal ausgecheckt wurden, wird durch - /usr/doc/Makefile ein alternativer Weg - unterstützt, die Dokumentation zu aktualisieren. Geben Sie - dazu die folgenden Befehle ein: + Die zu installierenden Ausgabeformate können durch das + Setzen von FORMATS angegeben werden: &prompt.root; cd /usr/doc -&prompt.root; make update - - - - Einstellbare Optionen der Dokumentationsquellen +&prompt.root; make FORMATS='html html-split' install clean - Das System zum aktualisieren und erstellen der - &os;-Dokumentationssammlung unterstützt ein paar Optionen, - welche den Prozess der Aktualisierung von Teilen der - Dokumentation oder einer bestimmten Übersetzung erleichtert. - Diese Optionen können entweder systemweit in - /etc/make.conf gesetzt, oder als - Kommandozeilenoptionen an &man.make.1; übergeben - werden. + Es existieren ein paar Optionen, welche den Prozess der + Aktualisierung von Teilen der Dokumentation oder einer + bestimmten Übersetzung erleichtern. Diese Optionen können + entweder systemweit in /etc/make.conf + gesetzt, oder als Kommandozeilenoptionen an + make übergeben werden. Zu den Optionen gehören: @@ -880,11 +841,12 @@ FORMATS - Ein einzelnes Format oder eine Liste von Ausgabeformaten, das - gebaut werden soll. Momentan werden html, + Ein einzelnes Format oder eine Liste von + Ausgabeformaten, das gebaut werden soll. Momentan + werden html, html-split, txt, - ps, pdf, - und rtf unterstützt. + ps und pdf + unterstützt. @@ -901,54 +863,12 @@ Für weitere make-Variablen, die als systemweite Optionen in &os; unterstützt werden, lesen Sie &man.make.conf.5;. - - Für weitere make-Variablen, die vom - System zum Erstellen der &os;-Dokumentation unterstützt - werden, lesen Sie die Fibel für - neue Mitarbeiter - des &os;-Dokumentationsprojekts. - - Die &os;-Dokumentation aus den Quellen - installieren - - Sobald ein aktueller Schnappschuss der - Dokumentationsquellen nach /usr/doc - heruntergeladen wurde, ist alles bereit für eine - Aktualisierung der bestehenden Dokumentation. - - Eine komplette Aktualisierung aller Sprachen, definiert in - DOC_LANG, kann durch folgende Eingabe - erreicht werden: - - &prompt.root; cd /usr/doc -&prompt.root; make install clean - - Wenn nur eine Aktualisierung einer bestimmten Sprache - gewünscht wird, kann &man.make.1; in einem sprachspezifischen - Unterverzeichnis von /usr/doc - aufgerufen werden: - - &prompt.root; cd /usr/doc/en_US.ISO8859-1 -&prompt.root; make update install clean - - Die zu installierenden Ausgabeformate können durch das - Setzen von FORMATS angegeben werden: - - &prompt.root; cd /usr/doc -&prompt.root; make FORMATS='html html-split' install clean - - Informationen zum Bearbeiten und Einreichen von - Korrekturen finden Sie in der Fibel für - neue Mitarbeiter des - &os;-Dokumentationsprojekts. - + + + Die Dokumentation aus den Ports aktualisieren - - Verwendung von Dokumentations-Ports MarcFonvieilleBasierend auf der Arbeit von @@ -963,181 +883,61 @@ Im vorherigen Abschnitt wurde eine Methode gezeigt, wie die &os;-Dokumentation aus den Quellen gebaut werden kann. - Allerdings sind quellbasierte Aktualisierungen möglicherweise - nicht für alle &os;-Systeme geeignet oder praktikabel. Das - Erstellen der Dokumentationsquellen benötigt eine große Anzahl - an Werkzeugen, Programmen und Hilfsmitteln, die - documentation toolchain, einen gewissen - Grad an Vertrautheit mit svn, - ausgecheckte Quellen von einem Repository, sowie ein paar - manuelle Schritte, um diese ausgecheckten Quellen zu bauen. Dieser Abschnitt beschreibt eine alternative Methode, in der die Ports-Sammlung verwendet wird und die es ermöglicht: - vorgefertigte Schnappschüsse der Dokumentation - herunterzuladen und zu installieren, ohne vorher die - Werkzeugsammlung der Dokumentation installieren zu - müssen. + vorgefertigte Schnappschüsse der Dokumentation zu + installieren, ohne vorher die Werkzeugsammlung der + Dokumentation installieren zu müssen. - die Dokumentationsquellen herunterzuladen und durch - das Ports-System erstellen zu lassen, was die Schritte zum - Auschecken und Erstellen etwas erleichtert. + die Dokumentationsquellen durch das Ports-System + erstellen zu lassen, was die Schritte zum Auschecken und + Erstellen etwas erleichtert. - Diese beiden Methoden der Aktualisierung der + Diese Methoden der Aktualisierung der &os;-Dokumentation werden durch eine Menge von - Dokumentations-Ports unterstützt, die von + Dokumentations-Ports und Paketen unterstützt, die von &a.doceng; monatlich aktualisiert wird. Diese sind in der - &os; Ports-Sammlung unter der Kategorie docs gelistet - (http://www.freshports.org/docs/). - - - Erstellen und Installieren von Dokumentations-Ports - - Die Dokumentations-Ports nutzen das Ports-System, um das - Erstellen von Dokumentation wesentlich einfacher zu machen. Es - automatisiert den Prozess des Auscheckens der Dokumentationsquellen, - aufrufen von &man.make.1; mit den passenden Umgebungsvariablen und - Kommandozeilenoptionen und macht die Installation und Deinstallation - von Dokumentation so einfach wie die Installation von jedem anderen - Port oder Paket. - - - Als zusätzliche Eigenschaft zeichnen sie eine - Abhängigkeit zur - Dokumentations-Werkzeugsammlung auf, - wenn die Dokumentations-Ports lokal erstellt werden, - weshalb diese auch automatisch mitinstalliert wird. - + &os; Ports-Sammlung unter der Kategorie docs + gelistet ( + http://www.freshports.org/docs/). Die Dokumentations-Ports sind wie folgt organisiert: - Der Master-Port, - misc/freebsd-doc-en, der alle - englischen Dokumentations-Ports installiert. + Das Paket oder der Port + misc/freebsd-doc-en installiert die + englische Dokumentation. - Der Alles-in-Einem-Port, - misc/freebsd-doc-all, welcher die - komplette Dokumentation in allen verfügbaren Sprachen - erstellt und installiert. + Das Paket oder der Port + misc/freebsd-doc-all installiert die + komplette Dokumentation in allen verfügbaren + Sprachen. - Es gibt noch einen Slave-Port für - jede Übersetzung, beispielsweise - misc/freebsd-doc-hu für Dokumentation - in ungarischer Sprache. + Es gibt noch ein Paket oder einen Port für jede + Übersetzung, beispielsweise + misc/freebsd-doc-hu für die + ungarische Dokumentation. - Um die englische Dokumentation zu bauen im getrennten - HTML-Format in - /usr/local/share/doc/freebsd zu - installieren, installieren Sie den folgenden Port: - - &prompt.root; cd /usr/ports/misc/freebsd-doc-en -&prompt.root; make install clean - - - Gebräuchliche Schalter und Optionen - - Es gibt viele Optionen, die das Standardverhalten der - Dokumentations-Ports verändern. Dazu gehören: - - - - WITH_HTML - - - Erstellt das HTML-Format mit einer einzigen - HTML-Datei pro Dokument. Die formatierte - Dokumentation wird als Datei mit dem Namen - article.html, oder - gegebenenfalls book.html, - zuzüglich der Bilder gespeichert. - - - - - WITH_PDF - - - Erstellt das &adobe; Portable Document Format - (PDF). Die formatierte Dokumentation wird als Datei - mit dem Namen article.pdf, oder - gegebenenfalls als book.pdf - gespeichert. - - - - - DOCBASE - - - Legt den Pfad fest, wohin die Dokumentation - installiert werden soll. Die Voreinstellung ist - /usr/local/share/doc/freebsd. - - - Der Standardpfad zum Verzeichnis unterscheidet - sich von dem Verzeichnis, das von - svn verwendet wird. - Das liegt daran, dass Ports üblicherweise in - /usr/local installiert - werden. Dies kann durch die Verwendung von - PREFIX überschrieben - werden. - - - - - - Dieses Beispiel verwendet Variablen, um die ungarische - Dokumentation als PDF zu installieren: - - &prompt.root; cd /usr/ports/misc/freebsd-doc-hu -&prompt.root; make -DWITH_PDF DOCBASE=share/doc/freebsd/hu install clean - - - - - Verwendung von Dokumentations-Paketen - - Das Erstellen der Dokumentations-Ports aus den Quellen, wie im - vorherigen Abschnitt beschrieben, benötigt die lokale - Installation der Dokumentations-Werkzeugsammlung und ein wenig - Festplattenspeicher für das Bauen der Ports. Sollten die - Ressourcen zum Bauen der Dokumentations-Werkzeugsammlung nicht zur - Verfügung stehen, oder weil das erstellen zuviel Plattenplatz - benötigen würde, ist es trotzdem möglich, bereits - zuvor gebaute Schnappschüsse der Dokumentations-Ports zu - installieren. - - &a.doceng; erstellt monatliche Schnappschüsse der - Dokumentations-Pakete von &os;. Diese Binärpakete können - mit jedem der mitgelieferten Paketwerkzeuge installiert werden, - beispielsweise &man.pkg.add.1;, &man.pkg.delete.1; und so - weiter. - - - Wenn Binärpakete zu Einsatz kommen, wird die - &os;-Dokumentation in allen verfügbaren - Formaten in der gegebenen Sprache installiert. - - - Zum Beispiel installiert das folgende Kommando das aktuelle, - vorgefertigte Paket der ungarischen Dokumentation: + Wenn Sie Pakete benutzen, wird die &os;-Dokumentation in + allen verfügbaren Formaten der jeweiligen Sprache + installiert. Das folgende Beispiel wird das aktuelle Paket + der ungarischen Dokumentation installieren: &prompt.root; pkg install hu-freebsd-doc @@ -1150,95 +950,76 @@ Ungarisch, oder zh_cn für vereinfachtes Chinesisch. - - - - Dokumentations-Ports aktualisieren - - Dokumentations-Ports können wie jeder andere Port - aktualisiert werden. Beispielsweise aktualisiert das - folgende Kommando die installierte ungarische Dokumentation - mittels ports-mgmt/portmaster unter - Verwendung von Paketen: - &prompt.root; portmaster -PP hu-freebsd-doc - - - -