summaryrefslogtreecommitdiff
path: root/doc/context/scripts/mkiv/mtx-context.html
blob: d13a88d457342d65512091fd1a704659334c101c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<!-- compare with lmx framework variant -->

<!--
    filename : context-base.xml
    comment  : companion to mtx-server-ctx-startup.tex
    author   : Hans Hagen, PRAGMA-ADE, Hasselt NL
    copyright: PRAGMA ADE / ConTeXt Development Team
    license  : see context related readme files
-->

<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
    <head>
        <title>ConTeXt Process Management 1.03</title>
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
                <style type="text/css">
            body { color: #FFFFFF; background-color: #808080; font-family: optima, verdana, futura, "lucida sans", arial, geneva, helvetica, sans; font-size: 12px; line-height: 18px; } a:link, a:active, a:visited { color: #FFFFFF; } a.dir-view:link, a.dir-view:active, a.dir-view:visited { color: #FFFFFF; text-decoration: underline; } .valid { color: #00FF00; } .invalid { color: #FF0000; } .invisible { visibility: hidden; } button, .commonlink, .smallbutton { font-weight: bold; font-size: 12px; text-decoration: none; color: #000000; border-color: #7F7F7F; border-style: solid; border-width: .125ex; background-color: #FFFFFF; padding: .5ex; } .smallbutton { width: 1em; } a.commonlink:link, a.commonlink:active, a.commonlink:visited, a.smalllink:link, a.smalllink:active, a.smalllink:visited { font-weight: bold; font-size: 12px; text-decoration: none; color: #000000; } h1, .title { font-style: normal; font-weight: normal; font-size: 18px; line-height: 18px; margin-bottom: 20px; } h2, .subtitle { font-style: normal; font-weight: normal; font-size: 12px; margin-top: 18px; margin-bottom: 18px; } table { line-height: 18px; font-size: 12px; margin: 0; } th { font-weight: bold; text-align: left; padding-bottom: 6px; } .tc { font-weight: bold; text-align: left; } p, li { max-width: 60em; } .empty-line { margin-top: 4px; } .more-room { margin-right: 1.5em; } .much-more-room { margin-right: 3em; } #main { position: absolute; left: 10%; top: 10%; right: 10%; bottom: 10%; z-index: 2; width: 80%; height: 80%; padding: 0%; margin: 0%; overflow: auto; border-style: none; border-width: 0; background-color: #3F3F3F; } #main-settings { margin: 12px; x_max-width: 60em; line-height: 18px; font-size: 12px; } #left { position: absolute; top : 10%; left: 0%; bottom: 0%; right: 90%; z-index: 1; width: 10%; height: 90%; padding: 0%; margin: 0%; font-size: 16px; border-style: none; border-width: 0; background-color: #4F6F6F; } #right { position: absolute; top : 0%; left: 90%; bottom: 10%; right: 0%; z-index: 1; width: 10%; height: 90%; padding: 0%; margin: 0%; font-size: 16px; border-style: none; border-width: 0; background-color: #4F6F6F; _margin-left: -15px; } #bottom { position: absolute; left: 10%; right: 0%; top: 90%; bottom: 0%; z-index: 1; width: 90%; height: 10%; padding: 0%; margin: 0%; font-size: 16px; border-style: none; border-width: 0; background-color: #6F6F8F; } #top { position: absolute; left: 0%; right: 10%; top: 0%; bottom: 90%; z-index: 1; width: 90%; height: 10%; padding: 0%; margin: 0%; font-size: 16px; border-style: none; border-width: 0; background-color: #6F6F8F; } #top-one { position: absolute; bottom: 50%; width: 100%; buggedheight: 100%; } #top-two { position: relative; margin-bottom: -9px; margin-left: 12px; margin-right: 12px; line-height: 18px; text-align: right; vertical-align: middle; } #bottom-one { position: absolute; bottom: 50%; width: 100%; buggedheight: 100%; } #bottom-two { position: relative; margin-bottom: -9px; margin-left: 12px; margin-right: 12px; line-height: 18px; text-align: left; vertical-align: middle; } #left-one { position: absolute; width: 100%; buggedheight: 100%; } #left-two { position: relative; margin-top: 12px; line-height: 18px; text-align: center; vertical-align: top; } #right-one { display: table; height: 100%; width: 100%; } #right-two { display: table-row; height: 100%; width: 100%; } #right-three { display: table-cell; width: 100%; vertical-align: bottom; _position: absolute; _top: 100%; } #right-four { text-align: center; margin-bottom: 2ex; _position: relative; _top: -100%; } #more-top { position: absolute; top: 0%; left: 90%; bottom: 90%; right: 0%; z-index: 3; width: 10%; height: 10%; padding: 0%; margin: 0%; border-style: none; border-width: 0; } #more-top-settings { text-align: center; } #more-right-settings { margin-right: 12px; margin-left: 12px; line-height: 18px; font-size: 10px; text-align: center; } #right-safari { _display: table; width: 100%; height: 100%; } 
        </style>
        <style type="text/css">
                    </style>
                    </head>
        <body>
            <div id="top">            <div id="top-one">
                <div id="top-two">ConTeXt Process Management 1.03 </div>
            </div>
        </div>
        <div id="bottom">            <div id="bottom-one">
                <div id="bottom-two">wiki: http://contextgarden.net | mail: ntg-context@ntg.nl | website: http://www.pragma-ade.nl</div>
            </div>
        </div>
        <div id="left"></div>
        <div id="right"></div>
        <div id="main">
            <div id='main-settings'>
                <h1>Command line options</h1>
<table>
    <tr><th style="width: 10em">flag</th><th style="width: 8em">value</th><th>description</th></tr>
        <tr><th colspan="3">basic</th></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--run</th><td></td><td>process (one or more) files (default action)</td></tr>
        <tr><th>--make</th><td></td><td>create context formats</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--ctx=name</th><td></td><td>use ctx file (process management specification)</td></tr>
        <tr><th>--noctx</th><td></td><td>ignore ctx directives and flags</td></tr>
        <tr><th>--interface</th><td></td><td>use specified user interface (default: en)</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--autopdf</th><td></td><td>close pdf file in viewer and start pdf viewer afterwards</td></tr>
        <tr><th>--purge</th><td></td><td>purge files either or not after a run (--pattern=...)</td></tr>
        <tr><th>--purgeall</th><td></td><td>purge all files either or not after a run (--pattern=...)</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--usemodule</th><td>list</td><td>load the given module or style, normally part of the distribution</td></tr>
        <tr><th>--environment</th><td>list</td><td>load the given environment file first (document styles)</td></tr>
        <tr><th>--mode</th><td>list</td><td>enable given the modes (conditional processing in styles)</td></tr>
        <tr><th>--path</th><td>list</td><td>also consult the given paths when files are looked for</td></tr>
        <tr><th>--arguments</th><td>list</td><td>set variables that can be consulted during a run (key/value pairs)</td></tr>
        <tr><th>--randomseed</th><td>number</td><td>set the randomseed</td></tr>
        <tr><th>--result</th><td>name</td><td>rename the resulting output to the given name</td></tr>
        <tr><th>--trackers</th><td>list</td><td>set tracker variables (show list with --showtrackers)</td></tr>
        <tr><th>--directives</th><td>list</td><td>set directive variables (show list with --showdirectives)</td></tr>
        <tr><th>--silent</th><td>list</td><td>disable logcatgories (show list with --showlogcategories)</td></tr>
        <tr><th>--strip</th><td></td><td>strip Lua code (only meant for production where no errors are expected)</td></tr>
        <tr><th>--errors</th><td>list</td><td>show errors at the end of a run, quit when in list (also when --silent)</td></tr>
        <tr><th>--htmlerrorpage</th><td></td><td>generate html error page instead (optional: =scite)</td></tr>
        <tr><th>--noconsole</th><td></td><td>disable logging to the console (logfile only)</td></tr>
        <tr><th>--nodummy</th><td></td><td>don't create a dummy file (can confuse pdf viewers that keep file in view)</td></tr>
        <tr><th>--purgeresult</th><td></td><td>purge result file before run</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--forcexml</th><td></td><td>force xml stub</td></tr>
        <tr><th>--forcecld</th><td></td><td>force cld (context lua document) stub</td></tr>
        <tr><th>--forcelua</th><td></td><td>force lua stub (like texlua)</td></tr>
        <tr><th>--forcemp</th><td></td><td>force mp stub</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--arrange</th><td></td><td>run extra imposition pass, given that the style sets up imposition</td></tr>
        <tr><th>--noarrange</th><td></td><td>ignore imposition specifications in the style</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--jit</th><td></td><td>use luajittex with jit turned off (only use the faster virtual machine)</td></tr>
        <tr><th>--jiton</th><td></td><td>use luajittex with jit turned on (in most cases not faster, even slower)</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--once</th><td></td><td>only run once (no multipass data file is produced)</td></tr>
        <tr><th>--runs</th><td></td><td>process at most this many times</td></tr>
        <tr><th>--forcedruns</th><td></td><td>process this many times (permits for optimization trial runs)</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--batchmode</th><td></td><td>run without stopping and do not show messages on the console</td></tr>
        <tr><th>--nonstopmode</th><td></td><td>run without stopping</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--nosynctex</th><td></td><td>never initializes synctex (for production runs)</td></tr>
        <tr><th>--synctex</th><td></td><td>run with synctex enabled (better use \setupsynctex[state=start]</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--nodates</th><td></td><td>omit runtime dates in pdf file (optional value: a number (this 1970 offset time) or string "YYYY-MM-DD HH:MM")</td></tr>
        <tr><th>--nocompression</th><td></td><td>forcefully turns off compression in the backend</td></tr>
        <tr><th>--trailerid</th><td></td><td>alternative trailer id (or constant one)</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--generate</th><td></td><td>generate file database etc. (as luatools does)</td></tr>
        <tr><th>--paranoid</th><td></td><td>do not descend to .. and ../..</td></tr>
        <tr><th>--version</th><td></td><td>report installed context version</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--global</th><td></td><td>assume given file present elsewhere</td></tr>
        <tr><th>--nofile</th><td></td><td>use dummy file as jobname</td></tr>
        <tr><th colspan="3">expert</th></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--touch</th><td></td><td>update context version number (also provide --expert, optionally provide --basepath)</td></tr>
        <tr><th>--nostatistics</th><td></td><td>omit runtime statistics at the end of the run</td></tr>
        <tr><th>--profile</th><td></td><td>profile job (use: mtxrun --script profile --analyze)</td></tr>
        <tr><th>--timing</th><td></td><td>generate timing and statistics overview</td></tr>
        <tr><th>--keeptuc</th><td></td><td>keep previous tuc files (jobname-tuc-[run].tmp)</td></tr>
        <tr><th>--keeplog</th><td></td><td>keep previous log files (jobname-log-[run].tmp)</td></tr>
        <tr><th>--lmtx</th><td></td><td>force lmtx mode (when available)</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--extra=name</th><td></td><td>process extra (mtx-context-... in distribution)</td></tr>
        <tr><th>--extras</th><td></td><td>show extras</td></tr>
        <tr><th colspan="3">special</th></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--pdftex</th><td></td><td>process file with texexec using pdftex</td></tr>
        <tr><th>--xetex</th><td></td><td>process file with texexec using xetex</td></tr>
        <tr><th>--mkii</th><td></td><td>process file with texexec</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--pipe</th><td></td><td>do not check for file and enter scroll mode (--dummyfile=whatever.tmp)</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--sandbox</th><td></td><td>process file in a limited environment</td></tr>
        <tr><th/><td/><td/></tr>
        <tr><th>--addbinarypath</th><td></td><td>prepend the (found) binarypath to runners</td></tr>
    </table>
<br/>
            </div>
        </div>
        </body>
</html>