Installation of Objavi is split into three steps: installing prerequisites, getting the Objavi source code and creating an Objavi site.
Objavi depends on a number of external tools and libraries for it's operation. Package names might vary depending on the operating system you are using.
The following demonstrates installing prerequisite packages on Ubuntu 12.04:
The HTML to PDF converter (wkhtmltopdf) should be downloaded from its respective home page manually. Make sure you choose the binary that matches your architecture (i386 or amd64). The following snipped demonstrates installing wkhtmltopdf on i386:
To use the beta PDF renderer you need to have its binary somewhere in the PATH, e.g. in /usr/local/bin. The source code for the Objavi Renderer is on GitHub, and can be obtained by cloning the github.com/bjandras/Renderer repository. Binaries for x86 and AMD-64 architectures are available from http://sourceforge.net/projects/booktype/files/Renderer. If you're getting a binary version make sure you download the package for your architecture. An INSTALL.txt file is included, just follow the instructions.
To create ODF output, you also need a whole lot of OpenOffice or LibreOffice 3.
Getting the code
The easiest way to obtain the Objavi source code is to clone the official Objavi git repository:
After unpacking the sources go to the Objavi's top-level directory and make sure that all files in the "bin" directory are executable.
Objavi also requires some sources from its sister project Booktype. If you don't already have Booktype sources on the system get them from the same place you got Objavi from:
Creating a Site
Once you have everything in place you are ready to create an Objavi site.
The 'create_site' script located in the 'scripts' directory of the Objavi source tree does exactly that. The script requires a destination directory where the site will be created.
The following command creates an Objavi installation inside /var/www/objavi_site:
Make sure you have the write permissions for the destination directory.
If you don't have Booktype installed globally on the system (i.e. somewhere in the PYTHONPATH) you will have to specify the path to Booktype's source directory when running the script, e.g.:
If the site was successfully created the script will notify you that a file named POST_INSTALL.txt has been created there and that you should read it. To complete the installation simply follow the instructions found in the POST_INSTALL.txt file.