Warning, /education/marble/install/INSTALL is written in an unsupported language. File is not indexed.

0001 This file describes how to build and install Marble
0002 
0003 The most recent version of this file can be found at:
0004 
0005 https://marble.kde.org/sources.php
0006 
0007 Please refer to the online version above if possible.
0008 
0009 NOTE: This file describes how to build Marble as a stand-alone
0010       application.  If you are building Marble as part of the KDE-EDU
0011       module, then you should instead read the file INSTALL in the top
0012       level directory of this module and ignore this one.  This is
0013       most likely ../INSTALL.
0014 
0015 
0016 Prerequisites for building Marble are:
0017  - Qt 5.3 or newer
0018  - Cmake version 2.8.12 or newer
0019  - (optional): KDE Frameworks 5.7 or newer (KF5) from the KDE repositories.
0020  - other dependencies are optional
0021 
0022 A checkout of Marble. You can check out Marble using GIT via the command:
0023 
0024 git clone git://anongit.kde.org/marble ~/marble/sources
0025 
0026 
0027 You can build and install Marble in two different ways:
0028 
0029 1. As a Qt-only application.
0030 2. As a KF5-based application, using KDE Frameworks 5 classes.
0031 
0032 Choose one of them and read below for how to do it.
0033 
0034 NOTE: If you wish to build Marble with debug info include the argument
0035       -DCMAKE_BUILD_TYPE=debug in the cmake command below.
0036 
0037 1. Build Marble as a Qt only application.
0038 
0039 1.1 Create a build directory
0040 
0041 Create a build directory parallel to the source directory.  Suppose
0042 that the source directory is named 'marble'. Then create a new
0043 directory called 'marble-build'.
0044 
0045 
0046 1.2 Configure the build tree
0047 
0048 Go into the build directory and type
0049 
0050   cmake -DWITH_KF5=FALSE ../marble
0051 
0052 By default, marble is installed into /usr/local.  If you want to
0053 install it into any other directory, add
0054 -DCMAKE_INSTALL_PREFIX=/path/to/install/into like in this example:
0055 
0056   cmake -DWITH_KF5=FALSE -DCMAKE_INSTALL_PREFIX=~/apps ../marble
0057 
0058 If you have no write permission to the installation directory of cmake
0059 (because you have a system installed cmake) you need to add another
0060 parameter -DPACKAGE_ROOT_PREFIX=~/apps to the cmake command:
0061 
0062   cmake -DWITH_KF5=FALSE -DCMAKE_INSTALL_PREFIX=~/apps \
0063         -DPACKAGE_ROOT_PREFIX=~/apps ../marble
0064 
0065 To modify the position of the data directory at compile time, see the notes
0066 at 3.1 .
0067 
0068 
0069 1.3 Build marble
0070 
0071 Also in the build directory, type:
0072 
0073   make
0074 
0075 
0076 1.4 Install marble
0077 
0078 Finally, also from the build directory, type:
0079 
0080   make install
0081 
0082 and start Marble either from the menu or via the command line:
0083 
0084   marble-qt
0085 
0086 
0087 2. Build Marble as a KF5-based application.
0088 
0089 2.1 Create a build directory
0090 
0091 This is the same step as for a Qt-only build:
0092 
0093 Create a build directory parallel to the source directory.  Suppose
0094 that the source directory is named 'marble'. Then create a new
0095 directory called 'marble-build'.
0096 
0097 2.2 Configure the build tree
0098 
0099 Go into the build directory and type
0100 
0101   cmake ../marble
0102 
0103 From now on the steps are the same as for a Qt-only build.
0104 
0105 2.3 Build marble
0106 
0107   make
0108 
0109 2.4 Install marble
0110 
0111   make install
0112 
0113 and start Marble either from the menu or via the command line:
0114 
0115   marble
0116 
0117 
0118 3 Adjust Marble's search path for the maps and data
0119 
0120 There are several ways to adjust the path where Marble is
0121 drawing it's data from:
0122 
0123 3.1 At Compiletime
0124 
0125 Use the cmake option -DMARBLE_DATA_PATH to specify the
0126 built-in system path that Marble gathers its data from:
0127 
0128 Example:
0129   cmake -DWITH_KF5=FALSE -DMARBLE_DATA_PATH /mnt1/marble/data ~/marble
0130 
0131 3.2 "At Runtime"
0132 
0133 There are two solutions to adjust the data path for a
0134 precompiled Marble binary:
0135 
0136 a) Enter a key and a value
0137 
0138 marbleDataPath="/smb/marble/data"
0139 
0140 to the config file "marblerc" or
0141 "~/.config/KDE/Marble\ Desktop\ Globe.conf" and (re)start the
0142 application.
0143 
0144 b) Start Marble using the command line option --marbleDataPath:
0145 
0146 marble --marbleDataPath ~/marble/data