From owner-svn-doc-all@FreeBSD.ORG Mon Jun 8 16:14:13 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 07002838; Mon, 8 Jun 2015 16:14:13 +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 E7B7A18F2; Mon, 8 Jun 2015 16:14:12 +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 t58GEC4J098236; Mon, 8 Jun 2015 16:14:12 GMT (envelope-from jkois@FreeBSD.org) Received: (from jkois@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t58GECPp098235; Mon, 8 Jun 2015 16:14:12 GMT (envelope-from jkois@FreeBSD.org) Message-Id: <201506081614.t58GECPp098235@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: jkois set sender to jkois@FreeBSD.org using -f From: Johann Kois Date: Mon, 8 Jun 2015 16:14:12 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46790 - head/de_DE.ISO8859-1/books/fdp-primer/tools 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: Mon, 08 Jun 2015 16:14:13 -0000 Author: jkois Date: Mon Jun 8 16:14:12 2015 New Revision: 46790 URL: https://svnweb.freebsd.org/changeset/doc/46790 Log: r39631 -> r43126 MFde: resync the tools chapter of the fdp-primer Obtained from: The FreeBSD German Documentation Project Modified: head/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.xml Modified: head/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.xml Mon Jun 8 15:54:38 2015 (r46789) +++ head/de_DE.ISO8859-1/books/fdp-primer/tools/chapter.xml Mon Jun 8 16:14:12 2015 (r46790) @@ -30,148 +30,45 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r39631 + basiert auf: r43126 --> Die Werkzeuge - Innerhalb des FDPs werden verschiedene Programme für die - Verwaltung der FreeBSD-Dokumentation, ihrer Transformation in - verschiede Formate und weitere Aufgaben eingesetzt. Wer an der - FreeBSD-Dokumentation mitarbeiten möchte, wird diese - Programme benötigen. - - Doch dies ist kein Grund zur Angst, da alle notwendigen - Programme als FreeBSD-Ports und fertige Pakete vorhanden sind, - wodurch sich die Installation drastisch vereinfacht. - - Allerdings müssen diese Programme installiert werden, - bevor alle Beispiele der folgenden Kapitel ausprobiert werden - können. - - - - Wenn es möglich ist, sollte der Port - <package>textproc/docproj</package> - verwendet werden - - Durch die Installation des Ports textproc/docproj kann die - Installation vereinfacht und eine Menge Zeit gespart werden. Bei - diesem Port handelt es sich um einen - Metaport, der selbst keine Programme oder - ähnliches installiert. Stattdessen enthält er eine - Vielzahl von Abhängigkeiten zu anderen Ports und setzt - deren korrekte Installation voraus. Durch seine Installation - sollten automatisch alle Pakete, die in - diesem Kapitel genannt werden, auf den Rechner geladen und dort - installiert werden. - - Ein nur unter bestimmten Umständen benötigter Port - ist das JadeTeX-Makro-Paket, - das seinerseits eine - &tex;-Installation voraussetzt. &tex; ist ein ziemlich großes - Programmpaket und sollte nur installiert werden, sofern - Zieldokumente im PostScript- oder PDF-Format generiert werden - sollen. - - Um den Platz und die Zeit für die Installation von - JadeTeX und &tex; zu sparen, - muß bei der Installation - angeben werden, ob JadeTeX (und damit auch &tex;) installiert - werden soll oder nicht. - - Daher sollte der docproj-Port entweder mit - - &prompt.root; make JADETEX=yes install - - oder mit - - &prompt.root; make JADETEX=no install - - installiert werden, je nachdem was gewünscht wird. - Alternativ können Sie auch direkt die Ports - textproc/docproj-jadetex oder - textproc/docproj-nojadetex - installieren. Die Variable JADETEX wird - von diesen Ports automatisch entsprechend gesetzt. Ohne - JadeTeX können Sie nur die Formate - HTML und ASCII erzeugen. Die Formate PostScript und PDF - erfordern &tex;. - - - - Notwendige Werkzeuge - - - Software - - Die folgenden Programme sind notwendig, um sinnvoll - an der FreeBSD-Dokumentation arbeiten und diese in andere - Formate wie HTML, reinen Text und RTF umwandeln zu - können. Sie müssen diese aber nicht separat - installieren, da alle Programme automatisch durch den - Metaport textproc/docproj installiert - werden. - - - - Jade (textproc/jade) - - - Eine DSSSL-Implementierung. Sie wird gebraucht, um - Dokumente in andere Formate wie HTML und &tex; zu - übersetzen. - - - - - Tidy - (www/tidy) - - - Ein Formatierer, mit dem man Teile der automatisch - generierten HTML-Dateien neuformatieren kann, um ihre - Lesbarkeit zu erhöhen. - - - - - Links (www/links) - - - Ein Textbrowser, der HTML-Dateien in einfache Textdateien - umwandeln kann. - - - - - peps - (graphics/peps) - - - Einige der Dokumente enthalten Grafiken, die nur im - EPS-Format vorliegen. Damit diese von dem meisten - Webbrowsern angezeigt werden können, müssen - sie nach PNG konvertiert werden. - - - - + Um die FreeBSD-Dokumentation zu verwalten und in verschiedene + Formate zu konvertieren, werden diverse Werkzeuge verwendet. Einige + dieser Werkzeuge sind verpflichtend und müssen auf Ihrem System + installiert sein, bevor Sie den Beispielen in den folgenden Kapiteln + folgen können. Andere sind hingegen optional und dienen dazu, + zusätzliche Funktionalität bereitzustellen oder das Erzeugen der + Dokumentation zu vereinfachen. + + + Verpflichtende Werkzeuge + + Installieren Sie zuerst den Port + textproc/docproj über die + Ports-Sammlung. Dieser Metaport installiert + alle verpflichtenden Werkzeuge für die Arbeit an der + &os;-Dokumentation. Einige dieser Komponenten werden in den + folgenden Abschnitten näher beschrieben. Die DTDs und die Entitäten - Das FDP benutzt verschiedene DTDs und - Entitätensätze, die installiert sein müssen, - bevor mit der Arbeit an einem beliebigen Dokument begonnen - werden kann. + Das FDP benutzt verschiedene Document Type + Definitions (DTDs) und diverse + XML-Entitätensätze. Diese werden durch den + Port textproc/docproj + automatisch installiert. - HTML DTD (textproc/html) + XHTML DTD (textproc/xhtml) - HTML ist die bevorzugte + XHTML ist die meistverwendete Auszeichnungssprache des World Wide Web und wird durchgängig für die FreeBSD-Webseite genutzt. @@ -179,22 +76,23 @@ - DocBook DTD (textproc/docbook) + DocBook DTD (textproc/docbook-xml-450) DocBook ist als Auszeichnungssprache für - technische Dokumentationen entwickelt worden. Die - gesamte FreeBSD-Dokumentation wird mittels DocBook + technische Dokumentationen entwickelt worden. Ein + Großteil der FreeBSD-Dokumentation wird mittels DocBook erstellt. - ISO 8879-Entitäten - (textproc/iso8879) + ISO 8879 entities + (textproc/iso8879) - 19 der ISO 8879:1986-Zeichensätze, die von + Enties des ISO 8879:1986-Standards, die von vielen DTDs benötigt werden. Darin enthalten sind mathematische Symbole, zusätzliche Zeichen, die für auf dem lateinischen beruhende Alphabete @@ -203,27 +101,6 @@ - - - Die Stilvorlagen - - Die Stilvorlagen werden während der Transformation und - der Formatierung von Dokumenten, beispielsweise für die - Bildschirmdarstellung oder den Druck, benutzt. - - - - Modular DocBook Stylesheets (textproc/dsssl-docbook-modular) - - - Die Modular DocBook Stylesheets werden - benötigt, wenn mittels DocBook erstellte Dokumente - in Formate wie HTML oder RTF konvertiert werden - sollen. - - - - @@ -239,74 +116,57 @@ - JadeTeX und - teTeX (print/jadetex und print/teTeX) + JadeTeX, + teTeX und Modular DocBook Stylesheets + (print/jadetex, + print/teTeX und + textproc/dsssl-docbook-modular) - Jade und - teTeX werden eingesetzt, um + Jade, + teTeX und Modular DocBook + Stylesheets werden eingesetzt, um DocBook-Dokumente nach DVI, Postscript und PDF zu konvertieren. Hierfür müssen die - JadeTeX Makros installiert + JadeTeX-Makros installiert sein. - Ist es nicht geplant, die Dokumente in einem dieser - Formate zu erzeugen, wenn also HTML, Text und RTF - ausreichend sind, brauchen - JadeTeX und - teTeX nicht installiert zu - werden. Da die Installation von - teTeX insgesamt 30 MB - benötigt, kann so Zeit und Plattenplatz gespart - werden. - - - - Wird sich für die Installation von - JadeTeX und - teTeX entschieden, - muß teTeX - anschließend noch eingerichtet werden. Die Datei - print/jadetex/pkg-message - enthält detailierte Angaben zu den dafür - notwendigen Schritten. - + Ist nicht geplant, die Dokumente in einem dieser + Formate zu erzeugen (wenn also XHTML + und Text ausreichend sind), brauchen Sie diese nicht zu + installieren. Dazu deaktivieren Sie diese Option im + Konfigurationsbildschirm des Ports textproc/docproj. + + + + Vim + (editors/vim) + + + Ein beliebter Texteditor zur Bearbeitung von + XML und davon abgeleiteten Dokumenten + wie DocBook XML. Emacs oder - XEmacs (editors/emacs oder editors/xemacs) + XEmacs + (editors/emacs oder + editors/xemacs) Beide Texteditoren haben einen speziellen Modus zur - Bearbeitung von SGML-Dokumenten entsprechend den - Vorgaben einer SGML-DTD. Zusätzlich bieten sie + Bearbeitung von Dokumenten entsprechend den Vorgaben + einer XML DTD. + Zusätzlich bieten sie Funktionen an, mit denen sich der Tippaufwand reduzieren - und Fehlerwahrscheinlichkeit senken - läßt. - - - - Natürlich muß nicht mit einem dieser - Texteditoren gearbeitet werden; jeder andere Editor kann - dafür genausogut genutzt werden, doch vielleicht - wird die Arbeit durch sie als effektiver empfunden - werden. - - - + und Fehlerwahrscheinlichkeit senken lässt. - - Sofern Sie Vorschläge haben, welche andere - Software für die Verarbeitung oder Bearbeitung von - SGML-Dokumenten in diese Liste mitaufgenommen werden sollte, - senden Sie diese bitte an &a.doceng;.