doc/options_editor_commands.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>Editor Options - 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="options_filtering.html">Previous</a>
  25             </p>
  26           </th>
  27
  28           <th>
  29             <p class="navtop_title">Editors &ndash; Options Explained</p>
  30           </th>
  31
  32           <th>
  33             <p class="next"><a href="options_properties.html">Next</a>
  34             </p>
  35           </th>
  36         </tr>
  37     </table>
  38   </div>
  39
  40   <hr />
  41
  42   <h1>Editor Commands</h1>
  43
  44   <p>This section describes the options presented under the Editors Tab of the preferences dialog.</p>
  45
  46   <p>Geeqie includes ten entries that can be used for executing other applications or shell commands with the selected image. These commands are accessible by menu and keyboard shortcuts. The keyboard shortcuts use <span class="key">Ctrl</span> + <span class="key">1</span> through <span class="key">Ctrl</span> + <span class="key">0</span>, which correspond to lines one through ten in the preferences dialog.</p>
  47
  48   <dl class="dialog_desc">
  49   <dt>Menu name</dt>
  50   <dd><p>This field is used to represent the command in the menus of Geeqie, it is intended to describe the application or function that results from executing the command in the <em>Command Line</em> field.</p>
  51   <p>External command Copy/Move/Rename/Delete/New Folder allows to specify commands to use for these operations. When set, internal operations will be disabled and these commands used instead.</p>
  52   </dd>
  53
  54
  55   <dt>Command Line</dt>
  56   <dd><p>This field is the command to execute. Several macros are available to position image file names within the command. If no macro is specified, the behavior will be to append the filenames onto the end of the command (the result will be the same as &ldquo;<i>command %f</i>&rdquo;).</p>
  57
  58   <div class="macro_description">
  59        <table width="80%" border="0" cellpadding="4" cellspacing="0" rules="rows">
  60        <col id="macro_description_col1" width="20%"></col>
  61        <col id="macro_description_col2" width="80%"></col>
  62
  63        <thead>
  64             <tr>
  65               <td>
  66                 <p>Macro</p>
  67               </td>
  68
  69               <td>
  70                 <p>Description</p>
  71               </td>
  72             </tr>
  73        </thead>
  74        <tbody>
  75             <tr>
  76               <td>
  77                 <p>%f</p>
  78               </td>
  79
  80               <td>
  81                 <p>Inserts list of selected files, may occur only once.</p>
  82               </td>
  83             </tr>
  84
  85             <tr>
  86               <td>
  87                 <p>%p</p>
  88               </td>
  89
  90               <td>
  91                 <p>Command is executed once for each selected file, may occur multiple times.</p>
  92               </td>
  93             </tr>
  94
  95             <tr>
  96               <td>
  97                 <p>%v</p>
  98               </td>
  99
 100               <td>
 101                 <p>Display the result of the command in an output window. Must occur as the first two characters, or immediately after the &ldquo;%w&rdquo; macro.</p>
 102               </td>
 103             </tr>
 104
 105             <tr>
 106               <td>
 107                 <p>%V</p>
 108               </td>
 109
 110               <td>
 111                 <p>Like %v above, but when used with %p, only displays output window when multiple files are selected; The output of a single file is suppressed.</p>
 112               </td>
 113             </tr>
 114
 115             <tr>
 116               <td>
 117                 <p>%w</p>
 118               </td>
 119
 120               <td>
 121                 <p>Prevent full screen from deactivating when command is executed. Must occur as the first two characters.</p>
 122               </td>
 123             </tr>
 124             <tr>
 125               <td>
 126                 <p>%%</p>
 127               </td>
 128
 129               <td>
 130                 <p>This will be replaced by one '%'. This is the way to escape '%'.</p>
 131               </td>
 132             </tr>
 133             <tr>
 134               <td>
 135                 <p>%d</p>
 136               </td>
 137
 138               <td>
 139                 <p>This only makes sense for external commands like copy or move as this is replaced by the destination.</p>
 140               </td>
 141             </tr>
 142
 143           </tbody>
 144           </table>
 145   </div>
 146   </dd>
 147
 148
 149   <dt>Help button</dt>
 150   <dd><p>Displays reference list of the supported command macros.</p></dd>
 151
 152   <dt>Defaults button</dt>
 153   <dd><p>Resets all commands to the default settings, discarding any customizations made by the user.</p></dd>
 154
 155   </dl>
 156
 157   <hr id="bottomseparator" />
 158
 159   <div class="navbottom">
 160     <table width="100%" border="0" cellpadding="4" cellspacing="0">
 161       <col id="navbottom_col1" width="33%"></col>
 162       <col id="navbottom_col2" width="33%"></col>
 163       <col id="navbottom_col3" width="33%"></col>
 164
 165         <tr>
 166           <th>
 167             <p class="previous"><a href="options_filtering.html">Previous</a>
 168             </p>
 169           </th>
 170
 171           <th>
 172             <p class="navbottom_title"><a href="index.html">Contents</a>
 173             </p>
 174           </th>
 175
 176           <th>
 177             <p class="next"><a href="options_properties.html">Next</a>
 178             </p>
 179           </th>
 180         </tr>
 181
 182     </table>
 183   </div>
 184
 185   <div class="footer">Geeqie User Manual</div>
 186   <div class="bottomspacer">&nbsp;</div>
 187 </body>
 188 </html>