2.1 tex4ht

<..configure info4ht Preamble..>
 \Configure{PROLOG}.........1
 
    #1 Comma separated list of hooks to appear before HTML.
 
       Each hook E is declared to be configurable by an
       instruction of the form \NewConfigure{E}{1}
 
       A star ’*’ prefix calls for accumulative configurations
 
    Example:
 
       \Configure{PROLOG}{VERSION,DOCTYPE,*XML-STYLESHEET}
       \Configure{VERSION}
          {\HCode{<?xml version="1.0"?>}}
 
 \Configure{ext}............1
 
    #1: default extension name for target files  (recorded in \:html)
 
    Can also be requested through a command line option ext=...
 
 \Preamble...................0
 
    Records the list of the requested options.  Defined upon entering
    the environment \Preamble{...}....\EndPreamble, to replace the
    earlier version of \Preamble.
 
 \ifOption ................. 3
 
    #1  Argument to be checked  wheteher it is a given option.
    #2  True part
    #3  False part
-_-_-

<..configure info4ht tex4ht..>
 Wrapper for the Document
 ------------------------
 
 \Configure{DOCTYPE}.........1
 \Configure{HTML}............2
 \Configure{HEAD}............2
 \Configure{@HEAD}...........1
 \Configure{BODY}............2
 \Configure{TITLE+}..........1
 \Configure{TITLE}...........2
 \Configure{@TITLE}..........1
 \Configure{Preamble}........2
 
     <DOCTYPE>
     <HTML 1>
       <HEAD 1>
          <TITLE 1>
             <@TITLE>
             <TITLE+>
          <TITLE 2>
          <@HEAD>
       <HEAD 2>
       <BODY 1>
       ......
       <BODY 2>
     <HTML 2>
 
 The \Configure{@HEAD}{...} command is additive, concatenating the
 content of all of its appearances.  An empty parameter requests
 the cancellation of the earlier contributions.
 
 For instance,
 
   \Configure{@HEAD}{A}
   \Configure{@HEAD}{}
   \Configure{@HEAD}{B}
   \Configure{@HEAD}{C}
 
 contributes ‘BC’.
 
 The \Configure{TITLE+} provides the content for the title,
 \Configure{TITLE} sets the envelop, and \Configure{@TITLE} acts as a
 hook for introducing localized configurations. As is the case for
 \Configure{@HEAD}, the contribution of \Configure{@TITLE} is also
 additive.
 
 These configurations should be introduced early enough in the
 compilation. For instance, in the case of LaTeX, between \Preamble
 and \begin{document} of a local configuration file.
 
            \Preamble
              %%% here %%%
            \begin{document}
              ...
            \EndPreamble
 
 
 \Configure{@BODY}...........1
 \Configure{@/BODY}..........1
 
    Variants of \Configure{@HEAD} which contribute their content,
    respectively, after <body> and before </body>.
 
 \Configure{CutAtTITLE+}.....1
 \Configure{HPageTITLE+}.....1
 
    #1 an insertion just before the content of <TITLE>;
 
    If #1 is a one parametric macro, it gets the title content for
    an argument.
 
 
 Support for Sectioning Commands
 -------------------------------
 
 \Configure{unit-name} ......................4
 
    #1 start
    #2 end
    #3 before title
    #4 after title
 
    Example:
 
         \Configure{section}
            {\HCode{<section>}}    {\HCode{</section>}}
            {\HCode{<title>}}      {\HCode{</title>}}
 
 
 \ConfigureMark{unit-name}...................1
 
    Defines a macro \<<unit-name>>HMark to hold the given argument.
    Upon entering the unit, \TitleMark gets the content of this macro.
 
    Some built-in configurations of TeX4ht require an argument for the
    \<<unit-name>>HMark commands. For safety, these commands should
    always be followed by a, possiblely empty, argument.  The argument
    should be a separator between the title mark and its content.
 
    Example:
 
         \Configure{section}
            {}{}
            {\HCode{<h3>}\TitleMark\space}    {\HCode{</h3>}}
         \ConfigureMark{section}{\thesection}
 
 
 \Configure{toTocLink}.......................2
 
    Each unit title contains a \Link{...}{...}...\EndLink command.
    The first argument of \Link points to the first table of contents
    referencing the title. The second argument provides an anchor
    for references to the title (mainly from tables of contents).
 
    The package option ‘section+’ requests the inclusion of the
    title within the anchor.  Without this option, the link command
    resides between the title mark and its content.
 
    The \Configure{toTocLink} command is provided for configuring
    the \Link and \EndLink  instructions.  In the default setting,
    when the ‘sections+’ option is not activated, the \Link
    command is altered to replace its first argument with an empty
    argument.
 
      Example:
 
           \Configure{toTocLink}
              {\Link}
              {\ifx \TitleMark\sectionHMark
                 \Picture[\up]{haut.jpg align="right"}%
                 \EndLink
                 \TitleMark\space
               \else \EndLink \fi
              }
           \def\up{[up]}
 
 \Configure{toToc}...........................2
 
     #1  unit type
     #2  desired contents type  (if empty, ‘unit type’ is assumed)
 
   Example: \Configure{toToc}{chapter}{likechapter}
            Introduces chapter as likechapter into toc
 
     #1  empty: stop adding entries of ‘unit type’ to toc
             @: add entries of ‘unit type’ to toc
             ?: resume mode in effect before the last stop
     #2  unit type
 
   Example: \Configure{toToc}{}{chapter}
            \chapter{...}
            \Configure{toToc}{@}{chapter}
 
 \Configure{writetoc}.........................1
 
     #1  Configuration material for the insertion instruction.
         New configurations are added to those request earlier
         by the command.  An empty argument cancels the earlier
         contributions.
 
 \NoLink.......................1
 
    Ignore option ‘section+’ for sections of type #1
 
 \TitleCount
 
    Count of entries submitted to the toc file
 
 \Configure{NoSection}.........2
 
    Insertions around the parameters of sectioning commands, applied when
    the parameters are not used to create titles for the divisions.
 
 
 \CutAt{#1,#2,#3,...}
 
     #1           section type to be placed in a separate web page
     #2,#3,...    end delimiting section types, other than #1, for
                  the web pages
     A ‘+’ before #1 requests hypertext buttons for the web pages
 
     Examples:
 
           \CutAt{mychapter,myappendix,mypart}
           \CutAt{+myappendix,mychapter,mypart}
 
     Cut points at arbitrary points can be introduced by introducing section-like
     commands in a manner similar to
 
          \NewSection\mysection{}
          \CutAt{mysection}
 
 
 \Configure{+CutAt}.................................3
 
      #1 sectioning type
      #2 before
      #3 after
 
      Requests delimiters for the \CutAt buttons of the specified
      sectioning type
 
     Example:   \Configure{+CutAt}{mysection}{[}{]}
 
 \PauseCutAt{#1}
 \ContCutAt{#1}
 
     #1  section type
 
 \Configure{CutAt-filename} ........................1
 
    A 2-parameter hook for tailoring section-based filenames.
    The section type is available through #1. The section title
    is accessible through #2.
 
    Example:   \Configure{CutAt-filename}{\NextFile{#1-#2.html}}
 
 
 Tables of Contents
 ------------------
 
 Created from the entries collected in the previous compilation within
 a jobname.4tc file.
 
 \ConfigureToc{unit-name} ......................4
 
    #1 before unit number
    #2 before content
    #3 before page number
    #4 at end
 
    * Empty arguments request the omission of the corresponding field.
 
    * \TocCount  Specifies the entry count withing the jobname.4tc file.
 
    * \TitleCount Count of entries submitted to the toc file
 
    * An alternative to \ConfigureToc{unit-name}:
 
       \def\toc<unit-name>#1#2#3{<before unit number>#1<before content>#2%
                              <before page number>#3<at end>}
 
 
    Example:
 
         \ConfigureToc{section}
            {}
            {\Picture[*]{pic.jpg width="13"  height="13"}~}
            {}
            {\HCode{<br />}}
 
 
 \Configure{TocLink}..................4
 
    Configures the link offered in the third arguments of \ConfigureToc
 
    Example:   \Configure{TocLink}{\Link{#2}{#3}#4\EndLink}
 
 \TocAt{#1,#2,#3,...}
 
     #1           section type for which local tables of contents
                  \Toc#1 are requested
     #2,#3,...    sectioning types to be included in the tables of
                  contents
 
     The non-leading arguments may be preceded by slashes ’/’, in
     which cases the arguments specify end points for the tables.
 
     The default setting requests automatic insertion of the local
     tables immediately after the sectioning heads.
 
     A star ‘*’ character may be introduced, between the  \TocAt and
     the left brace, to request the appearances of the tables of
     contents at the end of the units’ prefaces.
 
     A hyphen ‘-’ character, on the other hand, disables the automatic
     insertions of the local tables.
 
     In case of a single argument, the command removes the
     existing definition of \Toc#1.
 
     Example:
       \TocAt{mychapter,mysection,mysubsection,/myappendix,/mypart}
       \TocAt-{mysection,mysubsection,/mylikesection}
       \section{...}...\Tocmysection
 
     The definition  of the local table of contents can be redefined
     within \csname Toc#1\endcsname.
 
     Example:
 
        \TocAt{section}
        \def\Tocsection{\TableOfContents[section]}
 
        \Css{div.sectionTOCS {
                            width : 30\%;
                            float : right;
                       text-align : left;
                   vertical-align : top;
                      margin-left : 1em;
                        font-size : 85\%;
                 background-color : \#DDDDDD;
            }}
 
     Example: Table of content before the section title.
 
        \Configure{section}{}{}
           {\Tocsection \let\saveTocsection=\Tocsection
            \def\Tocsection{\let\Tocsection=\saveTocsection}%
            \ifvmode \IgnorePar\fi \EndP\IgnorePar
            \HCode{<h3 class="sectionHead">}\TitleMark\space\HtmlParOff}
           {\HCode{</h3>}\HtmlParOn\ShowPar \IgnoreIndent \par}
 
 
 \Configure{TocAt}......................2
 \Configure{TocAt*}.....................2
 
    #1 before the tables of contents
    #2 after the tables of contents
 
 
 Navigation Links for Sectioning Divisions
 -----------------------------------------
 
 \Configure{crosslinks}.....................8
 
    #1  left delimiter
    #2  right delimiter
    #3  next
    #4  previous
    #5  previous-tail
    #6  front
    #7  tail
    #8  up
 
   The content to be displayed in the pointers
 
 \Configure{crosslinks*}.................1--7
 
   Links to be included and their order. Available
   options: next, prev, prevtail, tail, front, up.
   The last argument must be empty.
 
   Default:
 
       \Configure{crosslinks*}
          {next}
          {prev}
          {prevtail}
          {tail} {front}
          {up}
          {}
 
 \Configure{crosslinks+}.....................4
 
    #1  before top menu
    #2  after top menu
    #3  before bottom menu
    #4  after bottom menu
 
   The top cross links are omitted, if both #1 and #2 are empty.
   The bottom cross links are omitted, if both #3 and #4 are empty.
 
 \Configure{next}.....................1
     #1  the anchor of the next button of the front page.
 
     Default: The value provided in \Configure{crosslinks}
 
 \Configure{next+}.............................2
 
    #1  before the next button of the front page, when the ‘next’
        option is active.
    #2  after the button
 
     Default: The values provided in \Configure{crosslinks}
 
 \Configure{crosslinks:next}..................1
 \Configure{crosslinks:prev}..................1
 \Configure{crosslinks:prevtail}..............1
 \Configure{crosslinks:tail}..................1
 \Configure{crosslinks:front}.................1
 \Configure{crosslinks:up}....................1
 
    #1 local configurations for the delimiters and hooks
 
 \Configure{crosslinks-}.....................2
 
    Asks to show linkless buttons with the following insertions.
 
       #1  before
       #2  after
 
    The default values are used, if both #1 and #2 are empty
 
    Examples:
 
        \Configure{crosslinks-}{}{}
 
        \Configure{crosslinks-}
            {\HCode{<span class="hidden">}[}
            {]\HCode{</span>} }
        \Css{span.hidden {visibility:hidden;}}
 
 Paragraphs
 ----------
 
 \Configure{HtmlPar}..........4
 
    #1 content at the start non-indented paragraphs
    #2 content at the start indented paragraphs
    #3 insertion into \EndP, at the start of non-indented paragraphs
    #4 insertion into \EndP, at the start of indented paragraphs
 
    \HtmlParOff
    \HtmlParOn
 
    \IgnorePar     Asks to ignore the next paragraph
    \ShowPar       Asks to take into account the following paragraphs
 
    \IgnoreIndent  asks to ignore indentation in the next paragraph
    \ShowIndent    asks to check indentation in the following paragraphs
 
    \SaveEndP      Saves the content of \EndP, and sets it to empty content
    \RecallEndP
 
    \SaveHtmlPar
    \RecallHtmlPar
 
 
   Example:
      \Configure{@BODY}
         {\ifvmode \IgnorePar\fi \EndP
          \HCode{<div>}\par\ShowPar}
      \Configure{@/BODY}
         {\ifvmode \IgnorePar\fi \EndP
          \HCode{</div>}}
 
 
 Cross-Linking
 -------------
 
 \Link[@1 @2]{@3}{@4}...\EndLink
 
   Creates
 
      <a href="@1#@3" name="@4" @2>...</a>
 
   * When @1 is empty, tex4ht will derive its value automatically.
     The derived value will be the file name containing the target @3.
 
   * \Link may be followed by ‘-’, if tex4ht needs not automatically
     determine (for other \link commands) the file containing @4.
     In the present of such a flag, tex4ht can spare a definition of
     one macro.
 
   * The component [@1 @2] is optional. If omitted, @1 and @2 are
     assumed to be empty
 
   * The href attribute is omitted when @1 and @3 are empty
 
   * The name attribute is omitted when @4 is empty
 
   Examples:
 
       \Link{a}{}...\Endlink .....  \Link{}{b}...\EndLink
       \Link[http://foo  id="fooo"]{a}{b}...\EndLink
 
 \Configure{Link}..............4
 
    Configures \Link...\EndLink so that
 
      #1 replaces ‘a’
      #2 replaces ‘href=’
      #3 replaces ‘name=’
      #4 replaces ‘#’.  If empty, the older value remains in effect.
 
   Examples:
 
    \Configure{Link}{a}{href=}{name=}{}
    \Configure{Link}{ref}{target=}{id=}{\empty}
 
 \Configure{?Link}..............1
 
    #1 insertion before broken links
 
    To help with debugging
 
 \LinkCommand...................1 <= i <= 6
 
    Creates a \Link-like command
 
    #1   tag name
    #2   href-like attribute
    #3   name-like attribute
    #4   insertion
    #5   /, if empty element
    #6  replacement for #  (ignored if absent)
 
   Example:
 
     \LinkCommand\JSLink{a,\noexpand\jsref,name}
     \def\jsref="#1"{href="javascript:window.open(’#1’)"}
 
     \JSLink{a}{}xx\EndJSLink
     \Link{}{a}\EndLink       % or \JSLink{}{a}\EndJSLink
 
 \Configure{XrefFile}.....................1
 
    #1 names cross-references of files (appends #1 to ‘)F’ and ‘)Q’
       entries of the .xref files). Applicable mainly implicitly
       within \Link commands
 
 \Tag.....................................2
 
    #1  label
    #2  content
 
 \Ref.....................................1
 \LikeRef.................................1
 
    #1  label
 
    \Tag and \Ref are tex4ht.sty commands introduced cross-referencing
    content through .xref auxiliary files.
 
    \LikeRef is a variant of \Ref which doesn’t verify whether the
    labels exit.  It is mainly used in \Link and \edef environments.
 
 \ifTag ..................................3
 
    #1  quetioned tag
    #2  true part
    #3  false part
 
 \LoadRef-[prefix]+{filename.ext}{pattern}
 
    Load the named xref-type file
 
    .xref      optional--‘.xref’ is assume for a default
    +          optional-- asks \Ref and \LikeRef commands
               to use expanded tags ‘filename::tag’, instead of just ‘tag’
    [prefix]   optional--asks just for tags starting with the
               specified prefix.
    -          optional--deletes the prefixes from the loaded tags
    {pattern}  to be included only when ‘[prefix]’ or ‘+’ are included.
               States how tags are to be addressed, with the parameter
               symbol ‘#1’  specifying the loaded part.
 
    Example:
 
         % a.tex
         \LoadRef-[to:]{b}{from:#1}      \Ref{from:filename}
                                         \LikeRef{from:filename}
 
         % b.tex
         \Tag{to:filename}{\FileName}
 
    Example:
 
         \LoadRef-[)F]{file}{)Ffoo##1}
         \LoadRef-[)Q]{file}{)Qfoo##1}
         \Configure{XrefFile}{foo}   \Link...\EndLink
 
         \LoadRef{another-file}
 
 
 Files
 -----
 
 \FileName    Holds the name of the current hypertext file
 \FileNumber  Holds the internal number of the current hypertext file
 \RefFileNumber...........................1
     #1  File number
 
     Provides the file name
 
 \NextFile.................................1
     #1 Requested name for the next file
 
 \Hinput{#1}
 
     The command asks to load the configuration files associated
     with mark #1.
 
 \Hinclude[#1]{#2}
 
     The command associates configuration file #2 with mark #1.  If
     the mark is the star character ‘*’, the configuration files is
     associated to all marks.  The command is applicable until the
     \Preamble command is processed
 
     For instance,  \Hinclude[*]{html4.4ht}....\Hinput{latex}
 
 \Hinclude{#1}{#2}
 
     The command is applicable while the \Preamble command is
     processed. Its purpose is to load *4ht hook files within
     the fragments of code specified in #1.
 
     For instance, \Hinclude{\input plain.4ht}{plain}
 
 
 Fonts
 -----
 
 \Configure{htf}...............................9
 
     #1         label (integer 0--255)
     #2         delimiter (a character not appearing in #3,...,#9)
            even label             odd label
     #3       start opening tag      start empty tag
     #4       name                   alt
     #5       size                   name
     #6       mag                    size
     #7                              mag
     #8       end the tag            ord
     #9       closing tag            end the tag
 
     The htf fonts assign a content and a label to each symbol (possibly
     followed by a comment).  For instance,
 
         ’e’    ’1’    epsilon
         ’z’    ’3’    zeta
 
     An even label asks that the content itself will be used for the
     symbol, and an odd label asks that the symbol will be represented by a
     bitmap.  In the later case,  the content serves as a substitution for
     browsers which don’t exhibit bitmaps.
 
     The \Configure{htf}... command provides label-dependent wrappers to
     chosen representations.
 
     If they are not empty, ‘mag’ and ‘ord’ must be c-type
     patterns for integer arguments, and ‘name’ and ‘size’
     should be a patterns for strings.  The ‘mag’ entry is
     ignored for fonts of the default dimension. Together
     they specify a attribute-value format, mainly for references
     in the css code.
 
   Examples:
 
      \Configure{htf}{0}{+}{<span\Hnewline
         class="}{\%s}{-\%s}{x-x-\%d}{}{">}{</span>}
      \Configure{htf}{1}{+}{<img\Hnewline
         src="}{" alt="}{" class="}{\%s}{-\%d}{x-x-\%x}{" />}
 
 \Configure{htf-attr}....................... 2
 
      #1  c-pattern for the font name and size
      #2  c-pattern for font magnification
 
      Specify the format of the selectors within the css files.
 
    Example:
      \Configure{htf-attr}{.\%s-%s}{--\%s}
 
 \Configure{htf-css}....................... 2
 
     #1  font name or label
     #2  css entry
 
     A variant of the \Css command. If #1 is a font name,
     the contribution replaces the one given within the
     htf font definition. If #1 is a label for an entry
     of a htf font, the contribution is added to the css
     file.  The contribution is offered, only when the
     font is in use.
 
   Example:
 
    \Configure{htf-css}{4}{.small-caps{font-variant: small-caps;}}
 
 
 Bitmaps
 -------
 
 \Configure{Picture}....................... #1
 
   #1  Extension name for bitmap files of dvi pictures,
       stored in \PictExt
 
   Default: \Configure{Picture}{.png}
 
   The extension names of bitmap files of glyphs of htf fonts may be
   determined within a g-entry in the environment file tex4ht.env, or a
   g-flag of the tex4ht.c utility.
 
 \Configure{Picture-alt}......................1
 
   #1  alt value for \Picture+{...}  and \Picture*{...}
 
 \Configure{Picture+}.........................2
 \Configure{Picture*}.........................2
 
   #1  before the dvi picture code
   #2  after the dvi picture code
 
   Typically, the plus ‘+’ variant is introduced as an inline
   contribution into paragraphs, and the star ‘*’ variant as an
   independent block between paragraphs.
 
 \Configure{PictureAlt}........................2
 \Configure{PictureAlt*+}......................2
 \Configure{PictureAlt*+[]}....................2
 
   #1 definitions before alt
   #2 definitions after alt
 
  Apply to \Picture{...}, \Picture*+{...}, and \Picture*+[...]{...}
 
 \Configure{PictureAlt}........................1
 \Configure{PictureAlt*+}......................1
 \Configure{PictureAlt*+[]}....................1
 
   #1 definition for attributes (introduced through
      a parameter named ‘#1’)
 
    Apply to \Picture{...}, \Picture*+{...}, and \Picture*+[...]{...}
 
 \Configure{IMG}...............................5
 
   #1 before file name
   #2 between file name and alt
   #3 close alt for  \Picture without * or +
   #4 close alt for  \Picture with * and +
   #5 right delimiter
 
   Example:
 
      \Configure{IMG}
         {\ht:special{t4ht=<img src="}}
         {\ht:special{t4ht=" alt="}}
         {" }
         {\ht:special{t4ht=" }}
         {\ht:special{t4ht=/>}}
 
 \NextPictureFile.............................1
 
    Requests a file name for the next created picture.
 
 \PictureFile.............................0
 
    Records the filename of the most recent created picture.
 
 Math
 ----
 
 \Configure{$}................................2
 \Configure{$$}...............................2
 \Configure{DviMath}..........................2
 
 \DviMath ... \EndDviMath
 \MathClass ... \EndMathClass
 \PicMath ... \EndPicMath
 \DisplayMath ... \EndDispalyMath
 
    Example:
 
      \Configure{$} {\Tg<math>\DviMath} {\EndDviMath\Tg</math>} {}
 
 
 
 \Configure{PicMath}..........................4
 
    Example:
 
        \Configure{PicMath}{}{}{}{ class="math" }
 
      \Configure{()}{\protect\PicMath$}{$\protect\EndPicMath}
 
 \Configure{SUB}..............................2
 \Configure{SUP}..............................2
 \Configure{SUBSUP}...........................3
 \Configure{SUPSUB}...........................3
 \Configure{SUB/SUP}..........................6
 
 \Configure{putSUB}...........................1
 \Configure{putSUP}...........................1
 
      #1 the code to be used for realizing subscripts and postcripts
 
 \Configure{afterSUB}.........................2
 
      #1 look ahead token after subscript
      #2 the code to be used for realizing subscripts having #1 for
         lookahead token
 
 \Configure{over}.............................2
 \Configure{atop}.............................2
 \Configure{above}............................2
 \Configure{overwithdelims}...................2
 \Configure{atopwithdelims}...................2
 \Configure{abovewithdelims}..................2
 
    #1 before \over, \atop, \above
              \overwithdelims, \atopwithdelims, \abovewithdelims
    #2 after  \over, \atop, \above <dimension>
              \overwithdelims <del1> <del2>
              \atopwithdelims <del1> <del2>
              \abovewithdelims <del1> <del2> <dimension>
 
    Example:
 
      \Configure{over}
          {\Send{GROUP}{0}{[before]}[before-rule]}
          {[before-argument]\Send{EndGROUP}{0}{[after]}}
 
 
 \Configure{MathClass}........................5
 
    #1  class number
           0: mathord, 1: mathop, 2: mathbin, 3: mathrel,
           4: mathopen, 5: mathclose, 6: mathpunc
    #2  delimiter
    #3  before
    #4  after
    #5  characters
 
    Extra support:
 
       \PauseMathClass
       \EndPauseMathClass
       \NewMathClass<new control sequence>  (7, 8, ...)
 
 \Configure{FormulaClass}.....................4
 
    #1  class number
           0: mathord, 1: mathop, 2: mathbin, 3: mathrel,
           4: mathopen, 5: mathclose, 6: mathpunc
    #2  a character not in #3 and #4
    #3  before
    #4  after
 
    If #2 is empty, the formula gets the same marking as a
    single character of the specified type
 
 \Configure{FormulaClass*}....................4
 
    Like the previous case, but allow marking in the
    nested content.
 
 \Configure{MathDelimiters}...................2
 
    #1  left
    #2  right
 
 \Configure{mathbin*}.........................4
 \Configure{mathclose*}.......................4
 \Configure{mathop*}..........................4
 \Configure{mathopen*}........................4
 \Configure{mathord*}.........................4
 \Configure{mathpunct*}.......................4
 \Configure{mathrel*}.........................4
 
    #1  a character not presented in #2#3#4
    #2  code before
    #3  code after
    #4  possible definitions for successive cases
 
   Example:
      \Configure{mathop*}{*}{}{}
         {\Configure{mathop}{*}{<mo>}{</mo>}{}}
      \mathop{\overline{x \mathop{op} y}} \limits^{a=3}
 
 \Configure{mathbin}..........................4
 \Configure{mathclose}........................4
 \Configure{mathopen}.........................4
 \Configure{mathop}...........................4
 \Configure{mathord}..........................4
 \Configure{mathpunct}........................4
 \Configure{mathrel}..........................4
 
 Variants of the above group, requesting to supress nested marks.
 
 \Configure{nolimits}.........................1
 
 \MathSymbol
 
 AtBeginDocument
 ---------------
 
 \Configure{AtBeginDocument}..................2
 
     #1  before the corresponding hook of latex
     #2  after
 
    Insertions are accumulative, and can be erased by providing
    two empty arguments
 
 Other Hooks
 -----------
 
   \Configure{HChar}...................1
 
     #1  a character
 
     The \HChar{i} instruction inserts the character code i with the
     font information of character #1, when i is positive. If i is
     negative, the font info is not included.
 
 
 \Configure{Canvas}
 \Configure{ExitHPage}
 \Configure{LinkHPage}......................1
 \Configure{FontCss}
 \Configure{HVerbatim+}
 \Configure{MiniHalign}
 \Configure{Needs-}
 \Configure{Needs}
 
 
 \Configure{TraceTables}
 \Configure{edit}
 \Configure{halignTB}
 \Configure{halignTD}
 \Configure{halign}
 \Configure{hooks}
 \Configure{moveright}
 
 \Configure{noalign-}
 \Configure{pic-halign}
 
 \Configure{accent}
 \Configure{mathaccent}
 \Configure{accented}
 \Configure{accenting}
 
 
 Back-end Specials
 -----------------
                                                     insertions
                                                     ----------
   =    \special{t4ht=...content...}
            Insert the specified content to the html output, under
            edef mode of processing, and without using the mapping
            of the htf fonts.  Used in \HCode{...}.
   @    \special{[email protected]...}
            Insert the absolute value as character code to the output.
            Positve values ask the insertion to be included in place
            of the next chracter, together with the font information
            of that character.
                                                     files
                                                     -----
   >    \special{t4ht>...file-name...}
            Open a new file, if needed, and direct future output
            to the specified file.  Used in \File{...}.
   <    \special{t4ht<...file-name...}
            Close the specified file.  If it is the current file,
            activate the youngest file. Used in \EndFile{...}.
   >*   \special{t4ht*>...file-name...}
            Declare the file to be the oldest.
        \special{t4ht*>}
            Reactivate the file that activated the current file.
   *<   \special{t4ht*<file}
            Input file (with no processing)
   +    \special{t4ht++file-name}...dvi...\special{t4ht+}
            Pipe the dvi code into a dvi page in the secondary dvi file
            ‘jobname.idv’.  Used by \Picture{...}, e.g., for requesting
            gif’s.
   +    \special{t4ht+embeded-specials within idv}
   .    \special{t4ht.ext}
            Change default ext of root file
   @D   \special{t4ht@D....} Writes the content, augmented with a
            loc stamp, to the .lg file.  The locations stamp consists
            a byte-address in a named output file.
 
                                                     character maps
                                                     --------------
   !    \special{t4ht!...optional-parameters....}...dvi...\special{t4ht!}
            Create an approximated character map for the dvi code.
            Used in \Picture{...}, e.g., for ALT of IMG
   |    \special{t4ht|}...\special{t4ht|}
            Use the non-pictorial characters of the htf fonts.
            Used for character maps of \Picture{....}
   @    \special{t4ht@-}....\special{t4ht@-}
            Remove left margin from character map.  Used in \Picture{...}.
 
                                                     character settings
                                                     ------------------
   @    \special{t4ht@@}....\special{t4ht@@}
            Insert the character codes, instead of their mappings through
            the htf fonts.  Used in \JavaScript...
   @    \special{[email protected]...}, \special{[email protected]...}
            Introduce the character code into the output.
            Used by \HChar{...} and \HChar{-...}. The earlier one
            also inherites the current font info.
   @    \special{t4ht@+...string...}
            Replace the character code introduced by the next character
            with the specified string.  The decoration of the character
            code is inherited, when the string is not empty. The string
            might include character codes by enclosing them between braces.
   @    \special{t4ht@*...string...}
            A variant \special{t4ht@+...string...} that inserts the content
            after the character instead of replacing it.
   @    \special{t4ht@(}
            Ignore spaces
   @    \special{t4ht@)}
            End ignore spaces
   @    \special{t4ht@[}
            Ignore chs and spaces
   @    \special{t4ht@]}
            End ignore chs and spaces
   @    \special{t4ht@[...}...\special{t4ht@]...}\special{t4ht@?...}
            Ignore chs and spaces, if the specials  have the above
            syntax on identical strings.
   @    \special{t4ht@!}
            Get the last ignored spaces (none, if from previous lines).
   @    \special{t4ht@_....}
            Output character for rulers. Empty string is also allowed.
   @    \special{t4ht@.’’’’}
            Output for line break characters (empty
                                          content resets the default).
   @    \special{t4ht@,’’’’}
            Output for space characters (empty content resets the default).
 
                                                     dvi tracing
                                                     -----------
   @    \special{t4ht@%X}...\special{t4ht@%x}
            Request dvi tracing.
 
                X  x
                P  p      groups
                C  c      characters
                H  h      horizontal spaces
                V  v      vertical spaces
                R  r      rulers
 
        \special{t4ht@%%X*...open-del....*...close-del....}
        \special{t4ht@%%x*...open-del....*...close-del....}
            Tailor dvi tracing
 
   @    \special{t4ht@/}
            On/off tracing of specials.
   @    \special{t4ht@e...}
            String for tracing errors into the output.
   ;    \special{t4ht;....}
            Decorations for htf characters (e.g., css)
               8    pause
               9    end pause
                 . pattern
               =... show font name of char
               %... show font size of char
               ,    don’t report next htf class to lg
               -    set default font info
               +    unset default font info
   ^    \special{t4ht^i}$symbols$\special{t4ht^}}’
            Requests math class i for the listed math symbols.
 
            Tex assignes class numbers 0--7 to the atoms of math
            formulas: 0--ordinary symbol, 1--large operator, 2--binary
            operation, 3--relational operation, 4--math delimiter,
            5--right delimiter, 6--punctuation mark, and 7--adjustable.
            TeX4ht adds classes  8 and 9, while using
            class 7 independently
        \special{t4ht^}
            on/off processing delimiters
        \special{t4ht^-}
            pause processing delimeters
        \special{t4ht^+}
            continue processing delimeters
        \special{t4ht^i}
            on/off processing delimiters of class i
        \special{t4ht^i*...*...}
            configure delimiters for class i. * can be any
            character distinguished for the group.
        \special{t4ht^i(}
            put delimiters of class i on next group
        \special{t4ht^i)}
            As before, but ignore the delimeters within the sub-group.
        \special{t4ht^)*...*...}
            put the specified delimiters on next group.
            Ignore delimeters within the group.
        \special{t4ht^<*...*...}
            put the specified delimiters on the next group.
            Don’t ignore delimeters within the group.
                                                     dvi arithmetic
                                                     --------------
   :    \special{t4ht:....}
            Dvi-mode arithmetics.
              :+...  increment by 1( define, if not defined)
              :-...  decrement by 1
              :>...  push current value
              :<...  pop current value
              :!...  display current value
              :  .  display top value
 
                                                     messages to lg file
                                                     -------------------
   +    \special{[email protected]...}
            Send message to the lg file.  Used in the \Needs{...} command.
   @    \special{t4ht@D....}
            Send message to the lg file, together with location and file
            stamp.
 
                                                     positional code
                                                     -------------------
   "    \special{t4ht"}
            Start/end positional env
        \special{t4ht"* before-all * after-all ...** before-char
                      * after-char * rect
                      *%A*%B*%C*%D*%E
                      * optional
            Configure positioned code
              * before-all
              * after-all      %...
              ** before-char  %x %y
              * after-char
              * rect          %x1 %y1 ...
              * x,x1-coefficients %A(x) + %B
              * y1-coefficients %C(y1 - %E(height)) + %D
              * y-coefficients  %C(y) + %D
              * optional: 1, 2
 
                %x1 %y1 %length %thickness          default
                %x1 %y1 %x1+length %y1+thickness    1
                %x1 %y1 %x1+length %y1 %thickness   2
 
            A-magnification, B-displacement
            C-magnification, D-displacement,
            E- origin (0: top, 0.5: mid, 1: bot)
 
            The %...’s should be c-type templates (e.g., "%.2f"; "%.0f"
               gives an integer)
 
            Multiple after-all templates are allowed. The leading
              character is a code specifying the dimension type.
                 x           min x
                 X           max x
                 y           min y
                 Y           max y
                 d           dx
                 D           dy
                 otherwise   a string with no values
            The delimiter ‘*’ can be substitued by another character.
 
 
   ~    \special{t4ht~...}
            Grouped-base two-way delivery for content created by
            inline commands like \over.
 
        \special{t4ht~}...\special{t4ht~}   on/off
 
        ~<i...  send forward to the start of the group nested
                                                 at relative level i.
        ~>i...  send forward to the end of the group nested
                                                 at relative level i.
                i=0, current group
 
 
        ~<*...  send back to start of previous token / group.
        \special{t4ht~<)}...\special{t4ht~<(}
            activate / deactivate  back token / group submissions
        \special{~<[}...\special{t4ht~<]}’
            hide region from back submissions over token / group
        \special{t4ht~<-} ... \special{t4ht~<+}
            latex back token / group
 
        \special{t4ht\string~!...path...<...content}
            insertion at the start of the group reached by the path
        \special{t4ht\string~!...path...>...content}
            insertion at the end of the group reached by the path
        \special{t4ht\string~!...path.../}
            ignore content within the group reached by the path
        \special{t4ht\string~!...path...-}
            ignore rulers from the group reached by the path
            until the start of the next group
         A path may consist only of ‘e’ and ‘s’ characters for,
         respectively, entering and skipping groups
 
   *!   \special{t4ht*! system command}
            System call
   *^   accent specials
         t text accent #1#2#1#3#1#4#1#5#1#6 pattern
                       empty                insertion point
         m math accent #1#2#1#3#1#4#1#5#1   pattern
                       empty                insertion point
         a accented    #1#2#1#3#1#4#1#5#1#6
         i             #1#2#1#3#1#1
   *@   halign specials
 
 \HCode...............................1
 
    A wrapper for \special{t4ht=...}.
 
    The sharp symbol # may be accessed indirectly through the command.
 
 \Hnewline............................0
 
    Requests new lines within specials
-_-_-