Align Previous to the left, drop useless col tags.
[geeqie.git] / doc / collections.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2
3 <html xmlns="http://www.w3.org/1999/xhtml">
4 <head>
5   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
6
7   <title>Collections - Geeqie User Manual</title>
8 <style type="text/css">
9 /*<![CDATA[*/
10  p.previous {text-align: left}
11  p.gq-collections-9 {margin-bottom: 0in}
12  p.gq-collections-8 {font-weight: bold; text-align: center}
13  p.gq-collections-7 {margin-left: 0.79in}
14  p.gq-collections-6 {font-family: Albany, sans-serif; margin-top: 0.17in; page-break-after: avoid}
15  span.gq-collections-5 {font-size: 120%}
16  div.gq-collections-4 {text-align: center}
17  table.gq-collections-3 {page-break-before: always}
18  p.gq-collections-2 {text-align: right}
19  p.gq-collections-1 {text-align: center}
20 /*]]>*/
21 </style>
22 </head>
23
24 <body lang="en-US" dir="ltr">
25   <div class="gq-collections-4">
26     <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-collections-3">
27
28       <thead>
29         <tr valign="top">
30           <td width="33%">
31             <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
32             </p>
33           </td>
34
35           <td width="33%">
36             <p class="gq-collections-1">Collections</p>
37           </td>
38
39           <td width="33%">
40             <p class="gq-collections-2"><a href="sidebars.html">Next</a>
41             </p>
42           </td>
43         </tr>
44       </thead>
45     </table>
46   </div>
47
48   <hr />
49
50   <h1>Collections</h1>
51
52   <p>Geeqie provides the ability to build lists of images, regardless of the location of the files on disk.</p>
53
54   <p><br />
55   <br />
56   </p>
57
58   <p class="gq-collections-6"><span class="gq-collections-5">The collection window</span>
59   </p>
60
61   <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>
62
63   <p>To open a new empty collection window press C or select New collection from the file menu.</p>
64
65   <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>
66
67   <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>
68
69   <p><u>Icon pane</u>
70   </p>
71
72   <p class="gq-collections-7">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>
73
74   <p class="gq-collections-7">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>
75
76   <p class="gq-collections-7">A <b>context menu</b> is available for the icon pane by right clicking the mouse or pressing the Menu key.</p>
77
78   <p class="gq-collections-7"><b>Keyboard shortcuts</b> available in the collection window:</p>
79
80   <div class="gq-collections-4">
81     <table width="80%" border="1" cellpadding="2" cellspacing="0">
82
83       <tr valign="top">
84         <td width="25%">
85           <p class="gq-collections-8">Shortcut</p>
86         </td>
87
88         <td width="25%">
89           <p class="gq-collections-8">Context menu name</p>
90         </td>
91
92         <td width="50%">
93           <p class="gq-collections-8">Description</p>
94         </td>
95       </tr>
96
97       <tr valign="top">
98         <td width="25%">
99           <p class="gq-collections-1">Enter</p>
100         </td>
101
102         <td width="25%">
103           <p class="gq-collections-1">View</p>
104         </td>
105
106         <td width="50%">
107           <p class="gq-collections-1">Opens selected image in main window.</p>
108         </td>
109       </tr>
110
111       <tr valign="top">
112         <td width="25%">
113           <p class="gq-collections-1">V</p>
114         </td>
115
116         <td width="25%">
117           <p class="gq-collections-1">View in new window</p>
118         </td>
119
120         <td width="50%">
121           <p class="gq-collections-1">Opens selected image in a new window.</p>
122         </td>
123       </tr>
124
125       <tr valign="top">
126         <td width="25%">
127           <p class="gq-collections-1">Control + A</p>
128         </td>
129
130         <td width="25%">
131           <p class="gq-collections-1">Select all</p>
132         </td>
133
134         <td width="50%">
135           <p class="gq-collections-1">Selects all images.</p>
136         </td>
137       </tr>
138
139       <tr valign="top">
140         <td width="25%">
141           <p class="gq-collections-1">Control + Shift + A</p>
142         </td>
143
144         <td width="25%">
145           <p class="gq-collections-1">Select none</p>
146         </td>
147
148         <td width="50%">
149           <p class="gq-collections-1">Clear the image selection.</p>
150         </td>
151       </tr>
152
153       <tr valign="top">
154         <td width="25%">
155           <p class="gq-collections-1">Control + 1 through<br />
156           Control + 0</p>
157         </td>
158
159         <td width="25%">
160           <p class="gq-collections-1">Edit sub menu</p>
161         </td>
162
163         <td width="50%">
164           <p class="gq-collections-1">Executes the respective editor command.</p>
165         </td>
166       </tr>
167
168       <tr valign="top">
169         <td width="25%">
170           <p class="gq-collections-1">Control + P</p>
171         </td>
172
173         <td width="25%">
174           <p class="gq-collections-1">Properties</p>
175         </td>
176
177         <td width="50%">
178           <p class="gq-collections-1">Opens a properties window for selected images.</p>
179         </td>
180       </tr>
181
182       <tr valign="top">
183         <td width="25%">
184           <p class="gq-collections-1">Control + C</p>
185         </td>
186
187         <td width="25%">
188           <p class="gq-collections-1">Copy</p>
189         </td>
190
191         <td width="50%">
192           <p class="gq-collections-1">Copy selected images.</p>
193         </td>
194       </tr>
195
196       <tr valign="top">
197         <td width="25%">
198           <p class="gq-collections-1">Control + M</p>
199         </td>
200
201         <td width="25%">
202           <p class="gq-collections-1">Move</p>
203         </td>
204
205         <td width="50%">
206           <p class="gq-collections-1">Move selected images.</p>
207         </td>
208       </tr>
209
210       <tr valign="top">
211         <td width="25%">
212           <p class="gq-collections-1">Control + R</p>
213         </td>
214
215         <td width="25%">
216           <p class="gq-collections-1">Rename</p>
217         </td>
218
219         <td width="50%">
220           <p class="gq-collections-1">Rename selected images.</p>
221         </td>
222       </tr>
223
224       <tr valign="top">
225         <td width="25%">
226           <p class="gq-collections-1">Control + D</p>
227         </td>
228
229         <td width="25%">
230           <p class="gq-collections-1">Delete</p>
231         </td>
232
233         <td width="50%">
234           <p class="gq-collections-1">Delete selected images.</p>
235         </td>
236       </tr>
237
238       <tr valign="top">
239         <td width="25%">
240           <p class="gq-collections-1">Delete</p>
241         </td>
242
243         <td width="25%">
244           <p class="gq-collections-1">Remove</p>
245         </td>
246
247         <td width="50%">
248           <p class="gq-collections-1">Remove selected images from result list.</p>
249         </td>
250       </tr>
251
252       <tr valign="top">
253         <td width="25%">
254           <p class="gq-collections-1">Control + L</p>
255         </td>
256
257         <td width="25%">
258           <p class="gq-collections-1">Append from file list</p>
259         </td>
260
261         <td width="50%">
262           <p class="gq-collections-1">Add contents of main window to collection.</p>
263         </td>
264       </tr>
265
266       <tr valign="top">
267         <td width="25%">
268           <p class="gq-collections-1">A</p>
269         </td>
270
271         <td width="25%">
272           <p class="gq-collections-1">Append from collection</p>
273         </td>
274
275         <td width="50%">
276           <p class="gq-collections-1">Append contents of another collection from a file.</p>
277         </td>
278       </tr>
279
280       <tr valign="top">
281         <td width="25%">
282           <p class="gq-collections-1">S</p>
283         </td>
284
285         <td width="25%">
286           <p class="gq-collections-1">Save collection</p>
287         </td>
288
289         <td width="50%">
290           <p class="gq-collections-1">Save collection to disk, if the collection is new a dialog will appear to select the file name and location.</p>
291         </td>
292       </tr>
293
294       <tr valign="top">
295         <td width="25%">
296           <p class="gq-collections-1">Control + S</p>
297         </td>
298
299         <td width="25%">
300           <p class="gq-collections-1">Save collection as</p>
301         </td>
302
303         <td width="50%">
304           <p class="gq-collections-1">Opens a dialog to select a new file name to use for the collection.</p>
305         </td>
306       </tr>
307
308       <tr valign="top">
309         <td width="25%">
310           <p class="gq-collections-1">Control + T</p>
311         </td>
312
313         <td width="25%">
314           <p class="gq-collections-1">Show filename text</p>
315         </td>
316
317         <td width="50%">
318           <p class="gq-collections-1">Toggle display of text below icons.</p>
319         </td>
320       </tr>
321
322       <tr valign="top">
323         <td width="25%">
324           <p class="gq-collections-1">Menu</p>
325         </td>
326
327         <td width="25%">
328           <p class="gq-collections-1"><br />
329           </p>
330         </td>
331
332         <td width="50%">
333           <p class="gq-collections-1">Displays the context menu.</p>
334         </td>
335       </tr>
336
337       <tr valign="top">
338         <td width="25%">
339           <p class="gq-collections-1">N</p>
340         </td>
341
342         <td width="25%">
343           <p class="gq-collections-1">Sort by name</p>
344         </td>
345
346         <td width="50%">
347           <p class="gq-collections-1">Sort collection by file name.</p>
348         </td>
349       </tr>
350
351       <tr valign="top">
352         <td width="25%">
353           <p class="gq-collections-1">I</p>
354         </td>
355
356         <td width="25%">
357           <p class="gq-collections-1">Sort by number</p>
358         </td>
359
360         <td width="50%">
361           <p class="gq-collections-1">Sort collection by file name, using natural numerical order</p>
362         </td>
363       </tr>
364
365       <tr valign="top">
366         <td width="25%">
367           <p class="gq-collections-1">D</p>
368         </td>
369
370         <td width="25%">
371           <p class="gq-collections-1">Sort by date</p>
372         </td>
373
374         <td width="50%">
375           <p class="gq-collections-1">Sort collection by file date.</p>
376         </td>
377       </tr>
378
379       <tr valign="top">
380         <td width="25%">
381           <p class="gq-collections-1">B</p>
382         </td>
383
384         <td width="25%">
385           <p class="gq-collections-1">Sort by size</p>
386         </td>
387
388         <td width="50%">
389           <p class="gq-collections-1">Sort collection by file size.</p>
390         </td>
391       </tr>
392
393       <tr valign="top">
394         <td width="25%">
395           <p class="gq-collections-1">P</p>
396         </td>
397
398         <td width="25%">
399           <p class="gq-collections-1">Sort by path</p>
400         </td>
401
402         <td width="50%">
403           <p class="gq-collections-1">Sort collection by file location (path to file).</p>
404         </td>
405       </tr>
406
407       <tr valign="top">
408         <td width="25%">
409           <p class="gq-collections-1"><br />
410           </p>
411         </td>
412
413         <td width="25%">
414           <p class="gq-collections-1">Print</p>
415         </td>
416
417         <td width="50%">
418           <p class="gq-collections-1">Opens a print dialog for selected images.</p>
419         </td>
420       </tr>
421
422       <tr valign="top">
423         <td width="25%">
424           <p class="gq-collections-1">Control + W</p>
425         </td>
426
427         <td width="25%">
428           <p class="gq-collections-1"><br />
429           </p>
430         </td>
431
432         <td width="50%">
433           <p class="gq-collections-1">Close window.</p>
434         </td>
435       </tr>
436     </table>
437   </div>
438
439   <p><br />
440   <br />
441   </p>
442
443   <p class="gq-collections-7">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>
444
445   <p><br />
446   <br />
447   </p>
448
449   <p><u>Status bar</u>
450   </p>
451
452   <p class="gq-collections-7">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>
453
454   <p><br />
455   <br />
456   </p>
457
458   <p><u>Drag and Drop</u>
459   </p>
460
461   <p class="gq-collections-7">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>
462
463   <p class="gq-collections-7">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>
464
465   <p class="gq-collections-7">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>
466
467   <p><br />
468   <br />
469   </p>
470
471   <p>Note: 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>
472
473   <p><br />
474   <br />
475   </p>
476
477   <hr />
478
479   <div class="gq-collections-4">
480     <table width="100%" border="0" cellpadding="4" cellspacing="0">
481
482       <thead>
483         <tr valign="top">
484           <td width="33%">
485             <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
486             </p>
487           </td>
488
489           <td width="33%">
490             <p class="gq-collections-1"><a href="index.html">Contents</a>
491             </p>
492           </td>
493
494           <td width="33%">
495             <p class="gq-collections-2"><a href="sidebars.html">Next</a>
496             </p>
497           </td>
498         </tr>
499       </thead>
500
501       <tbody>
502         <tr valign="top">
503           <td width="33%">
504             <p><br />
505             </p>
506           </td>
507
508           <td width="33%">
509             <p class="gq-collections-1"><br />
510             </p>
511           </td>
512
513           <td width="33%">
514             <p class="gq-collections-2">Geeqie User Manual</p>
515           </td>
516         </tr>
517       </tbody>
518     </table>
519   </div>
520
521   <p class="gq-collections-9"><br />
522   </p>
523 </body>
524 </html>