{"id":323,"date":"2010-09-06T16:54:52","date_gmt":"2010-09-06T11:24:52","guid":{"rendered":"http:\/\/www.cvr.cc\/?p=323"},"modified":"2010-09-06T16:54:52","modified_gmt":"2010-09-06T11:24:52","slug":"tex4ht-configure-part-1","status":"publish","type":"post","link":"https:\/\/cvr.cc\/?p=323","title":{"rendered":"TeX4ht: Configure Part 1"},"content":{"rendered":"

The \\Configure<\/code> command is the most powerful user command in Te<\/span>X4ht system. It helps to add various kinds of hooks to insert target markup code at the desired locations in and around various types of content. For instance, take the case of section{...}<\/code> in La<\/small><\/span>Te<\/span>X. A typical example will be:\n<\/p>\n

\n  \\section{Introduction}\n<\/pre>\n
\\Configure<\/code> for \\section<\/code> provides four (4) hooks in the following style:<\/p>\n
\n  \\Configure{section}\n    {<beginning of section>}  {<end of the section>}\n    {<before section heading>}{<after section heading>}\n<\/pre>\n
Suppose our target markup requires the following pattern of markup for a section heading:<\/p>\n
\n  <section id=\"sec1\">\n   <title>Introduction<\/title>\n    <para>\n         ...\n    <\/para>\n  <\/section>\n<\/pre>\n
We will accomplish the above target by configuring the section macros in the following manner:<\/p>\n
\n  \\Configure{section}\n   {\\EndP\\IgnorePar\\Tg<section id=\"sec\\thesection\">}\n   {\\EndP\\Tg<\/section>}\n   {\\Tg<title>}\n   {\\Tg<\/title>\\ShowPar}\n<\/pre>\n
The above code will help translate any La<\/small><\/span>Te<\/span>X section heading into the required markup scheme as provided in the example. Macros like \\EndP<\/code>, \\IgnorePar<\/code> and \\ShowPar<\/code> will be discussed a little later. These are hooks to insert begin and end of paragraph code into the content appropriately. Here, in this document, we shall list most of the \\Configure<\/code> hooks available in Te<\/span>X4ht system and describe briefly how those can be used for configuring most of the La<\/small><\/span>Te<\/span>X commands popularly used in documents.<\/p>\n
\n \\Configure{PROLOG}.........1\n<\/pre>\n
#1<\/div>\n
Comma separated list of hooks to appear before HTML<\/small>. Each hook E is declared to be configurable by an instruction of the form \\NewConfigure {E}{1}<\/code>. A star *<\/code> prefix calls for accumulative configurations.<\/div>\n<\/p>\n
Example<\/h4>\n
\n  \\Configure{PROLOG}{VERSION,DOCTYPE,*XML-STYLESHEET}\n  \\Configure{VERSION}\n     {\\HCode{<?xml version=\"1.0\"?>}}\n\n  \\Configure{ext}............1\n<\/pre>\n
#1:<\/div>\n
default extension name for target files (recorded in :html<\/code>). Can also be requested through a command line option ext=...<\/code><\/div>\n
\n \\Preamble...................0\n<\/pre>\n<\/p>\n
Records the list of the requested options. Defined upon entering the environment \\Preamble{...}....\\EndPreamble<\/code>, to replace the earlier version of \\Preamble<\/code>.<\/p>\n
\n\\ifOption ................. 3\n<\/pre>\n
#1<\/div>\n
Argument to be checked whether it is a given option.<\/div>\n
#2<\/div>\n
True part<\/div>\n
#3<\/div>\n
False part<\/div>\n
Wrapper for the Document<\/h4>\n
\n \\Configure{DOCTYPE}.........1\n \\Configure{HTML}............2\n \\Configure{HEAD}............2\n \\Configure{@HEAD}...........1\n \\Configure{BODY}............2\n \\Configure{TITLE+}..........1\n \\Configure{TITLE}...........2\n \\Configure{@TITLE}..........1\n \\Configure{Preamble}........2\n    <DOCTYPE>\n    <HTML 1>\n     <HEAD 1>\n        <TITLE 1>\n           <@TITLE>\n           <TITLE+>\n        <TITLE 2>\n        <@HEAD>\n     <HEAD 2>\n     <BODY 1>\n     ......\n     <BODY 2>\n    <HTML 2>\n<\/pre>\n<\/p>\n
The \\Configure{@HEAD}{...}<\/code> command is additive, concatenating the content of all of its appearances. An empty parameter requests the cancellation of the earlier contributions.<\/p>\n
For instance,<\/p>\n
\n \\Configure{@HEAD}{A}\n  \\Configure{@HEAD}{}\n  \\Configure{@HEAD}{B}\n  \\Configure{@HEAD}{C}\n<\/pre>\n
contributes ‘BC’.<\/p>\n
The \\Configure{TITLE+}<\/code> provides the content for the title, Configure{TITLE}<\/code> sets the envelop, and Configure{@TITLE}<\/code> acts as a hook for introducing localized configurations. As is the case for Configure{@HEAD}<\/code>, the contribution of \\Configure{@TITLE}<\/code> is also additive.<\/p>\n
These configurations should be introduced early enough in the compilation. For instance, in the case of LaTeX, between \\Preamble<\/code> and \\begin{document}<\/code> of a local configuration file.<\/p>\n
\n  \\Preamble\n    %%% here %%%\n  \\begin{document}\n    ...\n  \\EndPreamble\n  \\Configure{@BODY}...........1\n  \\Configure{@\/BODY}..........1\n<\/pre>\n
Variants of \\Configure{@HEAD}<\/code> which contribute their content, respectively, after <body><\/code> and before <\/body><\/code>.<\/p>\n
\n  \\Configure{CutAtTITLE+}.....1\n  Configure{HPageTITLE+}.....1 <\/pre>\n
#1<\/div>\n
An insertion just before the content of <TITLE><\/code>. If #1 is a one parametric macro, it gets the title content for an argument.<\/div>\n
Support for Sectioning Commands<\/h4>\n
\n \\Configure{unit-name} ......................4\n<\/pre>\n
#1<\/div>\n
start<\/div>\n
#2<\/div>\n
end<\/div>\n
#3<\/div>\n
before title<\/div>\n
#4<\/div>\n
after title<\/div>\n<\/p>\n
Example<\/h4>\n
\n  \\Configure{section}\n    {\\HCode{<section>}}    {\\HCode{<\/section>}}\n    {\\HCode{<title>}}      {\\HCode{<\/title>}}\n  \\ConfigureMark{unit-name}...................1\n<\/pre>\n<\/p>\n
Defines a macro <unit-name>\\HMark<\/code> to hold the given argument. Upon entering the unit, \\TitleMark<\/code> gets the content of this macro.<\/p>\n
Some built-in configurations of Te<\/span>X4ht require an argument for the <unit-name>\\HMark<\/code> 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.<\/p>\n
Example<\/h4>\n
\n  \\Configure{section}\n     {}{}\n     {\\HCode{<h3>}\\TitleMark\\space}{\\HCode{<\/h3>}}\n   \\ConfigureMark{section}{\\thesection}\n<\/pre>\n<\/p>\n
ToC link<\/h4>\n
\n  \\Configure{toTocLink}.......................2\n<\/pre>\n<\/p>\n
Each unit title contains a \\Link{...}{...}...\\EndLink<\/code> command. The first argument of \\Link<\/code> 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).<\/p>\n
The package option section+<\/code> requests the inclusion of the title within the anchor. Without this option, the link command resides between the title mark and its content.<\/p>\n
The \\Configure{toTocLink}<\/code> command is provided for configuring the \\Link<\/code> and \\EndLink<\/code> instructions. In the default setting, when the sections+<\/code> option is not activated, the \\Link<\/code> command is altered to replace its first argument with an empty argument.<\/p>\n
Example<\/h4>\n
\n  \\Configure{toTocLink}\n    {\\Link}\n    {\\ifx \\TitleMark\\sectionHMark\n       \\Picture[up]{haut.jpg align=\"right\"}%\n       \\EndLink\n       \\TitleMark\\space\n     else \\EndLink fi\n    }\n  \\def\\up{[up]}\n  \\Configure{toToc}...........................2\n<\/pre>\n
#1<\/div>\n
unit type<\/div>\n
#2<\/div>\n
desired contents type (if empty, ‘unit type’ is assumed)<\/div>\n<\/p>\n
Example<\/h4>\n
\n  \\Configure{toToc}{chapter}{likechapter}\n<\/pre>\n<\/p>\n
Introduces chapter as likechapter into toc<\/p>\n
#1<\/div>\n
empty: stop adding entries of ‘unit type’ to toc<\/div>\n
@:<\/div>\n
add entries of ‘unit type’ to toc<\/div>\n
?:<\/div>\n
resume mode in effect before the last stop<\/div>\n
#2<\/div>\n
unit type<\/div>\n
Example<\/h4>\n
\n  \\Configure{toToc}{}{chapter}\n  \\chapter{...}\n  \\Configure{toToc}{@}{chapter}\n  \\Configure{writetoc}.........................1\n<\/pre>\n
#1<\/div>\n
Configuration material for the insertion instruction. New configurations are added to those request earlier by the command. An empty argument cancels the earlier contributions.<\/div>\n<\/p>\n
\n  \\NoLink.......................1\n<\/pre>\n<\/p>\n
Ignore option section+<\/code> for sections of type #1.<\/p>\n
\n  \\TitleCount\n<\/pre>\n<\/p>\n
Count of entries submitted to the toc<\/code> file<\/p>\n
\n  \\Configure{NoSection}.........2\n<\/pre>\n<\/p>\n
Insertions around the parameters of sectioning commands, applied when the parameters are not used to create titles for the divisions.<\/p>\n
\n  \\CutAt{#1,#2,#3,...}\n<\/pre>\n
#1<\/div>\n
section type to be placed in a separate web page.<\/div>\n
#2,#3,…<\/div>\n
end delimiting section types, other than #1, for the web pages A +<\/code> before #1 requests hypertext buttons for the web pages.<\/div>\n
Example<\/h4>\n
\n  \\CutAt{mychapter,myappendix,mypart}\n  \\CutAt{+myappendix,mychapter,mypart}\n<\/pre>\n<\/p>\n
Cut points at arbitrary points can be introduced by introducing section-like commands in a manner similar to<\/p>\n
\n  \\NewSection\\mysection{}\n  \\CutAt{mysection}\n  \\Configure{+CutAt}.................................3\n<\/pre>\n
#1<\/div>\n
sectioning type<\/div>\n
#2<\/div>\n
before<\/div>\n
#3<\/div>\n
after<\/div>\n
Requests delimiters for the CutAt<\/code> buttons of the specified sectioning type.<\/p>\n
Example<\/h4>\n
\n  \\Configure{+CutAt}{mysection}{[}{]}\n  \\PauseCutAt{#1}\n  \\ContCutAt{#1}\n<\/pre>\n
#1<\/div>\n
section type<\/div>\n<\/p>\n
\n  \\Configure{CutAt-filename} ........................1\n<\/pre>\n<\/p>\n
A 2-parameter hook for tailoring section-based filenames. The section type is available through #1. The section title is accessible through #2.<\/p>\n
Example<\/h4>\n
\n  \\Configure{CutAt-filename}{\\NextFile{#1-#2.html}}\n<\/pre>\n<\/p>\n
Tables of Contents<\/h4>\n
Created from the entries collected in the previous compilation within a \\jobname.4tc<\/code> file.<\/p>\n
\n \\ConfigureToc{unit-name} ......................4\n<\/pre>\n
#1<\/div>\n
before unit number<\/div>\n
#2<\/div>\n
before content<\/div>\n
#3<\/div>\n
before page number<\/div>\n
#4<\/div>\n
at end<\/div>\n<\/p>\n
    \n
  • Empty arguments request the omission of the corresponding field.<\/li>\n
  • \\TocCount<\/code> Specifies the entry count withing the \\jobname.4tc<\/code> file.<\/li>\n
  • \\TitleCount<\/code> Count of entries submitted to the toc file.<\/li>\n
  • An alternative to \\ConfigureToc{unit-name}<\/code>:<\/li>\n
  • \n<\/li>\n<\/ul>\n
    \n  \\def\\toc<unit-name>#1#2#3{<before unit number>#1<before content>#2%\n                          <before page number>#3<at end>}\n<\/pre>\n<\/p>\n
    Example<\/h4>\n
    \n  \\ConfigureToc{section}\n    {}\n    {\\Picture[*]{pic.jpg width=\"13\"  height=\"13\"}~}\n    {}\n    {\\HCode{<br \/>}}\n<\/pre>\n
    \n  \\Configure{TocLink}..................4\n<\/pre>\n<\/p>\n
    Configures the link offered in the third arguments of \\ConfigureToc<\/code>.<\/p>\n
    Example<\/h4>\n
    \n  \\Configure{TocLink}{\\Link{#2}{#3}#4\\EndLink}\n  \\TocAt{#1,#2,#3,...}\n<\/pre>\n
    #1<\/div>\n
    section type for which local tables of contents Toc<\/code> #1 are requested.<\/div>\n
    #2,#3,…<\/div>\n
    sectioning types to be included in the tables of contents.<\/div>\n
    \n<\/p>\n
    The non-leading arguments may be preceded by slashes \/<\/code>, in which cases the arguments specify end points for the tables.<\/p>\n
    The default setting requests automatic insertion of the local tables immediately after the sectioning heads.<\/p>\n
    A star *<\/code> character may be introduced, between the \\TocAt<\/code> and the left brace, to request the appearances of the tables of contents at the end of the units’ prefaces.<\/p>\n
    A hyphen -<\/code> character, on the other hand, disables the automatic insertions of the local tables.<\/p>\n
    In case of a single argument, the command removes the existing definition of \\Toc#1<\/code>.<\/p>\n
    Example<\/h4>\n
    \n  \\TocAt{mychapter,mysection,mysubsection,\/myappendix,\/mypart}\n  \\TocAt-{mysection,mysubsection,\/mylikesection}\n  section{...}...\\Tocmysection\n<\/pre>\n<\/p>\n
    The definition of the local table of contents can be redefined within \\csname Toc#1\\endcsname<\/code>.<\/p>\n
    Example<\/h4>\n
    \n  \\TocAt{section}\n  \\def\\Tocsection{\\TableOfContents[section]}\n  \\Css{div.sectionTOCS {\n                    width : 30%;\n                    float : right;\n               text-align : left;\n            vertical-align : top;\n              margin-left : 1em;\n                font-size : 85%;\n          background-color : #DDDDDD;\n     }}\n<\/pre>\n<\/p>\n
    Example<\/h4>\n
    \n Table of content before the section title.<\/p>\n
    \n  \\Configure{section}{}{}\n    {\\Tocsection \\let\\saveTocsection=\\Tocsection\n     \\def\\Tocsection{\\let\\Tocsection=\\saveTocsection}%\n     \\ifvmode \\IgnorePar\\fi \\EndP\\IgnorePar\n     \\HCode{<h3 class=\"sectionHead\">}\\TitleMark\\space\\HtmlParOff}\n    {\\HCode{<\/h3>}\\HtmlParOn\\ShowPar \\IgnoreIndent \\par}\n<\/pre>\n
    \n  \\Configure{TocAt}......................2\n  \\Configure{TocAt*}.....................2\n<\/pre>\n
    #1<\/div>\n
    before the tables of contents<\/div>\n
    #2<\/div>\n
    after the tables of contents<\/div>\n<\/p>\n
    Paragraphs<\/h4>\n
    \n  \\Configure{HtmlPar}..........4\n<\/pre>\n<\/p>\n
    #1<\/div>\n
    content at the start non-indented paragraphs<\/div>\n
    #2<\/div>\n
    content at the start indented paragraphs<\/div>\n
    #3<\/div>\n
    insertion into EndP<\/code> , at the start of non-indented paragraphs<\/div>\n
    #4<\/div>\n
    insertion into EndP<\/code> , at the start of indented paragraphs<\/div>\n
    \n<\/p>\n
    \n  \\HtmlParOff\n  \\HtmlParOn\n  \\IgnorePar     Asks to ignore the next paragraph\n  \\ShowPar       Asks to take into account the following paragraphs\n \\IgnoreIndent  asks to ignore indentation in the next paragraph\n  \\ShowIndent    asks to check indentation in the following paragraphs\n  \\SaveEndP      Saves the content of EndP, and sets it to empty content\n  \\RecallEndP\n  \\SaveHtmlPar\n  \\RecallHtmlPar\n<\/pre>\n<\/p>\n
    Example<\/h4>\n
    \n  \\Configure{@BODY}\n    {\\ifvmode \\IgnorePar\\fi \\EndP\n     \\HCode{<div>}\\par\\ShowPar}\n  \\Configure{@\/BODY}\n    {\\ifvmode \\IgnorePar\\fi \\EndP\n     \\HCode{<\/div>}}\n<\/pre><\/p>\n","protected":false},"excerpt":{"rendered":"
    The \\Configure command is the most powerful user command in TeX4ht system. It helps to add various kinds of hooks to insert target markup code at the desired locations in and around various types of content. For instance, take the case of section{…} in LaTeX. A typical example will be:<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21,15,16],"tags":[],"class_list":["post-323","post","type-post","status-publish","format-standard","hentry","category-configure","category-tex","category-tex4ht"],"_links":{"self":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/posts\/323","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=323"}],"version-history":[{"count":0,"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/posts\/323\/revisions"}],"wp:attachment":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=323"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=323"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=323"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}