GithubHelp home page GithubHelp logo

jaksz / heroku-buildpack-tex Goto Github PK

View Code? Open in Web Editor NEW

This project forked from gulopine/heroku-buildpack-tex

0.0 2.0 0.0 379 KB

A buildpack for building TeX documents on Heroku

License: MIT License

Shell 100.00%

heroku-buildpack-tex's Introduction

Heroku buildpack: TeX

This is a Heroku buildpack for working with TeX documents. In its raw form, it simply bundles a working TeX Live environment into your Heroku app and doesn't do anything else with it.

$ ls

$ heroku create --buildpack git://github.com/holiture/heroku-buildpack-tex.git

$ git push heroku master
...
-----> Heroku receiving push
-----> Fetching custom build pack... done
-----> TeX app detected
-----> Fetching TeX Live 20120511
...

This can be useful if you simply want to play around with TeX Live without having to build or install it yourself. You can pull it up on your instance easily in bash:

$ heroku run bash

Multipacks

More likely, you'll want to use it as part of a larger project, which needs to build PDFs. The easiest way to do this is with a multipack, where this is just one of the buildpacks you'll be working with.

$ cat .buildpacks
git://github.com/heroku/heroku-buildpack-python.git
git://github.com/holiture/heroku-buildpack-tex.git

$ heroku config:add BUILDPACK_URL=git://github.com/ddollar/heroku-buildpack-multi.git

This will bundle TeX Live into your instance without impacting your existing system. You can then call out to executables like pdflatex as you would on any other machine.

Auto-build

Another potential use is simply for building a specific document. This can be useful if you're working with a document pipeline that outputs LaTeX documents, but not often enough to need it integrated into a larger system. Rather than having to build and install TeX Live yourself, you can use this buildpack to do it for you.

This funcionality is provided by a special autobuild branch. To activate it, simply append #autobuild to the buildpack URL and make sure you have a document.tex at the root of your repository. It can reference other .tex files as necessary, as long as the main file is called document.tex.

$ ls
document.tex

$ heroku create --buildpack git://github.com/holiture/heroku-buildpack-tex.git#autobuild

$ git push heroku master
...
-----> Heroku receiving push
-----> Fetching custom build pack... done
-----> TeX app detected
-----> Fetching TeX Live 20120511
-----> Building document.tex
       Wrote 3 pages to document.pdf

This will output a PDF file, which you can download it using your browser as document.pdf at the root of your app's URL. For example, if your document app is called silent-night-1234, you'd be able to find your completed document at http://silent-night-1234.herokuapp.com/document.pdf.

heroku-buildpack-tex's People

Contributors

gulopine avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.