TeXExec

From Wiki
Revision as of 21:35, 31 October 2006 by Adityam (talk | contribs) (→‎Command-Line Options: Changed to wiki marup... There seems to be a bug with partial html markup)
Jump to navigation Jump to search

< 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

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
room for corrections
just graphics
one (cropped) per page
--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
dvipdfm
Mark Wicks' dvi to pdf converter
dvipdfmx 
Jin-Hwan Cho's extended dvipdfm
dvips
Thomas Rokicky's dvi to ps converter
dvipsone 
YandY's dvi to ps converter
dviwindo 
YandY's windows previewer
pdftex
Han The Than's pdf backend
--pages = (even|odd|x,y:z) pages to output. x,y:z: pages x and y to z
--paperformat = AB or A:B or A*B paper input and output format. a4a3: A4 printed on A3, a5a4: A5 printed on A4
--paperoffset = extra offset paper input and output format. a4a3: A4 printed on A3, a5a4: A5 printed on A4
--passon switches to pass to TeX (--src for MikTeX)
--path = string document source path. string: path
--pdf 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)