MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="1293058819-1213484446-873576042" --1293058819-1213484446-873576042 Content-Type: TEXT/HTML; charset=iso-8859-1; name="index.html"
![]() |
HEAD | NEXT |
HEAD | PREVIOUS |
The Windows distribution of TTHgold includes an easy-to-use graphical interface. It is activated by dropping a TeX file onto the tth-gui icon or simply double-clicking on it. If desired, non-standard options are selected by button clicks before running the translation. The command line that will be used by in doing the translation is displayed to the user. So the tth-gui is a simple way to learn to use the switches. Figure 1 shows a screen capture of the user interface.
Messages from TTH are directed to a text window.This user interface handles long file names transparently. It is not included in the linux or C distributions.
HEAD | NEXT |
HEAD | PREVIOUS |
Small or moderate-sized TEXdocuments, up to at least 100 kbytes in size, when translated by TTHgold produce HTML documents that are managable for Web publication as one ``Web page'', that is, one HTML file. Single files are much more convenient for management on the server side, but also, despite their significant size, they are comfortable for browsing because the TTH translation produces compact HTML code that immediately displays in the browser even while the rest of the document is being downloaded. HTML reference links within the document, such as from the table of contents, generated automatically by TTHgold, make navigation easy and intuitive.
Nevertheless, there are occasions, such as when dealing with book-length LATEXdocuments, when it is advantageous to be able to split a single TEX document into multiple HTML documents (``web pages''). TTHgold offers this splitting capability. It can optionally produce a set of hyperlinked HTML documents representing either the chapters (of a book) or the sections of the document. In addition to serial linking of these web pages, so that the document can be read sequentially, TTHgold produces a table of contents that correctly hyperlinks to each of the individual chapters , sections, etc. in the different HTML files. In addition internal references to labels, tables, equations etc. are also translated into correct hyperreferences among the HTML files. See section 4.
HEAD | NEXT |
HEAD | PREVIOUS |
Splitting LATEXdocuments into linked HTML files is entirely automatic with TTHgold. After LATEX has produced its auxiliary files, the translation to HTML and cross-referencing of the document is performed in a single pass with the characteristic speed of TTH. The output is a multipart MIME1 file which is convenient for transportation to the final publishing directory of the document, where it can be unpacked into the individual HTML files. Alternatively the output can be piped directly through an unpacking program (provided with the TTHgold distribution) so that a single command generates the files in the directory chosen.
HEAD | NEXT |
HEAD | PREVIOUS |
Natural navigation links to the next or the previous web page in the sequence are automatically included, 2 as can be seen at the top and bottom of this page. Any page can be accessed directly from the table of contents (see section *). Links are generated in response to the standard LATEX commands such as \ref and \label, \cite, and \index. So, for example, a reference to a place in a different page is generated here by a command \ref{sec1label} which refers to a label left in section 2. It may be followed by simply clicking on the reference, and one can return here by using the ``back'' button on the browser.
Footnotes are kept in a separate file to which the browser is automatically taken when the footnote is clicked on.3 In addition, separate files for references and the index are created, if necessary.
HEAD | NEXT |
HEAD | PREVIOUS |
Some bonus items are included with TTHgold, including:
HEAD | NEXT |
HEAD | PREVIOUS |
HEAD | NEXT |
HEAD | PREVIOUS |
1Multipurpose Internet Mail Exchange is the standard used for email attachments, etc. It is just a convenient standard TTHgold uses for packing multiple files into one bundle.
2Text ``Previous'' and ``Next'' are used to avoid dependence on images
3One can return to the place in the text from the footnote by clicking on the footnote number or the back button.