b723bbe00c7e48c92afaf8ffdb31ada996c31243
[geeqie.git] / doc / image_management_external_editing.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>External Editing - 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="image_management_delete.html">Previous</a>
25             </p>
26           </th>
27
28           <th>
29             <p class="navtop_title">External Editing &ndash; Image Management</p>
30           </th>
31
32           <th>
33             <p class="next"><a href="image_search.html">Next</a>
34             </p>
35           </th>
36         </tr>
37     </table>
38   </div>
39
40   <hr />
41
42   <h1>External Editing</h1>
43
44   <p>Geeqie provides the ability to execute commands, such as running an image editor, on a selected image. In Geeqie these are called the external editing commands.</p>
45
46   <p>These commands are executed by pressing <span class="key">Ctrl</span> and a number key, from the Edit menu, or from the context menu available to all images and files. The keyboards shortcuts are <span class="key">Ctrl</span> + <span class="key">1</span> through <span class="key">Ctrl</span> + <span class="key">9</span>, and <span class="key">Ctrl</span> + <span class="key">0</span>, they correspond respectively to commands 1 through 10 on the <a href="options_editor_commands.html">Editors tab</a> in Options.</p>
47
48   <p>To edit the command list refer to section <a href="options_editor_commands.html">Editor Commands</a>.</p>
49
50   <h2>Result dialog</h2>
51
52   <p>Commands that are set to display the command's output in a window will show a dialog when the command is executed.</p>
53
54   <p>To specify a command to show a dialog begin the command with the %V or %v macros, details for these an all macros are listed on the <a href="options_editor_commands.html">Editors tab</a> in Options.</p>
55
56   <p>The result dialog will display the command's text output. If the editor command will result in multiple runs of the same command for each file, the Stop button will be enabled, activate it to stop Geeqie from executing the command for remaining files.</p>
57
58   <p>Once all commands have completed or if the Stop button was activated and the pending command has completed, the Close button will be enabled, activate it or press <span class="key">Escape</span> to close the result dialog. The result dialog can not be closed while a command is still running.</p>
59
60   <hr id="bottomseparator" />
61
62   <div class="navbottom">
63     <table width="100%" border="0" cellpadding="4" cellspacing="0">
64       <col id="navbottom_col1" width="33%"></col>
65       <col id="navbottom_col2" width="33%"></col>
66       <col id="navbottom_col3" width="33%"></col>
67
68         <tr>
69           <th>
70             <p class="previous"><a href="image_management_delete.html">Previous</a>
71             </p>
72           </th>
73
74           <th>
75             <p class="navbottom_title"><a href="index.html">Contents</a>
76             </p>
77           </th>
78
79           <th>
80             <p class="next"><a href="image_search.html">Next</a>
81             </p>
82           </th>
83         </tr>
84
85     </table>
86   </div>
87
88   <div class="footer">Geeqie User Manual</div>
89   <div class="bottomspacer">&nbsp;</div>
90 </body>
91 </html>