On this page we list the tools that you'll need to build Scribus, and when building, the dependencies that the build process has.
- A compiler
- GCC/clang on Linux on Mac OSX
- Visual Studio on Windows is the recommended option, although GCC can also be used
- For Scribus 1.5.5+, the compiler must support C++11
- An installation of Qt5. We list this as a tool as Qt comes with applications required for user interface design, translation and development work, aside from its function as a toolkit or library.
- This can be installed via your package distribution method on Linux or on Mac OSX
- It can be installed from the Qt installation tool
- For Scribus 1.5.0+, Qt 5.2+
- For Scribus 1.5.3+, Qt 5.5+
- For Scribus 1.5.5+, Qt 5.7+
- CMake, a tool for build systems.
For the next set of requirements, read [[Dependencies>>doc:Menu.Development.Dependencies.WebHome]]. For information about how to install the above tools, read below.
Note: many Linux distros have their own Package Managers i.e. Debian has apt, Fedora and CentOS have yum, more recently superceded by dnf, Redhat uses rpm etc... On Mac OS X there are several choices, most popular are Macports and Homebrew. In general, by utilizing the installed package manager we can streamline the installations through easy one liners which will automate the install. We do this by invoking the following pattern:
(package-manager) install (software-or-library-package-name)
- Debian: apt-get install cmake
- Fedora: dnf install cmake
- MacOSX: port install cmake or brew install cmake
If Qt5 is not present on your system, you have to install or build it. You can download Qt5 from [[http:~~/~~/qt-project.org/downloads>>url:http://qt-project.org/downloads]]. Binary installers are available for Windows, Mac OS X and Linux. For Linux, if your distribution provides the latest Qt5, you can install it from its repositories (details for some distributions are listed below). The source code is also available, in case you want to build Qt5 yourself, or if an installer is not available for your operating system. If you're using the Qt installer on Linux, make sure to make the file qt-opensource-linux-x~*~*-5.*.*.run executable. You can do this via your chosen UI or the command line. The latter requires the following commands:
- chmode +x /path/to/qt-opensource-linux-x~*~*-5.*.*.run##
To start the installation process, use the cd command to move into the installer's directory. Next, run the following command:
If run without root privileges, the installer will suggest /home/<username>/Qt5.* as the installation directory. That's fine if you only want to use, develop or test Scribus yourself. If you also want to test the latest versions of other programs using Qt5, you may consider installing Qt5 with root privileges. In case you need a list, the required qt5 libs are :
- sudo apt install libqt5webkit5-dev qtquick1-5-dev qtdeclarative5-dev qttools5-dev-tools
- yum install qt5-qtbase qt5-qtbase-devel qt5-qtdeclarative qt5-qtdeclarative-devel qt5-qttools qt5-qttools-devel qt5-qtwebkit qt5-qtwebkit-devel qt5-qtbase-static
- sudo dnf -y install qt5-qtbase-devel qt5-qtdeclarative-devel qt5-qttools-devel qt5-qtwebkit-devel
- sudo zypper in -t devel_qt5
Mac OS X
- sudo port install qt5