DAPS lets you publish your DocBook 4 or Docbook 5 XML sources in various output formats such as HTML, PDF, ePUB, man pages or ASCII with a single command. It is perfectly suited for large documentation projects by providing profiling support and packaging tools. DAPS supports authors by providing linkchecker, validator, spellchecker, and editor macros. DAPS exclusively runs on Linux.

Download & Installation

For download and installation instructions refer to https://github.com/openSUSE/daps/blob/master/INSTALL.adoc
Highlights of the DAPS 2.0 release include:

• fully supports DocBook 5 (production ready)
• daps_autobuild for automatically building and releasing books from different sources
• support for EPUB 3 and Amazon .mobi format
• default HTML output is XHTML, also supports HTML5
• now supports XSLT processor saxon6 (in addition to xsltproc)
• improved “scriptability”
• properly handles CSS, JavaScript and images for HTML and EPUB builds (via a “static/” directory in the respective stylesheet folder)
• added support for JPG images
• supports all DocBook profiling attributes
• improved performance by only loading makefiles that are needed for the given subcommand
• added a comprehensive test suite to ensure better code quality when releasing
• tested on Debian Wheezy, Fedora 20/21 openSUSE 13.x, SLE 12, and Ubuntu 14.10.

Please note that this DAPS release does not support webhelp. It is planned to re-add webhelp support with DAPS 2.1.

For a complete Changelog refer to https://github.com/openSUSE/daps/blob/master/ChangeLog

Support

If you have got questions regarding DAPS, please use the discussion forum at https://sourceforge.net/p/daps/discussion/General/. We will do our best to help.

Bug Reports

To report bugs or file enhancement issues, use the issue Tracker at https://github.com/openSUSE/daps/issues.

The DAPS Project

DAPS is developed by the SUSE Linux documentation team and used to generate the product documentation for all SUSE Linux products. However, it is not exclusively tailored for SUSE documentation, but supports every documentation written in DocBook.
DAPS has been tested on Debian Wheezy, Fedora 20/21 openSUSE 13.x, SLE 12, and Ubuntu 14.10.

The DAPS project moved from SourceForge to GitHub and is now available at https://opensuse.github.io/daps/.

Documents should represent the ‘coorperate identity’, which in small size firms probably comes down to printed stationary with a company logo and some other information on it. Kraft has to print  nicely on it. For that it is important that the layout can be configured at all and without compiling Kraft if the customer address should be printed fife millimeters higher for example.

Currently Kraft uses a document template written in RML for the layout. RML is a XML format which can be converted to PDF utilizing a python based command line tool which is called by Kraft. RML is a open source toolkit, quite powerful and mature. However, it does not solve all problems with flexible document creation and sometimes comes a bit unhandy. As a result our eyes are always open for alternatives.

Here are some requirements a template system must provide:

• There is a document template in the file system. It can be changed by the user without recompiling Kraft. Kraft picks it up, fills the document values in and processes it to PDF. Other output formats are optional.
• Layout: Areas where parts of the document are printed can be freely specified, ie. where the address, the date etc. is printed.
• Graphical elements like lines, fixed text, boxes, colors and images can be placed everywhere.
• The system knows at least different layouts for the first page, middle pages and the last page.
• All pages have page header and footer.
• Loops: Since an invoice for example has an unknown amount of items the system must be able to handle that, including clever space management with  pagebreaks. Nested loops are possible.
• Maintain areas which must not be split, i.e. an invoice item should be printed completely on one page and not be split by a pagebreak.
• Text faces, paragraph alignment, width, spacing and these kind of things must be configurable in the template.
• Some variables are available such as a page counter.
• Really great would be if the system provides carryover of calculations, like  on the top and bottom of each page the so far accumulated sum is printed.

Which free layouting and PDF generating system is able to provide that, preferably Qt/KDE based? Kugar was striving to solve it but when I tested it it did not work out.

Another idea is to use the ability of KWord to work with templates. If Kraft could read KWord templates, fill them and automatically generate a KWord doc from it, that would be a great solution, because in addition to automatic PDF generation documents could easily be exported as KWord docs and changed manually if needed. A great ‘template editor’ also would be available. This would in the direction of office suit integration that commercial Kraft competitors nowadays have.

I am not sure how far we are away from that. Something to investigate.

Nach ca. 1½ Jahren und unzähligen Stunden, dem Verschleiß von hunderten von Korrekturseiten und Stiften, einer überstandenen Druckerei-Pleite, viel verbrauchtem Gehirnschmalz, einem unwilligem PC und über 1000 Revisionen im SVN-Repository, ist jetzt die 2. Auflage meines Buches  “DocBook-XML — Medienneutrales und plattformunabhängiges Publizieren” beim Millin-Verlag erschienen. 5 Jahre nach der ersten Auflage.

Was ist neu?

Eine Menge! Hier eine kleine Übersicht der Neuerungen:

• Das Buch beschreibt sowohl die neue DocBook 5-Spezifikation als auch die ältere DocBook 4.x Version. Das komplette Buch habe ich für beide Versionen entsprechend angepasst.
• Die Installation und Konfiguration von DocBook für Linux und Windows wird Schritt für Schritt beschrieben.
• Es gibt viele neue Kapitel zu folgenden Themen:
  • ein Kapitel zu den Unterschieden zwischen Version 4 und 5.
  • RELAX NG beschreibt die Schemasprache, in der DocBook 5 geschrieben ist.
  • Modulare Dokumente zeigt, wie Dokumente in DocBook aufgeteilt werden.
  • Konditionale Elemente (Profiling), demonstriert die Fähigkeiten von Profiling, einer Methode um DocBook-Elemente auszublenden.
  • E-Book-Format EPUB erzeugen, beschreibt, wie Sie aus Ihrem Dokument ein E-Book erstellen, das Sie auf jedem E-Book-Lesegerät anzeigen können, sofern es Formate wie EPUB oder Mobipocket versteht.
  • Tipps und Tricks, gibt verschiedene Hilfestellungen und Tipps zu DocBook.
  • Migration nach DocBook, erklärt wie Sie von einem älteren Format nach DocBook gelangen.
