arkark/latexmk repository overview

⁠: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 :warning:.

⁠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
   

   Copy
   If you use Mac, execute:

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

   Copy
   If you use Windows, execute in PowerShell:

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

   Copy
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⁠