NAME¶
"latexmlmath" - transforms a TeX/LaTeX math expression into various
formats.
SYNOPSIS¶
latexml [options] texmath
Options:
--mathimage=file converts to image in file
--magnification=mag specifies magnification factor
--presentationmathml=file converts to Presentation MathML
--pmml=file alias for --presentationmathml
--linelength=n do linewrapping of pMML
--contentmathml=file convert to Content MathML
--cmml=file alias for --contentmathml
--openmath=file convert to OpenMath
--om=file alias for --openmath
--XMath=file convert to LaTeXML's internal format
--noparse disables parsing of math
(not useful for cMML or openmath)
--preload=file loads a style file.
--includestyles allows processing raw *.sty files
(normally it avoids this)
--path=dir adds a search path for style files.
--quiet reduces verbosity (can be repeated)
--verbose increases verbosity (can be repeated)
--strict be more strict about errors.
--documentid=id assign an id to the document root.
--debug=package enables debugging output for the
named package
--VERSION show version number and exit.
--help shows this help message.
If texmath is '-', latexml reads the TeX from standard input. If any of the
output files are '-', the result is printed on standard output.
OPTIONS AND ARGUMENTS¶
Conversion Options¶
These options specify what formats the math should be converted to. In each
case, the destination file is given. Except for mathimage, the file can be
given as '-', in which case the result is printed to standard output.
- "--mathimage"=file
- Requests conversion to png images.
- "--magnification="factor
- Specifies the magnification used for math image. Default is
1.75.
- "--presentationmathml"=file
- Requests conversion to Presentation MathML.
- "--linelength"=number
- (Experimental) Line-breaks the generated Presentation
MathML so that it is no longer than number `characters'.
- "--contentmathml"=file
- Requests conversion to Content MathML. Note that
this conversion is only partially implemented.
- "--openmath"=file
- Requests conversion to OpenMath. Note that this
conversion is only partially implemented.
- "--XMath"=file
- Requests convertion to LaTeXML's internal format.
Other Options¶
- "--preload"=module
- Requests the loading of an optional module or package. This
may be useful if the TeX code does not specificly require the module (eg.
through input or usepackage). For example, use
"--preload=LaTeX.pool" to force LaTeX mode.
- "--includestyles"
- This optional allows processing of style files (files with
extensions "sty", "cls", "clo",
"cnf"). By default, these files are ignored unless a latexml
implementation of them is found (with an extension of "ltxml").
These style files generally fall into two classes: Those that merely affect
document style are ignorable in the XML. Others define new markup and
document structure, often using deeper LaTeX macros to achieve their ends.
Although the omission will lead to other errors (missing macro
definitions), it is unlikely that processing the TeX code in the style
file will lead to a correct document.
- "--path"=dir
- Add dir to the search paths used when searching for
files, modules, style files, etc; somewhat like TEXINPUTS. This option can
be repeated.
- "--documentid"=id
- Assigns an ID to the root element of the XML document. This
ID is generally inherited as the prefix of ID's on all other elements
within the document. This is useful when constructing a site of multiple
documents so that all nodes have unique IDs.
- "--quiet"
- Reduces the verbosity of output during processing, used
twice is pretty silent.
- "--verbose"
- Increases the verbosity of output during processing, used
twice is pretty chatty. Can be useful for getting more details when errors
occur.
- "--strict"
- Specifies a strict processing mode. By default, undefined
control sequences and invalid document constructs (that violate the DTD)
give warning messages, but attempt to continue processing. Using --strict
makes them generate fatal errors.
- "--VERSION"
- Shows the version number of the LaTeXML package..
- "--debug"=package
- Enables debugging output for the named package. The package
is given without the leading LaTeXML::.
- "--help"
- Shows this help message.
BUGS¶
This program runs much slower than would seem justified. This is a result of the
relatively slow initialization including loading TeX and LaTeX macros and the
schema. Normally, this cost would be ammortized over large documents, whereas,
in this case, we're processing a single math expression.
SEE ALSO¶
latexml, latexmlpost, LaTeXML