nhamilakis/latexmk-docker

Useful LaTeX environment on :whale:

🐳 arkark/latexmk

Useful LaTeX environment on Docker.

• One command to LaTeX environment
• Colored latexmk output
• Automatic conversion from 、 。 to ， ．

Installation

$ docker pull arkark/latexmk

• Docker image size: 2.12GB

If you want to install all packages of TeX Live, pull arkark/latexmk:full whose size is 4.36GB ⚠️.

Usage

1. Prepare main.tex and some necessary files: e.g., other *.tex files, *.bib files, and image files.
2. Move to the directory.
3. Execute:

   $ docker run --rm -it -v $PWD:/workdir -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) arkark/latexmk

   If you use Mac, execute:

   $ docker run --rm -it -v $PWD:/workdir arkark/latexmk

   If you use Windows, execute in PowerShell:

   > docker run --rm -it -v "$(pwd):/workdir" arkark/latexmk

4. Edit latex files and preview out/main.pdf while monitoring a latexmk's log.
5. Press Ctrl+C to exit.

Options

The default latexmk file is here, which uses uplatex. If you want to customize it, add .latexmkrc file to the working directory.

For example, add the following .latexmkrc when using lualatex:

#!/usr/bin/env perl
$pdflatex = "lualatex --synctex=1 --interaction=nonstopmode --halt-on-error %O %S";
$max_repeat       = 5;
$pdf_mode         = 1;
$pdf_previewer    = ":";
$out_dir          = "out";
$pvc_view_file_via_temporary = 0;

Advanced Usage

Latexdiff:

$ docker run --rm -it -v $PWD:/workdir -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) arkark/latexmk latexdiff-vc <ARGS>

Colored latexmk with a root filename:

$ docker run --rm -it -v $PWD:/workdir -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) arkark/latexmk latexmk-ext <FILE_NAME>

Links

• Dockerで動くいい感じのLaTeX環境をつくった話 | Ark's Blog