1LaTeXML::Common::ConfigU(s3e)r Contributed Perl DocumentaLtaiToenXML::Common::Config(3)
2
3
4
6 "LaTeXML::Common::Config" - Configuration logic for LaTeXML
7
9 use LaTeXML::Common::Config;
10 my $config = LaTeXML::Common::Config->new(
11 profile=>'name',
12 timeout=>60,
13 ... );
14 $config->read(\@ARGV);
15 $config->check;
16
17 my $value = $config->get($name);
18 $config->set($name,$value);
19 $config->delete($name);
20 my $bool = $config->exists($name);
21 my @keys = $config->keys;
22 my $options_hashref = $config->options;
23 my $config_clone = $config->clone;
24
26 Configuration management class for LaTeXML options.
27 * Responsible for defining the options interface
28 and parsing the usual Perl command-line options syntax
29 * Provides the intuitive getters, setters, as well as
30 hash methods for manipulating the option values.
31 * Also supports cloning into new configuration objects.
32
33 METHODS
34 "my $config = LaTeXML::Common::Config->new(%options);"
35 Creates a new configuration object. Note that you should try
36 not to provide your own %options hash but rather create an
37 empty
38 configuration and use $config->read to read in the options.
39
40 "$config->read(\@ARGV);"
41 This is the main method for parsing in LaTeXML options.
42 The input array should either be @ARGV, e.g. when the
43 options were provided from the command line using the
44 classic Getopt::Long syntax,
45 or any other array reference that conforms to that setup.
46
47 "$config->check;"
48 Ensures that the configuration obeys the given profile and
49 performs a set of assignments of meaningful defaults
50 (when needed) and normalizations (for relative paths, etc).
51
52 "my $value = $config->get($name);"
53 Classic getter for the $value of an option $name.
54
55 "$config->set($name,$value);"
56 Classic setter for the $value of an option $name.
57
58 "$config->delete($name);"
59 Deletes option $name from the configuration.
60
61 "my $bool = $config->exists($name);"
62 Checks whether the key $name exists in the options hash of the
63 configuration.
64 Similarly to Perl's "exist" for hashes, it returns true even
65 when
66 the option's value is undefined.
67
68 "my @keys = $config->keys;"
69 Similar to "keys %hash" in Perl. Returns an array of all option
70 names.
71
72 "my $options_hashref = $config->options;"
73 Returns the actual hash reference that holds all options within the
74 configuration object.
75
76 "my $config_clone = $config->clone;"
77 Clones $config into a new LaTeXML::Common::Config object,
78 $config_clone.
79
81 latexmlc [options]
82
83 Options:
84 --VERSION show version number.
85 --help shows this help message.
86 --destination=file specifies destination file.
87 --output=file [obsolete synonym for --destination]
88 --preload=module requests loading of an optional module;
89 can be repeated
90 --preamble=file loads a tex file containing document
91 frontmatter. MUST include \begin{document}
92 or equivalent
93 --postamble=file loads a tex file containing document
94 backmatter. MUST include \end{document}
95 or equivalent
96 --includestyles allows latexml to load raw *.sty file;
97 by default it avoids this.
98 --base=dir sets the current working directory
99 --path=dir adds dir to the paths searched for files,
100 modules, etc;
101 --log=file specifies log file (default: STDERR)
102 --autoflush=count Automatically restart the daemon after
103 "count" inputs. Good practice for vast
104 batch jobs. (default: 100)
105 --timeout=secs Timecap for conversions (default 600)
106 --expire=secs Timecap for server inactivity (default 600)
107 --address=URL Specify server address (default: localhost)
108 --port=number Specify server port (default: 3354)
109 --documentid=id assign an id to the document root.
110 --quiet suppress messages (can repeat)
111 --verbose more informative output (can repeat)
112 --strict makes latexml less forgiving of errors
113 --bibtex processes a BibTeX bibliography.
114 --xml requests xml output (default).
115 --tex requests TeX output after expansion.
116 --box requests box output after expansion
117 and digestion.
118 --format=name requests "name" as the output format.
119 Supported: tex,box,xml,html4,html5,xhtml
120 html implies html5
121 --noparse suppresses parsing math (default: off)
122 --parse=name enables parsing math (default: on)
123 and selects parser framework "name".
124 Supported: RecDescent, no
125 --profile=name specify profile as defined in
126 LaTeXML::Common::Config
127 Supported: standard|math|fragment|...
128 (default: standard)
129 --mode=name Alias for profile
130 --cache_key=name Provides a name for the current option set,
131 to enable daemonized conversions without
132 needing re-initializing
133 --whatsin=chunk Defines the provided input chunk,
134 choose from document (default), fragment
135 and formula
136 --whatsout=chunk Defines the expected output chunk,
137 choose from document (default), fragment
138 and formula
139 --post requests a followup post-processing
140 --nopost forbids followup post-processing
141 --validate, --novalidate Enables (the default) or disables
142 validation of the source xml.
143 --omitdoctype omits the Doctype declaration,
144 --noomitdoctype disables the omission (the default)
145 --numbersections enables (the default) the inclusion of
146 section numbers in titles, crossrefs.
147 --nonumbersections disables the above
148 --timestamp provides a timestamp (typically a time and date)
149 to be embedded in the comments
150 --embed requests an embeddable XHTML snippet
151 (requires: --post,--profile=fragment)
152 DEPRECATED: Use --whatsout=fragment
153 TODO: Remove completely
154 --stylesheet specifies a stylesheet,
155 to be used by the post-processor.
156 --css=cssfile adds a css stylesheet to html/xhtml
157 (can be repeated)
158 --nodefaultresources disables processing built-in resources
159 --javscript=jsfile adds a link to a javascript file into
160 html/html5/xhtml (can be repeated)
161 --icon=iconfile specify a file to use as a "favicon"
162 --xsltparameter=name:value passes parameters to the XSLT.
163 --split requests splitting each document
164 --nosplit disables the above (default)
165 --splitat sets level to split the document
166 --splitpath=xpath sets xpath expression to use for
167 splitting (default splits at
168 sections, if splitting is enabled)
169 --splitnaming=(id|idrelative|label|labelrelative) specifies
170 how to name split files (idrelative).
171 --scan scans documents to extract ids,
172 labels, etc.
173 section titles, etc. (default)
174 --noscan disables the above
175 --crossref fills in crossreferences (default)
176 --nocrossref disables the above
177 --urlstyle=(server|negotiated|file) format to use for urls
178 (default server).
179 --navigationtoc=(context|none) generates a table of contents
180 in navigation bar
181 --index requests creating an index (default)
182 --noindex disables the above
183 --splitindex Splits index into pages per initial.
184 --nosplitindex disables the above (default)
185 --permutedindex permutes index phrases in the index
186 --nopermutedindex disables the above (default)
187 --bibliography=file sets a bibliography file
188 --splitbibliography splits the bibliography into pages per
189 initial.
190 --nosplitbibliography disables the above (default)
191 --prescan carries out only the split (if
192 enabled) and scan, storing
193 cross-referencing data in dbfile
194 (default is complete processing)
195 --dbfile=dbfile sets file to store crossreferences
196 --sitedirectory=dir sets the base directory of the site
197 --sourcedirectory=dir sets the base directory of the
198 original TeX source
199 --source=input as an alternative to passing the input as
200 the last argument, after the option set
201 you can also specify it as the value here.
202 useful for predictable API calls
203 --mathimages converts math to images
204 (default for html4 format)
205 --nomathimages disables the above
206 --mathimagemagnification=mag specifies magnification factor
207 --presentationmathml converts math to Presentation MathML
208 (default for xhtml & html5 formats)
209 --pmml alias for --presentationmathml
210 --nopresentationmathml disables the above
211 --linelength=n formats presentation mathml to a
212 linelength max of n characters
213 --contentmathml converts math to Content MathML
214 --nocontentmathml disables the above (default)
215 --cmml alias for --contentmathml
216 --openmath converts math to OpenMath
217 --noopenmath disables the above (default)
218 --om alias for --openmath
219 --keepXMath preserves the intermediate XMath
220 representation (default is to remove)
221 --mathtex adds TeX annotation to parallel markup
222 --nomathtex disables the above (default)
223 --parallelmath use parallel math annotations (default)
224 --noparallelmath disable parallel math annotations
225 --plane1 use plane-1 unicode for symbols
226 (default, if needed)
227 --noplane1 do not use plane-1 unicode
228 --graphicimages converts graphics to images (default)
229 --nographicimages disables the above
230 --graphicsmap=type.type specifies a graphics file mapping
231 --pictureimages converts picture environments to
232 images (default)
233 --nopictureimages disables the above
234 --svg converts picture environments to SVG
235 --nosvg disables the above (default)
236 --nocomments omit comments from the output
237 --inputencoding=enc specify the input encoding.
238 --debug=package enables debugging output for the named
239 package
240
241 If you want to provide a TeX snippet directly on input, rather than
242 supply a filename, use the "literal:" protocol to prefix your snippet.
243
245 General Options
246 "--verbose"
247 Increases the verbosity of output during processing, used twice is
248 pretty chatty.
249 Can be useful for getting more details when errors occur.
250
251 "--quiet"
252 Reduces the verbosity of output during processing, used twice is
253 pretty silent.
254
255 "--VERSION"
256 Shows the version number of the LaTeXML package..
257
258 "--debug"=package
259 Enables debugging output for the named package. The package is
260 given without the leading LaTeXML::.
261
262 "--base"=dir
263 Sepcifies the base working directory for the conversion server.
264 Useful when converting sets of documents that use relative
265 paths.
266
267 "--log"=file
268 Specifies the log file; be default any conversion messages are
269 printed to STDERR.
270
271 "--help"
272 Shows this help message.
273
274 Source Options
275 "--destination"=file
276 Specifies the destination file; by default the XML is written to
277 STDOUT.
278
279 "--preload"=module
280 Requests the loading of an optional module or package. This may be
281 useful if the TeX code
282 does not specificly require the module (eg. through input or
283 usepackage).
284 For example, use "--preload=LaTeX.pool" to force LaTeX mode.
285
286 "--preamble"=file
287 Requests the loading of a tex file with document frontmatter, to be
288 read in before the converted document,
289 but after all --preload entries.
290
291 Note that the given file MUST contain \begin{document} or an
292 equivalent environment start,
293 when processing LaTeX documents.
294
295 If the file does not contain content to appear in the final
296 document, but only macro definitions and
297 setting of internal counters, it is more appropriate to use
298 --preload instead.
299
300 "--postamble"=file
301 Requests the loading of a tex file with document backmatter, to be
302 read in after the converted document.
303
304 Note that the given file MUST contain \end{document} or an
305 equivalent environment end,
306 when processing LaTeX documents.
307
308 "--sourcedirectory"=source
309 Specifies the directory where the original latex source is located.
310 Unless LaTeXML is run from that directory, or it can be determined
311 from the xml filename, it may be necessary to specify this option
312 in order to find graphics and style files.
313
314 "--path"=dir
315 Add dir to the search paths used when searching for files, modules,
316 style files, etc;
317 somewhat like TEXINPUTS. This option can be repeated.
318
319 "--validate", "--novalidate"
320 Enables (or disables) the validation of the source XML document
321 (the default).
322
323 "--bibtex"
324 Forces latexml to treat the file as a BibTeX bibliography.
325 Note that the timing is slightly different than the usual
326 case with BibTeX and LaTeX. In the latter case, BibTeX simply
327 selects and formats a subset of the bibliographic entries; the
328 actual TeX expansion is carried out when the result is included
329 in a LaTeX document. In contrast, latexml processes and
330 expands
331 the entire bibliography; the selection of entries is done
332 during post-processing. This also means that any packages
333 that define macros used in the bibliography must be
334 specified using the "--preload" option.
335
336 "--inputencoding="encoding
337 Specify the input encoding, eg. "--inputencoding=iso-8859-1".
338 The encoding must be one known to Perl's Encode package.
339 Note that this only enables the translation of the input bytes
340 to
341 UTF-8 used internally by LaTeXML, but does not affect catcodes.
342 In such cases, you should be using the inputenc package.
343 Note also that this does not affect the output encoding, which
344 is
345 always UTF-8.
346
347 TeX Conversion Options
348 "--includestyles"
349 This optional allows processing of style files (files with
350 extensions "sty",
351 "cls", "clo", "cnf"). By default, these files are ignored
352 unless a latexml
353 implementation of them is found (with an extension of "ltxml").
354
355 These style files generally fall into two classes: Those
356 that merely affect document style are ignorable in the XML.
357 Others define new markup and document structure, often using
358 deeper LaTeX macros to achieve their ends. Although the
359 omission
360 will lead to other errors (missing macro definitions), it is
361 unlikely that processing the TeX code in the style file will
362 lead to a correct document.
363
364 "--timeout"=secs
365 Set time cap for conversion jobs, in seconds. Any job failing to
366 convert in the
367 time range would return with a Fatal error of timing out.
368 Default value is 600, set to 0 to disable.
369
370 "--nocomments"
371 Normally latexml preserves comments from the source file, and adds
372 a comment every 25 lines as
373 an aid in tracking the source. The option --nocomments
374 discards such comments.
375
376 "--documentid"=id
377 Assigns an ID to the root element of the XML document. This ID is
378 generally
379 inherited as the prefix of ID's on all other elements within
380 the document.
381 This is useful when constructing a site of multiple documents
382 so that
383 all nodes have unique IDs.
384
385 "--strict"
386 Specifies a strict processing mode. By default, undefined control
387 sequences and
388 invalid document constructs (that violate the DTD) give warning
389 messages, but attempt
390 to continue processing. Using "--strict" makes them generate
391 fatal errors.
392
393 "--post"
394 Request post-processing, auto-enabled by any requested post-
395 processor. Disabled by default.
396 If post-processing is enabled, the graphics and cross-
397 referencing processors are on by default.
398
399 Format Options
400 "--format"="(html|html5|html4|xhtml|xml|epub)"
401 Specifies the output format for post processing. By default, it
402 will be guessed from the file extension of the destination (if
403 given), with html implying "html5", xhtml implying "xhtml" and the
404 default being "xml", which you probably don't want.
405
406 The "html5" format converts the material to html5 form with
407 mathematics as MathML; "html5" supports SVG. "html4" format
408 converts the material to the earlier html form, version 4, and the
409 mathematics to png images. "xhtml" format converts to xhtml and
410 uses presentation MathML (after attempting to parse the
411 mathematics) for representing the math. "html5" similarly converts
412 math to presentation MathML. In these cases, any graphics will be
413 converted to web-friendly formats and/or copied to the destination
414 directory. If you simply specify "html", it will treat that as
415 "html5".
416
417 For the default, "xml", the output is left in LaTeXML's internal
418 xml, but the math is parsed and converted to presentation MathML.
419 For html, html5 and xhtml, a default stylesheet is provided, but
420 see the "--stylesheet" option.
421
422 "--xml"
423 Requests XML output; this is the default.
424 DEPRECATED: use --format=xml instead
425
426 "--tex"
427 Requests TeX output for debugging purposes;
428 processing is only carried out through expansion and digestion.
429 This may not be quite valid TeX, since Unicode may be
430 introduced.
431
432 "--box"
433 Requests Box output for debugging purposes;
434 processing is carried out through expansion and digestions,
435 and the result is printed.
436
437 "--profile"
438 Variety of shorthand profiles.
439 Note that the profiles come with a variety of preset options.
440 You can examine any of them in their
441 "resources/Profiles/name.opt"
442 file.
443
444 Example: "latexmlc --profile=math 'literal:1+2=3'"
445
446 "--omitdoctype", "--noomitdoctype"
447 Omits (or includes) the document type declaration. The default is
448 to include it if the document model was based on a DTD.
449
450 "--numbersections", "--nonumbersections"
451 Includes (default), or disables the inclusion of section, equation,
452 etc, numbers in the formatted document and crossreference links.
453
454 "--stylesheet"=xslfile
455 Requests the XSL transformation of the document using the given
456 xslfile as stylesheet. If the stylesheet is omitted, a `standard'
457 one appropriate for the format (html4, html5 or xhtml) will be
458 used.
459
460 "--css"=cssfile
461 Adds cssfile as a css stylesheet to be used in the transformed
462 html/html5/xhtml. Multiple stylesheets can be used; they are
463 included in the html in the order given, following the default
464 "ltx-LaTeXML.css" (unless "--nodefaultcss"). The stylesheet is
465 copied to the destination directory, unless it is an absolute url.
466
467 Some stylesheets included in the distribution are
468 --css=navbar-left Puts a navigation bar on the left.
469 (default omits navbar)
470 --css=navbar-right Puts a navigation bar on the left.
471 --css=theme-blue A blue coloring theme for headings.
472 --css=amsart A style suitable for journal articles.
473
474 "--javascript"=jsfile
475 Includes a link to the javascript file jsfile, to be used in the
476 transformed html/html5/xhtml. Multiple javascript files can be
477 included; they are linked in the html in the order given. The
478 javascript file is copied to the destination directory, unless it
479 is an absolute url.
480
481 "--icon"=iconfile
482 Copies iconfile to the destination directory and sets up the
483 linkage in the transformed html/html5/xhtml to use that as the
484 "favicon".
485
486 "--nodefaultresources"
487 Disables the copying and inclusion of resources added by the
488 binding files; This includes CSS, javascript or other files. This
489 does not affect resources explicitly requested by the "--css" or
490 "--javascript" options.
491
492 "--timestamp"=timestamp
493 Provides a timestamp (typically a time and date) to be embedded in
494 the comments by the stock XSLT stylesheets. If you don't supply a
495 timestamp, the current time and date will be used. (You can use
496 "--timestamp=0" to omit the timestamp).
497
498 "--xsltparameter"=name:value
499 Passes parameters to the XSLT stylesheet. See the manual or the
500 stylesheet itself for available parameters.
501
502 Site & Crossreferencing Options
503 "--split", "--nosplit"
504 Enables or disables (default) the splitting of documents into
505 multiple `pages'. If enabled, the the document will be split into
506 sections, bibliography, index and appendices (if any) by default,
507 unless "--splitpath" is specified.
508
509 "--splitat="unit
510 Specifies what level of the document to split at. Should be one of
511 "chapter", "section" (the default), "subsection" or
512 "subsubsection". For more control, see "--splitpath".
513
514 "--splitpath="xpath
515 Specifies an XPath expression to select nodes that will generate
516 separate pages. The default splitpath is
517 //ltx:section | //ltx:bibliography | //ltx:appendix | //ltx:index
518
519 Specifying
520
521 --splitpath="//ltx:section | //ltx:subsection
522 | //ltx:bibliography | //ltx:appendix | //ltx:index"
523
524 would split the document at subsections as well as sections.
525
526 "--splitnaming"="(id|idrelative|label|labelrelative)"
527 Specifies how to name the files for subdocuments created by
528 splitting. The values "id" and "label" simply use the id or label
529 of the subdocument's root node for it's filename. "idrelative" and
530 "labelrelative" use the portion of the id or label that follows the
531 parent document's id or label. Furthermore, to impose structure and
532 uniqueness, if a split document has children that are also split,
533 that document (and it's children) will be in a separate
534 subdirectory with the name index.
535
536 "--scan", "--noscan"
537 Enables (default) or disables the scanning of documents for ids,
538 labels, references, indexmarks, etc, for use in filling in refs,
539 cites, index and so on. It may be useful to disable when
540 generating documents not based on the LaTeXML doctype.
541
542 "--crossref", "--nocrossref"
543 Enables (default) or disables the filling in of references, hrefs,
544 etc based on a previous scan (either from "--scan", or "--dbfile")
545 It may be useful to disable when generating documents not based on
546 the LaTeXML doctype.
547
548 "--urlstyle"="(server|negotiated|file)"
549 This option determines the way that URLs within the documents are
550 formatted, depending on the way they are intended to be served.
551 The default, "server", eliminates unneccessary trailing
552 "index.html". With "negotiated", the trailing file extension
553 (typically "html" or "xhtml") are eliminated. The scheme "file"
554 preserves complete (but relative) urls so that the site can be
555 browsed as files without any server.
556
557 "--navigationtoc"="(context|none)"
558 Generates a table of contents in the navigation bar; default is
559 "none". The `context' style of TOC, is somewhat verbose and
560 reveals more detail near the current page; it is most suitable for
561 navigation bars placed on the left or right. Other styles of TOC
562 should be developed and added here, such as a short form.
563
564 "--index", "--noindex"
565 Enables (default) or disables the generation of an index from
566 indexmarks embedded within the document. Enabling this has no
567 effect unless there is an index element in the document (generated
568 by \printindex).
569
570 "--splitindex", "--nosplitindex"
571 Enables or disables (default) the splitting of generated indexes
572 into separate pages per initial letter.
573
574 "--bibliography="pathname
575 Specifies a bibliography generated from a BibTeX file to be used to
576 fill in a bibliography element. Hand-written bibliographies placed
577 in a "thebibliography" environment do not need this. The option
578 has no effect unless there is an bibliography element in the
579 document (generated by \bibliography).
580
581 Note that this option provides the bibliography to be used to fill
582 in the bibliography element (generated by "\bibliography");
583 latexmlpost does not (currently) directly process and format such a
584 bibliography.
585
586 "--splitbibliography", "--nosplitbibliography"
587 Enables or disables (default) the splitting of generated
588 bibliographies into separate pages per initial letter.
589
590 "--prescan"
591 By default "latexmlpost" processes a single document into one (or
592 more; see "--split") destination files in a single pass. When
593 generating a complicated site consisting of several documents it
594 may be advantageous to first scan through the documents to extract
595 and store (in "dbfile") cross-referencing data (such as ids,
596 titles, urls, and so on). A later pass then has complete
597 information allowing all documents to reference each other, and
598 also constructs an index and bibliography that reflects the entire
599 document set. The same effect (though less efficient) can be
600 achieved by running "latexmlpost" twice, provided a "dbfile" is
601 specified.
602
603 "--dbfile"=file
604 Specifies a filename to use for the crossreferencing data when
605 using two-pass processing. This file may reside in the
606 intermediate destination directory.
607
608 "--sitedirectory="dir
609 Specifies the base directory of the overall web site. Pathnames in
610 the database are stored in a form relative to this directory to
611 make it more portable.
612
613 "--embed"
614 TODO: Deprecated, use --whatsout=fragment Requests an embeddable
615 XHTML div (requires: --post --format=xhtml),
616 respectively the top division of the document's body.
617 Caveat: This experimental mode is enabled only for fragment
618 profile and post-processed
619 documents (to XHTML).
620
621 Math Options
622 These options specify how math should be converted into other formats.
623 Multiple formats can be requested; how they will be combined depends on
624 the format and other options.
625
626 "--noparse"
627 Suppresses parsing math (default: parsing is on)
628
629 "--parse=name"
630 Enables parsing math (default: parsing is on)
631 and selects parser framework "name".
632 Supported: RecDescent, no
633 Tip: --parse=no is equivalent to --noparse
634
635 "--mathimages", "--nomathimages"
636 Requests or disables the conversion of math to images (png by
637 default). Conversion is the default for html4 format.
638
639 "--mathsvg", "--nomathsvg"
640 Requests or disables the conversion of math to svg images.
641
642 "--mathimagemagnification="factor
643 Specifies the magnification used for math images (both png and
644 svg), if they are made. Default is 1.75.
645
646 "--presentationmathml", "--nopresentationmathml"
647 Requests or disables conversion of math to Presentation MathML.
648 Conversion is the default for xhtml and html5 formats.
649
650 "--linelength"=number
651 (Experimental) Line-breaks the generated Presentation MathML so
652 that it is no longer than number `characters'.
653
654 "--plane1"
655 Converts the content of Presentation MathML token elements to the
656 appropriate Unicode Plane-1 codepoints according to the selected
657 font, when applicable (the default).
658
659 "--hackplane1"
660 Converts the content of Presentation MathML token elements to the
661 appropriate Unicode Plane-1 codepoints according to the selected
662 font, but only for the mathvariants double-struck, fraktur and
663 script. This gives support for current (as of August 2009)
664 versions of Firefox and MathPlayer, provided a sufficient set of
665 fonts is available (eg. STIX).
666
667 "--contentmathml", "--nocontentmathml"
668 Requests or disables conversion of math to Content MathML.
669 Conversion is disabled by default. Note that this conversion is
670 only partially implemented.
671
672 "--openmath"
673 Requests or disables conversion of math to OpenMath. Conversion is
674 disabled by default. Note that this conversion is only partially
675 implemented.
676
677 "--keepXMath", "--xmath"
678 By default, when any of the MathML or OpenMath conversions are
679 used, the intermediate math representation will be removed; this
680 option preserves it; it will be used as secondary parallel markup,
681 when it follows the options for other math representations.
682
683 Graphics Options
684 "--graphicimages", "--nographicimages"
685 Enables (default) or disables the conversion of graphics to web-
686 appropriate format (png).
687
688 "--graphicsmap="sourcetype.desttype
689 Specifies a mapping of graphics file types. Typically, graphics
690 elements specify a graphics file that will be converted to a more
691 appropriate file target format; for example, postscript files used
692 for graphics with LaTeX will be converted to png format for use on
693 the web. As with LaTeX, when a graphics file is specified without
694 a file type, the system will search for the most appropriate target
695 type file.
696
697 When this option is used, it overrides and replaces the defaults
698 and provides a mapping of sourcetype to desttype. The option can
699 be repeated to provide several mappings, with the earlier formats
700 preferred. If the desttype is omitted, it specifies copying files
701 of type sourcetype, unchanged.
702
703 The default settings is equivalent to having supplied the options:
704 svg png gif jpg jpeg eps.png ps.png ai.png pdf.png
705
706 The first formats are preferred and used unchanged, while the
707 latter ones are converted to png.
708
709 "--pictureimages", "--nopictureimages"
710 Enables (default) or disables the conversion of picture
711 environments and pstricks material into images.
712
713 "--svg", "--nosvg"
714 Enables or disables (default) the conversion of picture
715 environments and pstricks material to SVG.
716
717 Daemon, Server and Client Options
718 Options used only for daemonized conversions, e.g. talking to a remote
719 server via latexmlc, or local processing via the
720 "LaTeXML::Plugin::latexmls" plugin.
721
722 For reliable communication and a stable conversion experience, invoke
723 latexmls only through the latexmlc client (you need to set --expire to
724 a positive value, in order to request auto-spawning of a dedicated
725 conversion server).
726
727 "--autoflush"=count
728 Automatically restart the daemon after converting "count" inputs.
729 Good practice for vast batch jobs. (default: 100)
730
731 "--expire"=secs
732 Set an inactivity timeout value in seconds.
733 If the server process is not given any input for the specified
734 duration,
735 it will automatically terminate.
736 The default value is 600 seconds, set to 0 to never expire,
737 -1 to entirely opt out of using an independent server.
738
739 "--address"=URL
740 Specify server address (default: localhost)
741
742 "--port"=number
743 Specify server port (default: 3334 for math, 3344 for fragment and
744 3354 for standard)
745
747 Bruce Miller <bruce.miller@nist.gov> Deyan Ginev <deyan.ginev@nist.gov>
748
750 Public domain software, produced as part of work done by the United
751 States Government & not subject to copyright in the US.
752
753
754
755perl v5.32.0 2020-11-17 LaTeXML::Common::Config(3)