From 04a1bff55ff08bd59ad07115f6abc2e3de31cca0 Mon Sep 17 00:00:00 2001 From: Colin Clark Date: Wed, 29 Dec 2021 15:34:11 +0000 Subject: [PATCH] Update documentation - increase Doxygen usage - Delete redundant files and folders - Delete ufraw - not updated for 5 years - Include .sh, .pl, .awk, .md files in Doxygen output - Update language translations - Various documentation updates - Include --list option for geeqie-install-debian.sh --- CHECKLIST.md | 16 +- CODING.md | 154 +- README.md | 207 +- ZoneDetect.md | 8 +- appimages/README.md | 1 + configure.ac | 1 - doc/Makefile.am | 2 +- doc/create-doxygen-lua-api.sh | 24 +- doc/docbook/GuideReferenceStandardPlugins.xml | 32 - doc/docbook2html.sh | 7 - doxygen.conf | 13 +- geeqie-install-debian.sh | 644 +- gen_changelog.sh | 14 +- gen_readme.sh | 21 +- keymap/hardcoded_keys | 29 - keymap/keymap.awk | 106 - keymap/keymap.pl | 63 - keymap/keymap_template.svg | 11665 ---------------- plugins/Makefile.am | 2 +- plugins/camera-import/geeqie-camera-import | 7 +- .../geeqie-camera-import-hook-script | 4 +- .../geeqie-camera-import-hook-script.sh | 1 + plugins/camera-import/geeqie-camera-import.sh | 1 + plugins/export-jpeg/geeqie-export-jpeg | 16 +- plugins/export-jpeg/geeqie-export-jpeg.sh | 1 + .../geocode-parameters/geocode-parameters.awk | 26 +- plugins/image-crop/geeqie-image-crop | 10 +- plugins/image-crop/geeqie-image-crop.sh | 1 + plugins/random-image/geeqie-random-image | 6 +- plugins/random-image/geeqie-random-image.sh | 1 + plugins/rotate/geeqie-rotate | 7 +- plugins/rotate/geeqie-rotate.sh | 1 + plugins/symlink/geeqie-symlink | 8 +- plugins/symlink/geeqie-symlink.sh | 1 + .../geeqie-tethered-photography | 19 +- .../geeqie-tethered-photography-hook-script | 4 +- ...geeqie-tethered-photography-hook-script.sh | 1 + .../geeqie-tethered-photography.sh | 1 + plugins/ufraw/Makefile.am | 13 - plugins/ufraw/geeqie-ufraw | 215 - plugins/ufraw/geeqie-ufraw-id.desktop.in | 24 - .../ufraw/geeqie-ufraw-recursive.desktop.in | 23 - plugins/ufraw/geeqie-ufraw.desktop.in | 26 - po/POTFILES.in | 8 +- po/ar.po | 3180 +++-- po/be.po | 3185 +++-- po/bg.po | 3177 +++-- po/ca.po | 3223 +++-- po/cs.po | 3199 +++-- po/da.po | 3165 +++-- po/de.po | 3191 +++-- po/el.po | 3207 +++-- po/en_GB.po | 6269 +++++---- po/eo.po | 3175 +++-- po/es.po | 3216 +++-- po/et.po | 3173 +++-- po/eu.po | 3175 +++-- po/fi.po | 3276 +++-- po/fr.po | 3193 +++-- po/gen_translations_stats.sh | 7 +- po/hu.po | 3283 +++-- po/id.po | 3173 +++-- po/it.po | 3173 +++-- po/ja.po | 3183 +++-- po/ko.po | 3077 ++-- po/nb.po | 3173 +++-- po/nl.po | 3228 +++-- po/pl.po | 3203 +++-- po/pt_BR.po | 3195 +++-- po/regen_potfiles.sh | 8 +- po/ro.po | 3200 +++-- po/ru.po | 3204 +++-- po/sk.po | 3320 +++-- po/sl.po | 3167 +++-- po/sr.po | 3191 +++-- po/sr@latin.po | 3191 +++-- po/sv.po | 3200 +++-- po/th.po | 3173 +++-- po/tlh.po | 3016 ++-- po/tr.po | 3208 +++-- po/uk.po | 3173 +++-- po/vi.po | 3181 +++-- po/zh_CN.po | 3152 +++-- po/zh_TW.po | 3284 +++-- scripts/check-compiles.sh | 11 +- scripts/decode_sim | 13 + scripts/decode_sim.pl | 1 + scripts/doxygen-help.sh | 62 +- scripts/generate-appimage.sh | 16 +- scripts/generate-man-page.sh | 13 +- scripts/keyword_merge.sh | 17 +- scripts/template-desktop.sh | 14 +- ...e_database => create_timezone_database.sh} | 24 +- src/editors.c | 1 - src/filefilter.c | 1 - src/layout_util.c | 2 +- src/options.c | 2 +- web/default.css | 28 - web/features.html | 108 - web/geeqie-install-debian.sh | 602 - web/help/Cancelbutton.html | 464 - web/help/Commandline.html | 483 - web/help/ExifRotation.html | 500 - web/help/Features.html | 522 - web/help/GuideCollections.html | 564 - web/help/GuideColorManagement.html | 454 - web/help/GuideCredits.html | 457 - web/help/GuideEditorsConfig.html | 715 - web/help/GuideFaq.html | 470 - web/help/GuideGnuFdl.html | 791 -- web/help/GuideImageManagement.html | 471 - web/help/GuideImageManagementCopyMove.html | 608 - web/help/GuideImageManagementDelete.html | 514 - .../GuideImageManagementExternalEditing.html | 479 - web/help/GuideImageManagementPlugins.html | 478 - web/help/GuideImageManagementRename.html | 554 - web/help/GuideImageMarks.html | 495 - web/help/GuideImagePresentation.html | 463 - .../GuideImagePresentationFullscreen.html | 539 - web/help/GuideImagePresentationSlideshow.html | 612 - web/help/GuideImageSearch.html | 473 - web/help/GuideImageSearchCache.html | 477 - .../GuideImageSearchFindingDuplicates.html | 669 - web/help/GuideImageSearchSearch.html | 722 - web/help/GuideIndex-info.html | 497 - web/help/GuideIndex.html | 705 - web/help/GuideIntroduction.html | 461 - web/help/GuideLicence.html | 456 - web/help/GuideMainWindow.html | 511 - web/help/GuideMainWindowFilePane.html | 688 - web/help/GuideMainWindowFolderPane.html | 940 -- web/help/GuideMainWindowImagePane.html | 668 - web/help/GuideMainWindowLayout.html | 534 - web/help/GuideMainWindowMenus.html | 1405 -- web/help/GuideMainWindowNavigation.html | 510 - web/help/GuideMainWindowStatusBar.html | 681 - web/help/GuideOptionsAdditional.html | 470 - web/help/GuideOptionsBehavior.html | 708 - web/help/GuideOptionsColor.html | 502 - web/help/GuideOptionsFiltering.html | 653 - web/help/GuideOptionsGeneral.html | 700 - web/help/GuideOptionsHidden.html | 501 - web/help/GuideOptionsImage.html | 615 - web/help/GuideOptionsKeyboard.html | 470 - web/help/GuideOptionsKeywords.html | 491 - web/help/GuideOptionsLayout.html | 536 - web/help/GuideOptionsMain.html | 514 - web/help/GuideOptionsMetadata.html | 665 - web/help/GuideOptionsOSD.html | 688 - web/help/GuideOptionsStereo.html | 468 - web/help/GuideOptionsSteroa.html | 465 - web/help/GuideOptionsToolbar.html | 481 - web/help/GuideOptionsWindow.html | 588 - web/help/GuideOtherWindows.html | 477 - web/help/GuideOtherWindowsExif.html | 472 - web/help/GuideOtherWindowsImageWindow.html | 534 - web/help/GuideOtherWindowsPanView.html | 645 - web/help/GuidePluginsConfig.html | 722 - web/help/GuidePrinting.html | 493 - web/help/GuideReference.html | 510 - web/help/GuideReferenceCommandLine.html | 786 -- web/help/GuideReferenceConfig.html | 532 - web/help/GuideReferenceDecodeLatLong.html | 490 - web/help/GuideReferenceKeyboardShortcuts.html | 2033 --- web/help/GuideReferenceLIRC.html | 575 - web/help/GuideReferenceLua.html | 590 - web/help/GuideReferenceManagement.html | 569 - web/help/GuideReferenceMetadata.html | 596 - web/help/GuideReferencePCRE.html | 479 - web/help/GuideReferencePixbufLoaders.html | 533 - web/help/GuideReferenceStandards.html | 493 - web/help/GuideReferenceSupportedFormats.html | 479 - web/help/GuideReferenceThumbnails.html | 512 - web/help/GuideReferenceUTC.html | 485 - web/help/GuideReferenceXmpExif.html | 1350 -- web/help/GuideSidebars.html | 466 - web/help/GuideSidebarsInfo.html | 913 -- web/help/GuideSidebarsSortManager.html | 601 - web/help/Imageviewing.html | 472 - web/help/Layouttab.html | 513 - web/help/Miscellaneous.html | 486 - web/help/Papertab.html | 503 - web/help/Preview.html | 515 - web/help/Printbutton.html | 464 - web/help/Printertab.html | 529 - web/help/Rememberprintsettings.html | 464 - web/help/Texttab.html | 511 - web/index.html | 105 - web/installing.html | 157 - web/screenshots/.llgal/llgal.css | 163 - web/screenshots/readme.txt | 4 - web/screenshots/screenshots.html | 137 - web/screenshots/slide_01.html | 51 - web/screenshots/slide_02.html | 51 - web/screenshots/slide_03.html | 51 - web/screenshots/slide_04.html | 51 - web/screenshots/slide_05.html | 51 - web/screenshots/slide_06.html | 51 - web/screenshots/slide_07.html | 51 - web/screenshots/slide_08.html | 51 - web/screenshots/slide_09.html | 51 - web/screenshots/slide_10.html | 51 - web/screenshots/slide_11.html | 51 - web/screenshots/slide_12.html | 51 - web/screenshots/slide_13.html | 51 - web/screenshots/slide_14.html | 51 - web/screenshots/slide_15.html | 51 - web/screenshots/slide_16.html | 51 - web/screenshots/slide_17.html | 51 - web/screenshots/slide_18.html | 51 - web/screenshots/slide_19.html | 51 - web/screenshots/slide_20.html | 51 - web/screenshots/slide_21.html | 51 - web/screenshots/slide_22.html | 51 - web/tidy.conf | 7 - web/upload.sh | 32 - 216 files changed, 66892 insertions(+), 124888 deletions(-) delete mode 100755 doc/docbook2html.sh mode change 120000 => 100755 geeqie-install-debian.sh delete mode 100644 keymap/hardcoded_keys delete mode 100644 keymap/keymap.awk delete mode 100755 keymap/keymap.pl delete mode 100644 keymap/keymap_template.svg create mode 120000 plugins/camera-import/geeqie-camera-import-hook-script.sh create mode 120000 plugins/camera-import/geeqie-camera-import.sh create mode 120000 plugins/export-jpeg/geeqie-export-jpeg.sh create mode 120000 plugins/image-crop/geeqie-image-crop.sh create mode 120000 plugins/random-image/geeqie-random-image.sh create mode 120000 plugins/rotate/geeqie-rotate.sh create mode 120000 plugins/symlink/geeqie-symlink.sh create mode 120000 plugins/tethered-photography/geeqie-tethered-photography-hook-script.sh create mode 120000 plugins/tethered-photography/geeqie-tethered-photography.sh delete mode 100644 plugins/ufraw/Makefile.am delete mode 100755 plugins/ufraw/geeqie-ufraw delete mode 100644 plugins/ufraw/geeqie-ufraw-id.desktop.in delete mode 100644 plugins/ufraw/geeqie-ufraw-recursive.desktop.in delete mode 100644 plugins/ufraw/geeqie-ufraw.desktop.in create mode 120000 scripts/decode_sim.pl rename scripts/zonedetect/{create_timezone_database => create_timezone_database.sh} (84%) delete mode 100644 web/default.css delete mode 100644 web/features.html delete mode 100755 web/geeqie-install-debian.sh delete mode 100644 web/help/Cancelbutton.html delete mode 100644 web/help/Commandline.html delete mode 100644 web/help/ExifRotation.html delete mode 100644 web/help/Features.html delete mode 100644 web/help/GuideCollections.html delete mode 100644 web/help/GuideColorManagement.html delete mode 100644 web/help/GuideCredits.html delete mode 100644 web/help/GuideEditorsConfig.html delete mode 100644 web/help/GuideFaq.html delete mode 100644 web/help/GuideGnuFdl.html delete mode 100644 web/help/GuideImageManagement.html delete mode 100644 web/help/GuideImageManagementCopyMove.html delete mode 100644 web/help/GuideImageManagementDelete.html delete mode 100644 web/help/GuideImageManagementExternalEditing.html delete mode 100644 web/help/GuideImageManagementPlugins.html delete mode 100644 web/help/GuideImageManagementRename.html delete mode 100644 web/help/GuideImageMarks.html delete mode 100644 web/help/GuideImagePresentation.html delete mode 100644 web/help/GuideImagePresentationFullscreen.html delete mode 100644 web/help/GuideImagePresentationSlideshow.html delete mode 100644 web/help/GuideImageSearch.html delete mode 100644 web/help/GuideImageSearchCache.html delete mode 100644 web/help/GuideImageSearchFindingDuplicates.html delete mode 100644 web/help/GuideImageSearchSearch.html delete mode 100644 web/help/GuideIndex-info.html delete mode 100644 web/help/GuideIndex.html delete mode 100644 web/help/GuideIntroduction.html delete mode 100644 web/help/GuideLicence.html delete mode 100644 web/help/GuideMainWindow.html delete mode 100644 web/help/GuideMainWindowFilePane.html delete mode 100644 web/help/GuideMainWindowFolderPane.html delete mode 100644 web/help/GuideMainWindowImagePane.html delete mode 100644 web/help/GuideMainWindowLayout.html delete mode 100644 web/help/GuideMainWindowMenus.html delete mode 100644 web/help/GuideMainWindowNavigation.html delete mode 100644 web/help/GuideMainWindowStatusBar.html delete mode 100644 web/help/GuideOptionsAdditional.html delete mode 100644 web/help/GuideOptionsBehavior.html delete mode 100644 web/help/GuideOptionsColor.html delete mode 100644 web/help/GuideOptionsFiltering.html delete mode 100644 web/help/GuideOptionsGeneral.html delete mode 100644 web/help/GuideOptionsHidden.html delete mode 100644 web/help/GuideOptionsImage.html delete mode 100644 web/help/GuideOptionsKeyboard.html delete mode 100644 web/help/GuideOptionsKeywords.html delete mode 100644 web/help/GuideOptionsLayout.html delete mode 100644 web/help/GuideOptionsMain.html delete mode 100644 web/help/GuideOptionsMetadata.html delete mode 100644 web/help/GuideOptionsOSD.html delete mode 100644 web/help/GuideOptionsStereo.html delete mode 100644 web/help/GuideOptionsSteroa.html delete mode 100644 web/help/GuideOptionsToolbar.html delete mode 100644 web/help/GuideOptionsWindow.html delete mode 100644 web/help/GuideOtherWindows.html delete mode 100644 web/help/GuideOtherWindowsExif.html delete mode 100644 web/help/GuideOtherWindowsImageWindow.html delete mode 100644 web/help/GuideOtherWindowsPanView.html delete mode 100644 web/help/GuidePluginsConfig.html delete mode 100644 web/help/GuidePrinting.html delete mode 100644 web/help/GuideReference.html delete mode 100644 web/help/GuideReferenceCommandLine.html delete mode 100644 web/help/GuideReferenceConfig.html delete mode 100644 web/help/GuideReferenceDecodeLatLong.html delete mode 100644 web/help/GuideReferenceKeyboardShortcuts.html delete mode 100644 web/help/GuideReferenceLIRC.html delete mode 100644 web/help/GuideReferenceLua.html delete mode 100644 web/help/GuideReferenceManagement.html delete mode 100644 web/help/GuideReferenceMetadata.html delete mode 100644 web/help/GuideReferencePCRE.html delete mode 100644 web/help/GuideReferencePixbufLoaders.html delete mode 100644 web/help/GuideReferenceStandards.html delete mode 100644 web/help/GuideReferenceSupportedFormats.html delete mode 100644 web/help/GuideReferenceThumbnails.html delete mode 100644 web/help/GuideReferenceUTC.html delete mode 100644 web/help/GuideReferenceXmpExif.html delete mode 100644 web/help/GuideSidebars.html delete mode 100644 web/help/GuideSidebarsInfo.html delete mode 100644 web/help/GuideSidebarsSortManager.html delete mode 100644 web/help/Imageviewing.html delete mode 100644 web/help/Layouttab.html delete mode 100644 web/help/Miscellaneous.html delete mode 100644 web/help/Papertab.html delete mode 100644 web/help/Preview.html delete mode 100644 web/help/Printbutton.html delete mode 100644 web/help/Printertab.html delete mode 100644 web/help/Rememberprintsettings.html delete mode 100644 web/help/Texttab.html delete mode 100644 web/index.html delete mode 100644 web/installing.html delete mode 100644 web/screenshots/.llgal/llgal.css delete mode 100644 web/screenshots/readme.txt delete mode 100644 web/screenshots/screenshots.html delete mode 100644 web/screenshots/slide_01.html delete mode 100644 web/screenshots/slide_02.html delete mode 100644 web/screenshots/slide_03.html delete mode 100644 web/screenshots/slide_04.html delete mode 100644 web/screenshots/slide_05.html delete mode 100644 web/screenshots/slide_06.html delete mode 100644 web/screenshots/slide_07.html delete mode 100644 web/screenshots/slide_08.html delete mode 100644 web/screenshots/slide_09.html delete mode 100644 web/screenshots/slide_10.html delete mode 100644 web/screenshots/slide_11.html delete mode 100644 web/screenshots/slide_12.html delete mode 100644 web/screenshots/slide_13.html delete mode 100644 web/screenshots/slide_14.html delete mode 100644 web/screenshots/slide_15.html delete mode 100644 web/screenshots/slide_16.html delete mode 100644 web/screenshots/slide_17.html delete mode 100644 web/screenshots/slide_18.html delete mode 100644 web/screenshots/slide_19.html delete mode 100644 web/screenshots/slide_20.html delete mode 100644 web/screenshots/slide_21.html delete mode 100644 web/screenshots/slide_22.html delete mode 100644 web/tidy.conf delete mode 100755 web/upload.sh diff --git a/CHECKLIST.md b/CHECKLIST.md index 9d93ed41..149e3d75 100644 --- a/CHECKLIST.md +++ b/CHECKLIST.md @@ -1,4 +1,4 @@ -# A checklist to be used after Geeqie has been updated +# Checklist for new releases of Geeqie ## Before compiling the sources, carry out the following actions when necessary @@ -18,7 +18,13 @@ cd ./po make update-po ``` -* Update the the timezone database +* Update the desktop template if menus have changed + +```sh +./scripts/template-desktop.sh +``` + +* Update the the timezone database if the underlying database has changed significantly ```sh ./scripts/zonedetect/create_timezone_database @@ -28,19 +34,19 @@ make update-po ## After compiling the sources, carry out the following actions when necessary -* Update the man page and Command Line Options section in Help +* Update the man page and Command Line Options section in Help if the command line options have changed ```sh ./scripts/generate-man-page.sh ``` -* Update the keyboard shortcuts page in Help +* Update the keyboard shortcuts page in Help if any keyboard shortcuts have changed ```sh ./doc/create-shortcuts-xml.sh ``` -* Commit the changes +* Commit the changes and push to the .repo * Generate a new AppImage (note that this should be run on a **20.04 system**) diff --git a/CODING.md b/CODING.md index de2c3996..ac999c8b 100644 --- a/CODING.md +++ b/CODING.md @@ -3,9 +3,13 @@ [Error Logging](#error-logging) [GPL header](#gpl-header) [Git change log](#git-change-log) -[Sources](#sources) -[Software Tools](#software-tools) +[Source Code Style](#source-code-style) +[External Software Tools](#external-software-tools) +[Geeqie Software Tools](#geeqie-software-tools) [Documentation](#documentation) +[Documentation - C code](#c-code) +[Documentation - Script files](#script-files) +[Doxygen](#doxygen) --- @@ -95,7 +99,7 @@ Also please use your full name and a working e-mail address as author for any co --- -## Sources +## Source Code Style Indentation: tabs at 4 spaces @@ -112,38 +116,38 @@ Conditions, cycles: ```c if () - { - ; - ... - ; - } + { + ; + ... + ; + } else - { - ; - ... - ; - } + { + ; + ... + ; + } if ( && ) ; switch () - { - case 0: - ; - ; - break; - case 1: - ; break; - } + { + case 0: + ; + ; + break; + case 1: + ; break; + } for (i = 0; i <= 10; i++) - { - ; - ... - ; - } + { + ; + ... + ; + } ``` Functions: @@ -151,18 +155,18 @@ Functions: ```c gint bar(, , ) { - ; - ... - ; + ; + ... + ; - return 0; // i.e. SUCCESS; if error, you must return minus @FIXME + return 0; // i.e. SUCCESS; if error, you must return minus @FIXME } void bar2(void) { - ; - ... - ; + ; + ... + ; } ``` @@ -194,7 +198,7 @@ Use glib functions when possible (i.e. `g_ascii_isspace()` instead of `isspace() Check if used functions are not deprecated. --- -## Software Tools +## External Software Tools ### astyle @@ -216,10 +220,6 @@ align-pointer=name align-reference=name ``` -### check-compiles.sh - -This shell script is part of the Geeqie project and will compile Geeqie with various options. - ### cppcheck A lint-style program may be used, e.g. @@ -237,25 +237,19 @@ unusedFunction unmatchedSuppression ``` -### generate-man-page.sh +### markdownlint -This script is part of the Geeqie project and should be used to generate the Geeqie man page from Geeqie's command line -help output and also update the Command Line Options section of the Help files. -The programs help2man and doclifter are required - both are available as .deb packages. +Markdown documents may be validated with e.g. [markdownlint](https://github.com/markdownlint/markdownlint). ```sh -./scripts/generate-man-page.sh +mdl --style - - - - -
-

Cancel button

- -

Activate this button to close the print dialog, no printing will be performed.

-
- - - diff --git a/web/help/Commandline.html b/web/help/Commandline.html deleted file mode 100644 index 5ff8bd64..00000000 --- a/web/help/Commandline.html +++ /dev/null @@ -1,483 +0,0 @@ - - - - -Command line - - - - - - - - -
-

Command line

- -

- -
-

14.2.1. How do I open an image in an existing Geeqie application ?

-

Use the “--remote” command line option to send commands to an existing Geeqie, for a list of commands supported by the remote switch run:

-
geeqie --remote-help
-

-
-
-

14.2.2. How do I set the slide show delay when starting Geeqie in slide show from the command line ?

-

The delay can not be set when used with the standard --slideshow command line switch, as --slideshow uses the delay stored in the configuration file.

-

For this, use the remote command --slideshow-start to start the slide show after setting the delay with --delay=. The order of the command line is important. For example for a 12 second slide show delay use:

-
geeqie --remote  --delay=12 --slideshow-start
-

Note that if geeqie is running prior to this command, the slide show should also be stopped prior to changing the delay:

-
geeqie --remote --slideshow-stop --delay=12 --slideshow-start
-

-
-
- - - diff --git a/web/help/ExifRotation.html b/web/help/ExifRotation.html deleted file mode 100644 index e38a6ecd..00000000 --- a/web/help/ExifRotation.html +++ /dev/null @@ -1,500 +0,0 @@ - - - - -Exif Auto Rotation - - - - - - - - -
-

Exif Auto Rotation

- -

- -
-

14.4.1. How do the Exif auto-rotation commands work?

-

- Image auto-rotation works in either of two modes, set by - Write altered image orientation to the metadata - option. -

-

- Write altered image orientation to the metadata not set -

- If you change the orientation of an image using any of the available commands, the image will always be displayed in the modified orientation. This new orientation is stored in temporary data structures associated with each image file. When Geeqie closes, these changes will be lost. -

-
-

It is not possible to determine if the image as displayed is the original image or one which has been temporarily rotated.

-
-

- If the option - Auto rotate image using EXIF information - is selected, any images which have Exif orientation data will also be shown rotated. However, any rotation you have selected manually will always over-ride the embedded Exif rotation value. -

-

- Write altered image orientation to the metadata set -

-

If you change the orientation of an image using any of the available commands, this new orientation is stored in a metadata write queue.

-

- If the option - Auto rotate image using EXIF information - is selected, any images which have Exif orientation data will be shown rotated, including any in the metadata write queue. -

-

- However if the option - Auto rotate image using EXIF information - is not selected, no images will be auto-rotated. If you have manually rotated any images, the metadata write icon on the status bar will alert you to that fact. Clicking the icon will give a list of the modified files. -

-

-

-
-
- - - diff --git a/web/help/Features.html b/web/help/Features.html deleted file mode 100644 index ac2390fa..00000000 --- a/web/help/Features.html +++ /dev/null @@ -1,522 +0,0 @@ - - - - -Features - - - - - - - - -
-

Features

- -
-
-

1.1.1. Basic Features

- -

-
-
-

1.1.2. Advanced Features

-
    -
  • - Search and Select -

    Image Search based on many parameters

    -
  • -
  • - Finding Duplicates -

    Find image duplicates based on image content

    -
  • -
  • - List panes -

    View IPTC, and view and edit Exif and XMP data stored in images

    -
  • -
  • - Sort Manager Sidebar -

    Simple Sort Manager to quickly sort a folder of images into other folders

    -
  • -
  • - Rename -

    Rename images in bulk

    -
  • -
  • - Image Overlay -

    Overlay the image with a panel showing user-definable data

    -
  • -
  • - Keywords -

    Add XMP keywords to images, and recall those images with the search function

    -
  • -
  • - -

    Geeqie is a very configurable application

    -
  • -
-

“An application that displays images.” - This was, and still is, the primary goal of Geeqie. Over time image management features have been added, but the core purpose of Geeqie remains the same.

-

-
-
- - - diff --git a/web/help/GuideCollections.html b/web/help/GuideCollections.html deleted file mode 100644 index 54870fb9..00000000 --- a/web/help/GuideCollections.html +++ /dev/null @@ -1,564 +0,0 @@ - - - - -Collections - - - - - - - - -
-

Collections

- -

Geeqie provides the ability to build lists of images, regardless of the location of the files on disk.

-

A collection window displays the contents of a collection. It allows the collection to be modified and access to the images contained in the collection.

-

- To open a new empty collection window select - File ▸ New collection ( - C - ) - . -

-

- To open an existing collection, select - File ▸ Open collection ( - O - ) - . A dialog will appear requesting the location of the collection file. A window will the open containing the selected collection. Recently opened or saved collections can also be opened by selecting the collection's file name from the Open recent sub menu of the file menu. -

-

- To delete or rename a collection, select - File ▸ Open collection ( - O - ) - , right-click on the collection you wish to delete or rename, and then select - Delete - or - Rename - . -

-

The collection window consists of a pane to display the contents of the collection, and a status bar along the bottom of the window.

-

-
-
-

4.4.1. Icon pane

-

The icon pane displays images contained in the collection as thumbnails in a grid, by default the file names also appear below each thumbnail.

-

- The Icon pane works exactly like the Icon view mode of the - File Pane - in a main window, but with the addition that the contents of the collection can be organized with drag and drop. -

-

- A - context menu - is available for the icon pane by right clicking the mouse or pressing the Menu key. -

-

- Keyboard and Mouse Shortcuts - are available in the collection window: -

-

- The - selection - can be changed using the keyboard and mouse the same as in a - File Pane - of the main window. -

-

-
-
-

4.4.2. Status bar

-

The status bar displays the total number of images in the collection, and the number of selected images in parenthesis. A progress bar also displays whenever thumbnails are loading from disk.

-

-
-
-

4.4.3. Drag and Drop

-

Drag and drop can be initialized with the primary or middle mouse buttons. Dragging an image that is selected will include all selected images in the drag. Dragging an image that is not selected will drag only that image.

-

Dropping files and folders onto the collection window will add them to the collection, they will be inserted at the location of the drop. A red arrow will indicate the location of the drop as files are dragged over the collection window. When one or more folders are included in the drop list, a menu will appear to select how to handle the contents of the folders.

-

To move images within the collection to change their order, initiate a drag for the selected image(s) and then move the mouse to the desired location within the window. A red arrow will appear to assist in determining the destination of the dragged images. Release the drag to move the images to the new location in the list.

-
-

- When renaming or moving files within Geeqie, the contents of collections located in the - collections folder - will automatically update to the new name or location. -

-
-

-
-
-

4.4.4. Append Images

-

Right-click menu items permit images to be appended from either another collection or from the currently selected folder.

-

-
-
-

4.4.5. Randomized Sort

-

- Right-click menu item - Sort - , in addition to the standard sort methods, permits images to be randomly arranged. -

-

-
-
- - - diff --git a/web/help/GuideColorManagement.html b/web/help/GuideColorManagement.html deleted file mode 100644 index d637625f..00000000 --- a/web/help/GuideColorManagement.html +++ /dev/null @@ -1,454 +0,0 @@ - - - - -Color Management - - - - - - - - -
-

Color Management

- -

TBD.

-

- Color management options -

-
- - - diff --git a/web/help/GuideCredits.html b/web/help/GuideCredits.html deleted file mode 100644 index cbc2aadd..00000000 --- a/web/help/GuideCredits.html +++ /dev/null @@ -1,457 +0,0 @@ - - - - -Credits - - - - - - - - -
-

Credits

- -

-

Geeqie is maintained by The Geeqie Team (Colin Clark, Klaus Ethgen, Laurent Monin, Petr Ostadal, Vladimir Nadvornik and others).

-

This software is a fork of GQview project by John Ellis.

-

The ever growing list of contributors and language translators can be found in the README file included with the latest release of the program.

-

The Credits can also be viewed by selecting the Credits button located in the About dialog - (open Help Menu, select About, click Credits... button).

-

-
- - - diff --git a/web/help/GuideEditorsConfig.html b/web/help/GuideEditorsConfig.html deleted file mode 100644 index 8e268a41..00000000 --- a/web/help/GuideEditorsConfig.html +++ /dev/null @@ -1,715 +0,0 @@ - - - - -External Editor Configuration - - - - - - - - -
-

External Editor Configuration

- -

-
-
-

12.2.1. Editor Configuration Dialog

-

- This dialog allows user to add new editors or modify the system ones. It is available in the menu - Edit ▸ Preferences ▸ Configure Editors - . -

