Installing Docvert on Debian/Ubuntu

Table of Contents
=================

* Install
* Optional libraries

Install
==================================================================

Install Docvert

    apt-get install docvert docvert-openoffice.org

Note: there's a docvert-openoffice server daemon script
at /etc/init.d/docvert-converter if you want to stop/restart it.

Enable docvert by uncommenting the alias in

    /etc/apache2/conf.d/docvert

and then restart apache:

    apache2ctl configtest
    apache2ctl graceful

This will install an older version of Docvert at http://localhost/docvert/

You'll notice a 'Docvert OpenOffice' daemon installed in /etc.init.d/docvert-converter

If you now wish to bypass Debian upgrades to install the most recent Docvert version
then you can now overwrite some files.

WARNING: Bypassing Debian upgrades may mean that Debian may overwrite parts of your
Docvert install so only do this if you know what you're doing.

To upgrade your install to the latest version of Docvert then,

    apt-get install subversion

Now decide whether you want to run the very latest version or the latest
stable version. You might get some hints from the list of changes,

    http://code.google.com/p/docvert/source/list

If you decide that you want the latest version:

    svn export http://docvert.googlecode.com/svn/trunk/ /usr/share/docvert --force

Or if you want particular Subversion revision (revision 177, below, is version 4.0), 

    svn export -r 177 http://docvert.googlecode.com/svn/trunk/ /usr/share/docvert --force


Optional libraries
==================================================================

*	If you want to convert bitmap images like BMP, JPG,
	PNG, GIF you'll need PHP GD ("php5-gd").

*	If you want to validate documents against a schema
	you'll need "trang"

*	If your documents have SVG images and you want to
	convert them to PNG/JPEG/GIF, then you'll need to
	install "librsvg-bin".

*	If you're using "Document Generation" you'll need PHP-Tidy
	("php5-tidy").

*	If you want EMF/WMF support then you'll need rsvg ("librsvg-bin")
	and pdf2svg ("pdf2svg")

