howto-deploy-latex-documents's Introduction

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.

howto-deploy-latex-documents's People

Contributors

Stargazers

Watchers

howto-deploy-latex-documents's Issues

Document pitfalls

Hi Simon, thanks for putting out this script!

I tried to make it work for my own PDF deployment, but gave up in the end because of problems with theunicode-math package. See the builds 1-8 at https://travis-ci.org/andreasabel/agda-scope/builds for a transcript of my attempts.

These are the pitfalls I ran into, you might want to warn users of your script about them:

An empty install: section causes the R environment to skip the script: section.
See andreasabel/agda-scope@6e5dd35 (build 3).
I discovered the solution to put a bogus installation entry (echo) by chance.
The unicode-math package seems to malfunction (at least with xelatex) in the version the R environment is using. While it can be installed via
```
tlmgr install filehooks unicode-math
```
(see andreasabel/agda-scope@88d8fbb)
it malfunctions:
```
! Undefined control sequence.
l.931   \file_get:nnN
                   {unicode-math-table.tex} 
```
There is a unresolved stackoverflow issue for that: https://stackoverflow.com/questions/55137760/undefined-control-sequence-file-getnnn-error-while-compiling-markdown-file

I did not find a workaround for this issue, thus, I abandoned the R environment and used the generic environment with manual installs of pandoc and texlive-latex via apt.

Anyhow, you might want to alert users of your script about these pitfalls.

Recommend Projects