diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn9.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/tex4ht/mn9.html | 419 |
1 files changed, 419 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/tex4ht/mn9.html b/Master/texmf-dist/doc/generic/tex4ht/mn9.html new file mode 100644 index 00000000000..6abdb8f6e39 --- /dev/null +++ b/Master/texmf-dist/doc/generic/tex4ht/mn9.html @@ -0,0 +1,419 @@ +<?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></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 +> +<!--l. 2680--><p class="noindent"><a + href="mn6.html#mn9-1" name="mn9-1" >1</a>. <a + name="index9-25007"></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. 2682--><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">\</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. 2704--><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. 2707--><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">unit</span><span +class="cmtt-10">,</span><span +class="cmti-10">unit</span><span +class="cmtt-10">,...}</span>’. +</p><hr /> +<!--l. 2715--><p class="noindent"><a + href="mn6.html#mn9-2" name="mn9-2" >2</a>. <a + name="index9-25009"></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. 2717--><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. 2724--><p class="noindent"><a + href="mn6.html#mn9-3" name="mn9-3" >3</a>. <a + name="index9-25011"></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. 2726--><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. 2733--><p class="indent"> <a + name="index9-25012"></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">\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 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. 2766--><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. 2779--><p class="noindent"><a + href="mn6.html#mn9-4" name="mn9-4" >4</a>. <a + name="index9-25014"></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. 2781--><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. 2806--><p class="noindent"><a + href="mn6.html#mn9-5" name="mn9-5" >5</a>. <a + name="index9-25016"></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. 2808--><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. 2823--><p class="noindent"><a + href="mn6.html#mn9-6" name="mn9-6" >6</a>. <a + name="index9-25018"></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. 2834--><p class="noindent"><a + href="mn6.html#mn9-7" name="mn9-7" >7</a>. <a + name="index9-25020"></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. 2849--><p class="noindent"><a + href="mn6.html#mn9-8" name="mn9-8" >8</a>. <a + name="index9-25022"></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. 2851--><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. 2874--><p class="noindent"><a + href="mn6.html#mn9-9" name="mn9-9" >9</a>. <a + name="index9-25024"></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. 2886--><p class="noindent"><a + href="mn6.html#mn9-10" name="mn9-10" >10</a>. <a + name="index9-25026"></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. 2893--><p class="noindent"><a + href="mn6.html#mn9-11" name="mn9-11" >11</a>. <a + name="index9-25028"></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. 2895--><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. 2916--><p class="noindent"><a + href="mn6.html#mn9-12" name="mn9-12" >12</a>. <a + name="index9-25030"></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. 2921--><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. 2927--><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. 2952--><p class="noindent"><a + href="mn6.html#mn9-13" name="mn9-13" >13</a>. <a + name="index9-25032"></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. 2954--><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. 2975--><p class="noindent"><a + href="mn6.html#mn9-14" name="mn9-14" >14</a>. <a + name="index9-25034"></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> + + +</body></html> |