Difference between revisions of "TeXExec"

From Wiki
Jump to navigation Jump to search
m (→‎mpgraphic: typo)
Line 194: Line 194:
 
=== mpgraphic ===
 
=== mpgraphic ===
  
: texexec --mpgraphic file.mp
+
texexec --mpgraphic file.mp
  
 
creates a temporary tex file, with
 
creates a temporary tex file, with

Revision as of 21:42, 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

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|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
--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.

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.

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)