<?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></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 > <!--l. 3940--><p class="noindent" ><a href="mn7.html#mn10-1" name="mn10-1" >1</a>. <a name="index10-26007"></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. 3942--><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. 3964--><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. 3967--><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. 3975--><p class="noindent" ><a href="mn7.html#mn10-2" name="mn10-2" >2</a>. <a name="index10-26009"></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. 3977--><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. 3984--><p class="noindent" ><a href="mn7.html#mn10-3" name="mn10-3" >3</a>. <a name="index10-26011"></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. 3986--><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. 3993--><p class="indent" > <a name="index10-26012"></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. 4026--><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. 4039--><p class="noindent" ><a href="mn7.html#mn10-4" name="mn10-4" >4</a>. <a name="index10-26014"></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. 4041--><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. 4066--><p class="noindent" ><a href="mn7.html#mn10-5" name="mn10-5" >5</a>. <a name="index10-26016"></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. 4068--><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. 4083--><p class="noindent" ><a href="mn7.html#mn10-6" name="mn10-6" >6</a>. <a name="index10-26018"></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. 4094--><p class="noindent" ><a href="mn7.html#mn10-7" name="mn10-7" >7</a>. <a name="index10-26020"></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. 4109--><p class="noindent" ><a href="mn7.html#mn10-8" name="mn10-8" >8</a>. <a name="index10-26022"></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. 4111--><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. 4134--><p class="noindent" ><a href="mn7.html#mn10-9" name="mn10-9" >9</a>. <a name="index10-26024"></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. 4146--><p class="noindent" ><a href="mn7.html#mn10-10" name="mn10-10" >10</a>. <a name="index10-26026"></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. 4153--><p class="noindent" ><a href="mn7.html#mn10-11" name="mn10-11" >11</a>. <a name="index10-26028"></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. 4155--><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. 4176--><p class="noindent" ><a href="mn7.html#mn10-12" name="mn10-12" >12</a>. <a name="index10-26030"></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. 4181--><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. 4187--><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. 4212--><p class="noindent" ><a href="mn7.html#mn10-13" name="mn10-13" >13</a>. <a name="index10-26032"></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. 4214--><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. 4235--><p class="noindent" ><a href="mn7.html#mn10-14" name="mn10-14" >14</a>. <a name="index10-26034"></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>