# Appendix B - Book File Format

This appendix describes the HTMLDOC .book file format.

## Introduction

The HTMLDOC .book file format is a simple text format that provides the command-line options and files that are part of the document. These files can be used from the GUI interface or from the command-line using the `--batch` option:

    htmldoc filename.book
    htmldoc --batch filename.book

The first form will load the book and display the GUI interface, if configured. Windows users should use ghtmldoc.exe executable to show the GUI and htmldoc.exe for the batch mode:

    ghtmldoc.exe filename.book
    htmldoc.exe --batch filename.book

## The Header

Each .book file starts with a line reading:

    #HTMLDOC 1.9

The version number (1.9) is optional.

## The Options

Following the header is a line containing the options for the book. You can use any valid command-line option on this line:

    -f htmldoc.pdf --titleimage htmldoc.png --duplex --compression=9 --jpeg=90

Long option lines can be broken using a trailing backslash (`\`) on the end of each continuation line:

    -f htmldoc.pdf --titleimage htmldoc.png --duplex \
    --compression=9 --jpeg=90

## The Files

Following the options are a list of files or URLs to include in the document:

    1-intro.html
    2-using.html
    3-cmdref.html
    4-htmlref.html
    5-mdref.html
    a-license.html
    b-book.html

## Putting It All Together

The following is the complete book file needed to generate this documentation:

    #HTMLDOC 1.9
    -f htmldoc.pdf --titleimage htmldoc.png --duplex --compression=9 --jpeg=90
    1-intro.html
    2-using.html
    3-cmdref.html
    4-htmlref.html
    5-mdref.html
    a-license.html
    b-book.html