daps-autobuild1
Automatically build books from several daps projects hosted on subversion or git.
Usage
daps-autobuild --config
PATH_TO_CONFIG-FILE
[OPTIONS]
Overview
daps-autobuild is designed to automatically build/rebuild documents from several DAPS projects hosted on subversion or git. The build results (HTML, single HTML, and/or PDF) can be copied to a remote server (using rsync). If run regularly (e.g. via cron), rebuilds will only be triggered if changes in the project repository have occurred.
daps-autobuild needs an XML configuration file providing all the data needed to build the books (see FIXME for details). Specifying this file with --config is mandatory. The script automatically validates the configuration file with each run. To manually validate the configuration file, use --validate.
Options
-
--config PATH_TO_CONFIG-FILE -
Path to config file. Can be specified relative or absolute. Default: unset
-
--debug -
In case of a build failure, show a verbose DAPS log. Default: disabled
-
--force -
Documents will only be rebuilt if the Git/SVN repository has changed since the last build. Use this option to force a rebuild even when the repository has not changed. Default: disabled (rebuilds on changes only)
-
--help -
Display the script's help message.
-
--helpconfig -
Show help on the config file.
-
--nosync -
Do not rsync the manuals. Default: disabled (rsync will be done)
-
--notify -
In case of build failures send a notification to the e-mail address specified with <maintainer/> in the config file. Will be ignored if maintainer is not set. Default: disabled (No notification e-mails)
-
--schemaPATH_TO_SCHEMA-FILE -
Path to the schema used to validate the config file. Default: /usr/share/xml/daps/schema/daps-autobuild.rnc
--sections SECT1 SECT2 ...
Space-separated list of sets that should be build. The sets need to be configured in the config file. Default: not set (all sets from the config file will be build)
-
--validate -
Validate the config file specified with --config. Other options except --schema will be ignored.
Releases
3 releases since Debian 11 (Bullseye); the text changed 2 times.