Install and Configure

Dependencies

lux-cli

In tutorial, you have found the core program is lx, a package manager written in rust. It is provided by lux-cli. The version must be > 0.11.1 due to many bug fixes.

luahbtex

luahbtex is a TeX compiler and Lua 5.3 interpreter. Its sisters, luatex, luajittex and ..., are not supported by LaTeX. That's why we choose it. It is contained in mostly TeX distribution such as TeXLive and MikTeX. However, you can install it standalone.

Install

cargo install lux-cli
lx install luahbtex

For ArchLinux:

paru -S lux-cli luahbtex

For Nix:

nix-env -iA nixos.lux-cli
nix-env -iA nur.repos.Freed-Wu.luahbtex

Remember to check the version of lux-cli!

lx --version

Configure

~/.config/lux/config.toml:

extra_servers = [
  # Add our server to install compiled packages without compiling by yourself.
  "https://ustctug.github.io/texrocks/",
]
# luahbtex uses lua 5.3.
lua_version = "5.3"

For some regions like China, access github is slow. You can download recent github action pages build and deployment's artifact github-pages. Then extract it:

unzip github-pages.zip
tar vxaf artifact.tar
# you can delete them
rm artifact.tar github-pages.zip

start a server:

python -m http.server

Open http://127.0.0.1:8000 to check it. Then edit your ~/.config/lux/config.toml:

extra_servers = [
  "http://127.0.0.1:8000",
]

It will be fast beyond your imagination.

generated by LDoc 1.5.0 Last updated 2025-08-16 20:10:55