• Viele Kapitel wurden überarbeitet. Beispielsweise wurde das alte Kapitel DocBook anwenden in vier separate Kapitel aufgeteilt: Strukturelemente, Block-Elemente, Inline-Elemente und Querverweise und Links.
• Wie DocBook 4/5 angepasst werden kann wird selbstverständlich ebenso gezeigt.
• Es gibt eine praktische Übersicht über alle DocBook-Elemente, in welcher Version sie erscheinen, wo sie angewendet werden usw.  Für die tägliche Arbeit sehr nützlich zum Nachschlagen!
• Der Index wurde stark erweitert und umfasst jetzt 18 Seiten.

Interessiert? Eine Leseprobe ist als PDF erhältlich.

Technisches

Beim Erstellen des Buches wurde nahezu ausschließlich Programme aus kontrolliertem Open-Source-Anbau verwendet. Einzige Ausnahmen waren der XML-Editor und der FO-Formatierer.

In der ersten Auflage wurde der DocBook 4-Quellcode noch nach LaTeX transformiert und daraus PDF bzw. PostScript erzeugt. Für die zweite Auflage wurde zuerst der vorhandene Quellcode mittels XSLT nach DocBook 5 umgewandelt. Mit Hilfe einer XSLT-Transformation wurde eine XSL-FO-Datei erstellt, die von einem FO-Formatierer eingelesen und in PDF umgewandelt wurde.

Als Textschrift wird die Charis von SIL International verwendet, für Überschriften die TheSans und für Listings die TheSansMono Condensed; die beiden Letzteren stammen von Lucas de Groot. Die Grafiken wurden entweder direkt in SVG mit Inkscape gezeichnet oder in OpenOffice.org Draw erstellt, nach PDF exportiert und im DocBook-Code entsprechend referenziert. Das Cover-Bild wurde mit Scribus erstellt und für die Druckerei nach TIFF exportiert.

Noch eine kleine Statistik: Das Buch enthält 23 Kapitel, 3 Anhänge, 230 Beispiele, 40 Abbildungen, 64 Tabellen, 65 Schritt-für-Schritt-Anleitungen, über 900 kleine und große Listings, 252 Links, 27 Zitate und über 970 Querverweise.

Wo erhältlich?

Das Buch können Sie in drei Versionen bestellen:

• Als 662 Seiten starkes gedrucktes Buch (ISBN-13-Nummer: 978-3-938626-14-6) oder
• als Online-Paket, bestehend aus EPUB, PDF und HTML zu einem Preis! Somit steht einem Einsatz auf E-Book-Readern, Laptops oder Browsern nichts im Wege.
• In Planung ist derzeit, dass einzelne Kapitel separat heruntergeladen werden können. Somit können Sie sich nur die Kapitel heraussuchen, für die Sie sich interessieren.

Alle im Buch besprochenen Programme befinden sich bereits als einfach zu installierende Pakete für openSUSE. Weitere können von meinem Buildserver Repository nachinstalliert werden.

Vielen Dank an Alle, die daran ihren Anteil hatten!

Features

So what’s are the virtues of Calibre? Here are a few:

• Calibre view your ebooks, displays table of contents (if available), can set bookmarks, and can copy text from your ebook.
• It can manage your ebooks by author, title, date, and other fields.
• Calibre can syncronize your ebook with some e-reader device attached on the USB port.
• Calibre supports a vast amount of ebook formats, including EPub, PDF, MobiPocket, and others (see Calibres’ FAQ page for the full list).
• Calibre can convert ebook formats. If you have downloaded or bought an ebook in a format that your reader does not understand, Calibre can convert it into something more useful with the any2epub tool.

And a lot more features.

Usability Issues

As you could see, Calibre is a very useful tool. However, Calibre’s main window is a bit strange (see screenshot): it wastes the available space and the icons plus their texts are far too big.

The Calibre Main Window

Unfortunately one of the most used icons, View, appears to be the last in the menu bar. This is extremely annoying when you have limited screen resolution, for example on laptops and so called netbooks. Or you want to have only a fraction of your screen occupied by Calibres’ window. The result is the same: the menu bar displays a fraction of its icons and the important View icon disappears. You have to click on the » icon to overlay the rest of the menu bar to reach the View icon.

Viewing my book as EPub

Apart from this usability issue, it does its job—viewing ebooks—very well. For example, this is a screenshot of the 2nd editon of my book in EPub (see 2nd screenshot). As far as I can see, it supports table of contents, CSS, and a lot more, all created by the latest DocBook stylesheets with EPub support.

More EBooks to discover…

If you are interested in trying out Calibre, there are a couple of interesting webpages where you can download free ebooks. Look at www.feedbooks.com, www.gutenberg.org, or use your favorite Internet search engine. Sometimes they offer different formats. Look for EPub or MobiPocket formats as these are “reflowable”.

Installation

Calibre can be downloaded from my openSUSE repository:

Version: 10.3
Version: 11.0
Version: 11.1

Thanks Kovid for this software!