Drop most old css classes.
[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="gq-management-4">
101     <table width="80%" border="1" cellpadding="4" cellspacing="0">
102
103       <tr valign="top">
104         <th width="50%">
105           <p>Folder or File name</p>
106         </th>
107
108         <th width="50%">
109           <p>Description</p>
110         </th>
111       </tr>
112
113       <tr>
114         <td colspan="2" width="100%" valign="top">
115           <p>Thumbnails</p>
116         </td>
117       </tr>
118
119       <tr valign="top">
120         <td width="50%">
121           <p><i>&lt;HOME&gt;</i>/.thumbnails</p>
122         </td>
123
124         <td width="50%">
125           <p>Shared thumbnail cache folder.</p>
126         </td>
127       </tr>
128
129       <tr valign="top">
130         <td width="50%">
131           <p><i>&lt;HOME&gt;</i>/.geeqie/thumbnails</p>
132         </td>
133
134         <td width="50%">
135           <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>
136         </td>
137       </tr>
138
139       <tr valign="top">
140         <td width="50%">
141           <p><i>&lt;SOURCE&gt;/.</i><span class="gq-management-8">thumbnails</span>
142           </p>
143         </td>
144
145         <td width="50%">
146           <p>Local thumbnail cache folder.</p>
147         </td>
148       </tr>
149
150       <tr>
151         <td colspan="2" width="100%" valign="top">
152           <p><b>Metadata</b> <span class="gq-management-9">(keywords and comments)</span></p>
153         </td>
154       </tr>
155
156       <tr valign="top">
157         <td width="50%">
158           <p><i>&lt;HOME&gt;</i>/.geeqie/metadata</p>
159         </td>
160
161         <td width="50%">
162           <p>Metadata stored in user's home folder.</p>
163         </td>
164       </tr>
165
166       <tr valign="top">
167         <td width="50%">
168           <p><i>&lt;SOURCE&gt;</i>/.metadata</p>
169         </td>
170
171         <td width="50%">
172           <p>Metadata stored local to source image. Requires option to be enabled in advanced preferences.</p>
173         </td>
174       </tr>
175
176       <tr>
177         <td colspan="2" width="100%" valign="top">
178           <p>Collections</p>
179         </td>
180       </tr>
181
182       <tr valign="top">
183         <td width="50%">
184           <p><i>&lt;HOME&gt;</i>/.geeqie/collections</p>
185         </td>
186
187         <td width="50%">
188           <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>
189         </td>
190       </tr>
191
192       <tr>
193         <td colspan="2" width="100%" valign="top">
194           <p>Preferences</p>
195         </td>
196       </tr>
197
198       <tr valign="top">
199         <td width="50%">
200           <p><i>&lt;HOME&gt;</i>/.geeqie</p>
201         </td>
202
203         <td width="50%">
204           <p>Geeqie preferences folder.</p>
205         </td>
206       </tr>
207
208       <tr valign="top">
209         <td width="50%">
210           <p><i>&lt;HOME&gt;</i>/.geeqie/geeqierc</p>
211         </td>
212
213         <td width="50%">
214           <p>Geeqie preferences rc file.</p>
215         </td>
216       </tr>
217
218       <tr valign="top">
219         <td width="50%">
220           <p><i>&lt;HOME&gt;</i>/.geeqie/history</p>
221         </td>
222
223         <td width="50%">
224           <p>Historic data such as last several folders visited, bookmarks, and recently used collections. Also contains default print settings.</p>
225         </td>
226       </tr>
227
228       <tr valign="top">
229         <td width="50%">
230           <p><i>&lt;HOME&gt;</i>/.geeqie/accels</p>
231         </td>
232
233         <td width="50%">
234           <p>Keyboard shortcut mapping.</p>
235         </td>
236       </tr>
237
238       <tr valign="top">
239         <td width="50%">
240           <p>Safe Delete</p>
241         </td>
242
243         <td width="50%">
244           <p><br />
245           </p>
246         </td>
247       </tr>
248
249       <tr valign="top">
250         <td width="50%">
251           <p><span class="gq-management-9"><i>&lt;HOME&gt;</i></span>/.geeqie/trash</p>
252         </td>
253
254         <td width="50%">
255           <p>Default location of the safe delete folder.</p>
256         </td>
257       </tr>
258     </table>
259   </div>
260
261   <p><br />
262   <br />
263   </p>
264
265   <p><br />
266   <br />
267   </p>
268
269   <p><br />
270   <br />
271   </p>
272
273   <hr />
274
275   <div class="navbottom">
276     <table width="100%" border="0" cellpadding="4" cellspacing="0">
277       <col id="navbottom_col1" width="33%"></col>
278       <col id="navbottom_col2" width="33%"></col>
279       <col id="navbottom_col3" width="33%"></col>
280
281       <thead>
282         <tr>
283           <td>
284             <p class="previous"><a href="reference_thumbnails.html">Previous</a>
285             </p>
286           </td>
287
288           <td>
289             <p class="navbottom_title"><a href="index.html">Contents</a>
290             </p>
291           </td>
292
293           <td>
294             <p class="next"><a href="credits.html">Next</a>
295             </p>
296           </td>
297         </tr>
298       </thead>
299
300     </table>
301   </div>
302
303   <div class="footer">Geeqie User Manual</div>
304   <div class="bottomspacer">&nbsp;</div>
305 </body>
306 </html>