Bug 305167

Summary: Add back filenames in html gallery
Product: [Applications] digikam Reporter: Jaan Vajakas <jaanvajakas>
Component: Plugin-Generic-HTMLGalleryAssignee: Digikam Developers <digikam-bugs-null>
Status: RESOLVED NOT A BUG    
Severity: normal CC: caulier.gilles, kde.107-732-241
Priority: NOR    
Version: 5.5.0   
Target Milestone: ---   
Platform: unspecified   
OS: Linux   
Latest Commit: Version Fixed In: 7.0.0
Sentry Crash Report:

Description Jaan Vajakas 2012-08-14 22:03:10 UTC 
In openSUSE 12.2 RC2 which has kipi-plugins version 2.6.0, if I export images as HTML in Gwenview then the web page created only shows thumbnails but does not mention the filenames of the images. The filenames were there in openSUSE 12.1 (with kipi-plugins 2.2.0 I guess). Could you please add the filenames back or create an option for showing them?

Reproducible: Always

Steps to Reproduce:
1. In Gwenview, open an image folder
2. Choose Plugins -> Export -> Export as HTML
3. Select the folder for exporting, click Next.
4. Choose e. g. the Simple theme, click Next.
5. Choose e. g. the Natural style, press Next.
6. Click Next.
7. Click Finish.
(maybe the command names are not exactly correct, since I translated back from Estonian)


Actual Results:  
The created web page has no captions under the thumbnails.

Expected Results:  
I would like the web page to have file names (without extensions) as captions under thumbnails.
Comment 1 Bob 2019-11-25 15:48:59 UTC 
Hello, Jaan.

As of digiKam 6.4.0 (and earlier versions) the HTML gallery plugin does create a gallery.xml file which contains the original filename (with extension) for each image:

<image>
  <title>JO2A2472.JPG</title>
  <description>Interior of Lumley Chapel, Cheam</description>
  <date>2019-09-28T12:44:42</date>
  <full fileName="jo2a2472_jpg.jpeg" height="1200" width="800"/>
  <thumbnail fileName="thumb_jo2a2472_jpg.jpeg" height="600" width="400"/>

This means that a gallery theme does have the option to display the filename below the thumbnails on the image list pages, and it's up to each theme designer (and style within a theme) to decide whether or not to label the thumbnails this way.

Of the HTML gallery themes which come with digiKam 6.4.0, the "Classic", "Frames", "Matrix", "Simple", and "Snow" themes do show the filename (with extension) below each thumbnail. Whilst the "Floating Cards" theme shows the image caption underneath each thumbnail (which looks good for short descriptions but might be a bit awkward for lengthy captions).

I find that the filenames are usually not helpful/appealing as a visual element (because my files are all named by the camera; I don't rename them with a descriptive label, because I use the caption metadata field in digiKam for that). But if you want to see filenames without extensions appear below thumbnails then the only way you're likely to achieve this is to create your own theme and generate HTML and styling to make it look exactly how you need. See this very useful how-to guide for advice on customising your own theme:

https://cgit.kde.org/digikam.git/tree/core/dplugins/generic/tools/htmlgallery/themes/THEME_HOWTO

I'm going to mark this as resolved because gallery appearance is specific to each theme and style, and for any visual style or structure not yet available the possibility exists to create your own.