svenevs/latex repository overview

⁠Pandoc LaTeX images

These images contain pandoc⁠, the universal document converter, and a basic LaTeX⁠ installation for conversions to PDF.

Using pandoc together with LaTeX⁠ is a popular option to create PDF files from other formats. This image provides a TeX Live⁠ installation and contains all packages required to produce a PDF with pandoc’s default options.

Quick Reference ------------------------------------------------------------------ - **Where to get help**: [pandoc-discuss mailing list][pandoc-discuss] - **Where to report issues**: https://github.com/pandoc/dockerfiles/issues - **Source repository**: [pandoc/dockerfiles] on Github - **Maintained by**: [Albert Krewinkel], [Stephen McDowell], and [Caleb Maclennan]. [pandoc-discuss]: https://groups.google.com/forum/#!forum/pandoc-discuss [pandoc/dockerfiles]: https://github.com/pandoc/dockerfiles [Albert Krewinkel]: https://github.com/tarleb [Stephen McDowell]: https://github.com/svenevs [Caleb Maclennan]: https://github.com/alerque Supported tags ----------------------------------------------------------------- ``` supported-tags ``` The tags listed in a bullet point all refer to the same image. Numerical tags are rolling, meaning that a version tag always points to the newest image with the given version prefix. A prefix-version like `a.b.` is an easy way to specify a range of acceptable versions. Use a full, four part version like `a.b.c.d` to fix the image to a specific version. The *latest* tag refers to the most recently released version; there may be a minor lag between the time a pandoc version is released and a new image is released. A recent development version is provided under the *edge* tag. All tags can be suffixed with a stack identifier (see [Supported stacks](#supported-stacks)). ### A note on pandoc versioning Pandoc is not only an executable but also a Haskell *library*, which is why it is versioned using the [Haskell Package Versioning Policy][PVP]. Even minor versions can sometimes introduce new behavior if the API does not change, but this is a rare occasion. [PVP]: https://pvp.haskell.org

⁠Supported stacks

All tags can be suffixed with a stack-identifier, e.g., latest-ubuntu. This allows to chose a specific operation system. Available stacks are

• alpine: Alpine⁠ Linux.
• ubuntu: Ubuntu⁠ Linux.

The default for pandoc/latex is alpine.

Run the pandoc Docker container ------------------------------------------------------------------ A common use of the image looks like this (linebreaks for readability): ``` sh docker run --rm \ --volume "$(pwd):/data" \ --user $(id -u):$(id -g) \ pandoc/latex README.md -o outfile.pdf ``` This will convert the file `README.md` in the current working directory into `outfile.pdf`. Note that Docker options go *before* the image name, here `pandoc/latex`, while pandoc options come *after* it. The `--volume` flag maps some local directory (lefthand side of the colons) to a directory in the container (righthand side), so that you have your source files available for pandoc to convert. `$(pwd)` is quoted to protect against spaces in filenames. Ownership of the output file is determined by the user executing pandoc *in the container*. This will generally be a user different from the local user. It is hence a good idea to specify for docker the user and group IDs to use via the `--user` flag. For frequent command line use, we suggest the following shell alias: ``` sh alias pandock=\ 'docker run --rm -v "$(pwd):/data" -u $(id -u):$(id -g) pandoc/latex' ```

⁠TeXLive Version

The TeXLive version for each tag is fixed. See the table below for the version associated with a given tag / pandoc version.

Note that, due to the way TeXLive releases work, users who build derivative images may experience problems if the TeXLive version has been newly frozen. This can be resolved by pulling the updated base image again.

⁠Other images

If the images here do not fit your use-case, then checkout these alternatives:

• pandoc/minimal⁠: small images with the pandoc executable.
• pandoc/core⁠: based on minimal images, but ships with additional programs commonly used during conversions.