luametalatex/README.md

26 lines
2.1 KiB
Markdown
Raw Normal View History

2019-07-17 21:35:27 +02:00
# (unofficial) LaTeX format for LuaMetaTeX
## Warning:
2020-06-04 00:13:05 +02:00
This code is in early stages of development and contains more bugs than features. _Do not_ expect it to be compatible with normal documents. Also later versions will contain many breaking changes.
2019-07-17 21:35:27 +02:00
## Prerequisites
2020-07-10 22:02:08 +02:00
You need an up-to-date TeX Live installation and the latest version of LuaMetaTeX. Additionally a current development version of luaotfload is required. (Of course, luaotfload is not necessary if you only want to use `luametaplain` without Unicode fonts.)
2019-07-17 21:35:27 +02:00
2020-07-09 15:02:39 +02:00
Additionally a special library version of LuaTeX's kpathsea Lua binding is needed which is provided as a binary for Linux x64 and Windows x64. The Windows version is much less tests and may be out-of-date. For other platforms you have to compile it yourself. Drop me a line if you need any instructions. (The source can be found under https://github.com/zauguin/luametalatex-kpse)
2019-07-17 21:35:27 +02:00
2020-07-02 11:41:15 +02:00
## How to install (automatically)
Obtain `luametatex` from ConTeXt, drop the binary into the same location where your `luatex` binary is installed and then run `install.sh`.
## How to install (manually)
2019-07-17 21:35:27 +02:00
Obtain `luametatex` from ConTeXt, drop the binary into the same location where your `luatex` binary is installed and copy (or sym-link) the file `luametalatex.lua` into the same directory. Additionally create a sym-link `luametalatex` to `luametatex` in the same directory. Then copy (or sym-link) this entire repo to `.../texmf-local/tex/lualatex/luametalatex`.
2020-07-09 15:02:39 +02:00
Finally add the lines (on Windows, `$(luametalatex.lua)` has to be replaced by the full path to `luametalatex.lua`)
2019-07-17 21:35:27 +02:00
```
luametalatex luametatex language.dat,language.dat.lua --lua="$(kpsewhich luametalatex.lua)" luametalatex.ini
```
2020-07-09 15:02:39 +02:00
to your local `fmtutil.cnf` and configure paths for luametalatex in your `texmf.cnf`. Then you should be able to run `mktexlsr` followed by `fmtutil-sys --byfmt luametalatex` to generate the format.
2019-07-17 21:35:27 +02:00
If this worked you can built (simple) LaTeX documents using the command `luametalatex`.
2020-07-02 11:41:15 +02:00
You can then repeat the same instructions with `luametalatex-dev` and `luametaplain` to also get access to development and plain TeX formats