From owner-svn-doc-all@freebsd.org Wed Sep 9 18:17:43 2015 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 8ADB7A01BC5; Wed, 9 Sep 2015 18:17:43 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from repo.freebsd.org (repo.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 701FD12F1; Wed, 9 Sep 2015 18:17:43 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.70]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id t89IHhS6024691; Wed, 9 Sep 2015 18:17:43 GMT (envelope-from jkois@FreeBSD.org) Received: (from jkois@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id t89IHhHG024689; Wed, 9 Sep 2015 18:17:43 GMT (envelope-from jkois@FreeBSD.org) Message-Id: <201509091817.t89IHhHG024689@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: jkois set sender to jkois@FreeBSD.org using -f From: Johann Kois Date: Wed, 9 Sep 2015 18:17:43 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47399 - in head/de_DE.ISO8859-1/books/fdp-primer: doc-build po-translations 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, 09 Sep 2015 18:17:43 -0000 Author: jkois Date: Wed Sep 9 18:17:42 2015 New Revision: 47399 URL: https://svnweb.freebsd.org/changeset/doc/47399 Log: r47338 MFde: sync the section about possible doc-build FORMATs Obained from: The FreeBSD German Documentation Project Modified: head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml head/de_DE.ISO8859-1/books/fdp-primer/po-translations/chapter.xml Modified: head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml Wed Sep 9 14:03:22 2015 (r47398) +++ head/de_DE.ISO8859-1/books/fdp-primer/doc-build/chapter.xml Wed Sep 9 18:17:42 2015 (r47399) @@ -30,7 +30,7 @@ $FreeBSD$ $FreeBSDde$ - basiert auf: r44068 + basiert auf: r47338 --> Die Erzeugung der Zieldokumente @@ -39,13 +39,85 @@ - - Dieses Kapitels erklärt detailliert, wie der Bau der Dokumentation organisiert ist und wie Sie diesen Prozess mit &man.make.1; beeinflussen können. + + DocBook in verschiedene Ausgabeformate konvertieren + + Aus einer einzigen DocBook-Quellcodedatei können + verschiedene Ausgabeformate erstellt werden. Welches Dateiformat + erstellt wird, wird über die Variable + FORMATS festgelegt. Eine Liste aller + verfügbaren Formate ist in KNOWN_FORMATS + gespeichert: + + &prompt.user; cd ~/doc/en_US.ISO8859-1/books/handbook +&prompt.user; make -V KNOWN_FORMATS + + + Häufige Ausgabeformate + + + + + FORMATS + Dateityp + Beschreibung + + + + + + html + HTML, Einzeldatei + Eine einzelne book.html oder + article.html. + + + + html-split + HTML, multiple Dateien + Multiple HTML-Dateien, eine + für jedes Kapitel oder für jeden Abschnitt. Dieser + Typ wird in der Regel für die Nutzung des Dokuments + auf einer Internetseite verwendet. + + + + pdf + PDF + Portable Document Format + + + +
+ + Welches Format verwendet wird, hängt vom jeweiligen + Dokument ab, in der Regel handelt es sich aber um + html-split. Weitere Formate werden über die + Variable FORMATS angegeben. Dabei können + Sie ein einzelnes Format, aber auch mehrere Formate gleichzeitig + definieren. + + + Das Dokument als eine einzelne HTML-Seite bauen + + &prompt.user; cd ~/doc/en_US.ISO8859-1/books/handbook +&prompt.user; make FORMATS=html + + + + Das Dokument in den Formaten HTML-Split sowie + <acronym>PDF</acronym> bauen + + &prompt.user; cd ~/doc/en_US.ISO8859-1/books/handbook +&prompt.user; make FORMATS="html-split pdf" + + + Für den Bau der &os;-Dokumentation benötigte Werkzeuge Modified: head/de_DE.ISO8859-1/books/fdp-primer/po-translations/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/fdp-primer/po-translations/chapter.xml Wed Sep 9 14:03:22 2015 (r47398) +++ head/de_DE.ISO8859-1/books/fdp-primer/po-translations/chapter.xml Wed Sep 9 18:17:42 2015 (r47399) @@ -779,9 +779,8 @@ DOC_PREFIX?= ${.CURDIR}/../../.. sich das Ergebnis in Firefox anzeigen. Für die englische Dokumentation gehen Sie analog vor. Eine Liste aller verfügbaren Werte für die Variable - FORMATS findet sich im FDP-Primer. - + FORMATS finden Sie in . &prompt.user; make FORMATS=html &prompt.user; firefox book.html