digikam-doc/post_processing/jalbum_export.rst

0001 .. meta::
0002    :description: The digiKam JAlbum Export
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, jalbum, gallery, export
0004
0005 .. metadata-placeholder
0006
0007    :authors: - digiKam Team
0008
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0010
0011 .. _jalbum_export:
0012
0013 JAlbum Export
0014 =============
0015
0016 The JAlbum Export tool allows to create metadata for a set on digiKam items to use in the Java-based `JAlbum HTML Gallery Generator <https://en.wikipedia.org/wiki/JAlbum>`_. The `Java virtual machine <https://en.wikipedia.org/wiki/Java_virtual_machine>`_ and the JAlbum program must be installed previously on your computer as run-time dependencies of this tool.
0017
0018 To run this tool, choose :menuselection:`Tools --> Create JAlbum Gallery` menu entry, or click on **Create JAlbum Gallery** icon from **Tools** tab in **Right Sidebar**.
0019
0020 .. figure:: images/jalbum_export_selection.webp
0021     :alt:
0022     :align: center
0023
0024     The Selection of Item to export to JAlbum Gallery Generator
0025
0026 This opens the JAlbum Export wizard that guides you through the entire process. This first page allows to use the items selection method: from **Images** currently selected in digiKam, or from **Albums** hosted in your collections. This page also verifies the availability of **JAlbum** and **Java** binary programs.
0027
0028 .. figure:: images/jalbum_export_page1.webp
0029     :alt:
0030     :align: center
0031
0032     The JAlbum Export Wizard Welcome Page
0033
0034 The second page of this wizard allows to review the list of images, or albums contents to export in the JAlbum HTML gallery generator. When selection is done, press the **Next** button.
0035
0036 .. figure:: images/jalbum_export_page2.webp
0037     :alt:
0038     :align: center
0039
0040     The JAlbum Export Wizard Items Selection Page
0041
0042 The third page will configure the JAlbum settings to export contents. Here you can configure the **Project Title** and the **Projects folder** where files must be generated.
0043
0044 .. figure:: images/jalbum_export_page3.webp
0045     :alt:
0046     :align: center
0047
0048     The JAlbum Export Wizard Settings Page
0049
0050 The fourth page will show all stages to generate files to export to JAlbum. When all is completed, the JAlbum
0051
0052 .. figure:: images/jalbum_export_page4.webp
0053     :alt:
0054     :align: center
0055
0056     The JAlbum Export Wizard Preparing Output Files
0057
0058 When all tasks are completed, the JAlbum Application is started with all files exported from digiKam. At this time, you can close the JAlbum Export tool and continue to work with JAlbum application.
0059
0060 .. figure:: images/jalbum_export_gallery.webp
0061     :alt:
0062     :align: center
0063
0064     The JAlbum Application Started with the Exported Files from digiKam