_ _ _
__| | ___ ___| |_ ___ _ __(_)
/ _` |/ _ \ / __| __/ _ \| '__| |
| (_| | (_) | (__| || (_) | | | |
\__,_|\___/ \___|\__\___/|_| _/ |
|__/
A simple server to connect to LibreOffice and convert documents to PDF format.
The name comes from "Document to Renderable (Java)", since I needed some software to batch convert Word Documents to PDFs that are renderable in the browser. But it's an easy name to remember because of the basketball star.
- Download and install LibreOffice_4.0.0
- Ensure a 32bit JDK is installed on the machine
-
Ensure your JAVA_HOME environment variable is set and ensure %JAVA_HOME%\bin is in the PATH environment variable.
-
Ensure a 32bit JRuby is installed on the machine
- Install the buildr gem for JRuby:
- jruby -S gem install buildr
- If on Windows, ensure the Windows Error Reporting\DontShowUI registry setting is set to 1
- This will prevent LibreOffice crashes from hanging the doctorj process.
- http://social.technet.microsoft.com/Forums/en-US/winservergen/thread/8e7a7f48-a65e-4cd5-a55a-a62e4f7604cc/
-
If any firewall is running, ensure that TCP port 8080 is allowed for inbound connections. (And port 8081 for the admin interface)
-
Clone this git repository
-
In the repository's root directory, execute:
- buildr run
- Use the REST API to submit files for conversion, check on conversion status, and retrieve files.
You can see an example ruby client in the test script: https://github.com/denniskuczynski/doctorj/tree/master/buildlib/doctorj
- In the root directory, execute: buildr test
- There are also two Ruby test scripts
- buildr smoke_test
- buildr load_test
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Added some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request
LibreOffice is released under the LGPL http://www.libreoffice.org/download/license/
doctorj uses the DropWizard framework (http://dropwizard.codahale.com/) which uses the Apache License
