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