8 Packaging and Deploying Your Documentation #

8.1 Creating a TAR Archive with All Sources (Including Graphics)
8.2 Generating a Distributable HTML Archive
8.3 Generating Desktop, Document, or Page Files

This chapter covers the following topics:

Creating TAR archives with all source files, including graphics
Generating distributable HTML archives
Generating page, desktop, or document files to integrate your documentation in KDE and GNOME desktop environments.

For distributing your output formats in a convenient way, DAPS can automatically create TAR archives of the XML sources (including graphics) and various output formats. DAPS uses bz2 for high compression of the archives and keeps the directory structure when generating the TAR archives.

Create source packages, HTML TAR archives, color PDFs, or JSP TAR archives with the daps package-* commands. By adding the respective options, you can additionally create page files, document files or desktop files for GNOME or KDE desktop environments.

8.1 Creating a TAR Archive with All Sources (Including Graphics) #

Use the following command to create a distributable TAR archive containing the sources of the complete set, including the graphics:

tux:~> daps -d PATH_TO_DC_FILE package-src

8.2 Generating a Distributable HTML Archive #

To generate HTML output and to automatically pack the HTML files, any graphics, and your CSS file into a TAR archive, use the following command:

tux:~> daps -d PATH_TO_DC_FILE package-html

8.3 Generating Desktop, Document, or Page Files #

To create files that you can use for the help system of the GNOME and KDE desktop environments, use one of the following options:

For the GNOME help system Yelp: --pagefiles
For former Yelp versions: --documentfiles
For the KDE3 help system: --desktopfiles

For example, to create a distributable HTML archive plus the files for GNOME yelp, use the following command:

tux:~> daps -d PATH_TO_DC_FILE package-html --pagefiles

Print this page