Synopsis
Parameters
Examples
Indirect DjVu Documents
Creating Indirect DjVu Documents
Viewing Indirect DjVu Documents
Distributing Indirect DjVu Documents
Converting Bundled
Documents into DjVu Documents
Restriction
The djvujoin command creates multiple-page DjVu documents that are in the indirect format. For more information about this format, see Indirect DjVu Documents. Because djvujoin only supports DjVu (.djvu) files, you must first encode the input image files using phototodjvu.
djvujoin [options...] <inputfile1.djvu> <inputfile2.djvu> [<inputfile.djvu...>] <newindex.djvu>
options – Specifies an optional assembling
requirement. You can specify multiple options each time you run a command. See
table below.
|
djvujoin 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.
newindex – Specifies a name for the index file of the resulting indirect DjVu document (for example, index.djvu). This file references each of the individual DjVu files in the multiple-page DjVu document.
mkdir
public_html/book
djvujoin
--verbose chapter1/*.djvu chapter1/index.djvu
djvujoin
--verbose chapter2/*.djvu chapter2/index.djvu
djvujoin
--verbose chapter3/*.djvu chapter3/index.djvu
djvujoin --verbose chapter1/index.djvu chapter2/index.djvu chapter3/index.djvu public_html/book/index.djvu
An indirect DjVu document consists of several DjVu files, each of which appears as a separate page in the document. Unlike a bundled DjVu document, however, an indirect document does not contain the image data from these files. Instead, it is similar to a directory in that it contains references to the DjVu files. These references are linked together by an index file, which you can remove or rename without affecting the referenced DjVu files.
Document Express also copies files from other directories and, if necessary, renames them if their names conflict with a file in the directory where the index file is located.
Use indirect DjVu documents to publish files on the Web or to distribute files that are too large to write into a single file.
To create an indirect DjVu document, list multiple DjVu files after the djvujoin command and do one of the following:
djvujoin stamps.djvu coins.djvu hats.djvu cards.djvu catalog
djvujoin stamps.djvu coins.djvu hats.djvu cards.djvu catalog.djvu
djvujoin stamps.djvu coins.djvu hats.djvu cards.djvu catalog/index.djvu
In the examples above, the resulting indirect document consists of four pages, each of which contains a reference to either stamps.djvu, coins.djvu, hats.djvu, or cards.djvu. The first page of the document is the first file that Document Express encoded (in this case, stamps.djvu). The other pages follow in the order that you specified on the command line.
To view an indirect document, open the index file in the DjVu Browser Plug-in. Each time you select a page to view, the DjVu Browser Plug-in downloads only the DjVu file that is referenced in that page. The other DjVu files are not downloaded until you select the pages that reference them, which enables you to download small amounts of information at a time.
When you distribute indirect DjVu documents electronically,
you may need to include the following components with the index file and
referenced DjVu files:
Shared dictionary files (*.djbz) – A shared dictionary file contains data about shapes that repeat in a multiple-page document. When Document Express Enterprise encodes a multiple-page document, it scans the pages of the document, looking for the shapes that repeat. It then stores data about these shapes in a shared dictionary file that is referenced by several pages in the document. Because it stores this information only once, Document Express is able to create multiple-page documents with very small file sizes.
By default, a shared dictionary file is created for every ten pages of a document. Using the pages-per-dict option, however, you can adjust the number of pages that reference this file.
Do not remove the *.djbz files from the directory that contains your indirect document unless all of the DjVu files that comprise the document have already been removed. Some indirect documents that do not contain repeating shapes, such as line drawings, do not use shared dictionaries; therefore, you can distribute these documents without the *.djbz files.
Thumbnail files (*.thumb) – If you integrate thumbnails into your indirect DjVu document, the thumbnail information is stored in a file with a .thumb extension, which needs to be distributed with the DjVu files.
Do not remove *.thumb files from the directory that contains your indirect document unless all of the DjVu files that comprise the document have already been removed.
For more information about thumbnail files, see thumbsize.
You can use djvujoin to convert a bundled DjVu document into an indirect DjVu document. For more information about these multiple-page formats, see Bundled DjVu Documents and Indirect DjVu Documents.
Type the name of the bundled DjVu file after the command and use one of the methods described in Creating Indirect DjVu Documents to create an index file. For example:
djvujoin
dogs.djvu breeds/index.djvu
In this example, the bundled document, dogs.djvu, contains three pages. When you run djvujoin, each of the pages becomes a separate DjVu file that is referenced by the index.djvu file. All of the files are saved in the “breeds” directory.
See also Converting Indirect Documents into Bundled Documents.
This command requires long file names, and will not work correctly on MSDOS FAT16 file systems.