This project is archived and replaced by https://github.com/lsst/lsst-texmf.
texlive Docker image for LSST documentation deployment.
Use lsst-texlive
in a CI environment to speed up build times, or as a replacement for a local texlive installation on your own computer.
Links:
- GitHub repository: https://github.com/lsst-sqre/lsst-texlive
- Docker Hub: https://hub.docker.com/r/lsstsqre/lsst-texlive/
This example demonstrates how how to build DMTN-044 (a LaTeX-formatted technical note) with lsst-texlive
.
git clone https://github.com/lsst-dm/dmtn-044
cd dmtn-044
git submodule init && git submodule update
docker run --rm -v `pwd`:/workspace -w /workspace lsstsqre/lsst-texlive:latest sh -c 'make'
Notes:
- The
-v
argument binds the current working directory (the technote's source) to the/workspace
directory in the container. - The
-w
argument has the container run the user command (sh -c make
) from thatworkspace
directory.
The lsst/lsst-texlive
image is currently based on Ubuntu trusty (14.04).
It includes git
, make
and a comprehensive texlive installation.
See the Dockerfile for details.
You can hack on this repo by cloning it and build it using the Makefile:
git clone https://github.com/lsst-sqre/lsst-texlive
cd lsst-texlive
make all
docker run --rm lsstsqre/lsst-texlive:latest
This repo uses Travis CI to build and push tagged image to Docker Hub. The normal development workflow is:
- Create a branch.
- Commit changes and push to a new branch on GitHub (
git push -u
). - Test your image using the tagged version corresponding to the branch or Travis build number.
- To release, make a tag:
git tag -s N.N.N -m "vN.N.N"
andgit push --tags
- Merge to master:
git checkout master && git merge --no-ff <branch>
.
The latest
tag corresponds to the head of the master
branch.
Copyright 2017 Association of Universities for Research in Astronomy, Inc..
lsst-texlive is MIT-licensed open source. See LICENSE file.