KPhotoAlbum/es: Difference between revisions

    From KDE UserBase Wiki
    (Updating to match new version of source page)
    (Updating to match new version of source page)
    Line 15: Line 15:
    necesidad de decodificar la imagen raw completa.
    necesidad de decodificar la imagen raw completa.


    ==Documentación==
    == Using KPhotoAlbum ==


    There is a [http://www.kphotoalbum.org/index.php?page=3-minute-tour 3-minute Tour] and a set of [http://www.kphotoalbum.org/index.php?page=videos How-To videos] on the project site. A '''KPhotoAlbum''' handbook is also available as a [http://docs.kde.org/development/en/extragear-graphics/kphotoalbum/kphotoalbum.pdf PDF] and [http://docs.kde.org/development/en/extragear-graphics/kphotoalbum/index.html on-line version].
    There is a [http://www.kphotoalbum.org/index.php?page=3-minute-tour 3-minute Tour] and a set of [http://www.kphotoalbum.org/index.php?page=videos How-To videos] on the project site. A '''KPhotoAlbum''' handbook is also available as a [http://docs.kde.org/development/en/extragear-graphics/kphotoalbum/kphotoalbum.pdf PDF] and [http://docs.kde.org/development/en/extragear-graphics/kphotoalbum/index.html on-line version].


    == Descargas de KPhotoAlbum ==
    == Getting KPhotoAlbum ==


    Los paquetes con el código fuente, binarios para varias distribuciones e instantáneas del código están disponibles en [http://www.kphotoalbum.org/index.php?page=download la página de descargas del proyecto].
    Los paquetes con el código fuente, binarios para varias distribuciones e instantáneas del código están disponibles en [http://www.kphotoalbum.org/index.php?page=download la página de descargas del proyecto].


    == KPhotoAlbum en sistemas Live como Knoppix ==
    === KPhotoAlbum on Live systems like Knoppix ===


    You can use an image file (or create your own) which integrates '''KPhotoAlbum''' in a Knoppix CD/DVD if '''KPhotoAlbum''' is missing there.  The details can be found on the page [[Special:myLanguage/KPhotoAlbum on Knoppix|KPhotoAlbum on Knoppix]].
    You can use an image file (or create your own) which integrates '''KPhotoAlbum''' in a Knoppix CD/DVD if '''KPhotoAlbum''' is missing there.  The details can be found on the page [[Special:myLanguage/KPhotoAlbum on Knoppix|KPhotoAlbum on Knoppix]].
    Line 59: Line 59:


    * Update CMakeLists.txt with the new version number you are just about to tag (alas, our automatic versionning doesn't work anymore ;-)
    * Update CMakeLists.txt with the new version number you are just about to tag (alas, our automatic versionning doesn't work anymore ;-)
    * 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 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>}}
    * Update doc/index.docbook to reflect the new release (if the documentation has been updated)
    * Commit the last changes<br/>{{Input|1=<nowiki>git commit -v -a</nowiki>}}
    {{Input|1=<nowiki><releaseinfo>4.5</releaseinfo></nowiki>}}
    * Tag the new release and push it out<br/>{{Input|1=<nowiki>git tag -a -m "kpa 4.5 released" v4.5
     
    * Commit the last changes
    {{Input|1=<nowiki>git commit -v -a</nowiki>}}
     
    * Tag the new release and push it out
    {{Input|1=<nowiki>git tag -a -m "kpa 4.5 released" v4.5
    git push
    git push
    git push --tags</nowiki>}}
    git push --tags</nowiki>}}
    * Create a tar ball of the released sources using the instructions on the following section (''kphotoalbum.rb --version 4.5'')
    * 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.
    * 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''
    * 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://[email protected]/home/kde/trunk/www/sites/kphotoalbum</tt> via svn.
    * 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://[email protected]/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.).
    * 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.
    * 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).
    * 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
    * Notify people building the binary packages for different distributions


    Line 101: Line 87:
    {{Input|1=<nowiki>./kphotoalbum.rb --version 4.6.2</nowiki>}}
    {{Input|1=<nowiki>./kphotoalbum.rb --version 4.6.2</nowiki>}}


    ==Fallos conocidos==
    === GIT Branches ===
     
    * ''master'' ([https://build.kde.org/job/kphotoalbum%20master%20kf5-qt5/PLATFORM=Linux,compiler=gcc build status])<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 ==


    Puedes ver una lista de [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum Fallos conocidos] y soluciones en KPhotoAlbum.
    Puedes ver una lista de [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum Fallos conocidos] y soluciones en KPhotoAlbum.

    Revision as of 16:30, 16 December 2016

    KPhotoAlbum es una herramienta que puedes usar para ordenar fácilmente tus imágenes. Tiene muchas características para hacer que la clasificación y visualización de imágenes sea sencilla.

    Earlier versions of KPhotoAlbum were released under the name "KimDaBa". The current stable release is KPhotoAlbum version 4.7.2 (as of December 2016), and the current beta version is 5.0.1.

    Para una introducción, visita el Tour de 3 minutos sobre KPhotoAlbum o los Vídeos en la página de KPhotoAlbum. Para obtener más información y ver algunas imágenes lee Preguntas más frecuentes.

    KPhotoAlbum es compatible con todos los formatos de imágenes normales, incluyendo los formatos raw producidos por la mayoría de cámaras digitales y escáneres (usando dcraw para hacer la decodificación). También es posible utilizar las miniaturas incrustadas en las imágenes raw (que normalmente tienen un tamaño y calidad decentes) para una visualización rápida, por lo que no hay necesidad de decodificar la imagen raw completa.

    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

    Los paquetes con el código fuente, binarios para varias distribuciones e instantáneas del código están disponibles en la página de descargas del proyecto.

    KPhotoAlbum on Live systems like Knoppix

    You can use an image file (or create your own) which integrates KPhotoAlbum in a Knoppix CD/DVD if KPhotoAlbum is missing there. The details can be found on the page KPhotoAlbum on Knoppix.

    Building KPhotoAlbum

    Step-by-step guide to build KPhotoAlbum from source code on Debian or Ubuntu are available on page Building KPhotoAlbum.

    Extensiones de 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
    • With Kimdaba2Mysql it's possible to:
      • insert your index.xml metadata into a mysql-database
      • generate a search-formular on your website with your kimdaba-keywords, example here
    • Patches and features awaiting approval or implementation - Please use bugs.kde.org for that.


    Con pse3tokimdaba.pl es posible extraer información de tu base de datos de Photoshop Elements 3 para crear un archivo index.xml. Hay muy pocas limitaciones, visita la página anterior para más detalles.

    djKPA is a Django web site designed to be the web interface of your 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

    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.

    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 ;-)
    • 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)
      <releaseinfo>4.5</releaseinfo>
    • Commit the last changes
      git commit -v -a
    • Tag the new release and push it out
      git tag -a -m "kpa 4.5 released" v4.5
      git push
      git push --tags
    • 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 incoming 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 svn+ssh://[email protected]/home/kde/trunk/www/sites/kphotoalbum 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 recordmydesktop. If you uploaded such a video, don't forget to add it to the Videos page on the homepage (cf. the README_new_video.txt 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. As long as KPhotoAlbum is based on KDE 4, it's necessary to use the kdelibs4 branch.

    git clone git://anongit.kde.org/releaseme
    cd releaseme
    git checkout kdelibs4

    To create the source package, run e. g.:

    ./kphotoalbum.rb --version `date +%Y%m%d`

    If a source package for a specific tagged version should be built, use that version number instead, e. g.:

    ./kphotoalbum.rb --version 4.6.2

    GIT Branches

    • master (build status)
      Current development branch
    • 4.7
      Old stable (Qt4/Plasma4) branch. Only gets fixes for serious bugs on a case-by-case basis.
    • 5.x
      Branch tracked by Neon/stable.
      When master is in stable condition, it should be synced to 5.x:
      git checkout 5.x ; git merge master
    • Feature branches are used in a very ad-hoc manner. If you are not a developer, don't bother with them.
      If you are a developer, try using descriptive names that are not likely to interfere with future branches.

    Known Bugs and feature requests

    Puedes ver una lista de Fallos conocidos y soluciones en KPhotoAlbum.

    Please use [1] marking the report as a "Wish".

    New Ideas for Future Versions

    Si tienes una nueva idea para KPhotoAlbum y piensas que bugs.kde.org no es el lugar adecuado, usa uno de canales de comunicación que aparecen en las páginas.