Difference between revisions of "TeXExec"

From Wiki
Jump to navigation Jump to search
m
 
(18 intermediate revisions by 7 users not shown)
Line 1: Line 1:
−
< [[texexec.ini]] >
+
{{todo|On this page I'd like to see some texexec trickery and explanations. --[[User:Patrick Gundlach|pg]]}}
  
−
{{todo|On this page I'd like to see some texexec trickery and explanations. --[[User:Patrick Gundlach|pg]]}}
+
{{note|This page documents the Perl version of TeXExec, which has (relatively recently) been replaced by a ruby re-implementation}}
  
 
==Command-Line Options==
 
==Command-Line Options==
−
<table>
+
 
−
<tr><td>--alone<td> bypass utilities (e.g. fmtutil for non-standard fmt)
+
{| 
−
<tr><td>--arrange<td> process and arrange
+
| --alone
−
<tr><td>--automprun<td> MetaPost at runtime when needed
+
|  bypass utilities (e.g. fmtutil for non-standard fmt)
−
<tr valign="top"><td>--autopdf<td> Open the pdf viewer after the texexec run. [[#autopdf|See below]].   
+
|-
−
<tr><td>--batch<td> run in batch mode (don't pause)
+
| --arrange
−
<tr><td>--centerpage<td> center the page on the paper
+
|  process and arrange
−
<tr><td>--color<td> enable color (when not yet enabled)
+
|-
−
<tr><td>--environment = name<td> load some environments first. Name is: list of environments
+
| --automprun
−
<tr><td>--fast<td> skip as much as possible
+
|  MetaPost at runtime when needed
−
<tr valign="top"><td>--figures = (a|b|c)<td> typeset figure directory   
+
|-  valign="top"
 +
| --autopdf
 +
|  Open the pdf viewer after the texexec run. [[#autopdf|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
 +
|-  valign="top"
 +
| --figures=(a&#124;b&#124;c)
 +
|  typeset figure directory   
 
; a : room for corrections
 
; a : room for corrections
 
; b : just graphics  
 
; b : just graphics  
 
; c : one (cropped) per page
 
; c : one (cropped) per page
−
<tr><td>--final<td> add a final run without skipping
+
|-
−
<tr><td>--format = name<td> fmt file. name: format file (memory dump)
+
| --final
−
<tr><td>--help<td> show this or more, e.g. '--help interface'
+
|  add a final run without skipping
−
<tr><td>--input = name<td> input file (if used). name: filename
+
|-
−
<tr><td>--interface = (cz|de|en|it|nl|uk)<td> user interface   
+
| --format=name
−
<tr><td>--language = lang<td> main hyphenation language. lang: standard abbreviation
+
|  fmt file. name: format file (memory dump)
−
<tr><td>--listing<td> produce a verbatim listing
+
|-
−
<tr><td>--make<td> build format files
+
| --help
−
<tr><td>--mode = list<td> running mode. list: modes to set
+
|  show this or more, e.g. '--help interface'
−
<tr><td>--module<td> typeset tex/pl/mp module
+
|-
−
<tr><td>--mpformat = name<td> mem file. name: format file (memory dump)
+
| --input=name
−
<tr><td>--mptex<td> run an MetaPost plus btex-etex cycle
+
|  input file (if used). name: filename
−
<tr><td>--mpxtex<td> generatet an MetaPostmpx file
+
|-
−
<tr><td>--noarrange<td> process but ignore arrange
+
| --interface=(cz&#124;de&#124;en&#124;it&#124;nl&#124;uk)
−
<tr><td>--nomp<td> don't run MetaPost at all
+
|  user interface   
−
<tr><td>--nomprun<td> don't run MetaPost at runtime
+
|-
−
<tr><td>--nonstop<td> run in non stop mode (don't pause)
+
| --language=lang
−
<tr><td>--once<td> run TeX only once (no TeXUtil either)
+
|  main hyphenation language. lang: standard abbreviation
−
<tr valign="top"><td>--output<td> specials to use. Can be one of
+
|-
−
{|
+
| --listing
−
| dvipdfm  || Mark Wicks' dvi to pdf converter  
+
|  produce a verbatim listing
−
|-
+
|-
−
| dvipdfmx || Jin-Hwan Cho's extended dvipdfm   
+
| --make
−
|-
+
|  build format files
−
| dvips    || Thomas Rokicky's dvi to ps converter
+
|-
−
|-
+
| --mode=list
−
| dvipsone || YandY's dvi to ps converter  
+
|  running mode. list: modes to set
−
|-
+
|-
−
| dviwindo || YandY's windows previewer  
+
| --module
−
|-
+
|  typeset tex/pl/mp module
−
| pdftex  || Han The Than's pdf backend
+
|-
 +
| --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)
 +
|-  valign="top"
 +
| --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&#124;odd&#124;x,y:z)
 +
|  pages to output. x,y:z: pages x and y to z
 +
|-
 +
| --paperformat=(AB&#124;A:B&#124;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
 +
|-
 +
| --pdfsplit
 +
| split pdf file into pages
 +
|-
 +
| --print=(up&#124;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
 
|}
 
|}
−
<tr><td>--pages = (even|odd|x,y:z)<td> pages to output. x,y:z: pages x and y to z
 
−
<tr><td>--paper = AB<td> paper input and output format.  a4a3: A4 printed on A3, a5a4: A5 printed on A4
 
−
<tr><td>--passon<td> switches to pass to TeX (--src for MikTeX)
 
−
<tr><td>--path = string<td> document source path. string: path
 
−
<tr><td>--pdf<td> produce PDF directly using pdf(e)tex
 
−
<tr><td>--pdfarrange<td> arrange pdf pages
 
−
<tr><td>--pdfcombine<td> combine pages to one page
 
−
<tr><td>--pdfcopy<td> scale pages down/up
 
−
<tr><td>--pdfselect<td> select pdf pages
 
−
<tr><td>--print = (up|down) <td> page imposition scheme.  down = 2 rotated pages per sheet doubleside,  up = 2 pages per sheet doublesided
 
−
<tr><td>--result = filename<td> resulting file will have that filename
 
−
<tr><td>--runs = n<td> maximum number of TeX runs. n: number of runs
 
−
<tr><td>--screensaver<td> turn graphic file into a (pdf) full screen file
 
−
<tr><td>--setfile<td> load environment (batch) file
 
−
<tr><td>--silent<td> minimize (status) messages
 
−
<tr><td>--suffix= string<td> resulting file suffix. string: suffix
 
−
<tr><td>--tex = name<td> TeX binary. name: binary of executable
 
−
<tr><td>--texroot = path<td> root of tex trees. path: tex root
 
−
<tr><td>--textree = path<td> additional texmf tree to be used. path: subpath of tex root
 
−
<tr><td>--texutil<td> force TeXUtil run
 
−
<tr><td>--usemodule = name<td> load some modules first  name: list of modules
 
−
<tr><td>--verbose<td> shows some additional info
 
−
<tr><td>--version<td> display various version information
 
−
<tr><td>--xmlfilter = name<td> apply XML filter.  name: list of filters
 
−
</table>
 
  
 
== Some features explained in detail ==
 
== Some features explained in detail ==
Line 84: Line 192:
  
 
Useful when running texexec from an editor and do not want it to stop for errors.
 
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
 +
 +
<texcode>
 +
\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
 +
</texcode>
 +
 +
So, in the end you get a single pdf with each figure on different page.
 +
 +
= Examples =
 +
 +
== Produce dvi output ==
 +
By default <code>--dvi</code> 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
 +
 +
== Combine two or more PDF files into one file ==
 +
 +
  texexec --pdfcombine --nobanner --result=result.pdf 1.pdf 2.pdf
 +
 +
== Concatenate two or more PDF files into one file ==
 +
 +
  texexec --pdfcopy --result=result.pdf 1.pdf 2.pdf
 +
 +
== Check the status of various scripts ==
 +
 +
  texexec --check
 +
 +
This should give an output like
 +
 +
  TeXExec | current distribution: web2c
 +
  TeXExec | context source date: 2006.10.27 15:16
 +
  TeXExec | format path: E:/isoimage/usr/local/context/tex/texmf-mswin/web2c/unsetengine E:/isoimage/usr/local/context/tex/texmf-mswin/web2c
 +
  TeXExec | start of analysis
 +
  TeXExec | processing document 'texexec'
 +
  TeXExec | tex processing method: context
 +
  TeXExec | writing option file texexec.top
 +
  TeXExec | using randomseed 1306
 +
  TeXExec | tex engine: pdftex
 +
  TeXExec | tex format: cont-en
 +
  TeXExec | progname: context
 +
 +
  This is pdfTeX, Version 3.141592-1.40.0-beta-20060213 (Web2c 7.5.5)
 +
  \write18 enabled.
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/web2c/natural.tcx)
 +
  entering extended mode
 +
  (./texexec.tex
 +
 +
  ConTeXt  ver: 2006.10.27 15:16 MK II  fmt: 2006.10.29  int: english/english
 +
  language        : language en is active
 +
  system          : cont-new loaded
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-new.tex
 +
  systems        : beware: some patches loaded from cont-new.tex
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-new.mkii))
 +
  system          : cont-old loaded
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-old.tex
 +
  loading        : Context Old Macros
 +
  )
 +
  system          : cont-fil loaded
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-fil.tex
 +
  loading        : Context File Synonyms
 +
  )
 +
  system          : cont-sys loaded
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/user/cont-sys.tex)
 +
  bodyfont        : 12pt rm is loaded
 +
  language        : patterns nl->texnansi:texnansi->1->2:3 nl->ec:ec->2->2:3 fr->
 +
  texnansi:texnansi->3->2:3 fr->ec:ec->4->2:3 de->texnansi:texnansi->5->2:3 de->e
 +
  c:ec->6->2:3 it->texnansi:texnansi->7->2:3 it->ec:ec->8->2:3 pt->texnansi:texna
 +
  nsi->9->2:3 pt->ec:ec->10->2:3 hr->ec:ec->11->2:3 pl->pl0:pl0->12->2:3 pl->ec:e
 +
  c->13->2:3 pl->qx:qx->14->2:3 cz->il2:il2->15->2:3 cz->ec:ec->16->2:3 sk->il2:i
 +
  l2->17->2:3 sk->ec:ec->18->2:3 sl->ec:ec->19->2:3 ru->t2a:t2a->21->2:3 en->ec:e
 +
  c->22->2:3 uk->ec:ec->23->2:3 us->ec:ec->24->2:3 agr->agr:agr->25->2:3 da->ec:e
 +
  c->26->2:3 sv->ec:ec->27->2:3 af->ec:ec->28->2:3 no->ec:ec->29->2:3 deo->ec:ec-
 +
  >30->2:3 es->ec:ec->31->2:3 ca->ec:ec->32->2:3 la->ec:ec->33->2:3 ro->ec:ec->34
 +
  ->2:3 tr->ec:ec->35->2:3 fi->ec:ec->37->2:3 hu->ec:ec->38->2:3 loaded
 +
  specials        : tex,postscript,rokicki loaded
 +
  system          : texexec.top loaded
 +
  (./texexec.top
 +
  specials        : loading definition file tpd
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-tpd.tex
 +
  specials        : loading definition file fdf
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-fdf.tex
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-fdf.mkii))
 +
  specials        : fdf loaded
 +
  )
 +
  specials        : fdf,tpd loaded
 +
  )
 +
  systems        : system commands are enabled
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/sort-def.tex)
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/sort-lan.tex)
 +
  systems        : begin file texexec at line 1
 +
  fonts          : resetting map file list
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-empty.map}
 +
  fonts          : using map file: texnansi-public-lm
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/texnans
 +
  i-public-lm.map}
 +
  fonts          : using map file: original-base
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-base.map}
 +
  fonts          : using map file: ec-public-lm
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/ec-publ
 +
  ic-lm.map}
 +
  fonts          : using map file: ec-base
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/ec-base
 +
  .map}
 +
  fonts          : using map file: original-ams-base
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-ams-base.map}
 +
  fonts          : using map file: original-ams-euler
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-ams-euler.map}
 +
  fonts          : using map file: original-public-lm
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-public-lm.map}
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/pdfr-ec.tex)
 +
  [1.1]
 +
  systems        : end file texexec at line 3
 +
  ){e:\isoimage\usr\local\context\tex\texmf/fonts/enc/dvips/lm/lm-ec.enc}<e:\iso
 +
  image\usr\local\context\tex\texmf/fonts/type1/public/lm/lmr12.pfb>
 +
  Output written on texexec.pdf (1 page, 23276 bytes).
 +
  Transcript written on texexec.log.
 +
  TeXExec | runtime: 0.47
 +
 +
  TeXExec | processing document 'texexec'
 +
  TeXExec | tex processing method: context
 +
  TeXExec | writing option file texexec.top
 +
  TeXExec | using randomseed 498
 +
  TeXExec | tex engine: pdftex
 +
  TeXExec | tex format: cont-nl
 +
  TeXExec | progname: context
 +
  This is pdfTeX, Version 3.141592-1.40.0-beta-20060213 (Web2c 7.5.5)
 +
  \write18 enabled.
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/web2c/natural.tcx)
 +
  entering extended mode
 +
  (./texexec.tex
 +
 +
  ConTeXt  ver: 2006.10.27 15:16 MK II  fmt: 2006.10.29  int: dutch/dutch
 +
  taal            : taal nl is actief
 +
  systeem        : cont-new geladen
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-new.tex
 +
  systems        : beware: some patches loaded from cont-new.tex
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-new.mkii))
 +
  systeem        : cont-old geladen
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-old.tex
 +
  loading        : Context Old Macros
 +
  )
 +
  systeem        : cont-fil geladen
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-fil.tex
 +
  loading        : Context File Synonyms
 +
  )
 +
  systeem        : cont-sys geladen
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/user/cont-sys.tex)
 +
  korps          : 12pt rm wordt geladen
 +
  taal            : patronen nl->texnansi:texnansi->1->2:2 nl->ec:ec->2->2:2 fr->
 +
  texnansi:texnansi->3->2:2 fr->ec:ec->4->2:2 de->texnansi:texnansi->5->2:2 de->e
 +
  c:ec->6->2:2 it->texnansi:texnansi->7->2:2 it->ec:ec->8->2:2 pt->texnansi:texna
 +
  nsi->9->2:2 pt->ec:ec->10->2:2 hr->ec:ec->11->2:2 pl->pl0:pl0->12->2:2 pl->ec:e
 +
  c->13->2:2 pl->qx:qx->14->2:2 cz->il2:il2->15->2:2 cz->ec:ec->16->2:2 sk->il2:i
 +
  l2->17->2:2 sk->ec:ec->18->2:2 sl->ec:ec->19->2:2 ru->t2a:t2a->21->2:2 en->ec:e
 +
  c->22->2:2 uk->ec:ec->23->2:2 us->ec:ec->24->2:2 agr->agr:agr->25->2:2 da->ec:e
 +
  c->26->2:2 sv->ec:ec->27->2:2 af->ec:ec->28->2:2 no->ec:ec->29->2:2 deo->ec:ec-
 +
  >30->2:2 es->ec:ec->31->2:2 ca->ec:ec->32->2:2 la->ec:ec->33->2:2 ro->ec:ec->34
 +
  ->2:2 tr->ec:ec->35->2:2 fi->ec:ec->37->2:2 hu->ec:ec->38->2:2 geladen
 +
  specials        : tex,postscript,rokicki geladen
 +
  systeem        : texexec.top geladen
 +
  (./texexec.top
 +
  specials        : definitiefile tpd wordt geladen
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-tpd.tex
 +
  specials        : definitiefile fdf wordt geladen
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-fdf.tex
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-fdf.mkii))
 +
  specials        : fdf geladen
 +
  )
 +
  specials        : fdf,tpd geladen
 +
  )
 +
  systems        : system commands are enabled
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/sort-def.tex)
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/sort-lan.tex)
 +
  systems        : begin file texexec at line 1
 +
  fonts          : resetting map file list
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-empty.map}
 +
  fonts          : using map file: texnansi-public-lm
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/texnans
 +
  i-public-lm.map}
 +
  fonts          : using map file: original-base
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-base.map}
 +
  fonts          : using map file: ec-public-lm
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/ec-publ
 +
  ic-lm.map}
 +
  fonts          : using map file: ec-base
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/ec-base
 +
  .map}
 +
  fonts          : using map file: original-ams-base
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-ams-base.map}
 +
  fonts          : using map file: original-ams-euler
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-ams-euler.map}
 +
  fonts          : using map file: original-public-lm
 +
  {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 +
  l-public-lm.map}
 +
  (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/pdfr-ec.tex)
 +
  [1.1]
 +
  systems        : end file texexec at line 3
 +
  ){e:\isoimage\usr\local\context\tex\texmf/fonts/enc/dvips/lm/lm-ec.enc}<e:\iso
 +
  image\usr\local\context\tex\texmf/fonts/type1/public/lm/lmr12.pfb>
 +
  Output written on texexec.pdf (1 page, 23276 bytes).
 +
  Transcript written on texexec.log.
 +
  TeXExec | runtime: 0.441
 +
  TeXExec | end of analysis
 +
 +
  TeXExec |
 +
  TeXExec | TeXExec | version 6.2.0 - 1997-2006 - PRAGMA ADE/POD
 +
  TeXExec | TeXUtil  | version 9.1.0 - 1997-2005 - PRAGMA ADE/POD
 +
  TeXExec | CtxTools | version 1.3.3 - 2004/2006 - PRAGMA ADE/POD
 +
  TeXExec |
 +
  TeXExec | testing interface en
 +
  TeXExec | pdfTeX Version 3.141592-1.40.0-beta-20060213 (Web2c 7.5.5)
 +
  TeXExec | ConTeXt ver: 2006.10.27 15:16 MK II fmt: 2006.10.29 int: english/english
 +
  TeXExec |
 +
  TeXExec | testing interface nl
 +
  TeXExec | pdfTeX Version 3.141592-1.40.0-beta-20060213 (Web2c 7.5.5)
 +
  TeXExec | ConTeXt ver: 2006.10.27 15:16 MK II fmt: 2006.10.29 int: dutch/dutch
  
 
