[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
22.5.3 HTML Customization Variables
This table gives the customization variables which apply to HTML output only. A few other customization variable apply to both HTML and other output formats; those are given in the next section.
AVOID_MENU_REDUNDANCY
For HTML. If set, and the menu entry and menu description are the same, then do not print the menu description; default false.
AFTER_BODY_OPEN
For HTML. If set, the corresponding text will appear at the beginning of each HTML file; default unset.
AFTER_ABOUT
For HTML, when an About-element is output. If set, the corresponding text will appear at the end of the About element; default unset.
AFTER_OVERVIEW
AFTER_TOC_LINES
For HTML. If set, the corresponding text is output after the short table of contents for
AFTER_OVERVIEW
and after the table of contents forAFTER_TOC_LINES
; otherwise, a default string is used. At the time of writing, a</div>
element is closed.In general, you should set
BEFORE_OVERVIEW
ifAFTER_OVERVIEW
is set, and you should setBEFORE_TOC_LINES
ifAFTER_TOC_LINES
is set.BASEFILENAME_LENGTH
For HTML. The maximum length of the base filenames; default 245. Changing this would make cross-manual references to such long node names invalid (see section HTML Cross Reference Link Basics).
BEFORE_OVERVIEW
BEFORE_TOC_LINES
For HTML. If set, the corresponding text is output before the short table of contents for
BEFORE_OVERVIEW
and before the table of contents forBEFORE_TOC_LINES
, otherwise a default string is used. At the time of writing, a<div ...>
element is opened.In general you should set
AFTER_OVERVIEW
ifBEFORE_OVERVIEW
is set, and you should setAFTER_TOC_LINES
ifBEFORE_TOC_LINES
is set.BIG_RULE
For HTML. Rule used after and before the top element and before special elements, but not for footers and headers; default
<hr>
.BODYTEXT
-
For HTML, the text appearing in
<body>
. By default, set automatically, taking into account the document language (see section@documentlanguage ll[_cc]
: Set the Document Language). CASE_INSENSITIVE_FILENAMES
For HTML. Construct output file names as if the filesystem were case insensitive (see section HTML Splitting); default false.
CHAPTER_HEADER_LEVEL
For HTML. Header formatting level used for chapter level sectioning commands; default ‘2’.
CHECK_HTMLXREF
For HTML. Check that manuals which are the target of external cross references (see section
@xref
with Four and Five Arguments) are present in ‘htmlxref.cnf’ (see section HTML Cross Reference Configuration: ‘htmlxref.cnf’); default false.COMPLEX_FORMAT_IN_TABLE
For HTML. If set, use tables for indentation of complex formats; default false.
CSS_LINES
For HTML. CSS output, automatically determined by default (see section HTML CSS).
DATE_IN_HEADER
For HTML. Put the document generation date in the header; off by default.
DEF_TABLE
For HTML. If set, a
<table>
construction for@deffn
and similar @-commands is used (looking more like the TeX output), instead of definition lists; default false.DEFAULT_RULE
For HTML. Rule used between element, except before and after the top element, and before special elements, and for footers and headers; default
<hr>
.DO_ABOUT
For HTML. If set to 0 never do an About special element; if set to 1 always do an About special element; default 0.
EXTERNAL_DIR
For HTML. Base directory for external manuals; default none. It is better to use the general external cross reference mechanism (see section HTML Cross Reference Configuration: ‘htmlxref.cnf’) than this variable.
EXTRA_HEAD
For HTML. Additional text appearing within
<head>
; default unset.FOOTNOTE_END_HEADER_LEVEL
For HTML. Header formatting level used for the footnotes header with the ‘end’ footnotestyle; default ‘4’. See section Footnote Styles.
FOOTNOTE_SEPARATE_HEADER_LEVEL
For HTML. Header formatting level used for the footnotes header with the ‘separate’ footnotestyle; default ‘4’. See section Footnote Styles.
FRAMES
For HTML. If set, a file describing the frame layout is generated, together with a file with the short table of contents; default false.
FRAMESET_DOCTYPE
For HTML. Same as DOCTYPE, but for the file containing the frame description.
HEADER_IN_TABLE
For HTML. Use tables for header formatting rather than a simple
<div>
element; default false.ICONS
For HTML. Use icons for the navigation panel; default false.
IMAGE_LINK_PREFIX
For HTML. If set, the associated value is prepended to the image file links; default unset.
INLINE_CONTENTS
For HTML. If set, output the contents where the
@contents
and similar @-commands are located; default true. This is ignored if@set*contentsaftertitlepage
is set (see section Generating a Table of Contents).INLINE_CSS_STYLE
For HTML. Put CSS directly in HTML elements rather than at the beginning of the output; default false.
KEEP_TOP_EXTERNAL_REF
For HTML. If set, do not ignore ‘Top’ as the first argument for an external ref to a manual, as is done by default. See section Naming a ‘Top’ Node.
L2H
For HTML. If set,
latex2html
is used to convert@math
and@tex
sections; default false. Best used with ‘--iftex’.L2H_CLEAN
(Relevant only if
L2H
is set.) If set, the intermediate files generated in relation withlatex2html
are removed; default true.L2H_FILE
(Relevant only if
L2H
is set.) If set, the given file is used aslatex2html
’s init file; default unset.L2H_HTML_VERSION
(Relevant only if
L2H
is set.) The HTML version used in thelatex2html
call; default unset.L2H_L2H
(Relevant only if
L2H
is set.) The program invoked aslatex2html
; default islatex2html
.L2H_SKIP
(Relevant only if
L2H
is set.) If set to a true value, the actual call tolatex2html
is skipped; previously generated content is reused instead. If set to 0, the cache is not used at all. If set to ‘undef’, the cache is used for as many TeX fragments as possible and for any remaining the command is run. The default is ‘undef’.L2H_TMP
(Relevant only if
L2H
is set.) Set the directory used for temporary files. None of the file name components in this directory name may start with ‘.’; otherwise,latex2html
will fail (because ofdvips
). The default is the empty string, which means the current directory.MAX_HEADER_LEVEL
For HTML. Maximum header formatting level used (higher header formatting level numbers correspond to lower sectioning levels); default ‘4’.
MENU_SYMBOL
For HTML. Symbol used in front of menu entries when node names are used for menu entries formatting; default ‘•’.
MONOLITHIC
For HTML. Output only one file including the table of contents. Set by default, but only relevant when the output is not split.
NO_CSS
For HTML. Do not use CSS; default false. See section HTML CSS.
NODE_FILE_EXTENSION
For HTML. Extension for node files if
NODE_FILENAMES
is set; default ‘html’.PRE_ABOUT
For HTML, when an About element is output. If set to a text string, this text will appear at the beginning of the About element. If set to a reference on a subroutine, the result of the subroutine call will appear at the beginning of the About element. If not set (the default), default text is used.
PRE_BODY_CLOSE
For HTML. If set, the given text will appear at the footer of each HTML file; default unset.
PROGRAM_NAME_IN_FOOTER
For HTML. If set, output the program name and miscellaneous related information in the page footers; default false.
SHORTEXTN
For HTML. If set, use ‘.htm’ as extension; default false.
SHOW_TITLE
For HTML. If set, output the title at the beginning of the document; default true.
SIMPLE_MENU
For HTML. If set, use a simple preformatted style for the menu, instead of breaking down the different parts of the menu; default false. See section The Parts of a Menu.
TOC_LINKS
For HTML. If set, links from headings to toc entries are created; default false.
TOP_FILE
This file name may be used for the top-level file. The extension is set appropriately, if necessary. This is used to override the default, and is, in general, only taken into account when output is split, and for HTML.
TOP_NODE_FILE
For HTML. File name used for the Top node, if
NODE_FILENAMES
is set; default isindex
.TOP_NODE_FILE_TARGET
For HTML. File name used for the Top node in cross references; default is
index
.TOP_NODE_UP_URL
For HTML. The url used for the Up pointer of the Top node; default
undef
, meaning no link is generated.USE_ACCESSKEY
-
For HTML. Use
accesskey
in cross references; default true. USE_ISO
For HTML. Use entities for doubled single-quote characters (see section Inserting Quotation Marks), and ‘---’ and ‘--’ (see section General Syntactic Conventions); default true.
USE_LINKS
-
For HTML. Generate
<link>
elements in the HTML<head>
output; default true. USE_REL_REV
For HTML. Use
rel
in cross references; default true.VERTICAL_HEAD_NAVIGATION
For HTML. If set, a vertical navigation panel is used; default false.
WORDS_IN_PAGE
-
For HTML, with output split at nodes. Specifies the approximate minimum page length at which a navigation panel is placed at the bottom of a page. To avoid ever having the navigation buttons at the bottom of a page, set this to a sufficiently large number. The default is 300.
XREF_USE_FLOAT_LABEL
For HTML. If set, for the float name in cross references, use the float label instead of the type followed by the float number (see section
@float
[type][,label]: Floating Material). The default is off.XREF_USE_NODE_NAME_ARG
For HTML. Only relevant for cross reference commands with no cross reference name (second argument). If set to 1, use the node name (first) argument in cross reference @-commands for the text displayed as the hyperlink. If set to 0, use the node name if
USE_NODES
is set, otherwise the section name. If set to ‘undef’, use the first argument in preformatted environments, otherwise use the node name or section name depending onUSE_NODES
. The default is ‘undef’.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated on October 2, 2013 using texi2html 5.0.