https://github.com/Docverter/docverter

Docverter Server
https://github.com/Docverter/docverter

Last synced: 3 months ago
JSON representation

Docverter Server

• Host: GitHub
• URL: https://github.com/Docverter/docverter
• Owner: Docverter
• License: other
• Created: 2012-11-24T05:08:23.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2016-09-29T23:02:29.000Z (about 8 years ago)
• Last Synced: 2024-08-01T23:30:55.521Z (3 months ago)
• Language: Ruby
• Size: 1.66 MB
• Stars: 831
• Watchers: 47
• Forks: 101
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Docverter Server

Docverter is a document conversion server with an HTTP interface.

It wraps the following open-source software in a JRuby app:

* [Pandoc](http://johnmacfarlane.net/pandoc/) for plain text to HTML and ePub conversion

* [Flying Saucer](http://code.google.com/p/flying-saucer/) for HTML to PDF

* [Calibre](http://calibre-ebook.com/) 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](http://ddollar.github.com/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](https://github.com/docverter/docverter-ruby) for usage documentation.

###### PHP

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

###### Python

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