Skip to content

SimonWaldherr/HowTo-Deploy-LaTeX-Documents

Repository files navigation

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


Build Status PDF Status GitHub Release GitHub forks GitHub stars

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

Creative Commons Lizenzvertrag

Download the PDF from the latest Release.