diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn14.html')
| -rw-r--r-- | Master/texmf-dist/doc/generic/tex4ht/mn14.html | 503 |
1 files changed, 394 insertions, 109 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn14.html b/Master/texmf-dist/doc/generic/tex4ht/mn14.html index 11784eb8df4..317465590c5 100644 --- a/Master/texmf-dist/doc/generic/tex4ht/mn14.html +++ b/Master/texmf-dist/doc/generic/tex4ht/mn14.html @@ -1,132 +1,417 @@ <?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"> <!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd--> <html xmlns="http://www.w3.org/1999/xhtml" > <head><title></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)" /> +<meta name="generator" content="TeX4ht (https://tug.org/tex4ht/)" /> +<meta name="originator" content="TeX4ht (https://tug.org/tex4ht/)" /> <!-- 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 > -<!--l. 3266--><p class="noindent"><a - href="mn6.html#mn14-1" name="mn14-1" >1</a>. <a - name="index14-29010"></a> <a - name="index14-29011"></a> <a - name="index14-29012"></a> <a - name="index14-29013"></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>, +<!--l. 5279--><p class="noindent" ><a + href="mn11.html#mn14-1" name="mn14-1" >1</a>. <a + name="index14-55007"></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> +</p><!--l. 5281--><p class="indent" > This directive asks the sectioning commands <span +class="cmtt-10">\</span><span +class="cmti-10">at-unit </span>to place their units in separate hypertext pages. The +pages are to terminate upon encountering any of the commands in the list <span +class="cmtt-10">\</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">\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">until-unit-2</span>,... + </p><div class="ShowCode"> + <br /> <span class="showcode"><span +class="cmtt-10">\CutAt{section,chapter}</span></span> + <br /> <span +class="cmtt-10">\tableofcontents</span> + <br /> <span +class="cmtt-10">\chapter{...}</span> <span +class="cmtt-10">......</span> <span +class="cmtt-10">\section{...}</span> <span +class="cmtt-10">......</span> <span +class="cmtt-10">\section{...}</span> <span +class="cmtt-10">......</span> + <br /> <span +class="cmtt-10">\chapter{...}</span> <span +class="cmtt-10">......</span> <span +class="cmtt-10">\section{...}</span> <span +class="cmtt-10">......</span> +</div> + Within the <span +class="cmtt-10">\CutAt </span>instruction, the starred commands of LaTeX should be referenced with the prefix ‘<span +class="cmtt-10">like</span>’ +instead of the postfix of ‘<span +class="cmtt-10">*</span>’, and appendices through the entry ‘<span +class="cmtt-10">appendix</span>’. +<!--l. 5303--><p class="indent" > A plus character ‘<span +class="cmtt-10">+</span>’, before the leading parameter, requests buttons that link to the hypertext pages; e.g., +‘<span +class="cmtt-10">\CutAt{+likesection}</span>’. +</p><!--l. 5306--><p class="indent" > The end points of sections not specified within the <span +class="cmtt-10">\CutAt </span>commands can be made known with instructions of +the form ‘<span +class="cmtt-10">\Configure{</span><span +class="cmti-10">endunit</span><span class="cmtt-10">}{</span><span -class="cmti-10">at-start</span><span -class="cmtt-10">}</span> -</p> - <table id="TBL-7" -><tr > -<td class="output" -><div class="output"> An equation: - <center class="math-display"> -<img -src="mn3x.gif" alt=" b -a -" class="math-display" /></center> - </div></td><td -><div class="source"> +class="cmti-10">unit</span><span +class="cmtt-10">,</span><span +class="cmti-10">unit</span><span +class="cmtt-10">,...}</span>’. +</p><hr /> +<!--l. 5314--><p class="noindent" ><a + href="mn11.html#mn14-2" name="mn14-2" >2</a>. <a + name="index14-55009"></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> +</p><!--l. 5316--><p class="indent" > This variant of the <span +class="cmtt-10">\tableofcontents </span>command specifies the kinds of entries that should be included in the +tables. +</p><hr /> +<!--l. 5323--><p class="noindent" ><a + href="mn11.html#mn14-3" name="mn14-3" >3</a>. <a + name="index14-55011"></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> +</p><!--l. 5325--><p class="indent" > This directive asks for a local table of contents, at each division created by the <span +class="cmtt-10">\</span><span +class="cmti-10">at-unit </span>command. The tables +should include entries of types <span +class="cmtt-10">\</span><span +class="cmti-10">unit-1</span>, <span +class="cmtt-10">\</span><span +class="cmti-10">unit-2</span>,..., and terminate upon reaching any of the <span +class="cmtt-10">\</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>,... commands. +</p><!--l. 5332--><p class="indent" > <a + name="index14-55012"></a>Within the <span +class="cmtt-10">\TocAt </span>instruction, the starred commands of LaTeX should be referenced with the prefix ‘<span +class="cmtt-10">like</span>’ +instead of the postfix of ‘<span +class="cmtt-10">*</span>’, and appendices through the entry ‘<span +class="cmtt-10">appendix</span>’. + </p><div class="ShowCode"> + <br /> <span class="showcode"><span +class="cmtt-10">\TocAt{section,subsection,/likechapter}</span></span> + <br /> <span +class="cmtt-10">\CutAt{subsection,section,likechapter}</span> + <br /> + <br /> <span +class="cmtt-10">\section{...}</span> <span +class="cmtt-10">...</span> <span +class="cmtt-10">\subsection{...}</span> <span +class="cmtt-10">...</span> + <br /> <span +class="cmtt-10">\section{...}</span> <span +class="cmtt-10">...</span> <span +class="cmtt-10">\subsection{...}</span> <span +class="cmtt-10">...</span> <span +class="cmtt-10">\subsection{...}</span> <span +class="cmtt-10">...</span> + <br /> <span +class="cmtt-10">\chapter*{...}</span> + <br /> <span +class="cmtt-10">\section*{...}</span> <span +class="cmtt-10">...</span> +</div> + A postfix ‘<span +class="cmtt-10">*</span>’ on <span +class="cmtt-10">\CutAt </span>asks the tables of contents to appear after the preambles of the logical +unit. <div class="ShowCode"> + <br /> <span class="showcode"><span +class="cmtt-10">\TocAt*{section,subsection,/likechapter}</span></span> + + <br /> <span +class="cmtt-10">\CutAt{subsection,section,likechapter}</span> + <br /> + <br /> <span +class="cmtt-10">\section{...}</span> <span +class="cmtt-10">...</span> <span +class="cmtt-10">\subsection{...}</span> <span +class="cmtt-10">...</span> <br /> <span -class="cmtt-10">\Configure{[]}{An</span> <span -class="cmtt-10">equation:</span> <span -class="cmtt-10">$$}{$$}</span> +class="cmtt-10">\section{...}</span> <span +class="cmtt-10">...</span> <span +class="cmtt-10">\subsection{...}</span> <span +class="cmtt-10">...</span> <span +class="cmtt-10">\subsection{...}</span> <span +class="cmtt-10">...</span> <br /> <span -class="cmtt-10">\[a^b\]</span> +class="cmtt-10">\chapter*{...}</span> + <br /> <span +class="cmtt-10">\section*{...}</span> <span +class="cmtt-10">...</span> </div> - </div></td></tr></table> - <a - name="index14-29014"></a><a - name="index14-29015"></a>The default configuration is obtained from<br />‘<span -class="cmtt-10">\Configure{[]}{\PicDisplay$$}{$$\EndPicDisplay}</span>’,<br />‘<span -class="cmtt-10">\Configure{$$}{\PicDisplay}{\EndPicDisplay}{}</span>’, -<br />‘<span -class="cmtt-10">\Configure{()}{\PicMath$}{$\EndPicMath}</span>’, and<br />‘<span -class="cmtt-10">\Configure{$}{}{}{}</span>’.<hr /> -<!--l. 3310--><p class="noindent"><a - href="mn6.html#mn14-2" name="mn14-2" >2</a>. <a - name="index14-29019"></a> <a - name="index14-29020"></a> <a - name="index14-29021"></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 + A postfix ‘<span +class="cmtt-10">-</span>’ on <span +class="cmtt-10">\CutAt </span>asks to produce the local tables of contents only on demand, through <span +class="cmtt-10">Cut</span><span +class="cmti-10">section-type</span> +commands. +<!--l. 5365--><p class="indent" > The only <span +class="cmtt-10">\ConfigureToc </span>commands that count are those before the <span +class="cmtt-10">\TocAt </span>instruction. +</p><hr /> +<!--l. 5378--><p class="noindent" ><a + href="mn11.html#mn14-4" name="mn14-4" >4</a>. <a + name="index14-55014"></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> +</p><!--l. 5380--><p class="indent" > This command determines how entries of the specified unit will appear in the tables of contents. The entries +include only fields corresponding to nonempty fields in the <span +class="cmtt-10">\ConfigureToc </span>commands. + </p><div class="ShowCode"> + <br /> <span +class="cmtt-10">\ConfigureToc{section}</span> <span +class="cmtt-10">{}</span> <span +class="cmtt-10">{$\bullet$~}</span> <span +class="cmtt-10">{}</span> <span +class="cmtt-10">{~~</span> <span +class="cmtt-10">}</span> + <br /> <span +class="cmtt-10">\tableofcontents[section]</span> +</div><hr /> +<!--l. 5405--><p class="noindent" ><a + href="mn11.html#mn14-5" name="mn14-5" >5</a>. <a + name="index14-55016"></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> +</p><!--l. 5407--><p class="indent" > The <span +class="cmti-10">end-of-toc </span>is inserted at the end of the internal environment of the tables. The <span +class="cmti-10">after-toc </span>is included after +leaving the internal environment. +</p><hr /> +<!--l. 5422--><p class="noindent" ><a + href="mn11.html#mn14-6" name="mn14-6" >6</a>. <a + name="index14-55018"></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> +</p><hr /> +<!--l. 5433--><p class="noindent" ><a + href="mn11.html#mn14-7" name="mn14-7" >7</a>. <a + name="index14-55020"></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> +</p><hr /> +<!--l. 5448--><p class="noindent" ><a + href="mn11.html#mn14-8" name="mn14-8" >8</a>. <a + name="index14-55022"></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> +</p><!--l. 5450--><p class="indent" > This command determines the content to be inserted at the mentioned locations of the specified +units. + </p><div class="ShowCode"> + <br /> <span class="showcode"><span +class="cmtt-10">\Configure{</span></span><span +class="cmtt-10">chapter</span><span class="showcode"><span +class="cmtt-10">}</span></span> + <br /> <span class="showcode"><span +class="cmtt-10">{</span></span><span +class="cmtt-10">\HCode{<div</span> <span +class="cmtt-10">class="chapter">}</span><span class="showcode"><span +class="cmtt-10">}</span></span> <span class="showcode"><span +class="cmtt-10">{</span></span><span +class="cmtt-10">\HCode{</div>}</span><span class="showcode"><span +class="cmtt-10">}</span></span> + <br /> <span class="showcode"><span +class="cmtt-10">{</span></span><span +class="cmtt-10">\HCode{<h2</span> <span +class="cmtt-10">class="chapterHead">}\chaptername</span> + <br /> <span +class="cmtt-10">~\thechapter\HCode{<br</span> <span +class="cmtt-10">/>}</span><span class="showcode"><span +class="cmtt-10">}</span></span> + <br /> <span class="showcode"><span +class="cmtt-10">{</span></span><span +class="cmtt-10">\HCode{</h2>}</span><span class="showcode"><span +class="cmtt-10">}</span></span> + <br /> <span +class="cmtt-10">\chapter{...}</span> <span +class="cmtt-10">....</span> + <br /> <span +class="cmtt-10">\chapter{...}</span> <span +class="cmtt-10">....</span> +</div><hr /> + +<!--l. 5473--><p class="noindent" ><a + href="mn11.html#mn14-9" name="mn14-9" >9</a>. <a + name="index14-55024"></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> +</p><hr /> +<!--l. 5485--><p class="noindent" ><a + href="mn11.html#mn14-10" name="mn14-10" >10</a>. <a + name="index14-55026"></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> -</p><!--l. 3312--><p class="indent"> These commands configure subscripts appearing in isolation, superscripts given in isolation, and subscripts -provided together with superscripts. If the last configuration command gets empty parameters, the corresponding -cases use the settings that apply to isolated subscripts and superscripts. -</p><!--l. 3318--><p class="indent"> The default setting results from<br />‘<span -class="cmtt-10">\Configure{SUB}{\HCode{<sub>}}{\HCode{</sub>}}</span>’, -<br />‘<span -class="cmtt-10">\Configure{SUP}{\HCode{<sup>}}{\HCode{</sup>}}</span>’, and<br />‘<span -class="cmtt-10">\Configure{SUBSUP}{}{}</span>’. </p><hr /> -<!--l. 3330--><p class="noindent"><a - href="mn6.html#mn14-3" name="mn14-3" >3</a>. <a - name="index14-29026"></a> <a - name="index14-29027"></a> <a - name="index14-29028"></a> <a - name="index14-29029"></a><span -class="cmtt-10">no_</span>, <span -class="cmtt-10">no^</span> -</p><!--l. 3332--><p class="indent"> TeX4ht modifies the implementation of ‘<span -class="cmtt-10">_</span>’ and ‘<span -class="cmtt-10">^</span>’, to create hypertext subscripts and superscripts in non -pictorial formulas--a modification that occasionally might clash with other interpretations in the source documents. -The current package parameters ask TeX4ht not to modify the implementation of these commands, -respectively. +<!--l. 5492--><p class="noindent" ><a + href="mn11.html#mn14-11" name="mn14-11" >11</a>. <a + name="index14-55028"></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> +</p><!--l. 5494--><p class="indent" > This directive introduces a sectioning command <span +class="cmtt-10">\</span><span +class="cmti-10">unit</span>, which submits <span +class="cmti-10">mark-for-toc </span>to the tables of +contents. + </p><div class="ShowCode"> + <br /> <span +class="cmtt-10">\newcounter{c}</span> + <br /> <span +class="cmtt-10">\NewSection\X</span> <span +class="cmtt-10">{\thec}</span> + <br /> <span +class="cmtt-10">\Configure{X}</span> + <br /> <span +class="cmtt-10">{\addtocounter{c}{1}\HCode{<h2>}[\thec]</span> <span +class="cmtt-10">}</span> + <br /> <span +class="cmtt-10">{\HCode{</h2>}}</span> + <br /> <span +class="cmtt-10">{}{}</span> +</div><hr /> +<!--l. 5515--><p class="noindent" ><a + href="mn11.html#mn14-12" name="mn14-12" >12</a>. <a + name="index14-55030"></a><span +class="cmtt-10">\Configure{writetoc} {</span><span +class="cmti-10">definitions-for-the-writing-environment</span><span +class="cmtt-10">}</span> +</p><!--l. 5520--><p class="indent" > TeX4ht expands and then writes the sectioning titles into an auxiliary file, and it might encounter there +problems from macros that are not fit for such conditions or for inclusion in the table of contents. +The current configuration instruction allows to locally modify the behavior of macros for the writing +phase. +</p><!--l. 5526--><p class="indent" > For instance, the instruction ‘<span +class="cmtt-10">\section{Foo \\ bar}</span>’ suggests a configuration similar to +‘<span +class="cmtt-10">\Configure{writetoc}{\let\\\space}</span>’. +</p><hr /> +<!--l. 5551--><p class="noindent" ><a + href="mn11.html#mn14-13" name="mn14-13" >13</a>. <a + name="index14-55032"></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> +</p><!--l. 5553--><p class="indent" > This command configures the appearance of the cross-links between hypertext pages obtained for sectioning +commands. + </p><div class="ShowCode"> + <br /> <span +class="cmtt-10">\Configure{crosslinks}</span> + <br /> <span +class="cmtt-10">{}{}{$\scriptstyle\Rightarrow$}</span> + <br /> <span +class="cmtt-10">{$\scriptstyle\Leftarrow$}</span> + <br /> <span +class="cmtt-10">{}{}{}{$\scriptstyle\Uparrow$}</span> +</div><hr /> +<!--l. 5574--><p class="noindent" ><a + href="mn11.html#mn14-14" name="mn14-14" >14</a>. <a + name="index14-55034"></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> </p> |