1. Manuals
  2. Tumbleweed
  3. daps
  4. daps-autobuild(1)

Scroll to navigation

DAPS(1) daps DAPS(1)

NAME

daps-autobuild - Automatically build books from several DAPS projects hosted on subversion or git.

SYNOPSIS

daps-autobuild {--config PATH_TO_CONFIG-FILE} [OPTIONS]

DESCRIPTION

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.

SEE ALSO

https://opensuse.github.io/daps/

DAPS project homepage

AUTHOR

Frank Sundermeyer <fsundermeyer@opensuse.org>

Developer
10/25/2022 DAPS @DAPS_VERSION@