Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
texexec(1)
Edit
PageHistory
Diff
Info
LikePages
texexec !!!texexec NAME SYNOPSIS DESCRIPTION OPTIONS General Options Processing !ConTeXt Source Files Creating !ConTeXt Format Files Postprocess PDF Files Extract or Strip Out Documentation Process METAPOST Figures Producing Proof Sheets of Figures USAGE INITIALIZATION ENCODINGS FILES SEE ALSO AUTHOR ---- !!NAME texexec - !ConTeXt and PDF auxiliary program and batch processor !!SYNOPSIS __texexec__ [[ ''OPTION'' ... ] ''FILE'' [[ ... ] !!DESCRIPTION __texexec__ is a Perl script that provides several functions: o Process a TeX file. This includes performing as many runs as necessary of tex(1), texutil(1), and metapost(1). Options allow you to select the output format, the pages to process, paper size, and so forth. o Create new !ConTeXt formats (with __--format__). o Post-process existing PDF files, including merging multiple files, and extracting and rearranging pages within a file (similar to the functions provided by psnup(1) and pdfmerge(1)). o Extract or strip documentation from com{!ConTeXt} source files (using texutil(1)). o Run METAPOST (mpost(1)) to generate figures from METAPOST source. o Produce ``proof sheets of figures used in a __!ConTeXt__ source file. !!OPTIONS All switches are specified in full, but can be abbreviated to the shortest unique string. Thus, __--ver__ works the same as __--verbose__. !!General Options __--alone__ Avoid calling other programs when possible. For example, __--alone__ will prevent __texexec__ from using fmtutil(1) to generate formats (which can be handy when tracing installation problems). __--environment=__''ENVIRONMENT'' Specify a !ConTeXt ''ENVIRONMENT'' to use when processing the file. This option can be useful when converting from non-!ConTeXt file formats where no environment or layout settings are present in the file. __--help__ [[ ''SWITCH'' ] Produce a summary of switches and arguments. Many switches have additional information that can be seen by typing ``texexec --help optvar(SWITCH). __--interface=__''LANGUAGE'' Specify the language __!ConTeXt__ should use to communicate with you. Options are __en__ US English __nl__ Dutch __de__ German __uk__ British English __cz__ Czech __it__ Italian __--once__ Process a file once and only once. (By default, __texexec__ processes the file as many times as necessary to sort out all references, typeset __METAPOST__ code, and so forth.) __--output=__''DRIVER'' Specify the output ''DRIVER'' for use with special primitives. Defaults to the setting in the local ''cont-sys.tex'' file, but can be set to one of __pdftex__ Native pdftex(1) code __dvips__ For dvips(1) (the default) __dvipsone__ For __dvipsone__ __dviwindo__ For __dviwindo__, the oldest __!ConTeXt__ drivers __dviview__ For __dviview__ (experimental) There may be other supported drivers -- check the most recent __!ConTeXt__ documentation. __--pages=__''PAGENUMBERLIST'' Specify the pages or page range to appear in the output file. ''PAGENUMBERLIST'' may be the keyword __odd__ or __even__; one or more pages separated by commas (x,y); or a page range in the form :z. __--passon=__''STRING'' Pass additional command-line switches and arguments to the tex(1) process run by __texexec__. For example, the __MikTeX__ TeX system (for DOS/Windows) can embed information in the DVI file that will allow you to find the line in a source code file corresponding to the line in the typeset output. It uses a switch called ``--src to activate this functionality, and can be used from __texexec__ as texexec --passon= The double quotes () are required to prevent __texexec__ from using the switch itself. __--program__ The name of the TeX program to use (tex(1), by default). __--result=__''FILENAME'' Allows you to change the basename of the output file. See __--mode__ for an example. __--runs=__''NUMBER'' Specify the number of runs to perform on a file. Overrides __texexec__s calculations. __--silent__ Suppress diagnostic and progress messages. __--suffix=__''SUFFIX'' Specify the suffix of the output file. __--tex=__''PROGRAMNAME'' Allows you specify the program to use instead of tex(1). Useful for trying different versions of tex(1) installed on the same machine. __--texutil__ Force a run of texutil(1). __--verbose__ Output diagnostic information, including the contents of ''texexec.ini''. !!Processing !ConTeXt Source Files Including specifying paper sizes, formats, and so forth. __--arrange__ Dont perform page rearrangements (e.g., for producing a booklet) until the last run. __--batch__ Process the file in batch mode -- continue to typeset the document after finding errors. More imformation about batch mode can be found in Donald E. Knuths ''!TeXbook''. __--bodyfont__ The name of a font to preload for use in setting the body of the text. __--centerpage__ Center the document image on the page. __--color__ Turn on color mode. Color mode can also be set by commands embedded in the document. These commands override the __--color__ option. __--convert=__''FORMAT'' Convert the input file to !ConTeXt format from ''FORMAT'' before processing. In most cases, this conversion will result in a TeX file. Currently supported input ''FORMAT''s are __xml__ and __sgml__. __--dvi__ Shortcut for __--output=dvi__. __--fast__ Typeset the document(s) as fast as possible without causing problems. __--final__ Perform a final run without skipping anything. This option is typically used with __--fast__. __--language=__''LANGUAGE'' Set the language for hyphenation. Can be specified in your source file. Options are the same as those for __--interface__. __--mode=__''MODELIST'' Allows you to change the mode (page size and resolution) of the output file. texexec --pdf --mode=A4 --result=pdftex-a pdftex-t texexec --pdf --mode=letter --result=pdftex-l pdftex-t texexec --pdf --mode=screen --result=pdftex-s pdftex-t Here the mode switch tells __!ConTeXt__ to obey the mode directives in the layout specifications. The __--result__ flag allows you to rename the output file. __--noarrange__ Ignore arrangement commands in the source file. __--paper=__''KEY'' For typesetting multiple pages on a single piece of paper. ''KEY'' can be __a4a3__ (for printing A4 pages on A3 paper) or __a5a4__ (for printing A5 pages on A4 paper). The actual layout of the pages is specified with the __--print__ switch. __--pdf__ Shorthand for __--output=pdftex__. __--print=__''KEY'' Specify the layout of the final output. ''KEY'' can be __up__, resulting in 2 pages per sheet, double sided, or __down__, resulting in 2 rotated pages per sheet, double sided. Use the --paper switch to specify the original page and sheet size. !!Creating !ConTeXt Format Files __--format=__''FORMATFILE'' Specify a ''FORMATFILE'' to use when typesetting. __texexec__ will prepend the string cont- to the name you give, so you can type plain instead of cont-plain, as in texexec --format=plain --program=pdftex somefile __--make__ Generate a __!ConTeXt__ format file. !!Postprocess PDF Files __--combination=__''ROWS''__*__''COLS'' Specify the number of pages to show on a single page. Use with __--pdfcombine__. __--pdfarrange__ For rearranging pages in PDF files. texexec --pdfarrange --paper=a5a4 --print=up foo.pdf This command creates an A5 booklet from a PDF file ''foo.pdf''. __--pdfarrange__ is used in conjunction with the following switches: __--paperoffset__ Adjust the space between the edge of the pages and the beginning of the text block. __--backspace__ Adjust the inside (``gutter) margins. __--topspace__ Adjust the top and bottom margin. __--markings__ Add crop marks. __--addempty=__''PAGES'' Add empty pages after the pages specified in ''PAGES''. (Useful for, among other things, adding blank pages after a table of contents.) __--textwidth=__''WIDTH'' Set the width of the original text. Specifying this parameter with a single-sided original will allow __!ConTeXt__ to adjust the page layout for double-sided output, producing much more attractive results. With the __--pdfarrange__ flag, specifying more than one file will result in all of the files being combined in the final result, allowing you to add title pages, decorated part separators, and so forth. You can also do more complex manipulations, such as adding additional text to the page by setting up a small file with layout definitions and a simple figure insertion loop. __--pdfcombine__ Combine multiple pages. Requires you to specify the __--combination__ switch. __--pdfselect__ Extract pages from a file. Use in combination with the __--selection__ switch, as in texexec --pdfselect --paper=S6 --selection=1,9,14 file-1 which extracts pages 1, 9, and 14 from ''file-1.pdf'', and places them in ''texexec.pdf'' (the default output filename if an output file isnt specified). See __--pdfarrange__ for other options. __--selection=__''PAGES'' Specify pages to be affected by another option. See __--pdfarrange__ and __--pdfselect__ for examples. !!Extract or Strip Out Documentation __--listing__ Produce a typeset version of the source code in ''FILE''. You can specify the form of the output file, as in texexec --listing --pdf readme.now which will produce a PDF file called ''texexec.pdf''. Without the __--pdf__ flag, __texexec__ will produce a DVI file. See also __--backspace__ and __--topspace__. __--module__ Create documentation for __!ConTeXt__, __!MetaPost__ (see mpost(1)), and Perl modules. Converts the documentation to __!ConTeXt__ format and then typesets that documentation. See texutil(1) for more information about the format of the documentation strings. !!Process METAPOST Figures __--mpformat__ The name of a __!MetaPost__ format file. __--mptex__ Strips out and typesets TeX code embedded in a __!MetaPost__ file. __--nomp__ Do not run __!MetaPost__, even if needed. __--nomprun__ Do not run mpost(1) on embedded __!MetaPost__ code. !!Producing Proof Sheets of Figures __--figures=__''ALTERNATIVE'' Specify one of three options to produce a document containing the images used in the source file: __a__ A proof sheet with additional information provided for each figure __b__ A proof sheet with the graphics only __c__ One figure per page, with the page clipped to the bounding box of the figure See also __--paperoffset__, which allows you to specify an offset to be added to the page, as in texexec --figures=c --paperoffset=.5cm *.pdf *.png *.jpg __texexec__ uses texutil(1) to obtain the list of figures to process. !!USAGE o Each __!ConTeXt__ user interface (language) has its own format. The following command generates two formats, one using the English interface for typesetting in English, and one for Dutch: texexec --make en nl By default, the language used for typesetting matches the user-interface language (set with __--interface__. Its possible to use one language for typesetting and another for messages by changing the relevant settings in ''cont-usr.tex'', but these languages can also be changed on the command line with a command such as texexec --make --language=pl,cz,sk --bodyfont=plr en That command generates a __!ConTeXt__ format file with an English user interface, and the main language set to Polish (__pl__). The default body font is the Polish version of Computer Modern Roman (__plr__). Czech and Slovak hyphenation patterns are also loaded so that Czech and Slovak text included in a source file will be typeset properly (__cz__ and __sk__). o When the appropriate formats are present, a file can be typeset by typing texexec test __texexec__ tries to determine what interface it should use to typeset ''test.tex'' by looking for a line such as % interface=en tex=pdfetex output=pdftex at the top of the file (i.e., on the very first line). This line is equivalent to __TeX__s format line, ``__FORMAT''). By default, __texexec__ will produce a DVI file. The __--pdf__ flag tells __texexec__ to produce a PDF file, instead (by running pdftex(1)). You can also be more specific about what drivers __texexec__ should use, by specifying a command line such as texexec --output=dvips,acrobat test which specifies the use of the __dvips__ driver (which is the default), combined with the use of Acrobat-specific PDF instructions. After an error-free run, __texexec__ will run texutil(1) to determine whether additional runs of tex(1) (or pdftex(1)) or any utility programs (e.g., bibtex(1), makeindex(1)) are necessary. You can suppress these additional runs by specifying the __--once__ or __--runs__ flags: texexec --once test texexec --runs=2 test !!INITIALIZATION When starting, __texexec__ first looks for the file ''texexec.ini'', which specifies the location of various programs and configuration files, and specifies the programs to use. The __--verbose__ flag causes __texexec__ to print the information in ''texexec.ini'' to the terminal and the log file. __texexec__ requires Perl. On Unix and Unix-like systems, no special steps have to be taken to get __texexec__ to work beyond installing Perl and having the perl(1) binary in your path. On Windows systems, however, you may need to run Perl by typing commands such as ``perl texexec.pl optvar(ARGS). The __fpTeX__ distribution comes with a program called __runperl.exe__ that can be copied and renamed to __texexec.exe__. You will also have to rename a copy to __texutil.exe__ (see texutil(1)). The __teTeX__ and __fpTeX__ distributions, at least, should perform the necessary steps as part of their installation sequence -- if you have problems, however, you may need to follow the advice given here. The file ''texexec.rme'' contains default configuration information. If no file ''texexec.ini'' exists (in ''TEXMF/context/config/'', you should copy ''texexec.rme'' to that directory and rename it to ''texexec.ini''. Make any necessary changes to this file to reflect the layout of programs and directories on your system. !!ENCODINGS Some languages require specific character encodings to represent their alphabets (beyond the basic ASCII encoding). Although you can use TeX commands to represent these characters, such as ``.z, its easier to use a text editor that includes direct support for these characters and let __!ConTeXt__ translate them to the necessary TeX commands. For some languages, this approach can also improve the performance of !TeXs hyphenation algorithms. __!ConTeXt__ supports several of the most commonly used encodings. Check the files beginning with ''enco-'', ''lang-'', and ''font-'' in the __!ConTeXt__ distribution for more information. __web2c__ distributions (such as __teTeX__) support a mechanism to map document encodings to __!ConTeXt__s internal encoding, font encodings, and hyphenation patterns. __texexec__ provides a document option and a command-line flag to pass the necessary information to tex(1) or pdftex(1). You can add lines such as % or % --translate=cp1250pl to the beginning of your document, or specify the __--translate__ flag on the command line, as texexec --translate=il2pl somefile Note that using language-specific encodings will make your file less portable than using ASCII. It may not be possible for other people to typeset your documents on their systems. !!FILES ''TEXMF/context/config/texexec.ini'' TeXExec configuration file ''TEXMF/context/config/texexec.rme'' TeXExec configuration file defaults !!SEE ALSO bibtex(1), dvips(1), fmtutil(1), makeindex(1), metapost(1), mpost(1), pdfetex(1), pdfmerge(1), pdftex(1), perl(1), psnup(1), tex(1), texshow(1), texutil(1). The TeXExec manual, ''mtexexec.pdf''. The TeXExec configuration README files: o ''TEXMF/context/config/texexec.rme'' o ''TEXMF/context/perltk/texexec.rme'' Donald E. Knuths ''The !TeXbook''. !!AUTHOR This manpage was written by Tobias Burnus TeXExec__ manual written by Hans Hagen __ The PDF manual and __texexec__ itself can be obtained from __ ----
3 pages link to
texexec(1)
:
texutil(1)
texshow(1)
Man1t
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
