1
% compile 3 timws: latex tex4ht-info
2
% or xhlatex tex4ht-info "html,3,sections+"
4
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
6
% Copyright (C) 2000-- Eitan M. Gurari %
8
% This work may be distributed and/or modified under the %
9
% conditions of the LaTeX Project Public License, either %
10
% version 1.3 of this license or (at your option) any %
11
% later version. The latest version of this license is %
13
% http://www.latex-project.org/lppl.txt %
14
% and version 1.3 or later is part of all distributions %
15
% of LaTeX version 2003/12/01 or later. %
17
% This work has the LPPL maintenance status "maintained".%
19
% This Current Maintainer of this work %
20
% is Eitan M. Gurari. %
22
% If you modify this file your changing the signature %
23
% in \message{(signature)} below will be appreciated. %
25
% gurari@cse.ohio-state.edu %
26
% http://www.cse.ohio-state.edu/~gurari %
27
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
28
\message{(<signature>)}
30
% Compile with the command `ht latex tex4ht-info'
35
\def\MAKETITLE{\author{Eitan M. Gurari}}
36
\def\next{\input mktex4ht.4ht \endinput}
41
%%%%%%%%%%%%%%%%%% definitions %%%%%%%%%%%%%%%%%%%%%%%%%
43
\expandafter\ifx \csname YES\HTML\endcsname\relax
44
\def\CleanComment{[0]}
47
\def\<{\edef\FIRST{\the\inputlineno}\let\<\saveCd \saveCd}
48
\def\CleanComment#1tex4ht-info#2#3#4.#5>#6//{[#4% <--jobname
49
\if,\ifnum \FIRST=#6 .\else ,0\fi\fi]#6//}
54
\string\ifx\string\infoIVht\string\UnDeF\string\def\string\infoIVht#1//{}\string\fi\string\infoIVht\CleanComment}{//
62
\def\>>>#1<<<{\bgroup\csname no:catcodes\endcsname0{255}{12}%
63
\csname no:catcodes\endcsname{13}{13}{13}% ^^M
64
\def\temp##1>>>{\egroup
65
\expandafter \def\csname #1\endcsname{##1}}\temp}
67
\newcount\tmpcnt \tmpcnt\time \divide\tmpcnt 60
68
\edef\temp{\the\tmpcnt}
69
\multiply\tmpcnt -60 \advance\tmpcnt \time
71
\edef\version{\the\year-\ifnum \month<10 0\fi
72
\the\month-\ifnum \day<10 0\fi\the\day
73
-\ifnum \temp<10 0\fi \temp
74
:\ifnum \tmpcnt<10 0\fi\the\tmpcnt}
77
\ifnum #1=\year #1\space\space\space\space\space\space
78
\else #1--\the\year\fi
82
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
84
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
88
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
89
% info4ht.4ht |version %
90
% Copyright (C) |CopyYear.2000. Eitan M. Gurari %
92
% This program can redistributed and/or modified under %
93
% the terms of the LaTeX Project Public License %
94
% Distributed from CTAN archives in directory %
95
% macros/latex/base/lppl.txt; either version 1 of the %
96
% License, or (at your option) any later version. %
98
% If you modify this program your changing its signature %
99
% with a directive of the following form will be %
101
% \message{signature} %
103
% gurari@cis.ohio-state.edu %
104
% http://www.cis.ohio-state.edu/~gurari %
105
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
106
\immediate\write-1{version |version}
107
{ \catcode`\@=0 \catcode`\\=11 @relax
108
@gdef@infoIVht[#1]#2//{%
110
@def@infoIVht[##1]##2//{%
111
@ifnum ##1>1 @ifnum ##1<#1
113
@no:catcodes0{255}{11}%
114
@no:catcodes{91}{91}{12}% [
115
@no:catcodes{47}{47}{12}% /
117
@long@def@infoIVht####1\ifx\infoIVht####2infoIVht[####3//{%
118
@def@infoIVht{******************************************}%
119
@immediate@write-1{@infoIVht}%
120
@immediate@write-1{****** @csname :Hin@endcsname.4ht}%
121
@immediate@write-1{@infoIVht}%
123
@def@infoIVht{~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*}%
124
@let~=@space @immediate@write-1{@infoIVht}%
126
@immediate@write-1{####1}%
128
@def@infoIVht{~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*}%
129
@let~=@space @immediate@write-1{@infoIVht}%
131
@immediate@write-1{@infoIVht}%
133
@expandafter@expandafter@expandafter@infoIVht
154
\<configure info4ht Preamble\><<<
155
\Configure{PROLOG}.........1
157
#1 Comma separated list of hooks to appear before HTML.
159
Each hook E is declared to be configurable by an
160
instruction of the form \NewConfigure{E}{1}
162
A star '*' prefix calls for accumulative configurations
166
\Configure{PROLOG}{VERSION,DOCTYPE,*XML-STYLESHEET}
168
{\HCode{<?xml version="1.0"?>}}
170
\Configure{html}............1
172
#1: default extension name for target files (recorded in \:html)
174
\Preamble...................0
176
Records the list of the requested options. Defined upon entering
177
the environment \Preamble{...}....\EndPreamble, to replace the
178
earlier version of \Preamble.
180
\ifOption ................. 3
182
#1 Argument to be checked wheteher it is a given option.
189
\<configure info4ht tex4ht\><<<
190
Wrapper for the Document
191
------------------------
193
\Configure{DOCTYPE}.........1
194
\Configure{HTML}............2
195
\Configure{HEAD}............2
196
\Configure{@HEAD}...........1
197
\Configure{BODY}............2
198
\Configure{TITLE+}..........1
199
\Configure{TITLE}...........2
200
\Configure{@TITLE}..........1
201
\Configure{Preamble}........2
217
The \Configure{@HEAD}{...} command is additive, concatenating the
218
content of all of its appearances. An empty parameter requests
219
the cancellation of the earlier contributions.
230
The \Configure{TITLE+} provides the content for the title,
231
\Configure{TITLE} sets the envelop, and \Configure{@TITLE} acts as a
232
hook for introducing localized configurations. As is the case for
233
\Configure{@HEAD}, the contribution of \Configure{@TITLE} is also
236
These configurations should be introduced early enough in the
237
compilation. For instance, in the case of LaTeX, between \Preamble
238
and \begin{document} of a local configuration file.
247
\Configure{@BODY}...........1
248
\Configure{@/BODY}..........1
250
Variants of \Configure{@HEAD} which contribute their content,
251
respectively, after <body> and before </body>.
253
\Configure{CutAtTITLE+}.....1
254
\Configure{HPageTITLE+}.....1
256
#1 an insertion just before the content of <TITLE>;
258
If #1 is a one parametric macro, it gets the title content for
262
Support for Sectioning Commands
263
-------------------------------
265
\Configure{unit-name} ......................4
275
{\HCode{<section>}} {\HCode{</section>}}
276
{\HCode{<title>}} {\HCode{</title>}}
279
\ConfigureMark{unit-name}...................1
281
Defines a macro \<<unit-name>>HMark to hold the given argument.
282
Upon entering the unit, \TitleMark gets the content of this macro.
284
Some built-in configurations of TeX4ht require an argument for the
285
\<<unit-name>>HMark commands. For safety, these commands should
286
always be followed by a, possiblely empty, argument. The argument
287
should be a separator between the title mark and its content.
293
{\HCode{<h3>}\TitleMark\space} {\HCode{</h3>}}
294
\ConfigureMark{section}{\thesection}
297
\Configure{toTocLink}.......................2
299
Each unit title contains a \Link{...}{...}...\EndLink command.
300
The first argument of \Link points to the first table of contents
301
referencing the title. The second argument provides an anchor
302
for references to the title (mainly from tables of contents).
304
The package option `section+' requests the inclusion of the
305
title within the anchor. Without this option, the link command
306
resides between the title mark and its content.
308
The \Configure{toTocLink} command is provided for configuring
309
the \Link and \EndLink instructions. In the default setting,
310
when the `sections+' option is not activated, the \Link
311
command is altered to replace its first argument with an empty
316
\Configure{toTocLink}
318
{\ifx \TitleMark\sectionHMark
319
\Picture[\up]{haut.jpg align="right"}%
326
\Configure{toToc}...........................2
329
#2 desired contents type (if empty, `unit type' is assumed)
331
Example: \Configure{toToc}{likechapter}{chapter}
333
#1 empty: stop adding entries of `unit type' to toc
334
@: add entries of `unit type' to toc
335
?: resume mode in effect before the last stop
338
Example: \Configure{toToc}{}{chapter}
340
\Configure{toToc}{@}{chapter}
342
\Configure{writetoc}.........................1
344
#1 Configuration material for the insertion instruction.
345
New configurations are added to those request earlier
346
by the command. An empty argument cancels the earlier
349
\NoLink.......................1
351
Ignore option `section+' for sections of type #1
355
Count of entries submitted to the toc file
357
\Configure{NoSection}.........2
359
Insertions around the parameters of sectioning commands, applied when
360
the parameters are not used to create titles for the divisions.
365
#1 section type to be placed in a separate web page
366
#2,#3,... end delimiting section types, other than #1, for
368
A `+' before #1 requests hypertext buttons for the web pages
372
\CutAt{mychapter,myappendix,mypart}
373
\CutAt{+myappendix,mychapter,mypart}
375
\Configure{+CutAt}.................................3
381
Requests delimiters for the \CutAt buttons of the specified
384
Example: \Configure{+CutAt}{mysection}{[}{]}
395
Created from the entries collected in the previous compilation within
398
\ConfigureToc{unit-name} ......................4
400
#1 before unit number
402
#3 before page number
405
* Empty arguments request the omission of the corresponding field.
407
* \TocCount Specifies the entry count withing the jobname.4tc file.
409
* An alternative to \ConfigureToc{unit-name}:
411
\def\<unit-name>#1#2#3{<before unit number>#1<before content>#2%
412
<before page number>#3<at end>}
417
\ConfigureToc{section}
419
{\Picture[*]{pic.jpg width="13" height="13"}~}
424
\Configure{TocLink}..................#1
426
Configures the link offered in the third arguments of \ConfigureToc
428
Example: \Configure{TocLink}{\Link{#2}{#3}#4\EndLink}
432
#1 section type for which local tables of contents
434
#2,#3,... sectioning types to be included in the tables of
437
The non-leading arguments may be preceded by slashes '/', in
438
which cases the arguments specify end points for the tables.
440
The default setting requests automatic insertion of the local
441
tables immediately after the sectioning heads.
443
A star `*' character may be introduced, between the \TocAt and
444
the left brace, to request the appearances of the tables of
445
contents at the end of the units' prefaces.
447
A hyphen `-' character, on the other hand, disables the automatic
448
insertions of the local tables.
450
In case of a single argument, the command removes the
451
existing definition of \Toc#1.
454
\TocAt{mychapter,mysection,mysubsection,/myappendix,/mypart}
455
\TocAt-{mysection,mysubsection,/mylikesection}
456
\section{...}...\Tocmysection
458
\Configure{TocAt}......................
459
\Configure{TocAt*}.....................
462
Navigation Links for Sectioning Divisions
463
-----------------------------------------
465
\Configure{crosslinks}.....................8
476
The content to be displayed in the pointers
478
\Configure{crosslinks*}.................1--7
480
Links to be included and their order. Available
481
options: next, prev, prevtail, tail, front, up.
482
The last argument must be empty.
486
\Configure{crosslinks*}
494
\Configure{crosslinks+}.....................4
498
#3 before bottom menu
501
The top cross links are omitted, if both #1 and #2 are empty.
502
The bottom cross links are omitted, if both #3 and #4 are empty.
504
\Configure{next}.............................2
506
#1 before the next button of the front page, when the `next'
513
\Configure{HtmlPar}..........4
515
#1 content at the start non-indented paragraphs
516
#2 content at the start indented paragraphs
517
#3 insertion into \EndP, at the start of non-indented paragraphs
518
#4 insertion into \EndP, at the start of indented paragraphs
523
\IgnorePar Asks to ignore the next paragraph
524
\ShowPar Asks to take into account the following paragraphs
526
\IgnoreIndent asks to ignore indentation in the next paragraph
527
\ShowIndent asks to check indentation in the following paragraphs
529
\SaveEndP Saves the content of \EndP, and sets it to empty content
538
\Link[@1 @2]{@3}{@4}...\EndLink
542
<a href="@1#@3" name="@4" @2>...</a>
544
* When @1 is empty, tex4ht will derive its value automatically.
545
The derived value will be the file name containing the target @3.
547
* \Link may be followed by `-', if tex4ht needs not automatically
548
determine (for other \link commands) the file containing @4.
549
In the present of such a flag, tex4ht can spare a definition of
552
* The component [@1 @2] is optional. If omitted, @1 and @2 are
555
* The href attribute is omitted when @1 and @3 are empty
557
* The name attribute is omitted when @4 is empty
561
\Link{a}{}...\Endlink ..... \Link{}{b}...\EndLink
562
\Link[http://foo id="fooo"]{a}{b}...\EndLink
564
\Configure{Link}..............4
566
Configures \Link...\EndLink so that
571
#4 replaces `#'. If empty, the older value remains in effect.
575
\Configure{Link}{a}{href=}{name=}{}
576
\Configure{Link}{ref}{target=}{id=}{\empty}
578
\Configure{?Link}..............1
580
#1 insertion before broken links
582
To help with debugging
584
\LinkCommand...................1 <= i <= 6
586
Creates a \Link-like command
589
#2 href-like attribute
590
#3 name-like attribute
592
#5 /, if empty element
593
#6 replacement for # (ignored if absent)
597
\LinkCommand\JSLink{a,\noexpand\jsref,name}
598
\def\jsref="#1"{href="javascript:window.open('#1')"}
600
\JSLink{a}{}xx\EndJSLink
601
\Link{}{a}\EndLink % or \JSLink{}{a}\EndJSLink
603
\Configure{XrefFile}.....................1
605
#1 names cross-references of files (appends #1 to `)F' and `)Q'
606
entries of the .xref files). Applicable mainly implicitly
607
within \Link commands
609
\Tag.....................................2
614
\Ref.....................................1
615
\LikeRef.................................1
619
\Tag and \Ref are tex4ht.sty commands introduced cross-referencing
620
content through .xref auxiliary files.
622
\LikeRef is a variant of \Ref which doesn't verify whether the
623
labels exit. It is mainly used in \Link and \edef environments.
625
\ifTag ..................................3
631
\LoadRef-[prefix]+{filename.ext}{pattern}
633
Load the named xref-type file
635
.xref optional--`.xref' is assume for a default
636
+ optional-- asks \Ref and \LikeRef commands
637
to use expanded tags `filename::tag', instead of just `tag'
638
[prefix] optional--asks just for tags starting with the
640
- optional--deletes the prefixes from the loaded tags
641
{pattern} to be included only when `[prefix]' or `+' are included.
642
States how tags are to be addressed, with the parameter
643
symbol `#1' specifying the loaded part.
648
\LoadRef-[to:]{b}{from:#1} \Ref{from:filename}
649
\LikeRef{from:filename}
652
\Tag{to:filename}{\FileName}
656
\LoadRef-[)F]{file}{)Ffoo##1}
657
\LoadRef-[)Q]{file}{)Qfoo##1}
658
\Configure{XrefFile}{foo} \Link...\EndLink
660
\LoadRef{another-file}
666
\FileName Holds the name of the current hypertext file
667
\FileNumber Holds the internal number of the current hypertext file
668
\RefFileNumber...........................1
671
Provides the file name
673
\NextFile.................................1
674
#1 Requested name for the next file
678
The command asks to load the configuration files associated
683
The command associates configuration file #2 with mark #1. If
684
the mark is the star character `*', the configuration files is
685
associated to all marks. The command is applicable until the
686
\Preamble command is processed
688
For instance, \Hinclude[*]{html4.4ht}....\Hinput{latex}
692
The command is applicable while the \Preamble command is
693
processed. Its purpose is to load *4ht hook files within
694
the fragments of code specified in #1.
696
For instance, \Hinclude{\input plain.4ht}{plain}
702
\Configure{htf}...............................9
704
#1 label (integer 0--255)
705
#2 delimiter (a character not appearing in #3,...,#9)
707
#3 start opening tag start empty tag
713
#9 closing tag end the tag
715
The htf fonts assign a content and a label to each symbol (possibly
716
followed by a comment). For instance,
721
An even label asks that the content itself will be used for the
722
symbol, and an odd label asks that the symbol will be represented by a
723
bitmap. In the later case, the content serves as a substitution for
724
browsers which don't exhibit bitmaps.
726
The \Configure{htf}... command provides label-dependent wrappers to
727
chosen representations.
729
If they are not empty, `mag' and `ord' must be c-type
730
patterns for integer arguments, and `name' and `size'
731
should be a patterns for strings. The `mag' entry is
732
ignored for fonts of the default dimension. Together
733
they specify a attribute-value format, mainly for references
738
\Configure{htf}{0}{+}{<span\Hnewline
739
class="}{\%s}{-\%s}{x-x-\%d}{}{">}{</span>}
740
\Configure{htf}{1}{+}{<img\Hnewline
741
src="}{" alt="}{" class="}{\%s}{-\%d}{x-x-\%x}{" />}
743
\Configure{htf-attr}....................... 2
745
#1 c-pattern for the font name and size
746
#2 c-pattern for font magnification
748
Specify the format of the selectors within the css files.
751
\Configure{htf-attr}{.\%s-%s}{--\%s}
753
\Configure{htf-css}....................... 2
755
#1 font name or label
758
A variant of the \Css command. If #1 is a font name,
759
the contribution replaces the one given within the
760
htf font definition. If #1 is a label for an entry
761
of a htf font, the contribution is added to the css
762
file. The contribution is offered, only when the
767
\Configure{htf-css}{4}{.small-caps{font-variant: small-caps;}}
773
\Configure{Picture}....................... #1
775
#1 Extension name for bitmap files of dvi pictures,
778
Default: \Configure{Picture}{.png}
780
The extension names of bitmap files of glyphs of htf fonts may be
781
determined within a g-entry in the environment file tex4ht.env, or a
782
g-flag of the tex4ht.c utility.
784
\Configure{Picture-alt}......................1
786
#1 alt value for \Picture+{...} and \Picture*{...}
788
\Configure{Picture+}.........................2
789
\Configure{Picture*}.........................2
791
#1 before the dvi picture code
792
#2 after the dvi picture code
794
Typically, the plus `+' variant is introduced as an inline
795
contribution into paragraphs, and the star `*' variant as an
796
independent block between paragraphs.
798
\Configure{PictureAlt}........................2
799
\Configure{PictureAlt*+}......................2
800
\Configure{PictureAlt*+[]}....................2
802
#1 definitions before alt
803
#2 definitions after alt
805
Apply to \Picture{...}, \Picture*+{...}, and \Picture*+[...]{...}
807
\Configure{PictureAlt}........................1
808
\Configure{PictureAlt*+}......................1
809
\Configure{PictureAlt*+[]}....................1
811
#1 definition for attributes (introduced through
812
a parameter named `#1')
814
Apply to \Picture{...}, \Picture*+{...}, and \Picture*+[...]{...}
816
\Configure{IMG}...............................5
819
#2 between file name and alt
820
#3 close alt for \Picture without * or +
821
#4 close alt for \Picture with * and +
827
{\ht:special{t4ht=<img src="}}
828
{\ht:special{t4ht=" alt="}}
830
{\ht:special{t4ht=" }}
831
{\ht:special{t4ht=/>}}
833
\NextPictureFile.............................1
835
Requests a file name for the next created picture.
837
\PictureFile.............................0
839
Records the filename of the most recent created picture.
844
\Configure{$}................................2
845
\Configure{$$}...............................2
846
\Configure{DviMath}..........................2
848
\DviMath ... \EndDviMath
849
\MathClass ... \EndMathClass
850
\PicMath ... \EndPicMath
851
\DisplayMath ... \EndDispalyMath
855
\Configure{$} {\Tg<math>\DviMath} {\EndDviMath\Tg</math>} {}
859
\Configure{PicMath}..........................4
863
\Configure{PicMath}{}{}{}{ class="math" }
865
\Configure{()}{\protect\PicMath$}{$\protect\EndPicMath}
867
\Configure{SUB}..............................2
868
\Configure{SUP}..............................2
869
\Configure{SUBSUP}...........................3
870
\Configure{SUPSUB}...........................3
871
\Configure{SUB/SUP}..........................6
873
\Configure{putSUB}...........................1
874
\Configure{putSUP}...........................1
876
#1 the code to be used for realizing subscripts and postcripts
878
\Configure{afterSUB}.........................2
880
#1 look ahead token after subscript
881
#2 the code to be used for realizing subscripts having #1 for
884
\Configure{over}.............................2
885
\Configure{atop}.............................2
886
\Configure{above}............................2
887
\Configure{overwithdelims}...................2
888
\Configure{atopwithdelims}...................2
889
\Configure{abovewithdelims}..................2
891
#1 before \over, \atop, \above
892
\overwithdelims, \atopwithdelims, \abovewithdelims
893
#2 after \over, \atop, \above <dimension>
894
\overwithdelims <del1> <del2>
895
\atopwithdelims <del1> <del2>
896
\abovewithdelims <del1> <del2> <dimension>
901
{\Send{GROUP}{0}{[before]}[before-rule]}
902
{[before-argument]\Send{EndGROUP}{0}{[after]}}
905
\Configure{MathClass}........................5
908
0: mathord, 1: mathop, 2: mathbin, 3: mathrel,
909
4: mathopen, 5: mathclose, 6: mathpunc
919
\NewMathClass<new control sequence> (7, 8, ...)
921
\Configure{FormulaClass}.....................4
924
0: mathord, 1: mathop, 2: mathbin, 3: mathrel,
925
4: mathopen, 5: mathclose, 6: mathpunc
926
#2 a character not in #3 and #4
930
If #2 is empty, the formula gets the same marking as a
931
single character of the specified type
933
\Configure{FormulaClass*}....................4
935
Like the previous case, but allow marking in the
938
\Configure{MathDelimiters}...................2
943
\Configure{mathbin*}.........................4
944
\Configure{mathclose*}.......................4
945
\Configure{mathop*}..........................4
946
\Configure{mathopen*}........................4
947
\Configure{mathord*}.........................4
948
\Configure{mathpunct*}.......................4
949
\Configure{mathrel*}.........................4
951
#1 a character not presented in #2#3#4
954
#4 possible definitions for successive cases
957
\Configure{mathop*}{*}{}{}
958
{\Configure{mathop}{*}{<mo>}{</mo>}{}}
959
\mathop{\overline{x \mathop{op} y}} \limits^{a=3}
961
\Configure{mathbin}..........................4
962
\Configure{mathclose}........................4
963
\Configure{mathopen}.........................4
964
\Configure{mathop}...........................4
965
\Configure{mathord}..........................4
966
\Configure{mathpunct}........................4
967
\Configure{mathrel}..........................4
969
Variants of the above group, requesting to supress nested marks.
971
\Configure{nolimits}.........................1
978
\Configure{AtBeginDocument}..................2
980
#1 before the corresponding hook of latex
983
Insertions are accumulative, and can be erased by providing
989
\Configure{HChar}...................1
993
The \HChar{i} instruction inserts the character code i with the
994
font information of character #1, when i is positive. If i is
995
negative, the font info is not included.
999
\Configure{ExitHPage}
1000
\Configure{LinkHPage}......................1
1002
\Configure{HVerbatim+}
1003
\Configure{MiniHalign}
1008
\Configure{TraceTables}
1010
\Configure{halignTB}
1011
\Configure{halignTD}
1014
\Configure{moveright}
1016
\Configure{noalign-}
1017
\Configure{pic-halign}
1020
\Configure{mathaccent}
1021
\Configure{accented}
1022
\Configure{accenting}
1029
= \special{t4ht=...content...}
1030
Insert the specified content to the html output, under
1031
edef mode of processing, and without using the mapping
1032
of the htf fonts. Used in \HCode{...}.
1033
@ \special{t4ht@...integer...}
1034
Insert the absolute value as character code to the output.
1035
Positve values ask the insertion to be included in place
1036
of the next chracter, together with the font information
1040
> \special{t4ht>...file-name...}
1041
Open a new file, if needed, and direct future output
1042
to the specified file. Used in \File{...}.
1043
< \special{t4ht<...file-name...}
1044
Close the specified file. If it is the current file,
1045
activate the youngest file. Used in \EndFile{...}.
1046
>* \special{t4ht*>...file-name...}
1047
Declare the file to be the oldest.
1049
Reactivate the file that activated the current file.
1050
*< \special{t4ht*<file}
1051
Input file (with no processing)
1052
+ \special{t4ht++file-name}...dvi...\special{t4ht+}
1053
Pipe the dvi code into a dvi page in the secondary dvi file
1054
`jobname.idv'. Used by \Picture{...}, e.g., for requesting
1056
+ \special{t4ht+embeded-specials within idv}
1057
. \special{t4ht.ext}
1058
Change default ext of root file
1059
@D \special{t4ht@D....} Writes the content, augmented with a
1060
loc stamp, to the .lg file. The locations stamp consists
1061
a byte-address in a named output file.
1065
! \special{t4ht!...optional-parameters....}...dvi...\special{t4ht!}
1066
Create an approximated character map for the dvi code.
1067
Used in \Picture{...}, e.g., for ALT of IMG
1068
|| \special{t4ht||}...\special{t4ht||}
1069
Use the non-pictorial characters of the htf fonts.
1070
Used for character maps of \Picture{....}
1071
@ \special{t4ht@-}....\special{t4ht@-}
1072
Remove left margin from character map. Used in \Picture{...}.
1076
@ \special{t4ht@@}....\special{t4ht@@}
1077
Insert the character codes, instead of their mappings through
1078
the htf fonts. Used in \JavaScript...
1079
@ \special{t4ht@...integer...}, \special{t4ht@-...integer...}
1080
Introduce the character code into the output.
1081
Used by \HChar{...} and \HChar{-...}. The earlier one
1082
also inherites the current font info.
1083
@ \special{t4ht@+...string...}
1084
Replace the character code introduced by the next character
1085
with the specified string. The decoration of the character
1086
code is inherited, when the string is not empty. The string
1087
might include character codes by enclosing them between braces.
1088
@ \special{t4ht@*...string...}
1089
A variant \special{t4ht@+...string...} that inserts the content
1090
after the character instead of replacing it.
1096
Ignore chs and spaces
1098
End ignore chs and spaces
1099
@ \special{t4ht@[...}...\special{t4ht@]...}\special{t4ht@?...}
1100
Ignore chs and spaces, if the specials have the above
1101
syntax on identical strings.
1103
Get the last ignored spaces (none, if from previous lines).
1104
@ \special{t4ht@_....}
1105
Output character for rulers. Empty string is also allowed.
1106
@ \special{t4ht@.''''}
1107
Output for line break characters (empty content resets the default).
1108
@ \special{t4ht@,''''}
1109
Output for space characters (empty content resets the default).
1113
@ \special{t4ht@%X}...\special{t4ht@%x}
1114
Request dvi tracing.
1119
H h horizontal spaces
1123
\special{t4ht@%%X*...open-del....*...close-del....}
1124
\special{t4ht@%%x*...open-del....*...close-del....}
1128
On/off tracing of specials.
1129
@ \special{t4ht@e...}
1130
String for tracing errors into the output.
1131
; \special{t4ht;....}
1132
Decorations for htf characters (e.g., css)
1136
=... show font name of char
1137
%... show font size of char
1138
, don't report next htf class to lg
1139
- set default font info
1140
+ unset default font info
1141
^ \special{t4ht^i}$symbols$\special{t4ht^}}'
1142
Requests math class i for the listed math symbols.
1144
Tex assignes class numbers 0--7 to the atoms of math
1145
formulas: 0--ordinary symbol, 1--large operator, 2--binary
1146
operation, 3--relational operation, 4--math delimiter,
1147
5--right delimiter, 6--punctuation mark, and 7--adjustable.
1148
TeX4ht adds classes 8 and 9, while using
1149
class 7 independently
1151
on/off processing delimiters
1153
pause processing delimeters
1155
continue processing delimeters
1157
on/off processing delimiters of class i
1158
\special{t4ht^i*...*...}
1159
configure delimiters for class i. * can be any
1160
character distinguished for the group.
1162
put delimiters of class i on next group
1164
As before, but ignore the delimeters within the sub-group.
1165
\special{t4ht^)*...*...}
1166
put the specified delimiters on next group.
1167
Ignore delimeters within the group.
1168
\special{t4ht^<*...*...}
1169
put the specified delimiters on the next group.
1170
Don't ignore delimeters within the group.
1173
: \special{t4ht:....}
1174
Dvi-mode arithmetics.
1175
:+... increment by 1( define, if not defined)
1176
:-... decrement by 1
1177
:>... push current value
1178
:<... pop current value
1179
:!... display current value
1180
:|... display top value
1184
+ \special{t4ht+@...message...}
1185
Send message to the lg file. Used in the \Needs{...} command.
1186
@ \special{t4ht@D....}
1187
Send message to the lg file, together with location and file
1193
Start/end positional env
1194
\special{t4ht"* before-all * after-all ...** before-char
1198
Configure positioned code
1201
** before-char %x %y
1204
* x,x1-coefficients %A(x) + %B
1205
* y1-coefficients %C(y1 - %E(height)) + %D
1206
* y-coefficients %C(y) + %D
1209
%x1 %y1 %length %thickness default
1210
%x1 %y1 %x1+length %y1+thickness 1
1211
%x1 %y1 %x1+length %y1 %thickness 2
1213
A-magnification, B-displacement
1214
C-magnification, D-displacement,
1215
E- origin (0: top, 0.5: mid, 1: bot)
1217
The %...'s should be c-type templates (e.g., "%.2f"; "%.0f"
1220
Multiple after-all templates are allowed. The leading
1221
character is a code specifying the dimension type.
1228
otherwise a string with no values
1229
The delimiter `*' can be substitued by another character.
1232
~ \special{t4ht~...}
1233
Grouped-base two-way delivery for content created by
1234
inline commands like \over.
1236
\special{t4ht~}...\special{t4ht~} on/off
1238
~<i... send forward to the start of the group nested
1239
at relative level i.
1240
~>i... send forward to the end of the group nested
1241
at relative level i.
1245
~<*... send back to start of previous token / group.
1246
\special{t4ht~<)}...\special{t4ht~<(}
1247
activate / deactivate back token / group submissions
1248
\special{~<[}...\special{t4ht~<]}'
1249
hide region from back submissions over token / group
1250
\special{t4ht~<-} ... \special{t4ht~<+}
1251
latex back token / group
1253
\special{t4ht\string~!...path...<...content}
1254
insertion at the start of the group reached by the path
1255
\special{t4ht\string~!...path...>...content}
1256
insertion at the end of the group reached by the path
1257
\special{t4ht\string~!...path.../}
1258
ignore content within the group reached by the path
1259
\special{t4ht\string~!...path...-}
1260
ignore rulers from the group reached by the path
1261
until the start of the next group
1262
A path may consist only of `e' and `s' characters for,
1263
respectively, entering and skipping groups
1265
*! \special{t4ht*! system command}
1270
\HCode...............................1
1272
A wrapper for \special{t4ht=...}
1274
\Hnewline............................0
1276
Requests new lines within specials
1288
\Configure{VBorder}...................4
1290
Break points, when scanning the pattern of column desriptions, at
1292
#1 at start of pattern
1297
Applies to \begin{tabular / array}{...pattern...}
1299
\ar:cnt index of entry in pattern
1300
\ch:class records the current alignment type: -,<,>,p,...
1301
\HColAlign produces the \Configure{halignTD} contribution
1302
for the current alignment type
1303
\HColWidth holds the width of the current p column
1305
\Configure{HBorder}..................10
1308
#1 insert at start of row (e.g., <tr>)
1309
#2 insert at each cell (e.g., <td><hr/></td>)
1310
#3 insert at end of row (e.g., </tr>)
1313
#4 insert at start of row (e.g., <tr>)
1314
#5 insert at each `extra' cell (e.g., <td></td>)
1315
#6 insert at each cell (e.g., <td><hr/></td>)
1316
#7 insert at end of row (e.g., </tr>)
1319
#8 insert at start of row (e.g., <tr>)
1320
#9 insert at each cell (e.g., <td> </td>)
1321
#10 insert at end of row (e.g., </tr>)
1323
The contributions are collected into \HBorder. (The \InitHBorder
1326
\Configure{putHBorder}...............1
1327
#1 Specifies how \HBorder is to be used.
1329
Example: \Configure{putHBorder}{\HCode{\HBorder}}
1333
\<configure info4ht latex\><<<
1337
\Configure{@sec @ssect}
1344
\Configure{tableofcontents}........................5
1349
#4 at paragraph break
1352
The \tableofcontents command may be followed by a comma separated
1353
list of sectioning unit names to be included in the table of
1354
contents. The list should be enclosed within square brackets.
1355
Alternatively, a command of the form \TableOfContents[...] might
1361
\ConfigureList.....................5
1363
#1 type of list (e.g., itemize, description, enumerate,
1370
\DeleteMark removes latex's label; to be placed at the end of #4
1371
\AnchorLabel defines an anchor for \label in current item; to
1378
\Configure{tabular}...................6
1379
\Configure{array}.....................6
1381
#1 before table #2 after table
1382
#3 before row #4 after row
1383
#5 before cell #6 after cell
1385
\HRow current row number
1386
\HCol current column number
1387
\HMultispan number of cells covered by the current cell
1388
\ar:cnt number of columns in table
1390
NOTE: Table require a number of compilations that depends
1391
on the number of columns.
1395
\Configure{halignTD}..................2 + 2i + {}
1397
interpretation for character codes referenced in \HAlign
1401
\Configure{halignTD}
1403
{<}{\HCode{align="left"}}
1404
{-}{\HCode{align="center"}}
1405
{>}{\HCode{align="right"}}
1406
{^}{\HCode{valign="top"}}
1407
{=}{\HCode{valign="baseline"}}
1408
{||}{\HCode{valign="middle"}}
1409
{_}{\HCode{valign="bottom"}}
1410
{p}{\HCode{align="left"}}
1413
\halignTD can be used in td elements to extract the alignment.
1414
It recieves information from \halignTB.
1416
\Configure{halignTB}..................2
1418
delimiters for \halignTB{tabular}
1421
\Configure{halignTB}{\HCode{<table }}{\HCode{>}}
1423
\Configure{tabbing}[mag]..................4
1427
#3 before each entry
1430
[mag] optional parameter specifying the magnification desired
1431
for the dimensions. When offered, the other parameters
1432
have no effect if all of them are assigned empty arguments
1434
\TabType \` or \relax
1435
\TabWidth Provides the entry width; 0 at trailing entry that is
1436
not flushed rightward
1442
\Configure{ref}.......................3
1444
#1 \Link-type command
1445
#2 \EndLink-type command
1446
#3 anchor (the system anchor is
1447
reachable through the parameter name #1)
1448
\RefArg Holds the argument of \ref
1450
If #1 is empty, the hyper links are ignored
1451
If #3 is empty, the anchor is the one provided by the system
1455
\Configure{ref}{\Link}{\EndLink}{{\bf #1}}
1457
\Configure{pageref}...................3
1461
#3 anchor (system anchor, if parameter is empty)
1463
\Configure{newlabel}..................2
1465
#1 address for hyperlink (\cur:th \:currentlabel, if empty)
1466
#2 anchor (the system anchor is
1467
reachable through the parameter name #1)
1469
\Configure{@newlabel}.................1
1471
#1 modifications to the newlabel environment
1473
\Configure{newlabel-ref}..............1
1475
#1 an intermediate link command for the aux file
1476
(Configured by \Configure{ref}...)
1478
The default for #1 is \rEfLiNK
1480
\Configure{cite}......................4
1484
#3 \Link-type command
1485
#4 \EndLink-type command
1487
If #3 is empty, the hyper links are ignored.
1489
\Configure{bibitem}...................2
1491
#1 \Link-type command
1492
#2 \EndLink-type command
1494
\Configure{bibcite}...................1
1496
#1 configurations for content transfered by bibitem to the aux file
1500
{\def\hookrightarrow{\string\hookrightarrow}}
1501
\bibitem[$\hookrightarrow$...]{...}
1504
\LoadLabels[#1]{#2}....................
1506
[#1] optional group name
1507
#2 aux file name, without the extension
1509
Loads labels of another file, under the specified group name
1511
\RefLabel.............................2
1513
#1 group name (for separating files and labels from
1517
A variant of \ref for loading labels produced for other files
1520
file1.tex: \label{foo}
1522
file2.tex: \LoadLabels[x]{file1}
1525
\SkipRefstepAnchor.....................0
1527
No \Link anchor for next \refstepcounter
1529
\ShowRefstepAnchor.....................0
1530
\AutoRefstepAnchor.....................0
1533
Bibliography on bibtex2 option:
1535
\Configure{bibliography2}........................ 4
1544
\Configure{bibliography2}
1545
{\bgroup ~~[\Configure{Link}{a}{target="x" href=}{ name=}{}}
1548
\Configure{bibitem2}..............................3
1550
#1 at start of bibitem
1551
#2 at end of bibitem
1552
#3 separator after label
1554
\Configure{bibliographystyle2}....................1
1556
#1 an empty argument asks for the same style as the
1557
normal aux file (still bibtex may produce different
1560
Note: Option `bibtex2' requires compilation
1561
of `\jobname j.aux' with bibtex.
1568
An option for \Preamble, requesting anchors at \caption. The default
1569
setting sends them back to the start of the floating environment.
1575
\Configure{newtheorem} ......................3
1578
#2 between title and body
1583
\Configure{()}...............................2
1584
\Configure{[]}...............................2
1588
\Configure{()}{\protect\PicMath$}{$\protect\EndPicMath}
1589
\Configure{[]} {\Tg<display>\DviMath$$} {$$\EndDviMath\Tg</display>}
1591
\Configure{equation}.........................3
1594
#2 between the equation and its numbering
1599
\Configure{equation}
1600
{\IgnorePar\EndP\bgroup \Configure{HtmlPar}{}{}{}{}%
1601
\HCode{<table class="equation"><tr><td>}\IgnorePar
1603
{\HCode{</td><td class="eq-number">}}
1604
{\HCode{</td></tr></table>}\egroup}
1606
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1608
\Configure{equation}
1609
{\IgnorePar\EndP \bgroup \Configure{$$}{}{}{}%
1610
\Configure{@math}{display="inline"}\DviMath
1611
\HCode{<mtable class="equation"><mtr><mtd>}\IgnorePar
1613
{\IgnorePar\HCode{</mtd><mtd class="eq-number">}}
1614
{\HCode{</mtd></mtr></mtable>}\EndDviMath\egroup}
1617
\Configure{frac}.............................4
1618
\Configure{sqrtsign}.........................2
1620
\Configure{mbox}.............................2
1622
Environments of latex
1623
---------------------
1625
\ConfigureEnv{...}.........................4
1630
#4 before underlying list
1631
#5 after underlying list
1633
#2 and #3 are ignore when they are both empty as well as
1634
when there is no underlying list
1648
\Configure{@begin}........................2
1651
#2 insertion before the environment
1654
\Configure{@begin}{theindex}{\section*{\indexname}}
1660
\Configure{verbatim}......................2
1665
\Configure{verb}..........................2
1670
\Configure{obeylines}.....................3
1676
\ScriptEnv................................3
1678
Introduces a verbatim environent
1684
A `-' immediately after \begin{...} designate as an escape symbol
1685
the character following the dash
1690
{\HCode{<myscript>}\NoFonts\hfill\break }
1691
{\EndNoFonts \HCode{</myscript>}}
1707
\Configure{texttt}........................2
1708
\Configure{textit}........................2
1709
\Configure{textrm}........................2
1710
\Configure{textup}........................2
1711
\Configure{textsl}........................2
1712
\Configure{textsf}........................2
1713
\Configure{textbf}........................2
1714
\Configure{textsc}........................2
1715
\Configure{emph}..........................2
1724
\Configure{footnotetext}..................3
1727
#2 between mark and content
1730
\FNnum footnote number
1732
\Configure{footnotemark}..................2
1740
\Configure{picture}.......................2
1748
\Configure{ }.........................1
1750
#1 representation for non-breaking space ch
1752
\Configure{hline}.....................1
1754
\Configure{hspace} ...................3
1756
\tmp:dim register holding the size
1759
#3 after #1 (\tmp:dim mod 6em copies)
1761
\Configure{vspace} ...................1
1763
#1 the size of space is prvided in a parameter nmaed `#1'
1770
\ifdim #1>1ex \HCode{<br />}\fi
1774
\Configure{fbox} .................................. 2
1779
{\HCode{<div class="fbox">}\bgroup \fboxrule=0pt}
1780
{\egroup\HCode{</div>}}
1781
\Css{div.fbox {border: 1pt solid black;}}
1784
{\HCode{<table cellspacing="0pt"
1785
border="1"><tr><td>}\bgroup \fboxrule=0pt}
1786
{\egroup\HCode{</td></tr></table>}}
1788
\Configure{'} ..................................... 3
1790
#1 at entry to math prime environment
1792
#3 content of \prime
1794
\Configure{float}....................................
1795
#1 optional, to appear within brakects [ and ]. An anchor for
1796
the links preceeding the float, when option refcaption is
1798
#2 Insertion before the links
1802
\Configure{textcircled}.............................2n+1
1803
2i'th replaced i=1,...,n
1805
2n+'nd empty (terminator)
1808
\Configure{add accent}{#1:#2}{#3}{#4}...{}{}
1811
#3 character under font
1814
Applies to accents that reach \add@accent
1818
\Configure{add accent}{OT4:18}
1827
\Configure{AfterTitle}
1829
\Configure{InsertTitle}
1832
\Configure{centercr}
1833
\Configure{centerline}
1835
\Configure{displaylines}
1836
\Configure{framebox}
1838
\Configure{leftline}
1839
\Configure{marginpar}
1840
\Configure{mathaccent}
1844
\Configure{overline}
1846
\Configure{rightline}
1847
\Configure{stackrel}
1849
\Configure{underline}
1850
\Configure{thanks}....................2
1860
\>>>maketitleInfo<<<
1863
\Configure{maketitle}.....................4
1865
#1 start of maketitle
1870
\Configure{thanks author date and}........8
1878
#7 representation of `and'
1879
#8 line breaks (= end of rows, for an embedded tabular environment)
1882
\>>>thebibliographyInfo<<<
1886
\ConfigureList{thebibliography}......4
1893
\DeleteMark removes latex's label; to be placed at the end of #3
1894
\AnchorLabel defines an anchor for \label in current item; to
1897
\Configure{cite} see the
1898
\Configure{bibitem} latex section
1905
\>>>tableofcontentsStr<<<
1906
\Configure{tableofcontents*}.......................1
1908
#1 A non-empty parameter asks to implicitly introduce
1909
a \tableofcontents upon reaching the first sectioning
1910
command, if no \tableofcontents command is encountered
1911
earlier. The parameter assumes a colon-separated list
1912
of sectioning types to be included in the output
1913
of \tableofcontents. Starred variants of sectioning
1914
types should be referenced with the `like' prefix.
1916
An empty parameter cancels earlier requests for implicit
1917
calls to \tableofcontents (e.g., embedded within requests
1918
to package options 1, 2, 3, 4)
1922
\Configure{tableofcontents*}{part,likepart,%
1923
section,likesection,subsection,likesubsection}
1927
A LaTeX macro stating the title for a table of contents division.
1931
\Configure{theindex} ..........................9
1939
#7 before-subsubitem
1945
\Configure{theindex}
1946
{\HCode{<ul class="theindex">}\global\let\IndexSpace=\empty}
1948
{\HCode{<li \IndexSpace>}\global\let\IndexSpace=\empty}
1949
{\HCode{</li>\Hnewline}}
1950
{\HCode{<li>}\ \ \ \ } {\HCode{</li>\Hnewline}}
1951
{\HCode{<li>}\ \ \ \ \ \ \ \ } {\HCode{</li>\Hnewline}}
1952
{\global\def\IndexSpace{class="indexspace"}}
1954
\Css{.indexspace{margin-top:1em;}}
1956
The links are indirectly requested in the idx files within
1957
\beforeentry macros. For instance, a file try.tex
1959
\documentclass{article}
1976
produces a file try.idx of the form
1978
\beforeentry{try.html}{dx1-1001}{}
1980
\beforeentry{try.html}{dx1-1002}{}
1982
\beforeentry{try.html}{dx1-1003}{}
1984
\beforeentry{try.html}{dx1-1004}{}
1986
\beforeentry{try.html}{dx1-1005}{}
1988
\beforeentry{try.html}{dx1-1006}{}
1993
\beforeentry{A}{B}{}\indexetry{C}{D}
1995
represents an entry of the form
1997
\indexentry{\Link[A]{B}{}C\EndLink}{D}
1999
The makeindex utility ignores the \beforeentry records. To compensate
2000
for that, one needs to pre-process the idx file which is introduced to
2001
the makeindex utility and/or post-process the output of the utility.
2003
A script consisting of two instructions similar to
2005
tex '\def\filename{{try}{idx}{4dx}{ind}} \input idxmake.4ht'
2006
makeindex -o try.ind try.4dx
2010
makeindex -o try.ind try.idx
2014
On some platforms, the quotation marks ' should be
2015
replaced by double quotation marks " or eliminated.
2017
\Configure{makeindex} ..........................1
2019
The default setting, requests consecutive numbers for the
2020
pointers in the indexes. The current command provides the
2021
means to configure the pointers to other values.
2023
Example: \Configure{makeindex}{Sec \arabic{section}}
2029
\<configure info4ht book\><<<
2037
\Configure{subsection}
2038
\Configure{subsubsection}
2039
\Configure{paragraph}
2040
\Configure{subparagraph}
2042
\Configure{likepart}
2043
\Configure{likechapter}
2044
\Configure{likesection}
2045
\Configure{likesubsection}
2046
\Configure{likesubsubsection}
2047
\Configure{likeparagraph}
2048
\Configure{likesubparagraph}
2049
|thebibliographyInfo
2054
lof, lot, appendix, chapter, likechapter, likeparagraph, likepart,
2055
likesection, likesubparagraph, likesubsection, likesubsubsection,
2056
paragraph, part, section, subparagraph, subsection, subsubsection
2059
\Configure{appendixTITLE+}........1
2060
\Configure{chapterTITLE+}.........1
2061
\Configure{partTITLE+}............1
2062
\Configure{sectionTITLE+}.........1
2063
\Configure{subsectionTITLE+}......1
2064
\Configure{subsubsectionTITLE+}...1
2066
#1 an insertion just before the content of <TITLE>;
2068
The insertion overrides the one offered by \Configure{CutAtTITLE+}
2069
for the given section type (the `like' counterparts acn also be
2072
If #1 is a one parametric macro, it gets the title content for
2075
\Configure{endpart}................1
2076
\Configure{endchapter}.............1
2077
\Configure{endsection}.............1
2078
\Configure{endsubsection}..........1
2079
\Configure{endsubsubsection}.......1
2080
\Configure{endparagraph}...........1
2081
\Configure{endsubparagraph}........1
2082
\Configure{endappendix}............1
2083
\Configure{endlikepart}............1
2084
\Configure{endlikechapter}.........1
2085
\Configure{endlikesection}.........1
2086
\Configure{endlikesubsection}......1
2087
\Configure{endlikesubsubsection}...1
2088
\Configure{endlikeparagraph}.......1
2089
\Configure{endlikesubparagraph}....1
2091
#1 a comma separated list specifying the end
2092
points for the configured logical unit
2094
e.g., \Configure{endsection}
2095
{likesection,chapter,likechapter,appendix,part,likepart}
2108
Environments of book:
2109
---------------------
2111
\ConfigureEnv{...}.........................4
2126
\Configure{appendix}
2141
\<configure info4ht report\><<<
2143
|thebibliographyInfo
2146
\ConfigureList{description}%
2150
lof, lot, appendix, chapter, likechapter, likeparagraph, likepart,
2151
likesection, likesubparagraph, likesubsection, likesubsubsection,
2152
paragraph, part, section, subparagraph, subsection, subsubsection
2155
\Configure{appendixTITLE+}
2156
\Configure{chapterTITLE+}
2157
\Configure{partTITLE+}
2158
\Configure{sectionTITLE+}
2159
\Configure{subsectionTITLE+}
2160
\Configure{subsubsectionTITLE+}
2162
#1 an insertion just before the content of <TITLE>;
2164
The insertion overrides the one offered by \Configure{CutAtTITLE+}
2165
for the given section type (the `like' counterparts acn also be
2168
If #1 is a one parametric macro, it gets the title content for
2172
\Configure{endpart}................1
2173
\Configure{endchapter}.............1
2174
\Configure{endsection}.............1
2175
\Configure{endsubsection}..........1
2176
\Configure{endsubsubsection}.......1
2177
\Configure{endparagraph}...........1
2178
\Configure{endsubparagraph}........1
2179
\Configure{endappendix}............1
2180
\Configure{endlikepart}............1
2181
\Configure{endlikechapter}.........1
2182
\Configure{endlikesection}.........1
2183
\Configure{endlikesubsection}......1
2184
\Configure{endlikesubsubsection}...1
2185
\Configure{endlikeparagraph}.......1
2186
\Configure{endlikesubparagraph}....1
2188
#1 a comma separated list specifying the end
2189
points for the configured logical unit
2191
e.g., \Configure{endsection}
2192
{likesection,chapter,likechapter,appendix,part,likepart}
2198
\Configure{appendix}................4
2200
\Configure{likechapter}
2201
\Configure{likeparagraph}
2202
\Configure{likepart}
2203
\Configure{likesection}
2204
\Configure{likesubparagraph}
2205
\Configure{likesubsection}
2206
\Configure{likesubsubsection}
2207
\Configure{paragraph}
2210
\Configure{subparagraph}
2211
\Configure{subsection}
2212
\Configure{subsubsection}
2217
Environments of report:
2218
----------------------
2220
\ConfigureEnv{...}.........................4
2235
\Configure{thanks author date and}
2241
\<configure info4ht article\><<<
2246
\Configure{part}...................4
2247
\Configure{section}................4
2248
\Configure{subsection}.............4
2249
\Configure{subsubsection}..........4
2250
\Configure{paragraph}..............4
2251
\Configure{subparagraph}...........4
2258
\Configure{likepart}...............4
2259
\Configure{likesection}............4
2260
\Configure{likesubsection}.........4
2261
\Configure{likesubsubsection}......4
2262
\Configure{likeparagraph}..........4
2263
\Configure{likesubparagraph}.......4
2265
starred versions of the sectioning commands
2267
\Configure{endpart}................1
2268
\Configure{endsection}.............1
2269
\Configure{endsubsection}..........1
2270
\Configure{endsubsubsection}.......1
2271
\Configure{endparagraph}...........1
2272
\Configure{endsubparagraph}........1
2273
\Configure{endlikepart}............1
2274
\Configure{endlikesection}.........1
2275
\Configure{endlikesubsection}......1
2276
\Configure{endlikesubsubsection}...1
2277
\Configure{endlikeparagraph}.......1
2278
\Configure{endlikesubparagraph}....1
2280
#1 a comma separated list specifying the end
2281
points for the configured logical unit
2283
e.g., \Configure{endsection}
2284
{likesection,chapter,likechapter,appendix,part,likepart}
2286
\Configure{partTITLE+}
2287
\Configure{sectionTITLE+}
2288
\Configure{subsectionTITLE+}
2289
\Configure{subsubsectionTITLE+}
2292
#1 an insertion just before the content of <TITLE>;
2294
The insertion overrides the one offered by \Configure{CutAtTITLE+}
2295
for the given section type (the `like' counterparts acn also be
2298
If #1 is a one parametric macro, it gets the title content for
2302
|thebibliographyInfo
2308
lof, lot, appendix, chapter, likechapter, likeparagraph, likepart,
2309
likesection, likesubparagraph, likesubsection, likesubsubsection,
2310
paragraph, part, section, subparagraph, subsection, subsubsection,
2318
\Configure{caption}...............4
2320
#1 before number #2 after number
2321
#3 before title #4 after title
2328
Environments of article:
2329
------------------------
2331
\ConfigureEnv{...}.........................4
2352
\<configure info4ht fontmath\><<<
2353
\Configure{mathbf}........................2
2354
\Configure{mathit}........................2
2355
\Configure{mathrm}........................2
2356
\Configure{mathsf}........................2
2357
\Configure{mathtt}........................2
2362
\Configure{overbrace}.................3
2363
\Configure{underbrace}................3
2369
\<configure info4ht graphics\><<<
2370
\Configure{graphics}...............2
2372
#1 before \includegraphics
2373
#2 after \includegraphics
2378
\Configure{graphics}
2379
{\Picture+[PIC]{ class="graphics"}}
2382
\Configure{graphics}
2385
{\ht:special{t4ht=<img src="}}
2386
{\ht:special{t4ht=" alt="}}
2388
{\ht:special{t4ht=" }}
2392
\def\temp{.pstex}\expandafter\ifx
2393
\csname Gin@ext\endcsname\temp
2394
\HCode{ width="75\%" }\fi
2399
\Configure{graphics*}..............2
2404
\Gin@base (file name), \Gin@ext, \Gin@req@width, \Gin@req@height,
2405
\noBoundingBox (defined iff bounding box is unknown)
2407
Allows to configure tex4ht for graphics files named in
2408
the \includegraphics macro, based on the type of the files.
2412
\Configure{graphics*}
2414
{\Picture[pict]{\csname Gin@base\endcsname.jpg}}
2416
\Configure{graphics*}
2418
{\Needs{"convert \csname Gin@base\endcsname.wmf
2419
\csname Gin@base\endcsname.gif"}%
2420
\Picture[pict]{\csname Gin@base\endcsname.gif
2421
width="\expandafter\the\csname
2422
Gin@req@width\endcsname"
2423
height="\expandafter\the\csname
2424
Gin@req@height\endcsname"}%
2427
\Configure{graphics*}
2429
{\openin15=\csname Gin@base\endcsname\PictExt\relax
2431
\Needs{"convert \csname Gin@base\endcsname.eps
2432
\csname Gin@base\endcsname\PictExt"}%
2435
\Picture[pict]{\csname Gin@base\endcsname\PictExt}%
2438
Note: Arguments of the \includegraphics command such as angle and
2441
\includegraphics[angle=-90,scale=0.5]{fig.eps}
2443
are not known to the given figure (e.g., to fig.eps). To be
2444
taken into account, the scripts should handle the transformations
2445
they request (e.g., in \csname Grot@angle\endcsname,
2446
\csname Gscale@x\endcsname, \csname Gscale@y\endcsname)
2454
\<configure info4ht babel\><<<
2456
\Configure{quotedblbase}
2457
\Configure{quotesinglbase}
2463
\<configure info4ht plain\><<<
2467
\Configure{TableOfContents}
2470
\Configure{beginsection}
2471
\Configure{centerline}
2472
\Configure{displaylines}
2473
\Configure{eqalignno}
2477
\Configure{leftline}
2478
\Configure{leqalignno}
2480
\Configure{mathaccent}
2481
\Configure{narrower}
2483
\Configure{obeylines}
2484
\Configure{overline}
2485
\Configure{proclaim}
2486
\Configure{rightline}
2488
\Configure{underline}
2489
\Configure{vfootnote}
2497
\<configure info4ht amsfonts\><<<
2498
\Configure{mathbb}........................2
2499
\Configure{mathfrak}......................2
2510
% \Configure{dbinom}..................4
2511
% \Configure{dfrac}..................4
2512
% \Configure{frac}..................4
2513
% \Configure{binom}..................4
2515
\<configure info4ht amsmath\><<<
2516
\Configure{tmspace}...................1
2518
\mathglue amount of space in math units
2519
\textspace amount of space in points
2522
\Configure{tmspace}{\mskip\mathglue}
2525
\Configure{boxed}.....................2
2526
\Configure{equations}.................2
2527
\Configure{equation}..................3
2528
\Configure{gather*}...................6
2529
\Configure{gather}....................6
2530
\Configure{genfrac}...................6
2531
\Configure{measure@}..................1
2532
\Configure{multline*}.................4
2533
\Configure{multline}..................6
2537
\Configure{overset}...................2
2538
\Configure{smallmatrix}...............6
2539
\Configure{split}.....................6
2540
\Configure{subarray}..................4
2541
\Configure{substack}..................2
2542
\Configure{underset}..................2
2543
\Configure{xleftarrow}................2
2544
\Configure{xrightarrow}...............2
2552
\<configure info4ht amstex1\><<<
2557
Environments of amstex1:
2586
\<configure info4ht amsart\><<<
2589
\ConfigureList{thebibliography}%
2593
\Configure{abstract}
2597
\Configure{endlikeparagraph}
2598
\Configure{endlikepart}
2599
\Configure{endlikesection}
2600
\Configure{endlikesubparagraph}
2601
\Configure{endlikesubsection}
2602
\Configure{endlikesubsubsection}
2603
\Configure{endparagraph}
2605
\Configure{endsection}
2606
\Configure{endsubparagraph}
2607
\Configure{endsubsection}
2608
\Configure{endsubsubsection}
2609
\Configure{keywords}
2610
\Configure{likeparagraph}
2611
\Configure{likepart}
2612
\Configure{likesection}
2613
\Configure{likesubparagraph}
2614
\Configure{likesubsection}
2615
\Configure{likesubsubsection}
2616
\Configure{maketitle}
2617
\Configure{paragraph}
2618
\Configure{partTITLE+}
2620
\Configure{sectionTITLE+}
2623
\Configure{subjclass}
2624
\Configure{submaketitle}
2625
\Configure{subparagraph}
2626
\Configure{subsectionTITLE+}
2627
\Configure{subsection}
2628
\Configure{subsubsectionTITLE+}
2629
\Configure{subsubsection}
2630
\Configure{thanks author date and}
2634
Environments of amsart:
2644
likeparagraph likepart, likesection, likesubparagraph,
2645
likesubsection, likesubsubsection, paragraph, part, section,
2646
subparagraph, subsection, subsubsection,
2653
\<configure info4ht amsbook\><<<
2656
\ConfigureList{thebibliography}%
2659
\Configure{abstract}
2660
\Configure{addresses}
2664
\Configure{endlikeparagraph}
2665
\Configure{endlikepart}
2666
\Configure{endlikesection}
2667
\Configure{endlikesubparagraph}
2668
\Configure{endlikesubsection}
2669
\Configure{endlikesubsubsection}
2670
\Configure{endparagraph}
2672
\Configure{endsection}
2673
\Configure{endsubparagraph}
2674
\Configure{endsubsection}
2675
\Configure{endsubsubsection}
2676
\Configure{keywords}
2677
\Configure{likeparagraph}
2678
\Configure{likepart}
2679
\Configure{likesection}
2680
\Configure{likesubparagraph}
2681
\Configure{likesubsection}
2682
\Configure{likesubsubsection}
2683
\Configure{maketitle}
2684
\Configure{paragraph}
2685
\Configure{partTITLE+}
2687
\Configure{sectionTITLE+}
2689
\Configure{subjclass}
2690
\Configure{subparagraph}
2691
\Configure{subsectionTITLE+}
2692
\Configure{subsection}
2693
\Configure{subsubsectionTITLE+}
2694
\Configure{subsubsection}
2695
\Configure{thanks author date and}
2698
\Configure{translators}
2700
Environments of amsbook:
2708
appendix, chapter, likechapter, likeparagraph, likepart,
2709
likesection, likesubparagraph, likesubsection, likesubsubsection,
2710
paragraph, part, section, subparagraph, subsection, subsubsection
2716
\<configure info4ht amsproc\><<<
2719
\ConfigureList{thebibliography}%
2722
\Configure{abstract}
2726
\Configure{endlikeparagraph}
2727
\Configure{endlikepart}
2728
\Configure{endlikesection}
2729
\Configure{endlikesubparagraph}
2730
\Configure{endlikesubsection}
2731
\Configure{endlikesubsubsection}
2732
\Configure{endparagraph}
2734
\Configure{endsection}
2735
\Configure{endsubparagraph}
2736
\Configure{endsubsection}
2737
\Configure{endsubsubsection}
2738
\Configure{keywords}
2739
\Configure{likeparagraph}
2740
\Configure{likepart}
2741
\Configure{likesection}
2742
\Configure{likesubparagraph}
2743
\Configure{likesubsection}
2744
\Configure{likesubsubsection}
2745
\Configure{maketitle}
2746
\Configure{paragraph}
2747
\Configure{partTITLE+}
2749
\Configure{sectionTITLE+}
2751
\Configure{subparagraph}
2752
\Configure{subsectionTITLE+}
2753
\Configure{subsection}
2754
\Configure{subsubsectionTITLE+}
2755
\Configure{subsubsection}
2756
\Configure{thanks author date and}
2760
Environments of amsproc:
2768
likeparagraph, likepart, likesection, likesubparagraph,
2769
likesubsection, likesubsubsection, paragraph, part, section,
2770
subparagraph, subsection, subsubsection
2776
\<configure info4ht amsthm\><<<
2777
Environments of amsthm:
2787
\<configure info4ht amsppt\><<<
2790
head, specialhead, subhead, subsubhead
2794
\Configure{abstract}
2801
\Configure{footnote}
2803
\Configure{itemitem}
2804
\Configure{keyformat}
2805
\Configure{keywords}
2809
\Configure{specialhead}
2811
\Configure{subjclass}
2812
\Configure{subsubhead}
2827
\<configure info4ht psfig\><<<
2834
\<configure info4ht epsfig\><<<
2835
\Configure{epsfig}...........................#1
2840
In LaTeX, epsfig reduces to graphicsx
2845
{\Configure{graphics}
2846
{} {\xdef\foo{width="\the\Gin@req@width"
2847
height="\the\Gin@req@height"}}%
2848
\Picture+[epsfig]{}}
2849
{\EndPicture\immediate\write16{..... \foo}}
2854
\<configure info4ht xy\><<<
2861
\<configure info4ht amscd\><<<
2863
Environments of amscd:
2871
\<configure info4ht array\><<<
2880
Environments of array:
2888
\<configure info4ht minitoc\><<<
2898
\Configure{tableofcontents}
2905
\<configure info4ht index\><<<
2906
\Configure{NoSection}
2916
\<configure info4ht ntheorem\><<<
2917
Environments of ntheorem:
2954
\<configure info4ht longtable\><<<
2955
\Configure{longtable}.............................6
2957
#1 before table #2 after table
2958
#3 before row #4 after row
2959
#5 before cell #6 after cell
2964
\<configure info4ht fancyvrb\><<<
2965
\Configure{fancyvrbcolor}
2966
\Configure{fancyvrbframe}
2967
\Configure{fancyvrb}
2969
Environments of fancyvrb:
2979
\<configure info4ht moreverb\><<<
2980
\Configure{verbatimtab}......................2
2985
Environments of moreverb:
2997
\<configure info4ht fancybox\><<<
2999
\Configure{doublebox}
3001
\Configure{shadowbox}
3007
\<configure info4ht color\><<<
3008
\Configure{HColor}......................2
3013
Examples: \Configure{HColor}{blue}{\#0000FF}
3014
\Configure{HColor}{light}{rgb(122,251,255)}
3016
\Configure{colorbox}
3018
\Configure{textcolor}
3024
\<configure info4ht colortbl\><<<
3026
\Configure{rowcolor}
3032
\<configure info4ht alltt\><<<
3033
Environments of alltt:
3043
\<configure info4ht url\><<<
3050
\<configure info4ht hyperref\><<<
3051
A trick like the following one allows a compilation to choose
3052
between a pdf and a html mode automatically.
3054
\ifx \HCode\UnDef \usepackage[pdf]{hyperref}
3055
\else \usepackage[tex4ht]{hyperref} \fi
3057
The trick assumes the compilations for html are invoked by
3058
htlatex-like commands.
3061
\Configure{::action}
3062
\Configure{::default}
3063
\Configure{::menulength}
3064
\Configure{::method}
3067
\Configure{CheckBox::checked}
3068
\Configure{CheckBox::}
3069
\Configure{ChoiceMenu::combo}
3070
\Configure{ChoiceMenu::popdown}
3071
\Configure{ChoiceMenu::radio}
3072
\Configure{ChoiceMenu::}
3074
\Configure{PushButton::}
3076
\Configure{Submit::}
3077
\Configure{TextField::default}
3078
\Configure{TextField::multiline}
3079
\Configure{TextField::password}
3080
\Configure{TextField::width}
3081
\Configure{TextField::}
3082
\Configure{combo::default}
3083
\Configure{multiline::value}
3084
\Configure{multiline::width}
3085
\Configure{radio::default}
3092
\<configure info4ht CJK\><<<
3099
\<configure info4ht vanilla\><<<
3110
\Configure{subheading}
3120
\section{emulateapj}
3122
\<configure info4ht emulateapj\><<<
3125
\Configure{keywords}
3127
\Configure{slugcomment}
3128
\Configure{subjectheadings}
3129
\Configure{submitted}
3130
\Configure{subsection}
3131
\Configure{subtitle}
3134
Environments of emulateapj:
3141
\<configure info4ht aa\><<<
3144
\Configure{endlikeparagraph}
3145
\Configure{endlikepart}
3146
\Configure{endlikesection}
3147
\Configure{endlikesubparagraph}
3148
\Configure{endlikesubsection}
3149
\Configure{endlikesubsubsection}
3150
\Configure{endparagraph}
3152
\Configure{endsection}
3153
\Configure{endsubparagraph}
3154
\Configure{endsubsection}
3155
\Configure{endsubsubsection}
3156
\Configure{likeparagraph}
3157
\Configure{likepart}
3158
\Configure{likesection}
3159
\Configure{likesubparagraph}
3160
\Configure{likesubsection}
3161
\Configure{likesubsubsection}
3162
\Configure{makeheadbox}
3163
\Configure{maketitle}
3164
\Configure{paragraph}
3165
\Configure{partTITLE+}
3167
\Configure{sectionTITLE+}
3169
\Configure{subparagraph}
3170
\Configure{subsectionTITLE+}
3171
\Configure{subsection}
3172
\Configure{subsubsectionTITLE+}
3173
\Configure{subsubsection}
3174
\Configure{subsubsection}
3175
\Configure{subtitle institute}
3176
\Configure{thanks author date and}
3187
\<configure info4ht pictex\><<<
3197
\<configure info4ht pb-diagram\><<<
3198
Environments of pb-diagram:
3207
\<configure info4ht ltugboat\><<<
3208
Environments of ltugboat:
3216
\<configure info4ht doc\><<<
3217
Environments of doc:
3228
\<configure info4ht doc\><<<
3229
\Configure{lineno}...................2
3231
Asks lineno.sty to introduce #1\LineNumber #2, instead of \LineNumber,
3242
\<configure info4ht elsart\><<<
3243
\Configure{abstract}
3246
Environments of elsart:
3256
\<configure info4ht ProTex\><<<
3257
\Configure{ShowCode}...................6
3270
\<configure info4ht seminar\><<<
3272
Environments of seminar:
3280
\<configure info4ht slides\><<<
3281
\Configure{slidename}....................................1
3282
\CutAt{slide}.............................................0
3284
\ConfigureList{description}%
3286
Environments of slides:
3299
\<configure info4ht slidesec\><<<
3307
\<configure info4ht web\><<<
3308
\Configure{maketitle}
3309
\Configure{webuniversity}
3310
\Configure{webversion}
3316
\<configure info4ht exerquiz\><<<
3317
\ConfigureList{questions}%
3320
\Configure{ReturnTo}
3321
\Configure{TextField::}
3322
\Configure{javascript}
3325
\Configure{shortquiz}
3327
Environments of exerquiz:
3334
\<configure info4ht foils\><<<
3339
\Configure{foilheads}
3343
Environments of foils:
3360
\<configure info4ht th4\><<<
3361
\Configure{JavaScript}............2
3363
Configures the environments
3373
These environments are activated by the `javascript' option.
3377
\Configure{JavaScript}
3378
{\HCode{<script type="text/JavaScript" ><!--\Hnewline}}
3379
{\HCode{//-->\Hnewline </script>}}
3385
Chapter, LikeSection, Section, SubSection
3387
\Configure{Appendix}
3394
\Configure{LikeChapter}
3395
\Configure{LikeSection}
3399
\Configure{SubSection}
3401
\Configure{Verbatim}
3402
\Configure{buttonList+}
3403
\Configure{buttonList}
3404
\Configure{centerline}
3410
When the package option `frames-' or `frames' is up,
3411
TeX4ht introduces the following commands for defining frames.
3415
A variant of the \Link[#1]{#2} portion of the
3416
\Link[#1]{#2}{#3}#4\EndLink, for specifying a frame.
3418
\HorFrames[#1]{#2}, \VerFrames[#1]{#2}
3420
#1 attributes ([#1] is optional)
3421
#2 list of dimensions
3423
A container partitioned, respectively, horizontally or
3424
vertically. Each partition may hold a sub-container or
3427
The list of dimensions determine the cardinality of the
3428
partition, and the dimension of each partition. A dimension
3429
can be specified absolutely by pixels (\HorFrames{80,130,50}),
3430
relatively by percentage (\HorFrames{20\%,30\%,50\%}), and
3431
relatively through ratio (\HorFrames{2*,3*,5*}).
3435
An end delimiter for a container
3439
When used, it should be placed before the outer-most
3440
\EndFrames command. The region \NoFrames...\EndNoFrames
3441
provides the content for browsers which do not support frames.
3443
Tailoring configurations for frames is a little tricky, but the
3444
job is simpler when the configurations don't deal with the root
3450
% Requires the command line option `frames-'
3451
\documentclass{article}
3457
\Configure{BODY}{}{}
3459
{\HCode{<!DOCTYPE html
3460
PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
3461
"http://www.w3.org/TR/html4/frameset.dtd">}}
3462
\Configure{HEAD}{}{}
3464
{\HCode{<html><head><title></title></head>}}
3466
\Configure{HtmlPar}{}{}{}{}
3467
\Configure{TITLE}{}{}
3469
\FileStream+{\jobname f.html}
3471
\Frame[\jobname.html]{}
3473
\Frame[http://www.tug.org]{}
3474
\Frame[\RefFile{z} ]{}
3475
\Frame[ name="y"]{w}
3481
\EndFileStream{\jobname f.html}
3487
\Configure{Link}{a}{target="y" href=}{ name=}{}
3488
\let\contentsname=\empty \tableofcontents
3494
\section{First} Is first.
3497
\section{Second} Is Second.
3501
Example 1a (allows also compilations for non-html output):
3502
..........................................................
3504
\documentclass{article}
3509
\section{First} Is first.
3511
\ifx \Link\undefined \else
3514
\section{Second} Is Second.
3519
\Preamble{html,frames-}
3524
\Configure{BODY}{}{}
3525
\Configure{DOCTYPE}{}
3526
\Configure{HEAD}{}{}
3527
\Configure{HTML}{}{}
3528
\Configure{HtmlPar}{}{}{}{}
3529
\Configure{TITLE}{}{}
3531
\FileStream+{\jobname f.html}
3533
\Frame[\jobname.html]{}
3535
\Frame[http://www.tug.org]{}
3536
\Frame[\RefFile{z} ]{}
3537
\Frame[ name="y"]{w}
3543
\EndFileStream{\jobname f.html}
3548
\Configure{Link}{a}{target="y" href=}{ name=}{}
3549
\let\contentsname=\empty \tableofcontents
3559
\documentclass{article}
3560
\usepackage{verbatim}
3563
\section{The Main File: \jobname.tex}
3564
\verbatiminput{\jobname.tex}
3565
\section{The Configurations File: \jobname.cfg}
3566
\verbatiminput{\jobname.cfg}
3567
\section{The Command Line}
3568
htlatex \jobname\space "\jobname"
3570
\NextFile{page.html}\HPage{}
3574
\HPage{}\Link{}{anchor}\EndLink
3575
\Link[http://www.ctan.org]{}{}ctan\EndLink
3580
% configurations .cfg file
3586
\Frame[ name="tex4ht-menu" ]{tex4ht-toc}
3589
\Frame[http://www.tug.org]{}
3593
\Frame[ name="tex4ht-main" ]{tex4ht-body}
3596
{\let\contentsname=\empty \tableofcontents}
3607
\<configure info4ht hebtex\><<<
3608
\Configure{arabtext}
3612
\Configure{chpatach}
3619
\Configure{qameschat}
3634
%%%%%%%%%%%%%%%%%%%%
3636
%%%%%%%%%%%%%%%%%%%%
3638
\<configure info4ht endnotes\><<<
3639
\Configure{theendnotes}......................2
3640
\Configure{enoteformat}......................2
3641
\Configure{makeenmark}.......................2
3643
Provide markups for the mentioned entities.
3647
A built-in counter for end notes.
3651
%%%%%%%%%%%%%%%%%%%%
3653
%%%%%%%%%%%%%%%%%%%%
3655
\<configure info4ht float\><<<
3656
New float environments can be configured with the \ConfigureEnv
3657
instruction. For instance,
3659
\newfloat{myfloat}{htb}{}[section]
3661
\ConfigureEnv{myfloat}
3662
{BEFORE MYFLOAT} {AFTER MYFLOAT}
3672
%%%%%%%%%%%%%%%%%%%%
3674
%%%%%%%%%%%%%%%%%%%%
3679
\<configure info4ht mktex4ht\><<<
3683
A package to help creating 4ht files for configuring seeded hooks.
3685
A sample self-explanatory template file make-4ht.tex is shown at the
3686
end. The sample file can be retrieved in ascii form from the file
3692
To get a better understanding of the structural meaning of some of the
3695
a. Compile the mktex4ht.4ht file with the `htlatex mktex4ht.4ht'
3696
command (or, `xhlatex mktex4ht.4ht' for XHTML output).
3698
Visit the links in the index of the outcome `mktex4ht.html' file.
3700
b. Compile your sorce file with a command similar to
3702
htlatex filename "html,info" "" "-p"
3704
and check the source file.
3706
c. Compile your sorce file with a command similar to
3708
htlatex filename "html,0.0,hooks" "" "-p"
3710
and view the outcome with a html browser.
3712
d. Take a look at the *.4ht configuration files mentioned in tex4ht.4ht.
3714
Setting up a calling command
3715
----------------------------
3717
i. Create a tex4ht.usr file, and introduce there \Configure command(s)
3718
similar to those found in tex4ht.4ht. For instance,
3721
\Hinclude[*]{myhtml.4ht}%
3722
\Hinclude[*]{mymath.4ht}%
3725
Choose arbitrary name in the first argument, and include *.4ht
3726
configuration files of your liking in the second argument.
3728
You might want to temporarily include also the file html0.4ht, as a
3729
first entry, while constructing new *.4ht configuration files. For
3733
\Hinclude[*]{html0.4ht}%
3734
\Hinclude[*]{myhtml.4ht}%
3735
\Hinclude[*]{mymath.4ht}%
3738
ii. A configuration setting may be loaded by mentioning its name
3739
within the option list of the htlatex command. For instance,
3741
htlatex filename "xhtml,foo" "unicode/!" "-p"
3743
iii. Alternatively, a htlatex-like command can be tailored to
3744
automatically load a configuration setting. That can be done
3745
by including the name in the argument list of
3746
\csname tex4ht\endcsname, within the script of the command. For
3747
instance, replace `docbook' with `foo' in the script of dblatex.
3750
Defining a New Configuration File with mktex4ht.4ht
3751
---------------------------------------------------
3753
1. Define a parameter-less macro \HTML to hold a comma separeted list
3754
of the output file names. Place the definition at the top of the
3755
source document. For instance
3757
\def\HTML{myhtml,mymath}
3759
request the files myhtml.4ht and mymath.4ht.
3761
2. Define a parameter-less macro \CONFIG to hold the name of the file
3762
containing the contributed configurations. Place the definition at
3763
the top of the source document.
3765
3. The configurations contributed to output file YYYY.4ht for style
3766
XXXX should be provided within code fragments of the form
3768
\<configure XXXX YYYY\><<<
3772
Arbitrary valid LaTeX source code may be inserted around the code
3777
Configurations for class book.cls:
3779
\<configure myhtml book\><<<
3780
\Configure{chapter} {...}{...}{...}{...}
3781
\Configure{section} {...}{...}{...}{...}
3784
Configurations for class article.cls:
3786
\<configure mymath article\><<<
3787
\Configure{section} {...}{...}{...}{...}
3790
The hooks are provided in book.4ht and article.4ht.
3792
4. Define a parameter-less macro \MAKETITLE with contribution for
3793
the \maketitle command (e.g., \def\MAKETITLE{\title{my name}}). Place
3794
the definition at the top of the source document.
3796
5. A file may reload itself, if it starts with preamble similar to
3801
\def\CONFIG{\jobname}
3802
\def\MAKETITLE{\author{...}}
3803
\def\next{\input mktex4ht.4ht \endinput}
3808
A Template File make-4ht.tex
3809
-----------------------------
3811
%--------------------- start of template -----------------
3812
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3814
% make-4ht.4ht Eitan M. Gurari
3816
% A sample file with instructions for creating 4ht
3817
% configuration files through literate programming.
3819
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3821
% * Compile this file twice with the command `latex make-4ht'
3822
% (or with `htlatex make-4ht')
3824
% * Inspect the outcome files sample.4ht and example.4ht
3826
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3828
% * Change `sample,example' in (1) below to a comma-separated list
3829
% of your choice. Each entry in the list stands for a name
3830
% of a 4ht configuration file to be created. The current list
3831
% requests the configuration files `sample.4ht' and `example.4ht'.
3833
% * Change `my title' in (2), and `my name' in (3), to a
3834
% content of your choice
3838
%%%%%%%%%%%%%%%%%% load style files %%%%%%%%%%%%%%%%%%%%%%%%%%
3841
\def\HTML{sample,example} %<------------ (1)
3842
\def\CONFIG{\jobname}
3843
\def\MAKETITLE{\title{my title}% %<------------ (2)
3844
\author{my name}} %<------------ (3)
3845
\def\next{\input mktex4ht.4ht \endinput}
3849
%%%%%%%%%%%%%%%%%%%%% useful definitions %%%%%%%%%%%%%%%%%%%%%
3851
\newcount\tmpcnt \tmpcnt\time \divide\tmpcnt 60
3852
\edef\temp{\the\tmpcnt}
3853
\multiply\tmpcnt -60 \advance\tmpcnt \time
3855
\edef\version{\the\year-\ifnum \month<10 0\fi
3856
\the\month-\ifnum \day<10 0\fi\the\day
3857
-\ifnum \temp<10 0\fi \temp
3858
:\ifnum \tmpcnt<10 0\fi\the\tmpcnt}
3861
\ifnum #1=\year #1\space\space\space\space\space\space
3862
\else #1--\the\year\fi
3866
%<--------------------------------------------------------------- (4)
3868
% * The code for the configuration files is to be written within
3869
% fragments of the form
3871
% \<fragment name\><<<
3875
% * References from code fragments to other code fragments should
3878
% ||<fragment name||>
3880
% * The character || is treated as an escape character
3881
% within the code fragments. References to the
3882
% character should take the form
3886
% * Insertions outside the code fragments are ignored in the
3887
% configuration files, and they should abide to the latex
3890
% * Change all the prose and code fragments below to meet
3891
% your needs. Make sure to follow the given instructions.
3893
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3895
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3897
%<--------------------------------------------------------------- (5)
3899
% * For each entry in the list of (1), you may have arbitrary many
3900
% code fragments named by the entry.
3902
% * The order of fragments is relevant only among those having
3908
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3909
% sample.4ht ||version %
3910
||<copyright statement||>
3915
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3916
% example.4ht ||version %
3917
||<copyright statement||>
3921
\<copyright statement\><<<
3922
% Copyright (C) ||CopyYear.2000. my name %
3924
% My copyright statement %
3926
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3927
\immediate\write-1{version ||version}
3931
%<--------------------------------------------------------------- (6)
3933
% * Each configuration of tex4ht requires a base 4ht configuration
3934
% file containing the following `Hinclude' code.
3936
% * The supplied html4.4ht, html32.4ht, html0.4ht, tei.4t,
3937
% and docbook.4ht files already include such code.
3939
% * In a compilation of a file, exactly one 4ht configuration
3940
% file should load `Hinclude' code.
3942
% * Either remove the following three code fragments, or replace
3943
% `sample' in their titles with an entry from (1)
3946
\<configure sample tex4ht\><<<
3947
\if:latex ||<Hinclude latex||>
3948
\else ||<Hinclude plain||> \fi
3951
\<configure sample plain\><<<
3952
||<Hinclude plain lib||>
3953
||<Hinclude plain + latex lib||>
3956
\<configure sample latex\><<<
3957
||<Hinclude latex lib||>
3958
||<Hinclude plain + latex lib||>
3962
%--------------------- end of template -------------------
3967
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3968
\chapter{Segment Code}
3969
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3971
%<--------------------------------------------------------------- (7)
3973
% * A 4ht configuration file is made up of segments which
3974
% correspond to classes and styles of tex, latex, amslatex,
3975
% etc. Have a look at these code segments in html4.4ht .
3977
% * You can get additional information about the possible
3978
% configurations in the different segments by compiling
3979
% your file with the `info' switch on. For instance
3981
% htlatex foo "html,info"
3983
% * Code for segment `xxxx' in file `yyyy.4ht' is introduced
3984
% through fragments named `configure yyyy xxxx'. That is,
3985
% through fragments of the form
3987
% \<configure yyyy xxxx\><<<
3993
\<configure sample tex4ht\><<<
3994
....tex4ht segment in sample.4ht.....
3997
\<configure sample latex\><<<
3998
....latex segment in sample.4ht.....
4005
\<configure example tex4ht\><<<
4006
....tex4ht segment in example.4ht.....
4009
\<configure example latex\><<<
4010
....latex segment in example.4ht.....
4015
....additional code....
4018
%<--------------------------------------------------------------- (8)
4020
% * Compile this file twice with the command `latex filename'
4021
% (or with `ht latex filename')
4023
% * If you don't have a file named tex4ht.usr, introduce such a file
4025
% * Insert into tex4ht.usr a file along the following lines, which
4026
% invokes *.4ht configuration files
4028
% \Configure{my4hts}{%
4029
% \Hinclude[*]{html4.4ht}%
4030
% \Hinclude[*]{html4-math.4ht}%
4031
% \Hinclude[*]{myflavor.4ht}%
4034
% For additional examples inspect, but do not change, the
4037
% * Invoke the compilations of you latex files with commands similar to
4039
% htlatex foo "html,my4hts"
added
removed
src/tex4ht-info.tex