-

- The Editors dialog shows list of all relevant editors i.e. all installed desktop files that are designated either: -

    -
  • - Categories=Graphics -
  • -
  • - Categories=X-Geeqie -
  • -
-

- The list has the following columns: -

-
-
- Name -
-
-

Editor name as specified in desktop file, and is the name displayed in menus.

-
-
- Hidden -
-
- An editor can be - Hidden - for one of these reasons: -
    -
  • - the desktop file contains - Hidden=TRUE - or - NoDisplay=TRUE -
  • -
  • - TryExec - binary was not found -
  • -
  • - MimeType - list does not contain images -
  • -
  • - MimeType - list is empty and - Categories - does not contain - X-Geeqie -
  • -
-
-
-
-
- Desktop file -
-
- Name of the desktop file, used as an identifier in - Keyboard Options - . -
-
- Path -
-
Full path to the desktop file. Desktop files in user directories override the system ones with the same name.
-
-
-
-

12.2.2. Adding new editor

-

- - - - - - New - - - opens a text editor with a desktop file template. You must amend the line -

Exec=command %f
- to contain the command you wish to execute. If it is more than a single command, you must create a script file and call that. If the location of the script file is not in your $PATH environment variable, you must include the full pathname. -

-

-
-
-

12.2.3. Modifying an existing editor

-

- - - - - - Edit - - - opens a text editor with existing desktop file. For desktop files that are not writable by user, it allows saving to a Geeqie specific directory, where it overrides the system file (but only for Geeqie). -

-
-
-

12.2.4. Deleting an editor

-

- - - - - - Delete - - - can delete user writable desktop files. System desktop files can't be deleted directly, but it is possible to edit them and set - Hidden=TRUE - , see above. -

-
-
-

12.2.5. Special editors

-

A desktop file with one of the following names has a special function. It will replace the corresponding internal command.

-

-

        geeqie-copy-command.desktop
-        geeqie-move-command.desktop
-        geeqie-rename-command.desktop
-        geeqie-delete-command.desktop
-        geeqie-folder-command.desktop
-      
-

-

This can be used for example for a custom trash command or for manipulation of files under version control.

-
-
-

12.2.6. Geeqie desktop file keys

-

- A desktop file for use only by Geeqie should have the following entries: -

        Categories=X-Geeqie;
-        OnlyShowIn=X-Geeqie;
-      
-

-

- A menu path where the editor will appear, instead of in the default - Edit ▸ External Editors - , can be set by including: -

X-Geeqie-Menu-Path=<FileMenuPath>
-

-

- Possible vales for - FileMenuPath - are: -

        FileMenu
-        FileMenu/OpenSection
-        FileMenu/SearchSection
-        FileMenu/PrintSection
-        FileMenu/FileOpsSection
-        FileMenu/QuitSection
-        GoMenu
-        SelectMenu
-        SelectMenu/SelectSection
-        SelectMenu/ClipboardSection
-        SelectMenu/MarksSection
-        SelectMenu/EditMenu
-        SelectMenu/ExternalMenu
-        SelectMenu/EditSection
-        SelectMenu/OrientationMenu
-        SelectMenu/PropertiesSection
-        SelectMenu/PreferencesMenu
-        SelectMenu/PreferencesSection
-        ViewMenu
-        ViewMenu/WindowSection
-        ViewMenu/FileDirMenu
-        ViewMenu/FileDirMenu/FolderSection
-        ViewMenu/FileDirMenu/ListSection
-        ViewMenu/DirSection
-        ViewMenu/ZoomMenu
-        ViewMenu/ZoomMenu/ConnectZoomMenu
-        ViewMenu/SplitMenu
-        ViewMenu/ColorMenu
-        ViewMenu/OverlayMenu
-        ViewMenu/ViewSection
-        ViewMenu/ToolsSection
-        ViewMenu/SlideShowSection
-        HelpMenu
-        HelpMenu/HelpSection
-      
-

-

- If you want an editor to use a user-definable path, the following entry must be made in the desktop file: -

X-Geeqie-Filter=true
-

-

- Desktop files containing this entry will be displayed in the Folder action list of the - Sort Manager Sidebar - . The path of the bookmark clicked will be used by the desktop file. -

- If the desktop file is called from the menu, when the external editor is executed you are presented with a dialogue which enables a path to be selected. The path selected, appended by the filename currently being processed, is made available to the editor script either as an environment variable or via a call to geeqie --remote. The following code demonstrates the use of both methods: -
        for file in "$@"
-        do
-        destination=$(geeqie --remote --get-destination:"$file")
-        
-        echo "$destination"
-        echo $GEEQIE_DESTINATION
-        done
-      
-

-

- If you want to run an editor in full-screen mode and wish full-screen to be maintained, include the following entry in the desktop file: -

X-Geeqie-Keep-Fullscreen=true
-

-

- Any terminal output from the editor command can be displayed with the following command: -

X-Geeqie-Verbose=true
-

-

- The editor can be restricted to run on only certain file types, for example: -

X-Geeqie-File-Extensions=.jpg; .cr2
- The entries are case insensitive. -

-

-

X-Geeqie-Keep-Verbose-Multi=
- TBD -

-

- The key or key combination to execute this function can be set with: -

X-Geeqie-Hotkey=
- Key combinations are of the form: - -
X-Geeqie-Hotkey=<control>y
-
- This value may conflict with a setting in - Keyboard Options -
-

-
-
- - - diff --git a/web/help/GuideFaq.html b/web/help/GuideFaq.html deleted file mode 100644 index 63410380..00000000 --- a/web/help/GuideFaq.html +++ /dev/null @@ -1,470 +0,0 @@ - - - - -Frequently Asked Questions - - - - - - - - -
-

Frequently Asked Questions

- -

-
-
- - - diff --git a/web/help/GuideGnuFdl.html b/web/help/GuideGnuFdl.html deleted file mode 100644 index dc0b88d8..00000000 --- a/web/help/GuideGnuFdl.html +++ /dev/null @@ -1,791 +0,0 @@ - - - - -GNU Free Documentation License - - - - - - - -
-

GNU Free Documentation License

