Tellico/Compiling: Difference between revisions

From KDE UserBase Wiki
(Created page with 'To compile Tellico from the source code, you must [http://tellico-project.org/download download the source package] or get the code from the KDE extragear/office SVN module. ...')
 
mNo edit summary
Line 1: Line 1:
= Download Tellico =
To compile [[Tellico]] from the source code, you must [http://tellico-project.org/download download the source package] or get the code from the KDE extragear/office SVN module.
To compile [[Tellico]] from the source code, you must [http://tellico-project.org/download download the source package] or get the code from the KDE extragear/office SVN module.


== Source Package ==
If you download the source package, extract all of the files, which should create a directory named ''tellico-2.0/''.
If you download the source package, extract all of the files, which should create a directory named ''tellico-2.0/''.
<code>
<code>
% tar xjvf tellico-2.0.tar.bz2
% tar xjvf tellico-2.0.tar.bz2
% cd tellico-2.0
% cd tellico-2.0
</code>
</code>
== Current Development Source ==
Like all KDE applications, the source code is stored in KDE's Subversion system, in the ''extragear/office'' folder. Please refer to [http://techbase.kde.org/Getting_Started/Sources/Using_Subversion_with_KDE the Subversion Tutorial for KDE].
<code>
% svn co svn://anonsvn.kde.org/home/kde/trunk/extragear/office/tellico
% cd tellico
</code>


After that, there are three steps to build and install Tellico.
After that, there are three steps to build and install Tellico.


1. '''Configure '''
= Configure =


The compilation environment must be configured to your system first. The tool used to create the configuration is ''[http://www.cmake.org CMake]''. CMake will check that you have all the required development libraries and set up the files for compiling.
The compilation environment must be configured to your system first. The tool used to create the configuration is ''[http://www.cmake.org CMake]''. CMake will check that you have all the required development libraries and set up the files for compiling.


In the ''tellico-2.0/'' directory, create a directory for building, named ''build/'', just to keep things clear.
In the ''tellico-2.0/'' directory, create a directory for building, named ''build/'', just to keep things clear.
<code>
<code>
% mkdir build
% mkdir build
Line 28: Line 36:
If you do not have the necessary libraries for building tellico, CMake will fail and show you an error, listing which libraries you lack. Some libraries are required for building. Some are optional for additional functionality. The library packages may have different names, depending on your distribution.
If you do not have the necessary libraries for building tellico, CMake will fail and show you an error, listing which libraries you lack. Some libraries are required for building. Some are optional for additional functionality. The library packages may have different names, depending on your distribution.


2. '''Compile'''
= Compile =


''Make'' is used to actually compile Tellico.
''Make'' is used to actually compile Tellico.
<code>
<code>
% make
% make
Line 42: Line 49:
then the compilation completed successfully.
then the compilation completed successfully.


3. '''Install'''
= Install =


To install Tellico alongside other KDE applications, you will likely need to use the ''sudo'' command.
To install Tellico alongside other KDE applications, you will likely need to use the ''sudo'' command.
<code>
<code>
% sudo make install
% sudo make install
Line 51: Line 57:


Enter your password, and Tellico should be installed and should show up in the KDE menu, likely in the Office menu. Or, run it from the command-line.
Enter your password, and Tellico should be installed and should show up in the KDE menu, likely in the Office menu. Or, run it from the command-line.
<code>
<code>
% tellico
% tellico
</code>
</code>


= Enjoy =


4. '''Enjoy'''
You can send questions to the [http://tellico-project.org/mailing-list tellico-users mailing list].


You can send questions to the [http://tellico-project.org/mailing-list tellico-users mailing list].
If you need to uninstall Tellico
<code>
% sudo make uninstall
</code>

Revision as of 22:27, 23 October 2009

Download Tellico

To compile Tellico from the source code, you must download the source package or get the code from the KDE extragear/office SVN module.

Source Package

If you download the source package, extract all of the files, which should create a directory named tellico-2.0/. % tar xjvf tellico-2.0.tar.bz2 % cd tellico-2.0

Current Development Source

Like all KDE applications, the source code is stored in KDE's Subversion system, in the extragear/office folder. Please refer to the Subversion Tutorial for KDE. % svn co svn://anonsvn.kde.org/home/kde/trunk/extragear/office/tellico % cd tellico

After that, there are three steps to build and install Tellico.

Configure

The compilation environment must be configured to your system first. The tool used to create the configuration is CMake. CMake will check that you have all the required development libraries and set up the files for compiling.

In the tellico-2.0/ directory, create a directory for building, named build/, just to keep things clear. % mkdir build % cd build % cmake .. -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix`

Note

Note the backquotes in the cmake command, they are important.


The tells CMake to use the top-level tellico-2.0/ directory as the source directory, and to build the application to install in the same place as the rest of the KDE workspace. Later, when you install Tellico, you will likely need to root access, either through the root password or sudo.

If you do not have the necessary libraries for building tellico, CMake will fail and show you an error, listing which libraries you lack. Some libraries are required for building. Some are optional for additional functionality. The library packages may have different names, depending on your distribution.

Compile

Make is used to actually compile Tellico. % make

There will likely be some warnings during compilation, but if you see something like

[100%] Built target tellico

then the compilation completed successfully.

Install

To install Tellico alongside other KDE applications, you will likely need to use the sudo command. % sudo make install

Enter your password, and Tellico should be installed and should show up in the KDE menu, likely in the Office menu. Or, run it from the command-line. % tellico

Enjoy

You can send questions to the tellico-users mailing list.

If you need to uninstall Tellico % sudo make uninstall