Various fixes and cleanup.
[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         <tr>
19           <th>
20             <p class="previous"><a href="reference_thumbnails.html">Previous</a>
21             </p>
22           </th>
23
24           <th>
25             <p class="navtop_title">Cache and Data Management &ndash; Reference</p>
26           </th>
27
28           <th>
29             <p class="next"><a href="credits.html">Next</a>
30             </p>
31           </th>
32         </tr>
33     </table>
34   </div>
35
36   <hr />
37
38   <h1>Cache and Data Maintenance</h1>
39
40   <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>
41
42   <h2>Geeqie thumbnail cache</h2>
43
44   <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>
45
46   <dl class="dialog_desc">
47   <dt>Clean up</dt>
48   <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>
49
50   <dt>Clear cache</dt>
51   <dd><p>Removes all thumbnails and data stored in the user's home folder: $HOME/.geeqie/thumbnails.</p></dd>
52   </dl>
53
54   <h2>Shared thumbnail cache</h2>
55
56   <p>The utilities listed here operate on the shared thumbnail mechanism.</p>
57  
58   <dl class="dialog_desc">
59   <dt>Clean up</dt>
60   <dd><p>Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</p></dd>
61
62   <dt>Clear cache</dt>
63   <dd><p>Removes all thumbnails stored in the user's home folder: $HOME/.thumbnails.</p></dd>
64   </dl>
65   <h2>Create thumbnails</h2>
66
67   <p>This utility will render thumbnails using the current thumbnail caching mechanism, as determined in <a href="options_general.html">preferences</a>.</p>
68
69   <dl class="dialog_desc">
70
71   <dt>Render</dt>
72   <dd><p>Pre-render thumbnails for a specific folder, the utility has the following options:</p></dd>
73
74   <dt>Include subfolders</dt>
75   <dd><p>Enable to include all images contained in the subfolders of folder.</p></dd>
76
77   <dt>Store thumbnails local to source images</dt>
78   <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>
79
80   </dl>
81
82   <h2>Metadata</h2>
83
84   <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>
85
86   <dl class="dialog_desc">
87   <dt>Clean up</dt>
88   <dd><p>Removes keywords and comments for which the source image is no longer present.</p></dd>
89   </dl>
90
91   <h2>File locations</h2>
92
93   <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>
94
95   <div class="file_locations">
96     <table width="80%" border="1" cellpadding="4" cellspacing="0">
97     <col id="file_locations_col1" width="50%"></col>
98     <col id="file_locations_col2" width="50%"></col>
99
100     <thead>
101       <tr>
102         <td>
103           <p>Folder or File name</p>
104         </td>
105
106         <td>
107           <p>Description</p>
108         </td>
109       </tr>
110     </thead>
111
112     <tbody>
113       <tr>
114         <td colspan="2" class="file_locations_subtitle">
115           <p>Thumbnails</p>
116         </td>
117       </tr>
118
119       <tr>
120         <td>
121           <p><em>&lt;HOME&gt;</em>/.thumbnails</p>
122         </td>
123
124         <td>
125           <p>Shared thumbnail cache folder.</p>
126         </td>
127       </tr>
128
129       <tr>
130         <td>
131           <p><em>&lt;HOME&gt;</em>/.geeqie/thumbnails</p>
132         </td>
133
134         <td>
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>
140         <td>
141           <p><em>&lt;SOURCE&gt;/.</em>thumbnails
142           </p>
143         </td>
144
145         <td>
146           <p>Local thumbnail cache folder.</p>
147         </td>
148       </tr>
149
150       <tr>
151         <td colspan="2" class="file_locations_subtitle">
152           <p>Metadata (keywords and comments)</p>
153         </td>
154       </tr>
155
156       <tr>
157         <td>
158           <p><em>&lt;HOME&gt;</em>/.geeqie/metadata</p>
159         </td>
160
161         <td>
162           <p>Metadata stored in user's home folder.</p>
163         </td>
164       </tr>
165
166       <tr>
167         <td>
168           <p><em>&lt;SOURCE&gt;</em>/.metadata</p>
169         </td>
170
171         <td>
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" class="file_locations_subtitle">
178           <p>Collections</p>
179         </td>
180       </tr>
181
182       <tr>
183         <td>
184           <p><em>&lt;HOME&gt;</em>/.geeqie/collections</p>
185         </td>
186
187         <td>
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" class="file_locations_subtitle">
194           <p>Preferences</p>
195         </td>
196       </tr>
197
198       <tr>
199         <td>
200           <p><em>&lt;HOME&gt;</em>/.geeqie</p>
201         </td>
202
203         <td>
204           <p>Geeqie preferences folder.</p>
205         </td>
206       </tr>
207
208       <tr>
209         <td>
210           <p><em>&lt;HOME&gt;</em>/.geeqie/geeqierc</p>
211         </td>
212
213         <td>
214           <p>Geeqie preferences rc file.</p>
215         </td>
216       </tr>
217
218       <tr>
219         <td>
220           <p><em>&lt;HOME&gt;</em>/.geeqie/history</p>
221         </td>
222
223         <td>
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>
229         <td>
230           <p><em>&lt;HOME&gt;</em>/.geeqie/accels</p>
231         </td>
232
233         <td>
234           <p>Keyboard shortcut mapping.</p>
235         </td>
236       </tr>
237
238       <tr>
239         <td colspan="2" class="file_locations_subtitle">
240           <p>Safe Delete</p>
241         </td>
242       </tr>
243
244       <tr>
245         <td>
246           <p><em>&lt;HOME&gt;</em>/.geeqie/trash</p>
247         </td>
248
249         <td>
250           <p>Default location of the safe delete folder.</p>
251         </td>
252       </tr>
253      </tbody>
254     </table>
255   </div>
256
257   <hr id="bottomseparator" />
258
259   <div class="navbottom">
260     <table width="100%" border="0" cellpadding="4" cellspacing="0">
261       <col id="navbottom_col1" width="33%"></col>
262       <col id="navbottom_col2" width="33%"></col>
263       <col id="navbottom_col3" width="33%"></col>
264
265         <tr>
266           <th>
267             <p class="previous"><a href="reference_thumbnails.html">Previous</a>
268             </p>
269           </th>
270
271           <th>
272             <p class="navbottom_title"><a href="index.html">Contents</a>
273             </p>
274           </th>
275
276           <th>
277             <p class="next"><a href="credits.html">Next</a>
278             </p>
279           </th>
280         </tr>
281
282     </table>
283   </div>
284
285   <div class="footer">Geeqie User Manual</div>
286   <div class="bottomspacer">&nbsp;</div>
287 </body>
288 </html>