Current File : //data/old/usr/share/texlive/texmf-dist/doc/generic/tex4ht/mn9.html
<?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>
Mini Shell