From d4f41aeb17f23eb0851e9a80b7771ccc76327699 Mon Sep 17 00:00:00 2001 From: Colin Clark Date: Mon, 2 Jan 2017 19:37:33 +0000 Subject: [PATCH] Revised Help documentation Revised documentation for keyboard shortcuts. Context-sensitive F1 help for Collections, Duplicates, Search and Pan View windows --- .../GuideReferenceKeyboardShortcuts.xml | 2262 ++++++++++------- src/collect.c | 3 + src/dupe.c | 3 + src/pan-view/pan-view.c | 3 + src/search.c | 3 + 5 files changed, 1385 insertions(+), 889 deletions(-) diff --git a/doc/docbook/GuideReferenceKeyboardShortcuts.xml b/doc/docbook/GuideReferenceKeyboardShortcuts.xml index 57761ca2..da293919 100644 --- a/doc/docbook/GuideReferenceKeyboardShortcuts.xml +++ b/doc/docbook/GuideReferenceKeyboardShortcuts.xml @@ -1,911 +1,1395 @@
+ Keyboard and Mouse Shortcuts - The table below shows the defaults for keyboard shortcuts. The current settings for all shortcuts may be found in the + The tables below shows the defaults for keyboard shortcuts. The current settings for all shortcuts may be found in the dialogue. - Keyboard and Mouse Shortcuts - - Default keyboard shortcuts - - - - Shortcut - Mouse - Action - - - - - - Image Navigation - - - - - - - PageDown - - - Left Click - , - - Mouse Wheel down - - - Default Mouse wheel functions can be altered by changing the - Mouse wheel scrolls image - option. - - - - 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) - - - - - - - Arrow key - - - Left click and Drag - - - Pan image. - - - - Shift + Arrows - - - Pan Image faster. - - - - Ctrl + Arrow key - - - Pan to respective edge of image. - - - - - 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 - - - - Delete selected images. - - - - - Ctrl + +
+ Keyboard shortcuts in all windows +
+ Standard keyboard shortcuts + + + + Shortcut + Mouse + Action + + + + + + F1 + + + Help. + + + + Menu + + Right-click + Context menu. + + + + F10 + + Right-click + Context menu. + + + +
+
+
+ Main window keyboard shortcuts + + + <link linkend="GuideMainWindow">Main window</link> + keyboard shortcuts + + + + + Shortcut + Mouse + Action + + + + + + Image Navigation + + + + + + + PageDown + + + Left Click + , + + Mouse Wheel down + + + Default Mouse wheel functions can be altered by changing the + Mouse wheel scrolls image + option. + + + + 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) + + + + + + + Arrow key + + + Left click and Drag + + + Pan image. + + + + Shift + Arrows + + + Pan Image faster. + + + + Ctrl + Arrow key + + + Pan to respective edge of image. + + + + + 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 - - - - Close window, Geeqie exits when last window is closed. - - - - - Ctrl + - Q - - - - Quit Geeqie. - - - - - - - - - Edit Menu - - - - - - - - Ctrl + + + + 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 - - - - Open Geeqie preferences window. - - - - - Ctrl + - S - - - - Save metadata - - - - - - - - - Select Menu - - - - - - - 1 - ... - 6 - - - Toggle mark 1 ... 6 - - - - - Ctrl + + + + 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 + + + + 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 - - ... - - Ctrl + + ... 6 - - - - Select mark 1 ... 6 - - - - - Ctrl + - A - - - - Select all images. - - - - - Ctrl + SHIFT + - A - - - - Unselect all images. - - - - - - - - - View Menu - - - - - - - T - - - Toggle display of thumbnails when in list view. - - - - - Ctrl + + + + Toggle mark 1 ... 6 + + + + + Ctrl + + 1 + + ... + + Ctrl + + 6 + + + + Select mark 1 ... 6 + + + + + Ctrl + + A + + + + Select all images. + + + + + Ctrl + SHIFT + + A + + + + Unselect all images. + + + + + + + + + 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 - - - - Display file list as detailed list view. - - - - - Ctrl + + + + 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 - - - - 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 + + + + Toggle information overlay. + + + S - - - - Toggle Sort Manager sidebar. - - - - - Ctrl + - K - - - - Toggle Keywords sidebar. - - - - V - - - Toggle full screen. - - - - I - - - Toggle information overlay. - - - - S - - - Toggle slideshow. - - - - - - - - - Help Menu - - - - - - - F1 - - - Open User Manual in browser. - - - - - - - + + + Toggle slideshow. + + + +
+
+
+ Collections keyboard shortcuts + + + <link linkend="GuideCollections">Collections window</link> + keyboard shortcuts + + + + + Shortcut + Mouse + Action + + + Collection Window - - - - Arrows - - - Move selection. - - - - Shift + Arrow key - - - Select multiple images. - - - - Ctrl + Arrow - - - Move focus without changing selection. - - - - 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 + + + + Arrows + + + Move selection. + + + + Shift + Arrow key + + + Select multiple images. + + + + 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 - - - - 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. - - - - - Ctrl + + + + 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. + + + + + + + + +
+
+
+ Duplicates keyboard shortcuts + + + <link linkend="GuideImageSearchFindingDuplicates">Duplicates window</link> + keyboard shortcuts + + + + + Shortcut + Mouse + Action + + + + + 1 - - ... - - Ctrl + - 0 - - - - Run external edit command on selected images. - - - - S - - - Save collection. - - - - - Ctrl + - S - - - - Save collection as, opens destination dialog. - - - - A - - - Append to collection, opens append dialog. - - - - - Ctrl + + + + Select group 1 duplicates. + + + + 2 + + + Select group 2 duplicates. + + + 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 + - P - - - - Open image properties window. - - - - - Ctrl + - W - - - - Close collection window. - - - - - - - - - - Find Duplicates Window - (same as Collection Window above, with the following additions) - - - - - - - 1 - - - Select group 1 duplicates. - - - - 2 - - - Select group 2 duplicates. - - - - C - - - Open new collection window and add selected images. - - - -
+ + + 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. + + + + +
+
+ Search keyboard shortcuts + + + <link linkend="GuideImageSearchSearch">Search window</link> + keyboard shortcuts + + + + + Shortcut + Mouse + Action + + + + + + + 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. + + + +
+
+
+ Pan view keyboard shortcuts + + + <link linkend="GuideOtherWindowsPanView">Pan View window</link> + keyboard shortcuts + + + + + Shortcut + Mouse + Action + + + + + + 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. + + + +
+
diff --git a/src/collect.c b/src/collect.c index c4de037f..12bee14d 100644 --- a/src/collect.c +++ b/src/collect.c @@ -920,6 +920,9 @@ static gboolean collection_window_keypress(GtkWidget *widget, GdkEventKey *event collection_remove_by_info(cw->cd, collection_table_get_focus_info(cw->table)); } break; + case GDK_KEY_F1: + help_window_show("GuideReferenceKeyboardShortcuts.html#CollectionsKeyboardShortcuts"); + break; default: stop_signal = FALSE; break; diff --git a/src/dupe.c b/src/dupe.c index a92fa3fc..27eb5013 100644 --- a/src/dupe.c +++ b/src/dupe.c @@ -3013,6 +3013,9 @@ static gboolean dupe_window_keypress_cb(GtkWidget *widget, GdkEventKey *event, g dupe_popup_menu_pos_cb, listview, 0, GDK_CURRENT_TIME); } break; + case GDK_KEY_F1: + help_window_show("GuideReferenceKeyboardShortcuts.html#DuplicatesKeyboardShortcuts"); + break; default: stop_signal = FALSE; break; diff --git a/src/pan-view/pan-view.c b/src/pan-view/pan-view.c index a75424d0..db70b65e 100644 --- a/src/pan-view/pan-view.c +++ b/src/pan-view/pan-view.c @@ -1298,6 +1298,9 @@ static gboolean pan_window_key_press_cb(GtkWidget *widget, GdkEventKey *event, g case '/': pan_search_toggle_visible(pw, TRUE); break; + case GDK_KEY_F1: + help_window_show("GuideReferenceKeyboardShortcuts.html#PanViewKeyboardShortcuts"); + break; default: stop_signal = FALSE; break; diff --git a/src/search.c b/src/search.c index b273759b..d45c123d 100644 --- a/src/search.c +++ b/src/search.c @@ -1305,6 +1305,9 @@ static gboolean search_result_keypress_cb(GtkWidget *widget, GdkEventKey *event, search_result_menu_pos_cb, sd, 0, GDK_CURRENT_TIME); } break; + case GDK_KEY_F1: + help_window_show("GuideReferenceKeyboardShortcuts.html#SearchKeyboardShortcuts"); + break; default: stop_signal = FALSE; break; -- 2.20.1