- -
-                    GNU GENERAL PUBLIC LICENSE
-                       Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
- 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-                            Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-License is intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users.  This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it.  (Some other Free Software Foundation software is covered by
-the GNU Lesser General Public License instead.)  You can apply it to
-your programs, too.
-
-  When we speak of free software, we are referring to freedom, not
-price.  Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-this service if you wish), that you receive source code or can get it
-if you want it, that you can change the software or use pieces of it
-in new free programs; and that you know you can do these things.
-
-  To protect your rights, we need to make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have.  You must make sure that they, too, receive or can get the
-source code.  And you must show them these terms so they know their
-rights.
-
-  We protect your rights with two steps: (1) copyright the software, and
-(2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
-
-  Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software.  If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
-
-  Finally, any free program is threatened constantly by software
-patents.  We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary.  To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-                    GNU GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License applies to any program or other work which contains
-a notice placed by the copyright holder saying it may be distributed
-under the terms of this General Public License.  The "Program", below,
-refers to any such program or work, and a "work based on the Program"
-means either the Program or any derivative work under copyright law:
-that is to say, a work containing the Program or a portion of it,
-either verbatim or with modifications and/or translated into another
-language.  (Hereinafter, translation is included without limitation in
-the term "modification".)  Each licensee is addressed as "you".
-
-Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running the Program is not restricted, and the output from the Program
-is covered only if its contents constitute a work based on the
-Program (independent of having been made by running the Program).
-Whether that is true depends on what the Program does.
-
-  1. You may copy and distribute verbatim copies of the Program's
-source code as you receive it, in any medium, provided that you
-conspicuously and appropriately publish on each copy an appropriate
-copyright notice and disclaimer of warranty; keep intact all the
-notices that refer to this License and to the absence of any warranty;
-and give any other recipients of the Program a copy of this License
-along with the Program.
-
-You may charge a fee for the physical act of transferring a copy, and
-you may at your option offer warranty protection in exchange for a fee.
-
-  2. You may modify your copy or copies of the Program or any portion
-of it, thus forming a work based on the Program, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) You must cause the modified files to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    b) You must cause any work that you distribute or publish, that in
-    whole or in part contains or is derived from the Program or any
-    part thereof, to be licensed as a whole at no charge to all third
-    parties under the terms of this License.
-
-    c) If the modified program normally reads commands interactively
-    when run, you must cause it, when started running for such
-    interactive use in the most ordinary way, to print or display an
-    announcement including an appropriate copyright notice and a
-    notice that there is no warranty (or else, saying that you provide
-    a warranty) and that users may redistribute the program under
-    these conditions, and telling the user how to view a copy of this
-    License.  (Exception: if the Program itself is interactive but
-    does not normally print such an announcement, your work based on
-    the Program is not required to print an announcement.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Program,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Program, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Program.
-
-In addition, mere aggregation of another work not based on the Program
-with the Program (or with a work based on the Program) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may copy and distribute the Program (or a work based on it,
-under Section 2) in object code or executable form under the terms of
-Sections 1 and 2 above provided that you also do one of the following:
-
-    a) Accompany it with the complete corresponding machine-readable
-    source code, which must be distributed under the terms of Sections
-    1 and 2 above on a medium customarily used for software interchange; or,
-
-    b) Accompany it with a written offer, valid for at least three
-    years, to give any third party, for a charge no more than your
-    cost of physically performing source distribution, a complete
-    machine-readable copy of the corresponding source code, to be
-    distributed under the terms of Sections 1 and 2 above on a medium
-    customarily used for software interchange; or,
-
-    c) Accompany it with the information you received as to the offer
-    to distribute corresponding source code.  (This alternative is
-    allowed only for noncommercial distribution and only if you
-    received the program in object code or executable form with such
-    an offer, in accord with Subsection b above.)
-
-The source code for a work means the preferred form of the work for
-making modifications to it.  For an executable work, complete source
-code means all the source code for all modules it contains, plus any
-associated interface definition files, plus the scripts used to
-control compilation and installation of the executable.  However, as a
-special exception, the source code distributed need not include
-anything that is normally distributed (in either source or binary
-form) with the major components (compiler, kernel, and so on) of the
-operating system on which the executable runs, unless that component
-itself accompanies the executable.
-
-If distribution of executable or object code is made by offering
-access to copy from a designated place, then offering equivalent
-access to copy the source code from the same place counts as
-distribution of the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  4. You may not copy, modify, sublicense, or distribute the Program
-except as expressly provided under this License.  Any attempt
-otherwise to copy, modify, sublicense or distribute the Program is
-void, and will automatically terminate your rights under this License.
-However, parties who have received copies, or rights, from you under
-this License will not have their licenses terminated so long as such
-parties remain in full compliance.
-
-  5. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Program or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Program (or any work based on the
-Program), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Program or works based on it.
-
-  6. Each time you redistribute the Program (or any work based on the
-Program), the recipient automatically receives a license from the
-original licensor to copy, distribute or modify the Program subject to
-these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties to
-this License.
-
-  7. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Program at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Program by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Program.
-
-If any portion of this section is held invalid or unenforceable under
-any particular circumstance, the balance of the section is intended to
-apply and the section as a whole is intended to apply in other
-circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system, which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  8. If the distribution and/or use of the Program is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License
-may add an explicit geographical distribution limitation excluding
-those countries, so that distribution is permitted only in or among
-countries not thus excluded.  In such case, this License incorporates
-the limitation as if written in the body of this License.
-
-  9. The Free Software Foundation may publish revised and/or new versions
-of the General Public License from time to time.  Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-Each version is given a distinguishing version number.  If the Program
-specifies a version number of this License which applies to it and "any
-later version", you have the option of following the terms and conditions
-either of that version or of any later version published by the Free
-Software Foundation.  If the Program does not specify a version number of
-this License, you may choose any version ever published by the Free Software
-Foundation.
-
-  10. If you wish to incorporate parts of the Program into other free
-programs whose distribution conditions are different, write to the author
-to ask for permission.  For software which is copyrighted by the Free
-Software Foundation, write to the Free Software Foundation; we sometimes
-make exceptions for this.  Our decision will be guided by the two goals
-of preserving the free status of all derivatives of our free software and
-of promoting the sharing and reuse of software generally.
-
-                            NO WARRANTY
-
-  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
-OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
-OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
-PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-REPAIR OR CORRECTION.
-
-  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
-INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
-OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
-YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
-PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGES.
-
-                     END OF TERMS AND CONDITIONS
-
-            How to Apply These Terms to Your New Programs
-
-  If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
-  To do so, attach the following notices to the program.  It is safest
-to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    one line to give the program's name and a brief idea of what it does.
-    Copyright (C) year  name of author
-
-    This program is free software; you can redistribute it and/or modify
-    it under the terms of the GNU General Public License as published by
-    the Free Software Foundation; either version 2 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU General Public License for more details.
-
-    You should have received a copy of the GNU General Public License along
-    with this program; if not, write to the Free Software Foundation, Inc.,
-    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-
-Also add information on how to contact you by electronic and paper mail.
-
-If the program is interactive, make it output a short notice like this
-when it starts in an interactive mode:
-
-    Gnomovision version 69, Copyright (C) year name of author
-    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-    This is free software, and you are welcome to redistribute it
-    under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, the commands you use may
-be called something other than `show w' and `show c'; they could even be
-mouse-clicks or menu items--whatever suits your program.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary.  Here is a sample; alter the names:
-
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
-  `Gnomovision' (which makes passes at compilers) written by James Hacker.
-
-  signature of Ty Coon, 1 April 1989
-  Ty Coon, President of Vice
-
-This General Public License does not permit incorporating your program into
-proprietary programs.  If your program is a subroutine library, you may
-consider it more useful to permit linking proprietary applications with the
-library.  If this is what you want to do, use the GNU Lesser General
-Public License instead of this License.
-
-

-
- - - diff --git a/web/help/GuideImageManagement.html b/web/help/GuideImageManagement.html deleted file mode 100644 index 8e47bf70..00000000 --- a/web/help/GuideImageManagement.html +++ /dev/null @@ -1,471 +0,0 @@ - - - - -File Management - - - - - - - - -
-

File Management

- -

Geeqie includes a set of utilities to copy, move, rename, and delete images. Cache maintenance utilities are also provided.

-

-
-
- - - diff --git a/web/help/GuideImageManagementCopyMove.html b/web/help/GuideImageManagementCopyMove.html deleted file mode 100644 index c3cbbd74..00000000 --- a/web/help/GuideImageManagementCopyMove.html +++ /dev/null @@ -1,608 +0,0 @@ - - - - -Copy and Move - - - - - - - - -
-

Copy and Move

- -

- To copy a file in Geeqie select - File ▸ Copy ( - Ctrl+C - ) - and to move a file select - File ▸ Move ( - Ctrl+M - ) - . These operations also appear in the context menu of all images and files. -

-

The Copy and Move operations and dialogs behave the same in Geeqie, with the only difference being the final result. The remaining text of this page applies equally to the Copy and Move operations, for the remainder of this page these will be referred to as a Copy/Move operation.

-

Initiating a Copy/Move operation will display a dialog to select the destination folder to Copy/Move the selected file, after the destination folder is selected Geeqie will proceed to Copy/Move the images to the destination. If an error occurs or a file exists with the same name as one of the files being Copy/Moved, a dialog will appear prompting how to handle the situation.

-

-
-
-

7.1.1. The Copy/Move dialog

-

This is the dialog that is displayed when initiating a Copy/Move operation. The dialog contains a row of buttons near the top, vertical list of bookmarks along the left side, a vertical list of folders in the current path, a text entry field, and a row of buttons along the bottom.

-
-
- Home button -
-
-

Activate this button to change the active path to your home folder.

-
-
- New Folder button -
-
-

Activate this to create a new empty folder as a sub folder of the active path. The new folder will appear in the folder list ready for you to type in the desired name.

-
-
- Show Hidden check box -
-
-

Enabling this check box will cause hidden folders to appear in the folder list.

-
-
- Bookmark list -
-
-

- This list on the left side of the window allows you to save links to folders that are frequently used. Activating a bookmark will change the active path to that pointed to by the link. To add items to the bookmark list highlight a folder and press - ( - Ctrl+B - ) - , select “Add bookmark” from the folder's context menu, or drag a folder onto the bookmark list. -

- The bookmark has a context menu that can be displayed by clicking the right mouse button, or pressing the Menu key when a bookmark has the focus. From the context menu you can edit a bookmark, move it up or down in the list, or remove the bookmark from the list. A bookmark can also be moved by pressing Shift + Up or Shift + Down while it has the focus. -

-

A bookmark with the name "." is treated as a special case. Each time this bookmark is displayed, its path is loaded with Geeqie's current working folder. This bookmark, like any other, can be deleted and re-created at any time.

-
-
- Folder list -
-
-

- This is the list that displays the folders contained in the active path. To change the active path to a folder displayed in this list double click the primary mouse button or highlight the folder with the keyboard and press - Enter - or - Spacebar - . This list has a context menu that allows renaming or bookmarking the selected folder. A folder can also be dragged onto the bookmark list to add a bookmark. -

-
-
- Path entry -
-
-

This text entry displays the active path of the dialog. The path can be directly edited using this entry. Tab completion is supported, and the drop down arrow will display a list of recently selected folders.

-
-
- Copy/Move button -
-
-

The name of this button will differ depending on the selected operation, activating it will start the operation with the folder displayed in the path entry as the destination.

-
-
- Cancel button -
-
-

Activate this button to close the dialog, the operation will be aborted.

-
-
-

-
-
-

7.1.2. The error dialog

-

If a problem occurs because Geeqie is unable to Copy or Move a selected file a dialog will appear to notify the user. The dialog will also ask if the operation should continue if one or more files remain to be Copied or Moved.

-

-
-
-

7.1.3. The overwrite dialog

-

If a file with the same name exists in the selected destination a dialog will appear to notify the user and ask how to resolve the conflict. The dialog will also display the source and destination images. The following possible solutions will be offered:

-
-
- Auto rename -
-
-

Enabling this check box to have Geeqie select a unique name for the destination file, the proposed new name will appear in the rename entry field.

-
-
- Rename -
-
-

Enable this check box to manually enter a new name for the file.

-
-
- Overwrite -
-
-

Activate this will overwrite the existing file, or rename it if one of the rename check boxes are enabled.

-
-
- Overwrite all -
-
-

Activating this will perform the same operation as the Yes button, however any further file name conflicts will be handled quietly in the same method as is selected for the current file.

-
-
- Skip -
-
-

This button will skip doing anything to the file in question, and resume the operation with the next file. The source file will remain untouched.

-
-
- Skip All -
-
-

This will perform the same as the Skip button, however any further file name conflicts will be quietly ignored for all remaining files.

-
-
- Cancel -
-
-

This will close the dialog and stop the operation, all remaining files will be ignored.

-
-
-

-
-
- - - diff --git a/web/help/GuideImageManagementDelete.html b/web/help/GuideImageManagementDelete.html deleted file mode 100644 index 6408e9e3..00000000 --- a/web/help/GuideImageManagementDelete.html +++ /dev/null @@ -1,514 +0,0 @@ - - - - -Delete - - - - - - - - -
-

Delete

- -

- To delete a file in Geeqie select - File ▸ Delete ( - Ctrl+D - ) - . Delete is also available in the context menu of all images and files. If - Enable delete key - is enabled in Options, pressing the - Delete - key can also be used to delete files. -

-

- The behavior when starting a delete operation depends on the - Confirm file delete - option in Options. If the option is enabled a dialog will appear to confirm the operation, if it is not enabled the files will be deleted without further interaction. In all cases if the file is unable to be deleted you will be notified by a dialog. -

-

-
-
-

7.3.1. Confirm delete dialog

-

- The dialog that appears when delete confirmation is enabled will show the file or files to be deleted. To delete the file press - Enter - or activate the Delete button. Pressing - Escape - or activating the Cancel button will close the dialog and abort the operation. -

-

When deleting multiple files, the dialog will include two arrow buttons to step the image preview through the list of files to be deleted. Initially the preview will be blank, activate the right arrow to display the first file.

-

- The dialog will also display the status of the - Safe Delete - feature. Use this to determine if a file to be deleted will be immediately lost, or if the file can possibly be recovered from the Safe Delete folder. -

-

- If a file is unable to be deleted, a dialog will appear to notify you. If multiple files were selected and any remain, the dialog will include a Continue button, activating this button or pressing Enter will delete the remaining files. Pressing - Escape - or activating the Cancel button will close the dialog and the remaining files will not be deleted. -

-

-
-
-

7.3.2. Safe Delete

-

- Geeqie includes a feature to temporarily store deleted files in a selected folder, to use this feature enable - Safe Delete - on the advanced tab of the preferences dialog. -

-
-
- - - diff --git a/web/help/GuideImageManagementExternalEditing.html b/web/help/GuideImageManagementExternalEditing.html deleted file mode 100644 index f5e982b3..00000000 --- a/web/help/GuideImageManagementExternalEditing.html +++ /dev/null @@ -1,479 +0,0 @@ - - - - -External Actions - - - - - - - - -
-

External Actions

- -

Geeqie provides the facility to execute external commands. In Geeqie these are called external editors.

-

However these commands are not limited to editing images - any external command may be called via this facility.

-

Actions may be performed on a single file, or on a set of selected files.

-

External editors can do anything from running simple operations like symlink to activating fully featured programs like Gimp. Nor does the action have to be performed on files - you may, for instance, configure an editor to download images from your digital camera.

-

- To perform these actions, Geeqie uses standard - desktop - files. -

-

- It is not necessary to understand the details of desktop file specifications because the - External Editor Configuration - dialogue presents you with an easy-to-use template. This dialogue is accessed via - Edit ▸ Preferences ▸ Configure Editors - . -

-

- Editors will appear in the menu - Edit ▸ External Editors - , unless specified otherwise in the desktop file. -

-

-

Commands that are set to display their output in a window will show a dialogue when the command is executed.

-

The Result dialogue will display the command's text output. If the editor command will result in multiple runs of the same command for each file, you can use the Stop button to stop Geeqie from executing the command for remaining files.

-

- Once all commands have completed, or if the Stop button was pressed and the pending command has completed, you can use the Close button, or press - Escape - , to close the Result dialogue. The Result dialogue can not be closed while a command is still running. -

-
- - - diff --git a/web/help/GuideImageManagementPlugins.html b/web/help/GuideImageManagementPlugins.html deleted file mode 100644 index f83e7343..00000000 --- a/web/help/GuideImageManagementPlugins.html +++ /dev/null @@ -1,478 +0,0 @@ - - - - -Plugins - - - - - - - - -
-

Plugins

- -

Geeqie provides the facility to execute external commands - any external command may be called via this facility.

-

Actions may be performed on a single file, or on a set of selected files.

-

Plugins can do anything from running simple operations like symlink to activating fully featured programs like Gimp. Nor does the action have to be performed on files - you may, for instance, configure a plugin to download images from your digital camera.

-

- To perform these actions, Geeqie uses standard - desktop - files. -

-

- It is not necessary to understand the details of desktop file specifications because the - Plugins Configuration - dialogue presents you with an easy-to-use template. This dialogue is accessed via - Edit ▸ Configure Plugins - . -

-

- Plugins will appear in the menu - Plugins - , unless specified otherwise in the desktop file. -

-

-

Commands that are set to display their output in a window will show a dialogue when the command is executed.

-

The Result dialogue will display the command's text output. If the plugin command will result in multiple runs of the same command for each file, you can use the Stop button to stop Geeqie from executing the command for remaining files.

-

- Once all commands have completed, or if the Stop button was pressed and the pending command has completed, you can use the Close button, or press - Escape - , to close the Result dialogue. The Result dialogue can not be closed while a command is still running. -

-
- - - diff --git a/web/help/GuideImageManagementRename.html b/web/help/GuideImageManagementRename.html deleted file mode 100644 index 855263fb..00000000 --- a/web/help/GuideImageManagementRename.html +++ /dev/null @@ -1,554 +0,0 @@ - - - - -Rename - - - - - - - - -
-

Rename

- -

- To rename a file in Geeqie select - File ▸ Rename ( - Ctrl+R - ) - . Rename is also available in the context menu of all images and files. -

-

When renaming a file, a dialog will display allowing entry of the new name for the file. The dialog will be different depending on the number of files selected to be renamed. A simple dialog will appear when renaming a single file, however when renaming multiple files the dialog will include a list of the file to be renamed and additional options.

-

-
-
-

7.2.1. Rename single file dialog

-

- The dialog that appears when renaming a single file includes an image of the file, an entry to type the new name of the file, a Rename button, and a Cancel button. Type the new name into the text entry and press - Enter - or activate the Rename button to rename the file. Press - Escape - or activate the Cancel button to close the dialog and abort renaming the file. -

-

- When renaming a file and the new name already exists on the file system a dialog will appear showing the renamed and existing files. To overwrite the existing file press - Enter - or activate the Overwrite button. Press - Escape - or activate the Cancel button to close the dialog abort renaming the file. -

-

-
-
-

7.2.2. Rename multiple files dialog

-

The dialog that appears when renaming multiple files includes the list of files to be renamed, a preview image of the active file, an entry to enter the new file name, an auto rename check box, a Rename button, and a Cancel button.

-
-
- Manually enter new file names -
-
-

- To manually enter the new name of each file, the active file will be displayed in the image preview and it's original name will be displayed above the text entry. To rename the file type the new name and press - Enter - or activate the Rename button. When a file is successfully renamed it will be removed from the list and the next one will become the active file. After all files have been renamed, the dialog will close. -

-

Files do not have to be renamed in the order that they appear in the list, highlighting a name in the list will make it become the active file.

-

- When renaming a file and the new name already exists on the file system a dialog will appear showing the renamed and existing files. To overwrite the existing file press - Enter - or activate the Overwrite button. Press - Escape - or activate the Cancel button to return to the original rename dialog, the file that prompted the overwrite dialog will remain active. -

-
-
- Automatic renaming of multiple files -
-
-

To automatically rename the files in the list, enable the Auto rename check box. The dialog will change to batch mode for numerical naming of files.

-

The file name list will change to include a preview column that will show the resulting name of each file. The text entry will change to three entries; the first represents the text that appears in the new names before the number, the second will be the start number to use when incrementing the file number, and the third represents the text to append to the name after the number. The end text should include the file name extension, therefore batch renaming multiple types of files (those with different extensions) all at once is not recommended.

-

The padding number can be used to change the minimum length of characters to use for the number portion of the new name. When the file number results in fewer characters than the padding size, the result will be padded with leading zeros to fill the remaining space. For example if padding size is 3, a file with the number 24 will appear in the file name as “024”.

-

The order of the file list can be changed by dragging a name to the desired location within the list. The preview column will update to reflect the new order.

-

- When the preview of new names is satisfactory, press - Enter - or activate the Rename button to rename the files to match the name in the preview column. Press - Escape - or activate the Cancel button to close the dialog and abort the rename operation. -

-

If the resulting new names match any existing files, a warning dialog will notify you. The rename dialog will remain so that you can select a different set of names.

-

-
-
- Formatted renaming of multiple files -
-
-

Formatted rename permits file to be renamed in a pre-determined way whilst still including the original file name.

-

- In the Format box any alpha-numerics can be entered, but the special character - * - will be replaced by the current filename. One or more - # - characters can be included, and will be replaced by an incrementing number. -

-

The current file extension is automatically appended to new new file name.

-

The order of the file list can be changed by dragging a name to the desired location within the list. The preview column will update to reflect the new order.

-

When the preview of new names is satisfactory, press Enter or activate the Rename button to rename the files to match the name in the preview column. Press Escape or activate the Cancel button to close the dialog and abort the rename operation.

-

If the resulting new names match any existing files, a warning dialog will notify you. The rename dialog will remain so that you can select a different set of names.

-

-
-
-
-
- - - diff --git a/web/help/GuideImageMarks.html b/web/help/GuideImageMarks.html deleted file mode 100644 index 69e0dc52..00000000 --- a/web/help/GuideImageMarks.html +++ /dev/null @@ -1,495 +0,0 @@ - - - - -Marking Images - - - - - - - - -
-

Marking Images

- -

Marks are intended as a temporary method of grouping and filtering sets of images.

-

- Keywords - are intended as a permanent method of identifying sets of images, and to this end it is possible to link any mark with any keyword. -

-

- The - Select - menu gives access to the marks operations of setting, filtering and intersection. -

-

There are 10 individual marks, any of which can be associated with an image simply by pressing the 0 to 9 keys on the keyboard, where key 0 represents mark 10.

-

- If the - Show Marks - menu has been selected, each image will have a set of 10 check-boxes displayed adjacent to it in the file pane in both icon and list mode. In addition a set of 10 check-boxes will be shown at the top of the files pane. Clicking any of these will filter the displayed list. -

-

Moving the mouse over any of the check-boxes at the top of the files pane will show mnemonic text for that mark. The text can be modified by right-clicking on the check box.

-

- If the - Image Overlay - is being displayed, the currently set marks for the image are shown. It is not necessary to include an entry into the overlay template for this to happen. -

-

- A keyword can be associated with a single mark by right-clicking on the keyword in the sidebar panel. When a meta-data write operation for a file is triggered either - manually - or as defined in - Metadata - , the keyword data indicated by the current set of mark-to-keyword links will be written. -

-

- The associations between keywords and marks is preserved when Geeqie is shut down. The current setting of marks can also be optionally saved - the setting is in the - Behavior tab of Preferences - . -

-

-

-
- - - diff --git a/web/help/GuideImagePresentation.html b/web/help/GuideImagePresentation.html deleted file mode 100644 index 73e32398..00000000 --- a/web/help/GuideImagePresentation.html +++ /dev/null @@ -1,463 +0,0 @@ - - - - -Image Presentation - - - - - - - - -
-

Image Presentation

- -

Geeqie can be used to display a set of images, showing each image for a period of time before changing to the next image. Images can also be set to fill the entire screen.

-

-
-
- - - diff --git a/web/help/GuideImagePresentationFullscreen.html b/web/help/GuideImagePresentationFullscreen.html deleted file mode 100644 index 74ed4e2d..00000000 --- a/web/help/GuideImagePresentationFullscreen.html +++ /dev/null @@ -1,539 +0,0 @@ - - - - -Full Screen - - - - - - - - -
-

Full Screen

- -

Geeqie allows for the image pane to be expanded to fill the entire screen, this is referred to as full screen.

-

-
-
-

9.2.1. Turning on full screen

-

Full screen can be activated in a number of ways:

-
    -
  • - View ▸ Full screen ( - F - ) -
  • -
  • - - From a context menu - right click an image pane, and select - Full screen - . - -
  • -
-

-
-
-

9.2.2. Turning off full screen

-

To return to the normal view:

-
    -
  • - - From the keyboard - press - F - or - Esc - to stop full screen. - -
  • -
  • - - From a context menu - right click the image pane, and select - Exit full screen - . - -
  • -
  • - - From the menu bar - the menu bar may be visible when using multiple monitors, select - View ▸ Full screen ( - F - ) - -
  • -
-

-
-
-

9.2.3. Configuring full screen

-

- Full screen behavior and location can be adjusted on the - Windows tab - of the preferences dialog. -

-
-
-

9.2.4. Navigation

-

- Refer to - Keyboard and Mouse Shortcuts - . -

-
-
- - - diff --git a/web/help/GuideImagePresentationSlideshow.html b/web/help/GuideImagePresentationSlideshow.html deleted file mode 100644 index 82edc4a1..00000000 --- a/web/help/GuideImagePresentationSlideshow.html +++ /dev/null @@ -1,612 +0,0 @@ - - - - -Slide Show - - - - - - - - -
-

Slide Show

- -

The image pane can be set to automatically change the displayed image after a period of time, in Geeqie this is referred to as a slide show.

-

-
-
-

9.1.1. Starting a slide show

-

A slide show can be started in a number of ways:

-
    -
  • - - From the keyboard or mouse - View ▸ Toggle slide show ( - S - ) - -
  • -
  • - - From a context menu - right click an image pane, and select - Start slide show - , or - Stop slide show - ; the text will change depending on the state of the current slide show. - -
  • -
-

-
-
-

9.1.2. Stopping a slide show

-

- An active slide show can be stopped by using the same functions available to start one, as they work like a toggle switch. If slide show repeat is not enabled in the - Preferences dialog - , the slide show will stop when the last image in the sequence is displayed. -

-

- Any action that changes the image pane to a new image will stop the active slide show, with the exception of the methods discussed in - Slide show sequence navigation - . -

-

-
-
-

9.1.3. Slide show status

-

- The main window - status bar - can be used to determine when a slide show is active, - Slide show - will be displayed next to the file count field. An individual - Image Window - can also display a slide show, however the status will not be immediately visible. To determine the slide show status in an image window, open a context menu by right clicking or using the menu key, the slide show menu item will reflect the slide show status; if - Start slide show - is displayed, no slide show is active, conversely if - Stop slide show - is displayed a slide show is active. -

-

- When a Slide show is paused, the main window status bar will display - Paused - instead of - Slide show - . Likewise, the image context menu will display - Pause slide show - or - Continue slide show - , depending on the current state. -

-

-
-
-

9.1.4. Pausing a slide show

-

An active slide show can be paused in two ways:

-
    -
  • - - From the keyboard - press the - P - key while a slide show is active. - -
  • -
  • - - From a context menu - right click the image pane displaying the slide show, and select - Pause slide show - , or - Continue slide show - depending on the current slide show state. - -
  • -
-

-
-
-

9.1.5. Selecting the images to include in a slide show

-

When a single image is selected, all images in the current folder are included in the slide show. The sequence will begin with the current image; however if random slide shows are enabled, the sequence will begin with a random image from the list.

-

To only include some images in a slide show, use multiple selection to select the images to include before starting the slide show.

-

An image collection can be used as the list of images, to do this drag an image from a collection window onto the image pane. Starting a slide show will then include the images from that collection.

-

- So far, the methods described are for slide shows in a main window, in an - Image Window - , the slide show will use all images referenced by that window. -

-

-
-
-

9.1.6. Recursive slide show

-

In the main window, a recursive slide show can be started from a folder's context menu; the folder's right click menu will include two slide show options:

-
    -
  • - Slide show: This will start a slide show that includes all images in the selected folder. -
  • -
  • - Slide show recursive: The slide show will include all images in the selected folder, and all images in the folders that are contained within the selected folder. -
  • -
-

-
-
-

9.1.7. Slide show sequence navigation

-

When a slide show is active, functions that normally change the image forward and backward can be used to step through those contained in the slide show.

-

-
-
-

9.1.8. Configuring a slide show

-

- The options that control the behavior of slide shows are located on the - General tab - of the options dialog. -

-
-
- - - diff --git a/web/help/GuideImageSearch.html b/web/help/GuideImageSearch.html deleted file mode 100644 index 6713e592..00000000 --- a/web/help/GuideImageSearch.html +++ /dev/null @@ -1,473 +0,0 @@ - - - - -Search and Select - - - - - - - - -
-

Search and Select

- -

Geeqie provides comprehensive set of search methods, including not only the standard functions such as file date or size, but also image similarity.

-

There is a duplicate file finder, which uses search parameters such as image dimensions or checksum. Two sets of image files may be compared.

-

Geeqie also has a set of temporary "marks" or "tags" which may be allocated to any image as an aide to file organising.

-

-
-
- - - diff --git a/web/help/GuideImageSearchCache.html b/web/help/GuideImageSearchCache.html deleted file mode 100644 index 2d2afbb9..00000000 --- a/web/help/GuideImageSearchCache.html +++ /dev/null @@ -1,477 +0,0 @@ - - - - -Caching Data For Searches - - - - - - - - -
-

Caching Data For Searches

- -

- Searching large numbers of files for similarity can take significant cpu time. Part of this is the time to compute the similarity matrix for each file. -

- If the - Cache Thumbnails - option is selected in Preferences/General, the similarity matrix and the checksum will also be cached. This will reduce the time needed for future searches. -
If you frequently search on similarity and your images are in a tree arrangement under a single point, initiating a one-time search on similarity from the top of the tree will generate the similarity data for all images.
-

Similarity data are stored in a folder hierarchy that mirrors the location of the source images. The data have the same name as the original appended by the file extension .sim.

-

- The root of the hierarchy is: -

-

$XDG_CACHE_HOME/geeqie/thumbnails/
- or, if $XDG_CACHE_HOME is not defined: -
$HOME/.cache/geeqie/thumbnails/
-

-

-

-

-
- - - diff --git a/web/help/GuideImageSearchFindingDuplicates.html b/web/help/GuideImageSearchFindingDuplicates.html deleted file mode 100644 index 874bcdfd..00000000 --- a/web/help/GuideImageSearchFindingDuplicates.html +++ /dev/null @@ -1,669 +0,0 @@ - - - - -Finding Duplicates - - - - - - - - -
-

Finding Duplicates

- -

Geeqie provides a utility to find images that have similar attributes or content.

-

- To display a new Find Duplicates Window select - File ▸ Find duplicates - . -

-
-
-

5.3.1. Adding files to be compared

-

Add files to be compared using drag and drop. Drop files or folders onto the Find Duplicates window to add them to the list of files to compare. When one or more folders are dropped onto the window a menu will appear allowing you to choose the desired action:

-
-
- Add contents -
-
The contents of dropped folders will added to the window.
-
- Add contents recursive -
-
The contents of dropped folders and all sub folders will be added to the window.
-
- Skip folders -
-
- Ignore folders contained in the drop list. -

- When files are added to the window, the comparison is restarted to include the new files. -
-
-
-
-

5.3.2. Comparison methods

-

- The attribute to use for two images to match can be selected with the - Compare by: - drop down menu. Each method is explained below: -

-
-
- Name -
-
-

The file name.

-
-
- Name case-insensitive -
-
-

The file name but ignoring case.

-
-
- Size -
-
-

The file size.

-
-
- Date -
-
-

The file date.

-
-
- Dimensions -
-
-

The image dimensions.

-
-
- Checksum -
-
-

The MD5 file checksum.

-
-
- Path -
-
-

The complete path to file.

-
-
- Similarity (high) -
-
-

Very similar image content.

-
-
- Similarity -
-
-

Similar image content.

-
-
- Similarity (low) -
-
-

Slightly similar image content.

-
-
- Similarity (custom) -
-
-

- The percentage value to used to consider two images a match is configured in the spin box at the bottom of the window. -

-
-
-
-
-

5.3.3. Results list

-

Files that match with the selected comparison method will appear in the list. Matching files are grouped in alternating color.

-

The order of the result list can not be changed, files will appear in the order of the search. When comparing by image content similarity, the matching groups will be sorted by order of rank starting with the files that are most similar.

-

- A - context menu - is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus. -

-

- Groups in the results list may be selected by using the keyboard. Refer to the Find Duplicates Window section of - Keyboard Shortcuts - . -

-

- The - selection - can be changed using the keyboard and mouse the same as in a - file pane - of the main window. -

-

The image Dimensions column of the result list will only contain dimension information when comparing by dimensions, or when the data is easily available from memory or has been read from the cache.

-
-
-

5.3.4. Status bar

-

Along the bottom of the Find Duplicates window is an area that displays the count of files contained in the window, and the number of files in the result list.

-

The status bar will also display the status of an active compare operation using the progress bar. A compare operation involves 2 or 3 stages, depending on the type of comparison. These are the stages in order:

-
    -
  1. -

    If necessary, extra data is read into memory for the comparison stage and the progress bar will indicate this stage with text such as “Reading dimensions...”, “Reading checksums...”, or “Reading similarity data...”.

    -
  2. -
  3. The images are compared using the selected method, the progress bar will indicate this stage with the text “Comparing...”.
  4. -
  5. -

    The results are sorted for display, the progress bar will indicate this stage with the text “Sorting...”.

    -

    Stage 1 is only used for the Dimensions, Checksum, and Similarity compare methods.

    -

    If the time to complete a stage will be significant, an estimated time to completion will also be displayed in the progress bar. The estimated time only refers to the current stage, other stages are not included in the estimate. The time estimate is displayed using the format MINUTES:SECONDS.

    -
  6. -
-
-
-

5.3.5. Thumbnails

-

Thumbnails can be displayed beside each image in the result list by enabling the Thumbnails check box.

-
-
-

5.3.6. Ignore Rotation

-

When checked, the rotational orientation of images will be ignored.

-
-
-

5.3.7. Sort

-

- The normal sort order is for groups (in the case of Similarity checks) with the highest number of near-100% matches to be at the top of the list. -

- If this box is checked, groups with the lowest number of matches are placed at the top of the list. -

-
-
-

5.3.8. Compare two file sets

-

Sometimes it is useful to compare one group of files to another, different group of files. Enable this check box to compare two groups of files. When enabled, a second list will appear and files can be added to this list using the same methods for the main list.

-

When comparing two file sets the results list will display matches between the two lists. For each match group, the first file is always from the main group, and the remaining files are always from the second group.

-
-
-

5.3.9. Drag and Drop

-

Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.

-
-
-

5.3.10. Image Data Window

-

- Ctrl+Shift+Right Mouse click - : Use this to display a dialog containing the data stored for the clicked image file. This is usually only useful for debugging purposes. -

-

-
-
- - - diff --git a/web/help/GuideImageSearchSearch.html b/web/help/GuideImageSearchSearch.html deleted file mode 100644 index 5017c37a..00000000 --- a/web/help/GuideImageSearchSearch.html +++ /dev/null @@ -1,722 +0,0 @@ - - - - -Search Window - - - - - - - - -
-

Search Window

- -

Geeqie provides a utility to find one or more images based on various parameters.

-

- To display a new Search Window press - F3 - or select - Search - from the File menu. -

-

- To start a search activate the - - - - - - Find - - - button. A search in progress can be stopped by activating the - - - - - - Stop - - - button. -

-

The progress of an active search is displayed as a progress bar at the bottom of the window. The progress bar will also display the total files that match the search parameters, and the total number of files searched.

-

When a search is completed, the total number of files found and their total size will be displayed in the status bar.

-

-
-
-

5.2.1. Search location

-

One of several locations can be chosen as the source to use in the search.

-
-
- Path -
-
The search will include files located in the selected folder, enable the Recurse check box to include the contents of all sub folders.
-
- Comments -
-
- This option is only for use with GqView legacy metadata. -

- The search will include all files that have a keyword or comment associated to it. -
Only keyword and comment associations stored in the user's home folder are included in this search type.
-
-
- Results -
-
The search will include all files currently listed in the results list. Use this to refine a previous search.
-
-

-

-
-
-

5.2.2. Search parameters

-

Each search parameter can be enabled or disabled with the check box to its left. For a file to be a match, all enabled parameters must be true.

-
-
- File name -
-
- The search will match if the entered text appears within the file name, or if the text exactly matches the file name, depending on the method selected from the drop down menu. The text comparison can be made to be case sensitive by enabling the Match case checkbox. -

- If "contains" is selected, - Perl Compatible Regular Expressions - are used. -
-
- File size -
-
- The search will match if the file size on disk is equal to, less than, greater than, or between the entered value, depending on the method selected from the drop down menu. The - between - test is inclusive - for example a file of size 10 will match if the size parameters are between 10 and 15. -
-
- File date -
-
- The search will match if the file date is equal to, before, after, or between the entered date, depending on the method selected from the drop down menu. The - between - test is inclusive, for example a file with date of 10/04/2003 will match if the date parameters are between 10/04/2003 and 12/31/2003. -

- For convenience, the - - - - - - - - button displays a pop up calendar to enter the date. -

- One of four date types may be selected. They are described in the - Reference section - . -
If an image does not have an exif date, it will default to 01 January 1970.
-
-
- Image dimensions -
-
- The search will match if the image dimensions are equal to, less than, greater than, or between the entered values, depending on the method selected from the drop down menu. The - between - test is inclusive. -

- The image dimensions test is simple, both width and height must be within the allowed values for a match. -
-
- Image content -
-
- The search will match if the image contents are similar within the percentage value, inclusive. This uses the same test and data that is used to determine image similarity when - Finding Duplicates - . The entry is for entering the path for the image to use in this test. -
-
- Keywords -
-
The search will match if the file's associated keywords match all, match any, or exclude the entered keywords, depending on the method selected from the drop down menu. Keywords can be separated with a space, comma, or tab character.
-
- Comment -
-
- The search will match if the file's Comments field contains the entered pattern. - Perl Compatible Regular Expressions - are used. -
-
- Geocoded position -
-
- The search will match if the file's GPS position is less than or greater than the selected distance from the specified position, or is not geocoded, depending on the method selected from the drop down menu. - The search location can be specified by -
    -
  • - Type in a latitude/longitude in the format - 89.123 179.123 -
  • -
  • Drag-and-drop a geocoded image onto the search box
  • -
  • If Geeqie's map is displayed, a left-click on the map will store the latitude/longitude under the mouse cursor into the clipboard. It can then be pasted into the search box.
  • -
  • Copy-and-paste (in some circumstances drag-and-drop) the result of an Internet search.
  • -
-
- In this last case, the result of a search may contain the latitude/longitude embedded in the URL. This may be automatically decoded with the help of an external file:- -
~/.config/geeqie/geocode-parameters.awk
- See - Decoding Latitude and Longitude - for details on how to create this file. -
-
-
- Class -
-
- The search will match if the file's class is, or is not, one of the following types. -
    -
  • Unknown
  • -
  • Image
  • -
  • Raw Image
  • -
  • Video
  • -
  • Metadata
  • -
-
-
- Marks -
-
- The search will match if the file does or does not have a mark attached to it. Refer to - Marking Images - . -
-
-

-

-
-
-

5.2.3. Results list

-

Files that match the parameters of the search are shown in the list. By default they are displayed in the order that they are found. To sort the results list by a column, activate or click the column title. Activating a column that is already used to sort the list will toggle between increasing and decreasing sort order.

-

- A - context menu - is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus. -

-

- The - Keyboard and Mouse Shortcuts - available are listed here. -

-

The image Dimensions column of the result list will only contain dimension information when dimensions are included in the search parameters.

-

-
-
-

5.2.4. Status bar

-

At the bottom of the search window is an area that includes the following items from left to right:

-
-

-
-
- Thumbnails -
-
Enable this check box to display a thumbnail next to each image in the results list.
-
- File count display -
-
Displays the total count of files in the results list, and their size on disk. The count of selected files will appear in parenthesis.
-
- Search progress -
-
When a search is active, the text “Searching...” will appear here. Two numbers in parenthesis will also be displayed, the first number is the number of files that match the search parameters and the second number is the total number of files that were searched.
-
- - - - - - Find - - -
-
Activate the find button to start a search with the selected parameters.
-
- - - - - - Stop - - -
-
Activate the stop button to end a search that is in progress.
-
-
-

-

-
-
-

5.2.5. Drag and Drop

-

Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.

-

-
-
- - - diff --git a/web/help/GuideIndex-info.html b/web/help/GuideIndex-info.html deleted file mode 100644 index 1373157e..00000000 --- a/web/help/GuideIndex-info.html +++ /dev/null @@ -1,497 +0,0 @@ - - - - -The Geeqie User Manual - - - - - - -
-

The Geeqie User Manual

-
-

Author

-
-
-John Ellis -
-
-Affiliation: Geeqie Project -
-
-Email: -
-
-
-
-

Publisher

-
- The Geeqie Team -
-
-
- -
- - -
-
-
-

Feedback

-

- Comments and general help: - -

-

- Bugs and Feature Requests: - Geeqie Issues -

-

- Website: - geeqie.org -

-
-
-

Revision History

-
-2004-01-01: 0.1 (John Ellis)
-
-2016-05-30: 0.2 (Colin Clark)
-
-
- - - diff --git a/web/help/GuideIndex.html b/web/help/GuideIndex.html deleted file mode 100644 index ad7a4eea..00000000 --- a/web/help/GuideIndex.html +++ /dev/null @@ -1,705 +0,0 @@ - - - - -The Geeqie User Manual - - - - - - - -
-

The Geeqie User Manual

-

-
-
- - - diff --git a/web/help/GuideIntroduction.html b/web/help/GuideIntroduction.html deleted file mode 100644 index 8109d693..00000000 --- a/web/help/GuideIntroduction.html +++ /dev/null @@ -1,461 +0,0 @@ - - - - -Introduction - - - - - - - - -
-

Introduction

- -

Geeqie is an image viewer that makes navigation of images easy. Images can be viewed as thumbnails, in multiple windows or in full screen mode.

-

Geeqie is an image manager, with complete copy, move, rename, and delete functions available at the press of a button.

-

Extensive image collections can be easily handled using a combination of Geeqie's flexible Keyword facility and powerful Image searches.

-

Image collections can be refined with a duplicate image finder.

-

Geeqie is ideal for making presentations. A slide-show feature is built in, and Geeqie can be remotely controlled either via command line scripts or an infra-red device. Information such as f-stop, shutter speed and descriptive text can be overlaid onto the image display.

-

There is no need to import images into Geeqie - simply point Geeqie to a folder containing images, and your data will be displayed.

-

Geeqie is an image viewer, not an image editor. However, Geeqie can be configured to call external image editors such as the Gimp, resulting in a very powerful combination.

-

-
-
- - - diff --git a/web/help/GuideLicence.html b/web/help/GuideLicence.html deleted file mode 100644 index 1dcfc047..00000000 --- a/web/help/GuideLicence.html +++ /dev/null @@ -1,456 +0,0 @@ - - - - -Licence - - - - - - - - -
-

Licence

- -

-

The Geeqie program is released under the "GNU General Public License", the complete GNU GPL text can be found in the COPYING file included with each Geeqie release.

-

This Geeqie documentation is released under the - GNU Free Documentation License.

-

-

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

-
- - - diff --git a/web/help/GuideMainWindow.html b/web/help/GuideMainWindow.html deleted file mode 100644 index 7905d80a..00000000 --- a/web/help/GuideMainWindow.html +++ /dev/null @@ -1,511 +0,0 @@ - - - - -Main Window - - - - - - - - -
-

Main Window

- -

- The Geeqie main window is designed for quick and easy navigation of images. The window consists of three regions: the - File Pane - , the - Folder pane - , and the - Image Pane (optionally bordered by Sidebars) - , all bordered by - Menus - and - Status Bar - . -

-

- Multiple instances of the main window may be started via the - File ▸ New Window ( - Ctrl+N - ) - menu item, and the - Layout - of each may be individually configured in the - Window Layout - dialogue. -

-

- If several instances of the main window are open, they may be closed individually or simultaneously as defined in - Window Layout - . -

-

-
-
- - - diff --git a/web/help/GuideMainWindowFilePane.html b/web/help/GuideMainWindowFilePane.html deleted file mode 100644 index 5dd5ac1f..00000000 --- a/web/help/GuideMainWindowFilePane.html +++ /dev/null @@ -1,688 +0,0 @@ - - - - -File Pane - - - - - - - - -
-

File Pane

- -

The file pane displays the images contained in the active folder. It has two modes of display, allows multiple selection, and can initiate drag and drop operations.

-

- A - context menu - can be displayed by clicking the right mouse button on the file pane or pressing the menu key while the file pane has the focus. -

-

-
-
-

2.1.1. List view

-

- This mode can be enabled by selecting - List - from the - View - menu, pressing Ctrl + L, or unselecting - View as icons - from the context menu. -

-

The list view mode displays images in a standard vertical list. Three columns provide the file name, size in bytes, and the time the contents were last modified.

-

- Thumbnails can be displayed next to each file in the list, to toggle thumbnails on or off by selecting - Thumbnails - from the - View - menu, pressing T, clicking on the tool bar, or selecting - Show thumbnails - from the context menu. -

-

- Grouped sidecar files - are represented by the main file with an expander. Clicking on the expander shows sidecar files. -

-

-
-
-

2.1.2. Icon view

-

- This mode can be enabled by selecting - Icons - from the View menu, pressing Ctrl + I, or selecting - View as icons - from the context menu. -

-

The icon view mode displays images as thumbnails in a grid, and by default a file name below each thumbnail.

-

- The - file name displayed below each thumbnail can be turned on or off by selecting - Show filename text - from the context menu. -

-

- Grouped sidecar files - are represented by the main file. For accessing sidecars switch to List mode. -

-

-
-
-

2.1.3. File Filter

-

- A filter box can be opened by selecting - Show File Filter - from the View menu. -

-

- Characters you type into this box will be used for pattern matching to select the files displayed. - Regular expressions - are used in this field. -

- For basic pattern matching "JPG" will match any filename containing those characters. -

- To make a case-insensitive search, use "(?i)JPG" -

- If you type a newline, the text will be saved in the dropdown box list. The last 10 items are saved. -

- To delete an item, select it from the drop-down list, click on the text box to select the text, and then press - Delete - followed by - Enter - . -

-

-
-
-

2.1.4. Multiple selection

-

It is possible to select more than one image from the file pane. Multiple files can be selected with several methods:

-

-
-
-

2.1.4.1. Mouse

-
    -
  • - Ctrl + Primary mouse button will add or remove the file from the selection. -
  • -
  • - Middle mouse button will toggle selection of the file. -
  • -
  • - Shift + Primary mouse button will select all images between the clicked and focused image, or it will unselect all those images if the clicked image is already selected. -
  • -
  • - Shift + Ctrl + Primary mouse button works as Shift + Primary mouse button, but will not change the selection of files outside the region between the focus and clicked image. -
  • -
-

-
-
-

2.1.4.2. Keyboard

-
    -
  • - Ctrl + Arrows will move the focus without changing the selection. -
  • -
  • - Ctrl + Space will toggle selection of the focused image. -
  • -
  • - Shift + Arrows will select a region of images. -
  • -
  • - Shift + Ctrl + Arrows works as Shift + Arrows, but will not change the selection of files outside the current focus region. -
  • -
-

- To select all files press Ctrl + A, or to unselect all image press Ctrl + Shift + A. These operations are also available from the - Edit - menu as - Select all - and - Select none - . -

-

- The current number of selected images and their total size will be indicated in the File list section of the - status bar - . -

-

-
-
-
-

2.1.5. Sorting

-

The order of the images can be changed by clicking the sort area of the status bar or from the context menu. The sort methods are by file name, number, file date, or file size. The number method will sort file names by their natural order, for example files with names of file_10, file_12, and file_9 will appear in order file_9, file_10, and file_12.

-

Selecting the ascending menu item will toggle between increasing and decreasing sort order.

-

-
-
-

2.1.6. Context menu

-

- Right clicking the mouse or pressing the menu key while the file pane has focus will display a menu. The menu functions will perform the same as those that match the window's - menu bar - , however a few functions are unique to the context menu: -

-
-
- View in new window -
-
-

Opens a new window containing a list of the currently selected images.

-
-
- Sort -
-
-

Changes the sort order of file pane.

-
-
- View as icons -
-
-

Toggles between the list and icon view modes.

-
-
- Show thumbnails -
-
-

Toggles display of thumbnails in the list view display mode.

-
-
- Show filename text -
-
-

Toggles display of file names in the icon view display mode.

-
-
- Show star rating -
-
-

Toggles display of the "star rating" (Xmp.xmp.Rating).

-
-
-

-
-
-

2.1.7. Drag and Drop

-

Drag and drop can be initialized with the primary or middle mouse buttons in the file pane. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.

-

-
-
- - - diff --git a/web/help/GuideMainWindowFolderPane.html b/web/help/GuideMainWindowFolderPane.html deleted file mode 100644 index a393438d..00000000 --- a/web/help/GuideMainWindowFolderPane.html +++ /dev/null @@ -1,940 +0,0 @@ - - - - -Folder pane - - - - - - - - -
-

Folder pane

- -

The folder pane contains the menu bar, tool bar, path entry, and folder list.

-

-
-
-

2.2.1. Menu bar

-

- The main menu of the window. The functions available from the main menu are described in the - Menus - chapter. -

-

-
-
-

2.2.2. Tool bar

-

- The tool bar includes buttons for often used operations. The tool bar can be hidden or shown by selecting - Hide toolbar - from the - View - menu. -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconTooltipDescription
- - - - Show thumbnails - This button is active when the file list is in list view mode, and activating it will toggle the display of thumbnails. -
- - - - Back - Move back in folder history -
- - - - Up - Move up one folder -
- - - - Home - Change the main window to display the contents of the user's home folder -
- - - - Refresh folder display - Refresh the contents of the file pane -
- - - - Zoom in - Increase the image display size. -
- - - - Zoom out - Decrease the image display size. -
- - - - Zoom to fit - This will size the image to fit within the window -
- - - - Zoom 1:1 - Restore zoom to the image's original size. -
- - - - Preferences - - Displays the - Preferences window - . - -
- - - - Float file list - Toggle the folder pane, file pane, and status bar between the main window and a secondary window. -
-

-
-
-

2.2.3. Path entry

-

This displays the active folder of the window and allows typing a location.

-

- A folder or file can be typed into the entry to quickly change to a desired location or image, the main window will update after pressing the - Enter - key. Tab completion is also available in the path entry. -

-
-

- Tab completion uses the - Tab - key, press the - Down - key to move the focus from the entry. -

-
-

Next to the path entry is a button with a down arrow, clicking this will display a drop down list containing the most recent locations viewed. The list is ordered such that the most recent location is at the top. Selecting a location from the drop down list will change the window to display the location.

-

-
-
-

2.2.4. Folder list

-

This pane consists of two sections: a folder pane and a shortcuts pane. The shortcuts pane may be hidden or revealed simply by moving the vertical divider to or from the extreme left.

-
-
-

2.2.4.1. Folders

-

This displays a list of sub folders contained in the active folder, or a tree that includes all folders in the file system.

-

- A - context menu - can be displayed by clicking the right mouse button on the folder pane or pressing the menu key while the folder pane has the focus -

-
-
-

2.2.4.2. Shortcuts

-

This is a list of shortcuts (bookmarks) to commonly used folders, images and collections. A context menu will appear by right clicking on an item, or pressing the menu key when the item has the focus.

-

Folders or images can be added to the list by activating the Add button at the bottom of the pane, or dragging a folder or image onto the list.

-

- Collections may be added by opening the - File ▸ Open collection... ( - O - ) - dialog and dragging a collection onto the list. -

-

- To edit an item select - Properties - from its context menu. A dialog will appear allowing the Name, Path, and Icon for the item to be changed. Select OK to close the dialog and apply the changes, or Cancel to close the dialog and discard the changes. -

-

- To change the order of the list, select - Move up - or - Move down - from the item's context menu. To move an item with the keyboard move the focus to that item, then press - Shift+Up - or - Shift+Down - to move the item. -

-

- To remove an item from the list select - Remove - from it's context menu. -

-

-
-
-
-

2.2.5. List view

-

- This mode can be enabled by from the - View - menu, from the context menu, or pressing - Ctrl + T - . -

-

The list view mode displays sub folders contained in the active folder in a standard vertical list. The parent folder can be selected with the folder named “..”.

-

-
-
-

2.2.6. Tree view

-

- This mode can be enabled by selecting - Tree - from the View menu, pressing - Ctrl + T - , or selecting - View as tree - from the context menu. -

-

- The tree view mode displays all folders in the file system, starting with the root folder and branching out to include sub folders. A folder branch can be expanded or collapsed by clicking the expander next to each folder icon, or by pressing the respective - + - or - - - keys when the folder branch has the focus. -

-

-
-
-

2.2.7. Sorting

-

The order of the folder names will match the order selected for the file pane. Sort order can be changed by clicking the sort area of the status bar or from the context menu of the file pane.

-

-
-
-

2.2.8. Context menu

-

- Right clicking the mouse or pressing the menu key while the folder pane has focus will display a menu. The menu functions will perform the same as those that match the window's - menu bar - , however a few functions are unique to the context menu: -

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IconTextDescription
- - - - Up to parent - This will change the window to display the contents of the parent folder. -
Slide show - - Start a - slide show - that contains all images in the selected folder. - -
Slide show recursive - - Start a - slide show - that contains all images in the selected folder, and all images in the sub folders of that folder. - -
- - - - Find duplicates - - This will open a new - find duplicates - window containing all images in the selected folder. - -
- - - - Find duplicates recursive - - This will open a new - find duplicates - window containing all image in the selected folder, and all images in the sub folders of that folder. - -
New folder - Creates a new folder that is a sub folder of the selected folder. -
Rename -

Renames the selected folder.

-
- Warning: - Renaming a folder will not update metadata, such as keywords, or cached thumbnails for images contained in that folder, the data will be lost. -
-
- - - - Delete - Delete file or folder -
Copy path - - Copy selected item-path(s) to clipboard - 1 - . Each data item copied will be enclosed in quotes. - -
Copy path unquoted - Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes. -
View as list - Switches to list tree mode of the folder pane. -
View as tree - Switches to tree mode of the folder pane. -
Show hidden files - Switches to list tree mode of the folder pane. -
- - - - Refresh - Switches to tree mode of the folder pane. -
-

-
-
-

2.2.9. Drag and drop

-

Image files can be dropped onto folders displayed in the folder pane. A menu will appear allowing you to select to move or copy the dropped images into the target folder. The list will automatically scroll up or down when the drag pointer is near the respective top or bottom of the list. When in tree mode, hovering over a folder for a brief period of time will expand that folder.

-

The folders can used as a drag source for drag and drop, for example to add images in a folder to a collection window. However drag and drop can not be used to move or copy folders in Geeqie.

-

- Using - Shift - key while dragging is a shortcut to move action. Menu will not appear but move will occur. -

-

- Using - Ctrl - key while dragging is a shortcut to copy action. Menu will not appear but copy will occur. -

-

-
-
-1 - The clipboard used is selected - here. -
-
- - - diff --git a/web/help/GuideMainWindowImagePane.html b/web/help/GuideMainWindowImagePane.html deleted file mode 100644 index 93013c7d..00000000 --- a/web/help/GuideMainWindowImagePane.html +++ /dev/null @@ -1,668 +0,0 @@ - - - - -Image Pane - - - - - - - - -
-

Image Pane

- -

The image pane is the region of the main window that displays the selected image. The image pane allows adjustment of display size and orientation; it also provides several methods to manipulate the image with the mouse and keyboard.

-

-
-
-

2.3.1. Image display

-

The image is drawn to the screen as it is decoded from disk. The image can be panned and zoomed while it is still loading. Image adjustment operations for rotation, mirror, and flip will delay until the image is completed. The adjustment queue will remember one operation and will retain the most recently requested function, which will be performed once the image has finished loading.

-

- The quality of the image, especially when using the zoom feature, is dependent on the settings that are available on the - Image tab - of the preferences dialog. -

-

- To increase the speed of loading the next image when navigating the image list in sequence, enable the - Preload next image - option. -

-

-
-
-

2.3.2. Image Overlay

-

- An image overlay can be turned on and off by repeatedly pressing - I - . This overlay can either display image data such as f-stop, shutter speed and descriptive text, or a histogram. -

-

- Data the overlay will always show is: -

  • - Marks - , if they are selected -
-

-

- If the histogram is being displayed, - K - will switch the histogram between colors, and - J - will toggle between a linear or logarithmic histogram. -

-

- Data the overlay displays is customizable through the - Image Overlay Template - option in the Windows tab in the Preferences dialog. -

-

-
-
-

2.3.3. Image panning and manipulation

-

When the image size is larger than the image pane, the visible region can be changed with the keyboard or mouse. The keyboard can also be used to adjust the orientation of the image.

-

-
-
-

2.3.3.1. Keyboard and mouse

-

- Keyboard and Mouse Shortcuts - describes how you may manipulate the image displayed. -

-
-

- The rotation, mirror, and flip functions do not change the image data, they merely change the image as you view it. You may store the modified orientation into metadata manually with - Edit ▸ Orientation ▸ Apply the orientation to image content - , or this may happen automatically if - Write altered image orientation to the metadata - is set in - Metadata Options -

-
-

-
-
-

2.3.3.2. Mouse

-

- Press the primary mouse button on the image and hold it, then move the mouse to pan the image in the desired direction. Releasing the mouse button will stop the panning operation. The mouse wheel can also be used to scroll the image when holding down the Shift key - 1 - . -

-

To scale the image size hold down the Ctrl key and scroll the mouse wheel up to zoom in, or down to zoom out.

-

-
-
-

2.3.3.2.1. Smooth Scroll

-

To start the smooth scroll function hold down the Shift key and click the primary mouse button. An icon will appear at the location of the mouse pointer, the mouse can then be positioned to pan the image. The image will pan in the direction of the mouse pointer relative to the icon. The pan speed will increase in proportion to the distance that the pointer is from the center of the icon. To end the smooth scroll function click the primary mouse button within the image pane.

-

-
-
-

2.3.3.2.2. Mouse Wheel Mode

-

A single click on the mouse middle button will toggle the function of the mouse wheel between "change image" and "change zoom".

-
-

- This option cannot be used if either the Preference - Mouse wheel scrolls image - or - Navigation by left or middle click on image - are selected. -

-
-

In Split View mode, each window can be clicked individually so that, in Quad View for example, Connected Zoom can be on 2, 3 or all 4 windows.

-
-
-
-
-

2.3.4. Navigation

-

The displayed image can be changed to the next or previous image using the keyboard or mouse.

-

-
-
-

2.3.4.1. Keyboard

-

The PageDown and PageUp keys will change the image to the next or previous image, respectively, in the list. The Home and End keys will jump to the first and last image, respectively. When the image has the focus, the SpaceBar and BackSpace keys can also be used to change the image.

-

-
-
-

2.3.4.2. Mouse

-

- To change to the next image in the list click the left mouse button, click the middle mouse button to change to the previous image. The mouse wheel can also be used to change the current image - - . -

-

-
-
-
-

2.3.5. Context menu

-

- Right clicking the mouse or pressing the menu key while the image has the focus will display a menu. The menu functions will perform the same as those that match the window's - menu bar - , however a few functions are unique to the context menu: -

-
-
View in new window
-
-

Opens a new window containing a second copy of the current image.

-
-
Pause slide show, Continue slide show
-
-

Controls the pause state of an active slide show, the text of the menu will change to reflect the action that will be performed.

-
-
-

-
-
-

2.3.6. Drag and Drop

-

Files and folders can be dropped onto the image pane, dropping a file will display the file and dropping a folder will change the main window to display the contents of the folder. When dropping multiple items on the image pane, only the first item in the list will be used, all additional items will be ignored.

-

A drag and drop operation can be initiated from the image pane with the middle mouse button, the dragged item will contain the file path of the displayed image.

-

-
-
-

2.3.7. Displaying images side by side

-

Using View > Split item from the main menu, image pane can be split into either two or four panes, allowing one to display images side by side. You may use drag'n drop to change images in each pane.

-

- Connected zoom is possible through the - View▸Zoom▸Connected Zoom - menu item. Zoom is then applied to all displayed images. -

-

Connected scrolling is also possible using Shift and primary mouse button.

-

As a general rule, hotkeys and mouse without shift affects just one image and with shift all images.

-

-
-
-1 - The mouse wheel behavior for scrolling and image step can be swapped with the "Mouse wheel scrolls image" option located on the - Behaviour tab - of the preferences dialog. -
-
- - - diff --git a/web/help/GuideMainWindowLayout.html b/web/help/GuideMainWindowLayout.html deleted file mode 100644 index 47048ba9..00000000 --- a/web/help/GuideMainWindowLayout.html +++ /dev/null @@ -1,534 +0,0 @@ - - - - -Layout - - - - - - - - -
-

Layout

- -

- The main window consists of four areas, the - folder pane - , - file pane - , - image pane - , and the - status bar - . The status bar is always at the bottom of the window. The three remaining areas, or panes, can be arranged and sized by the user. -

-

- -
-

2.7.1. Selecting the location of each pane

-

- The arrangement of the folder, file, and image pane is selected on the - Window Layout - dialogue. -

-

-
-
-

2.7.2. Changing the size of a pane

-

Between the panes of the main window are two dividers that can be moved with the mouse to adjust the size of each pane. Press and hold the primary button, then move the divider to the desired location and release the button.

-

-
-
-

2.7.2.1. Folder pane

-

- The - folder pane - contains the menu bar, tool bar, path entry, and folder list. The list can be set to display the sub folders of the active folder or a tree that starts with the root folder and contains all folders in the file system. -

-

-
-
-

2.7.2.2. File pane

-

- The - file pane - lists the images contained in the active folder. The file pane can be set to display as a vertical list or an icon view. -

-

-
-
-

2.7.2.3. Image pane

-

- The - image pane - is where the active image is displayed. -

-

-
-
-
- - - diff --git a/web/help/GuideMainWindowMenus.html b/web/help/GuideMainWindowMenus.html deleted file mode 100644 index 7d91ca38..00000000 --- a/web/help/GuideMainWindowMenus.html +++ /dev/null @@ -1,1405 +0,0 @@ - - - - -Menus - - - - - - - - -
-

Menus

- -

This section describes the functions of each item on the menu bar in the Geeqie main window.

-

-
-
-

2.5.1. File Menu

-
-
- New window ( - Ctrl+N - ) -
-
-

Opens a new main window, with the initial path set to the current folder.

-
-
- New collection ( - C - ) -
-
-

Opens a new collection window, the new collection will be empty.

-
-
- Open collection ( - O - ) -
-
-

Displays a dialog to open a collection stored on disk, the selected collection will then appear in a new window.

-
-
- Open recent -
-
-

- This menu item lists the recently active collections, selecting an item from the list will open that collection in a new window. The most recent item will appear at the top of the list. Maximum number of entries can be modified through - Open recent list maximum size - option. -

-
-
- Search… ( - F3 - ) -
-
-

Opens a new Search window.

-
-
- Find duplicates... ( - D - ) -
-
-

Opens a new Find Duplicates window.

-
-
- Print.. ( - Shift+P - ) -
-
-

Opens a print dialog.

-
-
- New folder… ( - Ctrl+F - ) -
-
-

Creates a new folder in the current path.

-
-
- Copy… ( - Ctrl+C - ) -
-
-

Opens a dialog to select a destination to copy the currently selected files.

-
-
- Move… ( - Ctrl+M - ) -
-
-

Opens a dialog to select a destination to move currently selected files.

-
-
- Rename… ( - Ctrl+R - ) -
-
-

Renames the current file selection.

-
-
- Delete… ( - Ctrl+D - ) -
-
-

Deletes the current file selection.

-
-
- Symlink -
-
-

- Creates a symbolic link. This is implemented via a - plugin - . -

-
-
- Close window ( - Ctrl+W - ) -
-
-

Closes the window containing the menu, if the window is the last main window Geeqie will quit.

-
-
- Quit ( - Ctrl+Q - ) -
-
-

Quits the Geeqie application, if collections or image metadata have been changed but not saved, the user will be prompted for confirmation.

-
-
-

-
-
-

2.5.2. Go menu

-
-
- First Image ( - Home - ) -
-
-

Goes tothe first image.

-
-
- Previous Image ( - Backspace - ) -
-
-

Goes to the previous image.

-
-
- Next Image ( - Space - ) -
-
-

Goes to the next image

-
-
- Last Image ( - End - ) -
-
-

Goes to the last image

-
-
- Back -
-
-

Back Goes to the previous folder

-
-
- Home ( - Home - ) -
-
-

- Goes to the the Home folder as defined in - Window Layout -

-
-
-

-
-
-

2.5.3. Select menu

-
-
- Select all ( - Ctrl+A - ) -
-
-

Selects all files in the current list

-
-
- Select none ( - Ctrl+Shift+A - ) -
-
-

Deselects all files

-
-
- Invert selection ( - Ctrl+Shift+I - ) -
-
-

Inverts current selection

-
-
- Rectangular selection ( - Alt+R - ) -
-
-

Toggles rectangular selection mode for icons

-
-
- Copy path -
-
-

- Copy selected item-path(s) to clipboard - 1 - . Each data item copied will be enclosed in quotes. -

-
-
- Copy path unquoted -
-
-

Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes.

-
-
- Show marks ( - M - ) -
-
-

Displays marks in the file list

-
-
- Clear marks -
-
-

Clear all marks for all images

-
-

Marks that are linked to keywords will also be cleared. This may result in a metadata write operation being triggered.

-
-
-
- Mark n -
-
-

Opens submenu for manipulating mark n

-
-
- Mark n ▸ Toggle Mark n ( - n - ) -
-
-

Set or unset mark n on selected files

-
-
- Mark n ▸ Set mark n -
-
-

Set mark n on selected files

-
-
- Mark n ▸ Reset mark n -
-
-

Unset mark n on selected files

-
-
- Mark n ▸ Select mark n ( - Ctrl+n - ) -
-
-

Selects all files having mark n set

-
-
- Mark n ▸ Add mark n -
-
-

Adds files having mark n set to selection

-
-
- Mark n ▸ Intersection with mark n -
-
-

Intersects current selection and mark n

-
-
- Mark n ▸ Unselect mark n -
-
-

Removes files having mark n set from current selection

-
-
- Mark n ▸ Filter mark n -
-
-

Shows only the images that have mark n set.

-
-
-

-
-
-

2.5.4. Edit menu

-
-
- Orientation -
-
-

Adjust image orientation

-
-
- Orientation ▸ Rotate clockwise ( - ] - ) -
-
-

Rotates the current image clockwise 90 degrees, does not modify the file on disk.

-
-
- Orientation ▸ Rotate counterclockwise ( - [ - ) -
-
-

Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.

-
-
- Orientation ▸ Rotate 180 ( - Shift+R - ) -
-
-

Rotates the current image 180 degrees, does not modify the file on disk.

-
-
- Orientation ▸ Mirror ( - Shift+M - ) -
-
-

Swaps the left and right sides of the image so that the result is similar to that of looking at the image in a mirror, does not modify the file on disk.

-
-
- Orientation ▸ Flip ( - Shift+F - ) -
-
-

Swaps the top and bottom sides of the image, does not modify the file on disk.

-
-

- The above orientation commands - Rotate, Mirror and Flip - do not change the image on disk. The changes will be lost when Geeqie closes. Refer to the - Metadata tab of the Preferences Dialog - if you wish these changes to be written to metadata. -

-

- Refer also to the - FAQ - . -

-
-
-
- Orientation ▸ Original state ( - Shift+O - ) -
-
-

Removes all temporary effects applied through the above commands, reverting the image according to its Exif Orientation tag.

-
-
- Auto rotate image using EXIF information -
-
-

- Auto rotates images based on metadata stored in images that have Exif data. Refer also to the - FAQ - . -

-
-
- Orientation ▸ Apply the orientation to image content -
-
-

This command affects only jpeg, tiff and png files. The image file on disk is rotated to the orientation as specified by its Exif Orientation tag.

-
-

- The file rotate.desktop, using external commands exiftran, exiv2 and mogrify, is used to implement this command. Refer to - Plugins section - for details. -

-
-
-
- Orientation ▸ Rotate counterclockwise ( - [ - ) -
-
-

Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.

-
-
- Orientation ▸ Rotate 180 ( - Shift+R - ) -
-
-

Rotates the current image 180 degrees, does not modify the file on disk.

-
-
- Orientation ▸ Write orientation to file -
-
-

- Saves the current image orientation to the disk file. This operation can only be carried out on jpeg, tiff and png files. Jpeg rotations are lossless. -

- The Preferences/Metadata option "Write altered image orientation to the metadata" must be off. -

- Exiftran and mogrify must be installed. -
-

-
-
- Orientation ▸ Write orientation to file (preserve timestamp) -
-
-

As above, but the file date and time are preserved.

-
-
- Rating -
-
-

Set a Rating value for each image.

-
-
- Rating ▸ n ( - Alt+Keypad+n - ) -
-
-

"n" is in the range 0 to 5. Sets the Rating value for the image.

-
-
- Rating ▸ -1 ( - Alt+Keypad+Minus - ) -
-
-

Sets the Rating value to -1 for the image.

-
-
- Save metadata ( - Ctrl+S - ) -
-
-

Saves queued metadata changes. Autosave can be configured too.

-
-
-
-
- Preferences ( - Ctrl+O - ) -
-
-

- Opens the - Preferences Dialog - for changing of global preferences. -

-
-
- Configure Plugins… -
-
-

- Opens the - Plugins Dialog - for changing of desktop files. -

-
-
- Configure This window… -
-
-

- Opens the - Window Preferences Dialog - for changing of options that can differ for each window. -

-
-
- Cache maintenance -
-
-

- Opens a dialog with utilities for thumbnail and keyword - Cache and Data Maintenance - . -

-
-
- Set as wallpaper -
-
-

- Renders the current image to the root window (desktop). The resulting image will be tiled to fit the root window if zoom is not set to - Fit to window - ; when zoom is set to - Fit to window - , the image will be scaled to fill the root window. -

-
-
-

-
-
-

2.5.5. Plugins menu

-
-
- Plugins -
-
-

- This menu contains the plugins (desktop files) that were found on the system. See the - Plugins section - for details. -

-
-
-
-
-

2.5.6. View menu

-
-
- View in new window ( - Ctrl+V - ) -
-
-

Opens selected image in its own window

-
-
- Pan view ( - Ctrl+J - ) -
-
-

Opens current folder in Pan view window

-
-
- Exif data ( - Ctrl+E - ) -
-
-

Toggles display of the Exif sidebar.

-
-
- Files and Folders ▸ Folder List ( - Meta+L - ) -
-
-

Set the folder view mode to list.

-
-
- Files and Folders ▸ Folder Tree ( - Ctrl+T - ) -
-
-

Set the folder view mode to tree.

-
-
- Files and Folders ▸ Image List ( - Ctrl+L - ) -
-
-

Changes the file list to display files in list format.

-
-
- Files and Folders ▸ Icons ( - Ctrl+I - ) -
-
-

Changes the file list to display files as icons.

-
-
- Files and Folders ▸ Show Thumbnails -
-
-

Toggles the display of image thumbnails in the file list, this item is not available when the file list is in icon view mode. A check appears next to this item when thumbnails are enabled.

-
-
- Files and Folders ▸ Float file list ( - L - ) -
-
-

- Splits the 3-pane main window into two parts: -

    -
  • File pane and Folder pane, along with menu and status bar
  • -
  • Image pane and its associated sidebar and sort manager (if displayed)
  • -
-

-
-
- Files and Folders ▸ Hide file list ( - Ctrl+H - ) -
-
-

- Hides the File and Folder panes, along with menu and status bar. - Right-click - on the Image pane provides a menu item to redisplay these items. -

-
-
- Files and Folders ▸ Hide toolbar -
-
-

Toggles visibility of the tool bar. A check appears next to this item when the tool bar is not visible.

-
-
-
-
- Zoom -
-
-

-
-
- Zoom ▸ Connected zoom -
-
-

- Actions in this menu are identical to those in - Zoom - menu, but apply to all images displayed in split view. -

-
-
- Zoom ▸ Zoom in -
-
-

Increases the zoom by one increment, resulting in a larger image.

-
-
- Zoom ▸ Zoom out -
-
-

Decreases the zoom by one increment, resulting in a smaller image.

-
-
- Zoom ▸ Zoom to fit -
-
-

- Automatically adjusts the zoom so that the image will fit within the display pane. The effect on images with an original size smaller than the display pane can be changed with the - Allow enlargement of image for zoom to fit - option located on the - Image tab - of the preferences dialog. -

-
-
- Zoom ▸ Fit Horizontally -
-
-

Adjusts the zoom so image height fit within the display pane.

-
-
- Zoom ▸ Fit Vertically -
-
-

Adjusts the zoom so image width fit within the display pane.

-
-
- - - - - - New - -  ▸ Zoom ▸ Zoom n:m ( - Z - ) -
-
-

Set zoom to the n:m value. 1:1 is the original size of the image. When n is greater than m, zoom in occurs else zoom out occurs.

-
-
-
-
- Zoom ▸ Zoom n:m ( - Z - ) - Split -
-
-

-
-
- Split ▸ Horizontal -
-
-

Splits main image view in two horizontal panes.

-
-
- Split ▸ Vertical ( - U - ) -
-
-

Splits main image view in two vertical panes.

-
-
- Split ▸ Quad -
-
-

Splits main image view in four panes.

-
-
- Split ▸ Single ( - Y - ) -
-
-

Reverts to normal view mode (one image).

-
-
-
-
-
- Image Overlay ▸ Image Overlay -
-
-

Displays Image Overlay information box (OSD), use twice to add histogram to it.

-
-
- Image Overlay ▸ Histogram channels -
-
-

Switches channels displayed in the histogram (red, green, blue, RGB, value, maximum value).

-
-
- Image Overlay ▸ Histogram log mode -
-
-

Toggles between linear and logarithmical histogram.

-
-
- Full screen -
-
-

Toggles the full screen window display.

-
-
- Keywords -
-
-

Toggles display of the Keywords sidebar.

-
-
- Sort manager -
-
-

Toggles display of the Sort Manager sidebar.

-
-
- Hide Bars -
-
-

This item is intended to be used by its shortcut key - by default this is the backtick key. When pressed, the info sidebar, sort manager and file list will be hidden (if displayed). Pressing backtick again will revert the display to its previous layout.

-
-
- Toggle slideshow -
-
-

Begins or ends a slide show, the slide show status is displayed in the status bar.

-
-
- Pause slideshow -
-
-

Pauses a slide show, the slide show status is displayed in the status bar.

-
-
- Faster -
-
-

Decreases slide show interval in units of 0.5 seconds.

-
-
- Slower -
-
-

Increases slide show interval in units of 0.5 seconds.

-
-
- Refresh -
-
-

Updates the contents of the folder and file lists to match what is currently on disk, the current image will also be reread from disk.

-
-
-

-
-
-

2.5.7. Help menu

-
-
- Contents ( - F1 - ) -
-
-

Opens the Geeqie user manual in a new browser window.

-
-
- On-line help search -
-
-

- Use a web browser to search Geeqie's on-line help files. The search engine used is defined in - Preferences General - . -

-
-
- Keyboard shortcuts -
-
-

Displays a window listing the default keyboard shortcuts.

-
-
- Keyboard Map -
-
-

Displays an image showing the currently allocated keyboard shortcuts.

-
-
- Release notes -
-
-

Displays a window containing the release notes for the version of Geeqie in use.

-
-
- About -
-
-

Opens a window containing the Geeqie version, credits, website, and email contact information.

-
-
- Log window -
-
-

Opens the log window, mostly used for debugging purposes.

-
-
-

-
-
-

2.5.8. Tear off menus

-

Menus can be permanently displayed by selecting the dotted line item at the top of each menu category. A tear off menu will behave the same as an ordinary window. To close a tear off menu, select the dotted line item at the top of the menu.

-

-
-
-

2.5.9. Keyboard shortcuts

-

- The keyboard sequence associated to each menu entry is listed within the main window menu bar. For reference, the complete list of default keyboard shortcuts can be found in section - Keyboard Shortcuts - . -

-

-
-
-

2.5.10. Changing the main window menu bar keyboard shortcuts

-

- The section - Keyboard Options - describes how to modify the keyboard shortcuts used in the main menu. -

-
-
-1 - The clipboard used is selected - here. -
-
- - - diff --git a/web/help/GuideMainWindowNavigation.html b/web/help/GuideMainWindowNavigation.html deleted file mode 100644 index c2aba5ca..00000000 --- a/web/help/GuideMainWindowNavigation.html +++ /dev/null @@ -1,510 +0,0 @@ - - - - -Navigation - - - - - - - - -
-

Navigation

- -

-
-
-

2.4.1. Moving around in the file system

-

To select the folder containing the desired images for display, change to the image's folder using the folder view. Single clicking a folder with the primary mouse button will change the main window to display that folder's contents. When the folder view is displayed as a list, use the folder named “..” to change to the parent folder (the parent folder is the folder that contains the current folder).

-

To select a folder with the keyboard, move the focus to the desired folder and press the - Space or Enter key.

-

-
-
-

2.4.2. Moving around within a folder

-

After selecting the desired folder as above, the desired image can be viewed by selecting it from the file list. To select a file for display single click it with the primary mouse button.

-

To select a file with the keyboard, move the focus to the desired file. As you move the focus within the file list the image display will update to match the highlighted file.

-

-
-
-

2.4.3. Going home

-

To change to your home folder, click the Home button in the tool bar. Home folder can be set in window preferences.

-

-
-
-

2.4.4. Direct path entry

-

The current path is displayed in an entry field above the folder list. A folder or file can be typed into the entry to quickly change to a desired location or image, the main window will update after pressing the Enter key. Tab completion is also available in the path entry.

-

Next to the path entry is a button with a down arrow, clicking this will display a drop down list containing the most recent locations viewed. The list is ordered such that the most recent location is at the top. Selecting a location from the drop down list will change the window to display the location.

-

-
-
-

2.4.5. Stepping through images sequentially

-

To change the displayed image to next or previous one within the same folder, use the respective PageDown and PageUp keys. The mouse can also be used to change the image by clicking the image display with the respective primary and middle buttons.

-

To change to beginning or end of the image list, use the respective Home or End keys.

-

-
-
- - - diff --git a/web/help/GuideMainWindowStatusBar.html b/web/help/GuideMainWindowStatusBar.html deleted file mode 100644 index 5c617b73..00000000 --- a/web/help/GuideMainWindowStatusBar.html +++ /dev/null @@ -1,681 +0,0 @@ - - - - -Status Bar - - - - - - - - -
-

Status Bar

- -

The status bar contains information and details about the contents of the main window. Information displayed includes the progress of generating thumbnails, the number of files in the file list with byte size, the current file selection count including byte size, details about the currently displayed image, and the zoom and image scroll settings. The current sort preference is also displayed, and can be adjusted from the status bar.

-

The status bar is comprised of five sections, from left to right these are a progress bar, sort method, file list counts, image details, and zoom and scroll setting. Each section is described below.

-

-
-
-

2.6.1. Progress Bar

-

- The Progress bar updates to display the current state of thumbnail generation, or the reading of metadata in the current folder. -

- When “Loading thumbs...” is displayed, thumbnails are currently being generated when Geeqie is idle; the progress bar will update to display the percentage of thumbnails that are completed. -

- When “Loading meta...” is displayed, certain metadata is being loaded when Geeqie is idle; the progress bar will update to display the percentage of files that have been read. Refer to - Preferences metadata. -

-
-
-

2.6.2. Sort method

-

This is the method used to sort image names in the file list. Clicking or activating this field will display a menu to allow selection of the sort method.

-
-
- Name -
-
-

Images are sorted by file name.

-
-
- Number -
-
-

Images are sorted by natural numerical order, such that, for example, 9_name.jpg will be listed before 10_name.jpg.

-
-
- Date -
-
-

Images are sorted by file modification date.

-
-
- File Date -
-
-

- Images are sorted by one of four types of file date. They are described in the - Reference section - . -

-
-
- Size -
-
-

Images are sorted by file size on disk.

-
-
- Rating -
-
-

Image are sorted by Xmp.xmp.Rating.

-
-
- Class -
-
-

Image are sorted by class. The class types, and sort order, is:

-
    -
  • Unknown
  • -
  • Image
  • -
  • Raw Image
  • -
  • Video
  • -
  • Metadata
  • -
-
-
- Ascending -
-
-

Toggles between increasing and decreasing sort order. A check will appear next to this entry to indicate ascending sort order.

-
-
-
When images have equal rank, for example in rating or class sorts, within each section images will be sorted by filename.
-
-
-

2.6.3. File list

-

This section displays the count of files that appear in the file list, including the total byte size. The number of files selected is displayed in parenthesis, including the total byte size of the selected files. The slide show status is also displayed here; when a slide show is running, “Slideshow” will appear, the text will change to “Paused” when a slide show is in the paused state.

-

-
-
-

2.6.4. Image Details

-

This section displays the dimensions (width x height) and file byte size of the image that is active in the image pane. When the format of the file in the image pane can not be determined the dimensions will show as “(0 x 0)”, in addition “(no read permission)” may appear if the file permissions do not allow reading the contents of the file.

-

-
-
-

2.6.5. Buttons

-

Statusbar buttons corresponds to selected menu action.

-

-
-
-

2.6.5.1. Zoom and Scroll

-

The button label displays the current zoom ratio. A ratio of 1:1 is the image's original size. When the left number is larger the image is displayed larger than original size, when the right number is larger the image is displayed smaller.

-

A tilde (~) appears within the ratio display when the zoom is set to fit the image within the display area. In this zoom mode the ratio is automatically adjusted, and the displayed ratio may not be the actual ratio because the status bar display rounds the actual value to the nearest tenth (0.1).

-

-

Clicking this button permits control of the behavior of the zoom and scroll settings used when changing the displayed image.

-
-
- Zoom to original size -
-
-

The new image is set to its original size.

-
-
- Fit image to window -
-
-

The new image's zoom is changed so that the image will fit within the current view area.

-
-
- Leave zoom at previous setting -
-
-

The zoom setting is unchanged, the new image will be scaled the same as the previous image.

-
-
-
-
- Scroll to top left corner -
-
-

The new image is displayed from top left corner.

-
-
- Scroll to image center -
-
-

The new image is centered

-
-
- Keep the region from previous image -
-
-

The new image is positioned as the previous one, whenever possible.

-
-
-
-
-

2.6.5.2. Exif rotate

-

- - - - Toggles the auto-rotation of images if they have Exif orientation data. - Refer also to the - FAQ - . -

-

-
-
-

2.6.5.3. Show Pixel Info

-

- - - - Shows coordinates and RGB value under cursor. -

-

-
-
-

2.6.5.4. Enable Color Management

-

- - - - Enables color profiles. -

-

-
-
-

2.6.5.5. Save Metadata

-

- - - - Opens dialog for review and saving of metadata changes. -

-

-
-
-
- - - diff --git a/web/help/GuideOptionsAdditional.html b/web/help/GuideOptionsAdditional.html deleted file mode 100644 index ab1751c0..00000000 --- a/web/help/GuideOptionsAdditional.html +++ /dev/null @@ -1,470 +0,0 @@ - - - - -Additional Preferences - - - - - - - - -
-

Additional Preferences

- -

There are two sets of preferences in Geeqie: those set via the main Preferences tabbed dialogue, and those set either via a menu entry or by editing a configuration file.

-

- This chapter explains in detail the Geeqie preferences that are set via a menu entry or by editing a configuration file. -

-

-
-
- - - diff --git a/web/help/GuideOptionsBehavior.html b/web/help/GuideOptionsBehavior.html deleted file mode 100644 index 91c3a495..00000000 --- a/web/help/GuideOptionsBehavior.html +++ /dev/null @@ -1,708 +0,0 @@ - - - - -Behavior Options - - - - - - - - -
-

Behavior Options

- -

This section describes the options presented under the Behavior Tab of the preferences dialog.

-
-
-

11.11.1. Delete

-
-
- Confirm permanent file delete -
-
-

Prompts for confirmation before deleting files.

-
-
- Confirm move file to Trash -
-
-

Prompts for confirmation before moving files to the trash bin.

-
-
- - Enable - Delete key - -
-
-

- Disable this to disassociate the delete file function from the - Delete - key. -

-

- If - Confirm file delete - , above, is disabled, accidentally hitting the - Delete - can result in files being erroneously deleted without warning. Disabling the - Delete - key will prevent this. The - - Ctrl + - D - - key sequence is not affected. -

-
-
- Use Geeqie trash location -
-
-

Moves deleted files to a temporary folder, for easy retrieval of deleted files. Files in the temporary folder are retained until the maximum size is reached, at which point deleting additional files will result in the removal of the oldest files to reclaim the space needed for the new files.

-
-

- Files moved to the Safe Delete folder are prefixed with a six digit number in the format: - nnnnnn_FILENAME -

- This is used by the delete feature to distinguish which files to remove first when clearing space for new files. -

- The digit counter increments with each deleted file. -

-
-
-
- Use system Trash bin -
-
-

Moves deleted files to the system-defined trash bin.

-
-
- Folder -
-
-

The location of the folder used by the Safe Delete feature.

-
-
- Maximum size -
-
-

The size to use for the Safe Delete folder, in megabytes. Note that setting this value to 0 (zero) will disable any limit.

-
-
- Clear button -
-
-

Removes all files contained in the Safe Delete folder.

-
-
- View button -
-
-

Changes the Geeqie main window to display the contents of the Safe Delete folder.

-
-
-
-
-

11.11.2. Behavior

-
-
- Descend folders in tree view -
-
-

This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.

-
-

Disable this if Geeqie wakes up auto mounted network shares, or takes too long to initially display the folder view.

-
-
-
- In place renaming -
-
-

When renaming a single file, this will allow the rename entry to appear directly over the original filename.

-
-
- List directory view uses single click to enter -
-
-

If selected, a single click will enter a directory, rather than the GTK+ default of a double click.

-
-
- Save marks on exit -
-
-

Save all marks that have been set. Note that marks that are linked to a keyword will always be saved irrespective of this setting.

-
-
- Use "With Rename" as default for Copy/Move dialogs -
-
-

Move the "With Rename" button to the default position.

-
-
- Open Collections on top -
-
-

Open collection windows with "Always on Top" set.

-
-
- Recent folder list maximum size -
-
-

This is the number of entries to be saved from the recent open folder list drop-down box. The number of entries displayed in the current session is unlimited.

-
-
- Drag'n drop icon size -
-
-

This is the width and height of the icon generated from image and displayed when doing drag and drop actions. High resolution screens may require to increase this number.

-
-
- Copy path clipboard selection -
-
-

- This option determines which clipboard selection is used for the "Copy path" menu item. The exact method of the paste operation will depend on the operating system, but in general will be: -

-
- PRIMARY -
-
-

Paste using mouse middle-click, or shift-insert.

-
-
- CLIPBOARD -
-
-

Paste using mouse right-click and select paste, or control-v.

-
-
-

-
-
-
-
-

11.11.3. Navigation

-
-
- Progressive keyboard scrolling -
-
-

This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.

-
-
- Keyboard scrolling step multiplier: -
-
-

Defines the amount to pan an image when using the keyboard arrows.

-
-
- Mouse wheel scrolls image -
-
-

- The default is for the mouse wheel to change the image, and to scroll the image when - Shift - is used in combination with the wheel. Enabling this swaps the behavior so that operating the wheel will scroll the image, and holding down - Shift - will change the image. -

-
-
- Navigation by left or middle click on image -
-
-

If selected, mouse left-click will select the next image; mouse middle-click will select the previous image.

-
-
- Play video by left click on image -
-
-

If selected, mouse left-click on an image belonging to the video class will start a program chosen in a box below.

-
-
-
-
-

11.11.4. Debugging

-
-
- Debug level -
-
-

Displayed when compiled with the option --enable-debug-log. This defines the verbosity of debug info sent to console and log window (0 disables the debug output).

-
-
- Log Window max. lines -
-
-

The maximum number of data lines to be displayed. The window will show the most recent data.

-
-
-
-
- - - diff --git a/web/help/GuideOptionsColor.html b/web/help/GuideOptionsColor.html deleted file mode 100644 index 7382dcfb..00000000 --- a/web/help/GuideOptionsColor.html +++ /dev/null @@ -1,502 +0,0 @@ - - - - -Color management options - - - - - - - - -
-

Color management options

- -

Use of this function requires LCMS to be installed. If you are compiling from sources, LCMS functionality will be available if the development files dependencies are met.

-

If you are using a pre-compiled distribution, availability depends on the package maintainer.

-

- Here one can defined color profiles to use. Color management can be enabled or disabled from - View ▸ Color Management - or - - - - on the status bar. -

-
-
- Type -
-
-

Either input color profile or screen color profile.

-
-
-
-
- Menu name -
-
-

Name of the menu entry corresponding to the color profile.

-
-
-
-
- File -
-
-

Path to the color profile file.

-
-
-
- - - diff --git a/web/help/GuideOptionsFiltering.html b/web/help/GuideOptionsFiltering.html deleted file mode 100644 index 261026f4..00000000 --- a/web/help/GuideOptionsFiltering.html +++ /dev/null @@ -1,653 +0,0 @@ - - - - -Files Options - - - - - - - - -
-

Files Options

- -

This section describes the options presented under the Files Tab of the preferences dialogue.

-

-
-
-

11.6.1. Filters

-
-
- Show hidden files or folders -
-
-

Enables the display of hidden files and folders, also known as dot files.

-
-
- Show parent folder -
-
-

Enables the display of the parent folder as a double dot in the directories views.

-
-
- Case sensitive sort -
-
-

Files and folders are sorted such that upper case letters occur before lower case letters.

-

- Enabled result: A, B, C, a, b, c -

- Disabled result: A, a, B, b, C, c -

-
-
- Natural sort order -
-
-

Files and folders are sorted with the dot '.' treated as a special case, so the order is e.g. "event.c" "event.h" "eventgenerator.c". Also, files containing numbers are sorted as "file1" "file5" "file10".

-
-
- Disable file extension checks -
-
-

During rename operations, allows files to be renamed to a different extension with no warning issued.

-
-
- Disable file filtering -
-
-

Enable this to allow Geeqie to list all files, even those that do not contain images.

-
-
-

-
-
-

11.6.2. Grouping sidecar extensions

-

This field defines which extensions will lead to file grouping. Grouped files will appear as a single entry in file views. This is useful, for example, when browsing directories containing two files for the same image (such as raw+jpeg files generated by some cameras).

-

The group is represented by the first extension in the list for which a file exists.

-

- Each extension should include the starting dot and should be separated by a semi-colon from following entries. It is possible to use wild-cards corresponding to entries in the - File Types Class - below: -

-
- %unknown -
-
- expands to all files listed in class - Unknown - , -
-
- %image -
-
- expands to all files listed in class - Image - , -
-
- %raw -
-
- expands to all files listed in class - RAW Image -
-
- %meta -
-
- expands to all files listed in class - Metadata -
-
-

-

-

-
-
-

11.6.3. File types

-

- This list contains the image formats that are understood by Geeqie. To disable a specific file type from being displayed, uncheck it's corresponding check-box. Filters can be edited by first selecting the line containing the item to be changed, then clicking the filter or description field, making any changes, then pressing - Enter - ; press - Escape - to cancel an active edit. -

-
-

Unlike all other options in the dialogue, filter list changes are applied immediately.

-
-

- The table consists of: -

-
- Filter -
-
- List of extensions this filter applies to, separated by a - ; - . Each extension must be preceded by a dot. -
-
- Description -
-
Brief description. This is not used elsewhere.
-
- Class -
-
- This may be used to define sets of file types, for use in the - Grouping - function described above. The drop-down list has 6 entries: -
    -
  • Unknown
  • -
  • Image
  • -
  • RAW Image
  • -
  • Metadata
  • -
  • Video
  • -
  • Collection
  • -
-
-
- Writable -
-
If this option is checked, Geeqie will try to write metadata to the image file itself. This, and the following option, are mutually exclusive.
-
- Sidecar is allowed -
-
If this option is checked, Geeqie will try to write metadata to a sidecar file associated with the image. This, and the previous option, are mutually exclusive.
-
-

-
-
- - - - - Add - -
-
Adds a new blank line to the filter list, change the parameters to match the desired file type.
-
-
-
- - - - - Remove - -
-
Removes the selected line from the filter list.
-
-
-
- Defaults -
-
Resets the filter list to the default values, discarding any customizations made by the user.
-
-
-
- - - diff --git a/web/help/GuideOptionsGeneral.html b/web/help/GuideOptionsGeneral.html deleted file mode 100644 index 345c4772..00000000 --- a/web/help/GuideOptionsGeneral.html +++ /dev/null @@ -1,700 +0,0 @@ - - - - -General Options - - - - - - - - -
-

General Options

- -

This section describes the options presented under the General Tab of the preferences dialog.

-
-
-

11.1.1. Thumbnails

-
-
- Size -
-
-

Selects the size of the thumbnails displayed throughout Geeqie, dimensions are width by height in pixels.

-
-
-
-
- Quality -
-
-

- Selects the method to use when scaling an image down for thumbnails: -

-
- Nearest -
-
-

Fastest scaler, but results in poor thumbnail quality.

-
-
- Tiles -
-
-

Thumbnail results are very close to bilinear, with better speed.

-
-
- Bilinear -
-
-

High quality results, moderately fast.

-
-
- Hyper -
-
-

Slowest scaler, sometimes gives better results than bilinear.

-
-
-

-
-
-
-
- Cache thumbnails -
-
-

Enable this to save thumbnails to disk. Subsequent requests for a thumbnail will be faster.

-
-
- Use Geeqie thumbnail style and cache -
-
-

Thumbnails are stored in a folder hierarchy that mirrors the location of the source images. Thumbnails have the same name as the original appended by the file extension .png.

-

- The root of the hierarchy is: -

-

$XDG_CACHE_HOME/geeqie/thumbnails/
- or, if $XDG_CACHE_HOME is not defined: -
$HOME/.cache/geeqie/thumbnails/
-

-

-
-
-
-
- Store thumbnails local to image folder (non-standard) -
-
-

- When enabled, Geeqie attempts to store cached thumbnails closer to the source image. This way multiple users can benefit from a single cache, thereby reducing wasted disk space. -

- Thumbnails have the same name as the original appended by the file extension .png. -

- The resulting location is the source image's folder, in a sub folder with the name -
.thumbnails
-

- When the image source folder cannot be written, Geeqie falls back to saving the thumbnail in the user's home folder. -

-
-
-
-
- Use standard thumbnail style and cache, shared with other applications -
-
-

- This will use a thumbnail caching method that is compatible with applications that use the standard thumbnail specification. When this option is enabled thumbnails will be stored in: -

-

$XDG_CACHE_HOME/thumbnails/
- or, if $XDG_CACHE_HOME is not defined: -
$HOME/.cache/thumbnails/
-

-

- All thumbnails are stored in the same folder, with computer-generated filenames. Refer to - Thumbnails Reference - for additional details. -

-

-
-
-
-
-
-
- Use EXIF thumbnails when available -
-
-

Geeqie will extract thumbnail from EXIF data if available, instead of generating one. This will speed up thumbnails generation, but the EXIF thumbnail may be not in sync with the image if it was modified by a tool which did not also update the thumbnail data.

-
-
-
-
-

11.1.2. Star Rating

-

The characters used to display the Star Rating are defined here. They are defined as a hexadecimal Unicode character. The complete list of Unicode characters can be found in many places on the Internet.

-
-
-

11.1.3. Slide show

-
-
- Delay between image change -
-
Specifies the delay between images for slide shows, in seconds.
-
-
-
- Random -
-
- When enabled, slide show images will appear in random order. -
-

Random images are displayed such that each image appears once per cycle of all images. When the slide show repeat option is enabled, the image order is randomized after completing each cycle.

-
-
-
-
-
- Repeat -
-
This will cause the slide show to loop indefinitely, it will continue with the first image after displaying the last image in the slide show list.
-
-
-
-

11.1.4. Image loading and caching

-
-
- Decoded image cache size -
-
-

Limit the amount of memory available for caching images.

-
-
- Preload next image -
-
-

Enabling this option will cause Geeqie to read the next logical image from disk when idle, it will also retain the previously viewed image in memory. By reading the nearest images into memory, time to display the next image is reduced.

-
-

This option will increase Geeqie memory requirements, and may cause performance issues with very large images. If the use of Geeqie results in the system noticeably swapping memory to disk, try disabling this feature.

-
-
-
- Refresh on file change -
-
-

Geeqie will monitor currently active images and folders for changes in their modification time, and update the display if it changes.

-
-

Disable this if the system will not go into sleep mode due to occasional disk activity from the time check, or if Geeqie updates too often for folders with continuously changing content.

-
-
-
-
-
-

11.1.5. Info Sidebar component heights

-

- The heights of the following components can be set individually: -

    -
  • Keywords
  • -
  • Title
  • -
  • Comments
  • -
-

-
-

Geeqie must be restarted for changes to take effect.

-
-
-
-
-

11.1.6. Show predefined keyword tree

-

Deselecting this option will hide the list of predefined keywords on the right-hand side of the keywords pane of the info sidebar.

-
-

Geeqie must be restarted for the change to take effect.

-
-
-
-
-

11.1.7. On-line help search

-

- An internet search engine may be used to search the help files on Geeqie's website. The string used to conduct the search is defined here. In most cases it will be in one of two formats: -

- https://www.search-engine.com/search?q=site:geeqie.org/help -

- https://www.search-engine.com/?q=site:geeqie.org/help' -

-
-
-
- - - diff --git a/web/help/GuideOptionsHidden.html b/web/help/GuideOptionsHidden.html deleted file mode 100644 index 8e9c9575..00000000 --- a/web/help/GuideOptionsHidden.html +++ /dev/null @@ -1,501 +0,0 @@ - - - - -Legacy Configuration File Options - - - - - - - - -
-

Legacy Configuration File Options

- -

-

- This section describes the options not accessible by the graphical interface, these options exist to maintain behavior of older releases of Geeqie. To change these settings, edit the - Geeqie configuration file - . -

-

- - lazy_image_sync: [true - false - ] - - : This will suppress the image view from changing when selecting a new folder; the current image will remain displayed until the user manually selects another image. -

-

- - place_dialogs_under_mouse: [true - false - ] - - : Enabling this will cause new dialogs to initially position themselves such that they are under the current mouse position. -

-

-
- scroll_reset_method: value - : This will set the method used to set the scroll position, or visible region of a new image, value can be: -
-
0: Move to upper left corner.
-
1: Center image.
-
2: Maintain same visible region as previous image, if possible.
-

- - thumbnails.use_xvpics = [true - false - ] - - : xvpics is a common thumbnail caching format used by several applications. Thumbnails are stored locally to the source image in a sub folder with the name - .xvpics - . Enabling this option will allow Geeqie to read thumbnails saved in the xvpics format. -

-
-

Support for xvpics is read only, Geeqie can not generate thumbnails in this format.

-
-
- - - diff --git a/web/help/GuideOptionsImage.html b/web/help/GuideOptionsImage.html deleted file mode 100644 index bbbd9e01..00000000 --- a/web/help/GuideOptionsImage.html +++ /dev/null @@ -1,615 +0,0 @@ - - - - -Image Options - - - - - - - - -
-

Image Options

- -

This section describes the options presented under the Image Tab of the preferences dialog.

-
-
-

11.2.1. Zoom

-
-
- Quality -
-
-

- Selects the method used to scale the size of an image: -

-
- Nearest -
-
-

Fastest scaler, but results in poor image quality.

-
-
- Tiles -
-
-

Results are somewhat close to bilinear, with better speed.

-
-
- Bilinear -
-
-

High quality results, moderately fast.

-
-
- Hyper -
-
-

Slowest scaler, sometimes gives better results than bilinear.

-
-
-

-
-
- Use GPU acceleration via Clutter library -
-
-

Use alternate renderer. Geeqie must be compiled with the --enable-gpu-accel option.

-
-
- Two pass zooming -
-
-

- Enables Geeqie to first display a scaled image using the - Nearest - zoom quality. After image decoding is complete, the image is scaled again using the selected - Zoom Quality - method. This allows faster display of an image as it is decoded from the source file. -

-
-
- Zoom increment -
-
-

Adjusts the step size when zooming in or out on an image. This value corresponds to the percentage of the original image.

-
-
-
-
-

11.2.2. Fit Image To Window

-
-
- Allow enlargement of image (max. size in %) -
-
-

- Enable this to allow Geeqie to increase the image size for images that are smaller than the current view area when the zoom is set to - Fit image to window - . This value sets the maximum expansion permitted in percent i.e. 100% is full-size. -

-
-
- Virtual window size (% of actual window) -
-
-

- This value will set the virtual size of the window when - Fit image to window - is set. Instead of using the actual size of the window, the specified percentage of the window will be used. It allows one to keep a border around the image (values lower than 100%) or to auto zoom the image (values greater than 100%). It affects fullscreen mode too. -

-
-
-
-
-

11.2.3. Appearance

-
-
- Custom border color -
-
-

Enable this to draw the image background (the area around the image) in the specified color.

-
-
-
-
- Border color -
-
-

Use this color chooser to define the color to use as image background.

-
-

- You may use the - Virtual window size - (see above) option to keep a border around the image in fullscreen mode. -

-
-
-
-
-
- Alpha channel color 1/2 -
-
-

These two colors define the checkerboard background used when images with an alpha channel are displayed.

-
-
-
-
-

11.2.4. Convenience

-
-
- Auto rotate proofs using EXIF information -
-
-

Auto rotate images on print proof sheet.

-
-
-
-
- - - diff --git a/web/help/GuideOptionsKeyboard.html b/web/help/GuideOptionsKeyboard.html deleted file mode 100644 index 92c63e4a..00000000 --- a/web/help/GuideOptionsKeyboard.html +++ /dev/null @@ -1,470 +0,0 @@ - - - - -Keyboard Options - - - - - - - - -
-

Keyboard Options

- -

This dialogue enables changes to be be made to the default key short-cut allocated to menu items.

-

The data displayed may be ordered by clicking at the top of each column.

-

To change or create a new short-cut, double click on the KEY column of the relevant item. The text displayed will change to "New accelerator...". Press the key combination required for this action. The Apply button must be pressed for the change to be made permanent.

-
- - - diff --git a/web/help/GuideOptionsKeywords.html b/web/help/GuideOptionsKeywords.html deleted file mode 100644 index f08b7b47..00000000 --- a/web/help/GuideOptionsKeywords.html +++ /dev/null @@ -1,491 +0,0 @@ - - - - -Keywords - - - - - - - - -
-

Keywords

- -

This section describes the keywords list used for autocompletion.

-

-
-
-

11.8.1. Keyword Search

-

-

Pressing the Search button will open a dialog which permits a recursive search to be made for keywords already attached to images. The result of the search is automatically appended to the existing list.

-
-
-

11.8.2. Keyword List

-

-

- The list shows all keywords currently used for autocompletion. Text may be copy-pasted into the list or deleted from the list. -

- When the list is saved, duplicates will automatically be removed and the list sorted into alphabetical order. -

-
-
- - - diff --git a/web/help/GuideOptionsLayout.html b/web/help/GuideOptionsLayout.html deleted file mode 100644 index 9b437ff8..00000000 --- a/web/help/GuideOptionsLayout.html +++ /dev/null @@ -1,536 +0,0 @@ - - - - -Window Layout - - - - - - - - -
-

Window Layout

- -

- This item is accessed via - Edit ▸ Configure this window - . -

-
-
- Home Path -
-
-

- The path to be moved to when - - - - - - - - is clicked. -

-
-
- Show date in directories list view -
-
-

The folder pane will show dates.

-
-
- Exit program when this window is closed -
-
-

- If multiple instances of Geeqie have been started via - File ▸ New Window - , if this check box is clicked all instances will be closed when this window is exited. -

-
-

When a window with this check box selected is closed, the existence of all other open Geeqie windows will be remembered. When Geeqie is started again, all those windows will be re-opened.

-
-
-
- Start-up directory -
-
-

This may be set for each instance of Geeqie.

-
    -
  • - No change: Use the Current Working Directory. If called from a system menu rather than the command line, the Home directory will probably be used. -
  • -
  • - Restore last path: Use the folder in use when Geeqie was previously closed. -
  • -
  • - Home path: Use the folder specified in the Home Path box. -
  • -
-
-
- Layout -
-
-

- The Geeqie main window consists of three main panes: the - folder pane - , - file pane - and the - image pane - . Their position and order can be changed here. The four choices shown represent the basic layout of the main window, the difference being that each has the larger pane in a different location: right, bottom, left, and top. -

-

The numbers within each selection represent the order of the pane content.

-

The order in which the panes are filled is determined by the three row list located below the layout selection. The three numbered rows correspond to the three numbered regions of the selected layout. To change the order of the list, drag a row to the desired location within the list.

-
-

In this dialogue the file and image panes are labeled as such, however for historical reasons the folder pane is labeled as tools.

-
-
-
-
- - - diff --git a/web/help/GuideOptionsMain.html b/web/help/GuideOptionsMain.html deleted file mode 100644 index 00ac2321..00000000 --- a/web/help/GuideOptionsMain.html +++ /dev/null @@ -1,514 +0,0 @@ - - - - -Preferences - - - - - - - - -
-

Preferences

- -

There are two sets of preferences in Geeqie: those set via the main Preferences tabbed dialogue, and those set either via a menu entry or by editing a configuration file.

-

- This chapter explains in detail the main Geeqie preferences dialog, which is accessed via - Edit ▸ Preferences ( - Ctrl+O - ) - or - - - - on the Toolbar. -

-

-
-
- - - diff --git a/web/help/GuideOptionsMetadata.html b/web/help/GuideOptionsMetadata.html deleted file mode 100644 index 795a2a12..00000000 --- a/web/help/GuideOptionsMetadata.html +++ /dev/null @@ -1,665 +0,0 @@ - - - - -Metadata - - - - - - - - -
-

Metadata

- -

This section describes the options for metadata writing.

-

-

- The settings in the - Files tab of Preferences - influence whether an attempt is made to write metadata to the file itself, to a sidecar file or to a local folder. -

-

- Refer also to - Metadata Processing - in the Reference section. -

-
-
-

11.7.1. Metadata writing process

-

- When writing metadata, Geeqie will follow three steps. This process will stop when the first successful write occurs. -

    -
  1. - - Save metadata in image files, resp. sidecar files, according to the XMP standard -

    - If checked, Geeqie will attempt to write metadata to the file itself, or to an associated XMP sidecar file -
    -
  2. -
  3. - - Save metadata in '.metadata' folder, local to image folder (non-standard) -

    - If checked, Geeqie will attempt to write to an xmp file in a local .metadata folder -
    -
  4. -
  5. - - Save metadata in Geeqie private directory -

    - If neither of the above are successful, Geeqie will write to an xmp file in the folder -
    $HOME/.local/share/geeqie/metadata
    -
    -
  6. -
-

-

When writing to local metadata folders, the directory structure duplicates that of the location of the source files.

-
-
-

11.7.2. Step 1: Write to image files

-

If Step 1 above was successful, the following options take effect:

-
    -
  • - - Store metadata also in legacy IPTC tags (converted according to IPTC4XMP standard) -

    - If checked, Geeqie will write IPTC tags as defined in - Standards -
    -
  • -
  • - - Warn if the image files are not writeable -

    - If checked, open a warning dialogue if the file is not writeable -
    -
  • -
  • - - Ask before writing to image files -

    - If checked, open a confirmation dialogue before writing to the file -
    -
  • -
  • - - Create sidecar files named image.ext.xmp (as opposed to image.xmp) -

    - If checked, new sidecar files will use image.ext.xmp naming scheme -
    -
  • -
-
-
-

11.7.3. Steps 2 and 3: Write to Geeqie private files

-

If Step 2 or 3 above was successful, the following option takes effect:

-
  • - - Use GQview legacy metadata format (supports only keywords and comments) instead of XMP -

    - If checked, Geeqie will write metadata in GQview legacy files (file extension .meta) format -
    -
-
-
-

11.7.4. Miscellaneous

-
    -
  • -

    - Write the same description tags (keywords, comment, title) to all grouped sidecars -

    - If checked the same descriptive tags are written to all files in a group. File grouping is as defined in the - Files tab - of main Preferences. Technical tags (exif) are handled separately for each file. -

    -
  • -
  • -

    - Allow keywords to differ only in case -

    - If checked, permits keywords to be case-sensitive (e.g. - Place - and - place - are two different keywords) -

    -
  • -
  • -

    - Write altered image orientation to the metadata -

    - If checked, the results of orientation commands (Rotate, Mirror and Flip) issued on an image will be written to metadata either automatically as specified below or when manually initiated. This option also affects the - Auto rotate image using EXIF information - menu item. -

    -
    -

    If this option is not checked, the results of orientation commands will be lost when Geeqie closes.

    -

    Do not change this option while you have temporary rotations applied to images.

    -
    -
  • -
-

-
-
-

11.7.5. Auto-save options

-
    -
  • - - Write metadata after timeout -

    - If checked, metadata writes will be made automatically at the defined interval. Warning dialogues will be issued if required. -
    -
  • -
  • - - Write metadata on image change -

    - If checked, metadata writes will be made when you move focus to another image. -
    -
  • -
  • - - Write metadata on directory change -

    - If checked, metadata writes will be made when you move focus to another folder. -
    -
  • -
-

-
-
-

11.7.6. Pre-load metadata

-
  • - - Read metadata in background -

    - Using the folder sorting options: -

    - Exif date original -

    - Exif date digitized -

    - Rating -

    - requires metadata to be read from all files in a folder before the sort action can be made. If a folder contains a large number of file, this can take a noticeable period of time. -

    - If this option is checked, Geeqie will automatically read the required metatada in the background as soon as a folder is opened. This will reduce the amount of time you have to wait until the sort is completed. -

    - If you do not use these sort options, leave this option unchecked. -
    -
-

-
-
- - - diff --git a/web/help/GuideOptionsOSD.html b/web/help/GuideOptionsOSD.html deleted file mode 100644 index e747b314..00000000 --- a/web/help/GuideOptionsOSD.html +++ /dev/null @@ -1,688 +0,0 @@ - - - - -OverlayScreen Display - - - - - - - - -
-

OverlayScreen Display

- -

This section describes the options presented under the OSD Tab of the preferences dialog.

-
-
-

11.3.1. Overlay Screen Display

-

The contents of the Overlay Screen Display is defined by the Image Overlay Template. This template is easily customised to display a wide range of data.

-

- The format of each entry is: -

%tag[:max_length][:extra]%
-

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Tag - - Replaced by -
nameFilename of the picture
collectionName of the collection
numberCurrent number of image in the list
totalTotal number of images
dateFile date
sizeFile size
widthImage width
heightImage height
resImage resolution
keywordsImage keywords from metadata
commentImage comment from XMP metadata
imagecommentJPEG image comment
ratingImage rating
<meta_tag>The Exif, XMP, or IPTC tag from metadata
lua/<lua_script>/The output of a Lua script file
lua//<lua_command>The output of a Lua command
-

- As an aide, in addition to standard metadata tags, Geeqie provides a number of - pre-formatted tags - . -

-

Examples of usage are:

-

-

        %keywords%
-        %Exif.Photo.DateTimeOriginal%
-        %lua/jpeg_comment.lua/:12%
-        %lua//return(os.date())%
-      
-

-

- Refer to - Lua Extensions - for further information. -

-

- The length of displayed data can be limited by using the - :max_length - parameter. The following example will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation. -

%formatted.Camera:20%
-

-

- If two or more variables are connected with the - | - character, the variables are displayed with a separator. For example:: -

%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%
- could show: -
"1/20s - 400 - 80 mm"
- Or, if there is no ISO information in the Exif data: -
"1/200 - 80 mm"
-

-

If there is no data for a requested tag, the line is not displayed.

-

- The - :extra - parameter may be used to format the output by prepending and appending a text string to the displayed item. -

-

- The special character - * - is used to mark the position of the Tag data item. If no - * - is present, the extra string is just appended to the standard data displayed. Any "\n" is replaced by a newline on display. - Pango mark up - is accepted in both left and right parts. If the data item is empty, nothing will be displayed. -

-

Examples:

-
- - - - - - - - - - - - - - - - - - - - -
- Template - - Example display -
- %name: - <i>*</i>\n% - - filename001.jpg -
%size:\n%123456
%formatted.ISOSpeedRating:ISO *%ISO 100
- %collection:Collection: - <b>*</b> - \n% - - Collection: - my_new_collection -
-

-
-
- - - - - - Font - , - - - - - - Text - , - - - - - - Background -
-
The font used for the Overlay Screen Display, as well as the font colour and background colour, may be set via these buttons. Colour transparency can also be set.
-
-
-
- - - - - - Help -
-
-

Show syntax help

-
-
-
-
- Defaults -
-
-

Restore default image overlay template

-
-
-
-
- - - diff --git a/web/help/GuideOptionsStereo.html b/web/help/GuideOptionsStereo.html deleted file mode 100644 index 284756c1..00000000 --- a/web/help/GuideOptionsStereo.html +++ /dev/null @@ -1,468 +0,0 @@ - - - - -Stereo image management - - - - - - - - -
-

Stereo image management

- -

TBD

-
- - - diff --git a/web/help/GuideOptionsSteroa.html b/web/help/GuideOptionsSteroa.html deleted file mode 100644 index 7cd95755..00000000 --- a/web/help/GuideOptionsSteroa.html +++ /dev/null @@ -1,465 +0,0 @@ - - - - -Stereo image management - - - - - - - - -
-

Stereo image management

- -

TBD

-
- - - diff --git a/web/help/GuideOptionsToolbar.html b/web/help/GuideOptionsToolbar.html deleted file mode 100644 index 39324a63..00000000 --- a/web/help/GuideOptionsToolbar.html +++ /dev/null @@ -1,481 +0,0 @@ - - - - -Toolbar - - - - - - - - -
-

Toolbar

- -

- This dialogue enables you to change the items displayed on the Toolbar. -

- The initial display shows the current setup. You may re-order these items by right-clicking on any item. -

- Additional items may be included by clicking on the "Plus" symbol at the bottom of the tab. A list of all available options is displayed. -

-

Most of the Geeqie menu items are available, plus any desktop (Plugins) files.

-
-

- If you select a desktop file, ensure that it includes an icon - the desktop file format is described in the - Standards section -

-
-
- - - diff --git a/web/help/GuideOptionsWindow.html b/web/help/GuideOptionsWindow.html deleted file mode 100644 index 36b5ab63..00000000 --- a/web/help/GuideOptionsWindow.html +++ /dev/null @@ -1,588 +0,0 @@ - - - - -Window Options - - - - - - - - -
-

Window Options

- -

This section describes the options presented under the Windows Tab of the preferences dialog.

-
-
-

11.4.1. State

-
-
- Remember window positions -
-
-

This will maintain windows size and position between Geeqie sessions.

-
-
-
-
- Use saved window positions also for new windows -
-
-

- A new window opened by menu - File ▸ New Window ( - Ctrl+N - ) - will use the saved window positions also. -

-
-
-
-
- Remember tool state -
-
-

- Maintains the selection set by - View ▸ File and Folders ▸ Float File List ( - L - ) -

-
-
-
-
- Remember dialog window positions -
-
-

This will maintain dialog windows size and position between Geeqie sessions.

-
-
-
-
- Show window IDs -
-
-

- Show the window ID in the titlebar of each window. When multiple Geeqie windows are opened, this option shows a unique identifier for each window. It may be used in conjunction with the command line option: - -

- -

-
-
-
-
-

11.4.2. Size

-
-
- Fit window to image when tools are hidden/floating -
-
-

The main window will be resized to accommodate each image's size and proportions when the image pane is the only one visible within the window.

-
-
-
-
- Limit size when auto-sizing window -
-
-

This will restrict the maximum size a window can grow to automatically fit an image. The value represents the percentage of the desktop size in width and height.

-
-
-
-
-

11.4.3. Full Screen

-
-
- Location -
-
-

Selects the location and position of the full screen window. 'Determined by window manager' will leave the window placement up to the window manager. 'Active screen' places the window on the same screen as the Geeqie main window. 'Active monitor' does the same, but limits the full screen window size to the monitor containing the main window. The remaining choices are dependent on the multiple monitor configuration.

-
-
-
-
- Smooth image flip -
-
-

This option delays the image change in full screen until the next image is entirely decoded into memory, the result is a smoother transition between images.

-
-
-
-
- Disable screen saver -
-
-

- This option will execute - xscreensaver-command --deactivate - once per minute to avoid the screen saver from activating when Geeqie is displayed full screen. -

-
-
-
-
- - - diff --git a/web/help/GuideOtherWindows.html b/web/help/GuideOtherWindows.html deleted file mode 100644 index a2286b7d..00000000 --- a/web/help/GuideOtherWindows.html +++ /dev/null @@ -1,477 +0,0 @@ - - - - -Stand-alone Windows - - - - - - - - -
-

Stand-alone Windows

- -

- This section describes the windows that may be displayed simultaneously with the Geeqie main window. They are initiated via the - View - and - File - menus. -

-

-
-
- - - diff --git a/web/help/GuideOtherWindowsExif.html b/web/help/GuideOtherWindowsExif.html deleted file mode 100644 index b2df77bb..00000000 --- a/web/help/GuideOtherWindowsExif.html +++ /dev/null @@ -1,472 +0,0 @@ - - - - -Exif Window - - - - - - - - -
-

Exif Window

- -

The Exif window shows the Exif, IPTC and XMP metadata that are present in the image file.

-

Unlike the other parts of the program, this window shows the "raw" metadata read from the file, without any post-processing. Thus, this window is ideal for metadata debugging.

-

- The Exif pane in the - Info Sidebar - is more suitable for general use, as it displays merged data from sidecar and private metadata files. -

-

- To facilitate including extra items in the Exif pane in the - Info Sidebar - , it is possible to drag-and-drop an item from the Exif window onto the Sidebar pane. -

-

-
- - - diff --git a/web/help/GuideOtherWindowsImageWindow.html b/web/help/GuideOtherWindowsImageWindow.html deleted file mode 100644 index dfe77f79..00000000 --- a/web/help/GuideOtherWindowsImageWindow.html +++ /dev/null @@ -1,534 +0,0 @@ - - - - -Image Window - - - - - - - - -
-

Image Window

- -

An image window is a window that displays only the image, without menus or sidebars.

-

An image window can always be opened from the context menu of all images and files. Keyboard shortcuts exist for most windows that display images or files, however the shortcut can vary dependent on the type of window containing them.

-

- The image pane contained in an image window behaves and operates similar to the - Image Pane - of a Main Window, including the - Image Overlay - . The keyboard shortcuts are the same, and the context menu is the same except - Hide file list - is replaced by - Close window - . The - slide show - and - full screen - functions are also available. -

-

-
-
-

4.1.1. Navigation

-

- When the image window is initiated from an image selection or from a collection window, the displayed image can be changed forward or backward in the list with the respective - PageDown - and - PageUp - keys. In addition, all navigation methods for the mouse and keyboard are similar to that of the - Image Pane - of a Main Window. -

-

-
-
-

4.1.2. Drag and Drop

-

- Images can be dragged and dropped onto an image window, but the process is somewhat different to that of an - Image Pane - . If multiple images, a folder or an image from a collection window is dropped onto the image window, you can cycle through all these images using the navigation keys. -

-

The dropped item can be one or more files, folders, or an image from a collection window:

-
-
- One or more files -
-
-

The image window will display the first image; the list of dropped images can be navigated similar to a main window's image pane.

-
-
- One or more folders -
-
-

When the dropped list of items includes a folder, a menu will appear allowing to skip the folders, add their contents, or add their contents recursively. After choosing from the menu the requested files will be added to the image window.

-
-
- Image from a collection -
-
-

The image window will change to display the image and become linked to the collection containing the image. Images in the collection can then be navigated and viewed from the image window.

-
-
-

Changing the image window by dropping a new item onto it will cause the previous list of images or linked collection to be discarded.

-

- To update the image display in the event that the source file has changed, press - R - . -

-

-
-
- - - diff --git a/web/help/GuideOtherWindowsPanView.html b/web/help/GuideOtherWindowsPanView.html deleted file mode 100644 index 4464ad44..00000000 --- a/web/help/GuideOtherWindowsPanView.html +++ /dev/null @@ -1,645 +0,0 @@ - - - - -Pan View - - - - - - - - -
-

Pan View

- -

- This window offers alternative views of the - current directory and its children - . -

- It may be opened by - View ▸ Pan view ( - Ctrl+J - ) - . - - You can pan the view as you pan an image in normal view mode, using left mouse button and drag. -

-

A primary mouse button click on any image will display information about the image. Secondary mouse button will show a context menu.

-

- The - Keyboard and Mouse Shortcuts - available are listed in the Reference section. -

-
-

Pan view recursively visits each folder under the specified folder. This can consume considerable computer resources.

-
-

-
-
-

4.3.1. Select a folder

-
-
- Location -
-
-

The initial location is the current Geeqie folder when the Pan view window is opened.

-
-
-

-
-
-

4.3.2. Choose a view mode

-

A select box let you choose among different view modes:

-
-
- Timeline -
-
-

Shows images grouped by date.

-
-
- Calendar -
-
-

Shows a calendar with the number of images indicated for each day (as dots and number). Left mouse button click will show images in a pop-up.

-
-
- Folders -
-
-

Show images grouped by folder. Each box represents a folder. Parent and children folders are shown as boxes enclosing other boxes.

-
-
- Folders (flower) -
-
-

Show images grouped by folder. Each box represents a folder. Parent folders are linked to children by a line. The top folder is the center of the flower.

-
-
- Grid -
-
-

All images are shown on a grid.

-
-
-

-
-
-

4.3.3. How each image should be represented

-

Another select box let you choose the representation of each image:

-
-
- Dots -
-
-

Each image is represented by a dot.

-
-
- No images -
-
-

Each image is represented by a square box.

-
-
- Small thumbnails -
-
-

Each image is represented by a small thumbnail.

-
-
- Normal thumbnails -
-
-

Each image is represented by a normal thumbnail.

-
-
- Large thumbnails -
-
-

Each image is represented by a large thumbnail.

-
-
- 1:10 (10%) -
-
-

Each image is represented by reduced image (1/10 of the original's dimensions).

-
-
- 1:4 (25%) -
-
-

Each image is represented by reduced image (1/4 of the original's dimensions).

-
-
- 1:3 (33%) -
-
-

Each image is represented by reduced image (1/3 of the original's dimensions).

-
-
- 1:2 (50%) -
-
-

Each image is represented by reduced image (1/2 of the original's dimensions).

-
-
- 1:1 (100%) -
-
-

The original image is shown at its normal dimensions.

-
-
-

-
-
-

4.3.4. Find

-

At the bottom of the window:

-
-
- Find button -
-
-

- Shows a text field for image search. One can enter either: -

    -
  • filename or part filename
  • -
  • - file date in any of the following forms, where the separator may one of - / - - - , - . - or a space: -
      -
    • yyyy-mm-dd
    • -
    • yyyy-mm
    • -
    • yyyy
    • -
    -
  • -
-

- Enter - will start the search, pressing it again will move to the next match. The matched file is made visible and details are shown for it. -

-
-
-
-
- - - diff --git a/web/help/GuidePluginsConfig.html b/web/help/GuidePluginsConfig.html deleted file mode 100644 index f612b728..00000000 --- a/web/help/GuidePluginsConfig.html +++ /dev/null @@ -1,722 +0,0 @@ - - - - -Plugins Configuration - - - - - - - - -
-

Plugins Configuration

- -

-
-
-

12.2.1. Plugins Configuration Dialog

-

- This dialog allows user to add new plugins or modify the system ones. It is available in the menu - Edit ▸ Configure Plugins - . -

-

- The Plugins dialog shows list of all relevant plugins i.e. all installed desktop files that are designated either: -

    -
  • - Categories=Graphics -
  • -
  • - Categories=X-Geeqie -
  • -
-

- The list has the following columns: -

-
-
- Disabled -
-
-

If the checkbox is ticked, the plugin will not be displayed in Geeqie menus.

-
-
- Name -
-
-

Plugin name as specified in desktop file, and is the name displayed in menus.

-
-
- Hidden -
-
- A plugin can be - Hidden - for one of these reasons: -
    -
  • - the desktop file contains - Hidden=TRUE - or - NoDisplay=TRUE -
  • -
  • - TryExec - binary was not found -
  • -
  • - MimeType - list does not contain images -
  • -
  • - MimeType - list is empty and - Categories - does not contain - X-Geeqie -
  • -
-
-
-
-
- Desktop file -
-
- Name of the desktop file, used as an identifier in - Keyboard Options - . -
-
- Path -
-
Full path to the desktop file. Desktop files in user directories override the system ones with the same name.
-
-
-
-

12.2.2. Adding new plugin

-

- - - - - - New - - - opens a text editor with a desktop file template. You must amend the line -

Exec=command %f
- to contain the command you wish to execute. If it is more than a single command, you must create a script file and call that. If the location of the script file is not in your $PATH environment variable, you must include the full pathname. -

-

-
-
-

12.2.3. Modifying an existing plugin

-

- - - - - - Edit - - - opens a text editor with existing desktop file. For desktop files that are not writable by user, it allows saving to a Geeqie specific directory, where it overrides the system file (but only for Geeqie). -

-
-
-

12.2.4. Deleting a plugin

-

- - - - - - Delete - - - can delete user writable desktop files. System desktop files can't be deleted directly, but it is possible to edit them and set - Hidden=TRUE - , see above. -

-
-
-

12.2.5. Special plugins

-

A desktop file with one of the following names has a special function. It will replace the corresponding internal command.

-

-

        geeqie-copy-command.desktop
-        geeqie-move-command.desktop
-        geeqie-rename-command.desktop
-        geeqie-delete-command.desktop
-        geeqie-folder-command.desktop
-      
-

-

This can be used for example for a custom trash command or for manipulation of files under version control.

-
-
-

12.2.6. Geeqie desktop file keys

-

- A desktop file for use only by Geeqie should have the following entries: -

        Categories=X-Geeqie;
-        OnlyShowIn=X-Geeqie;
-      
-

-

- A menu path where the plugin will appear, instead of in the default - Plugins - , can be set by including: -

X-Geeqie-Menu-Path=<FileMenuPath>
-

-

- Possible vales for - FileMenuPath - are: -

        FileMenu
-        FileMenu/OpenSection
-        FileMenu/SearchSection
-        FileMenu/PrintSection
-        FileMenu/FileOpsSection
-        FileMenu/QuitSection
-        GoMenu
-        SelectMenu
-        SelectMenu/SelectSection
-        SelectMenu/ClipboardSection
-        SelectMenu/MarksSection
-        EditMenu/EditMenu
-        EditMenu/EditSection
-        EditMenu/OrientationMenu
-        EditMenu/RatingMenu
-        EditMenu/PropertiesSection
-        EditMenu/PreferencesSection
-        PluginsMenu
-        ViewMenu
-        ViewMenu/WindowSection
-        ViewMenu/FileDirMenu
-        ViewMenu/FileDirMenu/FolderSection
-        ViewMenu/FileDirMenu/ListSection
-        ViewMenu/DirSection
-        ViewMenu/ZoomMenu
-        ViewMenu/ZoomMenu/ConnectZoomMenu
-        ViewMenu/SplitMenu
-        ViewMenu/StereoMenu
-        ViewMenu/ColorMenu
-        ViewMenu/OverlayMenu
-        ViewMenu/ViewSection
-        ViewMenu/ToolsSection
-        ViewMenu/SlideShowSection
-        HelpMenu
-        HelpMenu/HelpSection
-      
-

-

- If you want a plugin to use a user-definable path, the following entry must be made in the desktop file: -

X-Geeqie-Filter=true
-

-

- Desktop files containing this entry will be displayed in the Folder action list of the - Sort Manager Sidebar - . The path of the bookmark clicked will be used by the desktop file. -

- If the desktop file is called from the menu, when the plugin is executed you are presented with a dialogue which enables a path to be selected. The path selected, appended by the filename currently being processed, is made available to the shell script either as an environment variable or via a call to geeqie --remote. The following code demonstrates the use of both methods: -
        for file in "$@"
-        do
-        destination=$(geeqie --remote --get-destination:"$file")
-        
-        echo "$destination"
-        echo $GEEQIE_DESTINATION
-        done
-      
-

-

- If you want to run a plugin in full-screen mode and wish full-screen to be maintained, include the following entry in the desktop file: -

X-Geeqie-Keep-Fullscreen=true
-

-

- Any terminal output from the plugin command can be displayed with the following command: -

X-Geeqie-Verbose=true
-

-

- The plugin can be restricted to run on only certain file types, for example: -

X-Geeqie-File-Extensions=.jpg; .cr2
- The entries are case insensitive. -

-

-

X-Geeqie-Keep-Verbose-Multi=
- TBD -

-

- The key or key combination to execute this function can be set with: -

X-Geeqie-Hotkey=
- Key combinations are of the form: - -
X-Geeqie-Hotkey=<control>y
-
- This value may conflict with a setting in - Keyboard Options -
-

-
-
- - - diff --git a/web/help/GuidePrinting.html b/web/help/GuidePrinting.html deleted file mode 100644 index b82b1748..00000000 --- a/web/help/GuidePrinting.html +++ /dev/null @@ -1,493 +0,0 @@ - - - - -Printing - - - - - - - - -
-

Printing

- -

- To print an image select - File ▸ Print ( - Shift+P - ) - . -

-

The print dialog includes tabs that group related printing options, a preview pane, and a Print and Cancel button.

-
-
- - - diff --git a/web/help/GuideReference.html b/web/help/GuideReference.html deleted file mode 100644 index 860b5832..00000000 --- a/web/help/GuideReference.html +++ /dev/null @@ -1,510 +0,0 @@ - - - - -Reference - - - - - - - - -
-

Reference

- -

-
-
- - - diff --git a/web/help/GuideReferenceCommandLine.html b/web/help/GuideReferenceCommandLine.html deleted file mode 100644 index 145e444e..00000000 --- a/web/help/GuideReferenceCommandLine.html +++ /dev/null @@ -1,786 +0,0 @@ - - - - -Command Line Options - - - - - - - - -
-

Command Line Options

- -

- Geeqie is called by the command: -

      geeqie [options] [path_to_file_or_collection]
-      1
-    
-

-

These are the command line options available to Geeqie:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Short OptionLong OptionDescription
+t--with-toolsShow file list, menu, and statusbar.
-t--without-toolsHide file list, menu, and statusbar. Window contains image only.
-f--fullscreenStart up in fullscreen.
-s--slideshowStart up in slideshow mode.
-l [filelist] [collectionlist]--list [filelist] [collectionlist]Open collection window containing images specified on the command line. Any collections on the command line will also be appended to this collection.
--blankStart with file list blank.
--geometry=<w>x<h>+<x>+<y>Set the <width> <height> <xoffset> <yoffset> of the window. The parameters are in pixels.
-r--remoteSend command line options to existing Geeqie process.
-rh--remote-helpList command line options available to --remote.
-h--helpDisplay brief command line option list.
-v--versionDisplay version of Geeqie.
--debug[=<level>]Turn on debugging output (when compiled with Debug enabled). <level> is 0 to 4.
-g:<regexp>--grep:<regexp>Filter debug output with regular expression
+w--show-log-windowDisplay log window
-o:<file>--log-file:<file>Save log data to file
--alternateUse alternate similarity algorithm - experimental - requires re-compile.
-

-
-
-

13.1.1. Remote commands

-

The --remote command line option will send all entered commands to an existing Geeqie process, a new process will be started if one does not exist. These are the additional commands that can be used with the remote command:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Short OptionLong OptionDescription
-n--nextChange main window to display next image.
-b--backChange main window to display previous image.
--firstChange main window to display first image.
--lastChange main window to display last image.
-f--fullscreenToggle full screen mode of the main window.
-fs--fullscreen-startStart full screen mode for main window.
-fS--fullscreen-stopStop full screen mode for main window.
-s--slideshowToggle slide show for main window.
-ss--slideshow-startStart slide show for main window.
-sS--slideshow-stopStop slide show for main window.
--slideshow-recurse:<folder>Start recursive slide show for <folder> in main window.
-d<[h:][m:][n][.m]>--delay=<[h:][m:][n][.m]>Set slide show delay to <[hrs:][mins:][n][.m]> seconds, range is 0.1 secs to 24 hours
+t--tools-showShow tools for main window.
-t--tools-hideHide tools for main window.
-q--quitQuit Geeqie.
--config-load:<file>Load configuration from <file>.
--get-sidecars:<file>Get list of sidecars of <file>.
--get-destination:<file>Get destination path of <file>. This is used by the symlink desktop file to implement the symbolic link operation. There is no useful function for the user.
file:<file>Open <file> and bring Geeqie window to the top
File:<file>Open <file> and do not bring Geeqie window to the top
--tellPrint filename of current image
--pixel-infoPrint X, Y and RGB of mouse pointer on current image
view:<file>Open new window containing <file>
--list-clearClear command line collection list
--list-add:<file>Add <file> to command line collection list
raiseBring the geeqie window to the top
--id:<ID> - Window ID for following commands - 2 -
--new-windowOpen new window
--close-windowClose window
-ct:clear|clean--cache-thumbs:clear|cleanclear or clean thumbnail cache
-cs:clear|clean--cache-shared:clear|cleanclear or clean shared thumbnail cache
-cm--cache-metadataclean the metadata cache
-cr:<folder>--cache-render:<folder>render thumbnails
-crr:<folder>--cache-render-recurse:<folder>render thumbnails recursively
-crs:<folder>--cache-render-shared:<folder> - render thumbnails - 3 -
-crsr:<folder>--cache-render-shared-recurse:<folder>render thumbnails recursively
--lua:<file>,<lua script>run lua script on file
-

-
-
-
-1The name of a collection, with or without either path or extension (.gqv) may be used. If a path is not used and there is a name conflict with a file or folder, that will take precedence.
-
-2 -

The ID is shown in the titlebar of the window. If multiple windows are open, it can be used to direct commands to a particular window e.g. --remote --id:main --tell

-
-
-3 -

If standard thumbnail cache is not enabled, this command will be ignored.

-
-
-
- - - diff --git a/web/help/GuideReferenceConfig.html b/web/help/GuideReferenceConfig.html deleted file mode 100644 index 838aa913..00000000 --- a/web/help/GuideReferenceConfig.html +++ /dev/null @@ -1,532 +0,0 @@ - - - - -Configuration Files and Locations - - - - - - - - -
-

Configuration Files and Locations

- -

The following data lists the locations Geeqie uses for various actions. The uppercase symbols are environment variables. If they are not set on your system the fallback locations are listed in parentheses.

-

- Geeqie will first attempt to load a configuration file from: -

/etc/geeqie/geeqierc.xml
-

-

It will then continue with the following locations.

-

- Most of Geeqie's configuration files are contained in the folder, and sub-folders of: -

$XDG_CONFIG_HOME/geeqie/
-
($~/.config/geeqie/)
-

-

- Geeqie's standard configuration file is: -

.../geeqierc.xml
-

-

- An alternative configuration file may be used by executing: -

geeqie -r --config-load:<filename>
-

-

- Geeqie-created desktop files used by - Plugins - are in the folder: -

.../applications
-

-

- Lua script files for - Lua Extensions - are in the folder: -

.../lua
-

-

- Historic data such as last several folders visited, bookmarks, and recently used collections, as well as default print settings are contained in this text file: -

.../history
-

-

- Keyboard shortcut maps are contained in this text file: -

.../accels
-

-

- The location for Collections is in the folder: -

$XDG_DATA_HOME/geeqie/collections
-
($~/.local/share/geeqie/collections)
-

-

- The lirc - Infra-red controller - configuration file must be located at: -

$HOME/.lircrc
-

-

- Thumbnails are stored in a location specified in - Thumbnail Preferences -

-

- Metadata is stored either in the image file or in the location specified in - Safe Delete -

-

- The safe delete folder is specified in the - Metadata - tab of main Preferences -

-
- - - diff --git a/web/help/GuideReferenceDecodeLatLong.html b/web/help/GuideReferenceDecodeLatLong.html deleted file mode 100644 index 83a03937..00000000 --- a/web/help/GuideReferenceDecodeLatLong.html +++ /dev/null @@ -1,490 +0,0 @@ - - - - -Decoding Latitude and Longitude - - - - - - - - -
-

Decoding Latitude and Longitude

- -

This section is relevant to geocode searches and the map display of Geeqie.

-

- The result of some internet or other searches for placenames can contain a latitude and longitude embedded in a text string. For example an openstreetmap.org search can give a URL such as: -

- https://www.openstreetmap.org/search?query=51.5542%2C-0.1816#map=12/51.5542/-0.1818 -

-

- If you paste such a string into the search box, the latitude/longitude can be automatically extracted and used as the origin of the search. -

- You may also drag-and-drop a URL of this type onto the map to cause the map to be re-centered. -

- This feature uses the file: -

- /usr/local/lib/geeqie/geocode-parameters.awk -

- You may create your own decodes by using the above file as an example, and storing the file in: -

- ~/.config/geeqie/applications/geocode-parameters.awk -

- If a successful decode was not made from the first file, your local version will then be used. -

-
- - - diff --git a/web/help/GuideReferenceKeyboardShortcuts.html b/web/help/GuideReferenceKeyboardShortcuts.html deleted file mode 100644 index ccba978a..00000000 --- a/web/help/GuideReferenceKeyboardShortcuts.html +++ /dev/null @@ -1,2033 +0,0 @@ - - - - -Keyboard and Mouse Shortcuts - - - - - - - - -
-

Keyboard and Mouse Shortcuts

- -

- The tables below shows the defaults for keyboard shortcuts. The current settings for all shortcuts may be found in the - Keyboard Options - dialogue. -

-
-
-

13.2.1. Keyboard shortcuts in all windows

-
-
Table 13-3 Standard keyboard shortcuts
- - - - - - - - - - - - - - - - - - - - - - - -
ShortcutMouseAction
- F1 - Help.
- Menu - Right-clickContext menu.
- F10 - Right-clickContext menu.
-
-
-
-

13.2.2. Main window keyboard shortcuts

-
-
Table 13-4  - Main window - keyboard shortcuts -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ShortcutMouseAction
- Image Navigation -
- PageDown - - Left Click - , -

- Mouse Wheel down - 1 -
Change to next image.
- PageUp - - Middle Click - , -

- Mouse Wheel up - -
Change to previous image.
- Home - Change to first image.
- End - Change to last image.
- Space - Change to next image.
- Backspace - Change to previous image.
- Image viewing - (image has keyboard focus. Refer also to - Mouse Wheel Mode - ) -
- Arrow key - - Left click and Drag - - Pan image.
- Shift + Arrows - Pan Image faster.
- Ctrl + Arrow key - Pan to respective edge of image.
- Mouse button 8 - 2 - Forward
- Mouse button 9 - - Back
- Shift + right-click - Smooth scroll
- ] - Rotate image clockwise 90 degrees.
- [ - Rotate image counterclockwise 90 degree.
- Shift + R - Rotate image 180 degrees.
- Shift + M - Flip image horizontally (mirror).
- Shift + F - Flip image vertically.
- + - , - = - - Ctrl + Mouse Wheel up - Zoom image in.
- - - - Ctrl + Mouse Wheel down - Zoom image out.
- Z - Reset zoom to original size (1:1).
- X - Fit image to window size.
- W - Zoom image to fit window width.
- H - Zoom image to fit window height.
- 1 - Set zoom to 1:1
- 2 - Set zoom to 2:1
- 3 - Set zoom to 3:1
- 4 - Set zoom to 4:1
- 7 - Set zoom to 1:4
- 8 - Set zoom to 1:3
- 9 - Set zoom to 1:2
- File Menu -
- - Ctrl + - N - - New Window
- C - Open a new empty collection window.
- O - Display open collection dialog.
- F3 - Open new search window.
- - Shift + - P - - Open print dialog.
- - Ctrl + - F - - Create new folder in current path.
- - Ctrl + - C - - Copy selected images, opens destination selection dialog.
- - Ctrl + - M - - Move selected images, opens destination selection dialog.
- - Ctrl + - R - - Rename selected images, opens rename dialog.
- - Ctrl + - D - - Move selected images to trash bin.
- - Shift + Delete - - Permanently delete selected images.
- - Ctrl + - W - - Close window, Geeqie exits when last window is closed.
- - Ctrl + - Q - - Quit Geeqie.
- Edit Menu -
- - Ctrl + - O - - Open Geeqie preferences window.
- - Ctrl + - S - - Save metadata
- Select Menu -
- 1 - ... - 6 - Toggle mark 1 ... 6
- - Ctrl + - 1 - - ... - - Ctrl + - 6 - - Select mark 1 ... 6
- - Ctrl + - A - - Select all images.
- - Ctrl + SHIFT + - A - - Unselect all images.
- - Ctrl + SHIFT + - I - - Invert selection.
- - Alt + - R - - Toggle rectangular selection mode in icon view.
- M - Show marks.
- View Menu -
- T - Toggle display of thumbnails when in list view.
- - Ctrl + - L - - Display file list as detailed list view.
- - Ctrl + - I - - Display file list as icon view.
- - Ctrl + - T - - Toggle folder display between list and tree views.
- R - Refresh file list.
- L - Toggle floating of file display.
- - Ctrl + - H - - Toggle hiding of file display.
- - Ctrl + - E - - Toggle EXIF sidebar.
- - Shift + - S - - Toggle Sort Manager sidebar.
- - Ctrl + - K - - Toggle Keywords sidebar.
- V - Toggle full screen.
- I - Toggle information overlay.
- S - Toggle slideshow.
- P - Pause slideshow.
- - Ctrl + - Keypad + - - Slideshow faster.
- - Ctrl + - Keypad - - - Slideshow slower.
- E - Split panes horizontal.
- U - Split panes vertical.
- Y - Single pane.
- Alt + Right Arrow - Next split pane.
- Alt + Left Arrow - Previous split pane.
- Alt + Up Arrow - Up or previous split pane.
- Alt + Down Arrow - Down or next split pane.
-
-
-
-

13.2.3. Collections keyboard shortcuts

-
-
Table 13-5  - Collections window - keyboard shortcuts -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ShortcutMouseAction
- Arrows - Move selection.
- Shift + Arrow key - Select multiple images.
- - Alt + - R - - Toggle rectangular selection mode.
- Space - Select only image with focus.
- Ctrl + Space - Toggle selection of image with focus.
- Home - Move focus to first image.
- End - Move focus to last image.
- - Ctrl + - A - - Select all images.
- - Ctrl + Shift + - A - - Unselect all images.
- Delete - Remove selected image from collection, does not delete image from disk.
- - Ctrl + - L - - Add images from main window's file list.
- - Ctrl + - T - - Toggle display of icon filenames.
- N - Sort collection by name.
- D - Sort collection by file date.
- B - Sort collection by file size.
- P - Sort collection by file path.
- I - Sort collection by natural numerical order.
- Enter - View image with focus in main window.
- V - View image with focus in new window.
- - Shift + - P - - Open print dialog.
- S - Save collection.
- - Ctrl + - S - - Save collection as, opens destination dialog.
- A - Append to collection, opens append dialog.
- - Ctrl + - C - - Copy selected images, opens destination selection dialog.
- - Ctrl + - M - - Move selected images, opens destination selection dialog.
- - Ctrl + - R - - Rename selected images, opens rename dialog.
- - Ctrl + - D - - Delete selected images.
- - Ctrl + - W - - Close collection window.
-
-
-
-

13.2.4. Duplicates keyboard shortcuts

-
-
Table 13-6  - Duplicates window - keyboard shortcuts -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ShortcutMouseAction
- 1 - Select group 1 duplicates.
- 2 - Select group 2 duplicates.
- C - Open new collection window and add selected images.
- - Ctrl + - L - - Add images from main window's list.
- V - View selected item in new window.
- - Ctrl + - T - - Toggle thumbnails.
- - Ctrl + - A - - Select all.
- - Ctrl + shift + - A - - Deselect all.
- - Ctrl + - C - - Copy selected images, opens destination selection dialog.
- - Ctrl + - M - - Move selected images, opens destination selection dialog.
- - Ctrl + - R - - Rename selected images, opens rename dialog.
- - Ctrl + - D - - Delete selected images.
- Ctrl + Delete - Remove all items from list.
- - Ctrl + - W - - Close window.
- Ctrl + shift + right-click - Show debug info.
-
-
-
-

13.2.5. Search keyboard shortcuts

-
-
Table 13-7  - Search window - keyboard shortcuts -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ShortcutMouseAction
- - Ctrl + - C - - Copy selected images, opens destination selection dialog.
- - Ctrl + - M - - Move selected images, opens destination selection dialog.
- - Ctrl + - R - - Rename selected images, opens rename dialog.
- - Ctrl + - D - - Delete selected images.
- - Ctrl + - A - - Select all.
- - Ctrl + shift + - A - - Deselect all.
- Delete - Remove selected items from list.
- Ctrl + Delete - Remove all items from list.
- V - View selected item in new window.
- C - Open new collection window and add selected images.
- - Ctrl + - T - - Toggle thumbnails.
- - Ctrl + - W - - Close window.
-
-
-
-

13.2.6. Pan view keyboard shortcuts

-
-
Table 13-8  - Pan View window - keyboard shortcuts -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ShortcutMouseAction
- Arrow key - - Left click and Drag - - Scroll display.
- Page Up - Scroll display half screen up.
- Page Down - Scroll display half screen down.
- Home - Scroll display half screen left.
- End - Scroll display half screen right.
- - Ctrl + - F - - Display Find search bar.
- / - Display Find search bar.
- - Ctrl + - G - - Start search.
- F11, F, V - Toggle Fullscreen.
- Esc - Exit fullscreen or clear search bar.
- + - , - = - - Ctrl + Mouse Wheel up - Zoom image in.
- - - - Ctrl + Mouse Wheel down - Zoom image out.
- Z - Reset zoom to original size (1:1).
- 1 - Set zoom to 1:1
- 2 - Set zoom to 2:1
- 3 - Set zoom to 3:1
- 4 - Set zoom to 4:1
- 7 - Set zoom to 1:4
- 8 - Set zoom to 1:3
- 9 - Set zoom to 1:2
- - Ctrl + - C - - Copy selected image, opens destination selection dialog.
- - Ctrl + - M - - Move selected image, opens destination selection dialog.
- - Ctrl + - R - - Rename selected image, opens rename dialog.
- - Ctrl + - D - - Delete selected image.
- - Ctrl + - W - - Close window.
-
-
-
-
-1 -

- Default Mouse wheel functions can be altered by changing the - Mouse wheel scrolls image - option. -

-
-
-2 -

Requires a multi-button mouse.

-
-
-
- - - diff --git a/web/help/GuideReferenceLIRC.html b/web/help/GuideReferenceLIRC.html deleted file mode 100644 index c8dacb82..00000000 --- a/web/help/GuideReferenceLIRC.html +++ /dev/null @@ -1,575 +0,0 @@ - - - - -Infra-red controller - - - - - - - - -
-

Infra-red controller

- -

Recent Linux kernels have in-built support for ir devices, making lirc support redundant.

-

If you wish to use lirc with Geeqie, the lirc libraries must be installed. If you are compiling from sources, lirc functionality will be available if the library dependencies are met.

-

If you are using a pre-compiled distribution, availability depends on the package maintainer.

-

- The website - Linux Infrared Remote Control - has detailed information on this subject. -

-

- You will need to create a configuration file for the controller you will use. This file must be installed at the location specified in - Configuration Files and Locations - . -

-

- Here is an excerpt from an .lircrc file: -

      begin geeqie
-      begin
-      prog = geeqie
-      button = vol_up
-      config = ZOOM_IN 1
-      repeat = 3
-      end
-    
-

-

The commands Geeqie will respond to are:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
CommandMapped to
DOWN [int]Pan down by the specified amount. Default=1
EXITExit Geeqie
FIRSTJump to first image
INFOShow image overlay (full screen only)
LASTJump to last image
LEFT [int]Pan left by the specified amount. Default=1
NEXTGo to next image
PAUSEPause/unpause slideshow
PREVGo to previous image
RIGHT [int]Pan right by the specified amount. Default=1
ROTATE_90 ]Rotate image 90 degrees clockwise. .
ROTATE_90_CCRotate image 90 degrees counter-clockwise..
SET_INV_ZOOM [int]Set Zoom level to 1:N. Default=1x
SET_ZOOM [int]Set Zoom level to N:1. Default=1x
UP [int]Pan up by the specified amount. Default=1
ZOOM_IN [int]Zoom in. Value specifies the amount of zoom.
ZOOM_MAX ]Zoom to fit image to window
ZOOM_OUT [int]Zoom out. Value specifies the amount of zoom.
-

-
- - - diff --git a/web/help/GuideReferenceLua.html b/web/help/GuideReferenceLua.html deleted file mode 100644 index 8831364e..00000000 --- a/web/help/GuideReferenceLua.html +++ /dev/null @@ -1,590 +0,0 @@ - - - - -Lua Extensions - - - - - - - - -
-

Lua Extensions

- -

- Lua scripts allow the functionality of Geeqie to be extended. Lua scripts may only be used in conjunction with the - Overlay Screen Display - and the -

geeqie --remote --lua:
- command line option. -

-

-

Some knowledge of the Lua programming language is required.

-
-
-

13.5.1. Requirements

-

Use of Lua within Geeqie requires Lua to be installed. If you are compiling from sources, Lua functionality will be available if the development files dependencies are met.

-

If you are using a pre-compiled distribution, availability depends on the package maintainer.

-
-
-

13.5.2. How to use Lua

-

- Lua scripts must be stored in a single folder as defined in - Configuration Files and Locations - . -

-

- A link to a Lua script must be inserted into the overlay template. Refer to the - Overlay Screen Display - section of Window Options. -

-

The full extent of the Lua language is available.

-
-
-

13.5.3. Geeqie Lua built-in functions

-

The following functions are built in to Geeqie:

-

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Function - - Returns -
Image:get_path()The full path of the file, including filename and extension
Image:get_name()The full filename including extension
Image:get_extensionThe file extension including preceding dot
Image:get_date()The file date in Unix timestamp format.
Image:get_size()The file size in bytes
Image:get_marks()An integer representing the marks set for the file
Image:get_exif()A data structure containing the entire exif data
<exif_str>:get_datum("<exif_tag>")A single exif tag extracted from a structure output by the above command
-

-

The keyword "Image" refers to the file currently being displayed by Geeqie.

-
-
-

13.5.4. Examples

-

- The following example, which outputs the jpeg comment of a file, demonstrates the use of a built-in function and how to call a system command from a Lua script: -

        path=Image:get_path()
-        commentfile=io.popen("exiv2 -p c \"" .. path .. "\"" )
-        comment = commentfile:read("*a")
-        commentfile:close()
-        return (comment)
-      
-

-

Note that it is necessary to have escape characters surrounding path and filenames.

-

- The following example demonstrates how to extract exif data from a file: -

        --Retrieve the DateTimeDigitized exif tag
-        exif_structure = Image:get_exif();
-        DateTimeDigitized = exif_structure:get_datum("Exif.Photo.DateTimeDigitized");
-        return (os.date(DateTimeDigitized))
-      
-

-
-
-

13.5.5. Warning

-
-

Lua is a powerful programming language. Errors in script files, besides having undesirable side-effects, may cause Geeqie to crash.

-
-
-
- - - diff --git a/web/help/GuideReferenceManagement.html b/web/help/GuideReferenceManagement.html deleted file mode 100644 index 77d3d8a4..00000000 --- a/web/help/GuideReferenceManagement.html +++ /dev/null @@ -1,569 +0,0 @@ - - - - -Cache and Data Maintenance - - - - - - - - -
-

Cache and Data Maintenance

- -

- Thumbnails and other cached data can be maintained from the dialog accessible by selecting - Edit ▸ Thumbnail Maintenance - . -

-

-
-
-

7.4.1. Geeqie thumbnail cache

-

- The utilities listed here operate on the Geeqie caching mechanism. This also includes the data cached for the - search - and - find duplicates - utilities. -

-
-
- Clean up -
-
-

Removes thumbnails and data for which the source image is no longer present, or has been modified since the thumbnail was generated.

-
-
- Clear cache -
-
-

Removes all thumbnails and data stored in the designated folder.

-
-
-
-
-

7.4.2. Shared thumbnail cache

-

The utilities listed here operate on the shared thumbnail mechanism.

-
-
- Clean up -
-
-

Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.

-
-
- Clear cache -
-
-

Removes all thumbnails stored in the designated folder.

-
-
-
-
-

7.4.3. Create thumbnails

-

- This utility will render thumbnails using the current thumbnail caching mechanism, as determined in - Preferences - . -

-
-
- Render -
-
-

Pre-render thumbnails for a specific folder, the utility has the following options:

-
-
- Include subfolders -
-
-

Enable to include all images contained in the subfolders of folder.

-
-
- Store thumbnails local to source images -
-
-

The generated thumbnails will be stored local to the source images, if you have the permissions to write to the folder containing the images.

-
-
-
-
-

7.4.4. Metadata

-

- This utility operates on the data store for - Metadata - located in the folder: -

$HOME/.local/share/Geeqie/metadata
- . -

-
-
- Clean up -
-
-

Removes keywords and comments for which the source image is no longer present.

-

-

-
-
-
-
- - - diff --git a/web/help/GuideReferenceMetadata.html b/web/help/GuideReferenceMetadata.html deleted file mode 100644 index c2ea3c3d..00000000 --- a/web/help/GuideReferenceMetadata.html +++ /dev/null @@ -1,596 +0,0 @@ - - - - -Metadata Processing - - - - - - - - -
-

Metadata Processing

- -

This section describes the metadata reading and writing process.

-

-
-
-

13.4.1. Metadata handling

-

-
-
-

13.4.1.1. Read algorithm

-
    -
  1. - Read Exif, IPTC and XMP from the file. -
  2. -
  3. - - Display this "raw" data in the - Exif Window - . - -
  4. -
  5. - Read XMP sidecar or Geeqie private metadata file. This data will override the XMP data read from the file. -
  6. -
  7. - - Synchronise XMP data with Exif and IPTC data. This process corresponds to the section "Reconciling metadata properties" as described in the - XMP Specification - . -
      -
    • - detect which of Exif and Xmp.exif is newer and copy the data in the appropriate direction -
    • -
    • - detect which of IPTC and XMP is newer and copy the data in the appropriate direction -
    • -
    -
    -
  8. -
  9. - - Use this "processed" data within Geeqie, with the exception of in the - Exif Window - -
  10. -
-

-
-
-

13.4.1.2. Metadata modification

-
    -
  • - - Metadata is written to a single file or group of files as specified in the - Metadata - tab of main Preferences. - -
  • -
  • - Modifying the keywords, comment, orientation, etc. does not ask for confirmation, but immediately modifies the metadata in memory and adds the file to "write queue" -
  • -
  • - - Writing of the queued changes is triggered either - manually - or as defined in - Metadata. It is possible to review the changes and exclude selected files. - -
  • -
-

-
-
-

13.4.1.3. Write algorithm

-
    -
  1. - - Exif and IPTC are updated from XMP (for example - Exif.Image.Orientation - is updated from - Xmp.exif.orientation - ). See - XMP - and - IPTC4XMP - specifications for the list of corresponding tags. - -
  2. -
  3. - - Try to write metadata in the order specified in the - Metadata writing process - section of Preferences. - -
  4. -
  5. - After the first successful write attempt delete old metadata files in all possible locations. -
  6. -
-

-
-
-
-

13.4.2. Options that influence the process

-

- File types with allowed sidecars are listed in the - Files Options - tab of the main Preferences. -

-

-
-
- - - diff --git a/web/help/GuideReferencePCRE.html b/web/help/GuideReferencePCRE.html deleted file mode 100644 index 3158464c..00000000 --- a/web/help/GuideReferencePCRE.html +++ /dev/null @@ -1,479 +0,0 @@ - - - - -Perl Compatible Regular Expressions - - - - - - - - -
-

Perl Compatible Regular Expressions

- -

- The Filename and Comment sections on the search window use - Perl Compatible Regular Expressions - . In general use there are a number of differences to the wildcard expansion used on the command line: -

    -
  • Use "." and not "?" for a single character.
  • -
  • Use "abc.*ghk" and not "abc*ghk" for multiple characters
  • -
  • Use "\." to represent the dot in a file extension
  • -
-

-
- - - diff --git a/web/help/GuideReferencePixbufLoaders.html b/web/help/GuideReferencePixbufLoaders.html deleted file mode 100644 index a5b54a08..00000000 --- a/web/help/GuideReferencePixbufLoaders.html +++ /dev/null @@ -1,533 +0,0 @@ - - - - -Additional pixbuf loaders - - - - - - - - -
-

Additional pixbuf loaders

- -

Geeqie can display files for which there are existing pixbuf loaders. In addition to the standard ones included with most distributions, the following loaders may also be available to you.

-

However, in some cases you are required to compile and install them yourself.

-
-
-

13.10.1. svg

-

librsvg2-common

-
-
-

13.10.2. wmf

-

libwmf0.2-7-gtk

-
-
-

13.10.3. webp

-

-

https://github.com/aruiz/webp-pixbuf-loader
-

-

- Example installation script: -

        sudo apt-get install libglib2.0-dev libgdk-pixbuf2.0-dev libwebp-dev
-        wget https://github.com/aruiz/webp-pixbuf-loader/archive/master.zip
-        unzip master.zip
-        cd webp-pixbuf-loader-master
-        ./waf configure
-        ./waf build
-        sudo ./waf install
-      
-

-

-
-
-

13.10.4. xcf

-

-

https://gitorious.org/xcf-pixbuf-loader/mainline?p=xcf-pixbuf-loader:mainline.git;a=summary
-

-
-
-

13.10.5. psd

-

-

https://cgit.sukimashita.com/gdk-pixbuf-psd.git/
-

-
-
-

13.10.6. JP2/JPC/JPX/J2K/JPF

-

If your distribution has the libpixbufloader-jasper.so loader, these file formats will also be displayed.

-
-
- - - diff --git a/web/help/GuideReferenceStandards.html b/web/help/GuideReferenceStandards.html deleted file mode 100644 index 0dc8d4d9..00000000 --- a/web/help/GuideReferenceStandards.html +++ /dev/null @@ -1,493 +0,0 @@ - - - - -Standards - - - - - - - - - - - - diff --git a/web/help/GuideReferenceSupportedFormats.html b/web/help/GuideReferenceSupportedFormats.html deleted file mode 100644 index b13f85e8..00000000 --- a/web/help/GuideReferenceSupportedFormats.html +++ /dev/null @@ -1,479 +0,0 @@ - - - - -Supported File Formats - - - - - - - - -
-

Supported File Formats

- -

3FR, ANI, APM, ARW, BMP, CR2, CRW, CUR, DDS, DNG, ERF, GIF, ICNS, ICO, JPE/JPEG/JPG, JPS, KDC, MEF, MPO, MOS, MRW, NEF, ORF, PEF, PTX, PBM/PGM/PNM/PPM, PNG, QIF/QTIF (QuickTime Image Format), RAF, RAW, RW2, SR2, SRF, SVG/SVGZ, TGA/TARGA, TIF/TIFF, WMF, XBM, XPM. Animated GIFs are supported.

-

- Refer to - Additional pixbuf loaders - for additional information. -

-

- Preview and thumbnails of video clips can be displayed. Clips can be run via a defined external program - see - Play video by left click on image. -

-
- - - diff --git a/web/help/GuideReferenceThumbnails.html b/web/help/GuideReferenceThumbnails.html deleted file mode 100644 index e2eea6a9..00000000 --- a/web/help/GuideReferenceThumbnails.html +++ /dev/null @@ -1,512 +0,0 @@ - - - - -Thumbnails - - - - - - - - -
-

Thumbnails

- -
-

- This page only refers the Geeqie thumbnail caching mechanism, the shared thumbnail cache mechanism is described in - Thumbnail Standards - . -

-
-

-
-
-

13.3.1. Format

-

Thumbnails are stored in PNG image format. The thumbnail name is the name of the source image with “.png” appended.

-

The modification time (mtime) of the thumbnail is set to match the source file. Thumbnails are regenerated when the timestamps of the thumbnail and source file do not match.

-

-
-
-

13.3.2. Location

-

- Thumbnails are stored in a location specified in - Thumbnail Preferences - . - -

-

The directory structure of the thumbnail cache duplicates that of the location of the source files.

-
-
-

13.3.3. Size

-

Geeqie allows the following sizes for thumbnails:

-

24x24, 32x32, 48x48, 64x64, 96x72, 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192, 256x256

-

The thumbnail is scaled to fit within the preferred size maintaining the aspect ratio. Thumbnails are not cached for images that are equal to or smaller than the preferred thumbnail size.

-

When a cached thumbnail's width and height do not match the preferred size, the thumbnail is regenerated.

-

-
-
- - - diff --git a/web/help/GuideReferenceUTC.html b/web/help/GuideReferenceUTC.html deleted file mode 100644 index 6592b78c..00000000 --- a/web/help/GuideReferenceUTC.html +++ /dev/null @@ -1,485 +0,0 @@ - - - - -UTC and Daylight Saving Time (DST) - - - - - - - - -
-

UTC and Daylight Saving Time (DST)

- -

Geeqie can display the local time at which a photo was taken, adjusted for UTC offset and Daylight Saving Time.

-

- If the image exif data contains the required parameters (see - Pre-formatted tags - ), Geeqie will use the latitude and longitude to determine which timezone the image was taken in. -

- The UTC offset and Daylight Saving Time Correction for that timezone, combined with the GPS UTC value, will then be used to compute the correct local time. -

- This value may be displayed in either the Info Sidebar or Overlay Screen Display by using the parameter - formatted.localtime -

-

- The timezone for the image may also be displayed by using the parameter - formatted.timezone - . -

-
- - - diff --git a/web/help/GuideReferenceXmpExif.html b/web/help/GuideReferenceXmpExif.html deleted file mode 100644 index f4830cdf..00000000 --- a/web/help/GuideReferenceXmpExif.html +++ /dev/null @@ -1,1350 +0,0 @@ - - - - -XMP, Exif and IPTC - - - - - - - - -
-

XMP, Exif and IPTC

- -

The tables below show the XMP, Exif and IPTC tags used by Geeqie.

-
-
-

13.8.1. Geeqie pre-formatted tags

-
-
Table 13-10 Pre-formatted tags
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Geeqie Tag - - Exif tags used - - Description -
- formatted.Camera - - - Exif.Image.Make -

- Exif.Image.Model -

- Exif.Image.Software -
-
- Camera and software name -
- formatted.DateTime - - - Exif.Photo.DateTimeOriginal -

- Exif.Photo.SubSecTimeOriginal -

- Exif.Image.DateTime -

- Exif.Photo.SubSecTime -
-
- Image Date -
- formatted.ShutterSpeed - - - Exif.Photo.ExposureTime -

- Exif.Photo.ShutterSpeedValue - -
-
- Shutter speed in seconds (e.g. 1/60s) -
- formatted.Aperture - - -

- Exif.Photo.Fnumber -

- Exif.Photo.ApertureValue -

-
-
- Aperture (e.g. f5.6) -
- formatted.ExposureBias - - Exif.Photo.ExposureBiasValue - - Exposure bias (e.g. +0.3) -
- formatted.ISOSpeedRating - - Exif.Photo.ISOSpeedRatings - - ISO sensitivity (e.g. 100) -
- formatted.FocalLength - - Exif.Photo.FocalLength - - Focal length -
- formatted.FocalLength35mmFilm - - - Exif.Photo.FocalLengthIn35mmFilm -

- Exif.Photo.FocalLength -

- Exif.Photo.FocalPlaneXResolution -

- Exif.Photo.FocalPlaneYResolution -

- Exif.Photo.FocalPlaneResolutionUnit -

- Exif.Photo.PixelXDimension -

- Exif.Photo.PixelYDimension - -
-
- Focal length 35mm -
- formatted.SubjectDistance - - Exif.Photo.SubjectDistance - - Subject distance -
- formatted.Flash - - Exif.Photo.Flash - - Flash -
- formatted.Resolution - - - Exif.Image.Xresolution -

- Exif.Image.Yresolution -

- Exif.Image.ResolutionUnit -
-
- Resolution -
- formatted.ColorProfile - - - Exif.Image.InterColorProfile -

- Exif.Photo.ColorSpace -

- Exif.Iop.InteroperabilityIndex -
-
- Color profile -
- formatted.GPSAltitude - - - Exif.GPSInfo.GPSAltitudeRef -

- Exif.GPSInfo.GPSAltitude -
-
- Altitude above sea level -
- formatted.GPSPosition - - - Exif.GPSInfo.GPSLatitude -

- Exif.GPSInfo.GPSLatitudeRef -

- Exif.GPSInfo.GPSLongitude -

- Exif.GPSInfo.GPSLongitudeRef -
-
- Latitude, Longitude -
- formatted.localtime - - - Exif.GPSInfo.GPSLatitude -

- Exif.GPSInfo.GPSLatitudeRef -

- Exif.GPSInfo.GPSLongitude -

- Exif.GPSInfo.GPSLongitudeRef -

- Exif.GPSInfo.GPSDateStamp -

- Exif.GPSInfo.GPSTimeStamp -
-
- - Local time corrected for UTC offset, DST correction - 1 - -
- formatted.timezone - - - Exif.GPSInfo.GPSLatitude -

- Exif.GPSInfo.GPSLatitudeRef -

- Exif.GPSInfo.GPSLongitude -

- Exif.GPSInfo.GPSLongitudeRef -
-
- - Timezone indicated by lat/long - 2 - -
- formatted.countryname - - - Exif.GPSInfo.GPSLatitude -

- Exif.GPSInfo.GPSLatitudeRef -

- Exif.GPSInfo.GPSLongitude -

- Exif.GPSInfo.GPSLongitudeRef -
-
- ISO 3166 country name indicated by lat/long -
- formatted.countrycode - - - Exif.GPSInfo.GPSLatitude -

- Exif.GPSInfo.GPSLatitudeRef -

- Exif.GPSInfo.GPSLongitude -

- Exif.GPSInfo.GPSLongitudeRef -
-
- ISO 3166 two-letter abbreviated country name indicated by lat/long -
- formatted.star_rating - - Xmp.xmp.Rating - - Rating shown as a set of 🟊 characters -
-
-
-
-

13.8.2. Info sidebar panes

-
-
Table 13-11 Fixed panes
- - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Tag - - Pane title -
- Xmp.dc.description - - Comment -
- Xmp.dc.subject - - Keywords -
- Xmp.dc.title - - Title -
- Xmp.xmp.Rating - - Rating -
- Xmp.photoshop.Headline - - Headline -
-
-
-
Table 13-12 Location and GPS pane
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Tag - - Field -
- formatted.GPSPosition - - GPS position -
- formatted.GPSAltitude - - GPS altitiude -
- formatted.timezone - - Time zone -
- Xmp.photoshop.Country - - Country -
- -

Xmp.iptc.CountryCode

-
-
- Country Code -
- Xmp.photoshop.State - - State -
- Xmp.photoshop.City - - City -
- Xmp.iptc.Location - - Location -
-
-
-
Table 13-13 Copyright pane
- - - - - - - - - - - - - - - - - - - -
- Tag - - Field -
- Xmp.dc.creator - - Creator -
- Xmp.dc.contributor - - Contributor -
- Xmp.dc.rights - - Rights -
-
-
-
Table 13-14 Exif pane
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Tag - - Field -
- formatted.Camera - - Camera -
- formatted.DateTime - - Date -
- formatted.localtime - - Local time -
- formatted.ShutterSpeed - - Shutter speed -
- formatted.Aperture - - Aperture -
- formatted.ExposureBias - - Exposure bias -
- formatted.ISOSpeedRating - - ISO sensitivity -
- formatted.FocalLength - - Focal length -
- formatted.FocalLength35mmFilm - - Focal length 35mm -
- formatted.SubjectDistance - - Subject distance -
- formatted.Flash - - Flash -
- formatted.Resolution - - Resolution -
- formatted.ColorProfile - - Color profile -
- Exif.Photo.ExposureProgram - - Exposure Program -
- Exif.Photo.MeteringMode - - Metering Mode -
- Exif.Photo.LightSource - - Light Source -
-
-
-
-

13.8.3. Exif IPTC alternative keys

-
-
Table 13-15 Conversion table
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Tag - - Field -
- Xmp.tiff.Orientation - - Exif.Image.Orientation -
- Xmp.dc.title - - Iptc.Application2.ObjectName -
- Xmp.photoshop.Urgency - - Iptc.Application2.Urgency -
- Xmp.photoshop.Category - - Iptc.Application2.Category -
- Xmp.photoshop.SupplementalCategory - - Iptc.Application2.SuppCategory -
- Xmp.dc.subject - - Iptc.Application2.Keywords -
- Xmp.iptc.Location - - Iptc.Application2.LocationName -
- Xmp.photoshop.Instruction - - Iptc.Application2.SpecialInstructions -
- Xmp.photoshop.DateCreated - - Iptc.Application2.DateCreated -
- Xmp.dc.creator - - Iptc.Application2.Byline -
- Xmp.photoshop.AuthorsPosition - - Iptc.Application2.BylineTitle -
- Xmp.photoshop.City - - Iptc.Application2.City -
- Xmp.photoshop.State - - Iptc.Application2.ProvinceState -
- Xmp.iptc.CountryCode - - Iptc.Application2.CountryCode -
- Xmp.photoshop.Country - - Iptc.Application2.CountryName -
- Xmp.photoshop.TransmissionReference - - Iptc.Application2.TransmissionReference -
- Xmp.photoshop.Headline - - Iptc.Application2.Headline -
- Xmp.photoshop.Credit - - Iptc.Application2.Credit -
- Xmp.photoshop.Source - - Iptc.Application2.Source -
- Xmp.dc.rights - - Iptc.Application2.Copyright -
- Xmp.dc.description - - Iptc.Application2.Caption -
- Xmp.photoshop.CaptionWriter - - Iptc.Application2.Writer -
-
-
-
-
-1 -

- Refer to - UTC and DST - section. -

-
-
-2 -

- Refer to - UTC and DST - section. -

-
-
-
- - - diff --git a/web/help/GuideSidebars.html b/web/help/GuideSidebars.html deleted file mode 100644 index 730e8d0b..00000000 --- a/web/help/GuideSidebars.html +++ /dev/null @@ -1,466 +0,0 @@ - - - - -Sidebars - - - - - - - - -
-

Sidebars

- -

- A sidebar is a panel that appears next to an - Image Pane - , and displays additional information about the image. -

-
-
- - - diff --git a/web/help/GuideSidebarsInfo.html b/web/help/GuideSidebarsInfo.html deleted file mode 100644 index 4f326a1e..00000000 --- a/web/help/GuideSidebarsInfo.html +++ /dev/null @@ -1,913 +0,0 @@ - - - - -Info Sidebar - - - - - - - - -
-

Info Sidebar

- -

The Info Sidebar shows various information about the image and can also be used for metadata editing.

-

- To toggle display of the Sort Manager select - View ▸ Info Sidebar ( - Ctrl+K - ) - . -

-

It consists of several panes. Left-clicking on the pane title expands or collapses the pane. Right-clicking on the pane title or on empty space opens a context menu allowing you to add and remove panes, or move them up and down.

-

-
-
-

3.1.1. Histogram

-

- This histogram is identical to that shown in the - Image Overlay - . It can be configured by right-click to modify the display of color or linear/logarithmic scale. -

-

-
-
-

3.1.2. Title

-
-

- Title text is stored in the - Xmp.dc.title - tag. -

-
-

-
-
-

3.1.3. Comment

-
-

- Comment text is stored in the - Xmp.dc.description - tag. -

-
-

-
-
-

3.1.4. Keywords

-

Keywords, together with a flexible search tool, are essential for handling large image collections.

-

Geeqie has free-form keywords and a hierarchical method of adding new keywords to an image.

-
-

- Keywords are stored in the - Xmp.dc.subject - tag. -

-
-
-

- Keywords are not case-sensitive unless selected as so in - Preferences -

-
-

The Keyword pane in the sidebar consists of two sections:

-

-

    -
  • The left hand section which is for free-form keywords
  • -
  • The right hand section which is a hierarchical structure, allowing sets of keywords to be added.
  • -
-

-

The contents of the left-hand box is the data written to file.

-

- The right-hand section has two types of entries : -

    -
  • Keywords
  • -
  • Helpers
  • -
-

An example of keyword hierarchy is:

-
        [ ] animal
-        [ ]   mammal
-        [ ]     dog
-        [ ]     cat
-        [ ]   insect
-        [ ]     fly
-        [ ]     dragonfly
-        daytime
-        [ ]   morning
-        [ ]   afternoon
-      
-

-

- In this example - daytime - is a Helper, and all the others are keywords. Helpers are not stored in metadata - their purpose is only as an organisational aide. -

-

- In the above example if - cat - is clicked, both - mammal - and - animal - will also automatically be checked, and all three transferred to the left hand box, ready for writing as metadata. -

-

If a hierarchy of keywords are checked, and the top-level item then un-checked, all lower level keywords will also be unchecked and will be removed from the left-hand pane.

-
-

This action cannot be undone.

-
-

Irrespective of their position in a hierarchy in the right-hand box, all keywords are written as individual entries into metadata. When metadata for an image is read in, Geeqie will attempt to recreate any hierarchies within the data, and display it accordingly in the right-hand box.

-

- Right-click on the left-hand box allows the selected keywords to be written to the currently selected files - the keywords may be either added to the existing contents, or entirely replace the existing content. -

-

Keyword completion is used when selecting keywords. If the selected area includes part of a keyword, the selection will automatically be expanded to cover the whole keyword. If no text is selected, all keywords will be used.

-
-

-

- Right-click on the right-hand box allows a connection to be made between a keyword and a mark. The - Marking Images - section shows how marks and keywords inter-operate. -

-

The ordering of keywords in the right-hand box may be changed by drag-and-drop.

-

- The meta-data write operation for a file is triggered either - manually - or as defined in - Metadata - . -

-

- If the right-click menu item - Revert - is executed at any time after a - Show all - or - Collapse all - , the keyword layout will be restored to the state prior to the - Show all - or - Collapse all - . -

- If the right-click menu item - Revert - is executed at any time before a - Show all - or - Collapse all - , the keyword layout will be restored to the state existing at start-up. -

-
-

- The selections in the sub-menu - On any change - will affect the operation of the - Revert - option. -

-
-

-
-
-

3.1.5. Keyword Autocompletion

-

- The text box at the bottom of the keywords pane is used for autocompletion. Any keywords typed into the standard keyword box or the autocompletion box will be remembered as candidates for future autocompletion. -

- Frequently used sets of keywords can be entered as comma-delimited lists. -

- The list of keywords used for autocompletion can be edited on the - Keywords - tab of the Preferences dialog. -

- The menu action "Keyword autocomplete", set to - Alt + K - by default, will shift the keyboard focus to the autocomplete box. Pressing - Alt + K - a second time will shift the keyboard focus back to the previous object. -

-

-
-
-

3.1.6. List panes

-

- There are five list panes, whose contents can be configured to display Exif, XMP or IPTC metadata tags. The five panes are: -

    -
  • Title
  • -
  • Exif
  • -
  • File Info
  • -
  • Location and GPS
  • -
  • Copyright
  • -
-

-

Any metadata tag can be displayed in any pane - the pane titles merely exist as an organisational aide.

-

It is possible to reorganise the data displayed by drag-and-dropping any item within a pane, or from one pane to another (although in some cases it makes little sense to do so).

-

-

It is not possible to undo these actions, nor is there a way to reset the display to its original settings.
-

-

- It is also possible to drag new items from the - Exif Window - onto any pane. -

-

As an aide, in addition to standard metadata tags, Geeqie provides certain pre-formatted tags. These are:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Tag - - Replaced by Meta data -
formatted.CameraCamera and software name
formatted.DateTimeImage Date
formatted.ShutterSpeedShutter speed in seconds (e.g. 1/60s)
formatted.ApertureAperture (e.g. f5.6)
formatted.ExposureBiasExposure bias (e.g. +0.3)
formatted.ISOSpeedRatingISO sensitivity (e.g. 100)
formatted.FocalLengthFocal length
formatted.FocalLength35mmFilmFocal length 35mm
formatted.SubjectDistanceSubject distance
formatted.FlashFlash
formatted.ResolutionResolution
formatted.ColorProfileColor profile
formatted.GPSAltitudeAltitude above sea level
formatted.GPSPositionLatitude, Longitude
formatted.localtime - Local time corrected for UTC offset, DST correction - 1 -
formatted.timezone - Timezone indicated by GPS lat/long values - 2 -
formatted.countrynameISO 3166 country name indicated by GPS lat/long values
formatted.countrycodeISO 3166 two-letter abbreviated country name indicated by GPS lat/long values
file.sizefile size in bytes
file.datefile date and time in human readable form
file.modefile mode flags
file.ctimerefer to operating system documentation for the meaning of ctime
file.ownerthe file's owner. Refer to operating system documentation for the meaning of file permissions
file.groupthe file's group. Refer to operating system documentation for the meaning of file permissions
file.classthe file's class e.g. Image, RAW image etc.
file.linkif the file is a symbolic link, shows the path of the source file
-
-

Right-clicking on an item opens the context menu:

-
-
- Add entry -
-
-
-
- Key -
-
-

- Exif, IPTC, XMP or - Geeqie formatted exif - tags. -

-
-
- Title -
-
-

Displayed title text.

-
-
- Show only if set -
-
-

Inhibit display if the tag is empty.

-
-
- Editable -
-
-

Displays the value as editable.

-
-

Geeqie internally converts Exif and IPTC metadata to XMP on read and back on write, thus any changes made to Exif and IPTC here will be lost on write. You must edit the corresponding XMP instead.

-

An exception is Makernote tags which don't have an equivalent in XMP. However Makernotes cannot be written to an external file (a sidecar or Geeqie metadata file).

-
-
-
-
-
- Show hidden -
-
- Shows all entries regardless of - Show only if set - . -
-
-

-
-
-

3.1.7. Map Display

-

- Geeqie can display maps created by the - openstreetmap.org - . To use this facility, Geeqie must have been compiled with the --enable-map option. -

-
    -
  • -

    - Image location display -

    - All geocoded images in the currently displayed folder will show as small icons on the map. Clicking the icon will expand the icon to show an image thumbnail, plus other pre-defined image data. -

    -

    Right-click on the map will show other map options.

    -

    Middle-click controls the map-centering function.

    -
  • -
  • -

    - Geo-coded search -

    - Left-click stores the latitude/longitude under the cursor into the clipboard. This may be used to define the origin of a - geocode search - . -

    -
  • -
  • -

    - Geo-coding Images -

    - If an image is not geocoded, the filename or icon on the file pane can be dragged-and-dropped onto the map. The image latitude and longitude xmp meta-data will be updated to the drop position on the map. -

    -
  • -
  • -

    - Map Centering -

    - If an internet URL containing a valid latitude and longitude is dropped on the map, the map will be re-centered on that location. The zoom level will not change. Refer to - Decoding Latitude and Longitude - . -

    -
  • -
-
-
-
-1 -

- Refer to - UTC and DST - section. -

-
-
-2 -

- Refer to - UTC and DST - section. -

-
-
-
- - - diff --git a/web/help/GuideSidebarsSortManager.html b/web/help/GuideSidebarsSortManager.html deleted file mode 100644 index b855208c..00000000 --- a/web/help/GuideSidebarsSortManager.html +++ /dev/null @@ -1,601 +0,0 @@ - - - - -Sort Manager Sidebar - - - - - - - - -
-

Sort Manager Sidebar

- -

The Sort Manager sidebar provides a convenient method to quickly sort many files into a set of folders or collections.

-

- To toggle display of the Sort Manager select - View ▸ Sort Manager ( - Shift+S - ) - . -

-

The mode of the Sort Manager is selected by the drop down list under the sidebar title. The Folder mode allows moving or copying the visible image to a folder, and the Collection mode allows adding the visible image or file selection to a collection.

-

-
-
-

3.2.1. Folder view

-

The Sort Manager folder view consists of a vertical list for bookmarking folders, a section to select the operation to perform, and a set of buttons along the bottom.

-

Clicking or activating an item in the list will copy, move, or link the active image's file to that location. The active image will then change to the next image.

-

-
-
-

3.2.1.1. Bookmark list

-

This is a list of possible folders to use as a destination for the selected operation. A context menu will appear by right clicking on an item, or pressing the menu key when the item has the focus.

-

Folders can be added to the list by activating the Add button at the bottom of the sidebar, or dragging a folder onto the list.

-

- To edit an item select - Properties - from its context menu. A dialog will appear allowing the Name, Path, and Icon for the item to be changed. Select OK to close the dialog and apply the changes, or Cancel to close the dialog and discard the changes. -

-

- To change the order of the list, select - Move up - or - Move down - from the item's context menu. To move an item with the keyboard move the focus to that item, then press - Shift+Up - or - Shift+Down - to move the item. -

-

- To remove an item from the list select - Remove - from it's context menu. -

-

-
-
-

3.2.1.2. Copy, Move, Link and Desktop actions

-

- Copy, Move and Symbolic Link are available operations to use on the active image; they should be self explanatory. In some cases, Desktop files are also listed. This is detailed in - Plugins Configuration -

-

-
-
-

3.2.1.3. Add button

-

Activate this button to add a folder to the bookmark list. A dialog will appear to allow selection of the folder to use for the new item.

-

-
-
-

3.2.1.4. Undo button

-

Activate this button to undo the last copy, move, or link operation. The undo function can only reverse the most recent operation.

-

-
-
-
-

3.2.2. Collection view

-

The Sort Manager collection view consists of a vertical list of collection, a section to determine the current selection, and a set of buttons along the bottom.

-

Clicking or activating an item in the list will add the selected image to that collection.

-

-
-
-

3.2.2.1. Collection list

-

- This is the list of collections located in the folder listed in - Configuration Files - . Activating a member of this list will result in the current image selection to be added to the collection. If the image already exists within the collection, it will not be added a second time. -

-

A new empty collection can be added to the list by activating the Add button at the bottom of the sidebar.

-

-
-
-

3.2.2.2. Choosing the selection style

-

The images to add when activating a collection is determined by the selection style:

-
-
- Add image -
-
-

The visible image is added to the collection.

-
-
-
-
- Add selection -
-
-

All images selected in the file list will be added to the collection.

-
-
-

-
-
-

3.2.2.3. Add button

-

Activate this button to add a new empty collection to the visible list. A dialog will appear to allow entry of the name to use for the new collection.

-

-
-
-

3.2.2.4. Undo button

-

Activate this button to undo the last add operation. The undo function can only reverse the most recent operation.

-

-
-
-
- - - diff --git a/web/help/Imageviewing.html b/web/help/Imageviewing.html deleted file mode 100644 index aa9ad435..00000000 --- a/web/help/Imageviewing.html +++ /dev/null @@ -1,472 +0,0 @@ - - - - -Image viewing - - - - - - - - -
-

Image viewing

- -

- -
-

14.1.1. How do I keep images smaller than the visible area from enlarging when the zoom is set to “fit to window” ?

-

- In the - Preferences Image dialog - , disable “Allow enlargement of image for zoom to fit”. -

-

-
-
- - - diff --git a/web/help/Layouttab.html b/web/help/Layouttab.html deleted file mode 100644 index 409b4bc1..00000000 --- a/web/help/Layouttab.html +++ /dev/null @@ -1,513 +0,0 @@ - - - - -Layout tab - - - - - - - - -
-

Layout tab

- -
-
- Source -
-
-

This selects the group of images to use for print output.

-
-
-
-
- Image -
-
-

The file with the focus.

-
-
- Selection -
-
-

The files selected in the main window.

-
-
- All -
-
-

All files listed in the main window.

-
-
-
-
- Layout -
-
-

Select one image per page, or a Proof sheet that will print multiple images per page.

-
-
-
-
- Image size -
-
-

When print one image per page, the size of the image in relation to the available print area.

-
-
- Proof size -
-
-

When printing a Proof sheet, the size of each image in Units (see Paper tab).

-
-
-
- - - diff --git a/web/help/Miscellaneous.html b/web/help/Miscellaneous.html deleted file mode 100644 index 254bc4b5..00000000 --- a/web/help/Miscellaneous.html +++ /dev/null @@ -1,486 +0,0 @@ - - - - -Miscellaneous - - - - - - - - -
-

Miscellaneous

- -

- -
-

14.3.1. How can I save and restore multiple Geeqie windows

-

- The option - Exit program when this window is closed - provides this facility. -

-

-
-
-

14.3.2. I want to be able to edit images with Geeqie

-

- Geeqie is an image - viewer - . There is, and never will be, a plan to add editing features. I recommend gimp for image editing. -

-

-
-
- - - diff --git a/web/help/Papertab.html b/web/help/Papertab.html deleted file mode 100644 index 6d64208b..00000000 --- a/web/help/Papertab.html +++ /dev/null @@ -1,503 +0,0 @@ - - - - -Paper tab - - - - - - - - -
-

Paper tab

- -
-
- Format -
-
-

The size of the paper in the printer's paper tray. Many common sizes are provided, however if the paper size is not listed selected the Custom format and enter the paper size in Size below.

-
-
-
-
- Size -
-
-

The size of the selected paper format, in Units (below). These numbers can be changed when the paper Format is Custom.

-
-
-
-
- Units -
-
-

Select the units for Geeqie to use when conveying measurements of length for paper size, margins, and images sizes to the user.

-
-
-
-
- Orientation -
-
-

Select portrait or landscape print output.

-
-
-
-
- Margins -
-
-

These values specify the size of the paper edges not to be included in the print region, in Units (above).

-
-
-
- - - diff --git a/web/help/Preview.html b/web/help/Preview.html deleted file mode 100644 index 7f97856b..00000000 --- a/web/help/Preview.html +++ /dev/null @@ -1,515 +0,0 @@ - - - - -Preview - - - - - - - - -
-

Preview

- -

The preview displays a small version of the output that will result with the current settings. The preview will update whenever a setting is changed that will effect the print output.

-

The preview will indicate the number of pages that will be printed, to see a preview of a specific page change to that page by activating the left or right arrow buttons located below the preview.

-

The size of the preview can be changed using the three zoom buttons located below the preview.

-

- The preview includes several reference lines that are - not included - in the final print: -

-
-
- Reference grid -
-
-

Light gray lines that form a grid over the entire page, the spacing between these lines is dependent on the current measurement unit:

-
-
-
-
- Inch -
-
-

1 inch.

-
-
- Points -
-
-

72 points.

-
-
- Centimeters or Millimeters -
-
-

1 centimeter.

-
-
-
-
- Margins -
-
-

Blue lines along each edge of the page represent the location of the print margins, the non-printable area of the page is also gray.

-
-
-
-
- Proof sheet grid -
-
-

When the layout is set to Proof sheet, each proof location is indicated with a red rectangle.

-
-
-
- - - diff --git a/web/help/Printbutton.html b/web/help/Printbutton.html deleted file mode 100644 index 690985e0..00000000 --- a/web/help/Printbutton.html +++ /dev/null @@ -1,464 +0,0 @@ - - - - -Print button - - - - - - - - -
-

Print button

- -

Activate the print button to start the print job, the dialog will change to display the progress as images are sent to the selected print destination.

-
- - - diff --git a/web/help/Printertab.html b/web/help/Printertab.html deleted file mode 100644 index 2e2e1f26..00000000 --- a/web/help/Printertab.html +++ /dev/null @@ -1,529 +0,0 @@ - - - - -Printer tab - - - - - - - - -
-

Printer tab

- -
-
- Destination -
-
-

Use this to select the destination of the print output.

-
-
-
-
- Default printer -
-
-

Prints to the system default printer.

-
-
- Custom printer -
-
-

Prints to the printer using the command defined in Custom printer (below).

-
-
- Postscript file -
-
-

Writes using the postscript format to named File (below).

-
-
- Image file -
-
-

Writes using the selected File format (below) to named File (below).

-
-
-
-
- Custom printer -
-
-

The command to use when Destination is selected as Custom printer. For convenience, the drop down list includes printers available for use by the printing subsystem.

-
-
-
-
- File -
-
-

The file to use for output when Destination is Postscript file or Image file.

-
-
-
-
- File format -
-
-

The image format to use when Destination is Image file.

-
-
-
-
- DPI -
-
-

Abbreviation for Dots Per Inch. When the Destination is a printer or postscript file, this defines the maximum DPI to use when outputting image data. For example if the Destination printer is only capable of 600 DPI, but the resulting image to print is 1200 DPI, Geeqie will scale the image down to 600 DPI before sending it to the printer. This can greatly reduce the size of a print job when printing Proof Sheets or very large images.

-
-
-
- - - diff --git a/web/help/Rememberprintsettings.html b/web/help/Rememberprintsettings.html deleted file mode 100644 index 49526287..00000000 --- a/web/help/Rememberprintsettings.html +++ /dev/null @@ -1,464 +0,0 @@ - - - - -Remember print settings - - - - - - - - -
-

Remember print settings

- -

Enable this check box to retain the current settings as the default for the print dialog. This option only retains the settings when a print operation is started by activating the print button. In addition, only the settings relevant to the current print operation will be retained.

-
- - - diff --git a/web/help/Texttab.html b/web/help/Texttab.html deleted file mode 100644 index 5fdb6bff..00000000 --- a/web/help/Texttab.html +++ /dev/null @@ -1,511 +0,0 @@ - - - - -Text tab - - - - - - - - -
-

Text tab

- -
-
- Name -
-
-

Include the file name below each image.

-
-
-
-
- Path -
-
-

Include the full path of the file below each image.

-
-
-
-
- Date -
-
-

Include the file date below each image.

-
-
-
-
- Size -
-
-

Include the file size below each image.

-
-
-
-
- Dimensions -
-
-

Include the source image's pixel width and height below each image.

-
-
-
-
- Font size -
-
-

The font size to use for the text description of each image, in points.

-
-
-
- - - diff --git a/web/index.html b/web/index.html deleted file mode 100644 index 57e4a41d..00000000 --- a/web/index.html +++ /dev/null @@ -1,105 +0,0 @@ - - - - - Geeqie Image Viewer -- Main Project Page - - - - - - -
-

Geeqie is a lightweight image viewer for Linux, BSDs and compatibles.

-

It can be used as a simple, fast, database-free image viewer, but equally it can be used to manage large - collections of images.

-

Features

-

A summary of Geeqie may be found on its Wiki page.

-

A more complete feature list is here.

-

And the on-line Help file gives even more detail.

-

A few screenshots give an idea of the range of possibilities.

-

Downloading and installation

-

Geeqie is available as a package for several distributions:

-

Linux

- -

BSD

- -

MacOS X Homebrew Formulae

-

Solaris Openscw.org Solaris 10 & 11

-

Geeqie is also available:

- -

The source tar for Geeqie v1.5 is available here. (Signature also available under geeqie-1.5.tar.xz.asc)

-

However if you are compiling from sources it is recommended that you get the latest sources from the - Geeqie repository.

Geeqie is stable, there - are frequent updates, and compiling is a quick and painless task. The instructions for downloading and installing are easy to follow. -

For Ubuntu and other Debian-based systems, this script will download Geeqie sources, all dependencies, and compile and install Geeqie. You may also select which optional libraries to install.

-

Support

-

If you need help or have questions about Geeqie, just send a message to the mailing list. -

- Although it is not mandatory, we encourage you to subscribe. Please note that you will not automatically receive responses to your message unless you are subscribed -
Your email address: - - - - -
-

For bugs and feature requests, Geeqie at - GitHub is the place to go.

-
- - diff --git a/web/installing.html b/web/installing.html deleted file mode 100644 index 466c27fa..00000000 --- a/web/installing.html +++ /dev/null @@ -1,157 +0,0 @@ - - - - - Installing Geeqie - - -
-

Downloading

-

Geeqie is available as a package with some distributions.

-

- The source tar of the latest formal release may be downloaded: - http://geeqie.org/geeqie-1.3.tar.xz -

-

However Geeqie is stable, and you may download the latest version (if you have installed git) from here:

-

- Either: - git clone git://www.geeqie.org/geeqie.git -

-

- Or: - git clone http://www.geeqie.org/git/geeqie.git -

-

Installation

-

- List compile options: - ./autogen.sh --help -

-

- Common options: - ./autogen.sh --disable-gtk3 - , -

-

- Compilation: - ./autogen.sh [options]; make -j<no. of cpu cores> -

-

- Install: - [sudo] make install -

-

- Removal: - [sudo] make uninstall -

-

Note:

-

The zip and gzip files at geeqie.org and GitHub contain only the sources - they cannot, by themselves, be used to install Geeqie.

-

- It is recommended to always use - git clone git://www.geeqie.org/geeqie.git - to download Geeqie. After installing Geeqie you may delete the folder you have cloned Geeqie into. -

-

However if you leave the folder intact, whenever new features or patches are available, execute:

-

- git pull; sudo make uninstall; sudo make maintainer-clean; ./autogen.sh; make -j<no. of cpu cores>; sudo make install -

-

Only the changed sources are downloaded, which makes this a quick operation.

-

Your configuration file, history file and desktop files are not affected by this process.

-

Notes and changes for the latest release

-

- See the NEWS file in the installation folder, or - Geeqie News at GitHub -

-

- And either the ChangeLog file or - Geeqie ChangeLog -

-

Requirements

-

Required libraries:

-
-        
-          GTK+ 3.00
-          www.gtk.org
-          enabled by default
-          disable with configure option: --disable-gtk3
-          or
-          GTK+ 2.20
-          disabled by default when GTK+3 libraries are found.
-          enable with configure option: --disable-gtk3
-          optional items map display and GPU acceleration are not available
-          with GTK2
-          
-          Note: GTK+3 is still somehow experimental. It is needed for some
-          features but we have several complains about the GTK+3 usability.
-          
-          So if you need a stable version, you are advised to compile it
-          with GTK+2. If you want to play with the cool new features, use
-          GTK+3.
-        
-      
-

Optional libraries:

-
-        
-          lcms2 2.0
-          or
-          lcms 1.14
-          www.littlecms.com
-          for color management support
-          enabled by default
-          disable with configure option: --disable-lcms
-          
-          exiv2 0.11
-          www.exiv2.org
-          for enhanced exif support
-          enabled by default
-          disable with configure option: --disable-exiv2
-          
-          lirc
-          www.lirc.org
-          for remote control support
-          enabled by default
-          disable with configure option: --disable-lirc
-          
-          libchamplain-gtk 0.12
-          libchamplain 0.12
-          libclutter 1.0
-          wiki.gnome.org/Projects/libchamplain
-          for map display
-          enabled by default
-          disable with configure option: --disable-map
-          
-          libclutter 1.0
-          www.clutter-project.org
-          for GPU acceleration (a check-box on Preferences/Image must also be ticked)
-          enabled by default
-          disable with configure option: --disable-gpu-accel
-          explicitly disabling will also disable the map feature
-          
-          lua 5.1
-          www.lua.org
-          support for lua scripting
-          enabled by default
-          disable with configure option: --disable-lua
-
-          librsvg2-common
-          for displaying .svg images
-
-          libwmf0.2-7-gtk
-          for displaying .wmf images
-
-          (see also "Additional pixbuf loaders" in the References section of the Help file)
-
-          awk
-          when running Geeqie, to use the geo-decode function
-          
-          markdown
-          when compiling Geeqie, to create this file in html format
-
-         libffmpegthumbnailer 2.1.0
-         for thumbnailing camera video clips
-         enabled by default
-         disable with configure option: --disable-libffmpegthumbnailer
-        
-      
-
- - diff --git a/web/screenshots/.llgal/llgal.css b/web/screenshots/.llgal/llgal.css deleted file mode 100644 index 370f1eed..00000000 --- a/web/screenshots/.llgal/llgal.css +++ /dev/null @@ -1,163 +0,0 @@ -/* Body */ - -body { - font-family: verdana, sans-serif; - background: #333333; - color: #dddddd; -} - -/* Links */ - -a:link { - color: #95ddff; -} - -a:visited { - color: #aaaaaa; -} - -a:hover { - color: #bbddff; - background: #555555; -} - -img.image-link { - border-style: none; -} - -/* Various */ - -.small { - font-size: 75%; -} - -.large { - font-size: 200%; -} - -.center { - text-align: center; -} - -.center table { - margin-left: auto; - margin-right: auto; -} - -/* Index table */ - -table.index { - border: 0px; - padding: 0px; - margin-top: 9px; - margin-bottom: 9px; -} - -table.with-tile { - background-color: #000000; -} - -table.index td { - padding: 0px; -} - -table.index td.thumb img { - vertical-align: middle; - border-style: none; -} - -table.index td.text-thumb { - border-width: 1px; - border-style: solid; - border-color: #ffffff; - text-align: center; - font-size: 50%; -} - -table.index td.tiled { - background-image: url("tile.png"); - background-repeat: repeat-x; - text-align: left; - font-size: 0px; -} - -table.index td.thumb-dim { - font-size: 50%; -} - -table.index td.thumb-caption { - font-size: 75%; - background: none; -} - -hr.index { - width: 80%; - height: 0px; - border-width: 2px; -} - -/* Slides */ - -table.slide { - background-color: #000000; - border-width: 3px; - border-style: solid; - border-color: #ffffff; - border-spacing: 0px; -} - -table.slide td.image-slide { - padding: 0px; -} - -table.slide td.image-slide img { - vertical-align: middle; - border-style: none; -} - -table.slide td.text-slide { - text-align: center; - vertical-align: middle; - font-size: 200%; - font-style: italic; -} - -p.caption { - text-align: center; -} - -/* Headers and footers */ - -.header { - font-size: 120%; - padding-top: 6px; - padding-bottom: 6px; -} - -.footer { - font-size: 120%; - padding-top: 6px; - padding-bottom: 6px; -} - -/* EXIF table */ - -table.exif { - border: 0px; - border-spacing: 1px; - background: #ffffff; -} - -table.exif td.exif-name { - text-align: right; - background: #333333; - padding-left: 6px; - padding-right: 6px; -} - -table.exif td.exif-value { - text-align: left; - background: #333333; - padding-left: 6px; - padding-right: 6px; -} diff --git a/web/screenshots/readme.txt b/web/screenshots/readme.txt deleted file mode 100644 index 8d2cf6ff..00000000 --- a/web/screenshots/readme.txt +++ /dev/null @@ -1,4 +0,0 @@ - -Screenshots created with: -llgal -f --title "Geeqie Screenshots" --sx 1024 --sy 768 -p 20 -i screenshots - diff --git a/web/screenshots/screenshots.html b/web/screenshots/screenshots.html deleted file mode 100644 index 1f32d7f7..00000000 --- a/web/screenshots/screenshots.html +++ /dev/null @@ -1,137 +0,0 @@ - - - - - - - Geeqie Screenshots - - - - - - - -

Geeqie Screenshots

- - -
- - - - - - - - - - -
- - Thumbnail Screenshot_2017-08-13_12-02-32.png - - - Thumbnail Screenshot_2017-08-13_12-29-44.png - - - Thumbnail Screenshot_2017-08-13_12-43-38.png - - - Thumbnail Screenshot_2017-08-13_12-46-11.png - - - Thumbnail Screenshot_2017-08-13_12-49-26.png -
- - - - - - - - -
- - Thumbnail Screenshot_2017-08-13_12-55-34.png - - - Thumbnail Screenshot_2017-08-13_13-10-50.png - - - Thumbnail Screenshot_2017-08-13_13-31-36.png - - - Thumbnail Screenshot_2017-08-13_13-50-36.png - - - Thumbnail Screenshot_2017-08-13_13-53-32.png -
- - - - - - - - -
- - Thumbnail Screenshot_2017-08-13_19-19-41.png - - - Thumbnail Screenshot_2017-08-13_19-22-46.png - - - Thumbnail Screenshot_2017-08-13_19-28-22.png - - - Thumbnail Screenshot_2017-08-13_19-29-29.png - - - Thumbnail Screenshot_2017-08-13_19-56-20.png -
- - - - - - - - -
- - Thumbnail Screenshot_2017-08-14_15-22-59.png - - - Thumbnail Screenshot_2017-08-14_15-41-56.png - - - Thumbnail Screenshot_2017-08-14_15-56-10.png - - - Thumbnail Screenshot_Geeqie_1.0.jpg - - - Thumbnail geeqie_scr1.jpg -
- - - - - -
- - Thumbnail scr_sidebar.jpg - - - Thumbnail screen_gps.jpg -
- - -
- - -

created with llgal

- - - diff --git a/web/screenshots/slide_01.html b/web/screenshots/slide_01.html deleted file mode 100644 index 9a3e940a..00000000 --- a/web/screenshots/slide_01.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_12-02-32.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_12-02-32.png -
- -

-    (01/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_02.html b/web/screenshots/slide_02.html deleted file mode 100644 index bb5d2bcb..00000000 --- a/web/screenshots/slide_02.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_12-29-44.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_12-29-44.png -
- -

-    (02/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_03.html b/web/screenshots/slide_03.html deleted file mode 100644 index 76381e32..00000000 --- a/web/screenshots/slide_03.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_12-43-38.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_12-43-38.png -
- -

-    (03/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_04.html b/web/screenshots/slide_04.html deleted file mode 100644 index ed79b800..00000000 --- a/web/screenshots/slide_04.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_12-46-11.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_12-46-11.png -
- -

-    (04/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_05.html b/web/screenshots/slide_05.html deleted file mode 100644 index 3e78fe72..00000000 --- a/web/screenshots/slide_05.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_12-49-26.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_12-49-26.png -
- -

-    (05/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_06.html b/web/screenshots/slide_06.html deleted file mode 100644 index 7057daa2..00000000 --- a/web/screenshots/slide_06.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_12-55-34.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_12-55-34.png -
- -

-    (06/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_07.html b/web/screenshots/slide_07.html deleted file mode 100644 index 711b249c..00000000 --- a/web/screenshots/slide_07.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_13-10-50.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_13-10-50.png -
- -

-    (07/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_08.html b/web/screenshots/slide_08.html deleted file mode 100644 index dccada62..00000000 --- a/web/screenshots/slide_08.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_13-31-36.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_13-31-36.png -
- -

-    (08/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_09.html b/web/screenshots/slide_09.html deleted file mode 100644 index 32d734ac..00000000 --- a/web/screenshots/slide_09.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_13-50-36.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_13-50-36.png -
- -

-    (09/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_10.html b/web/screenshots/slide_10.html deleted file mode 100644 index 125b8c0e..00000000 --- a/web/screenshots/slide_10.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_13-53-32.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_13-53-32.png -
- -

-    (10/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_11.html b/web/screenshots/slide_11.html deleted file mode 100644 index 5a6a8a39..00000000 --- a/web/screenshots/slide_11.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_19-19-41.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_19-19-41.png -
- -

-    (11/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_12.html b/web/screenshots/slide_12.html deleted file mode 100644 index 7fdf2270..00000000 --- a/web/screenshots/slide_12.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_19-22-46.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_19-22-46.png -
- -

-    (12/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_13.html b/web/screenshots/slide_13.html deleted file mode 100644 index eae832f2..00000000 --- a/web/screenshots/slide_13.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_19-28-22.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_19-28-22.png -
- -

-    (13/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_14.html b/web/screenshots/slide_14.html deleted file mode 100644 index 7446e35e..00000000 --- a/web/screenshots/slide_14.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_19-29-29.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_19-29-29.png -
- -

-    (14/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_15.html b/web/screenshots/slide_15.html deleted file mode 100644 index 354afd5d..00000000 --- a/web/screenshots/slide_15.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-13_19-56-20.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-13_19-56-20.png -
- -

-    (15/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_16.html b/web/screenshots/slide_16.html deleted file mode 100644 index de6a1b36..00000000 --- a/web/screenshots/slide_16.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-14_15-22-59.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-14_15-22-59.png -
- -

-    (16/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_17.html b/web/screenshots/slide_17.html deleted file mode 100644 index c04d20a3..00000000 --- a/web/screenshots/slide_17.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-14_15-41-56.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-14_15-41-56.png -
- -

-    (17/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_18.html b/web/screenshots/slide_18.html deleted file mode 100644 index 2a959115..00000000 --- a/web/screenshots/slide_18.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_2017-08-14_15-56-10.png - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_2017-08-14_15-56-10.png -
- -

-    (18/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_19.html b/web/screenshots/slide_19.html deleted file mode 100644 index ff5eb9cb..00000000 --- a/web/screenshots/slide_19.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - Screenshot_Geeqie_1.0.jpg - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image Screenshot_Geeqie_1.0.jpg -
- -

-    (19/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_20.html b/web/screenshots/slide_20.html deleted file mode 100644 index 7750d618..00000000 --- a/web/screenshots/slide_20.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - geeqie_scr1.jpg - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image geeqie_scr1.jpg -
- -

-    (20/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_21.html b/web/screenshots/slide_21.html deleted file mode 100644 index 5003c956..00000000 --- a/web/screenshots/slide_21.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - scr_sidebar.jpg - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image scr_sidebar.jpg -
- -

-    (21/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/screenshots/slide_22.html b/web/screenshots/slide_22.html deleted file mode 100644 index 80955757..00000000 --- a/web/screenshots/slide_22.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - screen_gps.jpg - - - - - - - - - - - -

- <<Prev -       - Index -       - Next>> -

- -
- Scaled image screen_gps.jpg -
- -

-    (22/22)    -

- -

- <<Prev -       - Index -       - Next>> -

- -
- -
- - - diff --git a/web/tidy.conf b/web/tidy.conf deleted file mode 100644 index 05d3ecc0..00000000 --- a/web/tidy.conf +++ /dev/null @@ -1,7 +0,0 @@ -// Configuration file for HTML Tidy 5.2.0. -wrap: 120 -indent: auto -clean: yes -coerce-endtags: yes -indent-spaces: 4 - diff --git a/web/upload.sh b/web/upload.sh deleted file mode 100755 index fb6fc36c..00000000 --- a/web/upload.sh +++ /dev/null @@ -1,32 +0,0 @@ -#!/bin/sh - -if [ "${PWD##*/}" != "web" ] ; then - echo $0 must be called from directory \"web\" - exit 1 -fi - -# later we can include user manual -# ln -sf ../doc - -chmod -R a+rX . -rsync --archive \ - --verbose \ - --partial \ - --progress \ - --copy-links \ - --keep-dirlinks \ - --delete \ - --exclude "*.bak" \ - --exclude .xvpics \ - --exclude .thumbnails \ - --exclude .wml \ - --exclude "*.wml" \ - --exclude "*~" \ - --exclude .gitignore \ - --exclude Makefile \ - --exclude .wmlrc \ - --exclude .wmkrc \ - --exclude sync \ - --exclude "*.sh" \ - --exclude ".*.swp" \ - ./ tschil:/srv/www/geeqie.org/ -- 2.20.1