KIPIPLUGINS PROJECT (http://www.digikam.org)

-- AUTHORS ------------------------------------------------------------

See AUTHORS file for details.

-- ABOUT --------------------------------------------------------------

Libkipi and kipi-plugins allow image applications such as digiKam (http://www.digikam.org)
to use a plugin architecture for additional functionalities.

Notes:

kipi-plugins is based in part on the work of the Independent JPEG Group.

Facebook           : A tool to import/export images to/from a remote Facebook web service (http://www.facebook.com).
Flickr             : A tool to export images to a remote Flickr based web service (http://www.flickr.com). Also compatible with Zooomr and 23HQ 
GoogleServices     : A tool to export images to Google web services.
PrintImage         : A tool to print images in various format.
SendImages         : A tool to send images by e-mail.
FlashExport        : A tool to export images to Flash using SimpleViewer (http://www.airtightinteractive.com/simpleviewer).
Smug               : A tool to import/export images to/from a remote SmugMug web service (http://www.smugmug.com).
RemoteStorage      : A tool to export images to remote storage using network protocol (FTP, SSH, SAMBA, etc...).
Piwigo             : A tool to export images to a remote Piwigo (PHPWebGallery) server (http://piwigo.org).
YandexFotki        : A tool to export images to Yandex web service (http://fotki.yandex.ru).
MediaWiki          : A tool to export images to Mediawiki based web service (http://www.mediawiki.org).
RajceExport        : A tool to export images to Rajce web service (http://www.rajce.idnes.cz).
Vkontakte          : A tool to export images to VKontakte web service (http://www.vkontakte.ru)
PhotoLayoutEditor  : A tool to assemble images together.
ImageShack         : A tool to export images to ImageShack web service (http://imageshack.us)
ImgurExport        : A tool to export images to ImgUr web service (http://imgur.com)

-- DEPENDENCIES -------------------------------------------------------

CMake           >= 3.0.0                        http://www.cmake.org
ECM             >= 1.7.0                        https://projects.kde.org/projects/kdesupport/extra-cmake-modules
libqt           >= 5.4.0                        http://www.qtsoftware.com
libkde          >= 5.5.0                        http://www.kde.org
libkipi         >= 5.0.0                        https://projects.kde.org/projects/kde/kdegraphics/libs/libkipi

Optional:

libkarchive     >= 5.0.0                        https://projects.kde.org/projects/frameworks/karchive
libmediawiki    >= 5.0.0                        https://projects.kde.org/projects/extragear/libs/libmediawiki
libkvkontakte   >= 4.70.0                       https://projects.kde.org/projects/extragear/libs/libkvkontakte
libqtkoauth     >= 0.97                         https://github.com/kypeli/kQOAuth

Plugin Specific Dependencies (for compiling and for running) :

FaceBook           : libqjson.
Mediawiki          : libmediawiki.
Vkontakte          : libkvkontakte.
Imgur              : libqtkoauth for Imgur.com's authenticated API.

-- CONTACT ------------------------------------------------------------

If you have questions, comments, suggestions to make send an email to :

kde-imaging@kde.org

IRC channel from irc.freenode.org server: #kde-imaging
                                          #digikam

IMPORTANT : the bugreports and wishlist are hosted by the KDE bugs report 
system who can be contacted by the standard Kde help menu of plugins dialog. 
A mail will be automaticly sent to the Kipi mailing list.
There is no need to contact directly the Kipi mailing list for a bug report 
or a devel wish.

The current Kipi bugs and devel wishes reported to the Kde bugs report can be
seen at this url :

http://bugs.kde.org/buglist.cgi?product=kipiplugins&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED

-- INSTALL ------------------------------------------------------------

In order to compile, especially when QT4/Qt5 are installed at the same time,
just use something like that:

# export VERBOSE=1
# export QTDIR=/usr/lib/qt5/
# export PATH=$QTDIR/bin:$PATH
# cmake .
# make
# sudo make install

Usual CMake options :

-DCMAKE_INSTALL_PREFIX : decide where the program will be install on your computer.
-DCMAKE_BUILD_TYPE     : decide which type of build you want. You can chose between "debugfull", "debug", "profile", "relwithdebinfo" and "release". The default is "relwithdebinfo" (-O2 -g).

Compared to old autoconf options:

"cmake . -DCMAKE_BUILD_TYPE=debugfull" is equivalent to "./configure --enable-debug=full"
"cmake . -DCMAKE_INSTALL_PREFIX=/usr"  is equivalent to "./configure --prefix=/usr"

More details can be found at this url: http://techbase.kde.org/Development/Tutorials/CMake#Environment_Variables

Note: To know KDE install path on your computer, use 'kf5-config --prefix' command line like this (with full debug object enabled):

"cmake . -DCMAKE_BUILD_TYPE=debugfull -DCMAKE_INSTALL_PREFIX=`kf5-config --prefix`"
