Chapter 7. Building and installing

## Chapter 7. Building and installing

This chapter describes how to build and install Knotter from source and the official packages, see the section called “Obtaining Knotter” for links and instructions on how to get the packages.

## Requirements and dependencies

Knotter is written in C++ using the Qt framework, installing the Qt SDK will satisfy most requirements.

- C++ build environment (Compiler, make etc.)

- Qt libraries and development tools

  Knotter has been tested with Qt versions 4.7 and 4.8

  Qt Developer Network

- Boost program-options (optional)

  Boost homepage

## Compiling from a bourne shell

This section describes the scripts that can be called to build Knotter from a bourne-compatible shell like bash or dash. This is the recommended way to build Knotter.

Building from a shell takes two steps, configuration and actual building.

The configuration is done via configure.sh, see configure.sh --help for a list of options.

configure.sh generates a Makefile that can be used to build the program.

Building with automatic configuration is done as follows:

    ./configure.sh
    make

If you want to install the Knotter, after the commands described above, run

    make install

This will install the files in prefix, as set from configure.sh. You can move the entire install tree to a specific directory by setting the environment variable `INSTALL_ROOT`

.

## Compiling from Qt creator

| Warning
It is strongly recommended that you compile from a shell if it is available on your system.

The project file is `knotter.pro`, you should be able to build it from Qt Creator.

## Deb and packages

Binary deb and rpm packages can be used to install Knotter using the system installer on systems that support these package managers.

Chapter 6. Knotter file format |  | Chapter 8. Contacts and links