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