# iSilo™ Documents

An iSilo™ document is a collection of one or more pages. A page can be of arbitrary length. You use iSiloX to convert content to a document in iSilo™ format, which is an optimized read-only format that was designed specifically with the limited memory and processing power of handheld devices in mind.

iSiloX allows you to specify that a set of files be converted into a single iSilo™ document. The set of files can be an arbitrary mix of any of the supported file types. These include HTML, text, Palm Doc, and image files such as GIF, JPEG, PNG, and BMP. You can of course also specify that a single file be converted. These set of files are referred to as the source of the document. Each source file results in an individual page in the iSilo™ document.

When you create a document specification within iSiloX, you specify through the document's properties the root source files used to create the document. If the root source files are HTML files, they can have hyperlinks to other files. iSiloX adds linked files as additional pages in the document up to a maximum depth that you specify. The order of the pages in the document is the same as the order in which iSiloX encounters the source files. Both the root files and the linked files as a group are called the source files, although you only need to specify the root files when creating a document's specification. The following diagram briefly illustrates this concept:

In the diagram, the assumption is that the files "cover.jpg", "title.htm", and "contents.htm" have been specified as the source files of the document and that the document's properties specify that links should be followed. Assuming that the "contents.htm" file has hyperlinks to the four files "chap1.htm", "chap2.htm", "chap3.htm", and "chap4.htm", when you convert the document, all seven files will be brought in to create the final iSilo™ document with seven pages, one for each file.