Looking for the latest version? Download DAPS 2.1.tar.gz (13.1 MB)
Name Modified Size Downloads / Week Status
Totals: 5 Items   61.5 kB 9
2.1 2015-07-02 0
2.0 2015-06-19 11 weekly downloads
daps_archive 2015-06-12 33 weekly downloads
Changelog 2015-07-03 54.0 kB 88 weekly downloads
readme.install 2015-07-03 7.5 kB 11 weekly downloads
Installing the DocBook Authoring and Publishing Suite (DAPS) ============================================================ Tested Distributions -------------------- DAPS has been tested on the following Linux distributions. It should also run on any other distribution, feedback is welcome. * Debian Wheezy (7.8.0) * Fedora 20 and 21 * openSUSE 13.* * SUSE Linux Enterprise 12 * Ubuntu 14.10 (Utopic Unicorn) (see note in the Installation section) Pre-build Packages ------------------ Pre-build packages are available for openSUSE and Ubuntu from the following repositories: SUSE:: http://download.opensuse.org/repositories/Documentation:Tools/ + (browse to this URl and choose you SUSE version to get the complete repository URl and add it with the `zypper ar` command) Fedora, Ubuntu:: Not available, yet. Help is appreciated. The package is named +daps+. Additional packages needed by DAPS will automatically be installed. Installing DAPS --------------- DAPS can be installed either from a downloaded release or from the GitHub checkout. (Alternatively you may use the latest development version by using a repository clone directly without installing--see below. However, this is not recommended for production use). Prerequisites ------------- DAPS only runs on Linux and is not compatible with other operating systems. DAPS requires a few programs to be installed on your system. To use the full feature set of DAPS, make sure to also install the optional packages. If unsure, which DAPS' features are supported with your current installation, just run `./configure` in the DAPS checkout directory. It will output detailed information about the support status on your system. .*Required packages* [options="header"] |==== |SUSE |Debian/Ubuntu |Fedora |automake |autotools-dev |automake |dia |dia |dia |docbook_4 |docbook |docbook-dtds |-- |docbook-xml |-- |docbook-xsl-stylesheets^*^ |docbook-xsl^*^ |docbook-style-xsl^*^ |ImageMagick |imagemagick |ImageMagick |ghostscript |ghostscript |ghostscript |inkscape |inkscape |inkscape |libxml2-tools |libxml2-utils |libxml2 |-- |libxml-commons-external-java|-- |-- |libxmlgraphics-commons-java |-- |libxslt-tools |-- |libxslt |make |make |make |poppler-tools |poppler-utils |poppler-utils |python-xml |python-libxml2 |libxml2-python |python-lxml |python-lxml |python-lxml |sgml-skel |sgml-base |sgml-common |svg-dtd |sgml-data |? |w3m |w3m |w3m |xml-commons-jaxp-1.3-apis| -- |xml-commons-apis |xmlgraphics-fop^**^ |fop^**^ |fop^**^ |xmlstarlet |xmlstarlet |xmlstarlet |-- |xsltproc |-- |zip |zip |zip |==== ^*^: minimum version: 1.7.8 ^**^: minimum version: 0.96, 1.x is recommended .*Required Packages for DocBook 5 Support* [options="header"] |==== |SUSE |Debian/Ubuntu |Fedora |docbook_5 |docbook5-xml |docbook5-schemas |docbook5-xsl-stylesheets|docbook-xsl-ns |docbook5-style-xsl |jing |jing |jing |==== .*Optional packages* [options="header"] |==== |SUSE |Debian/Ubuntu |Fedora |aspell |aspell |aspell |epubcheck |epubcheck |? |exiftool |libimage-exiftool-perl |perl-Image-ExifTool |optipng |optipng |optipng |perl-checkbot |checkbot |? |remake |remake |remake |saxon6 |libsaxon-java |? |saxon6-scripts |-- |? |xmlformat |xmlformat-perl |? |transfig |xfig |xfig |==== Installation ------------ 1. Download the https://github.com/openSUSE/daps/archive/2.1.tar.gz[DAPS 2.1] archive and unpack it _or_, alternatively clone the master branch from GitHub: + `git clone https://github.com/openSUSE/daps.git -b master --single-branch` 2. Change into the daps directory 3. Run `./configure --sysconfdir=/etc` + Carefully check the configuration summary. Run `./configure --help` for more information on how to change installation paths. If you need to change something, re-run the configure command again afterwards. 4. Run `make` Important: Ubuntu users:: Ubuntu 14.10 ("Utopic Unicorn") ships a buggy xmlcatalog binary that creates wrong catalog entries for DAPS. To work around this issue, copy the file +Ubuntu_catalog_fix+ to +catalogs/for-catalog-daps.xml+ after having run `make` + In case you have not installed DAPS to the default location (e.g. by having ran configure with +--prefix+ or +--datadir+), you need to adjust the paths in +catalogs/for-catalog-daps.xml+ + It is unknown to us whether this bug also occurrs in previous Ubuntu versions. Check by inspection +catalogs/for-catalog-daps.xml+ after having run `make`. In case it does not contain entries with +urn:x-daps:xslt:profiling+ copy the correct file as explained above. 5. Run `sudo make install` 6. Run `daps --help` for a brief introduction in DAPS .Ubuntu: Workaround for Faulty Catalog Entries [NOTE] Ubuntu 14.10 ("Utopic Unicorn") ships a buggy xmlcatalog binary that creates wrong catalog entries for DAPS. To work around this issue, copy the file +Ubuntu_catalog_fix+ to +catalogs/for-catalog-daps.xml+ after having run `make' Running DAPS from a GitHub Checkout ----------------------------------- In case you do not want to install DAPS or always would like to use the latest development version, you can run DAPS directly from the GitHub checkout. 1. Make sure the prerequisites listed above are fullfilled. 2. Check out DAPS. Either choose the latest stable version (safe) or the development version (may not work) Checking out the latest release:: `git clone https://github.com/openSUSE/daps.git -b master --single-branch` Checking out the latest development version:: `git clone https://github.com/openSUSE/daps.git` 3. (Skip this step for SUSE). Go to <path_to_checkout>/etc/fop and enter the following command according to your distribution: Fedora/RedHat:: `ln -sf fop-daps.redhat etc/fop/fop-daps.xml` SUSE:: _Do nothing_ Other (non SUSE/RedHat-based) distributions:: `ln -sf fop-daps.generic etc/fop/fop-daps.xml` 4. Test DAPS by building the DAPS user manual: + `cd <path_to_checkout>/daps/doc` + `../bin/daps --dapsroot .. -d DC-daps-user pdf` To run DAPS from the checkout directory, enter the following command: + `<path_to_checkout>/bin/daps --dapsroot=<path_to_checkout> [options] <subcommand> [options]`
Source: readme.install, updated 2015-07-03