1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
= Installing the DocBook Authoring and Publishing Suite (DAPS)
:numbered:
[#distro-compatibility]
== Distribution compatibility
DAPS has been tested on the following Linux distributions. It should also run
on any other distribution, feedback is welcome.
* openSUSE Leap 15.x and openSUSE Tumbleweed
* SUSE Linux Enterprise 12 and 15 (including service packs)
* Debian Jessie (8.5.0)
* Fedora 23
* Linux Mint 18.1
* Ubuntu 16.04
[#install-package]
== Installing DAPS using a system package
Pre-built packages are available for openSUSE 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, for example:
`zypper ar -f http://download.opensuse.org/repositories/Documentation:Tools/openSUSE_Leap_42.2 Documentation:Tools`
To be able to use the complete functionality of DAPS, make sure to
also install all recommended packages (`zypper in --recommends --from Documentation:Tools daps`) +
+
Packages for daily builds are available from
https://download.opensuse.org/repositories/Documentation:Tools:Auto/
Note that these builds are not thoroughly tested and may contain bugs.
Debian, Fedora, Ubuntu::
Not available, yet. Help is appreciated.
The package is named +daps+. Additional packages needed by DAPS will
automatically be installed.
[#dependency]
== Package dependencies and 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 of DAPS's features are supported with your current installation,
run `./configure --sysconfdir=/etc` in the DAPS Git clone directory. This
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_5 |docbook5-xml |docbook5-schemas
|-- |docbook-xml |--
|docbook-xsl-stylesheets^1^ |docbook-xsl^*^ |docbook-style-xsl^1^
|docbook5-xsl-stylesheets |docbook-xsl-ns |docbook5-style-xsl
|ImageMagick |imagemagick |ImageMagick
|inkscape |inkscape |inkscape
|libxml2-tools |libxml2-utils |libxml2
|-- |libxml-commons-external-java|--
|-- |libxmlgraphics-commons-java |--
|libxslt-tools |-- |libxslt
|jing |jing |jing
|make |make |make
|poppler-tools |poppler-utils |poppler-utils
|python-xml |python3-libxml2 |python3-libxml2
|python-lxml |python3-lxml |python3-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^2^ |fop^2^ |fop^2^
|xmlstarlet |xmlstarlet |xmlstarlet
|-- |xsltproc |--
|zip |zip |zip
|====
^1^: minimum version: 1.7.8
^2^: minimum version: 0.96, 1.x or better is recommended
.*Required Packages for AsciiDoc Support*
[options="header"]
|====
|SUSE |Debian/Ubuntu |Fedora
|rubygem(asciidoctor)^3^ |asciidoctor |asciidoctor
|====
^3^: The exact package name depends on the Ruby version installed on your system.
Using this capability string with `zypper install` ensures the correct package is
installed.
.*Optional packages*
[options="header"]
|====
|SUSE |Debian/Ubuntu |Fedora
|aspell |aspell |aspell
|ditaa |ditaa |ditaa
|epubcheck |epubcheck |?
|exiftool |libimage-exiftool-perl |perl-Image-ExifTool
|libreoffice-draw |libreoffice-draw |libreoffice-draw
|optipng |optipng |optipng
|perl-checkbot |checkbot |?
|remake |remake |n/a^4^
|saxon6 |libsaxon-java |?
|saxon6-scripts |-- |?
|xmlformat |xmlformat-perl |?
|====
^4^ The `remake` package on Fedora is a different software.
To install optional packages at a later point in time,
run `daps-check-deps` to check for already installed and missing dependencies.
[#install-source]
== Installing DAPS from the source
DAPS can be installed from a downloaded release TAR or from a local Git clone.
1. Download the https://github.com/openSUSE/daps/releases/latest[latest DAPS version]
archive and unpack it _or_, alternatively clone the main branch from GitHub: +
`git clone https://github.com/openSUSE/daps.git -b main --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`
5. Run `sudo make install`
6. Run `daps --help` for a brief introduction to DAPS
[#run-from-git]
== Running DAPS from a local Git clone
If you do not want to install DAPS or always want to use the latest
development version, you can run DAPS directly from a local Git clone.
1. Make sure the prerequisites listed in <<anchor-1>> are fulfilled.
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 main --single-branch`
Checking out the latest development version::
`git clone https://github.com/openSUSE/daps.git`
3. (Skip this step for SUSE). Go to the checkout directory and run the
following command according to your distribution:
Debian/Ubuntu::
`./configure --sysconfdir=/etc` +
`make debian`
Fedora/Red Hat::
`./configure --sysconfdir=/etc` +
`make redhat`
SUSE::
_Do nothing_
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, use the following command: +
`<path_to_checkout>/bin/daps --dapsroot=<path_to_checkout>
[options] <subcommand> [options]`
|