Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > 8a0c95e246ae6b1f008ff48867f08c37 > files > 31

tex4ht-1.0.2008_02_28_2058-2mdv2009.0.i586.rpm

<?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 />&nbsp;<span class="showcode"><span 
class="cmtt-10">\CutAt{section,chapter}</span></span>
      <br />&nbsp;<span 
class="cmtt-10">\tableofcontents</span>
      <br />&nbsp;<span 
class="cmtt-10">\chapter{...}</span>&nbsp;&nbsp;<span 
class="cmtt-10">......</span>&nbsp;&nbsp;<span 
class="cmtt-10">\section{...}</span>&nbsp;&nbsp;<span 
class="cmtt-10">......</span>&nbsp;&nbsp;<span 
class="cmtt-10">\section{...}</span>&nbsp;&nbsp;<span 
class="cmtt-10">......</span>
      <br />&nbsp;<span 
class="cmtt-10">\chapter{...}</span>&nbsp;&nbsp;<span 
class="cmtt-10">......</span>&nbsp;&nbsp;<span 
class="cmtt-10">\section{...}</span>&nbsp;&nbsp;<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 &#8216;<span 
class="cmtt-10">like</span>&#8217;
instead of the postfix of &#8216;<span 
class="cmtt-10">*</span>&#8217;, and appendices through the entry &#8216;<span 
class="cmtt-10">appendix</span>&#8217;.
<!--l. 3964--><p class="indent" >    A plus character &#8216;<span 
class="cmtt-10">+</span>&#8217;, before the leading parameter, requests buttons that link to the hypertext pages; e.g.,
&#8216;<span 
class="cmtt-10">\CutAt{+likesection}</span>&#8217;.
</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 &#8216;<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>&#8217;.
</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 &#8216;<span 
class="cmtt-10">like</span>&#8217;
instead of the postfix of &#8216;<span 
class="cmtt-10">*</span>&#8217;, and appendices through the entry &#8216;<span 
class="cmtt-10">appendix</span>&#8217;.
      </p><div class="ShowCode">
      <br />&nbsp;<span class="showcode"><span 
class="cmtt-10">\TocAt{section,subsection,/likechapter}</span></span>
      <br />&nbsp;<span 
class="cmtt-10">\CutAt{subsection,section,likechapter}</span>
      <br />&nbsp;
      <br />&nbsp;<span 
class="cmtt-10">\section{...}</span>&nbsp;<span 
class="cmtt-10">...</span>&nbsp;<span 
class="cmtt-10">\subsection{...}</span>&nbsp;<span 
class="cmtt-10">...</span>
      <br />&nbsp;<span 
class="cmtt-10">\section{...}</span>&nbsp;<span 
class="cmtt-10">...</span>&nbsp;<span 
class="cmtt-10">\subsection{...}</span>&nbsp;<span 
class="cmtt-10">...</span>&nbsp;<span 
class="cmtt-10">\subsection{...}</span>&nbsp;<span 
class="cmtt-10">...</span>
      <br />&nbsp;<span 
class="cmtt-10">\chapter*{...}</span>
      <br />&nbsp;<span 
class="cmtt-10">\section*{...}</span>&nbsp;<span 
class="cmtt-10">...</span>
</div>
    A postfix &#8216;<span 
class="cmtt-10">*</span>&#8217; 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 />&nbsp;<span class="showcode"><span 
class="cmtt-10">\TocAt*{section,subsection,/likechapter}</span></span>

      <br />&nbsp;<span 
class="cmtt-10">\CutAt{subsection,section,likechapter}</span>
      <br />&nbsp;
      <br />&nbsp;<span 
class="cmtt-10">\section{...}</span>&nbsp;<span 
class="cmtt-10">...</span>&nbsp;<span 
class="cmtt-10">\subsection{...}</span>&nbsp;<span 
class="cmtt-10">...</span>
      <br />&nbsp;<span 
class="cmtt-10">\section{...}</span>&nbsp;<span 
class="cmtt-10">...</span>&nbsp;<span 
class="cmtt-10">\subsection{...}</span>&nbsp;<span 
class="cmtt-10">...</span>&nbsp;<span 
class="cmtt-10">\subsection{...}</span>&nbsp;<span 
class="cmtt-10">...</span>
      <br />&nbsp;<span 
