Given an input TeX document whose main file is story.tex, the call
typically produces at least one output HTML file story.html, and possibly some additional HTML files, which are named story-Z-H-1.html, story-Z-H-2.html, and so on. Additional HTML files are created whenever the input document has commands requesting page breaks in the HTML output.
This is about all you need to know. However, TeX2page does manipulate many other little auxiliary files in order to communicate information both to external programs and across successive runs of itself. The following briefly describes the functions of these auxiliary files, should you ever need to look at them more closely, either out of curiosity or for debugging your document.
TeX2page displays on standard output the log of its progress with story.tex. A copy of this log is kept in the log file story.hlog.
If story.tex uses the external program BibTeX for its bibliography, TeX2page sends information to BibTeX in the file story--h.aux and receives information from BibTeX in the file story--h.bbl.
If story.tex contains
\index commands, TeX2page
will dump the unsorted index into story--h.idx and
get from MakeIndex the sorted index story--h.ind.
TeX2page uses the auxiliary files story-Z-L.scm and story-Z-A.scm to keep track of labels and other internal cross-references. Each run of TeX2page loads the story-Z-L.scm and story-Z-A.scm created by the previous run. If story.tex contains forward cross-references, TeX2page must be rerun at least once.
For the image portions of story.tex, TeX2page creates the auxiliary TeX files story-Z-G-1.tex, etc, and uses the external programs TeX, Dvips, Ghostscript and NetPBM to convert them to the corresponding image files story-Z-G-1.gif, etc. This assumes you are using the GIF format for images. Change the extension .gif to .png or .jpeg if your images are in PNG or JPEG.
The above are ``single-use'' images. story.tex may reuse some image files within itself. Such image files have slightly different names and are numbered separately: story-Z-G-D-1.gif, etc.
\eval in story.tex create the
auxiliary Scheme files story-Z-E-1.scm, etc, which
are converted (by Scheme) into the corresponding
auxiliary TeX files story-Z-E-1.tex, etc, which are
loaded back into story.tex on a subsequent run.
\eval's that occur inside the
portions of story.tex have slightly different names
and are numbered separately: story-Z-E-H-1.scm, etc,
with their corresponding story-Z-E-H-1.tex, etc. This
is so that the
\eval's in the non-
\htmlonly portions can be shared by TeX2page
and TeX, without the
\eval's from the
\htmlonly portions throwing the numbering off.
By default, all these files are created in the working directory. To avoid cluttering up your working directory, you can specify a different target directory using one of the following three files:
jobname.hdir in the working directory, ie, a file with the same basename as the input document but with extension .hdir. For story.tex, this would be story.hdir.
.tex2page.hdir in the working directory.
.tex2page.hdir in the user's HOME directory.
The first line of the first of these files that exists is taken to be the name of the target directory. If none of these files exist, the current working directory is the target directory.
The .hdir file may contain the TeX control
\jobname, which expands to the basename of
the input TeX document.