The Light LaTeX Make
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
examples
spec
.appveyor.yml
.gitignore
.travis.yml
Gemfile
Gemfile.lock
LICENSE
README.md
Rakefile
llmk.lua

README.md

llmk: The Light LaTeX Make

Build Status Build status

This is yet another build tool for LaTeX documents. The features of llmk are:

  • it works solely with texlua,
  • using TOML to declare the settings,
  • no complicated nesting of configuration, and
  • modern default settings (make LuaTeX de facto standard!)

Basic Usage

The easiest way to use llmk is to write the build settings into the LaTeX document itself. The settings can be written as TOML format in comments of a source file, and those have to be placed between the comment lines only with the consecutive + characters (at least three).

Here's a very simple example:

% hello.tex

% +++
% latex = "xelatex"
% +++

\documentclass{article}
\begin{document}

Hello \textsf{llmk}!

\end{document}

Suppose we save this file as hello.tex, then run

$ llmk hello.tex

will produce a PDF document (hello.pdf) with XeLaTeX, since it is specified in the TOML line of the source.

You can find other example LaTeX document files in the examples directory.

Advanced Usage

Using llmk.toml

Alternatively, you can write your build settings in an independent file named llmk.toml (this file name is fixed).

# llmk.toml

latex = "lualatex"
source = "hello.tex"

If you run llmk without any argument, llmk will load llmk.toml in the working directory, and compile files specified by source key with the settings written in the file.

$ llmk

Custom compile sequence

You can setup custom sequence for processing LaTeX documents; use sequence key to specify the order of programs to process the documents and specify the detailed settings for each program.

For the simple use, you can specify the command name in the top-level just like latex = "lualatex", which is already shown in the former examples (only available for latex, dvipdf, and bibtex).

However, it is impossible to specify more detailed settings (e.g., command line options) with this simple manner. If you want to change those settings as well, you have to use tables of TOML; write [programs.<name>] and then write the each setting following to that:

# custom sequence
sequence = ["latex", "bibtex", "latex", "dvipdf"]

# quick settings
dvipdf = "dvipdfmx"

# detailed settings for each program
[programs.latex]
command = "uplatex"
opts = "-halt-on-error"
args = "%T"

[programs.bibtex]
command = "biber"
args = "%B"

In the args keys in each program, some format specifiers are available. Those specifiers will be replaced to appropriate strings before executing the programs:

  • %S: the file name given to llmk as an argument (source)
  • %T: the target for each program
  • %B: the base name of %S

This way is a bit complicated but strong enough allowing you to use any kind of outer programs.

Available TOML keys

This is the list of currently available TOML keys.

  • latex (type: string, default: "lualatex")
  • dvipdf (type: string, default: "dvipdfmx")
  • bibtex (type: string, default: "")
  • sequence (type: array of strings, default: ["latex", "bibtex", "makeindex", "dvipdf"])
  • programs (type: table)
    • <program name>
      • command (type: string, required)
      • target (type: string, default: the input FILE)
      • opts (type: string or array of strings)
      • args (type: string or array of strings, default: ["%T"])
      • auxiliary (type: string)
      • postprocess (type: string)
  • source (type: string or array of strings, only for llmk.toml)
  • max_repeat (type: int, default: 3)

Default settings for each program

If following keys are omitted, these default values will be used instead.

  • command is required (no default)
  • target = "%S"
  • opts = []
  • args = "%T"

Other from above, there are no default values (i.e., null).

Default programs table

  • latex
    • command = "lualatex"
    • opts = ["-interaction=nonstopmode", "-file-line-error", "-synctex=1"]
    • auxiliary = "%B.aux"
  • bibtex
    • command = "bibtex"
    • target = "%B.bib"
    • args = "%B"
    • postprocess = "latex"
  • makeindex
    • command = "makeindex"
    • target = "%B.idx"
    • postprocess = "latex"
  • dvipdf
    • command = "dvipdfmx"
    • target = "%B.dvi"
  • dvips
    • command = "dvips"
    • target = "%B.dvi"
  • ps2pdf
    • command = "ps2pdf"
    • target = "%B.ps"

Acknowledgements

This project is supported by TeX Development Fund created by TeX Users Group.

License

This package released under the MIT license.


Takuto ASAKURA (wtsnjp)