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