Giter VIP home page Giter VIP logo

letterpress's Introduction

letterpress

Given a nicely written document in pandoc markdown, output a pretty HTML document. Complete with bibtex-based references and a mobile-first stylesheet.

To create ./gen with all the necessary html and css files, ready for upload:

make SRC=dissertation html

Sample HTML output

Uses pandoc, normalize.css, bootstrap 3.x, and make. CSL sheets are available at https://github.com/citation-style-language/styles.

installation

This project depends on bower (a node package) and pandoc (a Haskell package). Build happens with make. If you want PDF generation, you'll also need a TeX library. If you've got these already, then simply run

git clone https://github.com/philadams/letterpress.git
pip install -r requirements.txt
bower install

installing all the dependencies

If you'd like PDF generation, install TeX using MacTeX (http://www.tug.org/mactex). You'll really only need the small BasicTeX library.

Then we'll need pandoc:

brew install haskell-platform
cabal install pandoc

And bower:

brew install node
npm install -g bower

And then follow the short installation instructions above.

Please note: if you get stuck installing things on Ubuntu, it's probably a packaging error. A common issue surrounds the packaging of pandoc on Ubuntu and installing pandoc from apt instead of using Haskell's cabal. You can fix it by following directions at http://johnmacfarlane.net/pandoc/faqs.html.

future

  • consider moving references to csl/json format (removing need for bibtex)

letterpress's People

Contributors

philadams avatar

Watchers

Phil Adams 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.