diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn3.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/tex4ht/mn3.html | 633 |
1 files changed, 633 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn3.html b/Master/texmf-dist/doc/generic/tex4ht/mn3.html new file mode 100644 index 00000000000..4acd1bf7911 --- /dev/null +++ b/Master/texmf-dist/doc/generic/tex4ht/mn3.html @@ -0,0 +1,633 @@ +<?xml version="1.0" encoding="iso-8859-1" ?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "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.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)" /> +<meta name="originator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)" /> +<!-- xhtml,th4,index --> +<meta name="src" content="mn.tex" /> +<meta name="date" content="2004-02-11 18:07:00" /> +<link rel="stylesheet" type="text/css" href="mn.css" /> +</head><body +> + <p class="rightline"><a + href="mn.html#mn3.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">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 and TeXi</a></span> <span class="DocChapter"><span +class="cmsy-10">•</span> <a + href="#QQ1-3-18" name="QQ2-3-18">Validation</a></span> <span class="DocChapter"><span +class="cmsy-10">•</span> <a + href="#QQ1-3-19" name="QQ2-3-19">Recommendations</a></span> + </div> + <h2 class="ChapterHead"><a + name="QQ1-3-5"></a>From LaTeX to HTML</h2> +<!--l. 1791--><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="mn38.html" >overview</a>). +</p><!--l. 1800--><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></div> +<!--l. 1809--><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, and the third for the <span +class="cmtt-10">t4ht </span>postprocessor. For instance, +</p><!--l. 1822--><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. 1831--><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. 1835--><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</span> +<span +class="cmtt-10">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></dl> + <h2 class="ChapterHead"><a + name="QQ1-3-6"></a>Available Values for the Options</h2> +<!--l. 1864--><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. 1871--><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. 1876--><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. 1881--><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="mn6.html#confFiles">General Configuration +Files</a>). These values should be of little interest to most users. +</p><!--l. 1889--><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 valign="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 valign="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" "</span><span +class="cmtt-10"> -coo") </span></td></tr></table> + <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>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. For instance, +‘<span +class="cmtt-10">xhlatex filename</span>’ or ‘<span +class="cmtt-10">htlatex filename "xhtml"</span>’. +<!--l. 1916--><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> + <h2 class="ChapterHead"><a + name="QQ1-3-8"></a>XHTML with MathML</h2> +<!--l. 1926--><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>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,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"> 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"> xhmlatex</span><span +class="cmtt-10"> filename</span><span +class="cmtt-10"> </span> +<br /></div> +<!--l. 1947--><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"</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"</span>’; it does not make any compromizes toward +browsers. +</p><!--l. 1954--><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-9001"></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>OpenOffice and MS Word</h2> +<!--l. 2004--><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 translation for an <a + href="http://www.openoffice.org/" >OpenOffice</a> 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</span> +<span +class="cmtt-10">"xhtml,ooffice" "</span><span +class="cmtt-10"> -coo"</span>). The output of a command ‘<span +class="cmtt-10">oolatex filename</span>’ is a zipped file named with a ‘<span +class="cmtt-10">.sxw</span>’ +extension. +</p><!--l. 2023--><p class="indent"> The OpenOffice code employs MathML for formulas, and XSL-FO for formatting. It can be viewed by the +OpenOffice 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”, MAPS 28 (2002), +pp. 28-35). +</p><!--l. 2031--><p class="indent"> A command of the form ‘<span +class="cmtt-10">htlatex filename "html,word" "symbol/!"</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. 2040--><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. 2071--><p class="noindent"><a + name="index3-12001"></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">htlatex </span><span +class="cmti-10">filename </span><span +class="cmtt-10">"html,3.2,javahelp"</span>’ (see +<a + href="jhsample.tex" >jhsample.tex</a>). +</p> + <h2 class="ChapterHead"><a + name="QQ1-3-13"></a>Private Configuration Files</h2> +<!--l. 2225--><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. 2233--><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. 2247--><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. 2270--><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. 2275--><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. 2299--><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. 2309--><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. 2323--><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. 2349--><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 and TeXi</h2> +<!--l. 2379--><p class="noindent"><a + name="index3-16001"></a> <a + name="index3-16002"></a> <a + name="index3-16003"></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 into the source file, after the preamble of the file where the document definitions reside +(<a + href="mn5.html" name="mn5.html" >example</a>). In the case of TeXi, such a code fragment is introduced implicitly. +</p><!--l. 2407--><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. + <h2 class="ChapterHead"><a + name="QQ1-3-18"></a>Validation</h2> +<!--l. 2435--><p class="noindent"><a + name="index3-18001"></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. 2440--><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-19"></a>Recommendations</h2> +<!--l. 2449--><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. 2456--><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> |