DAPS

DAPS (DocBook Authoring and Publishing Suite) is an open source that can be used to effortlessly publish large documentation projects in several formats. It supports HTML, ePUB and PDF.

DAPS is fully scriptable and features automated image conversion, as well as the ability to publish documentation from DocBook sources with one command.

In order to install this software, you will need to unpack the archive, cd into the newly created folder and execute the ./configure, make and sudo make install commands (one by one, hitting Enter after each one).

What is new in this release:

• spec-file update: Version 1.77 or better of the Docook stylesheets is required

What is new in version 1.1.4:

• daps-auto.pl:
• a perl script to automatically build documents and deploy them to a remote machine via rsync
• EPUB:
• completely rewrote the epub generating code
• no longer needs an external script (db2epub.ruby) for epub-file generation - now everything is handled in make itself
• HTML/HTML-Single/JSP:
• added a --clean switch which clears the directory before generating a new version
• Packaging:
• completely rewrote the code for package-src - new option --set-date allows to set a publication date (default: current date)
• new options for package-html and package-pdf --desktopfiles: generates an archive with desktopfiles for KDE3 --documentfiles: generates a documnet file for KDE4/GNOME2 --pagefiles: generates a page file for GNOME3
• completely rewrote online-docs - now automatically generates epub, color-pdf and single-html archive - new option --export-dir to specify a results directory
• completely rewrote locdrop - new option --export-dir to specify a results directory
• Spellchecking:
• no longer a stand-alone program
• use "daps -d DC-file spellcheck" to check single files (--file option), complete documents (via DC-file) or parts of a document (vi ROOTID)
• can be configured via config variables ASPELL_*
• Emacs macros for DocBook:
• Now supports nxml-mode
• Documentation:
• Significant additions
• Misc:
• Added a --manifest option to dist-html which adds a manifest files containing the html-files in the same order as in the document
• Replaced bash 4 only code with bash 3 compatible code (bash 4 is no longer a prerequisite for daps)
• added support for a static/ directory containing resources for HTML builds (images, js and css files). If present in STYLEROOT, it will be copied as-is and links CSS, JS and style-image links in the HTML source will point there
• Bugfixes:
• Ticket #77 Lang variable ($LL) might not be set
• Ticket #104 Inconsistent Tar Ball for dist-graphics
• Ticket #113 (daps-xslt/mallard/docbook.xsl missing)
• Ticket #114 (package-html with easy file names wanted)
• Ticket #121 package-pdf: --xsltparam missing
• Ticket #122 package-pdf: --documentfiles fails with clean sources
• Ticket #127 productinfo sometimes fails and is slow
• Corrected the webhelp.indexer.language setting
• a misplaced >/dev/null prevented the svg2svg conversion, resulting in 0 byte SVGs
• added proper error handling to setfiles, sourcefiles, docfiles computing
• html-single output in a separate htmlsingle/ directory
• Raised FOP_STACK to 2048k, because otherwise FOP builds on x86_64 fail
• Fixed a bug in listing the double images. backup images like foo.svg~ or foo.svg.~ were listed, too
• EPUB generation failed when no CSS file was specified. This is fixed now
• Fixed sed statements for preserving and recovering entities; the former statements did not match all entity declarations possible and recovering was error-prone
• Only use optipng when it is available
• Fixed targets warn-images and warn-cap

Requirements:

• ImageMagick
• DocBook
• GNU Make
• libxml2
• Libxslt