Reformatting.
[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   <p><b>Clean up</b>: Removes thumbnails and data for which the source image is no longer present, or has been modified since the thumbnail was generated.</p>
53
54   <p><b>Clear cache:</b> Removes all thumbnails and data stored in the user's home folder: $HOME/.geeqie/thumbnails.</p>
55
56   <p><br />
57   <br />
58   </p>
59
60   <h2>Shared thumbnail cache</h2>
61
62   <p>The utilities listed here operate on the shared thumbnail mechanism.</p>
63
64   <p><b>Clean up:</b> Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</p>
65
66   <p><b>Clear cache:</b> Removes all thumbnails stored in the user's home folder: $HOME/.thumbnails.</p>
67
68   <p><br />
69   <br />
70   </p>
71
72   <h2>Create thumbnails</h2>
73
74   <p>This utility will render thumbnails using the current thumbnail caching mechanism, as determined in <a href="options_general.html">preferences</a>.</p>
75
76   <p><b>Render:</b> Pre-render thumbnails for a specific folder, the utility has the following options:</p>
77
78   <p><b>Include subfolders:</b> Enable to include all images contained in the subfolders of folder.</p>
79
80   <p><b>Store thumbnails local to source images:</b> 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>
81
82   <p><br />
83   <br />
84   </p>
85
86   <h2>Metadata</h2>
87
88   <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>
89
90   <p><b>Clean up:</b> Removes keywords and comments for which the source image is no longer present.</p>
91
92   <p><br />
93   <br />
94   </p>
95
96   <h2>File locations</h2>
97
98   <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>
99
100   <div class="file_locations">
101     <table width="80%" border="1" cellpadding="4" cellspacing="0">
102     <col id="file_locations_col1" width="50%"></col>
103     <col id="file_locations_col2" width="50%"></col>
104
105     <thead>
106       <tr>
107         <td>
108           <p>Folder or File name</p>
109         </td>
110
111         <td>
112           <p>Description</p>
113         </td>
114       </tr>
115     </thead>
116
117     <tbody>
118       <tr>
119         <td colspan="2" class="file_locations_subtitle">
120           <p>Thumbnails</p>
121         </td>
122       </tr>
123
124       <tr>
125         <td>
126           <p><em>&lt;HOME&gt;</em>/.thumbnails</p>
127         </td>
128
129         <td>
130           <p>Shared thumbnail cache folder.</p>
131         </td>
132       </tr>
133
134       <tr>
135         <td>
136           <p><em>&lt;HOME&gt;</em>/.geeqie/thumbnails</p>
137         </td>
138
139         <td>
140           <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>
141         </td>
142       </tr>
143
144       <tr>
145         <td>
146           <p><em>&lt;SOURCE&gt;/.</em><span class="gq-management-8">thumbnails</span>
147           </p>
148         </td>
149
150         <td>
151           <p>Local thumbnail cache folder.</p>
152         </td>
153       </tr>
154
155       <tr>
156         <td colspan="2" class="file_locations_subtitle">
157           <p>Metadata (keywords and comments)</p>
158         </td>
159       </tr>
160
161       <tr>
162         <td>
163           <p><em>&lt;HOME&gt;</em>/.geeqie/metadata</p>
164         </td>
165
166         <td>
167           <p>Metadata stored in user's home folder.</p>
168         </td>
169       </tr>
170
171       <tr>
172         <td>
173           <p><em>&lt;SOURCE&gt;</em>/.metadata</p>
174         </td>
175
176         <td>
177           <p>Metadata stored local to source image. Requires option to be enabled in advanced preferences.</p>
178         </td>
179       </tr>
180
181       <tr>
182         <td colspan="2" class="file_locations_subtitle">
183           <p>Collections</p>
184         </td>
185       </tr>
186
187       <tr>
188         <td>
189           <p><em>&lt;HOME&gt;</em>/.geeqie/collections</p>
190         </td>
191
192         <td>
193           <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>
194         </td>
195       </tr>
196
197       <tr>
198         <td colspan="2" class="file_locations_subtitle">
199           <p>Preferences</p>
200         </td>
201       </tr>
202
203       <tr>
204         <td>
205           <p><em>&lt;HOME&gt;</em>/.geeqie</p>
206         </td>
207
208         <td>
209           <p>Geeqie preferences folder.</p>
210         </td>
211       </tr>
212
213       <tr>
214         <td>
215           <p><em>&lt;HOME&gt;</em>/.geeqie/geeqierc</p>
216         </td>
217
218         <td>
219           <p>Geeqie preferences rc file.</p>
220         </td>
221       </tr>
222
223       <tr>
224         <td>
225           <p><em>&lt;HOME&gt;</em>/.geeqie/history</p>
226         </td>
227
228         <td>
229           <p>Historic data such as last several folders visited, bookmarks, and recently used collections. Also contains default print settings.</p>
230         </td>
231       </tr>
232
233       <tr>
234         <td>
235           <p><em>&lt;HOME&gt;</em>/.geeqie/accels</p>
236         </td>
237
238         <td>
239           <p>Keyboard shortcut mapping.</p>
240         </td>
241       </tr>
242
243       <tr>
244         <td colspan="2" class="file_locations_subtitle">
245           <p>Safe Delete</p>
246         </td>
247       </tr>
248
249       <tr>
250         <td>
251           <p><em>&lt;HOME&gt;</em>/.geeqie/trash</p>
252         </td>
253
254         <td>
255           <p>Default location of the safe delete folder.</p>
256         </td>
257       </tr>
258      </tbody>
259     </table>
260   </div>
261
262   <p><br />
263   <br />
264   </p>
265
266   <p><br />
267   <br />
268   </p>
269
270   <p><br />
271   <br />
272   </p>
273
274   <hr />
275
276   <div class="navbottom">
277     <table width="100%" border="0" cellpadding="4" cellspacing="0">
278       <col id="navbottom_col1" width="33%"></col>
279       <col id="navbottom_col2" width="33%"></col>
280       <col id="navbottom_col3" width="33%"></col>
281
282       <thead>
283         <tr>
284           <td>
285             <p class="previous"><a href="reference_thumbnails.html">Previous</a>
286             </p>
287           </td>
288
289           <td>
290             <p class="navbottom_title"><a href="index.html">Contents</a>
291             </p>
292           </td>
293
294           <td>
295             <p class="next"><a href="credits.html">Next</a>
296             </p>
297           </td>
298         </tr>
299       </thead>
300
301     </table>
302   </div>
303
304   <div class="footer">Geeqie User Manual</div>
305   <div class="bottomspacer">&nbsp;</div>
306 </body>
307 </html>