Move (and update) image pane shortcuts to a table. Simplify css styles for those...
[geeqie.git] / doc / collections.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
8
9   <title>Collections - Geeqie User Manual</title>
10   <link rel="stylesheet" type="text/css" href="style.css" media="all" />
11   <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
12   <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
13 </head>
14
15 <body lang="en-US" dir="ltr">
16   <div class="navtop">
17     <table width="100%" border="0" cellpadding="4" cellspacing="0">
18       <col id="navtop_col1" width="33%"></col>
19       <col id="navtop_col2" width="33%"></col>
20       <col id="navtop_col3" width="33%"></col>
21
22         <tr>
23           <th>
24             <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
25             </p>
26           </th>
27
28           <th>
29             <p class="navtop_title">Collections</p>
30           </th>
31
32           <th>
33             <p class="next"><a href="sidebars.html">Next</a>
34             </p>
35           </th>
36         </tr>
37     </table>
38   </div>
39
40   <hr />
41
42   <h1>Collections</h1>
43
44   <p>Geeqie provides the ability to build lists of images, regardless of the location of the files on disk.</p>
45
46   <h2>The collection window</h2>
47  
48   <p>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.</p>
49
50   <p>To open a new empty collection window press C or select New collection from the file menu.</p>
51
52   <p>To open an existing collection, press O or select Open collection from the file menu. 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.</p>
53
54   <p>The collection window consists of a pane to display the contents of the collection, and a status bar along the bottom of the window.</p>
55
56   <h3>Icon pane</h3>
57
58   <p>The icon pane displays images contained in the collection as thumbnails in a grid, by default the file names also appear below each thumbnail.</p>
59
60   <p>The Icon pane works exactly like the Icon view mode of the <a href="main_window_file_pane.html">file pane</a> in a main window. But with the addition that the contents of the collection can be organized with drag and drop.</p>
61
62   <p>A <b>context menu</b> is available for the icon pane by right clicking the mouse or pressing the Menu key.</p>
63
64   <p><b>Keyboard shortcuts</b> available in the collection window:</p>
65
66   <div class="shortcuts">
67     <table width="80%" border="1" cellpadding="2" cellspacing="0">
68       <col width="25%"></col>
69       <col width="25%"></col>
70       <col width="50%"></col>
71
72       <thead>
73       <tr>
74         <th>
75           <p>Shortcut</p>
76         </th>
77
78         <th>
79           <p>Context menu name</p>
80         </th>
81
82         <th>
83           <p>Description</p>
84         </th>
85       </tr>
86       </thead>
87
88       <tr>
89         <td>
90           <p>Enter</p>
91         </td>
92
93         <td>
94           <p>View</p>
95         </td>
96
97         <td>
98           <p>Opens selected image in main window.</p>
99         </td>
100       </tr>
101
102       <tr>
103         <td>
104           <p>V</p>
105         </td>
106
107         <td>
108           <p>View in new window</p>
109         </td>
110
111         <td>
112           <p>Opens selected image in a new window.</p>
113         </td>
114       </tr>
115
116       <tr>
117         <td>
118           <p>Control + A</p>
119         </td>
120
121         <td>
122           <p>Select all</p>
123         </td>
124
125         <td>
126           <p>Selects all images.</p>
127         </td>
128       </tr>
129
130       <tr>
131         <td>
132           <p>Control + Shift + A</p>
133         </td>
134
135         <td>
136           <p>Select none</p>
137         </td>
138
139         <td>
140           <p>Clear the image selection.</p>
141         </td>
142       </tr>
143
144       <tr>
145         <td>
146           <p>Control + 1 through<br />
147           Control + 0</p>
148         </td>
149
150         <td>
151           <p>Edit sub menu</p>
152         </td>
153
154         <td>
155           <p>Executes the respective editor command.</p>
156         </td>
157       </tr>
158
159       <tr>
160         <td>
161           <p>Control + P</p>
162         </td>
163
164         <td>
165           <p>Properties</p>
166         </td>
167
168         <td>
169           <p>Opens a properties window for selected images.</p>
170         </td>
171       </tr>
172
173       <tr>
174         <td>
175           <p>Control + C</p>
176         </td>
177
178         <td>
179           <p>Copy</p>
180         </td>
181
182         <td>
183           <p>Copy selected images.</p>
184         </td>
185       </tr>
186
187       <tr>
188         <td>
189           <p>Control + M</p>
190         </td>
191
192         <td>
193           <p>Move</p>
194         </td>
195
196         <td>
197           <p>Move selected images.</p>
198         </td>
199       </tr>
200
201       <tr>
202         <td>
203           <p>Control + R</p>
204         </td>
205
206         <td>
207           <p>Rename</p>
208         </td>
209
210         <td>
211           <p>Rename selected images.</p>
212         </td>
213       </tr>
214
215       <tr>
216         <td>
217           <p>Control + D</p>
218         </td>
219
220         <td>
221           <p>Delete</p>
222         </td>
223
224         <td>
225           <p>Delete selected images.</p>
226         </td>
227       </tr>
228
229       <tr>
230         <td>
231           <p>Delete</p>
232         </td>
233
234         <td>
235           <p>Remove</p>
236         </td>
237
238         <td>
239           <p>Remove selected images from result list.</p>
240         </td>
241       </tr>
242
243       <tr>
244         <td>
245           <p>Control + L</p>
246         </td>
247
248         <td>
249           <p>Append from file list</p>
250         </td>
251
252         <td>
253           <p>Add contents of main window to collection.</p>
254         </td>
255       </tr>
256
257       <tr>
258         <td>
259           <p>A</p>
260         </td>
261
262         <td>
263           <p>Append from collection</p>
264         </td>
265
266         <td>
267           <p>Append contents of another collection from a file.</p>
268         </td>
269       </tr>
270
271       <tr>
272         <td>
273           <p>S</p>
274         </td>
275
276         <td>
277           <p>Save collection</p>
278         </td>
279
280         <td>
281           <p>Save collection to disk, if the collection is new a dialog will appear to select the file name and location.</p>
282         </td>
283       </tr>
284
285       <tr>
286         <td>
287           <p>Control + S</p>
288         </td>
289
290         <td>
291           <p>Save collection as</p>
292         </td>
293
294         <td>
295           <p>Opens a dialog to select a new file name to use for the collection.</p>
296         </td>
297       </tr>
298
299       <tr>
300         <td>
301           <p>Control + T</p>
302         </td>
303
304         <td>
305           <p>Show filename text</p>
306         </td>
307
308         <td>
309           <p>Toggle display of text below icons. When set, icon's tooltip will show the full path to the file.</p>
310         </td>
311       </tr>
312
313       <tr>
314         <td>
315           <p>Menu</p>
316         </td>
317
318         <td>&nbsp;</td>
319
320         <td>
321           <p>Displays the context menu.</p>
322         </td>
323       </tr>
324
325       <tr>
326         <td>
327           <p>N</p>
328         </td>
329
330         <td>
331           <p>Sort by name</p>
332         </td>
333
334         <td>
335           <p>Sort collection by file name.</p>
336         </td>
337       </tr>
338
339       <tr>
340         <td>
341           <p>I</p>
342         </td>
343
344         <td>
345           <p>Sort by number</p>
346         </td>
347
348         <td>
349           <p>Sort collection by file name, using natural numerical order</p>
350         </td>
351       </tr>
352
353       <tr>
354         <td>
355           <p>D</p>
356         </td>
357
358         <td>
359           <p>Sort by date</p>
360         </td>
361
362         <td>
363           <p>Sort collection by file date.</p>
364         </td>
365       </tr>
366
367       <tr>
368         <td>
369           <p>B</p>
370         </td>
371
372         <td>
373           <p>Sort by size</p>
374         </td>
375
376         <td>
377           <p>Sort collection by file size.</p>
378         </td>
379       </tr>
380
381       <tr>
382         <td>
383           <p>P</p>
384         </td>
385
386         <td>
387           <p>Sort by path</p>
388         </td>
389
390         <td>
391           <p>Sort collection by file location (path to file).</p>
392         </td>
393       </tr>
394
395       <tr>
396         <td>&nbsp;</td>
397
398         <td>
399           <p>Print</p>
400         </td>
401
402         <td>
403           <p>Opens a print dialog for selected images.</p>
404         </td>
405       </tr>
406
407       <tr>
408         <td>
409           <p>Control + W</p>
410         </td>
411
412         <td>&nbsp;</td>
413
414         <td>
415           <p>Close window.</p>
416         </td>
417       </tr>
418     </table>
419   </div>
420
421   <p>The <b>selection</b> can be changed using the keyboard and mouse the same as in a <a href="main_window_file_pane.html">file pane</a> of the main window.</p>
422
423   <h3>Status bar</h3>
424
425   <p>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.</p>
426
427   <h3>Drag and Drop</h3>
428
429   <p>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.</p>
430
431   <p>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.</p>
432
433   <p>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.</p>
434
435   <p class="note"><span class="note_label">Note:</span> When renaming or moving files within Geeqie, the contents of collections located in the folder ($HOME)/.geeqie/collections will automatically update to the new name or location.</p>
436
437   <hr id="bottomseparator" />
438
439   <div class="navbottom">
440     <table width="100%" border="0" cellpadding="4" cellspacing="0">
441       <col id="navbottom_col1" width="33%"></col>
442       <col id="navbottom_col2" width="33%"></col>
443       <col id="navbottom_col3" width="33%"></col>
444
445         <tr>
446           <th>
447             <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
448             </p>
449           </th>
450
451           <th>
452             <p class="navbottom_title"><a href="index.html">Contents</a>
453             </p>
454           </th>
455
456           <th>
457             <p class="next"><a href="sidebars.html">Next</a>
458             </p>
459           </th>
460         </tr>
461
462     </table>
463   </div>
464
465   <div class="footer">Geeqie User Manual</div>
466   <div class="bottomspacer">&nbsp;</div>
467 </body>
468 </html>