class="cmtt-10">\chapter*{...}</span>
      <br />&nbsp;<span 
class="cmtt-10">\section*{...}</span>&nbsp;<span 
class="cmtt-10">...</span>
</div>
    A postfix &#8216;<span 
class="cmtt-10">-</span>&#8217; 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 />&nbsp;<span 
class="cmtt-10">\ConfigureToc{section}</span>&nbsp;<span 
class="cmtt-10">{}</span>&nbsp;<span 
class="cmtt-10">{$\bullet$~}</span>&nbsp;&nbsp;<span 
class="cmtt-10">{}</span>&nbsp;&nbsp;<span 
class="cmtt-10">{~~</span>&nbsp;<span 
class="cmtt-10">}</span>
      <br />&nbsp;<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 />&nbsp;<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 />&nbsp;&nbsp;&nbsp;&nbsp;<span class="showcode"><span 
class="cmtt-10">{</span></span><span 
class="cmtt-10">\HCode{&#x003C;div</span>&nbsp;<span 
class="cmtt-10">class="chapter"&#x003E;}</span><span class="showcode"><span 
class="cmtt-10">}</span></span>&nbsp;&nbsp;<span class="showcode"><span 
class="cmtt-10">{</span></span><span 
class="cmtt-10">\HCode{&#x003C;/div&#x003E;}</span><span class="showcode"><span 
class="cmtt-10">}</span></span>
      <br />&nbsp;&nbsp;&nbsp;&nbsp;<span class="showcode"><span 
class="cmtt-10">{</span></span><span 
class="cmtt-10">\HCode{&#x003C;h2</span>&nbsp;<span 
class="cmtt-10">class="chapterHead"&#x003E;}\chaptername</span>
      <br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span 
class="cmtt-10">~\thechapter\HCode{&#x003C;br</span>&nbsp;<span 
class="cmtt-10">/&#x003E;}</span><span class="showcode"><span 
class="cmtt-10">}</span></span>
      <br />&nbsp;&nbsp;&nbsp;&nbsp;<span class="showcode"><span 
class="cmtt-10">{</span></span><span 
class="cmtt-10">\HCode{&#x003C;/h2&#x003E;}</span><span class="showcode"><span 
class="cmtt-10">}</span></span>
      <br />&nbsp;<span 
class="cmtt-10">\chapter{...}</span>&nbsp;<span 
class="cmtt-10">....</span>
      <br />&nbsp;<span 
class="cmtt-10">\chapter{...}</span>&nbsp;<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 />&nbsp;<span 
class="cmtt-10">\newcounter{c}</span>
      <br />&nbsp;<span 
class="cmtt-10">\NewSection\X</span>&nbsp;<span 
class="cmtt-10">{\thec}</span>
      <br />&nbsp;<span 
class="cmtt-10">\Configure{X}</span>
      <br />&nbsp;&nbsp;&nbsp;&nbsp;<span 
class="cmtt-10">{\addtocounter{c}{1}\HCode{&#x003C;h2&#x003E;}[\thec]</span>&nbsp;<span 
class="cmtt-10">}</span>
      <br />&nbsp;&nbsp;&nbsp;&nbsp;<span 
class="cmtt-10">{\HCode{&#x003C;/h2&#x003E;}}</span>
      <br />&nbsp;&nbsp;&nbsp;&nbsp;<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 &#8216;<span 
class="cmtt-10">\section{Foo \\ bar}</span>&#8217; suggests a configuration similar to
&#8216;<span 
class="cmtt-10">\Configure{writetoc}{\let\\\space}</span>&#8217;.
</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 />&nbsp;<span 
class="cmtt-10">\Configure{crosslinks}</span>
      <br />&nbsp;&nbsp;&nbsp;<span 
class="cmtt-10">{}{}{$\scriptstyle\Rightarrow$}</span>
      <br />&nbsp;&nbsp;&nbsp;<span 
class="cmtt-10">{$\scriptstyle\Leftarrow$}</span>
      <br />&nbsp;&nbsp;&nbsp;<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>