Blue Danube

Digital intuitions

· ·

TeX4ht: Options

Following is an incomplete list of options that can be passed on to TeX4ht when it is run from command line. These can also be provided as options when tex4ht package is loaded in a LaTeX document with the default usepackage command.

-css to ignore CSS code, use command line option -css.
-xtpipes to avoid xtpipes post-processing the output. This might be useful for docbook XML output.
0 pagination shall be obtained through the option 0 or 1, at locations marked with PageBreak.
1, 2, 3, 4, 5, 6, 7 for automatic sectioning pagination (to break at various section levels), use the appropriate command line option 1, 2, 3, 4, 5, 6, 7.
DOCTYPE to request a DOCTYPE declaration, use the command line option DOCTYPE.
Gin-dim for key dimensions of the graphic, try this option.
Gin-dim+ for key dimensions when the bounding box is not available.
NoFonts to ignore CSS font decoration.
PMath Option to choose positioned math. Example: Example: def({PMath$}; def){$EndPMath}; def[{PMath$$}; def]{$$EndPMath}.
RL2LR to reverse the direction of RL sentences.
TocLink option to request links from the tables of contents.
^13 option for active superscript character.
_13 option for active subscript character.
bib- for degraded bibliography friendlier for conversion to .doc.
bibtex2 Option bibtex2 requires compilation of jobname j.aux with bibtex.
charset for alternate character set, use the command line option charset="..." (e.g., charset="utf8").
css-in the inline CSS code will be extracted from the input of the previous compilation, so an extra compilaion might be needed for this option to make it effective.
css2 for CSS 2 code.
early^ for default catcode of superscript in the Preamble.
early_ for default catcode of subscript in the Preamble.
endnotes for end notes instead of footnotes, use this option.
enumerate+ for enumerated list elements with valued data. This will use the description list like <dt>...</dt> for the list counter.
enumerate- for enumerated list element’s <li>’s with value attributes, use this command line option. This will be an ordered list with the value of list counter provided as an attribute namely, value of the <li> element.
fn-in for inline footnotes use this option.
fn-out for offline footnotes.
fonts for tracing LaTeX font commands, use this command line option.
fonts+ for marking of the base font, use this option.
font for adjusted font size, use the command line option font=... (e.g., font=-2).
frames- for frames support. frames is also valid option for frames support.
frames-fn for content, TOC and footnotes in three frames.
frames for TOC and content in two frames.
gif for bitmaps of pictures in .gif format, use this option.
graphics- if the included graphics are of degraded quality, try the command line options graphics-num or graphics-. The num should provide the density of pixels in the bitmaps (e.g., 110).
hidden-ref option to hide clickable index and bibliography references.
html+ for stricter HTML code.
imgdir for addressing images in a subdirectory, use the option imgdir:.../.
image-maps for image-maps support.
index for n-column index, use the command line option, index=n (e.g., index=2).
info-oo for extra tracing information while generating open office output.
info for extra information in the jobname.log file.
java for javasupport.
javahelp for JavaHelp output format, use this command line option.
javascript for javascript support.
jh- for sources failing to produce XML versions of HTML, try this command line option.
jpg for bitmaps of pictures in .jpg format, use this option.
li- for enumerated list elements li’s with value attributes.
math- option to use when sources fail to produce clean math code.
mathltx- option to use when sources fail to produce clean mathltx code.
mathml- option to use when sources fail to produce clean MathML code.
mathplayer for MathML on Internet Explorer + MathPlayer.
minitoc¡ for mini tocs immediately after the header use the command line option, minitoc<.
mouseover for pop ups on mouse over.
next for linear cross-links of pages, use this option.
nikud for Hebrew vowels, use the command line option, nikud.
no-DOCTYPE to remove DOCTYPE declaration from the output.
no-VERSION to remove <?xml version="..."?> processing instruction from the output.
no^ for non-active ^ (superscript), use the option no^.
no_ for non-active _ (subscript command), use the command line option, no_.
no_^ for both non-active superscript and subscript, use the option no_^.
nolayers to remove overlays of slides, use this option.
nominitoc this will eliminate mini tables of contents from the output.
notoc* for tocs without * entries, use this option. The notoc* option is applicable only to pages that are automatically decomposed into separate web pages along section divides. It shall be used when addcontentsline instructions are present in the sources.
obj-toc for frames-like object based table of contents, use the command line option obj-toc.
p-width for width specifications of tabular p entries, use this option.
pic-RL for pictorial RL.
pic-align for pictorial align environment.
pic-array for pictorial array.
pic-cases for pictorial cases environment.
pic-eqalign for pictorial equalign environment.
pic-eqnarray for pictorial eqnarray.
pic-equation for pictorial equations.
pic-fbox for pictorial or bitmapped fbox’es.
pic-framebox for bitmap fameboxes.
pic-longtable for bitmapped longtable.
pic-m+ for pictorial $...$ and $$...$$ environments with LaTeX alt, use the command line option pic-m+ (not safe).
pic-m for pictorial $...$ environments, use the command line option pic-m (not recommended).
pic-matrix for pictorial matrix.
pic-tabular use this option for pictorial tabular.
plain- for scaled down implimentation.
prog-ref for pointers to code files from root fragments, use the command line option prof-ref. This is for debugging.
refcaption for links into captions, instead of flat heads, use this option.
rl2lr to reverse the direction of Hebrew words, use this option.
sec-filename for file names derived from section titles, use the command line option sec-filename.
sections+ for back links to table of contents, use this option.
svg- for external SVG files, try this option.
svg-obj same as above.
svg for dvi pictures in svg format.
tab-eq for tab-based layout of equation environment, use this option.
trace-onmo for mouseover tracing of compilation, use the command line option, trace-onmo.
url-enc for URL encoding within href, use this option. Configure{url-encoder} can be used to fine tune encoding.
url-il2-pl for il2-pl URL encoding.
ver for vertically stacked frames. Effective when frames option is requested.
xht for file name extension, .xht, use this command line option.
xhtml for XML code, use the command line option, xml or xhtml.
xml See previous entry.

9 responses to “TeX4ht: Options”

  1. Thank you, this will be very useful (and something very much awaited by tex4ht users). Thank you (and Karl Berry) for all your efforts maintaining tex4ht.

    1. Thanks for the nice compliments, LianTze.

  2. Great list! But, I can not got to work option“endnotes”, and it isn’t mentioned in the documentation… Is it something new? (puszcza is down at the moment).

    1. Thanks.

      The ‘endnotes’ option appears to be for oolatex invocation. I’d salvaged most of the options from Eitan’s literate sources, as such, many of them are untested. I will try to add appropriate script name (along with options) if an option is not meant for the default html or xhtml output.

  3. Kirill Müller

    Thank you for the useful list. However, not all options work for all output modes (XHTML, OpenOffice, …) Would you consider adding a matrix or a list for which output modes each option is valid?

  4. Thanks — for all your tex4ht work!
    I’ve wanted ‘pic-align’ for ages…
     

  5. julian

    Is there any option to produce equations in their original LATEX form (not converted to MathML) so that they can be displayed with MathJax?

    1. Martina

      MathJax can use MathML, TeX and ASCIImath as input so you can use mathml option in tex4ht and still get the equations shown by using MathJax.

    2. MadyYuvi

      Please have a look into “https://tex.stackexchange.com/questions/204476/leave-math-content-alone-with-tex4ht-for-mathjax”

Leave a Reply

Your email address will not be published. Required fields are marked *