= TeXTools =
 
= TeXTools =
Line 93: Line 452:
 
with <code>kurier-tex</code> being the new content for your old TEXMF tree (if it were) located under <code>e:\tex\texmf</code> (change folder names accordingly).
 
with <code>kurier-tex</code> being the new content for your old TEXMF tree (if it were) located under <code>e:\tex\texmf</code> (change folder names accordingly).
 
This will tell you what will be updated, merged and deleted (use <code>--force</code> to really do it)
 
This will tell you what will be updated, merged and deleted (use <code>--force</code> to really do it)
 +
 +
[[Category:Old_Content]]

Latest revision as of 18:13, 8 June 2020


 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
a 
room for corrections
b 
just graphics
c 
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
--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

Combine two or more PDF files into one file

 texexec --pdfcombine --nobanner --result=result.pdf 1.pdf 2.pdf

Concatenate two or more PDF files into one file

 texexec --pdfcopy --result=result.pdf 1.pdf 2.pdf

Check the status of various scripts

 texexec --check

This should give an output like 

 TeXExec | current distribution: web2c
 TeXExec | context source date: 2006.10.27 15:16
 TeXExec | format path: E:/isoimage/usr/local/context/tex/texmf-mswin/web2c/unsetengine E:/isoimage/usr/local/context/tex/texmf-mswin/web2c
 TeXExec | start of analysis
 TeXExec | processing document 'texexec'
 TeXExec | tex processing method: context
 TeXExec | writing option file texexec.top
 TeXExec | using randomseed 1306
 TeXExec | tex engine: pdftex
 TeXExec | tex format: cont-en
 TeXExec | progname: context

 This is pdfTeX, Version 3.141592-1.40.0-beta-20060213 (Web2c 7.5.5)
  \write18 enabled.
  (e:\isoimage\usr\local\context\tex\texmf-local/web2c/natural.tcx)
 entering extended mode
 (./texexec.tex

 ConTeXt  ver: 2006.10.27 15:16 MK II  fmt: 2006.10.29  int: english/english
 language        : language en is active
 system          : cont-new loaded
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-new.tex
 systems         : beware: some patches loaded from cont-new.tex
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-new.mkii))
 system          : cont-old loaded
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-old.tex
 loading         : Context Old Macros
 )
 system          : cont-fil loaded
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-fil.tex
 loading         : Context File Synonyms
 )
 system          : cont-sys loaded
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/user/cont-sys.tex)
 bodyfont        : 12pt rm is loaded
 language        : patterns nl->texnansi:texnansi->1->2:3 nl->ec:ec->2->2:3 fr->
 texnansi:texnansi->3->2:3 fr->ec:ec->4->2:3 de->texnansi:texnansi->5->2:3 de->e
 c:ec->6->2:3 it->texnansi:texnansi->7->2:3 it->ec:ec->8->2:3 pt->texnansi:texna
 nsi->9->2:3 pt->ec:ec->10->2:3 hr->ec:ec->11->2:3 pl->pl0:pl0->12->2:3 pl->ec:e
 c->13->2:3 pl->qx:qx->14->2:3 cz->il2:il2->15->2:3 cz->ec:ec->16->2:3 sk->il2:i
 l2->17->2:3 sk->ec:ec->18->2:3 sl->ec:ec->19->2:3 ru->t2a:t2a->21->2:3 en->ec:e
 c->22->2:3 uk->ec:ec->23->2:3 us->ec:ec->24->2:3 agr->agr:agr->25->2:3 da->ec:e
 c->26->2:3 sv->ec:ec->27->2:3 af->ec:ec->28->2:3 no->ec:ec->29->2:3 deo->ec:ec-
 >30->2:3 es->ec:ec->31->2:3 ca->ec:ec->32->2:3 la->ec:ec->33->2:3 ro->ec:ec->34
 ->2:3 tr->ec:ec->35->2:3 fi->ec:ec->37->2:3 hu->ec:ec->38->2:3 loaded
 specials        : tex,postscript,rokicki loaded
 system          : texexec.top loaded
 (./texexec.top
 specials        : loading definition file tpd
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-tpd.tex
 specials        : loading definition file fdf
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-fdf.tex
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-fdf.mkii))
 specials        : fdf loaded
 )
 specials        : fdf,tpd loaded
 )
 systems         : system commands are enabled
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/sort-def.tex)
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/sort-lan.tex)
 systems         : begin file texexec at line 1
 fonts           : resetting map file list
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-empty.map}
 fonts           : using map file: texnansi-public-lm
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/texnans
 i-public-lm.map}
 fonts           : using map file: original-base
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-base.map}
 fonts           : using map file: ec-public-lm
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/ec-publ
 ic-lm.map}
 fonts           : using map file: ec-base
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/ec-base
 .map}
 fonts           : using map file: original-ams-base
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-ams-base.map}
 fonts           : using map file: original-ams-euler
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-ams-euler.map}
 fonts           : using map file: original-public-lm
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-public-lm.map}
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/pdfr-ec.tex)
 [1.1]
 systems         : end file texexec at line 3
  ){e:\isoimage\usr\local\context\tex\texmf/fonts/enc/dvips/lm/lm-ec.enc}<e:\iso
 image\usr\local\context\tex\texmf/fonts/type1/public/lm/lmr12.pfb>
 Output written on texexec.pdf (1 page, 23276 bytes).
 Transcript written on texexec.log.
 TeXExec | runtime: 0.47

 TeXExec | processing document 'texexec'
 TeXExec | tex processing method: context
 TeXExec | writing option file texexec.top
 TeXExec | using randomseed 498
 TeXExec | tex engine: pdftex
 TeXExec | tex format: cont-nl
 TeXExec | progname: context
 This is pdfTeX, Version 3.141592-1.40.0-beta-20060213 (Web2c 7.5.5)
  \write18 enabled.
  (e:\isoimage\usr\local\context\tex\texmf-local/web2c/natural.tcx)
 entering extended mode
 (./texexec.tex

 ConTeXt  ver: 2006.10.27 15:16 MK II  fmt: 2006.10.29  int: dutch/dutch
 taal            : taal nl is actief
 systeem         : cont-new geladen
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-new.tex
 systems         : beware: some patches loaded from cont-new.tex
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-new.mkii))
 systeem         : cont-old geladen
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-old.tex
 loading         : Context Old Macros
 )
 systeem         : cont-fil geladen
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/cont-fil.tex
 loading         : Context File Synonyms
 )
 systeem         : cont-sys geladen
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/user/cont-sys.tex)
 korps           : 12pt rm wordt geladen
 taal            : patronen nl->texnansi:texnansi->1->2:2 nl->ec:ec->2->2:2 fr->
 texnansi:texnansi->3->2:2 fr->ec:ec->4->2:2 de->texnansi:texnansi->5->2:2 de->e
 c:ec->6->2:2 it->texnansi:texnansi->7->2:2 it->ec:ec->8->2:2 pt->texnansi:texna
 nsi->9->2:2 pt->ec:ec->10->2:2 hr->ec:ec->11->2:2 pl->pl0:pl0->12->2:2 pl->ec:e
 c->13->2:2 pl->qx:qx->14->2:2 cz->il2:il2->15->2:2 cz->ec:ec->16->2:2 sk->il2:i
 l2->17->2:2 sk->ec:ec->18->2:2 sl->ec:ec->19->2:2 ru->t2a:t2a->21->2:2 en->ec:e
 c->22->2:2 uk->ec:ec->23->2:2 us->ec:ec->24->2:2 agr->agr:agr->25->2:2 da->ec:e
 c->26->2:2 sv->ec:ec->27->2:2 af->ec:ec->28->2:2 no->ec:ec->29->2:2 deo->ec:ec-
 >30->2:2 es->ec:ec->31->2:2 ca->ec:ec->32->2:2 la->ec:ec->33->2:2 ro->ec:ec->34
 ->2:2 tr->ec:ec->35->2:2 fi->ec:ec->37->2:2 hu->ec:ec->38->2:2 geladen
 specials        : tex,postscript,rokicki geladen
 systeem         : texexec.top geladen
 (./texexec.top
 specials        : definitiefile tpd wordt geladen
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-tpd.tex
 specials        : definitiefile fdf wordt geladen
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-fdf.tex
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/spec-fdf.mkii))
 specials        : fdf geladen
 )
 specials        : fdf,tpd geladen
 )
 systems         : system commands are enabled
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/sort-def.tex)
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/sort-lan.tex)
 systems         : begin file texexec at line 1
 fonts           : resetting map file list
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-empty.map}
 fonts           : using map file: texnansi-public-lm
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/texnans
 i-public-lm.map}
 fonts           : using map file: original-base
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-base.map}
 fonts           : using map file: ec-public-lm
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/ec-publ
 ic-lm.map}
 fonts           : using map file: ec-base
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/ec-base
 .map}
 fonts           : using map file: original-ams-base
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-ams-base.map}
 fonts           : using map file: original-ams-euler
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-ams-euler.map}
 fonts           : using map file: original-public-lm
 {e:\isoimage\usr\local\context\tex\texmf-local/fonts/map/pdftex/context/origina
 l-public-lm.map}
 (e:\isoimage\usr\local\context\tex\texmf-local/tex/context/base/pdfr-ec.tex)
 [1.1]
 systems         : end file texexec at line 3
  ){e:\isoimage\usr\local\context\tex\texmf/fonts/enc/dvips/lm/lm-ec.enc}<e:\iso
 image\usr\local\context\tex\texmf/fonts/type1/public/lm/lmr12.pfb>
 Output written on texexec.pdf (1 page, 23276 bytes).
 Transcript written on texexec.log.
 TeXExec | runtime: 0.441
 TeXExec | end of analysis

 TeXExec | 
 TeXExec | TeXExec | version 6.2.0 - 1997-2006 - PRAGMA ADE/POD
 TeXExec | TeXUtil   | version 9.1.0 - 1997-2005 - PRAGMA ADE/POD
 TeXExec | CtxTools | version 1.3.3 - 2004/2006 - PRAGMA ADE/POD
 TeXExec | 
 TeXExec | testing interface en
 TeXExec | pdfTeX Version 3.141592-1.40.0-beta-20060213 (Web2c 7.5.5)
 TeXExec | ConTeXt ver: 2006.10.27 15:16 MK II fmt: 2006.10.29 int: english/english
 TeXExec | 
 TeXExec | testing interface nl
 TeXExec | pdfTeX Version 3.141592-1.40.0-beta-20060213 (Web2c 7.5.5)
 TeXExec | ConTeXt ver: 2006.10.27 15:16 MK II fmt: 2006.10.29 int: dutch/dutch

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)

Retrieved from "https://wiki.contextgarden.net/index.php?title=TeXExec&oldid=29007"