docverter

Docverter Server

Docverter is a document conversion server with an HTTP interface. It wraps the following open-source software in a JRuby app:

• Pandoc for plain text to HTML and ePub conversion
• Flying Saucer for HTML to PDF
• Calibre for ePub to MOBI conversion

Installation

Installing on Heroku is the easiest option. Simply clone the repo, create an app, and push:

$ git clone https://github.com/Docverter/docverter.git
$ cd docverter
$ heroku create --buildpack https://github.com/ddollar/heroku-buildpack-multi.git
$ heroku config:add PATH=bin:/app/bin:/app/jruby/bin:/usr/bin:/bin:/app/calibre/bin
$ heroku config:add LD_LIBRARY_PATH=/app/calibre/lib
$ git push heroku master

If you'd like to install locally, first ensure that Jruby, Pandoc and Calibre are installed and available. Then (for Ubuntu):

$ jruby -S gem install foreman
$ git clone https://github.com/docverter/docverter.git
$ cd docverter
$ sudo foreman export upstart /etc/init -u  -a docverter -l /var/log/docverter
$ sudo service docverter start

Other distributions will be similar. See the documentation for Foreman for more export options.

For a development server, try:

$ rvm install jruby-1.7.4
$ bundle install
$ gem install foreman
$ foreman start

Usage

Ruby

See doc/api.md and Docverter Ruby for usage documentation.

PHP

See doc/examples/php/markdown_to_pdf.php for usage documentation.

Python

See https://github.com/msabramo/pydocverter