2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
<html xmlns="http://www.w3.org/TR/xhtml1/transitional"
7
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
8
<meta name="generator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)" />
10
<meta name="src" content="mn.tex" />
11
<meta name="date" content="2001-02-28 17:02:00" />
12
<link rel="stylesheet" type="text/css" href="mn.css" />
15
<!--l. 3416--><p class="noindent"><a
16
href="mn3.html#mn22-1" name="mn22-1" >1</a>. <a
17
name="index22-23006"></a>Package parameter ‘<span class="cmtt-10">0.0</span>’
18
</p><!--l. 3418--><p class="indent"> This parameter asks for a pure text-based output without hypertext tags.
23
><div class="output">1 a demonstration of how 2 to produce xml output. </div></td><td
25
<div class="ShowCode"><pre>
26
<span class="cmtt-10">%-- try.tex --</span>
27
<span class="cmtt-10">\documentclass{article}</span>
28
<span class="cmtt-10">\usepackage[</span><span class="showcode"><span class="cmtt-10">html,0.0</span></span><span class="cmtt-10">]{tex4ht}</span>
29
<span class="cmtt-10">\begin{document}</span>
30
<span class="cmtt-10">\section{a demonstration} of how</span>
31
<span class="cmtt-10">\section{to produce} xml output.</span>
32
<span class="cmtt-10">\end{document}</span>
34
</div></td></tr></table><hr />
35
<!--l. 3438--><p class="noindent"><a
36
href="mn3.html#mn22-2" name="mn22-2" >2</a>. <a
37
name="index22-23008"></a>Parameter ‘<span class="cmtt-10">hooks</span>’
38
</p><!--l. 3440--><p class="indent"> This parameter asks for pseudo hypertext tags that partially trace empty parameters of configuration
39
instructions. The pseudo tags are highlighted fragments of content in the output, which carry the look of
45
><div class="output"> <strong class="hooks"><HTML1:2></strong><strong class="hooks"><HEAD1:2></strong><strong
46
class="hooks"><TITLE1:2></strong><strong class="hooks"><TITLE+1:1></strong><strong
47
class="hooks"><TITLE2:2></strong><strong class="hooks"><HEAD2:2></strong>
48
<strong class="hooks"><BODY1:2></strong>
49
<strong class="hooks"><TocAt*1:2></strong>
50
<strong class="hooks"><TocAt*2:2></strong>
51
<strong class="hooks"><HtmlPar2:4></strong> 1 a demonstration<strong
52
class="hooks"><section3:4></strong><strong class="hooks"><TocAt1:2></strong><strong
53
class="hooks"><TocAt2:2></strong> of how
54
<strong class="hooks"><TocAt*1:2></strong>
55
<strong class="hooks"><TocAt*2:2></strong>
56
<strong class="hooks"><section2:4></strong>
57
2 to produce<strong class="hooks"><section3:4></strong><strong
58
class="hooks"><TocAt1:2></strong><strong class="hooks"><TocAt2:2></strong> xml output.
59
<strong class="hooks"><section2:4></strong><strong class="hooks"><BODY2:2></strong><strong
60
class="hooks"><HTML2:2></strong>
64
<div class="ShowCode"><pre>
67
<span class="cmtt-10">%-- try.tex --</span>
68
<span class="cmtt-10">\documentclass{article}</span>
69
<span class="cmtt-10">\usepackage[html,0.0,</span><span class="showcode"><span class="cmtt-10">hooks</span></span><span class="cmtt-10">]{tex4ht}</span>
70
<span class="cmtt-10">\begin{document}</span>
71
<span class="cmtt-10">\section{a demonstration} of how</span>
72
<span class="cmtt-10">\section{to produce} xml output.</span>
73
<span class="cmtt-10">\end{document}</span>
75
</div></td></tr></table>
76
For instance, in the above example, the fields ‘<span class="cmtt-10"><section2:4></span>’ and ‘<span class="cmtt-10"><section3:4></span>’ indicate that
77
‘<span class="cmtt-10">\Configuration{section}</span>’ should have four parameters. Moreover, the location of ‘<span class="cmtt-10"><section2:4></span>’ shows where
78
the content of the second parameter will be included, and the location of ‘<span class="cmtt-10"><section3:4></span>’ shows where the content of
79
the third parameter will be included. A little experimentation reveals that the above configuration command has the
81
<!--l. 3481--><p class="indent"> <span class="cmtt-10">\Configuration{section} {</span><span class="cmti-10">before-section</span><span class="cmtt-10">} {</span><span class="cmti-10">after-section</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>
86
><div class="output"> <strong class="hooks"><HTML1:2></strong><strong class="hooks"><HEAD1:2></strong>
87
<strong class="hooks"><TocAt*1:2></strong>
88
<strong class="hooks"><TocAt*2:2></strong>
89
<strong class="hooks"><HtmlPar2:4></strong> <hr /><h3>a demonstration</h3><strong
90
class="hooks"><TocAt1:2></strong><strong class="hooks"><TocAt2:2></strong> of
92
<strong class="hooks"><TocAt*1:2></strong>
93
<strong class="hooks"><TocAt*2:2></strong>
94
<hr /><h3>to produce</h3><strong class="hooks"><TocAt1:2></strong><strong
95
class="hooks"><TocAt2:2></strong> xml output. <strong class="hooks"><BODY2:2></strong><strong
96
class="hooks"><HTML2:2></strong>
99
<div class="ShowCode"><pre>
100
<span class="cmtt-10">%---- try.tex ----</span>
101
<span class="cmtt-10">\documentclass{article}</span>
102
<span class="cmtt-10">\usepackage[try,html]{tex4ht}</span>
103
<span class="cmtt-10">\begin{document}</span>
104
<span class="cmtt-10">\section{a demonstration} of how</span>
105
<span class="cmtt-10">\section{to produce} xml output.</span>
106
<span class="cmtt-10">\end{document}</span>
107
<span class="cmtt-10">%---- try.cfg ----</span>
108
<span class="cmtt-10">\Preamble{0.0,hooks}</span>
109
<span class="cmtt-10">\Configure{section}</span>
110
<span class="cmtt-10">{\HCode{<hr />}} {\empty}</span>
111
<span class="cmtt-10">{\HCode{<h3>}} {\HCode{</h3>}}</span>
112
<span class="cmtt-10">\begin{document}</span>
113
<span class="cmtt-10">\EndPreamble</span>
115
</div></td></tr></table>
116
Most configurations should be set after the <span class="cmtt-10">\Preamble </span>command, but a few must appear earlier. Again, a little
117
experimentation is probably the easiest approach for detecting the latter exceptions.
121
><div class="output"> <strong class="hooks"><HTML1:2></strong><strong
122
class="hooks"><HEAD1:2></strong>
123
<strong class="hooks"><Preamble2:2></strong>
125
<strong class="hooks"><TITLE1:2></strong>
126
<strong class="hooks"><TITLE+1:1></strong>
127
<strong class="hooks"><TITLE2:2></strong>
128
<strong class="hooks"><HEAD2:2></strong>
129
<strong class="hooks"><BODY1:2></strong>
130
<hr /><h3><span></span>a demonstration</h3>
132
<hr /><h3><span></span>to produce</h3>
134
<strong class="hooks"><HTML2:2></strong>
136
><div class="source">
137
<div class="ShowCode"><pre>
138
<span class="cmtt-10">%---- try.cfg ----</span>
139
<span class="cmtt-10">\Preamble{0.0,hooks,xhtml}</span>
141
<span class="cmtt-10">\Configure{section}</span>
142
<span class="cmtt-10">{\par\IgnorePar\EndP \HCode{<hr />}}</span>
143
<span class="cmtt-10">{\EndP}</span>
144
<span class="cmtt-10">{\HCode{<h3>}} {\HCode{</h3>}\par\ShowPar}</span>
145
<span class="cmtt-10">\Configure{TocAt}{\empty}{\empty}</span>
146
<span class="cmtt-10">\Configure{TocAt*}{\empty}{\empty}</span>
148
<span class="cmtt-10">\begin{document}</span>
150
<span class="cmtt-10">\Configure{HtmlPar}</span>
151
<span class="cmtt-10">{\HCode{<p>}}{\HCode{<p>}}</span>
152
<span class="cmtt-10">{\HCode{</p>}}{\HCode{</p>}}</span>
154
</div></td></tr></table><hr />
155
<!--l. 3561--><p class="noindent"><a
156
href="mn3.html#mn22-3" name="mn22-3" >3</a>. <a
157
name="index22-23010"></a>Option ‘<span class="cmtt-10">hooks+</span>’
158
</p><!--l. 3563--><p class="indent"> This option is a generalization of the previous one. It adds to the <span class="cmtt-10">log </span>file a partial tracing of <span class="cmtt-10">\Configuration</span>
161
<!--l. 3571--><p class="noindent"><a
162
href="mn3.html#mn22-4" name="mn22-4" >4</a>. <a
163
name="index22-23013"></a> <a
164
name="index22-23014"></a>Package parameter ‘<span class="cmtt-10">edit</span>’<br /><span class="cmtt-10">\Tg<...></span><br /><span class="cmtt-10">\Tg</...></span><br /><span class="cmtt-10">\Tg<.../></span>
165
</p><!--l. 3573--><p class="indent"> The three commands introduce start, end, and empty, pseudo hypertext tags to the output. The <span class="cmtt-10">edit</span>
166
parameter request abstract forms of the hypertext tags.
171
><div class="output"> <hr /><h3><span></span>a demonstration</h3>
173
<hr /><h3><span></span>to produce</h3>
176
><div class="source">
177
<div class="ShowCode"><pre>
178
<span class="cmtt-10">%---- try.cfg ----</span>
179
<span class="cmtt-10">\Preamble{0.0,edit,xhtml}</span>
181
<span class="cmtt-10">\Configure{section}</span>
182
<span class="cmtt-10">{\par\IgnorePar\EndP \HCode{<hr />}}</span>
183
<span class="cmtt-10">{\EndP}</span>
185
<span class="cmtt-10">{\HCode{<h3>}} {\HCode{</h3>}\par\ShowPar}</span>
186
<span class="cmtt-10">\Configure{TocAt}{\empty}{\empty}</span>
187
<span class="cmtt-10">\Configure{TocAt*}{\empty}{\empty}</span>
189
<span class="cmtt-10">\begin{document}</span>
191
<span class="cmtt-10">\Configure{HtmlPar}</span>
192
<span class="cmtt-10">{\HCode{<p>}}{\HCode{<p>}}</span>
193
<span class="cmtt-10">{\HCode{</p>}}{\HCode{</p>}}</span>
195
<span class="cmtt-10">\EndPreamble</span>
197
</div></td></tr></table>
198
The <span class="cmtt-10">\Tg </span>commands allow also for arguments in their content.
200
<!--l. 3625--><p class="noindent"><a
201
href="mn3.html#mn22-5" name="mn22-5" >5</a>. <span class="cmtt-10">\Configure{edit} {</span><span class="cmti-10">before</span><span class="cmtt-10">} {</span><span class="cmti-10">after</span><span class="cmtt-10">} </span><br /><span class="cmtt-10">\Configure{hooks} {</span><span class="cmti-10">before</span><span class="cmtt-10">} {</span><span class="cmti-10">after</span><span class="cmtt-10">} {}{}</span>
202
</p><!--l. 3627--><p class="indent"> The pseudo tags produced by the <span class="cmtt-10">\Tg </span>commands are easier to program when the ‘<span class="cmtt-10">hooks</span>’ parameter is also
203
present, due to the hints provided by the pseudo tags. The current commands allow to provide distinguished looks
204
to the corresponding pseudo tags.
209
><div class="output"> <span class="hooks"><HTML1:2></span><span class="hooks"><HEAD1:2></span>
210
<span class="hooks"><Preamble2:2></span>
211
<strong><file></strong>
212
<span class="hooks"><TITLE+1:1></span>
213
<strong></file></strong>
214
<span class="hooks"><HEAD2:2></span>
215
<span class="hooks"><BODY1:2></span>
216
<strong><section></strong>
217
<strong><title></strong>
218
<span class="hooks"><HtmlPar2:4></span> <span
219
></span>a demonstration<strong></title></strong> of how
220
<strong></section></strong>
221
<strong><section></strong>
222
<strong><title></strong>
223
<span></span>to produce<strong></title></strong> xml output. <strong></section></strong><span
224
class="hooks"><HTML2:2></span>
226
><div class="source">
227
<div class="ShowCode"><pre>
228
<span class="cmtt-10">%---- try.cfg ----</span>
229
<span class="cmtt-10">\Configure{HtmlPar}</span>
230
<span class="cmtt-10">{\HCode{<p>}}{\HCode{<p>}}</span>
231
<span class="cmtt-10">{}{}</span>
232
<span class="cmtt-10">\Configure{TITLE}</span>
233
<span class="cmtt-10">{\Tg<file>}{\Tg</file>}</span>
235
<span class="cmtt-10">\Preamble{0.0,edit,hooks}</span>
237
<span class="cmtt-10">\Configure{section}</span>
238
<span class="cmtt-10">{\Tg<section>} {\Tg</section>}</span>
239
<span class="cmtt-10">{\Tg<title>} {\Tg</title>}</span>
240
<span class="cmtt-10">\Configure{TocAt}{\empty}{\empty}</span>
242
<span class="cmtt-10">\Configure{TocAt*}{\empty}{\empty}</span>
244
<span class="cmtt-10">\Configure{hooks}</span>
245
<span class="cmtt-10">{\HCode{<span class="hooks">&lt;}}</span>
246
<span class="cmtt-10">{\HCode{&gt;</span>}} {}{}</span>
248
<span class="cmtt-10">\begin{document}</span>
249
<span class="cmtt-10">\EndPreamble</span>
251
</div></td></tr></table><hr />
252
<!--l. 3689--><p class="noindent"><a
253
href="mn3.html#mn22-6" name="mn22-6" >6</a>. <a
254
name="index22-23016"></a> <span class="cmtt-10">\Configure<...>{</span><span class="cmti-10">before</span><span class="cmtt-10">}{</span><span class="cmti-10">after</span><span class="cmtt-10">}</span><br /><span class="cmtt-10">\Configure</...>{</span><span class="cmti-10">before</span><span class="cmtt-10">}{</span><span class="cmti-10">after</span><span class="cmtt-10">}</span><br /><span class="cmtt-10">\Configure<.../>{</span><span class="cmti-10">before</span><span class="cmtt-10">}{</span><span class="cmti-10">after</span><span class="cmtt-10">}</span>
255
</p><!--l. 3692--><p class="indent"> These commands configure the appearance of the pseudo tags introduced, respectively, by the commands
256
<span class="cmtt-10">\Tg<...></span>, <span class="cmtt-10">\Tg</...></span>, and <span class="cmtt-10">\Tg<.../> </span>(when the ‘<span class="cmtt-10">edit</span>’ parameter is present).
261
><div class="output"> <strong><FILE></strong>try.html<strong></FILE></strong>
262
<br /><strong><SECTION></strong><br /><strong><TITLE></strong> a
263
demonstration<strong></TITLE></strong>
265
<br /><strong></SECTION></strong><br /><br /><strong><SECTION></strong><br
266
/><strong><TITLE></strong> to produce<strong></TITLE></strong>
267
xml output. <br /><strong></SECTION></strong><br />
269
><div class="source">
270
<div class="ShowCode"><pre>
271
<span class="cmtt-10">%---- try.cfg ----</span>
272
<span class="cmtt-10">\Configure{HtmlPar} {}{} {}{}</span>
273
<span class="cmtt-10">\Configure{TITLE}</span>
274
<span class="cmtt-10">{\Tg<FILE>}{\Tg</FILE>}</span>
276
<span class="cmtt-10">\Preamble{0.0,edit}</span>
278
<span class="cmtt-10">\Configure{section}</span>
279
<span class="cmtt-10">{\Tg<SECTION>} {\EndP\Tg</SECTION>}</span>
280
<span class="cmtt-10">{\Tg<TITLE>} {\Tg</TITLE>}</span>
281
<span class="cmtt-10">\Configure{toc}{\empty}</span>
282
<span class="cmtt-10">\Configure{TocAt}{\empty}{\empty}</span>
283
<span class="cmtt-10">\Configure{TocAt*}{\empty}{\empty}</span>
285
<span class="cmtt-10">\Configure<SECTION>{\HCode{<br />}}{\HCode{<br />}}</span>
286
<span class="cmtt-10">\Configure</SECTION>{\HCode{<br />}}{\HCode{<br />}}</span>
288
<span class="cmtt-10">\begin{document}</span>
289
<span class="cmtt-10">\EndPreamble</span>
291
</div></td></tr></table><hr />
292
<!--l. 3748--><p class="noindent"><a
293
href="mn3.html#mn22-7" name="mn22-7" >7</a>. <span class="cmtt-10">\Configure<...>-{</span><span class="cmti-10">replacement</span><span class="cmtt-10">}</span><br /><span class="cmtt-10">\Configure</...>-{</span><span class="cmti-10">replacement</span><span class="cmtt-10">}</span><br /><span class="cmtt-10">\Configure<.../>-{</span><span class="cmti-10">replacement</span><span class="cmtt-10">}</span>
294
</p><!--l. 3750--><p class="indent"> These variants of the <span class="cmtt-10">\Configure </span>command specify replacements for tags created by the <span class="cmtt-10">\Tg </span>command. They
295
allow to provide counter HTML representations for the XML documents being compiled from the source LaTeX
302
><div class="output">
303
<pre class="Verbatim"><span class="cmtt-10"><!--try.html--></span>
304
<span class="cmtt-10"><h2></span> <span class="cmtt-10">a</span> <span class="cmtt-10">demonstration</h2></span>
305
<span class="cmtt-10">of</span> <span class="cmtt-10">how</span>
306
<span class="cmtt-10"><h2></span> <span class="cmtt-10">to</span> <span class="cmtt-10">produce</h2></span>
307
<span class="cmtt-10">xml</span> <span class="cmtt-10">output.</span>
310
><div class="source">
311
<div class="ShowCode"><pre>
312
<span class="cmtt-10">%---- try.cfg ----</span>
313
<span class="cmtt-10">\Configure{HtmlPar} {}{} {}{}</span>
314
<span class="cmtt-10">\Configure{TITLE}</span>
315
<span class="cmtt-10">{\Tg<FILE>}{\Tg</FILE>}</span>
317
<span class="cmtt-10">\Preamble{0.0,edit}</span>
319
<span class="cmtt-10">\Configure{section}</span>
320
<span class="cmtt-10">{\Tg<SECTION>} {\EndP\Tg</SECTION>}</span>
321
<span class="cmtt-10">{\Tg<TITLE>} {\Tg</TITLE>}</span>
322
<span class="cmtt-10">\Configure{toc}{\empty}</span>
323
<span class="cmtt-10">\Configure{TocAt}{\empty}{\empty}</span>
324
<span class="cmtt-10">\Configure{TocAt*}{\empty}{\empty}</span>
326
<span class="cmtt-10">\Configure<SECTION>+{}</span>
327
<span class="cmtt-10">\Configure</SECTION>+{}</span>
328
<span class="cmtt-10">\Configure<TITLE>+{\hcode{<h2>}}</span>
329
<span class="cmtt-10">\Configure</TITLE>+{\HCode{</h2>}}</span>
330
<span class="cmtt-10">\Configure<FILE>+{\HCode{<!--}}</span>
331
<span class="cmtt-10">\Configure</FILE>+{\HCode{-->}}</span>
333
<span class="cmtt-10">\begin{document}</span>
334
<span class="cmtt-10">\EndPreamble</span>
336
</div></td></tr></table><hr />
337
<!--l. 3798--><p class="noindent"><a
338
href="mn3.html#mn22-8" name="mn22-8" >8</a>. <a
339
name="index22-23018"></a>Package parameter ‘<span class="cmtt-10">edit+</span>’
340
</p><!--l. 5--><p class="indent"> This parameter is a generalization of the ‘<span class="cmtt-10">edit</span>’ parameter, which introduces configuration information into the
343
<!--l. 3804--><p class="noindent"><a
344
href="mn3.html#mn22-9" name="mn22-9" >9</a>. <a
345
name="index22-23021"></a> <a
346
name="index22-23022"></a>Package parameter ‘<span class="cmtt-10">verify</span>’<br /><span class="cmtt-10">\Verify...\EndVerify</span>
347
</p><!--l. 3806--><p class="indent"> The current parameter asks for a warning message to be given for unknown containment relationships of tags
348
defined by <span class="cmtt-10">\Tg</span>. A containment relationship can be made known to the system, by inserting into the environment
349
‘<span class="cmtt-10">\Verify...\EndVerify</span>’ the parent and child pair separated by the string ‘<span class="cmtt-10">--></span>’. Commas should be used to
350
separate pairs in the listing.
355
><div class="output"> <strong><DOC></strong> <strong><FILE></strong>try.html<strong></FILE></strong>
356
<strong><SECTION></strong><strong><TITLE></strong> a
358
demonstration<strong></TITLE></strong>
360
<strong></SECTION></strong><strong><SECTION></strong><strong><TITLE></strong>
361
to produce<strong></TITLE></strong>
362
xml output. <strong></SECTION></strong><strong></DOC></strong>
364
><div class="source">
365
<div class="ShowCode"><pre>
366
<span class="cmtt-10">%---- try.cfg ----</span>
367
<span class="cmtt-10">\Configure{HtmlPar} {}{} {}{}</span>
368
<span class="cmtt-10">\Configure{TITLE}</span>
369
<span class="cmtt-10">{\Tg<FILE>}{\Tg</FILE>}</span>
370
<span class="cmtt-10">\Configure{HTML}</span>
371
<span class="cmtt-10">{\Tg<DOC>}{\Tg</DOC>}</span>
373
<span class="cmtt-10">\Preamble{0.0,edit,verify}</span>
375
<span class="cmtt-10">\Configure{section}</span>
376
<span class="cmtt-10">{\Tg<SECTION>} {\EndP\Tg</SECTION>}</span>
377
<span class="cmtt-10">{\Tg<TITLE>} {\Tg</TITLE>}</span>
378
<span class="cmtt-10">\Configure{toc}{\empty}</span>
379
<span class="cmtt-10">\Configure{TocAt}{\empty}{\empty}</span>
380
<span class="cmtt-10">\Configure{TocAt*}{\empty}{\empty}</span>
382
<span class="cmtt-10">\Verify</span>
383
<span class="cmtt-10">--> DOC,</span>
384
<span class="cmtt-10">DOC --> FILE,</span>
385
<span class="cmtt-10">DOC --> SECTION</span>
386
<span class="cmtt-10">\EndVerify</span>
388
<span class="cmtt-10">\begin{document}</span>
389
<span class="cmtt-10">\EndPreamble</span>
391
</div></td></tr></table>
392
The compilation of the LaTeX file that produced the last example, issued the warning message ‘<span class="cmtt-10">6. ---</span>
393
<span class="cmtt-10">warning --- SECTION --> TITLE ?</span>’.
395
<!--l. 3859--><p class="noindent"><a
396
href="mn3.html#mn22-10" name="mn22-10" >10</a>. <a
397
name="index22-23024"></a>Package parameter ‘<span class="cmtt-10">verify+</span>’
398
</p><!--l. 3861--><p class="indent"> This is a variant of the ‘<span class="cmtt-10">verify</span>’ parameter that reports in the ‘<span class="cmtt-10">log</span>’ file the detected containment