Update web help file and other docs
[geeqie.git] / web / help / GuideCollections.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>Collections</title>
6 <link rel="previous" href="GuideOtherWindowsPanView.html" title="Pan View">
7 <link rel="next" href="GuideImageSearch.html" title="Search and Select">
8 <link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
9 <style type="text/css">
10
11 html { height: 100%; }
12 body {
13   margin: 0px; padding: 12px;
14   background-color: #f9f9f6;
15   min-height: 100%;
16   direction: ltr;
17 }
18 div, p, pre, blockquote { margin: 0; padding: 0; }
19 p img { vertical-align: middle; }
20 sub { font-size: 0.83em; }
21 sub sub { font-size: 1em; }
22 sup { font-size: 0.83em; }
23 sup sup { font-size: 1em; }
24 table { border-collapse: collapse; }
25 table.table-pgwide { width: 100%; }
26 td { vertical-align: top; }
27 td { padding: 0.2em 0.83em 0.2em 0.83em; }
28 th { padding: 0 0.83em 0 0.83em; }
29 tr.tr-shade {
30   background-color: #f9f9f6;
31 }
32 td.td-colsep { border-right: solid 1px; }
33 td.td-rowsep { border-bottom: solid 1px; }
34 thead { border-top: solid 2px; border-bottom: solid 2px; }
35 tfoot { border-top: solid 2px; border-bottom: solid 2px; }
36 div.body {
37   padding: 1em;
38   max-width: 60em;
39   background-color: #ffffff;
40   border: solid 1px #e0e0df;
41 }
42 div.body-sidebar {
43   margin-right: 13em;
44 }
45 div.division div.division { margin-top: 1.72em; }
46 div.division div.division div.division { margin-top: 1.44em; }
47 div.header {
48   margin: 0;
49   color: #3f3f3f;
50   border-bottom: solid 1px #e0e0df;
51 }
52 h1, h2, h3, h4, h5, h6, h7 {
53   margin: 0; padding: 0;
54   color: #3f3f3f;
55 }
56 h1.title { font-size: 1.72em; }
57 h2.title { font-size: 1.44em; }
58 h3.title { font-size: 1.2em; }
59 h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
60 .block { margin-top: 1em; }
61 .block .block-first { margin-top: 0; }
62 .block-indent {
63   margin-left left: 1.72em;
64   margin-: 1em;
65 }
66 .block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
67 td .block-indent  { margin-left: 0em; margin-right: 0em; }
68 dd .block-indent  { margin-left: 0em; margin-right: 0em; }
69 .block-verbatim { white-space: pre; }
70 div.title {
71   margin-bottom: 0.2em;
72   font-weight: bold;
73   color: #3f3f3f;
74 }
75 div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
76 div.title-formal .label { font-weight: normal; }
77 a {
78   color: #1f609f;
79   text-decoration: none;
80 }
81 a:hover { text-decoration: underline; }
82 a:visited { color: #9f1f6f; }
83 ul, ol, dl { margin: 0; padding: 0; }
84 li {
85   margin-top: 1em;
86   margin-left: 2.4em;
87   padding: 0;
88 }
89 li.li-first { margin-top: 0; }
90 dt { margin: 1em 0 0 0; }
91 dt.dt-first { margin: 0; }
92 dd {
93   margin-left: 1.72em;
94   margin-top: 0.5em;
95 }
96 dl.dl-compact dt { margin-top: 0; }
97 dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }
98
99
100 ul.linktrail {
101   display: block;
102   margin: 0.2em 0 0 0;
103   text-align: right;
104 }
105 li.linktrail { display: inline; margin: 0; padding: 0; }
106
107 li.linktrail::before {
108   content: '  /  ';
109   color: #3f3f3f;
110 }
111
112 li.linktrail-first::before, li.linktrail-only::before { content: ''; }
113
114
115 div.navbar {
116   padding: 0.5em 1em 0.5em 1em;
117   max-width: 60em;
118   background-color: #ffffff;
119   border: solid 1px #e0e0df;
120 }
121 div.navbar-top { margin-bottom: 1em; }
122 div.navbar-bottom { margin-top: 1em; clear: both; }
123 div.navbar img { border: 0; vertical-align: -0.4em; }
124 table.navbar { width: 100%; margin: 0; border: none; }
125 table.navbar td { padding: 0; border: none; }
126 td.navbar-next {
127   text-align: right;
128 }
129 a.navbar-prev::before {
130   
131   content: '◀  ';
132   color: #3f3f3f;
133 }
134 a.navbar-next::after {
135   
136   content: '  ▶';
137   color: #3f3f3f;
138 }
139
140
141 div.sidebar {
142   float: right;
143   padding: 0; margin: 0; width: 12em;
144 }
145 div.sidenav {
146   padding: 0.5em 1em 0 1em;
147   background-color: #ffffff;
148   border: solid 1px #e0e0df;
149 }
150 div.sidenav div.autotoc {
151   background-color: #ffffff;
152   border: none; padding: 0; margin: 0;
153 }
154 div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
155 div.sidenav div.autotoc li { margin-bottom: 0.5em; }
156 div.sidenav div.autotoc div.autotoc div.autotoc {
157   margin-left: 1em;
158   margin-top: 0;
159 }
160 div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }
161
162
163 div.autotoc {
164   
165   display: table;
166   margin-top: 1em;
167   margin-left: 1.72em;
168   padding: 0.5em 1em 0.5em 1em;
169   background-color: #f0f9ff;
170   border: solid 1px #c0c9ff;
171 }
172 div.autotoc ul { margin: 0; padding: 0; }
173 div.autotoc li { list-style-type: none; margin: 0; }
174 div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
175 div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
176 div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }
177
178
179 span.bibliolabel {
180   color: #3f3f3f;
181 }
182
183
184 div.admonition {
185   padding: 0.5em 6px 0.5em 6px;
186   border: solid 1px #e0e0df;
187   background-color: #fffff0;
188 }
189 div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
190   padding-left: 60px;
191   background-position: left top;
192   background-repeat: no-repeat;
193   min-height: 48px;
194 }
195 div.caution-inner { background-image: url("admon-caution.png"); }
196 div.important-inner { background-image: url("admon-important.png"); }
197 div.note-inner { background-image: url("admon-note.png"); }
198 div.note-bug div.note-inner { background-image: url("admon-bug.png"); }
199 div.tip-inner { background-image: url("admon-tip.png"); }
200 div.warning-inner { background-image: url("admon-warning.png"); }
201 div.blockquote {
202   
203   background-image: url('watermark-blockquote-201C.png');
204   background-repeat: no-repeat;
205   background-position: top left;
206   padding: 0.5em;
207   padding-left: 4em;
208 }
209 div.attribution {
210   margin-top: 0.5em;
211   color: #3f3f3f;
212 }
213 div.attribution::before {
214   
215   content: '― ';
216 }
217 div.epigraph {
218   text-align: right;
219   margin-left: 20%;
220   margin-right: 0;
221   color: #3f3f3f;
222 }
223 div.figure, div.informalfigure {
224   
225   display: table;
226   padding: 0.5em;
227   background-color: #f9f9f6;
228   border: solid 1px #e0e0df;
229 }
230 div.figure-inner, div.informalfigure-inner {
231   padding: 0.5em;
232   background-color: #ffffff;
233   border: solid 1px #e0e0df;
234 }
235 div.caption { margin-top: 0.5em; }
236 div.programlisting {
237   padding: 0.5em;
238   
239   background-color: #f9f9f6;
240   border: solid 1px #e0e0df;
241 }
242 div.screen {
243   padding: 0.5em;
244   
245   background-color: #f9f9f6;
246   border: solid 1px #e0e0df;
247 }
248 div.screen .prompt {
249   color: #3f3f3f;
250 }
251 div.screen .userinput {
252   font-weight: bold;
253   color: #3f3f3f;
254 }
255 div.programlisting .userinput {
256   font-weight: bold;
257   color: #3f3f3f;
258 }
259 pre.linenumbering {
260   color: #3f3f3f;
261   margin: 0;
262   padding-right: 1em;
263   float: left;
264   text-align: right;
265 }
266
267
268
269 dl.index dt { margin-top: 0; }
270 dl.index dd { margin-top: 0; margin-bottom: 0; }
271 dl.indexdiv dt { margin-top: 0; }
272 dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
273 dl.setindex dt { margin-top: 0; }
274 dl.setindex dd { margin-top: 0; margin-bottom: 0; }
275 div.list div.title-formal span.title {
276   border-bottom: solid 1px #e0e0df;
277 }
278 div.simplelist {
279   margin-left: 1.72em;
280 }
281 div.simplelist table { margin-left: 0; border: none; }
282 div.simplelist td {
283   padding: 0.5em;
284   border-left: solid 1px #e0e0df;
285 }
286 div.simplelist td.td-first {
287   padding-left: 0;
288   border-left: 0;
289 }
290 div.synopsis {
291   padding: 0.5em;
292   
293   background-color: #f9f9f6;
294   border-top: solid 2px #c0c9ff;
295   border-bottom: solid 2px #c0c9ff;
296 }
297 div.synopsis div.synopsis {
298   padding: 0;
299   border: none;
300 }
301 div.synopsis div.block { margin-top: 0.2em; }
302 div.synopsis div.block-first { margin-top: 0; }
303 div.cmdsynopsis { font-family: monospace; }
304
305 span.accel { text-decoration: underline; }
306 span.acronym { font-family: sans-serif; }
307 span.application { font-style: italic; }
308 span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
309 span.code {
310   font-family: monospace;
311   border: solid 1px #e0e0df;
312   padding-left: 0.2em;
313   padding-right: 0.2em;
314 }
315 pre span.code { border: none; padding: 0; }
316 span.command {
317   font-family: monospace;
318   border: solid 1px #e0e0df;
319   padding-left: 0.2em;
320   padding-right: 0.2em;
321 }
322 pre span.command { border: none; padding: 0; }
323 span.computeroutput { font-family: monospace; }
324
325 span.constant { font-family: monospace; }
326 span.database { font-family: monospace; }
327 span.email { font-family: monospace; }
328 span.emphasis { font-style: italic; }
329 span.emphasis-bold { font-style: normal; font-weight: bold; }
330 span.envar { font-family: monospace; }
331
332 span.filename { font-family: monospace; }
333 span.firstterm { font-style: italic; }
334 span.foreignphrase { font-style: italic; }
335 span.function { font-family: monospace; }
336
337 dt.glossterm span.glossterm { font-style: normal; }
338
339
340 span.glossterm { font-style: italic; }
341
342 span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
343   font-weight: bold;
344   color: #3f3f3f;
345 }
346 span.keycap {
347   font-weight: bold;
348   color: #3f3f3f;
349 }
350 span.lineannotation { font-style: italic; }
351 span.literal { font-family: monospace; }
352 span.markup  { font-family: monospace; }
353 span.medialabel { font-style: italic; }
354 span.methodname { font-family: monospace; }
355 span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
356 span.option { font-family: monospace; }
357 span.parameter { font-family: monospace; }
358 span.paramdef span.parameter { font-style: italic; }
359 span.prompt { font-family: monospace; }
360 span.property { font-family: monospace; }
361 span.replaceable  { font-style: italic; }
362 span.returnvalue { font-family: monospace; }
363 span.sgmltag { font-family: monospace; }
364 span.structfield, span.structname { font-family: monospace; }
365 span.symbol { font-family: monospace; }
366 span.systemitem { font-family: monospace; }
367 span.token { font-family: monospace; }
368 span.type { font-family: monospace; }
369 span.uri { font-family: monospace; }
370 span.userinput { font-family: monospace; }
371 span.varname { font-family: monospace; }
372 span.wordasword { font-style: italic; }
373
374
375
376 div.footnotes { font-style: italic; font-size: 0.8em; }
377 div.footnote { margin-top: 1.44em; }
378 span.footnote-number { display: inline; padding-right: 0.83em; }
379 span.footnote-number + p { display: inline; }
380 a.footnote { text-decoration: none; font-size: 0.8em; }
381 a.footnote-ref { text-decoration: none; }
382
383 span.co {
384   margin-left: 0.2em; margin-right: 0.2em;
385   padding-left: 0.4em; padding-right: 0.4em;
386   border: solid 1px #000000;
387   -moz-border-radius: 8px;
388   background-color: #000000;
389   color: #FFFFFF;
390   font-size: 8px;
391 }
392 span.co:hover {
393   border-color: #333333;
394   background-color: #333333;
395   color: #FFFFFF;
396 }
397 span.co a { text-decoration: none; }
398 span.co a:hover { text-decoration: none; }
399
400 dt.question { margin-left: 0em; }
401 dt.question div.label { float: left; }
402 dd + dt.question { margin-top: 1em; }
403 dd.answer {
404   margin-top: 1em;
405   margin-left: 2em;
406   margin-right: 1em;
407 }
408 dd.answer div.label { float: left; }
409 </style>
410 </head>
411 <body>
412 <div class="navbar navbar-top"><table class="navbar"><tr>
413 <td class="navbar-prev"><a class="navbar-prev" href="GuideOtherWindowsPanView.html" title="Pan View">Pan View</a></td>
414 <td class="navbar-next"><a class="navbar-next" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></td>
415 </tr></table></div>
416 <div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
417 <li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
418 <li>
419 <a class="xref" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a><div class="autotoc"><ul>
420 <li><a class="xref" href="GuideIntroduction.html" title="Introduction">Introduction</a></li>
421 <li><a class="xref" href="GuideMainWindow.html" title="Main Window">Main Window</a></li>
422 <li><a class="xref" href="GuideSidebars.html" title="Sidebars">Sidebars</a></li>
423 <li>
424 <a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a><div class="autotoc"><ul>
425 <li><a class="xref" href="GuideOtherWindowsImageWindow.html" title="Image Window">Image Window</a></li>
426 <li><a class="xref" href="GuideOtherWindowsExif.html" title="Exif Window">Exif Window</a></li>
427 <li><a class="xref" href="GuideOtherWindowsPanView.html" title="Pan View">Pan View</a></li>
428 <li>Collections</li>
429 </ul></div>
430 </li>
431 <li><a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></li>
432 <li><a class="xref" href="GuideImageManagementPlugins.html" title="Plugins">Plugins</a></li>
433 <li><a class="xref" href="GuideImageManagement.html" title="File Management">File Management</a></li>
434 <li><a class="xref" href="GuideColorManagement.html" title="Color Management">Color Management</a></li>
435 <li><a class="xref" href="GuideImagePresentation.html" title="Image Presentation">Image Presentation</a></li>
436 <li><a class="xref" href="GuidePrinting.html" title="Printing">Printing</a></li>
437 <li><a class="xref" href="GuideOptionsMain.html" title="Preferences">Preferences</a></li>
438 <li><a class="xref" href="GuideOptionsAdditional.html" title="Additional Preferences">Additional Preferences</a></li>
439 <li><a class="xref" href="GuideReference.html" title="Reference">Reference</a></li>
440 <li><a class="xref" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a></li>
441 <li><a class="xref" href="GuideLicence.html" title="Licence">Licence</a></li>
442 <li><a class="xref" href="GuideCredits.html" title="Credits">Credits</a></li>
443 <li><a class="xref" href="GuideGnuFdl.html" title="GNU Free Documentation License">GNU Free Documentation License</a></li>
444 </ul></div>
445 </li>
446 </ul></div></div></div>
447 <div class="body body-sidebar"><div class="division section">
448 <a name="GuideCollections"></a><div class="header"><h1 class="section title"><span class="title"><a name="titleGuideCollections"></a>Collections</span></h1></div>
449 <ul class="linktrail">
450 <li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
451 <li class="linktrail linktrail-last"><a class="linktrail" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
452 </ul>
453 <p class="para block block-first">Geeqie provides the ability to build lists of images, regardless of the location of the files on disk.</p>
454 <p class="para block">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>
455 <p class="para block">
456     To open a new empty collection window select
457     <span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guimenuitem">New collection</span> <span class="shortcut">(
458         <span class="keycombo"><span class="keycap">C</span></span>
459       )</span></span>
460     .
461   </p>
462 <p class="para block">
463     To open an existing collection, select
464     <span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guimenuitem">Open collection</span> <span class="shortcut">(
465         <span class="keycombo"><span class="keycap">O</span></span>
466       )</span></span>
467     . 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.
468   </p>
469 <p class="para block">
470     To delete or rename a collection, select
471     <span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guimenuitem">Open collection</span> <span class="shortcut">(
472         <span class="keycombo"><span class="keycap">O</span></span>
473       )</span></span>
474     , right-click on the collection you wish to delete or rename, and then select
475     <span class="emphasis emphasis-bold">Delete</span>
476     or
477     <span class="emphasis emphasis-bold">Rename</span>
478     .
479   </p>
480 <p class="para block">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>
481 <p class="para block"></p>
482 <div class="autotoc"><ul>
483 <li>
484 <span class="label">4.4.1. </span><a class="xref" href="GuideCollections.html#Iconpane" title="Icon pane">Icon pane</a>
485 </li>
486 <li>
487 <span class="label">4.4.2. </span><a class="xref" href="GuideCollections.html#Statusbar" title="Status bar">Status bar</a>
488 </li>
489 <li>
490 <span class="label">4.4.3. </span><a class="xref" href="GuideCollections.html#DragandDrop" title="Drag and Drop">Drag and Drop</a>
491 </li>
492 <li>
493 <span class="label">4.4.4. </span><a class="xref" href="GuideCollections.html#AppendImages" title="Append Images">Append Images</a>
494 </li>
495 <li>
496 <span class="label">4.4.5. </span><a class="xref" href="GuideCollections.html#RandomizedSort" title="Randomized Sort">Randomized Sort</a>
497 </li>
498 </ul></div>
499 <div class="division section">
500 <a name="Iconpane"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">4.4.1. </span>Icon pane</span></h2></div>
501 <p class="para block block-first">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>
502 <p class="para block">
503       The Icon pane works exactly like the Icon view mode of the
504       <a class="link" href="GuideMainWindowFilePane.html" title="File Pane">File Pane</a>
505       in a main window, but with the addition that the contents of the collection can be organized with drag and drop.
506     </p>
507 <p class="para block">
508       A
509       <span class="emphasis emphasis-bold">context menu</span>
510       is available for the icon pane by right clicking the mouse or pressing the Menu key.
511     </p>
512 <p class="para block">
513       <a class="link" href="GuideReferenceKeyboardShortcuts.html" title="Keyboard and Mouse Shortcuts">Keyboard and Mouse Shortcuts</a>
514       are available in the collection window:
515     </p>
516 <p class="para block">
517       The
518       <span class="emphasis emphasis-bold">selection</span>
519       can be changed using the keyboard and mouse the same as in a
520       <a class="link" href="GuideMainWindowFilePane.html" title="File Pane">File Pane</a>
521       of the main window.
522     </p>
523 <p class="para block"></p>
524 </div>
525 <div class="division section">
526 <a name="Statusbar"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">4.4.2. </span>Status bar</span></h2></div>
527 <p class="para block block-first">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>
528 <p class="para block"></p>
529 </div>
530 <div class="division section">
531 <a name="DragandDrop"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">4.4.3. </span>Drag and Drop</span></h2></div>
532 <p class="para block block-first">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>
533 <p class="para block">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>
534 <p class="para block">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>
535 <div class="admonition block note block-indent"><div class="note-inner">
536       <p class="para block block-first">
537         When renaming or moving files within Geeqie, the contents of collections located in the
538         <a class="link" href="GuideReferenceConfig.html" title="Configuration Files and Locations">collections folder</a>
539         will automatically update to the new name or location.
540       </p>
541     </div></div>
542 <p class="para block"></p>
543 </div>
544 <div class="division section">
545 <a name="AppendImages"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">4.4.4. </span>Append Images</span></h2></div>
546 <p class="para block block-first">Right-click menu items permit images to be appended from either another collection or from the currently selected folder.</p>
547 <p class="para block"></p>
548 </div>
549 <div class="division section">
550 <a name="RandomizedSort"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">4.4.5. </span>Randomized Sort</span></h2></div>
551 <p class="para block block-first">
552       Right-click menu item
553       <span class="emphasis emphasis-bold">Sort</span>
554       , in addition to the standard sort methods, permits images to be randomly arranged.
555     </p>
556 <p class="para block"></p>
557 </div>
558 </div></div>
559 <div class="navbar navbar-bottom"><table class="navbar"><tr>
560 <td class="navbar-prev"><a class="navbar-prev" href="GuideOtherWindowsPanView.html" title="Pan View">Pan View</a></td>
561 <td class="navbar-next"><a class="navbar-next" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></td>
562 </tr></table></div>
563 </body>
564 </html>