https://github.com/nanmu42/miktex-docker

Dockerized MiKTeX, with preinstalled Chinese and Makefile support
https://github.com/nanmu42/miktex-docker

docker latex miktex pdflatex

Last synced: 7 months ago
JSON representation

Dockerized MiKTeX, with preinstalled Chinese and Makefile support

• Host: GitHub
• URL: https://github.com/nanmu42/miktex-docker
• Owner: nanmu42
• Created: 2019-10-12T06:35:16.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2019-10-12T06:55:32.000Z (about 6 years ago)
• Last Synced: 2025-02-10T11:41:47.595Z (9 months ago)
• Topics: docker, latex, miktex, pdflatex
• Language: Dockerfile
• Homepage: https://hub.docker.com/r/nanmu42/miktex-docker
• Size: 2.93 KB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Dockerized MiKTeX

This image allows you to run MiKTeX on any computer that supports Docker.

This image is forked from https://github.com/MiKTeX/docker-miktex, with Chinese fonts and Makefile tools preinstalled.

## Obtaining the image

Get the latest image from the registry:

    docker pull nanmu42/miktex-docker

## Using the image

### Volumes

#### Input files

The host directory containing the input files must be mounted to the

container path `/miktex/work`.

To mount the current host working directory, you would pass option `-v

$(pwd):/miktex/work` to the Docker `run` command.

#### Package files

The container image contains a bare MiKTeX setup and MiKTeX is

configured to install missing package files in the container directory

`/miktex/.miktex`.  It is recommended that you mount this directory to

a dedicated Docker volume.

### Running as `root` or not

By default, all commands inside the container are executed as `root`.

It is possible to execute as a dedicated host user by

setting the container environment variables `MIKTEX_GID` and `MIKTEX_UID`.

To execute as the current user, you would pass options `-e MIKTEX_GID=$(id

-g)` and `-e MIKTEX_UID=$(id -u)` to the Docker `run` command.

### Example

First, create a Docker volume named `miktex`:

    docker volume create --name miktex

This volume will be used to mount the the container directory

`/miktex/.miktex` in subsequent runs.

Provided that your main input file is located in the current working

directory, you can run `pdflatex` as follows:

    docker run --rm -ti \

      -v miktex:/miktex/.miktex \

      -v $(pwd):/miktex/work \

      -e MIKTEX_GID=$(id -g) \

      -e MIKTEX_UID=$(id -u) \

      nanmu42/miktex-docker \

      pdflatex main.tex