Difference between revisions of "TeXExec"
m (→Command-Line Options: Changed to wiki marup... There seems to be a bug with partial html markup) |
m (→Command-Line Options: Removed spaces around =) |
||
Line 29: | Line 29: | ||
| enable color (when not yet enabled) | | enable color (when not yet enabled) | ||
|- | |- | ||
− | | --environment = name | + | | --environment=name |
| load some environments first. Name is: list of environments | | load some environments first. Name is: list of environments | ||
|- | |- | ||
Line 35: | Line 35: | ||
| skip as much as possible | | skip as much as possible | ||
|- valign="top" | |- valign="top" | ||
− | | --figures = (a|b|c) | + | | --figures=(a|b|c) |
| typeset figure directory | | typeset figure directory | ||
; a : room for corrections | ; a : room for corrections | ||
Line 44: | Line 44: | ||
| add a final run without skipping | | add a final run without skipping | ||
|- | |- | ||
− | | --format = name | + | | --format=name |
| fmt file. name: format file (memory dump) | | fmt file. name: format file (memory dump) | ||
|- | |- | ||
Line 50: | Line 50: | ||
| show this or more, e.g. '--help interface' | | show this or more, e.g. '--help interface' | ||
|- | |- | ||
− | | --input = name | + | | --input=name |
| input file (if used). name: filename | | input file (if used). name: filename | ||
|- | |- | ||
− | | --interface = (cz|de|en|it|nl|uk) | + | | --interface=(cz|de|en|it|nl|uk) |
| user interface | | user interface | ||
|- | |- | ||
− | | --language = lang | + | | --language=lang |
| main hyphenation language. lang: standard abbreviation | | main hyphenation language. lang: standard abbreviation | ||
|- | |- | ||
Line 65: | Line 65: | ||
| build format files | | build format files | ||
|- | |- | ||
− | | --mode = list | + | | --mode=list |
| running mode. list: modes to set | | running mode. list: modes to set | ||
|- | |- | ||
Line 74: | Line 74: | ||
| process mp file to stand-alone graphics | | process mp file to stand-alone graphics | ||
|- | |- | ||
− | | --mpformat = name | + | | --mpformat=name |
| mem file. name: format file (memory dump) | | mem file. name: format file (memory dump) | ||
|- | |- | ||
Line 107: | Line 107: | ||
; pdftex : Han The Than's pdf backend | ; pdftex : Han The Than's pdf backend | ||
|- | |- | ||
− | | --pages = (even|odd|x,y:z) | + | | --pages=(even|odd|x,y:z) |
| pages to output. x,y:z: pages x and y to z | | pages to output. x,y:z: pages x and y to z | ||
|- | |- | ||
− | | --paperformat = AB | + | | --paperformat=(AB|A:B|A*B) |
| paper input and output format. a4a3: A4 printed on A3, a5a4: A5 printed on A4 | | paper input and output format. a4a3: A4 printed on A3, a5a4: A5 printed on A4 | ||
|- | |- | ||
− | | --paperoffset = | + | | --paperoffset=dim |
− | | | + | | extra offset |
|- | |- | ||
| --passon | | --passon | ||
| switches to pass to TeX (--src for MikTeX) | | switches to pass to TeX (--src for MikTeX) | ||
|- | |- | ||
− | | --path = string | + | | --path=string |
| document source path. string: path | | document source path. string: path | ||
|- | |- | ||
Line 137: | Line 137: | ||
| select pdf pages | | select pdf pages | ||
|- | |- | ||
− | | --print = (up|down) | + | | --print=(up|down) |
− | | page imposition scheme. down = 2 rotated pages per sheet doubleside, up = 2 pages per sheet doublesided | + | | page imposition scheme. down=2 rotated pages per sheet doubleside, up=2 pages per sheet doublesided |
|- | |- | ||
− | | --result = filename | + | | --result=filename |
| resulting file will have that filename | | resulting file will have that filename | ||
|- | |- | ||
− | | --runs = n | + | | --runs=n |
| maximum number of TeX runs. n: number of runs | | maximum number of TeX runs. n: number of runs | ||
|- | |- | ||
Line 155: | Line 155: | ||
| minimize (status) messages | | minimize (status) messages | ||
|- | |- | ||
− | | --suffix= string | + | | --suffix=string |
| resulting file suffix. string: suffix | | resulting file suffix. string: suffix | ||
|- | |- | ||
− | | --tex = name | + | | --tex=name |
| TeX binary. name: binary of executable | | TeX binary. name: binary of executable | ||
|- | |- | ||
− | | --texroot = path | + | | --texroot=path |
| root of tex trees. path: tex root | | root of tex trees. path: tex root | ||
|- | |- | ||
− | | --textree = path | + | | --textree=path |
| additional texmf tree to be used. path: subpath of tex root | | additional texmf tree to be used. path: subpath of tex root | ||
|- | |- | ||
Line 170: | Line 170: | ||
| force TeXUtil run | | force TeXUtil run | ||
|- | |- | ||
− | | --usemodule = name | + | | --usemodule=name |
| load some modules first name: list of modules | | load some modules first name: list of modules | ||
|- | |- | ||
Line 179: | Line 179: | ||
| display various version information | | display various version information | ||
|- | |- | ||
− | | --xmlfilter = name | + | | --xmlfilter=name |
| apply XML filter. name: list of filters | | apply XML filter. name: list of filters | ||
|} | |} |
Revision as of 21:39, 31 October 2006
< texexec.ini >
TODO: On this page I'd like to see some texexec trickery and explanations. --pg (See: To-Do List) |
NOTE: This page documents the Perl version of TeXExec, which has (relatively recently) been replaced by a ruby re-implementation |
Contents
Command-Line Options
--alone | bypass utilities (e.g. fmtutil for non-standard fmt) |
--arrange | process and arrange |
--automprun | MetaPost at runtime when needed |
--autopdf | Open the pdf viewer after the texexec run. See below. |
--batch | run in batch mode (don't pause) |
--centerpage | center the page on the paper |
--color | enable color (when not yet enabled) |
--environment=name | load some environments first. Name is: list of environments |
--fast | skip as much as possible |
--figures=(a|b|c) | typeset figure directory
|
--final | add a final run without skipping |
--format=name | fmt file. name: format file (memory dump) |
--help | show this or more, e.g. '--help interface' |
--input=name | input file (if used). name: filename |
--interface=(cz|de|en|it|nl|uk) | user interface |
--language=lang | main hyphenation language. lang: standard abbreviation |
--listing | produce a verbatim listing |
--make | build format files |
--mode=list | running mode. list: modes to set |
--module | typeset tex/pl/mp module |
--mpgraphic | process mp file to stand-alone graphics |
--mpformat=name | mem file. name: format file (memory dump) |
--mptex | run an MetaPost plus btex-etex cycle |
--mpxtex | generatet an MetaPostmpx file |
--noarrange | process but ignore arrange |
--nomp | don't run MetaPost at all |
--nomprun | don't run MetaPost at runtime |
--nonstop | run in non stop mode (don't pause) |
--once | run TeX only once (no TeXUtil either) |
--output | specials to use. Can be one of
|
--pages=(even|odd|x,y:z) | pages to output. x,y:z: pages x and y to z |
--paperformat=(AB|A:B|A*B) | paper input and output format. a4a3: A4 printed on A3, a5a4: A5 printed on A4 |
--paperoffset=dim | extra offset |
--passon | switches to pass to TeX (--src for MikTeX) |
--path=string | document source path. string: path |
produce PDF directly using pdf(e)tex | |
--pdfarrange | arrange pdf pages |
--pdfcombine | combine pages to one page |
--pdfcopy | scale pages down/up |
--pdfselect | select pdf pages |
--print=(up|down) | page imposition scheme. down=2 rotated pages per sheet doubleside, up=2 pages per sheet doublesided |
--result=filename | resulting file will have that filename |
--runs=n | maximum number of TeX runs. n: number of runs |
--screensaver | turn graphic file into a (pdf) full screen file |
--setfile | load environment (batch) file |
--silent | minimize (status) messages |
--suffix=string | resulting file suffix. string: suffix |
--tex=name | TeX binary. name: binary of executable |
--texroot=path | root of tex trees. path: tex root |
--textree=path | additional texmf tree to be used. path: subpath of tex root |
--texutil | force TeXUtil run |
--usemodule=name | load some modules first name: list of modules |
--verbose | shows some additional info |
--version | display various version information |
--xmlfilter=name | apply XML filter. name: list of filters |
Some features explained in detail
autopdf
Currently works only on Windows and Linux. On Mac OS X there is no way to do this for Acrobat Reader 7.0 and Preview.app in a sophisticated way (= keep view), since they are not (apple-)scriptable. You can use TeXniscope, TeXshop or iTeXMac that does that automatically.
nonstopmode
Useful when running texexec from an editor and do not want it to stop for errors.
TeXTools
(should be moved on a separate page, but it's stil almost empty anyway)
To update your TeX tree to the most recent version of kurier fonts for example, you can use
textools --updatetree kurier-tex e:\tex\texmf
with kurier-tex
being the new content for your old TEXMF tree (if it were) located under e:\tex\texmf
(change folder names accordingly).
This will tell you what will be updated, merged and deleted (use --force
to really do it)