<?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>Within</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#mn7.html" >up</a></p> <h2 class="ChapterHead"><a name="QQ1-7-22"></a>Configurations</h2><div class="TableOfContents"><span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-23" name="QQ2-7-23">Background</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-24" name="QQ2-7-24">Recommendations</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-25" name="QQ2-7-25">Low-Level Features</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-26" name="QQ2-7-26">Sectioning and Tables of Contents</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-27" name="QQ2-7-27">Tables</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-28" name="QQ2-7-28">Lists and Environments</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-29" name="QQ2-7-29">Pictures</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-30" name="QQ2-7-30">Mathematical Formulas</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-31" name="QQ2-7-31">Paragraphs</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-32" name="QQ2-7-32">Cascade Style Sheets (CSS)</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-33" name="QQ2-7-33">Fonts</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-35" name="QQ2-7-35">Scripts</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-36" name="QQ2-7-36">Configurable Hooks</a></span> <span class="DocChapter"><span class="cmsy-10">∙</span> <a href="#QQ1-7-37" name="QQ2-7-37">General Configuration Files</a></span> </div> <h2 class="ChapterHead"><a name="QQ1-7-23"></a>Background</h2> <!--l. 3755--><p class="noindent" >TeX4ht handles correctly only macros whose logical meanings are directly or indirectly declared in TeX4ht configurations. For instance, without extra configurations, TeX4ht will provide correct translation for </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"> \divide{a}{b}</span><span class="cmtt-10"> </span> <br /></div> <!--l. 3765--><p class="indent" > under a user’s definition of the form </p><div class="Verbatim"><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \def\divide#1#2{{#1\over</span><span class="cmtt-10"> #2}}</span><span class="cmtt-10"> </span> <br /></div> <!--l. 3771--><p class="indent" > but not under a definition of the form </p><div class="Verbatim"><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \def\divide#1#2{\vbox{\hbox{$#1$}\hrule\hbox{$#2$}}}</span><span class="cmtt-10"> </span> <br /></div> <h2 class="ChapterHead"><a name="QQ1-7-24"></a>Recommendations</h2> <!--l. 3781--><p class="noindent" ><a name="index7-24001"></a> <a name="index7-24002"></a>It is highly recommended to leave source LaTeX and TeX files intact, and not introduce TeX4ht configurations there. The configurations should be introduced indirectly in private <a href="mn-commands.html#prvCfgFiles">configuration files</a>. Source files containing just native LaTeX and TeX code permit their compilation to different output formats, including PostScript and PDF, by TeX4ht and other tools. </p><!--l. 3792--><p class="indent" > Packages used by the general LaTeX community typically provide better support than one can expect from tailoring private commands and configurations for such commands. It is also expected to take less effort to learn the features of existing packages than designing new ones. Consequently, one is advised to investigate available resources before committing to work on private features. </p> <h2 class="ChapterHead"><a name="QQ1-7-25"></a>Low-Level Features</h2> <!--l. 3803--><p class="noindent" >The following are some of the more useful underlying commands of TeX4ht. </p><!--l. 3806--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn8.html#mn8-1" name="mn8-1" >1</a></td><td class="button-list"> <a name="index7-25001"></a><span class="cmtt-10">\HCode{...}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn8.html#mn8-2" name="mn8-2" >2</a></td><td class="button-list"> <a name="index7-25004"></a> <span class="cmtt-10">\HPage{</span><span class="cmti-10">anchor</span><span class="cmtt-10">}</span><span class="cmti-10">content</span><span class="cmtt-10">\EndHPage{}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn8.html#mn8-3" name="mn8-3" >3</a></td><td class="button-list"> <a name="index7-25007"></a><span class="cmtt-10">\Link[</span><span class="cmti-10">target-file arguments</span><span class="cmtt-10">]{</span><span class="cmti-10">target-loc</span><span class="cmtt-10">}{</span><span class="cmti-10">cur-loc</span><span class="cmtt-10">}</span><span class="cmti-10">anchor</span><span class="cmtt-10">\EndLink</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn8.html#mn8-4" name="mn8-4" >4</a></td><td class="button-list"> <a name="index7-25012"></a><span class="cmtt-10">\ifOption{...}{</span><span class="cmti-10">true-part</span><span class="cmtt-10">}{</span><span class="cmti-10">false-part</span><span class="cmtt-10">}</span> </td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-26"></a>Sectioning and Tables of Contents</h2> <!--l. 3903--><p class="noindent" ><a name="index7-26001"></a> <a name="index7-26002"></a> <a name="index7-26003"></a> <a name="index7-26004"></a> <a name="index7-26005"></a>A non-leading command line argument ‘<span class="cmtt-10">1</span>’, ‘<a href="mn9.html" name="mn9.html" ><span class="cmtt-10">2</span></a>’, ‘<span class="cmtt-10">3</span>’, or ‘<span class="cmtt-10">4</span>’ asks for a tree-structured set of files, reflecting on the sectioning of the document to the specified depth. Sequential prev-next links within the hierarchy, instead of the default hierarchical ones, can be requested with the ‘<span class="cmtt-10">next</span>’ parameter. The parameter ‘<span class="cmtt-10">sections+</span>’ creates titles for the sectioning commands that link to the tables of contents. </p><!--l. 3932--><p class="indent" > Finer control is possible with the following commands. </p><!--l. 3934--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-1" name="mn10-1" >1</a></td><td class="button-list"> <a name="index7-26006"></a><span class="cmtt-10">\CutAt{</span><span class="cmti-10">at-unit</span><span class="cmtt-10">,</span><span class="cmti-10">until-unit-1</span><span class="cmtt-10">,</span><span class="cmti-10">until-unit-2</span><span class="cmtt-10">,...}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-2" name="mn10-2" >2</a></td><td class="button-list"> <a name="index7-26008"></a><span class="cmtt-10">\tableofcontents[</span><span class="cmti-10">unit-1</span><span class="cmtt-10">,</span><span class="cmti-10">unit-2</span><span class="cmtt-10">,...]</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-3" name="mn10-3" >3</a></td><td class="button-list"> <a name="index7-26010"></a><span class="cmtt-10">\TocAt{</span><span class="cmti-10">at-unit</span><span class="cmtt-10">,</span><span class="cmti-10">unit-1</span><span class="cmtt-10">,</span><span class="cmti-10">unit-2</span><span class="cmtt-10">,...,/</span><span class="cmti-10">until-unit-1</span><span class="cmtt-10">,/</span><span class="cmti-10">until-unit-2</span><span class="cmtt-10">,...}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-4" name="mn10-4" >4</a></td><td class="button-list"> <a name="index7-26013"></a><span class="cmtt-10">\ConfigureToc{</span><span class="cmti-10">unit</span><span class="cmtt-10">} {</span><span class="cmti-10">before-mark</span><span class="cmtt-10">} {</span><span class="cmti-10">before-title</span><span class="cmtt-10">} {</span><span class="cmti-10">before-page-number</span><span class="cmtt-10">} {</span><span class="cmti-10">at-end</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-5" name="mn10-5" >5</a></td><td class="button-list"> <a name="index7-26015"></a><span class="cmtt-10">\Configure{tableofcontents} {</span><span class="cmti-10">before-toc</span><span class="cmtt-10">} {</span><span class="cmti-10">end-of-toc</span><span class="cmtt-10">} {</span><span class="cmti-10">after-toc</span><span class="cmtt-10">} {</span><span class="cmti-10">before-nonindented-par</span><span class="cmtt-10">}</span> <span class="cmtt-10">{</span><span class="cmti-10">before-indented-par</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-6" name="mn10-6" >6</a></td><td class="button-list"> <a name="index7-26017"></a><span class="cmtt-10">\Configure{TocAt} {</span><span class="cmti-10">before-toc</span><span class="cmtt-10">} {</span><span class="cmti-10">after-toc</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-7" name="mn10-7" >7</a></td><td class="button-list"> <a name="index7-26019"></a><span class="cmtt-10">\Configure{TocAt*} {</span><span class="cmti-10">before-toc</span><span class="cmtt-10">} {</span><span class="cmti-10">after-toc</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-8" name="mn10-8" >8</a></td><td class="button-list"> <a name="index7-26021"></a><span class="cmtt-10">\Configure{</span><span class="cmti-10">unit</span><span class="cmtt-10">} {</span><span class="cmti-10">top</span><span class="cmtt-10">} {</span><span class="cmti-10">bottom</span><span class="cmtt-10">} {</span><span class="cmti-10">before-title</span><span class="cmtt-10">} {</span><span class="cmti-10">after-title</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-9" name="mn10-9" >9</a></td><td class="button-list"> <a name="index7-26023"></a><span class="cmtt-10">\Configure{CutAt} {</span><span class="cmti-10">unit</span><span class="cmtt-10">} {</span><span class="cmti-10">before-button</span><span class="cmtt-10">} {</span><span class="cmti-10">after-button</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-10" name="mn10-10" >10</a></td><td class="button-list"> <a name="index7-26025"></a><span class="cmtt-10">\Configure{+CutAt} {</span><span class="cmti-10">unit</span><span class="cmtt-10">} {</span><span class="cmti-10">before-button</span><span class="cmtt-10">} {</span><span class="cmti-10">after-button</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-11" name="mn10-11" >11</a></td><td class="button-list"> <a name="index7-26027"></a><span class="cmtt-10">\NewSection\</span><span class="cmti-10">unit </span><span class="cmtt-10">{</span><span class="cmti-10">mark-for-toc</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-12" name="mn10-12" >12</a></td><td class="button-list"> <a name="index7-26029"></a><span class="cmtt-10">\Configure{writetoc} {</span><span class="cmti-10">definitions-for-the-writing-environment</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-13" name="mn10-13" >13</a></td><td class="button-list"> <a name="index7-26031"></a><span class="cmtt-10">\Configure{crosslinks} {</span><span class="cmti-10">left-delimiter</span><span class="cmtt-10">} {</span><span class="cmti-10">right-delimiter</span><span class="cmtt-10">} {</span><span class="cmti-10">next</span><span class="cmtt-10">} {</span><span class="cmti-10">prev</span><span class="cmtt-10">} {</span><span class="cmti-10">prev-tail</span><span class="cmtt-10">} {</span><span class="cmti-10">front</span><span class="cmtt-10">} {</span><span class="cmti-10">tail</span><span class="cmtt-10">}</span> <span class="cmtt-10">{</span><span class="cmti-10">up</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn10.html#mn10-14" name="mn10-14" >14</a></td><td class="button-list"> <a name="index7-26033"></a><span class="cmtt-10">\Configure{crosslinks+} {</span><span class="cmti-10">before-top-links</span><span class="cmtt-10">} {</span><span class="cmti-10">after-top-links</span><span class="cmtt-10">} {</span><span class="cmti-10">before-bottom-links</span><span class="cmtt-10">} {</span><span class="cmti-10">after-bottob-links</span><span class="cmtt-10">}</span> </td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-27"></a>Tables</h2> <!--l. 4243--><p class="noindent" ><a name="index7-27001"></a>Tables with <span class="cmtt-10">\multicolum </span>entries need a few LaTeX compilations to stabilize. </p><!--l. 4249--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn11.html#mn11-1" name="mn11-1" >1</a></td><td class="button-list"> <a name="index7-27002"></a> <a name="index7-27003"></a> <a name="index7-27004"></a><span class="cmtt-10">\Configure{</span><span class="cmti-10">table</span><span class="cmtt-10">} {</span><span class="cmti-10">before-tbl</span><span class="cmtt-10">} {</span><span class="cmti-10">after-tbl</span><span class="cmtt-10">} {</span><span class="cmti-10">before-row</span><span class="cmtt-10">} {</span><span class="cmti-10">after-row</span><span class="cmtt-10">} {</span><span class="cmti-10">before-entry</span><span class="cmtt-10">} {</span><span class="cmti-10">after-entry</span><span class="cmtt-10">}</span> </td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-28"></a>Lists and Environments</h2> <!--l. 4312--><p class="noindent" ><a name="index7-28001"></a> <a name="index7-28002"></a>The appearances of lists and <span class="cmtt-10">\begin</span>-<span class="cmtt-10">\end </span>environments are configured with the following commands. </p><!--l. 4318--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn12.html#mn12-1" name="mn12-1" >1</a></td><td class="button-list"> <a name="index7-28003"></a><span class="cmtt-10">\ConfigureList{</span><span class="cmti-10">list-name</span><span class="cmtt-10">} {</span><span class="cmti-10">before-list</span><span class="cmtt-10">} {</span><span class="cmti-10">after-list</span><span class="cmtt-10">} {</span><span class="cmti-10">before-label</span><span class="cmtt-10">} {</span><span class="cmti-10">after-label</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn12.html#mn12-2" name="mn12-2" >2</a></td><td class="button-list"> <a name="index7-28015"></a><span class="cmtt-10">\ConfigureEnv{</span><span class="cmti-10">environment-name</span><span class="cmtt-10">} {</span><span class="cmti-10">before-environment</span><span class="cmtt-10">} {</span><span class="cmti-10">after-environment</span><span class="cmtt-10">} {</span><span class="cmti-10">before-list</span><span class="cmtt-10">}</span> <span class="cmtt-10">{</span><span class="cmti-10">after-list</span><span class="cmtt-10">}</span> </td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-29"></a>Pictures</h2> <!--l. 4415--><p class="noindent" ><a name="index7-29001"></a>The next command imports external pictures, and the two commands that follow request pictorial representations for local content. The attributes, and the replacement parameters with their enclosing rectangular brackets, are optional. </p><!--l. 4420--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn13.html#mn13-1" name="mn13-1" >1</a></td><td class="button-list"> <a name="index7-29002"></a><span class="cmtt-10">\Picture[</span><span class="cmti-10">replacement-for-textual-browser</span><span class="cmtt-10">]{</span><span class="cmti-10">file-name attributes</span><span class="cmtt-10">}</span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn13.html#mn13-2" name="mn13-2" >2</a></td><td class="button-list"><span class="cmtt-10">\Picture+[</span><span class="cmti-10">replacement-for-text-browsers</span><span class="cmtt-10">]{</span><span class="cmti-10">file-name attributes</span><span class="cmtt-10">}</span><span class="cmti-10">content</span><span class="cmtt-10">\EndPicture</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn13.html#mn13-3" name="mn13-3" >3</a></td><td class="button-list"><span class="cmtt-10">\Picture*[</span><span class="cmti-10">replacement-for-text-browsers</span><span class="cmtt-10">]{</span><span class="cmti-10">file-name attributes</span><span class="cmtt-10">}</span><span class="cmti-10">content</span><span class="cmtt-10">\EndPicture</span> </td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-30"></a>Mathematical Formulas</h2> <!--l. 4479--><p class="noindent" ><a name="index7-30001"></a> <a name="index7-30002"></a> <a name="index7-30003"></a> <a name="index7-30004"></a> <a name="index7-30005"></a>In the default setting, the math environments ‘<span class="cmtt-10">\(...\)</span>’, and the display math environments ‘<span class="cmtt-10">\[...\]</span>’ and ‘<span class="cmtt-10">$$...$$</span>’, request pictorial representations for their content. On the other hand, the math environments ‘<span class="cmtt-10">$...$</span>’ ask for no special treatment. Simple features like mathematical symbols, subscripts, and superscripts, are translated into html, and more complex entities like roots and fractions are translated into pictures (<a href="mn14.html" name="mn14.html" >example</a>). </p><!--l. 4506--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn15.html#mn15-1" name="mn15-1" >1</a></td><td class="button-list"> <a name="index7-30006"></a> <a name="index7-30007"></a> <a name="index7-30008"></a> <a name="index7-30009"></a><span class="cmtt-10">\Configure{[]} {</span><span class="cmti-10">before</span><span class="cmtt-10">$$</span><span class="cmti-10">at-start</span><span class="cmtt-10">} {</span><span class="cmti-10">at-end</span><span class="cmtt-10">$$</span><span class="cmti-10">after</span><span class="cmtt-10">}</span>, <span class="cmtt-10">\Configure{()}{</span><span class="cmti-10">before</span><span class="cmtt-10">$</span><span class="cmti-10">at-start</span><span class="cmtt-10">}{</span><span class="cmti-10">at-end</span><span class="cmtt-10">$</span><span class="cmti-10">after</span><span class="cmtt-10">}</span><br /><span class="cmtt-10">\Configure{$$}{</span><span class="cmti-10">before</span><span class="cmtt-10">}{</span><span class="cmti-10">after</span><span class="cmtt-10">}{</span><span class="cmti-10">at-start</span><span class="cmtt-10">}</span><br /><span class="cmtt-10">\Configure{$}{</span><span class="cmti-10">before</span><span class="cmtt-10">}{</span><span class="cmti-10">after</span><span class="cmtt-10">}{</span><span class="cmti-10">at-start</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn15.html#mn15-2" name="mn15-2" >2</a></td><td class="button-list"> <a name="index7-30016"></a> <a name="index7-30017"></a> <a name="index7-30018"></a><span class="cmtt-10">\Configure{SUB}{</span><span class="cmti-10">before</span><span class="cmtt-10">}{</span><span class="cmti-10">after</span><span class="cmtt-10">}</span><br /><span class="cmtt-10">\Configure{SUP}{</span><span class="cmti-10">before</span><span class="cmtt-10">}{</span><span class="cmti-10">after</span><span class="cmtt-10">}</span><br /><span class="cmtt-10">\Configure{SUBSUP}{</span><span class="cmti-10">before</span><span class="cmtt-10">}{</span><span class="cmti-10">between</span><span class="cmtt-10">}{</span><span class="cmti-10">after</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn15.html#mn15-3" name="mn15-3" >3</a></td><td class="button-list"> <a name="index7-30022"></a> <a name="index7-30023"></a> <a name="index7-30024"></a> <a name="index7-30025"></a><span class="cmtt-10">no_</span>, <span class="cmtt-10">no^ </span></td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-31"></a>Paragraphs</h2> <!--l. 4615--><p class="noindent" ><a name="index7-31001"></a>The insertions of code at paragraph breaks are controlled by the following commands. </p><!--l. 4618--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn16.html#mn16-1" name="mn16-1" >1</a></td><td class="button-list"> <a name="index7-31002"></a> <a name="index7-31003"></a><span class="cmtt-10">\Configure{HtmlPar} {</span><span class="cmti-10">noindent-P</span><span class="cmtt-10">} {</span><span class="cmti-10">indent-P</span><span class="cmtt-10">} {</span><span class="cmti-10">from-noindent-P</span><span class="cmtt-10">} {</span><span class="cmti-10">from-indent-P</span><span class="cmtt-10">} </span><br /><span class="cmtt-10">\EndP</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn16.html#mn16-2" name="mn16-2" >2</a></td><td class="button-list"> <a name="index7-31006"></a> <span class="cmtt-10">\IgnorePar </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn16.html#mn16-3" name="mn16-3" >3</a></td><td class="button-list"> <a name="index7-31008"></a> <span class="cmtt-10">\ShowPar </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn16.html#mn16-4" name="mn16-4" >4</a></td><td class="button-list"> <a name="index7-31010"></a> <span class="cmtt-10">\IgnoreIndent </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn16.html#mn16-5" name="mn16-5" >5</a></td><td class="button-list"> <a name="index7-31012"></a> <span class="cmtt-10">\ShowIndent </span></td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-32"></a>Cascade Style Sheets (CSS)</h2> <!--l. 4727--><p class="noindent" ><a name="index7-32001"></a>Cascade style sheets attach presentations to the content of hypertext pages, in a manner similar to the way that ‘<span class="cmtt-10">.sty</span>’ files define the presentations to the content of source LaTeX files. TeX4ht produces a CSS file for each document that is translated to HTML transitional 4.0 code. The following are related commands. </p><!--l. 4735--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn17.html#mn17-1" name="mn17-1" >1</a></td><td class="button-list"><span class="cmtt-10">\Css{</span><span class="cmti-10">content</span><span class="cmtt-10">}</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn17.html#mn17-2" name="mn17-2" >2</a></td><td class="button-list"> <a name="index7-32002"></a><span class="cmtt-10">\Css </span><span class="cmti-10">content</span><span class="cmtt-10">\EndCss</span> </td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn17.html#mn17-3" name="mn17-3" >3</a></td><td class="button-list"> <a name="index7-32004"></a><span class="cmtt-10">\CssFile[</span><span class="cmti-10">list-of-css-files</span><span class="cmtt-10">]</span><span class="cmti-10">content</span><span class="cmtt-10">\EndCssFile</span> </td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-33"></a>Fonts</h2> <!--l. 4811--><p class="noindent" ><a name="index7-33001"></a>TeX4ht has an elaborated machinery for handling fonts, through special virtual hypertext fonts stored in ‘<span class="cmtt-10">.htf</span>’ files. Instead of providing a design for each symbol, as is the case in standard fonts, the virtual fonts provide a content for each symbol. The following commands offer some control, from within the source LaTeX documents, over the content provided to the symbols. </p><!--l. 4820--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn18.html#mn18-1" name="mn18-1" >1</a></td><td class="button-list"> <a name="index7-33002"></a><span class="cmtt-10">\NoFonts </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn18.html#mn18-2" name="mn18-2" >2</a></td><td class="button-list"> <a name="index7-33004"></a><span class="cmtt-10">\EndNoFonts </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn18.html#mn18-3" name="mn18-3" >3</a></td><td class="button-list"> <a name="index7-33006"></a><span class="cmtt-10">\Configure{htf} {</span><span class="cmti-10">class</span><span class="cmtt-10">} {</span><span class="cmti-10">delimiter</span><span class="cmtt-10">} {</span><span class="cmti-10">template-1</span><span class="cmtt-10">} {</span><span class="cmti-10">template-2</span><span class="cmtt-10">} {</span><span class="cmti-10">template-3</span><span class="cmtt-10">} {</span><span class="cmti-10">template-4</span><span class="cmtt-10">} {</span><span class="cmti-10">template-5</span><span class="cmtt-10">}</span> <span class="cmtt-10">{</span><span class="cmti-10">template-6</span><span class="cmtt-10">} {</span><span class="cmti-10">template-7</span><span class="cmtt-10">} </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn18.html#mn18-4" name="mn18-4" >4</a></td><td class="button-list"> <a name="index7-33008"></a><span class="cmtt-10">\Configure{htf-sty} {</span><span class="cmti-10">class/font</span><span class="cmtt-10">} {</span><span class="cmti-10">CSS-instructions</span><span class="cmtt-10">} </span></td></tr></table> <!--l. 4978--><p class="indent" > The <span class="cmtt-10">htf </span>fonts might request pictorial representations for symbols. In such cases, the sizes of the pictures depend on the sizes of the TeX fonts in use. Size changes through the <span class="cmtt-10">\magnification </span>command should be made before loading the <span class="cmtt-10">tex4ht.sty </span>package. </p><!--l. 4985--><p class="indent" > The design of a virtual hypertext font might take some labor, but it does not <a href="mn-htf.html" name="mn-htf.html" >require</a> too much sophistication. </p><!--l. 5173--><p class="indent" > A font of TeX may have more than one htf font to map to. The search for a desired version can be regulated within <a href="mn38.html#alt-htf">scripts</a>. </p> <h2 class="ChapterHead"><a name="QQ1-7-35"></a>Scripts</h2> <!--l. 5181--><p class="noindent" >Scripts produce the content in verbatim format with no decorations. </p><!--l. 5185--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn20.html#mn20-1" name="mn20-1" >1</a></td><td class="button-list"> <a name="index7-35001"></a><span class="cmtt-10">\ScriptEnv{</span><span class="cmti-10">environment</span><span class="cmtt-10">} {</span><span class="cmti-10">prefix</span><span class="cmtt-10">} {</span><span class="cmti-10">postfix</span><span class="cmtt-10">} </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn20.html#mn20-2" name="mn20-2" >2</a></td><td class="button-list"> <a name="index7-35003"></a><span class="cmtt-10">\ScriptCommand{\</span><span class="cmti-10">command</span><span class="cmtt-10">} {</span><span class="cmti-10">prefix</span><span class="cmtt-10">} {</span><span class="cmti-10">postfix</span><span class="cmtt-10">} </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn20.html#mn20-3" name="mn20-3" >3</a></td><td class="button-list"> <a name="index7-35005"></a><span class="cmtt-10">\JavaScript...\EndJavaScript </span></td></tr></table> <h2 class="ChapterHead"><a name="QQ1-7-36"></a>Configurable Hooks</h2> <!--l. 5244--><p class="noindent" >Much of the look and feel of TeX4ht is achieved through hooks that are introduced and configured with the following commands. </p><!--l. 5248--><p class="indent" > </p> <table class="button-list"> <tr valign="top" class="button-list"><td class="button-list"><a href="mn21.html#mn21-1" name="mn21-1" >1</a></td><td class="button-list"> <a name="index7-36001"></a><span class="cmtt-10">\NewConfigure{</span><span class="cmti-10">name</span><span class="cmtt-10">}[</span><span class="cmti-10">i</span><span class="cmtt-10">]{</span><span class="cmti-10">body</span><span class="cmtt-10">} </span></td></tr> <tr valign="top" class="button-list"><td class="button-list"><a href="mn21.html#mn21-2" name="mn21-2" >2</a></td><td class="button-list"> <a name="index7-36003"></a><span class="cmtt-10">\Configure{</span><span class="cmti-10">name</span><span class="cmtt-10">}{</span><span class="cmti-10">parameter-1</span><span class="cmtt-10">}...{</span><span class="cmti-10">parameter-i</span><span class="cmtt-10">}</span> </td></tr></table> <!--l. 5288--><p class="indent" > Block <span class="cmtt-10">{\begin}</span><span class="cmmi-10">…</span><span class="cmtt-10">\end </span>environments may also be configured through the <span class="cmtt-10">\ConfigureEnv </span>command, and lists may also employ the <span class="cmtt-10">\ConfigureList </span>command. </p><!--l. 5293--><p class="indent" > For help configuring hooks already seeded in the system, compile the source files in use with the ‘<span class="cmtt-10">info</span>’ option active and review the information in log files. Much of the information in the log files may also be obtained by running ‘<span class="cmtt-10">xhlatex mktex4ht.4ht</span>’ and reviewing the entries in the outcome page ‘<span class="cmtt-10">mktex4ht.html => index =></span> <span class="cmtt-10">mktex4ht</span>’. </p> <h2 class="ChapterHead"><a name="QQ1-7-37"></a>General Configuration Files</h2> <!--l. 5309--><p class="noindent" ><a name="index7-37001"></a><a name="confFiles"></a> <a name="index7-37002"></a>A compilation starts by opening <span class="cmtt-10">tex4ht.sty </span>and loading a fraction of its code. The main purpose of this phase is to request the loading of the system at a later time (for instance, upon reaching <span class="cmtt-10">\begin{document}</span>). The motivation for the late loading is to allow TeX4ht to collect as much information as possible about the environment requested by the source file, and help the system reshape that environment with minimal interference from elsewhere. </p><!--l. 5321--><p class="indent" > <a name="index7-37003"></a>The system uses two kinds of (4ht) configuration files. The files of the first kind mainly seed hooks into the macros loaded by the source file (for instance, <span class="cmtt-10">latex.4ht</span>, <span class="cmtt-10">fontmath.4ht</span>, and <span class="cmtt-10">article.4ht</span>). The files of the second kind mainly attach meaning to the hooks (for instance, <span class="cmtt-10">html4.4ht</span>, <span class="cmtt-10">unicode.4ht</span>, and <span class="cmtt-10">mathml.4ht</span>). </p><!--l. 5329--><p class="indent" > <a name="index7-37004"></a>Different source files may request the loading of different style files and in different orders. The hook seeding files are loaded in response to the loading of the style files, and in a compatible order. Since the different style files may redefine the syntax and semantics of macros, TeX4t follows a similar route of defining and redefining the hooks and their meanings. </p><!--l. 5337--><p class="indent" > <a name="index7-37005"></a>The meaning attaching files are normally requested through option names introduced in the <span class="cmtt-10">tex4ht.4ht </span>system file. For instance, the <span class="cmtt-10">mzlatex </span>command refers to the <span class="cmtt-10">mozilla </span>option name of <span class="cmtt-10">tex4ht.4ht</span>, and the <span class="cmtt-10">oolatex</span> command refers to the <span class="cmtt-10">ooffice </span>option name. The user may add option names, and redefine old ones, within a new file named <span class="cmtt-10">tex4ht.usr</span>. </p><!--l. 5345--><p class="indent" > A new <span class="cmtt-10">tex4ht.usr </span>file should group references to <span class="cmtt-10">*.4ht </span>configuration files under arbitrarily chosen option names. For that purpose, <span class="cmtt-10">\Configure </span>commands similar to those provided in <span class="cmtt-10">tex4ht.4ht </span>should be employed. </p><!--l. 5351--><p class="indent" > Variants of the htlatex-like scripts may be produced in the following manner. </p><!--l. 5354--><p class="indent" > </p><ol type="a" > <li>Adjust the <span class="cmtt-10">latex </span>(<span class="cmtt-10">tex</span>, <span class="cmtt-10">texi</span>) command of a given script to use a desired option name, and rename the new script. </li> <li>Make sure the <span class="cmtt-10">tex4ht </span>and <span class="cmtt-10">t4ht </span>commands receive appropriate switches in the new script. (These commands show the available options when invoked without parameters.) </li></ol> <!--l. 5365--><p class="indent" > The definition of new meaning assigning configuration files can be considerable simplified by relying on literate programming and the file <span class="cmtt-10">mktex4t.4ht</span>. For additional information, compile this file into a hypertext document, visit the ‘<span class="cmtt-10">index</span>’ page, and from there reach into the ‘<span class="cmtt-10">mktex4ht</span>’ page. </p> <div class="EXAMPL"><span class="cmbx-10">Example</span> <ol type="a" > <li>Add a configuration file <span class="cmtt-10">myooconfig.4ht </span>with the following content. <div class="Verbatim"><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \exit:ifnot{jurabib}</span><span class="cmtt-10"> </span> <br /><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> <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"> </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"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \ConfigureHinput{jurabib}</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> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \def\jbNoLink#1#2{}</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"> \Configure{jblink}{\jbNoLink}{}</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"> \Configure{jbanchor}{\jbNoLink}{}</span><span class="cmtt-10"> </span> <br /><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> <br /><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"> \endinput\empty\empty\empty\empty\empty\empty</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> <br /><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \endinput</span><span class="cmtt-10"> </span> <br /></div> <!--l. 5397--><p class="noindent" ></p></li> <li>Add to <span class="cmtt-10">tex4ht.usr </span>the following script. <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"> \Configure{myooffice}{%</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"> \:CheckOption{info}\if:Option</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"> </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"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \Hinclude[*]{infoht4.4ht}\fi</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"> \:CheckOption{info}\if:Option</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"> </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"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> </span><span class="cmtt-10"> \Hinclude[*]{infomml.4ht}\fi</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"> \Hinclude[*]{ooffice.4ht}%</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"> \Hinclude[*]{unicode.4ht}%</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"> \Hinclude[*]{mathml.4ht}%</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"> \Hinclude[*]{ooffice-mml.4ht}%</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"> \Hinclude[*]{myooconfig.4ht}%</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> <br /></div> <!--l. 5413--><p class="indent" > It is the ooffice script from <span class="cmtt-10">tex4ht.4ht</span>, with the added record ‘<span class="cmtt-10">\Hinclude[*]{myooconfig.4ht}%</span>’. </p><!--l. 5416--><p class="noindent" ></p></li> <li>Invoke the compilations with a variant of the following form of the <span class="cmtt-10">oolatex </span>command. <div class="centerline"><span class="cmtt-10">htlatex filename "xhtml,myooffice" "ooffice/!</span><span class="cmtt-10"> -cmozhtf" "-coo"</span></div> </li></ol> </div> </body></html>