doc/sidebars_keywords.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>Keywords Sidebar - 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" xml:lang="en-US">
  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="sidebars_sort_manager.html">Previous</a>
  25             </p>
  26           </th>
  27
  28           <th>
  29             <p class="navtop_title">Keywords &ndash; Sidebar</p>
  30           </th>
  31
  32           <th>
  33             <p class="next"><a href="image_presentation.html">Next</a>
  34             </p>
  35           </th>
  36         </tr>
  37     </table>
  38   </div>
  39
  40   <hr />
  41
  42   <h1>Keywords Sidebar</h1>
  43
  44   <p>The Keywords sidebar displays keywords and comments for the active image, and provides functions for editing them.</p>
  45
  46   <p>To toggle display of the Keywords sidebar press <span class="key">Ctrl</span> + <span class="key">K</span> or select &ldquo;Keywords&rdquo; from the View menu.</p>
  47
  48   <p><b>Keywords</b> are single words that are associated to an image. They can be used to classify, group, or describe; the uses for keywords are only limited by your imagination. Images associated to one or more keywords can be found using the <a href="image_search_search.html">Search window</a>.</p>
  49
  50   <p><b>Comments</b> is an area to associate a textual description to an image.</p>
  51
  52   <p>The sidebar is comprised of three sections: Keywords, Comments and a button bar.</p>
  53
  54   <h2>Keywords</h2>
  55
  56   <p>The keywords panel consists of two fields. The left field is a text entry that allows direct typing of one or more keywords. The right field is a list of favorite or often used keywords that can be associated with the active image by filling the check box next to the keyword.</p>
  57
  58   <p>The <b>text entry</b> allows typing keywords to associate them with the active image. Keywords entered here can be separated by a space, tab, or comma; creating a new line by pressing <span class="key">Enter</span> will also separate keywords.</p>
  59
  60   <p>The <b>favorite keywords</b> list allows quick selection of commonly used keywords. <span class="key">A</span> keyword is enabled when the check box next to it is filled. The text entry will update as words from the list are selected. To edit the favorite keywords list activate the favorites button at the bottom of the sidebar.</p>
  61
  62   <h2>Comments</h2>
  63
  64   <p>This text entry allows entering text to be associated with the active image.</p>
  65
  66   <h2>The buttons</h2>
  67
  68   <p class="note"><span class="note_label">Note:</span> These buttons are only displayed as an icon, the text below refers to the tool tip that appears by hovering the mouse over each button.
  69   </p>
  70
  71   <dl class="dialog_desc">
  72
  73   <dt>Edit favorite keywords list</dt>
  74   <dd><p>Activate this button to display a dialog to edit the favorite keywords list. For details on the dialog refer to the section titled Favorite Keywords Dialog, below.</p></dd>
  75
  76   <dt>Add keywords to selected files</dt>
  77   <dd><p>This button will be active when more than one image is selected. Activate this button to add all keywords currently displayed to the selected list of files.</p></dd>
  78
  79   <dt>Add keywords to selected files, replacing existing ones</dt>
  80   <dd><p>This button will be active when more than one image is selected. Activate this button to replace all keywords in the selected files with the ones that are currently displayed. All previously existing keywords for those files will be lost.</p></dd>
  81
  82   <dt>Save comment now</dt>
  83   <dd><p>Saving of changes to keywords and comments are slightly delayed to reduce writes to disk. If the changes have not yet been written to disk this button will be active, activating it will immediately save the changes.</p></dd>
  84
  85   </dl>
  86
  87   <h2>Favorite Keywords Dialog</h2>
  88
  89   <p>This dialog allows editing of the favorite keywords list that is displayed in the Keywords sidebar. Activating the Add button will create a new blank item at the current position in the list, the new item will immediately change to the editing state to allow entry of the new keyword. Activating the Remove button will remove the selected keyword from the list. To edit a row highlight it then click it or press <span class="key">Enter</span> on the keyboard.</p>
  90
  91   <p>Activate OK to save the changes and close the dialog, Cancel will discard the changes and close the dialog.</p>
  92
  93   <hr id="bottomseparator" />
  94
  95   <div class="navbottom">
  96     <table width="100%" border="0" cellpadding="4" cellspacing="0">
  97       <col id="navbottom_col1" width="33%"></col>
  98       <col id="navbottom_col2" width="33%"></col>
  99       <col id="navbottom_col3" width="33%"></col>
 100
 101         <tr>
 102           <th>
 103             <p class="previous"><a href="sidebars_sort_manager.html">Previous</a>
 104             </p>
 105           </th>
 106
 107           <th>
 108             <p class="navbottom_title"><a href="index.html">Contents</a>
 109             </p>
 110           </th>
 111
 112           <th>
 113             <p class="next"><a href="image_presentation.html">Next</a>
 114             </p>
 115           </th>
 116         </tr>
 117
 118     </table>
 119   </div>
 120
 121   <div class="footer">Geeqie User Manual</div>
 122   <div class="bottomspacer">&nbsp;</div>
 123 </body>
 124 </html>