Building on Linux

Ubuntu

You need the following packages:

...

• git
• gcc
• g++
• make
• libxml2-dev

...

• libsdl2-dev
• libsdl2-image-dev

...

• qtbase5-dev
• libqt5webkit5-dev

To install these packages on Ubuntu, do the following:

sudo apt-get install \
    git \
    gcc \
    g++ \
    make \
    libxml2

...

Fedora

You need the following packages:

-dev \
    libsdl2-dev \
    libsdl2-image-dev \
    qtbase5-dev \
    libqt5webkit5-dev

In addition to the above, you also need a recent version of CMake. Some distributions (such as Ubuntu 14.04) currently ship with old versions; you need at least 3.1 to build Corinthia. Here's how to download & build the latest version from source:

...

wget 

http://www.cmake.org/

...

Typical command to get the libraries needed is sudo yum install libxml2

Making the make files

Note that, as per standard cmake practice, you should always build separately from the source tree (although a separate sub-directory within the source tree is acceptable).

Set the DOCFORMATS_DIR environment variable to the location of the repository root. Then, any where on your file system:

Build

To have the make system call your compiler and build the binaries

This will produce four binaries in your build directory:

lib/libDocFormats.a  – a static library

bin/dfconvert   – the converter program

bin/dftest         – the test suite

bin/dfutil          –  the driver program

To run the tests, type the following from your /build directory:

files/v3.2/cmake-3.2.2.tar.gz
tar xvf cmake-3.2.2.tar.gz
cd cmake-3.2.2
./bootstrap
make
sudo make install

To check out and build the source, do the following:

git clone https://git-wip-us.apache.org/repos/asf/incubator-corinthia.git
mkdir incubator-corinthia/build
cd incubator-corinthia/build
cmake -G 'Unix Makefiles' ..
make

Note that the build directory should be different from the source directory. The example above uses a subdirectory of the source directory, which is fine - but you can also use one in a completely different location as well.

Building

...

on OS X

You can either use the instructions above for building using make, or alternatively generate an Xcode project:

...

...

This will produce DocFormats.xcodeproj, which you can then open in Xcode. 

Building on Windows