Update web help file and other docs
[geeqie.git] / web / help / GuideImageManagementRename.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>Rename</title>
6 <link rel="previous" href="GuideImageManagementCopyMove.html" title="Copy and Move">
7 <link rel="next" href="GuideImageManagementDelete.html" title="Delete">
8 <link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
9 <style type="text/css">
10
11 html { height: 100%; }
12 body {
13   margin: 0px; padding: 12px;
14   background-color: #f9f9f6;
15   min-height: 100%;
16   direction: ltr;
17 }
18 div, p, pre, blockquote { margin: 0; padding: 0; }
19 p img { vertical-align: middle; }
20 sub { font-size: 0.83em; }
21 sub sub { font-size: 1em; }
22 sup { font-size: 0.83em; }
23 sup sup { font-size: 1em; }
24 table { border-collapse: collapse; }
25 table.table-pgwide { width: 100%; }
26 td { vertical-align: top; }
27 td { padding: 0.2em 0.83em 0.2em 0.83em; }
28 th { padding: 0 0.83em 0 0.83em; }
29 tr.tr-shade {
30   background-color: #f9f9f6;
31 }
32 td.td-colsep { border-right: solid 1px; }
33 td.td-rowsep { border-bottom: solid 1px; }
34 thead { border-top: solid 2px; border-bottom: solid 2px; }
35 tfoot { border-top: solid 2px; border-bottom: solid 2px; }
36 div.body {
37   padding: 1em;
38   max-width: 60em;
39   background-color: #ffffff;
40   border: solid 1px #e0e0df;
41 }
42 div.body-sidebar {
43   margin-right: 13em;
44 }
45 div.division div.division { margin-top: 1.72em; }
46 div.division div.division div.division { margin-top: 1.44em; }
47 div.header {
48   margin: 0;
49   color: #3f3f3f;
50   border-bottom: solid 1px #e0e0df;
51 }
52 h1, h2, h3, h4, h5, h6, h7 {
53   margin: 0; padding: 0;
54   color: #3f3f3f;
55 }
56 h1.title { font-size: 1.72em; }
57 h2.title { font-size: 1.44em; }
58 h3.title { font-size: 1.2em; }
59 h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
60 .block { margin-top: 1em; }
61 .block .block-first { margin-top: 0; }
62 .block-indent {
63   margin-left left: 1.72em;
64   margin-: 1em;
65 }
66 .block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
67 td .block-indent  { margin-left: 0em; margin-right: 0em; }
68 dd .block-indent  { margin-left: 0em; margin-right: 0em; }
69 .block-verbatim { white-space: pre; }
70 div.title {
71   margin-bottom: 0.2em;
72   font-weight: bold;
73   color: #3f3f3f;
74 }
75 div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
76 div.title-formal .label { font-weight: normal; }
77 a {
78   color: #1f609f;
79   text-decoration: none;
80 }
81 a:hover { text-decoration: underline; }
82 a:visited { color: #9f1f6f; }
83 ul, ol, dl { margin: 0; padding: 0; }
84 li {
85   margin-top: 1em;
86   margin-left: 2.4em;
87   padding: 0;
88 }
89 li.li-first { margin-top: 0; }
90 dt { margin: 1em 0 0 0; }
91 dt.dt-first { margin: 0; }
92 dd {
93   margin-left: 1.72em;
94   margin-top: 0.5em;
95 }
96 dl.dl-compact dt { margin-top: 0; }
97 dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }
98
99
100 ul.linktrail {
101   display: block;
102   margin: 0.2em 0 0 0;
103   text-align: right;
104 }
105 li.linktrail { display: inline; margin: 0; padding: 0; }
106
107 li.linktrail::before {
108   content: '  /  ';
109   color: #3f3f3f;
110 }
111
112 li.linktrail-first::before, li.linktrail-only::before { content: ''; }
113
114
115 div.navbar {
116   padding: 0.5em 1em 0.5em 1em;
117   max-width: 60em;
118   background-color: #ffffff;
119   border: solid 1px #e0e0df;
120 }
121 div.navbar-top { margin-bottom: 1em; }
122 div.navbar-bottom { margin-top: 1em; clear: both; }
123 div.navbar img { border: 0; vertical-align: -0.4em; }
124 table.navbar { width: 100%; margin: 0; border: none; }
125 table.navbar td { padding: 0; border: none; }
126 td.navbar-next {
127   text-align: right;
128 }
129 a.navbar-prev::before {
130   
131   content: '◀  ';
132   color: #3f3f3f;
133 }
134 a.navbar-next::after {
135   
136   content: '  ▶';
137   color: #3f3f3f;
138 }
139
140
141 div.sidebar {
142   float: right;
143   padding: 0; margin: 0; width: 12em;
144 }
145 div.sidenav {
146   padding: 0.5em 1em 0 1em;
147   background-color: #ffffff;
148   border: solid 1px #e0e0df;
149 }
150 div.sidenav div.autotoc {
151   background-color: #ffffff;
152   border: none; padding: 0; margin: 0;
153 }
154 div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
155 div.sidenav div.autotoc li { margin-bottom: 0.5em; }
156 div.sidenav div.autotoc div.autotoc div.autotoc {
157   margin-left: 1em;
158   margin-top: 0;
159 }
160 div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }
161
162
163 div.autotoc {
164   
165   display: table;
166   margin-top: 1em;
167   margin-left: 1.72em;
168   padding: 0.5em 1em 0.5em 1em;
169   background-color: #f0f9ff;
170   border: solid 1px #c0c9ff;
171 }
172 div.autotoc ul { margin: 0; padding: 0; }
173 div.autotoc li { list-style-type: none; margin: 0; }
174 div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
175 div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
176 div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }
177
178
179 span.bibliolabel {
180   color: #3f3f3f;
181 }
182
183
184 div.admonition {
185   padding: 0.5em 6px 0.5em 6px;
186   border: solid 1px #e0e0df;
187   background-color: #fffff0;
188 }
189 div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
190   padding-left: 60px;
191   background-position: left top;
192   background-repeat: no-repeat;
193   min-height: 48px;
194 }
195 div.caution-inner { background-image: url("admon-caution.png"); }
196 div.important-inner { background-image: url("admon-important.png"); }
197 div.note-inner { background-image: url("admon-note.png"); }
198 div.note-bug div.note-inner { background-image: url("admon-bug.png"); }
199 div.tip-inner { background-image: url("admon-tip.png"); }
200 div.warning-inner { background-image: url("admon-warning.png"); }
201 div.blockquote {
202   
203   background-image: url('watermark-blockquote-201C.png');
204   background-repeat: no-repeat;
205   background-position: top left;
206   padding: 0.5em;
207   padding-left: 4em;
208 }
209 div.attribution {
210   margin-top: 0.5em;
211   color: #3f3f3f;
212 }
213 div.attribution::before {
214   
215   content: '― ';
216 }
217 div.epigraph {
218   text-align: right;
219   margin-left: 20%;
220   margin-right: 0;
221   color: #3f3f3f;
222 }
223 div.figure, div.informalfigure {
224   
225   display: table;
226   padding: 0.5em;
227   background-color: #f9f9f6;
228   border: solid 1px #e0e0df;
229 }
230 div.figure-inner, div.informalfigure-inner {
231   padding: 0.5em;
232   background-color: #ffffff;
233   border: solid 1px #e0e0df;
234 }
235 div.caption { margin-top: 0.5em; }
236 div.programlisting {
237   padding: 0.5em;
238   
239   background-color: #f9f9f6;
240   border: solid 1px #e0e0df;
241 }
242 div.screen {
243   padding: 0.5em;
244   
245   background-color: #f9f9f6;
246   border: solid 1px #e0e0df;
247 }
248 div.screen .prompt {
249   color: #3f3f3f;
250 }
251 div.screen .userinput {
252   font-weight: bold;
253   color: #3f3f3f;
254 }
255 div.programlisting .userinput {
256   font-weight: bold;
257   color: #3f3f3f;
258 }
259 pre.linenumbering {
260   color: #3f3f3f;
261   margin: 0;
262   padding-right: 1em;
263   float: left;
264   text-align: right;
265 }
266
267
268
269 dl.index dt { margin-top: 0; }
270 dl.index dd { margin-top: 0; margin-bottom: 0; }
271 dl.indexdiv dt { margin-top: 0; }
272 dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
273 dl.setindex dt { margin-top: 0; }
274 dl.setindex dd { margin-top: 0; margin-bottom: 0; }
275 div.list div.title-formal span.title {
276   border-bottom: solid 1px #e0e0df;
277 }
278 div.simplelist {
279   margin-left: 1.72em;
280 }
281 div.simplelist table { margin-left: 0; border: none; }
282 div.simplelist td {
283   padding: 0.5em;
284   border-left: solid 1px #e0e0df;
285 }
286 div.simplelist td.td-first {
287   padding-left: 0;
288   border-left: 0;
289 }
290 div.synopsis {
291   padding: 0.5em;
292   
293   background-color: #f9f9f6;
294   border-top: solid 2px #c0c9ff;
295   border-bottom: solid 2px #c0c9ff;
296 }
297 div.synopsis div.synopsis {
298   padding: 0;
299   border: none;
300 }
301 div.synopsis div.block { margin-top: 0.2em; }
302 div.synopsis div.block-first { margin-top: 0; }
303 div.cmdsynopsis { font-family: monospace; }
304
305 span.accel { text-decoration: underline; }
306 span.acronym { font-family: sans-serif; }
307 span.application { font-style: italic; }
308 span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
309 span.code {
310   font-family: monospace;
311   border: solid 1px #e0e0df;
312   padding-left: 0.2em;
313   padding-right: 0.2em;
314 }
315 pre span.code { border: none; padding: 0; }
316 span.command {
317   font-family: monospace;
318   border: solid 1px #e0e0df;
319   padding-left: 0.2em;
320   padding-right: 0.2em;
321 }
322 pre span.command { border: none; padding: 0; }
323 span.computeroutput { font-family: monospace; }
324
325 span.constant { font-family: monospace; }
326 span.database { font-family: monospace; }
327 span.email { font-family: monospace; }
328 span.emphasis { font-style: italic; }
329 span.emphasis-bold { font-style: normal; font-weight: bold; }
330 span.envar { font-family: monospace; }
331
332 span.filename { font-family: monospace; }
333 span.firstterm { font-style: italic; }
334 span.foreignphrase { font-style: italic; }
335 span.function { font-family: monospace; }
336
337 dt.glossterm span.glossterm { font-style: normal; }
338
339
340 span.glossterm { font-style: italic; }
341
342 span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
343   font-weight: bold;
344   color: #3f3f3f;
345 }
346 span.keycap {
347   font-weight: bold;
348   color: #3f3f3f;
349 }
350 span.lineannotation { font-style: italic; }
351 span.literal { font-family: monospace; }
352 span.markup  { font-family: monospace; }
353 span.medialabel { font-style: italic; }
354 span.methodname { font-family: monospace; }
355 span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
356 span.option { font-family: monospace; }
357 span.parameter { font-family: monospace; }
358 span.paramdef span.parameter { font-style: italic; }
359 span.prompt { font-family: monospace; }
360 span.property { font-family: monospace; }
361 span.replaceable  { font-style: italic; }
362 span.returnvalue { font-family: monospace; }
363 span.sgmltag { font-family: monospace; }
364 span.structfield, span.structname { font-family: monospace; }
365 span.symbol { font-family: monospace; }
366 span.systemitem { font-family: monospace; }
367 span.token { font-family: monospace; }
368 span.type { font-family: monospace; }
369 span.uri { font-family: monospace; }
370 span.userinput { font-family: monospace; }
371 span.varname { font-family: monospace; }
372 span.wordasword { font-style: italic; }
373
374
375
376 div.footnotes { font-style: italic; font-size: 0.8em; }
377 div.footnote { margin-top: 1.44em; }
378 span.footnote-number { display: inline; padding-right: 0.83em; }
379 span.footnote-number + p { display: inline; }
380 a.footnote { text-decoration: none; font-size: 0.8em; }
381 a.footnote-ref { text-decoration: none; }
382
383 span.co {
384   margin-left: 0.2em; margin-right: 0.2em;
385   padding-left: 0.4em; padding-right: 0.4em;
386   border: solid 1px #000000;
387   -moz-border-radius: 8px;
388   background-color: #000000;
389   color: #FFFFFF;
390   font-size: 8px;
391 }
392 span.co:hover {
393   border-color: #333333;
394   background-color: #333333;
395   color: #FFFFFF;
396 }
397 span.co a { text-decoration: none; }
398 span.co a:hover { text-decoration: none; }
399
400 dt.question { margin-left: 0em; }
401 dt.question div.label { float: left; }
402 dd + dt.question { margin-top: 1em; }
403 dd.answer {
404   margin-top: 1em;
405   margin-left: 2em;
406   margin-right: 1em;
407 }
408 dd.answer div.label { float: left; }
409 </style>
410 </head>
411 <body>
412 <div class="navbar navbar-top"><table class="navbar"><tr>
413 <td class="navbar-prev"><a class="navbar-prev" href="GuideImageManagementCopyMove.html" title="Copy and Move">Copy and Move</a></td>
414 <td class="navbar-next"><a class="navbar-next" href="GuideImageManagementDelete.html" title="Delete">Delete</a></td>
415 </tr></table></div>
416 <div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
417 <li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
418 <li>
419 <a class="xref" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a><div class="autotoc"><ul>
420 <li><a class="xref" href="GuideIntroduction.html" title="Introduction">Introduction</a></li>
421 <li><a class="xref" href="GuideMainWindow.html" title="Main Window">Main Window</a></li>
422 <li><a class="xref" href="GuideSidebars.html" title="Sidebars">Sidebars</a></li>
423 <li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
424 <li><a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></li>
425 <li><a class="xref" href="GuideImageManagementPlugins.html" title="Plugins">Plugins</a></li>
426 <li>
427 <a class="xref" href="GuideImageManagement.html" title="File Management">File Management</a><div class="autotoc"><ul>
428 <li><a class="xref" href="GuideImageManagementCopyMove.html" title="Copy and Move">Copy and Move</a></li>
429 <li>Rename</li>
430 <li><a class="xref" href="GuideImageManagementDelete.html" title="Delete">Delete</a></li>
431 <li><a class="xref" href="GuideReferenceManagement.html" title="Cache and Data Maintenance">Cache and Data Maintenance</a></li>
432 </ul></div>
433 </li>
434 <li><a class="xref" href="GuideColorManagement.html" title="Color Management">Color Management</a></li>
435 <li><a class="xref" href="GuideImagePresentation.html" title="Image Presentation">Image Presentation</a></li>
436 <li><a class="xref" href="GuidePrinting.html" title="Printing">Printing</a></li>
437 <li><a class="xref" href="GuideOptionsMain.html" title="Preferences">Preferences</a></li>
438 <li><a class="xref" href="GuideOptionsAdditional.html" title="Additional Preferences">Additional Preferences</a></li>
439 <li><a class="xref" href="GuideReference.html" title="Reference">Reference</a></li>
440 <li><a class="xref" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a></li>
441 <li><a class="xref" href="GuideLicence.html" title="Licence">Licence</a></li>
442 <li><a class="xref" href="GuideCredits.html" title="Credits">Credits</a></li>
443 <li><a class="xref" href="GuideGnuFdl.html" title="GNU Free Documentation License">GNU Free Documentation License</a></li>
444 </ul></div>
445 </li>
446 </ul></div></div></div>
447 <div class="body body-sidebar"><div class="division section">
448 <a name="GuideImageManagementRename"></a><div class="header"><h1 class="section title"><span class="title"><a name="titleGuideImageManagementRename"></a>Rename</span></h1></div>
449 <ul class="linktrail">
450 <li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
451 <li class="linktrail linktrail-last"><a class="linktrail" href="GuideImageManagement.html" title="File Management">File Management</a></li>
452 </ul>
453 <p class="para block block-first">
454     To rename a file in Geeqie select
455     <span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guimenuitem">Rename</span> <span class="shortcut">(
456         <span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">R</span></span>
457       )</span></span>
458     . Rename is also available in the context menu of all images and files.
459   </p>
460 <p class="para block">When renaming a file, a dialog will display allowing entry of the new name for the file. The dialog will be different depending on the number of files selected to be renamed. A simple dialog will appear when renaming a single file, however when renaming multiple files the dialog will include a list of the file to be renamed and additional options.</p>
461 <p class="para block"></p>
462 <div class="autotoc"><ul>
463 <li>
464 <span class="label">7.2.1. </span><a class="xref" href="GuideImageManagementRename.html#Renamesinglefiledialog" title="Rename single file dialog">Rename single file dialog</a>
465 </li>
466 <li>
467 <span class="label">7.2.2. </span><a class="xref" href="GuideImageManagementRename.html#Renamemultiplefilesdialog" title="Rename multiple files dialog">Rename multiple files dialog</a>
468 </li>
469 </ul></div>
470 <div class="division section">
471 <a name="Renamesinglefiledialog"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">7.2.1. </span>Rename single file dialog</span></h2></div>
472 <p class="para block block-first">
473       The dialog that appears when renaming a single file includes an image of the file, an entry to type the new name of the file, a Rename button, and a Cancel button. Type the new name into the text entry and press
474       <span class="keycap">Enter</span>
475       or activate the Rename button to rename the file. Press
476       <span class="keycap">Escape</span>
477       or activate the Cancel button to close the dialog and abort renaming the file.
478     </p>
479 <p class="para block">
480       When renaming a file and the new name already exists on the file system a dialog will appear showing the renamed and existing files. To overwrite the existing file press
481       <span class="keycap">Enter</span>
482       or activate the Overwrite button. Press
483       <span class="keycap">Escape</span>
484       or activate the Cancel button to close the dialog abort renaming the file.
485     </p>
486 <p class="para block"></p>
487 </div>
488 <div class="division section">
489 <a name="Renamemultiplefilesdialog"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">7.2.2. </span>Rename multiple files dialog</span></h2></div>
490 <p class="para block block-first">The dialog that appears when renaming multiple files includes the list of files to be renamed, a preview image of the active file, an entry to enter the new file name, an auto rename check box, a Rename button, and a Cancel button.</p>
491 <div class="block list variablelist"><dl class="variablelist">
492 <dt class="term dt-first">
493           <span class="guilabel">Manually enter new file names</span>
494         </dt>
495 <dd>
496           <p class="para block block-first">
497             To manually enter the new name of each file, the active file will be displayed in the image preview and it's original name will be displayed above the text entry. To rename the file type the new name and press
498             <span class="keycap">Enter</span>
499             or activate the Rename button. When a file is successfully renamed it will be removed from the list and the next one will become the active file. After all files have been renamed, the dialog will close.
500           </p>
501           <p class="para block">Files do not have to be renamed in the order that they appear in the list, highlighting a name in the list will make it become the active file.</p>
502           <p class="para block">
503             When renaming a file and the new name already exists on the file system a dialog will appear showing the renamed and existing files. To overwrite the existing file press
504             <span class="keycap">Enter</span>
505             or activate the Overwrite button. Press
506             <span class="keycap">Escape</span>
507             or activate the Cancel button to return to the original rename dialog, the file that prompted the overwrite dialog will remain active.
508           </p>
509         </dd>
510 <dt class="term">
511           <span class="guilabel">Automatic renaming of multiple files</span>
512         </dt>
513 <dd>
514           <p class="para block block-first">To automatically rename the files in the list, enable the Auto rename check box. The dialog will change to batch mode for numerical naming of files.</p>
515           <p class="para block">The file name list will change to include a preview column that will show the resulting name of each file. The text entry will change to three entries; the first represents the text that appears in the new names before the number, the second will be the start number to use when incrementing the file number, and the third represents the text to append to the name after the number. The end text should include the file name extension, therefore batch renaming multiple types of files (those with different extensions) all at once is not recommended.</p>
516           <p class="para block">The padding number can be used to change the minimum length of characters to use for the number portion of the new name. When the file number results in fewer characters than the padding size, the result will be padded with leading zeros to fill the remaining space. For example if padding size is 3, a file with the number 24 will appear in the file name as “024”.</p>
517           <p class="para block">The order of the file list can be changed by dragging a name to the desired location within the list. The preview column will update to reflect the new order.</p>
518           <p class="para block">
519             When the preview of new names is satisfactory, press
520             <span class="keycap">Enter</span>
521             or activate the Rename button to rename the files to match the name in the preview column. Press
522             <span class="keycap">Escape</span>
523             or activate the Cancel button to close the dialog and abort the rename operation.
524           </p>
525           <p class="para block">If the resulting new names match any existing files, a warning dialog will notify you. The rename dialog will remain so that you can select a different set of names.</p>
526           <p class="para block"></p>
527         </dd>
528 <dt class="term">
529           <span class="guilabel">Formatted renaming of multiple files</span>
530         </dt>
531 <dd>
532           <p class="para block block-first">Formatted rename permits file to be renamed in a pre-determined way whilst still including the original file name.</p>
533           <p class="para block">
534             In the Format box any alpha-numerics can be entered, but the special character
535             <span class="keycap">*</span>
536             will be replaced by the current filename. One or more
537             <span class="keycap">#</span>
538             characters can be included, and will be replaced by an incrementing number.
539           </p>
540           <p class="para block">The current file extension is automatically appended to new new file name.</p>
541           <p class="para block">The order of the file list can be changed by dragging a name to the desired location within the list. The preview column will update to reflect the new order.</p>
542           <p class="para block">When the preview of new names is satisfactory, press Enter or activate the Rename button to rename the files to match the name in the preview column. Press Escape or activate the Cancel button to close the dialog and abort the rename operation.</p>
543           <p class="para block">If the resulting new names match any existing files, a warning dialog will notify you. The rename dialog will remain so that you can select a different set of names.</p>
544           <p class="para block"></p>
545         </dd>
546 </dl></div>
547 </div>
548 </div></div>
549 <div class="navbar navbar-bottom"><table class="navbar"><tr>
550 <td class="navbar-prev"><a class="navbar-prev" href="GuideImageManagementCopyMove.html" title="Copy and Move">Copy and Move</a></td>
551 <td class="navbar-next"><a class="navbar-next" href="GuideImageManagementDelete.html" title="Delete">Delete</a></td>
552 </tr></table></div>
553 </body>
554 </html>