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