view doc/reference_management.html @ 1214:31402ecb2aed

write metadata after timeout, image change or dir change
author nadvornik
date Mon, 22 Dec 2008 18:29:25 +0000
parents c564ab6c11fc
children
line wrap: on
line source

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />

  <title>Cache and Data Management - Geeqie User Manual</title>
  <link rel="stylesheet" type="text/css" href="style.css" media="all" />
  <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
  <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
</head>

<body lang="en-US" dir="ltr">
  <div class="navtop">
    <table width="100%" border="0" cellpadding="4" cellspacing="0">
      <col id="navtop_col1" width="33%"></col>
      <col id="navtop_col2" width="33%"></col>
      <col id="navtop_col3" width="33%"></col>

        <tr>
          <th>
            <p class="previous"><a href="reference_thumbnails.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navtop_title">Cache and Data Management &ndash; Reference</p>
          </th>

          <th>
            <p class="next"><a href="credits.html">Next</a>
            </p>
          </th>
        </tr>
    </table>
  </div>

  <hr />

  <h1>Cache and Data Maintenance</h1>

  <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>

  <h2>Geeqie thumbnail cache</h2>

  <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>

  <dl class="dialog_desc">
  <dt>Clean up</dt>
  <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>

  <dt>Clear cache</dt>
  <dd><p>Removes all thumbnails and data stored in the user's home folder: $HOME/.geeqie/thumbnails.</p></dd>
  </dl>

  <h2>Shared thumbnail cache</h2>

  <p>The utilities listed here operate on the shared thumbnail mechanism.</p>
 
  <dl class="dialog_desc">
  <dt>Clean up</dt>
  <dd><p>Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</p></dd>

  <dt>Clear cache</dt>
  <dd><p>Removes all thumbnails stored in the user's home folder: $HOME/.thumbnails.</p></dd>
  </dl>
  <h2>Create thumbnails</h2>

  <p>This utility will render thumbnails using the current thumbnail caching mechanism, as determined in <a href="options_general.html">preferences</a>.</p>

  <dl class="dialog_desc">

  <dt>Render</dt>
  <dd><p>Pre-render thumbnails for a specific folder, the utility has the following options:</p></dd>

  <dt>Include subfolders</dt>
  <dd><p>Enable to include all images contained in the subfolders of folder.</p></dd>

  <dt>Store thumbnails local to source images</dt>
  <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>

  </dl>

  <h2>Metadata</h2>

  <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>

  <dl class="dialog_desc">
  <dt>Clean up</dt>
  <dd><p>Removes keywords and comments for which the source image is no longer present.</p></dd>
  </dl>

  <h2>File locations</h2>

  <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>

  <div class="file_locations">
    <table width="80%" border="1" cellpadding="4" cellspacing="0">
    <col id="file_locations_col1" width="50%"></col>
    <col id="file_locations_col2" width="50%"></col>

    <thead>
      <tr>
        <td>
          <p>Folder or File name</p>
        </td>

        <td>
          <p>Description</p>
        </td>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td colspan="2" class="file_locations_subtitle">
          <p>Thumbnails</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.thumbnails</p>
        </td>

        <td>
          <p>Shared thumbnail cache folder.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.geeqie/thumbnails</p>
        </td>

        <td>
          <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>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;SOURCE&gt;/.</em>thumbnails
          </p>
        </td>

        <td>
          <p>Local thumbnail cache folder.</p>
        </td>
      </tr>

      <tr>
        <td colspan="2" class="file_locations_subtitle">
          <p>Metadata (keywords and comments)</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.geeqie/metadata</p>
        </td>

        <td>
          <p>Metadata stored in user's home folder.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;SOURCE&gt;</em>/.metadata</p>
        </td>

        <td>
          <p>Metadata stored local to source image. Requires option to be enabled in advanced preferences.</p>
        </td>
      </tr>

      <tr>
        <td colspan="2" class="file_locations_subtitle">
          <p>Collections</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.geeqie/collections</p>
        </td>

        <td>
          <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>
        </td>
      </tr>

      <tr>
        <td colspan="2" class="file_locations_subtitle">
          <p>Preferences</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.geeqie</p>
        </td>

        <td>
          <p>Geeqie preferences folder.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.geeqie/geeqierc</p>
        </td>

        <td>
          <p>Geeqie preferences rc file.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.geeqie/history</p>
        </td>

        <td>
          <p>Historic data such as last several folders visited, bookmarks, and recently used collections. Also contains default print settings.</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.geeqie/accels</p>
        </td>

        <td>
          <p>Keyboard shortcut mapping.</p>
        </td>
      </tr>

      <tr>
        <td colspan="2" class="file_locations_subtitle">
          <p>Safe Delete</p>
        </td>
      </tr>

      <tr>
        <td>
          <p><em>&lt;HOME&gt;</em>/.geeqie/trash</p>
        </td>

        <td>
          <p>Default location of the safe delete folder.</p>
        </td>
      </tr>
     </tbody>
    </table>
  </div>

  <hr id="bottomseparator" />

  <div class="navbottom">
    <table width="100%" border="0" cellpadding="4" cellspacing="0">
      <col id="navbottom_col1" width="33%"></col>
      <col id="navbottom_col2" width="33%"></col>
      <col id="navbottom_col3" width="33%"></col>

        <tr>
          <th>
            <p class="previous"><a href="reference_thumbnails.html">Previous</a>
            </p>
          </th>

          <th>
            <p class="navbottom_title"><a href="index.html">Contents</a>
            </p>
          </th>

          <th>
            <p class="next"><a href="credits.html">Next</a>
            </p>
          </th>
        </tr>

    </table>
  </div>

  <div class="footer">Geeqie User Manual</div>
  <div class="bottomspacer">&nbsp;</div>
</body>
</html>