Move from xhtml transitional to xhtml strict.
[geeqie.git] / doc / reference_management.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
8
9   <title>Cache and Data Management - Geeqie User Manual</title>
10   <link rel="stylesheet" type="text/css" href="style.css" />
11 </head>
12
13 <body lang="en-US" dir="ltr">
14   <div class="navtop">
15     <table width="100%" border="0" cellpadding="4" cellspacing="0">
16       <col id="navtop_col1" width="33%"></col>
17       <col id="navtop_col2" width="33%"></col>
18       <col id="navtop_col3" width="33%"></col>
19
20         <tr>
21           <th>
22             <p class="previous"><a href="reference_thumbnails.html">Previous</a>
23             </p>
24           </th>
25
26           <th>
27             <p class="navtop_title">Cache and Data Management &ndash; Reference</p>
28           </th>
29
30           <th>
31             <p class="next"><a href="credits.html">Next</a>
32             </p>
33           </th>
34         </tr>
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   <h2>Geeqie thumbnail cache</h2>
45
46   <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>
47
48   <dl class="dialog_desc">
49   <dt>Clean up</dt>
50   <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>
51
52   <dt>Clear cache</dt>
53   <dd><p>Removes all thumbnails and data stored in the user's home folder: $HOME/.geeqie/thumbnails.</p></dd>
54   </dl>
55
56   <h2>Shared thumbnail cache</h2>
57
58   <p>The utilities listed here operate on the shared thumbnail mechanism.</p>
59  
60   <dl class="dialog_desc">
61   <dt>Clean up</dt>
62   <dd><p>Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</p></dd>
63
64   <dt>Clear cache</dt>
65   <dd><p>Removes all thumbnails stored in the user's home folder: $HOME/.thumbnails.</p></dd>
66   </dl>
67   <h2>Create thumbnails</h2>
68
69   <p>This utility will render thumbnails using the current thumbnail caching mechanism, as determined in <a href="options_general.html">preferences</a>.</p>
70
71   <dl class="dialog_desc">
72
73   <dt>Render</dt>
74   <dd><p>Pre-render thumbnails for a specific folder, the utility has the following options:</p></dd>
75
76   <dt>Include subfolders</dt>
77   <dd><p>Enable to include all images contained in the subfolders of folder.</p></dd>
78
79   <dt>Store thumbnails local to source images</dt>
80   <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>
81
82   </dl>
83
84   <h2>Metadata</h2>
85
86   <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>
87
88   <dl class="dialog_desc">
89   <dt>Clean up</dt>
90   <dd><p>Removes keywords and comments for which the source image is no longer present.</p></dd>
91   </dl>
92
93   <h2>File locations</h2>
94
95   <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>
96
97   <div class="file_locations">
98     <table width="80%" border="1" cellpadding="4" cellspacing="0">
99     <col id="file_locations_col1" width="50%"></col>
100     <col id="file_locations_col2" width="50%"></col>
101
102     <thead>
103       <tr>
104         <td>
105           <p>Folder or File name</p>
106         </td>
107
108         <td>
109           <p>Description</p>
110         </td>
111       </tr>
112     </thead>
113
114     <tbody>
115       <tr>
116         <td colspan="2" class="file_locations_subtitle">
117           <p>Thumbnails</p>
118         </td>
119       </tr>
120
121       <tr>
122         <td>
123           <p><em>&lt;HOME&gt;</em>/.thumbnails</p>
124         </td>
125
126         <td>
127           <p>Shared thumbnail cache folder.</p>
128         </td>
129       </tr>
130
131       <tr>
132         <td>
133           <p><em>&lt;HOME&gt;</em>/.geeqie/thumbnails</p>
134         </td>
135
136         <td>
137           <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>
138         </td>
139       </tr>
140
141       <tr>
142         <td>
143           <p><em>&lt;SOURCE&gt;/.</em>thumbnails
144           </p>
145         </td>
146
147         <td>
148           <p>Local thumbnail cache folder.</p>
149         </td>
150       </tr>
151
152       <tr>
153         <td colspan="2" class="file_locations_subtitle">
154           <p>Metadata (keywords and comments)</p>
155         </td>
156       </tr>
157
158       <tr>
159         <td>
160           <p><em>&lt;HOME&gt;</em>/.geeqie/metadata</p>
161         </td>
162
163         <td>
164           <p>Metadata stored in user's home folder.</p>
165         </td>
166       </tr>
167
168       <tr>
169         <td>
170           <p><em>&lt;SOURCE&gt;</em>/.metadata</p>
171         </td>
172
173         <td>
174           <p>Metadata stored local to source image. Requires option to be enabled in advanced preferences.</p>
175         </td>
176       </tr>
177
178       <tr>
179         <td colspan="2" class="file_locations_subtitle">
180           <p>Collections</p>
181         </td>
182       </tr>
183
184       <tr>
185         <td>
186           <p><em>&lt;HOME&gt;</em>/.geeqie/collections</p>
187         </td>
188
189         <td>
190           <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>
191         </td>
192       </tr>
193
194       <tr>
195         <td colspan="2" class="file_locations_subtitle">
196           <p>Preferences</p>
197         </td>
198       </tr>
199
200       <tr>
201         <td>
202           <p><em>&lt;HOME&gt;</em>/.geeqie</p>
203         </td>
204
205         <td>
206           <p>Geeqie preferences folder.</p>
207         </td>
208       </tr>
209
210       <tr>
211         <td>
212           <p><em>&lt;HOME&gt;</em>/.geeqie/geeqierc</p>
213         </td>
214
215         <td>
216           <p>Geeqie preferences rc file.</p>
217         </td>
218       </tr>
219
220       <tr>
221         <td>
222           <p><em>&lt;HOME&gt;</em>/.geeqie/history</p>
223         </td>
224
225         <td>
226           <p>Historic data such as last several folders visited, bookmarks, and recently used collections. Also contains default print settings.</p>
227         </td>
228       </tr>
229
230       <tr>
231         <td>
232           <p><em>&lt;HOME&gt;</em>/.geeqie/accels</p>
233         </td>
234
235         <td>
236           <p>Keyboard shortcut mapping.</p>
237         </td>
238       </tr>
239
240       <tr>
241         <td colspan="2" class="file_locations_subtitle">
242           <p>Safe Delete</p>
243         </td>
244       </tr>
245
246       <tr>
247         <td>
248           <p><em>&lt;HOME&gt;</em>/.geeqie/trash</p>
249         </td>
250
251         <td>
252           <p>Default location of the safe delete folder.</p>
253         </td>
254       </tr>
255      </tbody>
256     </table>
257   </div>
258
259   <hr id="bottomseparator" />
260
261   <div class="navbottom">
262     <table width="100%" border="0" cellpadding="4" cellspacing="0">
263       <col id="navbottom_col1" width="33%"></col>
264       <col id="navbottom_col2" width="33%"></col>
265       <col id="navbottom_col3" width="33%"></col>
266
267         <tr>
268           <th>
269             <p class="previous"><a href="reference_thumbnails.html">Previous</a>
270             </p>
271           </th>
272
273           <th>
274             <p class="navbottom_title"><a href="index.html">Contents</a>
275             </p>
276           </th>
277
278           <th>
279             <p class="next"><a href="credits.html">Next</a>
280             </p>
281           </th>
282         </tr>
283
284     </table>
285   </div>
286
287   <div class="footer">Geeqie User Manual</div>
288   <div class="bottomspacer">&nbsp;</div>
289 </body>
290 </html>