|
|
| (2 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| Compiling latest Git version of KPhotoAlbum on Ubuntu / Debian
| | {{db-g7}} |
| | |
| ==Backup==
| |
| BY USING GIT VERSION YOU RISK LOOSING YOUR DATA.
| |
| IT SHOULDN'T HAPPEN BUT YOU NEVER KNOW. SO DO BACKUP YOUR FILES (come on, at least the index.xml) FIRST!
| |
| YOU'VE BEEN WARNED!
| |
| | |
| Create backup directory
| |
| mkdir kpa-backup
| |
| | |
| Backup your settings:
| |
| cp -a ~/.kde/share/apps/kphotoalbum/kphotoalbumui.rc kpa-backup/
| |
| cp -a ~/.kde/share/config/kphotoalbumrc kpa-backup/
| |
| | |
| And if you want to try KPhotoalbum with your real database (not the demo):
| |
| Backup your database:
| |
| cp -a /path/to/your/image/folder/index.html kpa-backup/
| |
| cp -a /path/to/your/image/folder/exif-info.db kpa-backup/
| |
| | |
| Backup the layout of your Annotation dialog:
| |
| cp -a /path/to/your/image/folder/layout.dat kpa-backup/
| |
| | |
| Note: there is also a backup script provided in KPhotoAlbum sources. You can just simply run it after the sources have been fetched (source/script/kpa-backup.sh):
| |
| kpa-backup.sh --backup
| |
| kpa-backup.sh --restore
| |
| | |
| ==Build==
| |
| ===Build dependencies===
| |
| If you've had KPhotoAlbum installed earlier from repositories, the Git KPhotoAlbum will use the same setting files as the earlier version.
| |
| If you want to be able to use the previous version after installing this, please do install to custom directory, not the default one.
| |
| | |
| Install required build tools:
| |
| sudo apt-get install git build-essential
| |
| | |
| Install required packages to build:
| |
| sudo apt-get build-dep kphotoalbum
| |
| | |
| OPTIONAL BUT RECOMMENDED: Install other dependencies:
| |
| sudo apt-get install kipi-plugins mplayerthumbs libjpeg8-dev khelpcenter4
| |
| (I'm not sure if libjpeg is needed, its in the build dependencies, see http://ftp.de.debian.org/debian/pool/main/k/kphotoalbum/kphotoalbum_4.1.1-4.debian.tar.gz)
| |
| | |
| ===Fetching source code===
| |
| Clone the Git repository:
| |
| git clone git://anongit.kde.org/kphotoalbum.git
| |
| | |
| ===Building===
| |
| Move to the created directory
| |
| cd kphotoalbum
| |
| | |
| Create a build-directory (so you don't mess up you source directory)
| |
| mkdir build ; cd build
| |
| | |
| Run cmake to configure the build system
| |
| cmake .. [to install to the default directory]
| |
| OR
| |
| cmake -DCMAKE_INSTALL_PREFIX=/path/for/my/kphotoalbum/installation .. [to install to a custom directory]
| |
| OR
| |
| cmake -DCMAKE_BUILD_TYPE=relwithdebuginfo .. [to make the debug build that will output plenty of debug messages to help track crashes etc]
| |
| OR combine the options:
| |
| cmake -DCMAKE_INSTALL_PREFIX=~/kphotoalbum -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
| |
| | |
| See the messages. In this stage you'll be told if you have missing dependencies. Do fix them (try to find the missing packages from the package repositories) before continuing.
| |
| | |
| Run make:
| |
| make
| |
| | |
| ===Installing===
| |
| Run installation(optional):
| |
| make install
| |
| or if the installation path is not writable by your user:
| |
| sudo make install
| |
| | |
| ===Running===
| |
| | |
| A handy feature of the cmake build-system is that it builds binaries in such a way that you can start them from within the build system. This certainly handy for quickly testing a new version of KPhotoalbum without touching anything else on your system.
| |
| However, be aware that some features depend on hard-coded paths (e.g. menu-entries, Handbook, HTML Exports, Demo) and may not work as expected. These features will still use the files installed by the distributions version of KPhotoAlbum.
| |
| You can just try out KPhotoalbum without installation first, and install later on (see 2.4), if you decide so.
| |
| | |
| If you installed to a non-standard directory, you have two options:
| |
| 1a) Start KPhotoAlbum from the directory where it was installed:
| |
| /path/for/my/kphotoalbum/installation/kphotoalbum
| |
| OR
| |
| 1b) add the following line to /home/username/.bashrc so you can start KPhotoAlbum from anywhere:
| |
| export KDEDIRS=/path/for/my/kphotoalbum/installation
| |
| Restart your terminal (so that .bashrc gets executed)
| |
| | |
| 2)Start KPhotoAlbum:
| |
| kphotoalbum
| |
| | |
| It's always a good idea to first try out things with the demo-database. Just add "--demo" when starting KPhotoalbum:
| |
| kphotoalbum --demo
| |
| | |
| | |
| ==Rebuild==
| |
| ===Refetching sources===
| |
| In the kphotoalbum Git folder, pull the changes:
| |
| git pull
| |
| | |
| If you want to see what has changed try git log or qgit for graphical user interface
| |
| | |
| ===Rebuilding===
| |
| You normally don't have to run cmake again -- it will be invoked by the makefiles, if neccessary. Otherwise follow BUILDING.
| |
| | |
| ===Reinstalling===
| |
| Follow instruction at [[#installing]]
| |
| | |
| ===RUNNING===
| |
| Follow instruction at [[#Running]]
| |
| | |
| | |
| ==Summary==
| |
| ===First build===
| |
| sudo apt-get build-essential build-dep kphotoalbum
| |
| sudo apt-get install git libjpeg8-dev
| |
| sudo apt-get install kipi-plugins mplayerthumbs libjpeg8-dev khelpcenter4
| |
| git clone git://anongit.kde.org/kphotoalbum
| |
| cd kphotoalbum
| |
| mkdir build ; cd build
| |
| cmake -DCMAKE_INSTALL_PREFIX=~/kphotoalbum -DCMAKE_BUILD_TYPE=Release ..
| |
| make install
| |
| | |
| ===Updating===
| |
| cd ~/kphotoalbum
| |
| git pull
| |
| make install
| |
| | |
| ===Running===
| |
| ~/kphotoalbum/script/kpa-backup.sh --backup
| |
| ~/kphotoalbum/bin/kphotoalbum
| |
