TeXExec
< 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 |
--pdfsplit | split pdf file into 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.
mpgraphic
texexec --mpgraphic file.mp
creates a temporary tex file, with
\setoutput[pdftex] \setupcolors[state=start] % Some lines for font maps \starttext \startTEXpage \convertMPtoPDF{file.1}{1}{1} \stopTEXpage \startTEXpage \convertMPtoPDF{file.2}{1}{1} \stopTEXpage % etc.... \stoptext
So, in the end you get a single pdf with each figure on different page.
Examples
Produce dvi output
By default --dvi
also produces a ps file. If you just want a dvi file
texexec --dvi test --nobackend
Select n pages from a pdf file
texexec --pdfselect --select=1:5 blabla.pdf
Split pdf file
texexec --pdfsplit somefile.pdf
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)