Skip to content
This repository has been archived by the owner on Sep 5, 2021. It is now read-only.

arkark/latexmk-docker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐳 arkark/latexmk

Docker build Docker automated build

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