GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LATEXML (1)

.ds Aq ’

NAME

"latexml" - transforms a TeX/LaTeX file into XML.

CONTENTS

SYNOPSIS

latexml [options] texfile



 Options:
 --destination=file sets destination file (default stdout).
 --output=file      [obsolete synonym for --destination]
 --preload=module   requests loading of an optional module;
                    can be repeated
 --preamble=file    sets a preamble file which will
                    effectively be prepended to the main file.
 --postamble=file   sets a postamble file which will
                    effectively be appended to the main file.
 --includestyles    allows latexml to load raw *.sty file;
                    by default it avoids this.
 --path=dir         adds to the paths searched for files,
                    modules, etc;
 --documentid=id    assign an id to the document root.
 --quiet            suppress messages (can repeat)
 --verbose          more informative output (can repeat)
 --strict           makes latexml less forgiving of errors
 --bibtex           processes as a BibTeX bibliography.
 --xml              requests xml output (default).
 --tex              requests TeX output after expansion.
 --box              requests box output after expansion
                    and digestion.
 --noparse          suppresses parsing math
 --nocomments       omit comments from the output
 --inputencoding=enc specify the input encoding.
 --VERSION          show version number.
 --debug=package    enables debugging output for the named
                    package
 --help             shows this help message.



If texfile is ’-’, latexml reads the TeX source from standard input. If texfile has an explicit extention of .bib, it is processed as a BibTeX bibliography.

OPTIONS AND ARGUMENTS

--destination=file Specifies the destination file; by default the XML is written to stdout.
--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.
--preamble=file, --postamble=file Specifies a file whose contents will effectively be prepended or appended to the main document file’s content. This can be useful when processing TeX fragments, in which case the preamble would contain documentclass and begindocument control sequences. This option is not used when processing BibTeX files.
--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.
--bibtex Forces latexml to treat the file as a BibTeX bibliography. Note that the timing is slightly different than the usual case with BibTeX and LaTeX. In the latter case, BibTeX simply selects and formats a subset of the bibliographic entries; the actual TeX expansion is carried out when the result is included in a LaTeX document. In contrast, latexml processes and expands the entire bibliography; the selection of entries is done during postprocessing. This also means that any packages that define macros used in the bibliography must be specified using the --preload option.
--xml Requests XML output; this is the default.
--tex Requests TeX output for debugging purposes; processing is only carried out through expansion and digestion. This may not be quite valid TeX, since Unicode may be introduced.
--box Requests Box output for debugging purposes; processing is carried out through expansion and digestions, and the result is printed.
--nocomments Normally latexml preserves comments from the source file, and adds a comment every 25 lines as an aid in tracking the source. The option --nocomments discards such comments.
--inputencoding=encoding Specify the input encoding, eg. --inputencoding=iso-8859-1. The encoding must be one known to Perl’s Encode package. Note that this only enables the translation of the input bytes to UTF-8 used internally by LaTeXML, but does not affect catcodes. It is usually better to use LaTeX’s inputenc package. Note that this does not affect the output encoding, which is always UTF-8.
--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.

SEE ALSO

latexmlpost, latexmlmath, LaTeXML
Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 LATEXML (1) 2014-12-04

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.