miktex-luatex 1 &PACKAGE_NAME; &miktexrev; User Commands
miktex-luatex an extended version of &pdfTeX; using &Lua; as an embedded scripting language
`miktex-luatex` option command file

## Description

Run the &LuaTeX; typesetter on file, usually creating `file.pdf`. Any remaining commands are processed as &LuaTeX; input, after file is read.

Alternatively, if the first non-option argument begins with a backslash, interpret all non-option arguments as a line of &LuaTeX; input.

Alternatively, if the first non-option argument begins with a `&`, the next word is taken as the format to read, overriding all else. Any remaining arguments are processed as above.

If no arguments or options are specified, prompt for input.

If called as `miktex-texlua` it acts as &Lua; interpreter. If called as `miktex-texluac` it acts as &Lua; bytecode compiler.

&LuaTeX; is an extended version of &pdfTeX; with Unicode and OpenType font support, embeded &Lua; scripting language, the &eTeX; and Ω extensions, as well as integrated &MetaPost; engine, that can create &PDF; files as well as &DVI; files. For more information about &LuaTeX;, see http://www.luatex.org, you can read the &LuaTeX; manual using the &MiKTeXHelpUtility; (`&mthelp; luatex`).

All &LuaTeX; text input and output is considered to be Unicode text.

In &DVI; mode, &LuaTeX; can be used as a complete replacement for the &TeX; engine.

In &PDF; mode, &LuaTeX; can natively handle the &PDF;, &JPG;, &JBIG2;, and &PNG; graphics formats. &LuaTeX; cannot include &PostScript; or Encapsulated &PostScript; (&EPS;) graphics files; first convert them to &PDF; using miktex-epstopdf 1.

## Options

When the &LuaTeX; executable starts, it looks for the `--lua` commandline option. If there is no `--lua` option, the commandline is interpreted in a similar fashion as in traditional &pdfTeX;. But if the option is present, &LuaTeX; will enter an alternative mode of commandline parsing in comparison to the standard &MiKTeX; programs. The presence of `--lua` makes most of other options unreliable, because the &Lua; initialization file can disable path searching and/or hook functions into various callbacks.

`--lua=file`

  Load and execute a &Lua; initialization script.

  --lua=file

The following two options alter the executable behaviour:

`--luaonly`

  Start &LuaTeX; as a &Lua; interpreter. In this mode, it will set &Lua;’s `arg[0]` to the found script name, pushing preceding options in negative values and the rest of the commandline in the positive values, just like the &Lua; interpreter. &LuaTeX; will exit immediately after executing the specified &Lua; script.

  --luaonly
`--luaconly`

  Start &LuaTeX; as a &Lua; byte compiler. In this mode, &LuaTeX; is exactly like `luac` from the standalone &Lua; distribution, except that it does not have the `−l` switch, and that it accepts (but ignores) the `−−luaconly` switch.

  --luaconly

Then the regular options:

`--credits`

  Display credits and exit.

  --credits
`--debug-format`

  Enable format debugging.

  --debug-format
`--draftmode`

  Switch on draft mode. luaTeX; doesn't write a &PDF; and doesn't read any included images, thus speeding up execution.

  --draftmode
`--mktex=fmt`

  Enable fmt generation, where fmt must be either `tex` or `tfm`.

--mktex=fmt
`--no-mktex=fmt`

  Disable fmt generation, where fmt must be either `tex` or `tfm`.

--no-mktex=fmt
`--nosocket`

  Disable the &Lua; socket library.

--nosocket
`--output-comment=string`

  Use string for &DVI; file comment instead of date.

  --output-comment=string
`--output-format=format`

  Use format for job output (one of: `dvi`, `pdf`).

  --output-format=format
`--safer`

  Disable easily exploitable &Lua; commands.

  --safer
`--utc`

  Init time to &UTC;.

  --utc

The following options are ignored:

- `−−8bit`
- `−−etex`
- `−−parse−first−line`
- `−−no−parse−first−line`

These are always on.

- `−−default−translate−file=tcxname`
- `−−translate−file=tcxname`

These are always off.

## Environment

## See Also

- miktex-epstopdf 1
- miktex-pdftex 1