Howto Deploy LaTeX Documents

HowTo Deploy LaTeX (or Markdown) Documents as PDF (and DjVu) via GitHub and TravisCI

maybe you should take a look at: https://github.com/SimonWaldherr/BookTemplate

This repository explains how to automate the process of converting LaTeX documents to PDFs or DjVu-Files. You need no special software, everything gets done online.

Dealing with TeX + PDF on GitHub (or other online repository hosting services) leads mostly to various problems, e.g.:

• having large binary files in a git repo (PDFs)
• having old files, large gap between source and PDF
• need of a local tex installation to update the PDF

the alternative is to only publish the LaTeX source, which has other problems:

• no preview on GitHub
• no preview after download
• no way to see the completed document on devices without TeX (e.g. mobile)

and what is the solution?

• building the binary files (PDF + DjVu) on a Server
• save the files on publicly accessible servers (e.g. as GitHub Release)
• link to the files from the README

Download the PDF from the latest Release.