Synopsis
Parameters
Examples
Bundled DjVu Documents
Creating Bundled DjVu Documents
Viewing Bundled DjVu Documents
Converting Indirect Files into Bundled Files
The djvubundle command creates multiple-page DjVu documents that are in the bundled format. For information about this format, see Bundled DjVu documents. Because djvubundle only supports DjVu (.djvu) files, you must first encode the input image files using phototodjvu.
djvubundle [options...] <inputfile1.djvu> <inputfile2.djvu> [<inputfile.djvu...>] <newfile.djvu>
options – Specifies an optional assembling requirement. You can specify multiple options each time you run a command. See table below.
|
djvubundle Options |
|
|
|
|
|
|
|
inputfile1.djvu, inputfile2.djvu,... – Specifies the name of each input DjVu (*.djvu) file you want to include in the multiple-page document. If you do not want to type each file name individually, you can create a text file, called a filelist, that lists all the input files to be assembled. For more information, see the filelist command option.
newfile – Specifies a name for the resulting bundled
DjVu document (for example, bundled.djvu).
The following example demonstrates how you can use djvubundle and its options to bundle every DjVu file into one file per chapter:
djvubundle
--verbose chapter1/*.djvu chapter1.djvu
djvubundle
--verbose chapter2/*.djvu chapter2.djvu
djvubundle --verbose chapter3/*.djvu chapter3.djvu
To bundle those chapters into a book, use djvubundle with these options:
djvubundle --verbose chapter1.djvu chapter2.djvu chapter3.djvu book.djvu
A bundled DjVu document is a single DjVu file that contains several encoded images, each of which appears as a separate page in the document. Bundled documents contain all shared dictionary information. If necessary, Document Express renames any conflicting file names.
Use bundled DjVu documents for archiving, sending email, copying between file systems, and working with other applications where it is practical to have a single file.
To create a bundled DjVu document, list multiple DjVu files after the djvubundle command and specify an output filename with a .djvu extension. For example:
djvubundle
beagle.djvu collie.djvu chihuahua.djvu dogs.djvu
In this example the bundled DjVu document, dogs.djvu, contains three pages: beagle, collie, and chihuahua. The data from each of the DjVu files is incorporated into the bundled document, creating a single DjVu file with multiple pages.
To view a bundled document, open the DjVu file in the DjVu Browser Plug-in. The first page that displays is the first file that Document Express encoded. Document Express encodes images in the order that you list them on the command line.
You can use djvubundle to convert an indirect DjVu document into a bundled DjVu document. For more information about these multiple-page formats, see Bundled DjVu documents and Indirect DjVu documents.
Type the name of the indirect document's index file after the djvubundle command and specify a filename for the new bundled document. For example:
djvubundle
index.djvu book.djvu
In this example, the index file, index.djvu, contains references to three DjVu files: chapt1.djvu, chapt2.djvu, and chapt3.djvu. The djvubundle command copies the image data from these files and incorporates it into a single DjVu file, book.djvu, that consists of three pages.
See also Converting Bundled Documents into Indirect Documents.
This command requires long file names, and will not work correctly on MSDOS FAT16 file systems.