<?xml version="1.0" encoding="iso-8859-1" ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd--> <html xmlns="http://www.w3.org/1999/xhtml" > <head><title>calling commands</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> <meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> <meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> <!-- xhtml,th4,index --> <meta name="src" content="mn.tex" /> <meta name="date" content="2007-07-08 23:10:00" /> <link rel="stylesheet" type="text/css" href="mn.css" /> </head><body > <p class="rightline"><a href="mn.html#mn-commands.html" >up</a></p> <h2 class="ChapterHead"><a name="QQ1-3-4"></a>Calling Commands</h2><div class="TableOfContents"><span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-5" name="QQ2-3-5">From LaTeX to HTML</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-6" name="QQ2-3-6">Available Values for the Options</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-7" name="QQ2-3-7">XHTML and Unicode</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-8" name="QQ2-3-8">XHTML with MathML</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-10" name="QQ2-3-10">OpenDocument, OpenOffice, and MS Word</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-11" name="QQ2-3-11">DocBook and TEI</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-12" name="QQ2-3-12">JavaHelp</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-13" name="QQ2-3-13">Private Configuration Files</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-14" name="QQ2-3-14">An Insight into the Commands</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-15" name="QQ2-3-15">A Deeper Insight</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-16" name="QQ2-3-16">TeX, ConTeXt, and TeXi</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-18" name="QQ2-3-18">Other Options</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-19" name="QQ2-3-19">Validation</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-3-20" name="QQ2-3-20">Recommendations</a></span> </div> <h2 class="ChapterHead"><a name="QQ1-3-5"></a>From LaTeX to HTML</h2> <!--l. 2839--><p class="noindent" ><a name="features"></a>The translation of a LaTeX source file into HTML involves of loading <span class="cmtt-10">tex4ht.sty </span>and *.4ht style files, choosing the desirable options for the translation, compiling the source into <span class="cmtt-10">dvi </span>code with the native LaTeX engine, and postprocessing the outcome with the <span class="cmtt-10">tex4ht </span>and <span class="cmtt-10">t4ht </span>programs (see <a href="mn37.html" >overview</a>). </p><!--l. 2848--><p class="indent" > <a name="index3-5001"></a>The <span class="cmtt-10">htlatex </span>command loads a script which takes on itself to invoke the different steps of the process, without user intervention. The command assumes the form </p> <div class="centerline"><span class="cmtt-10">htlatex filename "</span><span class="cmti-10">options1</span><span class="cmtt-10">" "</span><span class="cmti-10">option2</span><span class="cmtt-10">" "</span><span class="cmti-10">options3</span><span class="cmtt-10">" "</span><span class="cmti-10">options4</span><span class="cmtt-10">"</span></div> <!--l. 2857--><p class="noindent" >where the first set of options is for the <span class="cmtt-10">tex4ht.sty </span>and <span class="cmtt-10">*.4ht </span>style files, the second set is for the <span class="cmtt-10">tex4ht</span> postprocessor, the third for the <span class="cmtt-10">t4ht </span>postprocessor, and the last one is for the LaTeX compiler. For instance, </p><!--l. 2871--><p class="indent" > </p><dl > <dt><span class="cmtt-10">htlatex filename</span></dt><dd> This command requests a translation according to the default conditions, which are set to produce HTML transitional 4.0 code. </dd><dt><span class="cmtt-10">htlatex filename "html,2,info"</span></dt><dd> This command is equivalent to the previous one, specifying explicitly the option <span class="cmtt-10">html </span>for <span class="cmtt-10">tex4ht.sty </span>instead of doing so implicitly. <!--l. 2881--><p class="indent" > In addition, the command requests a break up of the output into separate web pages, in accordance to the two top sectioning levels of the document. </p><!--l. 2885--><p class="indent" > Moreover, it asks for a listing in the log file of the information available for the style files in use. That information, among other things, also introduces additional values available for the first list of options. </p> </dd><dt><span class="cmtt-10">htlatex filename "" "dbcs/!"</span></dt><dd> This command requests the loading of the dbcs branch of Chinese hypertext fonts (on top of those already requested by the default setting). </dd><dt> <a name="index3-5002"></a> <a name="index3-5003"></a> <a name="index3-5004"></a> <a name="index3-5005"></a> <a name="index3-5006"></a><span class="cmtt-10">htlatex filename "foo,frames" "" "-p"</span></dt><dd> This command requests LaTeX to load a private configuration file, named <span class="cmtt-10">foo.cfg</span>, and to place the content and table of contents in separate frames. In addition, it asks <span class="cmtt-10">t4ht </span>not to produce bitmaps for pictures. </dd><dt><span class="cmtt-10">htlatex filename "" " -ciso2htf" "" "-translate-file=il2-pl"</span></dt><dd> This command invokes the LaTeX compiler with the instruction ‘<span class="cmtt-10">latex -translate-file=il2-plfilename</span>’. </dd></dl> <h2 class="ChapterHead"><a name="QQ1-3-6"></a>Available Values for the Options</h2> <!--l. 2924--><p class="noindent" ><a name="index3-6001"></a>The fields of <span class="cmti-10">option1 </span>should be separated by commas. An ‘<span class="cmtt-10">info</span>’ field requests a listing in the .log file of many of the the available values. If the list is not empty, it must start with the entry ‘<span class="cmtt-10">html</span>’, ‘<span class="cmtt-10">xhtml</span>’, or a name of a private configuration file. </p><!--l. 2931--><p class="indent" > The fields of <span class="cmti-10">option2 </span>and <span class="cmti-10">options3 </span>should be separated by spaces. The available values can be listed by executing the postprocessors <span class="cmtt-10">tex4ht.c </span>and <span class="cmtt-10">t4ht.c</span>, respectively, without arguments (or with wrong sets of arguments). </p><!--l. 2936--><p class="indent" > The first field of <span class="cmti-10">option2 </span>should be empty or a subdirectory of <span class="cmtt-10">ht-fonts </span>(typically augmented with an exclamation mark ‘<span class="cmtt-10">!</span>’). A space should separate the first field from the second one, also when the first field is empty. </p><!--l. 2941--><p class="indent" > The underlying output formats of available <span class="cmtt-10">htlatex</span>-like commands are tailored into the commands through fields of <span class="cmti-10">option1</span>. The names of these fields are defined in <span class="cmtt-10">tex4ht.4ht </span>and <span class="cmtt-10">tex4ht.usr </span>(see <a href="mn7.html#confFiles">General Configuration Files</a>). These values should be of little interest to most users. </p><!--l. 2949--><p class="indent" > <a name="index3-6002"></a> <a name="index3-6003"></a>Different variants of the <span class="cmtt-10">htlatex </span>command may be invoked by introducing the commands as arguments to a driver named <span class="cmtt-10">mk4ht</span>. When provided without arguments, the driver lists the commands it recognizes. </p> <table id="TBL-1" ><tr style="vertical-align:top;" > <td style="white-space: nowrap; margin-right:2em;" > <span class="cmtt-10">mk4ht mzlatex filename "html,3" </span></td><td ><span class="cmtt-10">(htlatex filename "html,3,xhtml,mozilla" "</span><span class="cmtt-10"> -cmozhtf")</span> </td></tr><tr style="vertical-align:top;" > <td style="white-space: nowrap; margin-right:2em;" > <span class="cmtt-10">mk4ht oolatex filename </span></td><td ><span class="cmtt-10">(htlatex filename "xhtml,ooffice" "ooffice/!</span><span class="cmtt-10"> -coo") </span></td></tr></table> <!--l. 2963--><p class="indent" > <a name="index3-6004"></a>Alternatively, a compilation ‘<span class="cmtt-10">latex mkht-scripts.4ht</span>’ produces different named scripts of similar functionality. </p> <h2 class="ChapterHead"><a name="QQ1-3-7"></a>XHTML and Unicode</h2> <a name="index3-7001"></a> <a name="index3-7002"></a> <a name="index3-7003"></a> <a name="index3-7004"></a>The ‘<span class="cmtt-10">xhlatex</span>’ command is a variant of the ‘<span class="cmtt-10">htlatex</span>’ command requesting XHTML output. It consists just of a call to ‘<span class="cmtt-10">htlatex</span>’ with the entry ‘<span class="cmtt-10">xhtml</span>’ in the first list of options and ‘<span class="cmtt-10">-cvalidate</span>’ in the third list. For instance, ‘<span class="cmtt-10">xhlatex filename</span>’ or ‘<span class="cmtt-10">htlatex filename "xhtml"</span>’. <!--l. 2981--><p class="noindent" >To request a Unicode representation of symbols, the first list of options should include the ‘<span class="cmtt-10">uni-html4</span>’ entry, and the second list should include the ‘<span class="cmtt-10">-cunihtf</span>’ entry preceded by space. For instance, ‘<span class="cmtt-10">xhlatex filename</span> <span class="cmtt-10">"xhtml,uni-html4" " -cunihtf"</span>’. </p><!--l. 2987--><p class="indent" > Unicode representations of symbols in UTF-8 encoding may be requested with the entry ‘<span class="cmtt-10">-utf8</span>’ added to the second list. For instance, ‘<span class="cmtt-10">xhlatex filename "xhtml,charset=utf-8" " -cunihtf</span> <span class="cmtt-10">-utf8"</span>’. </p><!--l. 2994--><p class="item" > <span class="item">T</span>o request expanded usage of unicode values in iso-8859-1 output employ commands similar to </p> <div class="centerline"><span class="cmtt-10">htlatex file "" "iso8859/1/charset/uni/!"</span></div> <!--l. 3000--><p class="noindent" >or introduce a similar charset path in tex4ht.env. Otherwise, non iso-8859-1 characters might obtain bitmap representations. </p> <h2 class="ChapterHead"><a name="QQ1-3-8"></a>XHTML with MathML</h2> <!--l. 3009--><p class="noindent" ><a name="index3-8001"></a> <a name="index3-8002"></a> <a name="index3-8003"></a> <a name="index3-8004"></a> <a name="index3-8005"></a> <a name="index3-8006"></a>TeX4ht has different configurations for different modes of output. It is distributed with pre-tailored base configurations for translating LaTeX math into MathML, and extra configurations for adjusting the outcome to Mozilla, MathPlayer, and PMathML CSS. Only presentational MathML is supported. </p><div class="Verbatim"><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> mzlatex</span><span class="cmtt-10"> filename</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> mzlatex</span><span class="cmtt-10"> filename</span><span class="cmtt-10"> "html,pmathml"</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> mzlatex</span><span class="cmtt-10"> filename</span><span class="cmtt-10"> "html,mathml-"</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> mzlatex</span><span class="cmtt-10"> filename</span><span class="cmtt-10"> "html,mathplayer"</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> xhmlatex</span><span class="cmtt-10"> filename</span><span class="cmtt-10"> </span> <br /></div> <!--l. 3033--><p class="indent" > For XHTML+MathML to be served both by Mozilla and MSIE+MathPlayer use the command line option ‘mathplayer’. </p><!--l. 3037--><p class="indent" > The <span class="cmtt-10">mzlatex </span>command is a short cut representation for the command ‘<span class="cmtt-10">htlatex filename "xhtml,mozilla"</span> <span class="cmtt-10">" -cmozhtf" "-cvalidate"</span>’. It take into account special needs of browsers. The <span class="cmtt-10">xhmlatex </span>command is a short cut representation for the command ‘<span class="cmtt-10">htlatex filename "xhtml,mathml" " -cunihtf" "-cvalidate"</span>’; it does not make any compromizes toward browsers. </p><!--l. 3045--><p class="indent" > It might be worthwhile to notice some of the more <a href="mn4.html" name="mn4.html" >common sources of problems</a> for MathML. <a name="index3-9003"></a>The ‘<span class="cmtt-10">mathml-</span>’ options asks for a degraded MathML output that sidetracks some of the problems. </p> <h2 class="ChapterHead"><a name="QQ1-3-10"></a>OpenDocument, OpenOffice, and MS Word</h2> <!--l. 3189--><p class="noindent" ><a name="index3-10001"></a> <a name="index3-10002"></a> <a name="index3-10003"></a> <a name="index3-10004"></a> <a name="index3-10005"></a> <a name="index3-10006"></a>A translation for an OpenDocument format can be requested by the ‘<span class="cmtt-10">\oolatex</span>’ command. The command is a variant of <span class="cmtt-10">htlatex </span>in which the first list of options holds the entries ‘<span class="cmtt-10">xhtml,ooffice</span>’, the second list holds the entry ‘<span class="cmtt-10">-cmozhtf</span>’ preceded by a space, and the third list contains ‘<span class="cmtt-10">-coo</span>’ (<span class="cmtt-10">htlatex filename "xhtml,ooffice"</span> <span class="cmtt-10">"ooffice/!</span><span class="cmtt-10"> -cmozhtf" "-coo" "-cvalidate"</span>). The output of a command ‘<span class="cmtt-10">oolatex filename</span>’ is a zipped file named with a ‘<span class="cmtt-10">.odt</span>’ extension. </p><!--l. 3209--><p class="indent" > The OpenDocument code employs MathML for formulas, and XSL-FO for formatting. It can be viewed by the <a href="http://www.openoffice.org/" >OpenOffice</a> word processor which, in turn, can export RTF and other MicroSoft-based formats (see also, Maarten Wisse, “Hacking TeX4ht for XML Output: The Road toward a TeX to Word Convertor”, <a href="http://www.ntg.nl/maps/electromaps.html" >MAPS</a> 28 (2002), pp. 28-35). </p><!--l. 3221--><p class="indent" > A command of the form ‘<span class="cmtt-10">htlatex filename "html,word" "symbol/!" "-cvalidate"</span>’ asks for HTML output tuned toward MicroSoft Word. Such a format, however, relies on bitmaps for mathematical formulas. </p> <h2 class="ChapterHead"><a name="QQ1-3-11"></a>DocBook and TEI</h2> <!--l. 3230--><p class="noindent" ><a name="index3-11001"></a> <a name="index3-11002"></a> <a name="index3-11003"></a> <a name="index3-11004"></a> <a name="index3-11005"></a> <a name="index3-11006"></a> <a name="index3-11007"></a> <a name="index3-11008"></a> <a name="index3-11009"></a> <a name="index3-11010"></a>The following commands may be used for requesting DocBook and TEI output. </p> <table id="TBL-2" ><tr > <td ><span class="cmtt-10">dbmlatex: </span></td><td ><span class="cmtt-10">htlatex </span><span class="cmti-10">filename </span><span class="cmtt-10">"xhtml,docbook-mml" " -cunihtf" </span></td></tr><tr > <td ><span class="cmtt-10">dblatex:</span></td><td ><span class="cmtt-10">htlatex </span><span class="cmti-10">filename </span><span class="cmtt-10">"xhtml,docbook" " -cunihtf" </span></td></tr><tr > <td ><span class="cmtt-10">teimlatex:</span></td><td ><span class="cmtt-10">htlatex </span><span class="cmti-10">filename </span><span class="cmtt-10">"xhtml,tei-mml" " -cunihtf" </span></td></tr><tr > <td ><span class="cmtt-10">teilatex:</span></td><td ><span class="cmtt-10">htlatex </span><span class="cmti-10">filename </span><span class="cmtt-10">"xhtml,tei" " -cunihtf" </span></td></tr></table> <h2 class="ChapterHead"><a name="QQ1-3-12"></a>JavaHelp</h2> <!--l. 3261--><p class="noindent" ><a name="index3-12001"></a> <a name="index3-12002"></a><a href="http://java.sun.com/products/javahelp/index.jsp" >JavaHelp</a> is an online documentation system for use by Java-based applications. Such documents can be produced from LaTeX files through commands similar to ‘<span class="cmtt-10">jhlatex </span><span class="cmti-10">filename</span>’ for JavaHelp version 2.0 (<span class="cmtt-10">jh1latex </span>for version 1.0). </p><!--l. 3269--><p class="indent" > The above invocation stands for ‘<span class="cmtt-10">htlatex </span><span class="cmti-10">filename </span><span class="cmtt-10">"html,3.2,javahelp,unicode" " -cmozhtf</span> <span class="cmtt-10">-u10" "-dfilename-doc/ -cjavahelp"</span>’. The ‘<span class="cmtt-10">-u10</span>’ asks for entity references in base 10—JavaHelp doesn’t seem to support hexadecimal representations. The <span class="cmtt-10">-cjavahelp </span>invokes the JavaHelp indexer to produce the search database at ‘jobname-doc/jobname-jhs’ with a command similar to ‘<span class="cmtt-10">java -jar</span> <span class="cmtt-10">${HOME}/jh2.0/javahelp/bin/jhindexer.jar -db jobname-doc/jobname-jhs jobname*.html</span>’. </p><!--l. 3281--><p class="indent" > The Java program is to be distributed with the jobname-doc directory. </p> <h2 class="ChapterHead"><a name="QQ1-3-13"></a>Private Configuration Files</h2> <!--l. 3430--><p class="noindent" ><a name="index3-13001"></a><a name="prvCfgFiles"></a>The leading entry, in the first list of options of the <span class="cmtt-10">htlatex</span>-like commands, can equal ‘<span class="cmtt-10">html</span>’ or ‘<span class="cmtt-10">xhtml</span>’. If this is not the case, the entry is assumed to be the name of a configuration file. The extension ‘<span class="cmtt-10">cfg</span>’ is assumed for names of configuration files that are listed without their extension. </p><!--l. 3438--><p class="indent" > A configuration file should take the following form for LaTeX files. </p> <div class="Template"> <span class="cmtt-10">...</span><span class="cmti-10">early definitions</span><span class="cmtt-10">...</span><br /> <span class="cmtt-10">\Preamble{</span><span class="cmti-10">options</span><span class="cmtt-10">}</span><br /> <span class="cmtt-10">...</span><span class="cmti-10">definitions</span><span class="cmtt-10">...</span><br /> <span class="cmtt-10">\begin{document}</span><br /> <span class="cmtt-10">...</span><span class="cmti-10">insertions into the header of the html file</span><span class="cmtt-10">...</span><br /> <span class="cmtt-10">\EndPreamble </span></div> <!--l. 3452--><p class="indent" > It is up to the user to decide the distribution of entries between the <span class="cmtt-10">\Preamble </span>and the <span class="cmtt-10">htlatex</span>-like commands. </p> <div class="EXAMPL"><span class="cmbx-10">Example </span>The command ‘<span class="cmtt-10">htlatex myfile "mycfg,2"</span>’ requests the compilation of a file named myfile.tex, in the presence of a configuration file named mycfg.cfg. The configuration file might have the following content. <div class="Verbatim"><span class="cmtt-10">\Preamble{html}</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">\begin{document}</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> \Css{body</span><span class="cmtt-10"> {</span><span class="cmtt-10"> color</span><span class="cmtt-10"> :</span><span class="cmtt-10"> red;</span><span class="cmtt-10"> }}</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10">\EndPreamble</span><span class="cmtt-10"> </span> <br /></div> </div> <div class="Notes"><span class="cmbx-10">Notes</span> <ul > <li>Notice that for a LaTeX file the <span class="cmtt-10">\begin{document} </span>instruction should be present both in the configuration file and the source file. <!--l. 3475--><p class="noindent" ></p></li> <li>Instructions defined within a source file may be redefined in a configuration file. Such a feature enables to keep source files intact for compilation to different formats by different tools. <!--l. 3480--><p class="indent" > For instance, a definition of the form <span class="cmtt-10">\renewcommand\mycommand{...} </span>within a configuration file provided for the following LaTeX source. </p><div class="Verbatim"><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \documentclass{...}</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \newcommand\mycommand{...}</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \begin{document}</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> Use</span><span class="cmtt-10"> \mycommand{...}</span><span class="cmtt-10"> </span> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \end{document}</span><span class="cmtt-10"> </span> <br /></div> </li></ul> </div> <h2 class="ChapterHead"><a name="QQ1-3-14"></a>An Insight into the Commands</h2> <!--l. 3504--><p class="noindent" >Given a LaTeX file </p><div class="ShowCode"> <br /> <span class="cmtt-10">\documentclass{article}</span> <br /> <span class="cmtt-10">\begin{document}</span> <br /> <span class="cmtt-10">..................</span> <br /> <span class="cmtt-10">\end{document}</span> </div> <!--l. 3514--><p class="noindent" >the ‘<span class="cmtt-10">htlatex </span><span class="cmti-10">filename</span>’ command produces a call ‘<span class="cmtt-10">latex </span><span class="cmti-10">filename</span>’ to LaTeX on an implicit file of the following form. </p><div class="ShowCode"> <br /> <span class="cmtt-10">\documentclass{article}</span> <br /> <span class="showcode"><span class="cmtt-10">\usepackage{tex4ht}</span></span> <br /> <span class="cmtt-10">\begin{document}</span> <br /> <span class="cmtt-10">..................</span> <br /> <span class="cmtt-10">\end{document}</span> </div> <!--l. 3528--><p class="noindent" >Similarly, the command ‘<span class="cmtt-10">htlatex </span><span class="cmti-10">filename </span><span class="cmtt-10">"</span><span class="cmti-10">options</span><span class="cmtt-10">"</span>’ produces a call to a ‘<span class="cmtt-10">latex </span><span class="cmti-10">filename</span>’ command on an implicit file of the following form. </p><div class="ShowCode"> <br /> <span class="cmtt-10">\documentclass{article}</span> <br /> <span class="cmtt-10">\usepackage[</span><span class="showcode"><span class="cmtt-10">options</span></span><span class="cmtt-10">]{tex4ht}</span> <br /> <span class="cmtt-10">\begin{document}</span> <br /> <span class="cmtt-10">..................</span> <br /> <span class="cmtt-10">\end{document}</span> </div> <a name="index3-14001"></a>The command ‘<span class="cmtt-10">ht latex </span><span class="cmti-10">filename </span>’ may be used, instead of the ‘<span class="cmtt-10">htlatex </span><span class="cmti-10">filename </span><span class="cmtt-10">"</span><span class="cmti-10">options</span><span class="cmtt-10">"</span>’ command, in cases that the <span class="cmtt-10">\usepackage </span>instruction is explicitly introduced into the source files. <h2 class="ChapterHead"><a name="QQ1-3-15"></a>A Deeper Insight</h2> <!--l. 3554--><p class="noindent" >From the perspective of TeX4ht, the <span class="cmtt-10">htlatex</span>-like commands, and the <span class="cmtt-10">\usepackage</span>, are indirect approaches for getting LaTeX files of the following form. Such files can be explicitly provided for compilations requested through the ‘<span class="cmtt-10">ht latex </span><span class="cmti-10">filename</span>’ command. </p><div class="ShowCode"> <br /> <span class="cmtt-10">\documentclass{article}</span> <br /> <span class="cmtt-10">.....</span> <br /> <span class="cmtt-10">\input</span> <span class="cmtt-10">tex4ht.sty</span> <br /> <span class="cmtt-10">.....</span> <br /> <span class="cmtt-10">\Preamble{</span><span class="showcode"><span class="cmtt-10">options</span></span><span class="cmtt-10">}</span> <br /> <span class="cmtt-10">.....</span> <br /> <span class="cmtt-10">\begin{document}</span> <br /> <span class="cmtt-10">.....</span> <br /> <span class="cmtt-10">\EndPreamble</span> <br /> <span class="cmtt-10">..................</span> <br /> <span class="cmtt-10">\end{document}</span> </div> <h2 class="ChapterHead"><a name="QQ1-3-16"></a>TeX, ConTeXt, and TeXi</h2> <!--l. 3584--><p class="noindent" ><a name="index3-16001"></a> <a name="index3-16002"></a> <a name="index3-16003"></a> <a name="index3-16004"></a>Commands similar to those offered for LaTeX are also offered for TeX (dbmtex, dbtex, ht, httex, mztex, ootex, t4ht, teimtex, teitex, tex4ht, xhmtex, xhtex) and TeXi (dbmtexi, dbtexi, httexi, mztexi, ootexi, teimtexi, teitexi, xhmtexi, xhtexi). In the case of TeX, the fragment of code ‘<span class="cmtt-10">\csname tex4ht\endcsname</span>’ should be introduced by the user into the source file, after the preamble of the file where the document definitions reside (<a href="mn6.html" name="mn6.html" >example</a>). In the case of TeXi, such a code fragment is introduced implicitly. </p><!--l. 3612--><p class="indent" > The private configuration files are similar to those of LaTeX, with the instruction ‘<span class="cmtt-10">\begin{document}</span>’ excluded. </p> <div class="Template"> <span class="cmtt-10">...</span><br /> <span class="cmtt-10">\Preamble{</span><span class="cmti-10">options</span><span class="cmtt-10">}</span><br /> <span class="cmtt-10">...</span><br /> <span class="cmtt-10">\begin{document}</span><br /> <span class="cmtt-10">...</span><br /> <span class="cmtt-10">\EndPreamble</span><br /> <span class="cmtt-10">... </span></div> The ‘<span class="cmtt-10">ht tex </span><span class="cmti-10">filename </span>’ and ‘<span class="cmtt-10">ht texi </span><span class="cmti-10">filename </span>’ commands may apply for TeX and TeXi sources that embed such code fragments in their body. The embeded code should replace the ‘<span class="cmtt-10">\csname tex4ht\endcsname</span>’ fragment in TeX sources, be palces at the strat of the files in TeXi sources, and not include the <span class="cmtt-10">\begin{document}</span> instruction. <!--l. 3636--><p class="indent" > <a name="index3-17001"></a> <a name="index3-17002"></a>For <a href="http://www.pragma-ade.com/" >ConTeXt</a> similar instructions apply with suffixes ‘<span class="cmtt-10">context</span>’ instead of ‘<span class="cmtt-10">latex</span>’, ‘<span class="cmtt-10">tex</span>’, or ‘<span class="cmtt-10">texi</span>’. For instance, ‘<span class="cmtt-10">htcontext’ </span>. </p> <h2 class="ChapterHead"><a name="QQ1-3-18"></a>Other Options</h2> <!--l. 3649--><p class="noindent" > </p><ul > <li> <a name="index3-18001"></a>XeTeX files can be compiled with htlatex-like instructions (e.g., htxelatex, htxetex, mzxelatex). Currently only partial support is provided and only TeX-based fonts are handled. </li> <li> <a name="index3-18002"></a>A <a href="http://www.math.union.edu/~dpvc/jsMath/welcome.html" >jsMath</a> mode of output may be requested with instructions similar to the following one. <div class="centerline"><span class="cmtt-10">htlatex file "xhtml,jsmath" " -cmozhtf"</span></div> <!--l. 3662--><p class="noindent" ></p></li> <li> <a name="index3-18003"></a>The dvipng utility might be activated for bitmap constructions through a request ‘-cdvipng’ in the third options list. For instance, <div class="centerline"><span class="cmtt-10">htlatex file "" "" "-cdvipng"</span></div> <!--l. 3669--><p class="indent" > This utility is reported to produce fast high quality output with much smaller files than other convertors. </p><!--l. 3672--><p class="noindent" ></p></li> <li> <a name="index3-18004"></a>TeX4ht offers also <a href="http://www.cse.ohio-state.edu/~gurari/laspeak" >speech</a> output formats. </li></ul> <h2 class="ChapterHead"><a name="QQ1-3-19"></a>Validation</h2> <!--l. 3684--><p class="noindent" ><a name="index3-19001"></a>The outcome of the translations should be checked by validators for proper syntax. Typically, with the presence of validators, errors are easy to detect and correct, but they require human intervention. </p><!--l. 3689--><p class="indent" > TeX4ht doesn’t offer a built-in parser to verify the correctness of the outcome. However, external validator(s) can quite easily be integrated into the compilation process. </p> <h2 class="ChapterHead"><a name="QQ1-3-20"></a>Recommendations</h2> <!--l. 3698--><p class="noindent" >To keep with the spirit of LaTeX and hypertext, in which style is assumed to be separated from content, the users are encouraged to avoid inserting TeX4ht code into their source files. Instead, they should place their modifications, to the default settings, within private configuration files to be loaded by htlatex-like commands. </p><!--l. 3705--><p class="indent" > On the other hand, it should be noted that hypertext markings should adhere to strict rules specified by different standards. Consequently, it is strongly advised to check the output obtained from the default configurations, before trying to tailor new ones. </p> </body></html>