forked from dragotin/kraft
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
144 lines (108 loc) · 4.23 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
Generic compile and installation instructions in the beginning of
this file.
=> Find Kraft specific instructions below. Make sure to read them!
+------------------------------------------------------------------+
| Please use binary Packages from the openSUSE Buildservice |
| or the binary package repository of your joice. |
| Go to http://software.opensuse.org/search |
| and search for Kraft. Use the openSUSE 1-Click-Install |
+------------------------------------------------------------------+
The following section briefly describes how to build Kraft with cmake.
-----------------------------------------------------
Precondition
-----------------------------------------------------
Check that cmake is installed on your machine and is in your PATH.
To do so, just type
$ cmake --version
on your command line. Version 2.4 is required, the most recent
stable version of cmake is preferred.
To build Kraft, the following libs and software versions have to
be provided:
- cmake and the cmake extra modules
- Qt libs incl. devel packages version 5.5.0 or later
- kcontacts for using the KDE contact classes
- A few other KDE classes (kxmlgui, ki18n)
- google ctemplate, A simple but powerful template language for C++,
packages from the openSUSE Buildservice or from the website
https://github.com/OlafvdSpek/ctemplate
- optional: akonadi contact for Akonadi based addressbook access
Required packages for building with openSUSE Leap 42.3:
- cmake
- extra-cmake-modules
- gcc-c++
- kcontacts-devel
- akonadi-contact-devel
- gettext
- libctemplate-devel
- ki18n-devel
- kxmlgui-devel
- libQt5Core-devel
- libQt5Gui-devel
- libQt5Sql-devel
- libQt5Widgets-devel
Required packages for building with Kubuntu 18.04
- cmake
- extra-cmake-modules
- qt5-default
- gettext
- libkf5xmlgui-dev
- libkf5contacts-dev
- libkf5akonadi-dev
- libkf5akonadicontact-dev
- libctemplate-dev
-----------------------------------------------------
Build Kraft
-----------------------------------------------------
cmake is designed so that the build process can be done in a separate
directory. This is highly recommended for users and required for packagers.
Go to the top level of the source directory.
To build Kraft in the subdirectory ./build/ type
$ mkdir build
$ cd build
$ cmake ..
to generate the Makefiles.
$ ccmake .
to change the configuration of the build process. (optional)
Check out for errors during the cmake run. Fix them, usually you need
more devel packages installed.
Ready? Congratulations, your Makefiles were generated!
Now you could just type
$ make
to build the project in the build/ directory.
Note that 'make' automatically checks whether any CMakeLists.txt file
has changed and reruns cmake if necessary.
To start Kraft from the build directory, set the environment variable
KRAFT_HOME to the root of the _source_ directory to let Kraft find its
resource files:
$ KRAFT_HOME=/home/me/kraft build/src/kraft
Kraft Installation
==================
Type
$ make install
To change the target root directory to where it is installed, call
cmake with the parameter -DCMAKE_INSTALL_PREFIX=/my_dir
Database
========
Since version 0.40 Kraft either can use a SQLite file based
database or a MySQL server based database.
The SQLite database is created automatically on the fly
on first start. Its use is recommended for all users who
want to evaluate Kraft.
To run Kraft with MySQL, create or pick a user on the MySQL
server with appropiate permissions to write to a specific
database and create tables on it. Create an empty database
to use with Kraft. Remember both the database name and the
credentials.
On Krafts first start, enter these data in the setup assistant.
Kraft will create the database tables and fill it automatically.
Document Generation
===================
Kraft generates PDF documents. For that it uses a python tool named
erml2pdf. The tool can be found in Kraft's tools directory in this
source package.
erml2pdf uses a python lib called the ReportLab Toolkit: a mature,
Open Source PDF library which can be found at
http://www.reportlab.org/rl_toolkit.html
Furthermore it uses python-pypdf for pdf processing. Both python
modules are not part of Kraft and should be installed separately
on the system.