up

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  
              \let \prOteCt \relax \Protect \csname acp:c\endcsname {14}.. 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  
             :\let \prOteCt \relax \Protect \csname acp:c\endcsname {14}..  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  
 

up