9de07ce6373ea79a2a862c6c4120a88668affef0
[geeqie.git] / doc / reference_management.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>Cache and Data Management - 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       <thead>
19         <tr>
20           <td>
21             <p class="previous"><a href="reference_thumbnails.html">Previous</a>
22             </p>
23           </td>
24
25           <td>
26             <p class="navtop_title">Cache and Data Management &ndash; Reference</p>
27           </td>
28
29           <td>
30             <p class="next"><a href="credits.html">Next</a>
31             </p>
32           </td>
33         </tr>
34       </thead>
35     </table>
36   </div>
37
38   <hr />
39
40   <h1>Cache and Data Maintenance</h1>
41
42   <p>Thumbnails and other cached data can be maintained from the dialog accessible by selecting Thumbnail maintenance from the Edit menu of the main window.</p>
43
44   <p><br />
45   <br />
46   </p>
47
48   <h2>Geeqie thumbnail cache</h2>
49
50   <p>The utilities listed here operate on the Geeqie caching mechanism. This also includes the data cached for the <a href="image_search_search.html">search</a> and <a href="image_search_finding_duplicates.html">find duplicates</a> utilities.</p>
51
52   <dl class="dialog_desc">
53   <dt>Clean up</dt>
54   <dd><p>Removes thumbnails and data for which the source image is no longer present, or has been modified since the thumbnail was generated.</p></dd>
55
56   <dt>Clear cache</dt>
57   <dd><p>Removes all thumbnails and data stored in the user's home folder: $HOME/.geeqie/thumbnails.</p></dd>
58   </dl>
59
60   <p><br />
61   <br />
62   </p>
63
64   <h2>Shared thumbnail cache</h2>
65
66   <p>The utilities listed here operate on the shared thumbnail mechanism.</p>
67  
68   <dl class="dialog_desc">
69   <dt>Clean up</dt>
70   <dd><p>Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</p></dd>
71
72   <dt>Clear cache</dt>
73   <dd><p>Removes all thumbnails stored in the user's home folder: $HOME/.thumbnails.</p></dd>
74   </dl>
75   <p><br />
76   <br />
77   </p>
78
79   <h2>Create thumbnails</h2>
80
81   <p>This utility will render thumbnails using the current thumbnail caching mechanism, as determined in <a href="options_general.html">preferences</a>.</p>
82
83   <dl class="dialog_desc">
84
85   <dt>Render</dt>
86   <dd><p>Pre-render thumbnails for a specific folder, the utility has the following options:</p></dd>
87
88   <dt>Include subfolders</dt>
89   <dd><p>Enable to include all images contained in the subfolders of folder.</p></dd>
90
91   <dt>Store thumbnails local to source images</dt>
92   <dd><p>The generated thumbnails will be stored local to the source images, if you have the permissions to write to the folder containing the images.</p></dd>
93
94   </dl>
95
96   <p><br />
97   <br />
98   </p>
99
100   <h2>Metadata</h2>
101
102   <p>This utility operates on the data store for <a href="sidebars_keywords.html">keywords and comments</a> located in the user's home folder: $HOME/.geeqie/metadata.</p>
103
104   <dl class="dialog_desc">
105   <dt>Clean up</dt>
106   <dd><p>Removes keywords and comments for which the source image is no longer present.</p></dd>
107   </dl>
108
109   <p><br />
110   <br />
111   </p>
112
113   <h2>File locations</h2>
114
115   <p>The various file locations and their use are listed below. <i>&lt;HOME&gt;</i> refers to your home folder and <i>&lt;SOURCE&gt;</i> refers to the folder containing the image.</p>
116
117   <div class="file_locations">
118     <table width="80%" border="1" cellpadding="4" cellspacing="0">
119     <col id="file_locations_col1" width="50%"></col>
120     <col id="file_locations_col2" width="50%"></col>
121
122     <thead>
123       <tr>
124         <td>
125           <p>Folder or File name</p>
126         </td>
127
128         <td>
129           <p>Description</p>
130         </td>
131       </tr>
132     </thead>
133
134     <tbody>
135       <tr>
136         <td colspan="2" class="file_locations_subtitle">
137           <p>Thumbnails</p>
138         </td>
139       </tr>
140
141       <tr>
142         <td>
143           <p><em>&lt;HOME&gt;</em>/.thumbnails</p>
144         </td>
145
146         <td>
147           <p>Shared thumbnail cache folder.</p>
148         </td>
149       </tr>
150
151       <tr>
152         <td>
153           <p><em>&lt;HOME&gt;</em>/.geeqie/thumbnails</p>
154         </td>
155
156         <td>
157           <p>Classic Geeqie thumbnail cache folder. Also used to cache data used for the search and find duplicates utilities to increase the speed for subsequent searches.</p>
158         </td>
159       </tr>
160
161       <tr>
162         <td>
163           <p><em>&lt;SOURCE&gt;/.</em><span class="gq-management-8">thumbnails</span>
164           </p>
165         </td>
166
167         <td>
168           <p>Local thumbnail cache folder.</p>
169         </td>
170       </tr>
171
172       <tr>
173         <td colspan="2" class="file_locations_subtitle">
174           <p>Metadata (keywords and comments)</p>
175         </td>
176       </tr>
177
178       <tr>
179         <td>
180           <p><em>&lt;HOME&gt;</em>/.geeqie/metadata</p>
181         </td>
182
183         <td>
184           <p>Metadata stored in user's home folder.</p>
185         </td>
186       </tr>
187
188       <tr>
189         <td>
190           <p><em>&lt;SOURCE&gt;</em>/.metadata</p>
191         </td>
192
193         <td>
194           <p>Metadata stored local to source image. Requires option to be enabled in advanced preferences.</p>
195         </td>
196       </tr>
197
198       <tr>
199         <td colspan="2" class="file_locations_subtitle">
200           <p>Collections</p>
201         </td>
202       </tr>
203
204       <tr>
205         <td>
206           <p><em>&lt;HOME&gt;</em>/.geeqie/collections</p>
207         </td>
208
209         <td>
210           <p>Default location for Geeqie collections, collections in this folder will appear in the <a href="sidebars_sort_manager.html">sort manager</a> sidebar.</p>
211         </td>
212       </tr>
213
214       <tr>
215         <td colspan="2" class="file_locations_subtitle">
216           <p>Preferences</p>
217         </td>
218       </tr>
219
220       <tr>
221         <td>
222           <p><em>&lt;HOME&gt;</em>/.geeqie</p>
223         </td>
224
225         <td>
226           <p>Geeqie preferences folder.</p>
227         </td>
228       </tr>
229
230       <tr>
231         <td>
232           <p><em>&lt;HOME&gt;</em>/.geeqie/geeqierc</p>
233         </td>
234
235         <td>
236           <p>Geeqie preferences rc file.</p>
237         </td>
238       </tr>
239
240       <tr>
241         <td>
242           <p><em>&lt;HOME&gt;</em>/.geeqie/history</p>
243         </td>
244
245         <td>
246           <p>Historic data such as last several folders visited, bookmarks, and recently used collections. Also contains default print settings.</p>
247         </td>
248       </tr>
249
250       <tr>
251         <td>
252           <p><em>&lt;HOME&gt;</em>/.geeqie/accels</p>
253         </td>
254
255         <td>
256           <p>Keyboard shortcut mapping.</p>
257         </td>
258       </tr>
259
260       <tr>
261         <td colspan="2" class="file_locations_subtitle">
262           <p>Safe Delete</p>
263         </td>
264       </tr>
265
266       <tr>
267         <td>
268           <p><em>&lt;HOME&gt;</em>/.geeqie/trash</p>
269         </td>
270
271         <td>
272           <p>Default location of the safe delete folder.</p>
273         </td>
274       </tr>
275      </tbody>
276     </table>
277   </div>
278
279   <p><br />
280   <br />
281   </p>
282
283   <p><br />
284   <br />
285   </p>
286
287   <p><br />
288   <br />
289   </p>
290
291   <hr />
292
293   <div class="navbottom">
294     <table width="100%" border="0" cellpadding="4" cellspacing="0">
295       <col id="navbottom_col1" width="33%"></col>
296       <col id="navbottom_col2" width="33%"></col>
297       <col id="navbottom_col3" width="33%"></col>
298
299       <thead>
300         <tr>
301           <td>
302             <p class="previous"><a href="reference_thumbnails.html">Previous</a>
303             </p>
304           </td>
305
306           <td>
307             <p class="navbottom_title"><a href="index.html">Contents</a>
308             </p>
309           </td>
310
311           <td>
312             <p class="next"><a href="credits.html">Next</a>
313             </p>
314           </td>
315         </tr>
316       </thead>
317
318     </table>
319   </div>
320
321   <div class="footer">Geeqie User Manual</div>
322   <div class="bottomspacer">&nbsp;</div>
323 </body>
324 </html>