summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/tex4ht/mn9.html
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:56:57 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:56:57 +0000
commitf07bb53970ee2ecc53f81a206a3d3a67ef665e4a (patch)
tree6f57a1d62971db79e5ff023bdfd83b22cb971dc9 /Master/texmf-dist/doc/generic/tex4ht/mn9.html
parent007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (diff)
doc 6
git-svn-id: svn://tug.org/texlive/trunk@85 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/tex4ht/mn9.html')
-rw-r--r--Master/texmf-dist/doc/generic/tex4ht/mn9.html419
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 />&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. 2704--><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. 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 &#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. 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 &#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. 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 />&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. 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 />&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{&lt;div</span>&nbsp;<span
+class="cmtt-10">class=&#34;chapter&#34;&gt;}</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{&lt;/div&gt;}</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{&lt;h2</span>&nbsp;<span
+class="cmtt-10">class=&#34;chapterHead&#34;&gt;}\chaptername</span>
+ <br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span
+class="cmtt-10">~\thechapter\HCode{&lt;br</span>&nbsp;<span
+class="cmtt-10">/&gt;}</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{&lt;/h2&gt;}</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. 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 />&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{&lt;h2&gt;}[\thec]</span>&nbsp;<span
+class="cmtt-10">}</span>
+ <br />&nbsp;&nbsp;&nbsp;&nbsp;<span
+class="cmtt-10">{\HCode{&lt;/h2&gt;}}</span>
+ <br />&nbsp;&nbsp;&nbsp;&nbsp;<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 &#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. 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 />&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. 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>