Jump to content

KPhotoAlbum/gl: Difference between revisions

From KDE Wiki Sandbox
← Older editNewer edit →
FuzzyBot (talk | contribs)
50,556 edits
Updating to match new version of source page
FuzzyBot (talk | contribs)
50,556 edits
Updating to match new version of source page
Line 9: Line 9:
Earlier versions of '''KPhotoAlbum''' were released under the name "KimDaBa". Stable releases are always announced on our [https://www.kphotoalbum.org/news/ news page].
Earlier versions of '''KPhotoAlbum''' were released under the name "KimDaBa". Stable releases are always announced on our [https://www.kphotoalbum.org/news/ news page].


For an introduction, take the [http://kphotoalbum.org/index.php?page=3-minute-tour 3 minute KPhotoAlbum tour] or see the [http://kphotoalbum.org/index.php?page=videos Videos] at [http://kphotoalbum.org/ KPhotoAlbum's Homepage].  To learn more and view some screenshots read the [[Special:myLanguage/KPhotoAlbum FAQ|FAQ]].
For an introduction, take the [https://www.kphotoalbum.org/documentation/3minutetour/3 minute KPhotoAlbum tour] or see the [https://www.kphotoalbum.org/documentation/videos/ Videos] at [https://www.kphotoalbum.org/ KPhotoAlbum's Homepage].  To learn more and view some screenshots read the [[Special:myLanguage/KPhotoAlbum FAQ|FAQ]].


'''KPhotoAlbum''' supports all the normal image formats including raw
'''KPhotoAlbum''' supports all the normal image formats including raw
Line 22: Line 22:


Source packages, binaries for various distros, and snapshots are available from [https://www.kphotoalbum.org/download/ the project Download page].
Source packages, binaries for various distros, and snapshots are available from [https://www.kphotoalbum.org/download/ the project Download page].
{{Install|KPhotoAlbum}}


=== KPhotoAlbum on Live systems ===
=== KPhotoAlbum on Live systems ===
Line 29: Line 31:
* Developer Edition (stable branch) has the ''5.x'' branch.<br/>Most of the time, this should be the same as unstable, but when new features are developed they only arrive in stable after the roughest edges have been smoothed out.
* Developer Edition (stable branch) has the ''5.x'' branch.<br/>Most of the time, this should be the same as unstable, but when new features are developed they only arrive in stable after the roughest edges have been smoothed out.
* Developer Edition (unstable branch) has the ''master'' branch of kphotoalbum.
* Developer Edition (unstable branch) has the ''master'' branch of kphotoalbum.
=== Building KPhotoAlbum ===
Step-by-step guide to build KPhotoAlbum from source code on Debian or Ubuntu are available on page [[Special:myLanguage/Building KPhotoAlbum|Building KPhotoAlbum]].
{{Install|KPhotoAlbum}}


== Extending KPhotoAlbum ==
== Extending KPhotoAlbum ==
Line 43: Line 39:
* Another way to extend '''KPhotoAlbum''' is to write [[Special:myLanguage/KIPI|KIPI plugins]] (that are used also by other KDE photo applications). These plugins provide functions like exporting images to websites like Flickr, Picasa, Facebook, ... correcting exif date stamps or doing some other image manipulations. ('''KPhotoAlbum''' by itself does not touch the original files at all but preserves them intact).
* Another way to extend '''KPhotoAlbum''' is to write [[Special:myLanguage/KIPI|KIPI plugins]] (that are used also by other KDE photo applications). These plugins provide functions like exporting images to websites like Flickr, Picasa, Facebook, ... correcting exif date stamps or doing some other image manipulations. ('''KPhotoAlbum''' by itself does not touch the original files at all but preserves them intact).
* Other useful scripts are available from [http://www.hardakers.net/kphotoalbum/#sec-5 Wes Hardaker's site]
* Other useful scripts are available from [http://www.hardakers.net/kphotoalbum/#sec-5 Wes Hardaker's site]
* With [http://wersdoerfer.com/wicked/Kimdaba2Mysql Kimdaba2Mysql] it's possible to:
<br />
** insert your index.xml metadata into a mysql-database
** generate a search-formular on your website  with your kimdaba-keywords, example [http://wersdoerfer.com/bilder here]<br />


* Patches and features awaiting approval or implementation - Please use [https://bugs.kde.org/ bugs.kde.org] for that.
* Patches and features awaiting approval or implementation - Please use [https://bugs.kde.org/ bugs.kde.org] for that.
Line 51: Line 45:




With [http://www.gowdy.us/pse3/ pse3tokimdaba.pl] it's possible to extract information from your Photoshop Elements 3 database to create an index.xml file. There are quite a few limitations, see the above page for more details.
[http://d200.vmrt.homelinux.com/|djKPA djKPA] is a [http://www.djangoproject.org Django] web site designed to be the web interface of your [http://www.kphotoalbum.org KPhotoAlbum] photo repository.
The philosophy of djKPA is be as far as possible fully automatic: labels, tags, descriptions, ... of photo come from '''KPhotoAlbum'''. Nevertheless, djKPA is a real interactive application that allows your visitors to vote, post comments, show exif, ... and visit your photos by browsing the your Tags.


=== Help develop KPhotoAlbum ===
=== Help develop KPhotoAlbum ===


If you are interested in helping the '''KPhotoAlbum''' development or related projects, please look at  [http://www.kphotoalbum.org/index.php?page=getting-involved this project page]. Or, if you have an idea for a feature, please see the Feature Requests section, below.
If you are interested in helping the '''KPhotoAlbum''' development or related projects, please look at  [https://www.kphotoalbum.org/gettinginvolved/ this project page]. Or, if you have an idea for a feature, please see the Feature Requests section, below.
 
== Developer documentation ==
=== KPA Release Steps ===
 
* Update CMakeLists.txt with the new version number you are just about to tag (alas, our automatic versionning doesn't work anymore {{Smiley}})
 
* Update the ChangeLog to mark the new release and add the key improvements to the list of changes, if they are not already mentioned in the ChangeLog
 
* Update doc/index.docbook to reflect the new release (if the documentation has been updated)<br />{{Input|1=<nowiki><releaseinfo>4.5</releaseinfo></nowiki>}}
 
* Commit the last changes<br />{{Input|1=<nowiki>git commit -v -a</nowiki>}}
 
* Tag the new release and push it out<br />{{Input|1=<nowiki>git tag -a -m "kpa 4.5 released" v4.5
git push
git push --tags</nowiki>}}
 
* Create a tar ball of the released sources using the instructions on the following section (''kphotoalbum.rb --version 4.5'')
 
* Upload the created tar ball to the <tt>incoming</tt> directory of upload.kde.org using an FTP client. The current instructions of notifying administrators of the upload are shown when logging in to the FTP server. You create a ticket and provide SHA sums and some other information of the upload.
 
* Add a new version to Bugzilla (bugs.kde.org, you have to have administrator rights to do this): ''Edit Products → KPhotoAlbum → Add version''
 
* Update the KPA web pages to point to proper source file, you get a link to the mirroring system as when the uploaded tar to KDE FTP server has been processed. The sources of the web page can be checked out from <tt>svn+ssh://svn@svn.kde.org/home/kde/trunk/www/sites/kphotoalbum</tt> via svn.
 
* Publish the release information (KPA's web site, mailing lists, distributor's bugtracking system, social media etc.).
** Don't forget to post on the kde-distro-packagers mailing list, and make sure to mention any changes in dependencies.
** Update the latest version on top of this page.
* Create a video of the cool new features and publish it on Youtube. A nice tool for doing so is [http://recordmydesktop.sourceforge.net/ recordmydesktop]. If you uploaded such a video, don't forget to add it to the Videos page on the homepage (cf. the <tt>README_new_video.txt</tt> file).
 
* Notify people building the binary packages for different distributions
 
=== Building a Release ===
 
Building a snapshot tar ball is rather straight forward. Install the releaseme building tool and run a command to generate the source package.
 
{{Input|1=<nowiki>git clone git://anongit.kde.org/releaseme
cd releaseme</nowiki>}}
To create the source package, run e. g.:
{{Input|1=<nowiki>./tarme.rb --origin trunk --version 5.1 kphotoalbum</nowiki>}}
 
=== GIT Branches ===
 
* ''master'' <br />Current development branch
* ''4.7''<br />Old stable (Qt4/Plasma4) branch. Only gets fixes for serious bugs on a case-by-case basis.
* ''5.x''<br />Branch tracked by [https://community.kde.org/Neon/Builder#The_Packaging Neon/stable].<br />When ''master'' is in stable condition, it should be synced to ''5.x'': {{Input|1=<nowiki>git checkout 5.x ; git merge master</nowiki>}}
* Feature branches are used in a very ad-hoc manner. If you are not a developer, don't bother with them.<br />If you are a developer, try using descriptive names that are not likely to interfere with future branches.


== Known Bugs and feature requests ==
== Known Bugs and feature requests ==


See the list of [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum|Known Bugs] and workarounds in KPhotoAlbum.
See the list of [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum Known Bugs] and workarounds in KPhotoAlbum.


Please use [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum|bugs.kde.org] marking the report as a "Wish".
Please use [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum bugs.kde.org] marking the report as a "Wish".


=== New Ideas for Future Versions ===
=== New Ideas for Future Versions ===

Revision as of 06:01, 8 February 2019

Other languages:
KPhotoAlbum is a tool which you can use to easily sort your images. It provides many capabilities to make sorting and viewing images easy.

Earlier versions of KPhotoAlbum were released under the name "KimDaBa". Stable releases are always announced on our news page.

For an introduction, take the minute KPhotoAlbum tour or see the Videos at KPhotoAlbum's Homepage. To learn more and view some screenshots read the FAQ.

KPhotoAlbum supports all the normal image formats including raw formats produced by most digital cameras and scanners (using dcraw to do the decoding). It is also possible to use the thumbnails embedded in raw images (that are usually of decent size and quality) for fast viewing so there is no need to decode the whole raw image.

Using KPhotoAlbum

There is a 3-minute Tour and a set of How-To videos on the project site. A KPhotoAlbum handbook is also available as a PDF and on-line version.

Getting KPhotoAlbum

Source packages, binaries for various distros, and snapshots are available from the project Download page.

Installation Instructions

If you need help to install KPhotoAlbum, look at this tutorial about how to install KDE software.


KPhotoAlbum on Live systems

KPhotoAlbum is available in Neon:

  • User Edition has the latest release
  • Developer Edition (stable branch) has the 5.x branch.
    Most of the time, this should be the same as unstable, but when new features are developed they only arrive in stable after the roughest edges have been smoothed out.
  • Developer Edition (unstable branch) has the master branch of kphotoalbum.

Extending KPhotoAlbum

  • Image::Kimdaba is a perl module available on CPAN which parses the index.xml database.
  • Another way to extend KPhotoAlbum is to write KIPI plugins (that are used also by other KDE photo applications). These plugins provide functions like exporting images to websites like Flickr, Picasa, Facebook, ... correcting exif date stamps or doing some other image manipulations. (KPhotoAlbum by itself does not touch the original files at all but preserves them intact).
  • Other useful scripts are available from Wes Hardaker's site


  • Patches and features awaiting approval or implementation - Please use bugs.kde.org for that.



Help develop KPhotoAlbum

If you are interested in helping the KPhotoAlbum development or related projects, please look at this project page. Or, if you have an idea for a feature, please see the Feature Requests section, below.

Known Bugs and feature requests

See the list of Known Bugs and workarounds in KPhotoAlbum.

Please use bugs.kde.org marking the report as a "Wish".

New Ideas for Future Versions

If you have a new idea for KPhotoAlbum and think that bugs.kde.org is not the right place for it, use one of the communication channels listed on the pages.

Retrieved from "https://wikisandbox.kde.org/index.php?title=KPhotoAlbum/gl&oldid=414819"