1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>Manual del usuario de la Herramienta de configuración de las acciones de Nautilus</title>
6
<style type="text/css">
10
margin: 0px; padding: 12px;
11
background-color: #f9f9f6;
15
div, p, pre, blockquote { margin: 0; padding: 0; }
16
p img { vertical-align: middle; }
17
sub { font-size: 0.83em; }
18
sub sub { font-size: 1em; }
19
sup { font-size: 0.83em; }
20
sup sup { font-size: 1em; }
21
table { border-collapse: collapse; }
22
table.table-pgwide { width: 100%; }
23
td { vertical-align: top; }
24
td { padding: 0.2em 0.83em 0.2em 0.83em; }
25
th { padding: 0 0.83em 0 0.83em; }
27
background-color: #f9f9f6;
29
td.td-colsep { border-right: solid 1px; }
30
td.td-rowsep { border-bottom: solid 1px; }
31
thead { border-top: solid 2px; border-bottom: solid 2px; }
32
tfoot { border-top: solid 2px; border-bottom: solid 2px; }
36
background-color: #ffffff;
37
border: solid 1px #e0e0df;
42
div.division div.division { margin-top: 1.72em; }
43
div.division div.division div.division { margin-top: 1.44em; }
47
border-bottom: solid 1px #e0e0df;
49
h1, h2, h3, h4, h5, h6, h7 {
50
margin: 0; padding: 0;
53
h1.title { font-size: 1.72em; }
54
h2.title { font-size: 1.44em; }
55
h3.title { font-size: 1.2em; }
56
h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
57
.block { margin-top: 1em; }
58
.block .block-first { margin-top: 0; }
60
margin-left left: 1.72em;
63
.block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
64
td .block-indent { margin-left: 0em; margin-right: 0em; }
65
dd .block-indent { margin-left: 0em; margin-right: 0em; }
66
.block-verbatim { white-space: pre; }
72
div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
73
div.title-formal .label { font-weight: normal; }
76
text-decoration: none;
78
a:hover { text-decoration: underline; }
79
a:visited { color: #9f1f6f; }
80
ul, ol, dl { margin: 0; padding: 0; }
86
li.li-first { margin-top: 0; }
87
dt { margin: 1em 0 0 0; }
88
dt.dt-first { margin: 0; }
93
dl.dl-compact dt { margin-top: 0; }
94
dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }
102
li.linktrail { display: inline; margin: 0; padding: 0; }
104
li.linktrail::before {
109
li.linktrail-first::before, li.linktrail-only::before { content: ''; }
113
padding: 0.5em 1em 0.5em 1em;
115
background-color: #ffffff;
116
border: solid 1px #e0e0df;
118
div.navbar-top { margin-bottom: 1em; }
119
div.navbar-bottom { margin-top: 1em; clear: both; }
120
div.navbar img { border: 0; vertical-align: -0.4em; }
121
table.navbar { width: 100%; margin: 0; border: none; }
122
table.navbar td { padding: 0; border: none; }
126
a.navbar-prev::before {
131
a.navbar-next::after {
140
padding: 0; margin: 0; width: 12em;
143
padding: 0.5em 1em 0 1em;
144
background-color: #ffffff;
145
border: solid 1px #e0e0df;
147
div.sidenav div.autotoc {
148
background-color: #ffffff;
149
border: none; padding: 0; margin: 0;
151
div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
152
div.sidenav div.autotoc li { margin-bottom: 0.5em; }
153
div.sidenav div.autotoc div.autotoc div.autotoc {
157
div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }
165
padding: 0.5em 1em 0.5em 1em;
166
background-color: #f0f9ff;
167
border: solid 1px #c0c9ff;
169
div.autotoc ul { margin: 0; padding: 0; }
170
div.autotoc li { list-style-type: none; margin: 0; }
171
div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
172
div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
173
div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }
182
padding: 0.5em 6px 0.5em 6px;
183
border: solid 1px #e0e0df;
184
background-color: #fffff0;
186
div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
188
background-position: left top;
189
background-repeat: no-repeat;
192
div.caution-inner { background-image: url("admon/admon-caution.png"); }
193
div.important-inner { background-image: url("admon/admon-important.png"); }
194
div.note-inner { background-image: url("admon/admon-note.png"); }
195
div.note-bug div.note-inner { background-image: url("admon/admon-bug.png"); }
196
div.tip-inner { background-image: url("admon/admon-tip.png"); }
197
div.warning-inner { background-image: url("admon/admon-warning.png"); }
200
background-image: url('watermark-blockquote-201C.png');
201
background-repeat: no-repeat;
202
background-position: top left;
210
div.attribution::before {
220
div.figure, div.informalfigure {
224
background-color: #f9f9f6;
225
border: solid 1px #e0e0df;
227
div.figure-inner, div.informalfigure-inner {
229
background-color: #ffffff;
230
border: solid 1px #e0e0df;
232
div.caption { margin-top: 0.5em; }
236
background-color: #f9f9f6;
237
border: solid 1px #e0e0df;
242
background-color: #f9f9f6;
243
border: solid 1px #e0e0df;
248
div.screen .userinput {
252
div.programlisting .userinput {
266
dl.index dt { margin-top: 0; }
267
dl.index dd { margin-top: 0; margin-bottom: 0; }
268
dl.indexdiv dt { margin-top: 0; }
269
dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
270
dl.setindex dt { margin-top: 0; }
271
dl.setindex dd { margin-top: 0; margin-bottom: 0; }
272
div.list div.title-formal span.title {
273
border-bottom: solid 1px #e0e0df;
278
div.simplelist table { margin-left: 0; border: none; }
281
border-left: solid 1px #e0e0df;
283
div.simplelist td.td-first {
290
background-color: #f9f9f6;
291
border-top: solid 2px #c0c9ff;
292
border-bottom: solid 2px #c0c9ff;
294
div.synopsis div.synopsis {
298
div.synopsis div.block { margin-top: 0.2em; }
299
div.synopsis div.block-first { margin-top: 0; }
300
div.cmdsynopsis { font-family: monospace; }
302
span.accel { text-decoration: underline; }
303
span.acronym { font-family: sans-serif; }
304
span.application { font-style: italic; }
305
span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
307
font-family: monospace;
308
border: solid 1px #e0e0df;
310
padding-right: 0.2em;
312
pre span.code { border: none; padding: 0; }
314
font-family: monospace;
315
border: solid 1px #e0e0df;
317
padding-right: 0.2em;
319
pre span.command { border: none; padding: 0; }
320
span.computeroutput { font-family: monospace; }
322
span.constant { font-family: monospace; }
323
span.database { font-family: monospace; }
324
span.email { font-family: monospace; }
325
span.emphasis { font-style: italic; }
326
span.emphasis-bold { font-style: normal; font-weight: bold; }
327
span.envar { font-family: monospace; }
329
span.filename { font-family: monospace; }
330
span.firstterm { font-style: italic; }
331
span.foreignphrase { font-style: italic; }
332
span.function { font-family: monospace; }
334
dt.glossterm span.glossterm { font-style: normal; }
337
span.glossterm { font-style: italic; }
339
span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
347
span.lineannotation { font-style: italic; }
348
span.literal { font-family: monospace; }
349
span.markup { font-family: monospace; }
350
span.medialabel { font-style: italic; }
351
span.methodname { font-family: monospace; }
352
span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
353
span.option { font-family: monospace; }
354
span.package { font-family: monospace; }
355
span.parameter { font-family: monospace; }
356
span.paramdef span.parameter { font-style: italic; }
357
span.prompt { font-family: monospace; }
358
span.property { font-family: monospace; }
359
span.replaceable { font-style: italic; }
360
span.returnvalue { font-family: monospace; }
361
span.sgmltag { font-family: monospace; }
362
span.structfield, span.structname { font-family: monospace; }
363
span.symbol { font-family: monospace; }
364
span.systemitem { font-family: monospace; }
365
span.token { font-family: monospace; }
366
span.type { font-family: monospace; }
367
span.uri { font-family: monospace; }
368
span.userinput { font-family: monospace; }
369
span.varname { font-family: monospace; }
370
span.wordasword { font-style: italic; }
374
div.footnotes { font-style: italic; font-size: 0.8em; }
375
div.footnote { margin-top: 1.44em; }
376
span.footnote-number { display: inline; padding-right: 0.83em; }
377
span.footnote-number + p { display: inline; }
378
a.footnote { text-decoration: none; font-size: 0.8em; }
379
a.footnote-ref { text-decoration: none; }
382
margin-left: 0.2em; margin-right: 0.2em;
383
padding-left: 0.4em; padding-right: 0.4em;
384
border: solid 1px #000000;
385
-moz-border-radius: 8px;
386
background-color: #000000;
391
border-color: #333333;
392
background-color: #333333;
395
span.co a { text-decoration: none; }
396
span.co a:hover { text-decoration: none; }
398
dt.question { margin-left: 0em; }
399
dt.question div.label { float: left; }
400
dd + dt.question { margin-top: 1em; }
406
dd.answer div.label { float: left; }
410
<div class="navbar navbar-top"><table class="navbar"><tr>
411
<td class="navbar-prev"></td>
412
<td class="navbar-next"></td>
414
<div class="sidebar"><div class="sidenav"><div class="autotoc"><ul><li>Manual del usuario de la <span class="application">Herramienta de configuración de las acciones de Nautilus</span>
415
</li></ul></div></div></div>
416
<div class="body body-sidebar"><div class="division article" dir="ltr">
417
<a name="index"></a><div class="header"><h1 class="article title"><span class="title">Manual del usuario de la <span class="application">Herramienta de configuración de las acciones de Nautilus</span></span></h1></div>
418
<div class="autotoc"><ul>
420
<span class="label">1. </span><a class="xref" href="nautilus-actions-config-tool.html#introduction" title="Introducción">Introducción</a>
423
<span class="label">2. </span><a class="xref" href="nautilus-actions-config-tool.html#getting-started" title="Inicio">Inicio</a>
426
<span class="label">3. </span><a class="xref" href="nautilus-actions-config-tool.html#usage" title="Using Nautilus-Actions Configuration Tool">Using <span class="application">Nautilus-Actions Configuration Tool</span></a>
429
<span class="label">4. </span><a class="xref" href="nautilus-actions-config-tool.html#misc" title="Miscellaneous informations">Miscellaneous informations</a>
432
<span class="label">5. </span><a class="xref" href="nautilus-actions-config-tool.html#bugs" title="Errores conocidos y limitaciones">Errores conocidos y limitaciones</a>
435
<span class="label">6. </span><a class="xref" href="nautilus-actions-config-tool.html#about" title="About Nautilus-Actions Configuration Tool">About <span class="application">Nautilus-Actions Configuration Tool</span></a>
438
<span class="label">A. </span><a class="xref" href="nautilus-actions-config-tool.html#appendix-gnu-fdl" title="GNU Free Documentation License">GNU Free Documentation License</a>
441
<div class="division sect1">
442
<a name="introduction"></a><div class="header"><h2 class="sect1 title"><span class="title"><span class="label">1. </span>Introducción</span></h2></div>
443
<p class="para block block-first">
444
<span class="productname">Nautilus-Actions™</span> is a <span class="productname">Nautilus™</span> extension whose principal function
445
is to allow the user to add arbitrary actions to the file manager
446
context menus. These actions may be organized in menus and submenus,
447
exported and shared with other desktop environments.
449
<p class="para block">
450
The <span class="application">Nautilus-Actions Configuration Tool</span> application is the user interface which lets you precisely
451
configure how, where and when your actions should appear in <span class="productname">Nautilus™</span>
452
context menus, and how they will be executed.
454
<p class="para block">
455
<span class="application">Nautilus-Actions Configuration Tool</span> provides the following features:
457
<div class="block list itemizedlist"><ul class="itemizedlist">
458
<li class="li-first">
459
<span class="para">Define and configure actions from scratch.</span>
462
<span class="para">Organize actions into menus, submenus and so on.</span>
465
<span class="para">Import and export actions and menus from and to outside world.</span>
468
<div class="admonition block note block-indent"><div class="note-inner">
469
<p class="para block block-first">
470
<span class="productname">Nautilus-Actions™</span> also comes with additional features such as:
472
<div class="block list itemizedlist"><ul class="itemizedlist">
473
<li class="li-first">
474
<p class="para block block-first">
475
A <span class="productname">Nautilus™</span> plugin which exports in real time to D-Bus the currently
480
<p class="para block block-first">
481
A command-line program which is able to run any action.
483
<p class="para block">
484
Associated with the D-Bus interface, this program lets the user
485
run any action from a keyboard shortcut, applying this action
486
to the item(s) currently selected in the file manager.
490
<p class="para block block-first">
491
A command-line program which is able to create a new action.
495
<p class="para block">
496
All these features are more thoroughly described in the global
497
<span class="productname">Nautilus-Actions™</span> documentation.
501
<div class="division sect1">
502
<a name="getting-started"></a><div class="header"><h2 class="sect1 title"><span class="title"><span class="label">2. </span>Inicio</span></h2></div>
503
<div class="autotoc"><ul>
505
<span class="label">2.1. </span><a class="xref" href="nautilus-actions-config-tool.html#getting-started-starting" title="Starting Nautilus-Actions Configuration Tool">Starting <span class="application">Nautilus-Actions Configuration Tool</span></a>
508
<span class="label">2.2. </span><a class="xref" href="nautilus-actions-config-tool.html#getting-started-first-run" title="The first run">The first run</a>
511
<span class="label">2.3. </span><a class="xref" href="nautilus-actions-config-tool.html#getting-started-first-action" title="Creating your first action">Creating your first action</a>
514
<div class="division sect2">
515
<a name="getting-started-starting"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">2.1. </span>Starting <span class="application">Nautilus-Actions Configuration Tool</span></span></h3></div>
516
<p class="para block block-first">
517
You can start <span class="application">Nautilus-Actions Configuration Tool</span> in the following ways:
519
<div class="block list variablelist"><dl class="variablelist">
520
<dt class="term dt-first">Menú <span class="guimenu">Sistema</span>
523
<p class="para block block-first">
525
<span class="menuchoice"><span class="guisubmenu">Preferences</span> ▸ <span class="guisubmenu">Look and Feel</span> ▸ <span class="guimenuitem">Nautilus Actions Configuration Tool</span></span>.
528
<dt class="term">Línea de comandos</dt>
530
<p class="para block block-first">
531
To start <span class="application">Nautilus-Actions Configuration Tool</span> from a command line, type the following command:
533
<p class="para block">
534
<span class="command" dir="ltr"><span class="filename" dir="ltr">nautilus-actions-config-tool</span></span>
536
<p class="para block">
537
then press <span class="keycap">Return</span>.
539
<div class="admonition block tip block-indent"><div class="tip-inner">
540
<p class="para block block-first">
541
To view available command line options, type:
543
<p class="para block">
544
<span class="command" dir="ltr">
545
<span class="filename" dir="ltr">nautilus-actions-config-tool</span>
546
<span class="option" dir="ltr">--help-all</span>
549
<p class="para block">
550
then press <span class="keycap">Return</span>.
556
<div class="division sect2">
557
<a name="getting-started-first-run"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">2.2. </span>The first run</span></h3></div>
558
<p class="para block block-first">
559
When you start <span class="application">Nautilus-Actions Configuration Tool</span>, the following window is displayed.
561
<div class=" block figure block-indent">
562
<a name="nact-FIG-main-empty"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 1</span> </span><span class="application">Nautilus-Actions Configuration Tool</span> Start Up Window</span></div>
563
<div class="figure-inner">
565
<div class=" block screenshot block-first">
566
<div class="mediaobject">
567
<img src="figures/nact-main-empty.png"><div class=" block caption">
568
<p class="para block block-first">The empty <span class="application">Nautilus-Actions Configuration Tool</span> main window</p>
574
<p class="para block">
575
The <span class="application">Nautilus-Actions Configuration Tool</span> main window contains the following elements:
577
<div class="block list variablelist"><dl class="variablelist">
578
<dt class="term dt-first">Barra de menú.</dt>
580
<p class="para block block-first">
581
The menus on the menubar contain all of the commands
582
you need to use in <span class="application">Nautilus-Actions Configuration Tool</span>.
584
<p class="para block">
585
Shortcuts are available for some commands:
587
<div class="block list variablelist"><dl class="variablelist">
588
<dt class="term dt-first">
589
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">N</span></span>
592
<p class="para block block-first">
597
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">S</span></span>
600
<p class="para block block-first">
601
Save modified actions and menus.
605
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">Q</span></span>
608
<p class="para block block-first">
609
Quit the application.
613
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">X</span></span>
616
<p class="para block block-first">
617
Cut the current selection, keeping it in the clipboard.
621
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">C</span></span>
624
<p class="para block block-first">
625
Copy the current selection to the clipboard.
629
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">V</span></span>
632
<p class="para block block-first">
633
Insert the content of the clipboard before the current item.
637
<span class="keycombo"><span class="keycap">Mayús</span>+<span class="keycap">Ctrl</span>+<span class="keycap">V</span></span>
640
<p class="para block block-first">
641
Insert the content of the clipboard as subitem(s) of the current item.
645
<span class="keycombo"><span class="keycap">Eliminar</span></span>
648
<p class="para block block-first">
649
Delete the current selection.
653
<span class="keycombo"><span class="keycap">F5</span></span>
656
<p class="para block block-first">
657
Reload the actions and menus.
661
<span class="keycombo"><span class="keycap">F1</span></span>
664
<p class="para block block-first">
670
<dt class="term">Barra de herramientas.</dt>
672
<p class="para block block-first">
673
Several toolbars may be displayed below the menubar, depending of
675
<span class="menuchoice"><span class="guimenu">View</span> ▸ <span class="guimenuitem">Toolbars</span></span> submenu.
678
<dt class="term">Items list.</dt>
680
<p class="para block block-first">
681
The list on the left of the main window contains all items,
682
whether they are actions or menus, currently available for edition in
683
<span class="application">Nautilus-Actions Configuration Tool</span>.
685
<p class="para block">
686
Items may be sorted in ascending or descending alphabetical order, or
687
not sorted at all, being directly organized and managed by the user.
689
<p class="para block">
690
Invalid items are displayed in red color.
692
<p class="para block">
693
Modified items are displayed in italic characters.
696
<dt class="term">Sort buttons</dt>
698
<p class="para block block-first">
699
Three buttons allow you to toggle between sort modes.
702
<dt class="term">Properties tabs.</dt>
704
<p class="para block block-first">
705
The right part of the main window displays all is needed to define
706
how, when and where actions and menus should be displayed.
708
<div class="block list variablelist"><dl class="variablelist">
709
<dt class="term dt-first">
713
<p class="para block block-first">
714
Define in which <span class="productname">Nautilus™</span> menus the item should appear, and
715
how it will be displayed.
718
<dt class="term">Comando</dt>
720
<p class="para block block-first">
721
Specify which command to execute, and which parameters
725
<dt class="term">Ejecución</dt>
727
<p class="para block block-first">
728
Specify how the command should be executed.
735
<p class="para block block-first">
736
Define the basename filters the <span class="productname">Nautilus™</span> selection must satisfy
737
in order the action or menu be candidate for display.
740
<dt class="term">Tipos MIME</dt>
742
<p class="para block block-first">
743
Define the mimetype filters the <span class="productname">Nautilus™</span> selection must satisfy
744
in order the action or menu be candidate for display.
747
<dt class="term">Carpetas</dt>
749
<p class="para block block-first">
750
Define the folder filters the <span class="productname">Nautilus™</span> selection must satisfy
751
in order the action or menu be candidate for display.
758
<p class="para block block-first">
759
Define the scheme filters the <span class="productname">Nautilus™</span> selection must satisfy
760
in order the action or menu be candidate for display.
763
<dt class="term">Prestaciones</dt>
765
<p class="para block block-first">
766
Define the capability filters the <span class="productname">Nautilus™</span> selection must satisfy
767
in order the action or menu be candidate for display.
770
<dt class="term">Entorno</dt>
772
<p class="para block block-first">
773
Define some environment conditions the <span class="productname">Nautilus™</span> selection must satisfy
774
in order the action or menu be candidate for display.
777
<dt class="term">Propiedades</dt>
779
<p class="para block block-first">
780
Display item properties.
785
<dt class="term">Barra de estado.</dt>
787
<p class="para block block-first">
788
The statusbar displays some status informations about the
789
currently selected row in the items list.
791
<p class="para block">
792
When no relevant information is to be displayed, the statusbar
793
displays the count of loaded menus, actions and profiles.
795
<p class="para block">
796
The « read-only » icon
797
<span class="inlinegraphic"><img src="figures/read-only.png"></span>
799
the right of the statusbar when appropriate.
804
<div class="division sect2">
805
<a name="getting-started-first-action"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">2.3. </span>Creating your first action</span></h3></div>
806
<p class="para block block-first">
807
In this example, we are going to create an action which displays some
808
pretty informations about the current selection.
810
<div class=" block formalpara">
811
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Checking for prerequisites</span></div>
812
<p class="para block block-first">
813
This action will require <span class="productname">Zenity™</span>.
816
<p class="para block">
817
<span class="productname">Zenity™</span> is a program which will allow you to create a graphical
818
user interface from a command-line.
820
<p class="para block">
821
You should check that this program
822
is installed on your system, by example by typing the following command
825
<p class="para block">
826
<span class="command" dir="ltr">
827
<span class="filename" dir="ltr">zenity</span>
830
<p class="para block">
831
then press <span class="keycap">Return</span>.
833
<div class=" block formalpara">
834
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Creating the action</span></div>
835
<p class="para block block-first">
836
To create a new action, choose
837
<span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guisubmenu">New action</span> <span class="shortcut">(
838
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">N</span></span>
842
<p class="para block">
843
A new action is inserted in the items list,
844
and its properties are displayed in the tabs on the right pane.
846
<p class="para block">
847
The label of the currently edited action (this one) is added
848
to the application name in the title bar.
850
<div class=" block figure block-indent">
851
<a name="nact-FIG-tab-action"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 2</span> </span>Default properties of a new action</span></div>
852
<div class="figure-inner">
854
<div class=" block screenshot block-first">
855
<div class="mediaobject">
856
<img src="figures/nact-action-tab.png"><div class=" block caption">
857
<p class="para block block-first">Default properties of a new action</p>
863
<p class="para block">
864
In the <span class="guilabel">Items list</span>, the new action is displayed in italic characters.
866
<p class="para block">
867
Italics are used as a reminder that the item has not yet been saved.
869
<p class="para block">
870
As another reminder that there is some pending modifications,
871
an asterisk (« <span class="literal" dir="ltr">*</span> »)
872
comes to prefix the application name in the title bar.
874
<div class=" block formalpara">
875
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Qualifying your new action</span></div>
876
<p class="para block block-first">
877
It merely consists of choosing how your action will be displayed
878
in the file manager context menu.
881
<div class="block list itemizedlist"><ul class="itemizedlist">
882
<li class="li-first">
883
<p class="para block block-first">
884
Enter <span class="userinput" dir="ltr">My first action</span>
885
in the <span class="guilabel">Context label</span> entry box.
887
<p class="para block">
888
The <span class="guilabel">Context label</span> entry box contains the label
889
of the action as you want it to be displayed in the file manager
892
<p class="para block">
893
The label is a mandatory property of your action. If it happens
894
to be empty, then your action will be considered as invalid by
895
<span class="productname">Nautilus-Actions™</span>: it will be displayed in red in <span class="guilabel">Items list</span>
896
and will never be candidate to be displayed in the
897
file manager context menus.
901
<p class="para block block-first">
902
Enter <span class="userinput" dir="ltr">This will execute an action with some parameters</span>
903
in the <span class="guilabel">Tooltip</span> entry box.
905
<p class="para block">
906
The <span class="guilabel">Tooltip</span> entry box contains the text
907
you want to be displayed as a short help to your action.
911
<p class="para block block-first">
912
Select <span class="userinput" dir="ltr">gtk-about</span> in the <span class="guilabel">Icon</span>
915
<p class="para block">
916
The <span class="guilabel">Icon</span> selection defines the icon which will
917
be associated with your action in file manager context menus and in
920
<p class="para block">
921
You have two ways of choosing the icon associated to your action:
923
<div class="block list itemizedlist"><ul class="itemizedlist">
924
<li class="li-first">
926
Click on the <span class="guilabel">Icon</span> drop-down list to select an icon.
931
Click on <span class="guibutton">Browse</span> to search
932
for an image in the filesystem.
938
<div class=" block formalpara">
939
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Specifying the command to be executed</span></div>
940
<p class="para block block-first">
941
When you will select your action in the file manager
942
context menu, this command will be executed, with
943
arguments of your choice.
946
<p class="para block">
947
Click on the <span class="guilabel">Command</span> tab to show the page
948
which will permit you to enter the command.
950
<div class=" block figure block-indent">
951
<a name="nact-FIG-tab-command"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 3</span> </span>Command page</span></div>
952
<div class="figure-inner">
954
<div class=" block screenshot block-first">
955
<div class="mediaobject">
956
<img src="figures/nact-command-tab.png"><div class=" block caption">
957
<p class="para block block-first">Command page</p>
963
<div class="block list itemizedlist"><ul class="itemizedlist">
964
<li class="li-first">
965
<p class="para block block-first">
966
Enter <span class="userinput" dir="ltr">zenity</span> in the <span class="guilabel">Path</span>
969
<p class="para block">
970
The <span class="guilabel">Path</span> entry box defines the command which
971
will be executed when you will select your action in the file manager
974
<p class="para block">
975
You have two ways of defining the command to be executed:
977
<div class="block list itemizedlist"><ul class="itemizedlist">
978
<li class="li-first">
980
Enter it in the <span class="guilabel">Path</span> entry box.
985
Click on <span class="guibutton">Browse</span> to select
986
the executable file on the filesystem.
990
<p class="para block">
991
If the command you enter does not have an absolute path,
992
then it will be searched for in the <span class="envar" dir="ltr">PATH</span>
993
variable at execution time.
997
<p class="para block block-first">
998
Enter <span class="userinput" dir="ltr">--info --text='%c selected item(s): %U'</span>
999
in the <span class="guilabel">Parameters</span>
1002
<p class="para block">
1003
The <span class="guilabel">Parameters</span> contains the arguments which will
1004
be passed to your command when it will be executed. These arguments may
1005
embed parameters which will be expanded at runtime.
1007
<p class="para block">
1008
If both <span class="guilabel">Path</span> and <span class="guilabel">Parameters</span>
1009
are empty, then this action will be considered as invalid: it will be
1010
displayed in red in <span class="guilabel">Items list</span> and will be
1011
never be candidate to be displayed in the
1012
file manager context menus.
1016
<div class=" block formalpara">
1017
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Guardado</span></div>
1018
<p class="para block block-first">
1019
To save all pending modifications, choose
1020
<span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guisubmenu">Save</span> <span class="shortcut">(
1021
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">S</span></span>
1025
<p class="para block">
1026
<span class="productname">Nautilus™</span> automatically takes into account your new action,
1027
and displays it in its context menu.
1029
<div class=" block figure block-indent">
1030
<a name="nact-FIG-start-nautilus-context"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 4</span> </span>Your first action in the <span class="productname">Nautilus™</span> context menu</span></div>
1031
<div class="figure-inner">
1033
<div class=" block screenshot block-first">
1034
<div class="mediaobject">
1035
<img src="figures/start-context-menu-nautilus.png"><div class=" block caption">
1036
<p class="para block block-first">Your first action in the <span class="productname">Nautilus™</span> context menu</p>
1042
<p class="para block">
1043
Cliking of the item in the <span class="productname">Nautilus™</span> context menu activates it,
1044
and executes the corresponding command.
1046
<div class=" block figure block-indent">
1047
<a name="nact-FIG-start-zenity"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 5</span> </span>The result of the execution of your first action</span></div>
1048
<div class="figure-inner">
1050
<div class=" block screenshot block-first">
1051
<div class="mediaobject">
1052
<img src="figures/start-zenity-result.png"><div class=" block caption">
1053
<p class="para block block-first">The result of the execution of your first action</p>
1061
<div class="division sect1">
1062
<a name="usage"></a><div class="header"><h2 class="sect1 title"><span class="title"><span class="label">3. </span>Using <span class="application">Nautilus-Actions Configuration Tool</span></span></h2></div>
1063
<div class="autotoc"><ul>
1065
<span class="label">3.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions" title="Defining the conditions">Defining the conditions</a>
1068
<span class="label">3.2. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-where" title="Locating the action">Locating the action</a>
1071
<span class="label">3.3. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution" title="What the action should it execute ?">What the action should it execute ?</a>
1074
<span class="label">3.4. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-profile" title="Using profiles to extend your action">Using profiles to extend your action</a>
1077
<span class="label">3.5. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-menus" title="Organizing actions in menus">Organizing actions in menus</a>
1080
<span class="label">3.6. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-sorting" title="Sorting the items list">Sorting the items list</a>
1083
<span class="label">3.7. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-edit" title="Editando">Editando</a>
1086
<span class="label">3.8. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-save" title="Saving your modifications">Saving your modifications</a>
1089
<span class="label">3.9. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-export" title="Exporting your actions">Exporting your actions</a>
1092
<span class="label">3.10. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-import" title="Acciones de importación">Acciones de importación</a>
1095
<span class="label">3.11. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-prefs" title="Setting your own preferences">Setting your own preferences</a>
1098
<div class="division sect2">
1099
<a name="usage-conditions"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.1. </span>Defining the conditions</span></h3></div>
1100
<p class="para block block-first">
1101
Whether your action will eventually be displayed in <span class="productname">Nautilus™</span> file manager
1102
context menus or in its toolbar depends of the conditions you will have
1105
<p class="para block">
1106
Conditions may be put against the location the file manager currently
1107
points to, or against the currently selected items in this location.
1109
<p class="para block">
1110
Each time the selection or the location change in the file manager,
1111
<span class="productname">Nautilus-Actions™</span> checks all your actions, comparing the defined conditions
1112
against the new location and selection: all defined conditions must
1113
be satisfied in order your action be actually displayed.
1115
<div class="autotoc"><ul>
1117
<span class="label">3.1.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-basenames" title="Basename-based conditions">Basename-based conditions</a>
1120
<span class="label">3.1.2. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-mimetypes" title="Mimetype-based conditions">Mimetype-based conditions</a>
1123
<span class="label">3.1.3. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-folders" title="Folder-based conditions">Folder-based conditions</a>
1126
<span class="label">3.1.4. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-schemes" title="Scheme-base-conditions">Scheme-base-conditions</a>
1129
<span class="label">3.1.5. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-capabilities" title="Capability-based conditions">Capability-based conditions</a>
1132
<span class="label">3.1.6. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-count" title="Selection count condition">Selection count condition</a>
1135
<span class="label">3.1.7. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-desktop" title="Desktop selection">Desktop selection</a>
1138
<span class="label">3.1.8. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-executable" title="Executable found condition">Executable found condition</a>
1141
<span class="label">3.1.9. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-dbus" title="D-Bus registration condition">D-Bus registration condition</a>
1144
<span class="label">3.1.10. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-true" title="Customized condition">Customized condition</a>
1147
<span class="label">3.1.11. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-conditions-run" title="Running process condition">Running process condition</a>
1150
<div class="division sect3">
1151
<a name="usage-conditions-basenames"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.1. </span>Basename-based conditions</span></h4></div>
1152
<p class="para block block-first">
1153
You may decide that your action will appear depending on the basenames
1154
of the items currently selected in the file-manager: you may define that each
1155
item of the selection must meet some sort of basename, and you may simultaneously
1156
decide that none of the selected item(s) can have some other sort of basename.
1158
<p class="para block">
1159
Click on the <span class="guilabel">Basenames</span> tab to show the page
1160
which will permit you to configure your basename-based conditions.
1162
<div class=" block figure block-indent">
1163
<a name="nact-FIG-tab-basenames"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 6</span> </span>Basename-based conditions</span></div>
1164
<div class="figure-inner">
1166
<div class=" block screenshot block-first">
1167
<div class="mediaobject">
1168
<img src="figures/nact-basenames-tab.png"><div class=" block caption">
1169
<p class="para block block-first">The basename-based conditions tab</p>
1175
<p class="para block">
1176
In fact, basename-based conditions are built as a list of
1177
« must match one of » and « must not match any of »
1178
patterns. In order you action be candidate regarding of these basename-based
1179
conditions, each element of the selection must be valid for all the listed
1180
conditions: the basename of each element must match at least one of the defined
1181
« must match one of » patterns, and must not match any of
1182
the defined « must not match any of » patterns.
1184
<p class="para block">
1185
If at least one element of the selection does not match all the defined
1186
conditions, then your action will not be displayed.
1188
<p class="para block">
1189
When targeting the selection context menu, your basename-based conditions
1190
will be checked against the currently selected items. When targeting the
1191
location context menu or the toolbar, your basename-based conditions will
1192
be checked against the basename of the current location.
1194
<p class="para block">
1195
Defining a new basename-based condition involves two steps.
1197
<div class="block list orderedlist"><ol class="orderedlist">
1198
<li class="li-first">
1199
<p class="para block block-first">
1200
Define the new condition filter.
1202
<div class="block list itemizedlist"><ul class="itemizedlist">
1203
<li class="li-first">
1204
<p class="para block block-first">
1205
Press <span class="keycap">Insert</span> or click on
1206
<span class="guibutton"><span class="inlinegraphic"><img src="figures/add.png"></span></span>
1207
button to insert a new condition filter
1211
<p class="para block block-first">
1212
Edit the newly inserted condition filter to the basename you want match.
1214
<div class="admonition block tip block-indent"><div class="tip-inner">
1215
<p class="para block block-first">
1216
A basename-based condition may use « <span class="literal" dir="ltr">*</span> » or
1217
« <span class="literal" dir="ltr">?</span> » wildcard characters.
1224
<p class="para block block-first">
1225
Indicates whether this a « must match one of »
1226
or a « must not match any of » condition.
1228
<p class="para block">
1229
Click on the <span class="guilabel">Must match one of</span> or
1230
<span class="guilabel">Must not match any of</span> radio button in the same
1231
row to set the corresponding condition.
1235
<p class="para block">
1236
Depending of your target operating system, make sure that the
1237
<span class="guilabel">Match case</span> checkbox is activated (or not).
1239
<div class="block list itemizedlist"><ul class="itemizedlist">
1240
<li class="li-first">
1241
<p class="para block block-first">
1242
When activated, all filters are considered as case sensitive,
1243
which means that <span class="filename" dir="ltr">/my/file</span> filename is
1244
considered distinct from <span class="filename" dir="ltr">/My/File</span> one.
1246
<p class="para block">
1247
This is the default behavior on Unix-like systems.
1251
<p class="para block block-first">
1252
When disactivated, filters are considered as case insensitive,
1253
which means that <span class="filename" dir="ltr">/my/file</span> and
1254
<span class="filename" dir="ltr">/My/File</span> filenames are considered the same
1257
<p class="para block">
1258
This is most probably what you want if you target some sort of
1259
<span class="productname">Windows™</span> system.
1263
<p class="para block">
1264
By default, the basename-based condition is just one
1265
« <span class="literal" dir="ltr">must match one of *</span> » condition.
1266
As all basenames always match the « <span class="literal" dir="ltr">*</span> »
1267
condition, this just means that basename-based conditions are not
1268
considered as relevant for the action.
1271
<div class="division sect3">
1272
<a name="usage-conditions-mimetypes"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.2. </span>Mimetype-based conditions</span></h4></div>
1273
<p class="para block block-first">
1274
You may decide that your action will appear depending on the mimetypes
1275
of the items currently selected in the file-manager: you may define that each
1276
item of the selection must meet some sort of mimetype; and you may simultaneously
1277
decide that none of the selected item(s) can have some other sort of mimetype.
1279
<p class="para block">
1280
Click on the <span class="guilabel">Mimetypes</span> tab to show the page
1281
which will permit you to configure your mimetype-based conditions.
1283
<div class=" block figure block-indent">
1284
<a name="nact-FIG-tab-mimetypes"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 7</span> </span>Mimetype-based conditions</span></div>
1285
<div class="figure-inner">
1287
<div class=" block screenshot block-first">
1288
<div class="mediaobject">
1289
<img src="figures/nact-mimetypes-tab.png"><div class=" block caption">
1290
<p class="para block block-first">The mimetype-based conditions tab</p>
1296
<p class="para block">
1297
In fact, mimetype-based conditions are built as a list of
1298
« must match one of » and « must not match any of » patterns.
1299
In order you action be candidate regarding of these mimetype-based
1300
conditions, each element of the selection must be valid for all the listed
1301
conditions: the mimetype of each element must match at least one of the defined
1302
« must match one of » patterns, and must not match any of
1303
the defined « must not match any of » patterns.
1305
<p class="para block">
1306
If at least one element of the selection does not match all the defined
1307
conditions, then your action will not be displayed.
1309
<p class="para block">
1310
When targeting the selection context menu, your mimetype-based conditions
1311
will be checked against the currently selected items. When targeting the
1312
location context menu or the toolbar, your mimetype-based conditions will
1313
be checked against the mimetype of the current location, which happens to
1314
be the well known « inode/directory » mimetype.
1316
<p class="para block">
1317
Defining a new mimetype-based condition involves two steps.
1319
<div class="block list orderedlist"><ol class="orderedlist">
1320
<li class="li-first">
1321
<p class="para block block-first">
1322
Define the new condition filter.
1324
<div class="block list itemizedlist"><ul class="itemizedlist">
1325
<li class="li-first">
1326
<p class="para block block-first">
1327
Press <span class="keycap">Insert</span> or click on
1328
<span class="guibutton"><span class="inlinegraphic"><img src="figures/add.png"></span></span>
1329
button to insert a new condition filter
1333
<p class="para block block-first">
1334
Edit the newly inserted condition filter to the mimetype you want match.
1336
<p class="para block">
1337
A mimetype must be defined as a <span class="literal" dir="ltr">group/subgroup</span>
1340
<div class="admonition block tip block-indent"><div class="tip-inner">
1341
<p class="para block block-first">
1342
The « <span class="literal" dir="ltr">*</span> » wildcard is supported only in some situations:
1344
<div class="block list itemizedlist"><ul class="itemizedlist">
1345
<li class="li-first">
1347
The « <span class="literal" dir="ltr">*/*</span> » expression
1348
matches all mimetypes. As a convenient shortcut, the
1349
« <span class="literal" dir="ltr">*</span> » literal is also accepted for this same purpose.
1354
A <span class="literal" dir="ltr">group/*</span> string
1355
matches all subgroups of <span class="literal" dir="ltr">group</span> mimetype.
1360
<div class="admonition block note block-indent"><div class="note-inner">
1361
<p class="para block block-first">
1362
The <span class="literal" dir="ltr">*/subgroup</span> string
1363
is not accepted as a valid wildcard.
1370
<p class="para block block-first">
1371
Indicates whether this a « must match one of » or a « must not match any of » condition.
1373
<p class="para block">
1374
Click on the <span class="guilabel">Must match one of</span> or
1375
<span class="guilabel">Must not match any of</span> radio button in the same
1376
row to set the corresponding condition.
1380
<p class="para block">
1381
By default, the mimetype-based condition is just one
1382
« <span class="literal" dir="ltr">must match one of */*</span> » condition.
1383
As all mimetypes always match the « <span class="literal" dir="ltr">*/*</span> »,
1384
this just means that mimetypes are not considered as relevant
1387
<div class=" block example block-indent">
1388
<div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Ejemplo 1</span> </span>Example of usual mimetypes</span></div>
1389
<div class="example-inner">
1391
<div class="block list variablelist"><dl class="variablelist">
1392
<dt class="term dt-first">
1396
<p class="para block block-first">
1404
<p class="para block block-first">
1405
Matches all regular files.
1412
<p class="para block block-first">
1413
Matches only directories.
1420
<div class="division sect3">
1421
<a name="usage-conditions-folders"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.3. </span>Folder-based conditions</span></h4></div>
1422
<p class="para block block-first">
1423
You may decide that your action will appear depending on the directory
1424
the items currently selected in the file-manager are located in:
1425
you may define that each item of the selection must be located in one
1426
hierarchy or in another; and you may simultaneously
1427
decide that none of the selected item(s) can be located in some other
1430
<p class="para block">
1431
A folder-based condition must be understood as the specification
1432
of the hierarchy in which the currently examined item should (or
1433
should not) stay: this is a pattern on the dirname of the element.
1435
<p class="para block">
1436
Click on the <span class="guilabel">Folders</span> tab to show the page
1437
which will permit you to configure your folder-based conditions.
1439
<div class=" block figure block-indent">
1440
<a name="nact-FIG-tab-folders"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 8</span> </span>Folder-based conditions</span></div>
1441
<div class="figure-inner">
1443
<div class=" block screenshot block-first">
1444
<div class="mediaobject">
1445
<img src="figures/nact-folders-tab.png"><div class=" block caption">
1446
<p class="para block block-first">The folder-based conditions tab</p>
1452
<p class="para block">
1453
In fact, folder-based conditions are built as a list of
1454
« must match one of » and « must not match any of » patterns.
1455
In order you action be candidate regarding of these folder-based
1456
conditions, each element of the selection must be valid for all the
1457
listed conditions: each element must located in one of the defined
1458
« must match one of » folders, and must not match any of the defined
1459
« must not match any of » folders.
1461
<p class="para block">
1462
If at least one element of the selection does not match all the
1463
defined conditions, then your action will not be displayed.
1465
<p class="para block">
1466
When targeting the selection context menu, your folder-based
1467
conditions will be checked against the dirname of each currently
1469
When targeting the location context menu or the toolbar,
1470
your folder-based conditions will be checked against the current
1473
<p class="para block">
1474
Defining a new folder-based condition involves two steps.
1476
<div class="block list orderedlist"><ol class="orderedlist">
1477
<li class="li-first">
1478
<p class="para block block-first">
1479
Define the new condition filter.
1481
<div class="block list itemizedlist"><ul class="itemizedlist">
1482
<li class="li-first">
1483
<p class="para block block-first">
1484
Press <span class="keycap">Insert</span> or click on
1485
<span class="guibutton"><span class="inlinegraphic"><img src="figures/add.png"></span></span>
1486
button to insert a new condition filter
1490
<p class="para block block-first">
1491
Edit the newly inserted condition filter to the folder you want match.
1493
<div class="admonition block tip block-indent"><div class="tip-inner">
1494
<p class="para block block-first">
1495
The « <span class="literal" dir="ltr">*</span> » and « <span class="literal" dir="ltr">?</span> » characters
1496
are accepted as wildcards at any level of the defined
1502
<p class="para block block-first">
1504
<span class="guibutton">Browse</span> to select a folder on the filesystem.
1510
<p class="para block block-first">
1511
Indicates whether this a « must match one of » or a « must not match any of »
1514
<p class="para block">
1515
Click on the <span class="guilabel">Must match one of</span> or
1516
<span class="guilabel">Must not match any of</span> radio button in the same
1517
row to set the corresponding condition.
1521
<p class="para block">
1522
By default, the folder-based condition is just one
1523
« <span class="literal" dir="ltr">must match one of /</span> » condition.
1524
As <span class="literal" dir="ltr">/</span> is always the top of an Unix-like filesystem,
1525
then all selected items always match this condition.
1527
<div class="admonition block note block-indent"><div class="note-inner">
1528
<p class="para block block-first">
1529
If you target a <span class="productname">Windows™</span> system, then this default value may
1530
not be what you actually want.
1534
<div class="division sect3">
1535
<a name="usage-conditions-schemes"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.4. </span>Scheme-base-conditions</span></h4></div>
1536
<p class="para block block-first">
1537
You may decide that your action will appear depending on the schemes
1538
of the URIs of the items currently selected in the file-manager:
1539
you may define that each item of the selection must have some scheme;
1540
and you may simultaneously
1541
decide that none of the selected item(s) may have some other scheme.
1543
<p class="para block">
1544
Click on the <span class="guilabel">Schemes</span> tab to show the page
1545
which will permit you to configure your scheme-based conditions.
1547
<div class=" block figure block-indent">
1548
<a name="nact-FIG-tab-schemes"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 9</span> </span>Scheme-based conditions</span></div>
1549
<div class="figure-inner">
1551
<div class=" block screenshot block-first">
1552
<div class="mediaobject">
1553
<img src="figures/nact-schemes-tab.png"><div class=" block caption">
1554
<p class="para block block-first">The scheme-based conditions tab</p>
1560
<p class="para block">
1561
In fact, scheme-based conditions are built as a list of
1562
« must match one of » and « must not match any of » patterns.
1563
In order you action be candidate regarding of these scheme-based
1564
conditions, each element of the selection must be valid for all the
1565
listed conditions: the scheme of each element must match at least one
1566
of the defined « must match one of » patterns, and must not match any of
1567
the defined « must not match any of » patterns.
1569
<p class="para block">
1570
If at least one element of the selection does not match all the defined
1571
conditions, then your action will not be displayed.
1573
<p class="para block">
1574
When targeting the selection context menu, your scheme-based conditions
1575
will be checked against the currently selected items. When targeting the
1576
location context menu or the toolbar, your scheme-based conditions will
1577
be checked against the scheme of the current location.
1579
<p class="para block">
1580
Defining a new scheme-based condition involves two steps.
1582
<div class="block list orderedlist"><ol class="orderedlist">
1583
<li class="li-first">
1584
<p class="para block block-first">
1585
Define the new condition filter.
1587
<div class="block list itemizedlist"><ul class="itemizedlist">
1588
<li class="li-first">
1589
<p class="para block block-first">
1590
Press <span class="keycap">Insert</span> or click on
1591
<span class="guibutton"><span class="inlinegraphic"><img src="figures/add.png"></span></span>
1592
button to insert a new condition filter
1596
<p class="para block block-first">
1597
Edit the newly inserted condition filter to the scheme you want match.
1599
<div class="admonition block tip block-indent"><div class="tip-inner">
1600
<p class="para block block-first">
1601
Scheme-based conditions only accept « <span class="literal" dir="ltr">*</span> » wildcard,
1602
which stands for « any scheme ».
1607
<p class="para block block-first">
1609
<span class="guibutton">Common</span> to select a scheme among those
1611
<span class="menuchoice"><span class="guimenu">Edit</span> ▸ <span class="guimenuitem">Preferences</span></span>.
1613
<div class=" block figure block-indent">
1614
<a name="nact-FIG-add-scheme"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 10</span> </span>Selecting a scheme among predefined defaults</span></div>
1615
<div class="figure-inner">
1617
<div class=" block screenshot block-first">
1618
<div class="mediaobject">
1619
<img src="figures/nact-new-scheme.png"><div class=" block caption">
1620
<p class="para block block-first">Selecting a scheme among predefined defaults</p>
1626
<p class="para block">
1627
A new scheme may only be selected here if it is not already
1628
defined as a scheme filter.
1630
<p class="para block">
1631
To select a new scheme, click <span class="guibutton">OK</span>, or
1632
double-click on the desired row.
1638
<p class="para block block-first">
1639
Indicates whether this a « must match one of » or a « must not match any of » condition.
1641
<p class="para block">
1642
Click on the <span class="guilabel">Must match one of</span> or
1643
<span class="guilabel">Must not match any of</span> radio button
1644
in the same row to set the corresponding condition.
1648
<p class="para block">
1649
By default, the scheme-based condition is just one
1650
« <span class="literal" dir="ltr">must match one of *</span> » condition,
1651
which means that schemes are not relevant for this action.
1654
<div class="division sect3">
1655
<a name="usage-conditions-capabilities"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.5. </span>Capability-based conditions</span></h4></div>
1656
<p class="para block block-first">
1657
Capabilities are some properties that a file may exhibit to the user.
1659
<p class="para block">
1660
But the <span class="literal" dir="ltr">Local</span> capability, all others are dependant
1661
of the user who executes the command.
1663
<p class="para block">
1664
You may so decide that your action will appear, or not, depending
1665
on the capabilities of the selected item(s) <span class="abbrev">vs.</span>
1668
<p class="para block">
1669
Click on the <span class="guilabel">Capabilities</span> tab to show the page
1670
which will permit you to configure your capability-based conditions.
1672
<div class=" block figure block-indent">
1673
<a name="nact-FIG-tab-capabilities"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 11</span> </span>Capability-based conditions</span></div>
1674
<div class="figure-inner">
1676
<div class=" block screenshot block-first">
1677
<div class="mediaobject">
1678
<img src="figures/nact-capabilities-tab.png"><div class=" block caption">
1679
<p class="para block block-first">The capability-based conditions tab</p>
1685
<p class="para block">
1686
In fact, capability-based conditions are built as a list of
1687
« must match all of » and « must not match any of » patterns.
1688
In order you action be candidate regarding of these capability-based
1689
conditions, each element of the selection must be valid for all the
1690
listed conditions: the capability of each element must match each
1691
of the defined « must match all of » capabilities,
1692
and must not match any of the defined « must not match any of » ones.
1694
<p class="para block">
1695
If at least one element of the selection does not match all the defined
1696
conditions, then your action will not be displayed.
1698
<p class="para block">
1699
When targeting the selection context menu, your capability-based conditions
1700
will be checked against the currently selected items. When targeting the
1701
location context menu or the toolbar, your capability-based conditions will
1702
be checked against those of of the current location.
1704
<p class="para block">
1705
Defining a new capability-based condition involves two steps.
1707
<div class="block list orderedlist"><ol class="orderedlist">
1708
<li class="li-first">
1709
<p class="para block block-first">
1710
Define the new condition filter.
1712
<div class="block list itemizedlist"><ul class="itemizedlist">
1713
<li class="li-first">
1714
<p class="para block block-first">
1715
Press <span class="keycap">Insert</span> to insert a new condition filter
1719
<p class="para block block-first">
1720
Edit the newly inserted condition filter to the capability you want match.
1724
<p class="para block block-first">
1726
<span class="guibutton"><span class="inlinegraphic"><img src="figures/add.png"></span></span>
1727
to open the <span class="guilabel">Adding a new capability</span> dialog
1730
<div class=" block figure block-indent">
1731
<a name="nact-FIG-add-capability"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 12</span> </span>Managed capabilities</span></div>
1732
<div class="figure-inner">
1734
<div class=" block screenshot block-first">
1735
<div class="mediaobject">
1736
<img src="figures/nact-new-capability.png"><div class=" block caption">
1737
<p class="para block block-first">The list of managed capabilities</p>
1743
<p class="para block">
1744
A new capability may only be selected here if it is not already
1745
defined as a capability filter.
1747
<p class="para block">
1748
To select a new capability, click <span class="guibutton">OK</span>, or
1749
double-click on the desired row.
1755
<p class="para block block-first">
1756
Indicates whether this a « must match all of »
1757
or a « must not match any of » condition.
1759
<p class="para block">
1760
Click on the <span class="guilabel">Must match all of</span> or
1761
<span class="guilabel">Must not match any of</span> radio button in the same
1762
row to set the corresponding condition.
1766
<p class="para block">
1767
By default, the capability-based condition list is empty. This means
1768
that capabilities are not relevant for this action.
1771
<div class="division sect3">
1772
<a name="usage-conditions-count"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.6. </span>Selection count condition</span></h4></div>
1773
<p class="para block block-first">
1774
You may define that your action will only appear if the current
1775
selection in the file manager has some precise count, or some
1776
precise relation with a given count.
1778
<div class=" block example block-indent">
1779
<div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Ejemplo 2</span> </span>A selection count use case</span></div>
1780
<div class="example-inner">
1782
<p class="para block block-first">
1783
If your action consists in displaying the differences between
1784
two files, you may define here
1785
« <span class="literal" dir="ltr">Count = (equal to) 2</span> ».
1789
<p class="para block">
1790
Click on the <span class="guilabel">Environment</span> tab to show the page
1791
which will permit you to configure your environment-based conditions.
1793
<div class=" block figure block-indent">
1794
<a name="nact-FIG-tab-environment"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 13</span> </span>Environment-based conditions</span></div>
1795
<div class="figure-inner">
1797
<div class=" block screenshot block-first">
1798
<div class="mediaobject">
1799
<img src="figures/nact-environment-tab.png"><div class=" block caption">
1800
<p class="para block block-first">The environment-based conditions tab</p>
1806
<p class="para block">
1807
The selection count condition is defined in the
1808
<span class="guilabel">Appears if selection contains</span> frame.
1810
<div class=" block figure block-indent">
1811
<a name="nact-FIG-frame-count"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 14</span> </span>Selection count condition frame</span></div>
1812
<div class="figure-inner">
1814
<div class=" block screenshot block-first">
1815
<div class="mediaobject">
1816
<img src="figures/nact-selection-count-frame.png"><div class=" block caption">
1817
<p class="para block block-first">Selection count condition frame</p>
1823
<p class="para block">
1824
When targeting the selection context menu, the count condition
1825
defined here will be checked against the count of currently
1826
selected items. When targeting the location context menu or
1827
the toolbar, the count condition will be checked against zero
1828
because there is no selected item in this case.
1830
<p class="para block">
1831
To define a selection count condition:
1833
<div class="block list itemizedlist"><ul class="itemizedlist">
1834
<li class="li-first">
1835
<p class="para block block-first">
1836
Select in the <span class="guilabel">Count</span> drop-down list
1837
the operator you want apply to the selection count:
1839
<div class="block list simplelist"><table class="simplelist">
1840
<tr><td class="td-first"><span class="member"><span class="literal" dir="ltr"><</span> (strictly less than)</span></td></tr>
1841
<tr><td class="td-first"><span class="member"><span class="literal" dir="ltr">=</span> (igual a)</span></td></tr>
1842
<tr><td class="td-first"><span class="member"><span class="literal" dir="ltr">></span> (strictly greather than)</span></td></tr>
1846
<p class="para block block-first">
1847
Enter the reference count you wish.
1851
<p class="para block">
1852
The selection count defaults to
1853
« <span class="literal" dir="ltr">Count > (strictly greater than) 0</span> »,
1854
which means that the action will be candidate to be displayed
1855
as soon as at least one item is selected in the file manager.
1858
<div class="division sect3">
1859
<a name="usage-conditions-desktop"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.7. </span>Desktop selection</span></h4></div>
1860
<p class="para block block-first">
1861
You may define that your action:
1863
<div class="block list itemizedlist"><ul class="itemizedlist">
1864
<li class="li-first">
1871
or will only appear in some given desktop environments,
1876
or will not appear in some given desktop environments.
1880
<p class="para block">
1881
Only one choice between these three items is possible.
1883
<p class="para block">
1884
Click on the <span class="guilabel">Environment</span> tab to show the page
1885
which will permit you to configure your environment-based conditions.
1887
<p class="para block">
1888
The desktop selection is defined in the
1889
<span class="guilabel">Desktop environment</span> frame.
1891
<div class=" block figure block-indent">
1892
<a name="nact-FIG-frame-desktop"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 15</span> </span>Desktop selection frame</span></div>
1893
<div class="figure-inner">
1895
<div class=" block screenshot block-first">
1896
<div class="mediaobject">
1897
<img src="figures/nact-desktop-environment-frame.png"><div class=" block caption">
1898
<p class="para block block-first">Desktop selection frame</p>
1904
<p class="para block">
1905
To define the desktop environment condition:
1907
<div class="block list orderedlist"><ol class="orderedlist">
1908
<li class="li-first">
1909
<p class="para block block-first">
1910
First select the type of filter:
1912
<div class="block list simplelist"><table class="simplelist">
1913
<tr><td class="td-first"><span class="member">does your action should always appear, regarding of
1914
the desktop environment ?</span></td></tr>
1915
<tr><td class="td-first"><span class="member">does your action should only appear in some desktop
1916
environment(s) ?</span></td></tr>
1917
<tr><td class="td-first"><span class="member">does your action should never appear in some
1918
desktop environment(s) ?</span></td></tr>
1922
<p class="para block block-first">
1923
If your action should not always appear, then
1924
select the relevant desktop environment(s) in the listbox
1929
<p class="para block">
1930
The targeted desktop environment condition defaults to
1931
« <span class="literal" dir="ltr">Always appear</span> »,
1932
which means that the action will be candidate to be displayed
1933
regarding of the current desktop environment.
1936
<div class="division sect3">
1937
<a name="usage-conditions-executable"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.8. </span>Executable found condition</span></h4></div>
1938
<p class="para block block-first">
1939
You may define that your action will only appear if some
1940
prerequisite package is installed on your system. This is
1941
checked here by specifying that a specific file, known or
1942
at least supposed to be provided by the package, must be
1943
present on the filesystem, and executable.
1945
<p class="para block">
1946
Click on the <span class="guilabel">Environment</span> tab to show the page
1947
which will permit you to configure your environment-based conditions.
1949
<p class="para block">
1950
The executable found condition is defined in the
1951
<span class="guilabel">Execution environment</span> frame.
1953
<div class=" block figure block-indent">
1954
<a name="nact-FIG-frame-execution-environment"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 16</span> </span>Execution environment frame</span></div>
1955
<div class="figure-inner">
1957
<div class=" block screenshot block-first">
1958
<div class="mediaobject">
1959
<img src="figures/nact-execution-environment-frame.png"><div class=" block caption">
1960
<p class="para block block-first">Execution environment frame</p>
1966
<p class="para block">
1967
To define the relevant file, enter its full filename in the
1968
<span class="guilabel">Appears if the file is executable</span> entry
1969
box, or click on <span class="guibutton">Browse</span> to select a file
1972
<p class="para block">
1973
Leave the field empty if this condition is not relevant for
1976
<div class="admonition block tip block-indent"><div class="tip-inner">
1977
<p class="para block block-first">
1978
You may embed some parameters in the searched filename.
1979
These parameters will be dynamically substituted at runtime with values
1980
which will depend of currently selected item(s).
1984
<div class="division sect3">
1985
<a name="usage-conditions-dbus"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.9. </span>D-Bus registration condition</span></h4></div>
1986
<p class="para block block-first">
1987
You may define that your action will only appear if some given
1988
name is registered on D-Bus system at runtime.
1990
<p class="para block">
1991
Click on the <span class="guilabel">Environment</span> tab to show the page
1992
which will permit you to configure your environment-based conditions,
1993
and focus on <span class="guilabel">Execution environment</span> frame.
1995
<p class="para block">
1996
To define the relevant name, enter it in the
1997
<span class="guilabel">Appears if the name is registered on D-Bus</span>
2000
<p class="para block">
2001
Leave the field empty if this condition is not relevant for
2004
<div class="admonition block tip block-indent"><div class="tip-inner">
2005
<p class="para block block-first">
2006
You may embed some parameters in the searched name.
2007
These parameters will be dynamically substituted at runtime with values
2008
which will depend of currently selected item(s).
2012
<div class="division sect3">
2013
<a name="usage-conditions-true"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.10. </span>Customized condition</span></h4></div>
2014
<p class="para block block-first">
2015
You may define that your action will only appear if some given
2016
command outputs a <span class="literal" dir="ltr">true</span> string on its standard
2019
<p class="para block">
2020
Click on the <span class="guilabel">Environment</span> tab to show the page
2021
which will permit you to configure your environment-based conditions,
2022
and focus on <span class="guilabel">Execution environment</span> frame.
2024
<p class="para block">
2025
This lets you define your own customized condition filter,
2026
by writing a small script which outputs, or not, the
2027
<span class="literal" dir="ltr">true</span> string on stdout when it is ran.
2029
<p class="para block">
2030
To define the command, enter it in the
2031
<span class="guilabel">Appears if the command outputs "true"</span>
2034
<p class="para block">
2035
Leave the field empty if this condition is not relevant for
2038
<div class="admonition block tip block-indent"><div class="tip-inner">
2039
<p class="para block block-first">
2040
You may embed some parameters in the executed filename or its options.
2041
These parameters will be dynamically substituted at runtime with values
2042
which will depend of currently selected item(s).
2046
<div class="division sect3">
2047
<a name="usage-conditions-run"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.1.11. </span>Running process condition</span></h4></div>
2048
<p class="para block block-first">
2049
You may define that your action will only appear if some given
2050
binary is currently running.
2052
<p class="para block">
2053
Click on the <span class="guilabel">Environment</span> tab to show the page
2054
which will permit you to configure your environment-based conditions,
2055
and focus on <span class="guilabel">Execution environment</span> frame.
2057
<p class="para block">
2058
To define the binary, enter its name in the
2059
<span class="guilabel">Appears if the binary is running</span>
2060
entry box, or click on <span class="guibutton">Browse</span> to select
2061
a file on the filesystem.
2063
<div class="admonition block note block-indent"><div class="note-inner">
2064
<p class="para block block-first">
2065
Even if you enter here the full filename of a binary, only
2066
its basename will be searched for in the processes list
2070
<p class="para block">
2071
Leave the field empty if this condition is not relevant for
2074
<div class="admonition block tip block-indent"><div class="tip-inner">
2075
<p class="para block block-first">
2076
You may embed some parameters in the searched name.
2077
These parameters will be dynamically substituted at runtime with values
2078
which will depend of currently selected item(s).
2083
<div class="division sect2">
2084
<a name="usage-where"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.2. </span>Locating the action</span></h3></div>
2085
<div class=" block figure block-first block-indent">
2086
<a name="nact-FIG-target-location-where"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 17</span> </span>Target configuration</span></div>
2087
<div class="figure-inner">
2089
<div class=" block screenshot block-first">
2090
<div class="mediaobject">
2091
<img src="figures/nact-target-location.png"><div class=" block caption">
2092
<p class="para block block-first">Target configuration</p>
2098
<p class="para block">
2099
<span class="productname">Nautilus™</span> file manager may display your action in different places,
2100
depending on what you will request here, and if some item is currently
2103
<p class="para block">
2104
Click on the <span class="guilabel">Action</span> tab to show the page
2105
which will permit you to configure the locations your action
2108
<div class="autotoc"><ul>
2110
<span class="label">3.2.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-where-selection" title="Targeting the selection context menu">Targeting the selection context menu</a>
2113
<span class="label">3.2.2. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-where-location" title="Targeting the location context menu">Targeting the location context menu</a>
2116
<span class="label">3.2.3. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-where-toolbar" title="Targeting the toolbar">Targeting the toolbar</a>
2119
<span class="label">3.2.4. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-where-notes" title="Notas">Notas</a>
2122
<div class="division sect3">
2123
<a name="usage-where-selection"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.2.1. </span>Targeting the selection context menu</span></h4></div>
2124
<p class="para block block-first">
2125
When <span class="guilabel">Display item in selection context menu</span>
2126
is checked, then your action will be candidate to be displayed in
2127
<span class="productname">Nautilus™</span> context menu as soon as at least one item is selected in
2128
the file manager. Your action will so deal with currently selected
2129
item(s).In order to be
2130
actually displayed, all the conditions defined in
2131
your candidate action must be met by each item currently selected
2132
in the <span class="productname">Nautilus™</span> file manager.
2134
<div class="admonition block tip block-indent"><div class="tip-inner">
2135
<p class="para block block-first">
2136
When an action targets the selection context menu, and is actually
2137
displayed in <span class="productname">Nautilus™</span> context menu, then it is also displayed
2138
in <span class="productname">Nautilus™</span> <span class="guimenu">Edit</span> menu.
2141
<p class="para block">
2142
This target is checked by default.
2145
<div class="division sect3">
2146
<a name="usage-where-location"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.2.2. </span>Targeting the location context menu</span></h4></div>
2147
<p class="para block block-first">
2148
When <span class="guilabel">Display item in location context menu</span> checkbox
2149
is activated, then your action will be candidate to be displayed in
2150
<span class="productname">Nautilus™</span> context menu when the file manager selection is empty.
2151
Your action will so deal with currently displayed location.
2153
actually displayed, all the conditions defined in
2154
your candidate action must be met by the location currently displayed
2155
in the <span class="productname">Nautilus™</span> file manager.
2157
<div class="admonition block tip block-indent"><div class="tip-inner">
2158
<p class="para block block-first">
2159
When an action targets the location context menu, and is actually
2160
displayed in <span class="productname">Nautilus™</span> context menu, then it is also displayed
2161
in <span class="productname">Nautilus™</span> <span class="guimenu">File</span> menu.
2165
<div class="division sect3">
2166
<a name="usage-where-toolbar"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.2.3. </span>Targeting the toolbar</span></h4></div>
2167
<p class="para block block-first">
2168
When <span class="guilabel">Display item in the toolbar</span> checkbox
2169
is activated, then your action will be candidate to be displayed in
2170
<span class="productname">Nautilus™</span> toolbar.
2172
<p class="para block">
2173
Actions displayed in the toolbar only deal with the location which
2174
is currently displayed in the file-manager, not with the items which
2175
may be currently selected (or not). In order to be displayed, all the
2176
conditions defined in your candidate action must so be met by the
2180
<div class="division sect3">
2181
<a name="usage-where-notes"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.2.4. </span>Notas</span></h4></div>
2182
<div class=" block formalpara block-first">
2183
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>If your action is to be displayed in a context menu</span></div>
2184
<p class="para block block-first">
2185
Whether it is the selection context menu or the location
2186
context menu, and both in <span class="productname">Nautilus™</span> context menus and in
2187
<span class="guimenu">File</span> or <span class="guimenu">Edit</span> menus, it
2188
will be displayed as
2191
<div class="block list itemizedlist"><ul class="itemizedlist">
2192
<li class="li-first">
2194
the <span class="guilabel">Context label</span> as a label,
2199
the <span class="guilabel">Icon</span>,
2204
these two properties being associated with the
2205
<span class="guilabel">Tooltip</span>.
2209
<div class="admonition block note block-indent"><div class="note-inner">
2210
<p class="para block block-first">
2211
Depending of the exact configuration of your desktop environment,
2212
the icon may or may not be displayed in front of the label in
2216
<div class="admonition block tip block-indent"><div class="tip-inner">
2217
<p class="para block block-first">
2218
You may embed some parameters in the label, the icon name or the tooltip.
2219
These parameters will be dynamically substituted at runtime with values
2220
which will depend of currently selected item(s).
2223
<div class=" block formalpara">
2224
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>If your action is to be displayed in the toolbar</span></div>
2225
<p class="para block block-first">
2226
It will be displayed as
2229
<div class="block list itemizedlist"><ul class="itemizedlist">
2230
<li class="li-first">
2232
the <span class="guilabel">Toolbar label</span> as a label,
2237
the <span class="guilabel">Icon</span>,
2242
these two properties being associated with the
2243
<span class="guilabel">Tooltip</span>.
2247
<div class="admonition block note block-indent"><div class="note-inner">
2248
<p class="para block block-first">
2249
Depending of the exact configuration of your desktop environment,
2250
the toolbar label may or may not be displayed in front of the icon
2254
<div class="admonition block tip block-indent"><div class="tip-inner">
2255
<p class="para block block-first">
2256
The toolbar label defaults to the same label than
2257
those used in menus. By unchecking the
2258
<span class="guilabel">Use same label for icon in the toolbar</span>
2259
checkbox, then you can define a label specific to the
2260
toolbar, usually shorter that those defined for the menus.
2263
<div class="admonition block tip block-indent"><div class="tip-inner">
2264
<p class="para block block-first">
2265
You may embed some parameters in the toolbar label, the icon name or the tooltip.
2266
These parameters will be dynamically substituted at runtime with values
2267
which will depend of currently selected item(s).
2270
<div class=" block formalpara">
2271
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Defining several targets</span></div>
2272
<p class="para block block-first">
2273
An action may target both the selection context menu, the location context
2274
menu and the toolbar, or one or more among these.
2277
<div class=" block formalpara">
2278
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Defining no target at all</span></div>
2279
<p class="para block block-first">
2280
If no target is defined,
2281
<span class="abbrev">i.e.</span> if the three checkboxes are unchecked, then your action
2282
will never be displayed.
2287
<div class="division sect2">
2288
<a name="usage-execution"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.3. </span>What the action should it execute ?</span></h3></div>
2289
<p class="para block block-first">
2290
You most probably want your action eventually ends up with
2291
executing something. And, as a matter of fact, having something
2292
to execute is one of the few conditions which are required
2293
in order an action be considered as valid.
2295
<p class="para block">
2296
As we have already seen, the command to be executed is configured
2297
in the <span class="guilabel">Command</span> page.
2299
<p class="para block">
2300
This command may take arguments, which themselves may embed
2301
parameters. These parameters will be expanded at runtime,
2302
with values which will depend of currently selected item(s).
2304
<div class="autotoc"><ul>
2306
<span class="label">3.3.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution-parameters" title="Available parameters">Available parameters</a>
2309
<span class="label">3.3.2. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution-work" title="Where the action should it be executed ?">Where the action should it be executed ?</a>
2312
<span class="label">3.3.3. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution-how" title="How the action should it be executed ?">How the action should it be executed ?</a>
2315
<div class="division sect3">
2316
<a name="usage-execution-parameters"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.3.1. </span>Available parameters</span></h4></div>
2317
<p class="para block block-first">
2318
In the <span class="guilabel">Command</span> page, click on <span class="guilabel">Legend</span>
2319
button to see the list of available parameters.
2321
<div class=" block figure block-indent">
2322
<a name="nact-FIG-legend"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 18</span> </span>List of available parameters</span></div>
2323
<div class="figure-inner">
2325
<div class=" block screenshot block-first">
2326
<div class="mediaobject">
2327
<img src="figures/nact-legend.png"><div class=" block caption">
2328
<p class="para block block-first">The available parameters</p>
2334
<div class="admonition block tip block-indent"><div class="tip-inner">
2335
<p class="para block block-first">
2336
The <span class="guibutton">Legend</span> button has a toggling action:
2337
click once to display the <span class="guilabel">Parameter Legend</span>
2338
dialog box; click a second time to hide it.
2341
<div class="admonition block note block-indent"><div class="note-inner">
2342
<p class="para block block-first">
2343
The word « <span class="guilabel">first</span> » may be misleading
2344
as it only refers to the list of selected items internally provided by
2345
the file manager to the <span class="productname">Nautilus-Actions™</span> plugin.
2347
<p class="para block">
2348
In particular, it has <span class="emphasis">nothing to do</span> with the
2349
visual selection you may
2350
have done in the file manager window. And, in fact, which is the
2351
« <span class="guilabel">first</span> » selected item in a
2352
multiple selection is absolutly undefined and rather unpredictable.
2356
<div class="division sect3">
2357
<a name="usage-execution-work"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.3.2. </span>Where the action should it be executed ?</span></h4></div>
2358
<p class="para block block-first">
2359
Your action may be executed in a particular working directory.
2361
<p class="para block">
2362
You may specify it in the <span class="guilabel">Command</span> tab, in the
2363
<span class="guilabel">Working directory</span> entry box, or by clicking
2364
on <span class="guibutton">Browse</span> to select a folder on the
2367
<div class=" block figure block-indent">
2368
<a name="nact-FIG-work-dir-frame"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 19</span> </span>Working directory frame</span></div>
2369
<div class="figure-inner">
2371
<div class=" block screenshot block-first">
2372
<div class="mediaobject">
2373
<img src="figures/nact-working-directory-frame.png"><div class=" block caption">
2374
<p class="para block block-first">Working directory frame</p>
2380
<p class="para block">
2381
The working directory defaults to <span class="literal" dir="ltr">%d</span>, which runs
2382
the command in the base directory of the (first) selected item.
2384
<p class="para block">
2385
In the particular case of the <span class="literal" dir="ltr">%d</span> parameter,
2386
which is the « <span class="guilabel">first</span> » selected item
2387
is not very important: we are rather sure that all selected items
2388
are located in the same base directory.
2391
<div class="division sect3">
2392
<a name="usage-execution-how"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.3.3. </span>How the action should it be executed ?</span></h4></div>
2393
<p class="para block block-first">
2394
Apart from configuring the conditions the selection must met in
2395
order your action be displayed in file manager menus, <span class="productname">Nautilus-Actions™</span>
2396
allows you to configure how exactly your command will be
2399
<p class="para block">
2400
Click on the <span class="guilabel">Execution</span> tab to show the page
2401
which will permit you to configure the execution of your command.
2403
<div class=" block figure block-indent">
2404
<a name="nact-FIG-execution"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 20</span> </span>Configuration of the execution modes</span></div>
2405
<div class="figure-inner">
2407
<div class=" block screenshot block-first">
2408
<div class="mediaobject">
2409
<img src="figures/nact-execution-tab.png"><div class=" block caption">
2410
<p class="para block block-first">Configuration of the execution modes</p>
2416
<div class="autotoc"><ul>
2418
<span class="label">3.3.3.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution-how-mode" title="Modo de ejecución">Modo de ejecución</a>
2421
<span class="label">3.3.3.2. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution-how-notify" title="Notificación de inicio">Notificación de inicio</a>
2424
<span class="label">3.3.3.3. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution-how-class" title="Window class">Window class</a>
2427
<span class="label">3.3.3.4. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution-how-user" title="Owner of the execution">Owner of the execution</a>
2430
<span class="label">3.3.3.5. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-execution-how-singular" title="Multiple execution">Multiple execution</a>
2433
<div class="division sect4">
2434
<a name="usage-execution-how-mode"></a><div class="header"><h5 class="sect4 title"><span class="title"><span class="label">3.3.3.1. </span>Modo de ejecución</span></h5></div>
2435
<div class=" block figure block-first block-indent">
2436
<a name="nact-FIG-execution-mode"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 21</span> </span>Configuration of the execution mode</span></div>
2437
<div class="figure-inner">
2439
<div class=" block screenshot block-first">
2440
<div class="mediaobject">
2441
<img src="figures/nact-exec-mode-frame.png"><div class=" block caption">
2442
<p class="para block block-first">Configuration of the execution mode</p>
2448
<p class="para block">
2449
The execution mode of your command may be choosen between following
2452
<div class="block list variablelist"><dl class="variablelist">
2453
<dt class="term dt-first">Normal</dt>
2455
<p class="para block block-first">
2456
Starts the command as a standard graphical user interface.
2459
<dt class="term">Terminal</dt>
2461
<p class="para block block-first">
2462
Starts the preferred terminal of the desktop environment,
2463
and runs the command in it.
2466
<dt class="term">Empotrado</dt>
2468
<p class="para block block-first">
2469
Makes use of a special feature of the file manager which may allow
2470
a terminal to be ran in it.
2472
<p class="para block">
2473
As <span class="productname">Nautilus™</span> does not have this feature, this option is strictly
2474
equivalent to <span class="literal" dir="ltr">Terminal</span> option.
2481
<p class="para block block-first">
2482
Starts the preferred terminal of the desktop environment, and
2483
runs the command in it. At end, standard streams (stdout, stderr)
2484
are collected and displayed.
2488
<p class="para block">
2489
The execution mode of a command defaults to <span class="literal" dir="ltr">Normal</span>.
2490
That is, the command is executed without any particular pre- or
2494
<div class="division sect4">
2495
<a name="usage-execution-how-notify"></a><div class="header"><h5 class="sect4 title"><span class="title"><span class="label">3.3.3.2. </span>Notificación de inicio</span></h5></div>
2496
<div class=" block figure block-first block-indent">
2497
<a name="nact-FIG-startup-mode"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 22</span> </span>Configuration of the startup modes</span></div>
2498
<div class="figure-inner">
2500
<div class=" block screenshot block-first">
2501
<div class="mediaobject">
2502
<img src="figures/nact-startup-mode-frame.png"><div class=" block caption">
2503
<p class="para block block-first">Configuration of the startup modes</p>
2509
<p class="para block">
2510
If the execution mode of the command is <span class="literal" dir="ltr">Normal</span>,
2511
and if you know that the application will send a <span class="literal" dir="ltr">remove</span>
2512
message with the <span class="envar" dir="ltr">DESKTOP_STARTUP_ID</span> environment variable set,
2513
then check the <span class="guilabel">Startup notify</span> checkbox.
2515
<p class="para block">
2517
<a class="ulink" href="http://www.freedesktop.org/Standards/startup-notification-spec" title="http://www.freedesktop.org/Standards/startup-notification-spec">http://www.freedesktop.org/Standards/startup-notification-spec</a>
2521
<div class="division sect4">
2522
<a name="usage-execution-how-class"></a><div class="header"><h5 class="sect4 title"><span class="title"><span class="label">3.3.3.3. </span>Window class</span></h5></div>
2523
<p class="para block block-first">
2524
If the execution mode of the command is <span class="literal" dir="ltr">Normal</span>,
2525
and if you know that the application will map at least one window with a
2527
then enter that name into the <span class="guilabel">Startup Window Manager class</span>
2530
<p class="para block">
2532
<a class="ulink" href="http://www.freedesktop.org/Standards/startup-notification-spec" title="http://www.freedesktop.org/Standards/startup-notification-spec">http://www.freedesktop.org/Standards/startup-notification-spec</a>
2536
<div class="division sect4">
2537
<a name="usage-execution-how-user"></a><div class="header"><h5 class="sect4 title"><span class="title"><span class="label">3.3.3.4. </span>Owner of the execution</span></h5></div>
2538
<div class=" block figure block-first block-indent">
2539
<a name="nact-FIG-execute-as"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 23</span> </span>Configuration of the owner of the run</span></div>
2540
<div class="figure-inner">
2542
<div class=" block screenshot block-first">
2543
<div class="mediaobject">
2544
<img src="figures/nact-execute-as-frame.png"><div class=" block caption">
2545
<p class="para block block-first">Configuration of the owner of the run</p>
2551
<p class="para block">
2552
Enter in the <span class="guilabel">Execute as user</span> entry box the username
2553
or the <span class="acronym">UID</span> of the user your command must be ran as.
2555
<p class="para block">
2556
If you do not enter anything in this field, then the command will be
2557
executed as the current user.
2560
<div class="division sect4">
2561
<a name="usage-execution-how-singular"></a><div class="header"><h5 class="sect4 title"><span class="title"><span class="label">3.3.3.5. </span>Multiple execution</span></h5></div>
2562
<p class="para block block-first">
2563
You may want your command be executed once, giving it the list of
2564
selected items as argument.
2566
<p class="para block">
2567
Or you may prefer your command be repeated for each selected item,
2568
giving to each execution a different item as argument.
2570
<p class="para block">
2571
Actually, <span class="productname">Nautilus-Actions™</span> automatically handles these two behaviors,
2572
depending of the form and the order of the parameters in the command
2575
<p class="para block">
2576
Though some parameters are not sensible to the count of the
2577
selection (<span class="abbrev">e.g.</span> « <span class="literal" dir="ltr">%c</span> »,
2578
the selection count itself), most have two declensions:
2580
<div class="block list itemizedlist"><ul class="itemizedlist">
2581
<li class="li-first">
2583
a « singular » one, <span class="abbrev">e.g.</span>
2584
« <span class="literal" dir="ltr">%b</span> »,
2585
the basename of the selected item;
2590
a « plural » one, <span class="abbrev">e.g.</span>
2591
« <span class="literal" dir="ltr">%B</span> »,
2592
the space-separated list of the basenames of selected items.
2596
<p class="para block">
2597
When the selection is empty or contains only one element,
2598
and from this topic point of view, these two forms are exactly equivalent.
2600
<p class="para block">
2601
When the selection contains more than one item:
2603
<div class="block list itemizedlist"><ul class="itemizedlist">
2604
<li class="li-first">
2606
if the first relevant parameter is of a singular form,
2607
then <span class="productname">Nautilus-Actions™</span> will consider that the command is only able to deal
2608
with one item at a time, and thus that it has to be ran one time for
2614
contrarily, if the first relevant parameter found is of the plural form,
2615
then <span class="productname">Nautilus-Actions™</span> will consider that the command is able to deal with a
2616
list of items, and thus the command will be executed only once;
2621
if all found parameters are irrelevant, then <span class="productname">Nautilus-Actions™</span> defaults
2622
to consider that the command should be executed only once.
2626
<div class="table block block-indent">
2627
<a name="nact-TAB-multiple-execution"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Tabla 1</span> </span>Characterization of the parameters <span class="abbrev">vs.</span> multiple execution</span></div>
2628
<table summary="Characterization of the parameters vs. multiple execution" style="border: solid 1px;">
2630
<th style="text-align: center;" class="td-colsep">Parámetro</th>
2631
<th style="text-align: left;" class="td-colsep">Descripción</th>
2632
<th style="text-align: center;" colspan="3">Said form</th>
2636
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%b</span></td>
2637
<td style="text-align: left;" class="td-colsep">(first) basename</td>
2638
<td style="text-align: center;" class="td-colsep">singular</td>
2639
<td style="text-align: center;" class="td-colsep"></td>
2640
<td style="text-align: center;"></td>
2642
<tr class="tr-shade">
2643
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%B</span></td>
2644
<td style="text-align: left;" class="td-colsep">space-separated list of basenames</td>
2645
<td style="text-align: center;" class="td-colsep"></td>
2646
<td style="text-align: center;" class="td-colsep"></td>
2647
<td style="text-align: center;">plural</td>
2650
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%c</span></td>
2651
<td style="text-align: left;" class="td-colsep">count of selected items</td>
2652
<td style="text-align: center;" class="td-colsep"></td>
2653
<td style="text-align: center;" class="td-colsep">irrelevant</td>
2654
<td style="text-align: center;"></td>
2656
<tr class="tr-shade">
2657
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%d</span></td>
2658
<td style="text-align: left;" class="td-colsep">(first) base directory</td>
2659
<td style="text-align: center;" class="td-colsep">singular</td>
2660
<td style="text-align: center;" class="td-colsep"></td>
2661
<td style="text-align: center;"></td>
2664
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%D</span></td>
2665
<td style="text-align: left;" class="td-colsep">space-separated list of base directory of each selected items</td>
2666
<td style="text-align: center;" class="td-colsep"></td>
2667
<td style="text-align: center;" class="td-colsep"></td>
2668
<td style="text-align: center;">plural</td>
2670
<tr class="tr-shade">
2671
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%f</span></td>
2672
<td style="text-align: left;" class="td-colsep">(first) filename</td>
2673
<td style="text-align: center;" class="td-colsep">singular</td>
2674
<td style="text-align: center;" class="td-colsep"></td>
2675
<td style="text-align: center;"></td>
2678
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%F</span></td>
2679
<td style="text-align: left;" class="td-colsep">space-separated list of selected filenames</td>
2680
<td style="text-align: center;" class="td-colsep"></td>
2681
<td style="text-align: center;" class="td-colsep"></td>
2682
<td style="text-align: center;">plural</td>
2684
<tr class="tr-shade">
2685
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%h</span></td>
2686
<td style="text-align: left;" class="td-colsep">hostname of the (first) URI</td>
2687
<td style="text-align: center;" class="td-colsep"></td>
2688
<td style="text-align: center;" class="td-colsep">irrelevant</td>
2689
<td style="text-align: center;"></td>
2692
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%m</span></td>
2693
<td style="text-align: left;" class="td-colsep">mimetype of the (first) selected item</td>
2694
<td style="text-align: center;" class="td-colsep">singular</td>
2695
<td style="text-align: center;" class="td-colsep"></td>
2696
<td style="text-align: center;"></td>
2698
<tr class="tr-shade">
2699
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%M</span></td>
2700
<td style="text-align: left;" class="td-colsep">space-separated list of the mimetypes of the selected items</td>
2701
<td style="text-align: center;" class="td-colsep"></td>
2702
<td style="text-align: center;" class="td-colsep"></td>
2703
<td style="text-align: center;">plural</td>
2706
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%n</span></td>
2707
<td style="text-align: left;" class="td-colsep">username of the (first) URI</td>
2708
<td style="text-align: center;" class="td-colsep"></td>
2709
<td style="text-align: center;" class="td-colsep">irrelevant</td>
2710
<td style="text-align: center;"></td>
2712
<tr class="tr-shade">
2713
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%o</span></td>
2714
<td style="text-align: left;" class="td-colsep">no-op operator which forces a singular form of execution</td>
2715
<td style="text-align: center;" class="td-colsep">singular</td>
2716
<td style="text-align: center;" class="td-colsep"></td>
2717
<td style="text-align: center;"></td>
2720
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%O</span></td>
2721
<td style="text-align: left;" class="td-colsep">no-op operator which forces a plural form of execution</td>
2722
<td style="text-align: center;" class="td-colsep"></td>
2723
<td style="text-align: center;" class="td-colsep"></td>
2724
<td style="text-align: center;">plural</td>
2726
<tr class="tr-shade">
2727
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%p</span></td>
2728
<td style="text-align: left;" class="td-colsep">port number of the (first) URI</td>
2729
<td style="text-align: center;" class="td-colsep"></td>
2730
<td style="text-align: center;" class="td-colsep">irrelevant</td>
2731
<td style="text-align: center;"></td>
2734
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%s</span></td>
2735
<td style="text-align: left;" class="td-colsep">scheme of the (first) URI</td>
2736
<td style="text-align: center;" class="td-colsep"></td>
2737
<td style="text-align: center;" class="td-colsep">irrelevant</td>
2738
<td style="text-align: center;"></td>
2740
<tr class="tr-shade">
2741
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%u</span></td>
2742
<td style="text-align: left;" class="td-colsep">(first) URI</td>
2743
<td style="text-align: center;" class="td-colsep">singular</td>
2744
<td style="text-align: center;" class="td-colsep"></td>
2745
<td style="text-align: center;"></td>
2748
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%U</span></td>
2749
<td style="text-align: left;" class="td-colsep">space-separated list of selected URIs</td>
2750
<td style="text-align: center;" class="td-colsep"></td>
2751
<td style="text-align: center;" class="td-colsep"></td>
2752
<td style="text-align: center;">plural</td>
2754
<tr class="tr-shade">
2755
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%w</span></td>
2756
<td style="text-align: left;" class="td-colsep">(first) basename without the extension</td>
2757
<td style="text-align: center;" class="td-colsep">singular</td>
2758
<td style="text-align: center;" class="td-colsep"></td>
2759
<td style="text-align: center;"></td>
2762
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%W</span></td>
2763
<td style="text-align: left;" class="td-colsep">space-separated list of basenames without their extension</td>
2764
<td style="text-align: center;" class="td-colsep"></td>
2765
<td style="text-align: center;" class="td-colsep"></td>
2766
<td style="text-align: center;">plural</td>
2768
<tr class="tr-shade">
2769
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%x</span></td>
2770
<td style="text-align: left;" class="td-colsep">(first) extension</td>
2771
<td style="text-align: center;" class="td-colsep">singular</td>
2772
<td style="text-align: center;" class="td-colsep"></td>
2773
<td style="text-align: center;"></td>
2776
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%X</span></td>
2777
<td style="text-align: left;" class="td-colsep">space-separated list of extensions</td>
2778
<td style="text-align: center;" class="td-colsep"></td>
2779
<td style="text-align: center;" class="td-colsep"></td>
2780
<td style="text-align: center;">plural</td>
2782
<tr class="tr-shade">
2783
<td style="text-align: center;" class="td-colsep"><span class="literal" dir="ltr">%%</span></td>
2784
<td style="text-align: left;" class="td-colsep">the « <span class="literal" dir="ltr">%</span> » character</td>
2785
<td style="text-align: center;" class="td-colsep"></td>
2786
<td style="text-align: center;" class="td-colsep">irrelevant</td>
2787
<td style="text-align: center;"></td>
2792
<div class=" block example block-indent">
2793
<div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Ejemplo 3</span> </span>Usage of singular <span class="abbrev">vs.</span> plural forms</span></div>
2794
<div class="example-inner">
2796
<p class="para block block-first">
2797
Say the current folder is <span class="filename" dir="ltr">/data</span>,
2798
and the current selection contains the three files
2799
<span class="filename" dir="ltr">pierre</span>, <span class="filename" dir="ltr">paul</span>
2800
and <span class="filename" dir="ltr">jacques</span>.
2802
<div class=" block formalpara">
2803
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>
2804
If we have requested <span class="command" dir="ltr">echo %b</span>,
2806
<p class="para block block-first">
2807
then the following commands will be successively run:
2810
<div class="block list simplelist"><table class="simplelist">
2811
<tr><td class="td-first"><span class="member"><span class="command" dir="ltr">echo pierre</span></span></td></tr>
2812
<tr><td class="td-first"><span class="member"><span class="command" dir="ltr">echo paul</span></span></td></tr>
2813
<tr><td class="td-first"><span class="member"><span class="command" dir="ltr">echo jacques</span></span></td></tr>
2815
<p class="para block">
2816
This is because <span class="literal" dir="ltr">%b</span> marks a <span class="emphasis">singular</span>
2817
parameter. The command is the run once for each of the selected items.
2819
<div class=" block formalpara">
2820
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>
2821
Contrarily, if we have requester <span class="command" dir="ltr">echo %B</span>,
2823
<p class="para block block-first">
2824
then the following command will be run:
2827
<div class="block list simplelist"><table class="simplelist"><tr><td class="td-first"><span class="member"><span class="command" dir="ltr">echo pierre paul jacques</span></span></td></tr></table></div>
2828
<p class="para block">
2829
This is because <span class="literal" dir="ltr">%B</span> marks a a <span class="emphasis">plural</span>
2830
parameter. The command is then run only once, with the list of selected
2833
<div class=" block formalpara">
2834
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>
2835
If we have requested <span class="command" dir="ltr">echo %b %B</span>,
2837
<p class="para block block-first">
2838
then the following commands will be successively run:
2841
<div class="block list simplelist"><table class="simplelist">
2842
<tr><td class="td-first"><span class="member"><span class="command" dir="ltr">echo pierre pierre paul jacques</span></span></td></tr>
2843
<tr><td class="td-first"><span class="member"><span class="command" dir="ltr">echo paul pierre paul jacques</span></span></td></tr>
2844
<tr><td class="td-first"><span class="member"><span class="command" dir="ltr">echo jacques pierre paul jacques</span></span></td></tr>
2846
<p class="para block">
2847
This is because the first <span class="emphasis">relevant</span> parameter
2848
is <span class="literal" dir="ltr">%b</span>, and so the command is run once for each
2849
selected item, replacing at each occurrence the <span class="literal" dir="ltr">%b</span>
2850
parameter with the corresponding item. The second parameter is
2851
computed and added as arguments to the executed command.
2853
<div class=" block formalpara">
2854
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>
2855
And if we have requested <span class="literal" dir="ltr">echo %B %b</span>,
2857
<p class="para block block-first">
2858
then the following commands will be run:
2861
<div class="block list simplelist"><table class="simplelist"><tr><td class="td-first"><span class="member"><span class="command" dir="ltr">echo pierre paul jacques pierre</span></span></td></tr></table></div>
2862
<p class="para block">
2863
This is because the first <span class="emphasis">relevant</span> parameter here
2864
is <span class="literal" dir="ltr">%B</span>. The command is then run only once, replacing
2865
<span class="literal" dir="ltr">%B</span> with the space-separated list of basenames. As
2866
the command is only run once, the <span class="literal" dir="ltr">%b</span> is substituted
2867
only once with the (first) basename.
2874
<div class="division sect2">
2875
<a name="usage-profile"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.4. </span>Using profiles to extend your action</span></h3></div>
2876
<p class="para block block-first">
2877
There is some situations where you will want a given action behave
2878
slightly differently depending on the currently selected items or
2879
the current runtime environment.
2881
<div class=" block example block-indent">
2882
<div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Ejemplo 4</span> </span>Open a terminal here</span></div>
2883
<div class="example-inner">
2885
<p class="para block block-first">
2886
Say you have an action which opens a terminal in the current location.
2888
<p class="para block">
2889
You have configured it to open your preferred terminal in the
2890
location your file manager currently points to.
2892
<p class="para block">
2893
But what if you want select a directory in your file manager,
2894
and directly opens your terminal in this directory ? If you
2895
keep based on the current file manager location, your
2896
terminal will open in the parent of the targeted directory.
2898
<p class="para block">
2899
One solution is to define a new profile to your action,
2900
configuring this profile to open the terminal in the
2903
<p class="para block">
2904
At runtime, <span class="productname">Nautilus-Actions™</span> will successively examine each profile
2905
attached to your action. If the first profile targets a file
2906
while you have selected a directory, then <span class="productname">Nautilus-Actions™</span> will just
2907
try with your second profile.
2911
<p class="para block">
2912
To create a new profile, first select the action in the items list,
2914
<span class="menuchoice"><span class="guisubmenu">File</span> ▸ <span class="guimenuitem">New profile</span></span>.
2916
<p class="para block">
2917
A new profile is created in your action.
2919
<p class="para block">
2920
You can now define the conditions which are to be met in order
2921
this profile be selected, and the command which will be executed.
2923
<div class="autotoc"><ul><li>
2924
<span class="label">3.4.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-profile-order" title="Ordering the profiles inside an action">Ordering the profiles inside an action</a>
2926
<div class="division sect3">
2927
<a name="usage-profile-order"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.4.1. </span>Ordering the profiles inside an action</span></h4></div>
2928
<p class="para block block-first">
2929
At runtime, <span class="productname">Nautilus-Actions™</span> will begin with examining the conditions
2932
<p class="para block">
2933
If these conditions (the action-conditions) are met, then <span class="productname">Nautilus-Actions™</span>
2934
will examine in order each profile.
2936
<p class="para block">
2937
If the conditions defined in a profile are met, then this profile
2938
will be validated, and the review of other profiles will stop.
2940
<p class="para block">
2941
If no profile is found valid at runtime, then the action will be
2942
itself considered invalid, and will not be displayed in the file
2943
manager context menu.
2945
<p class="para block">
2946
So, ordering of the profiles may be important for your action: the
2947
first valid profile found, the first - and the only - selected profile.
2949
<p class="para block">
2950
You may order your profiles inside an action in two ways.
2952
<div class="block list orderedlist"><ol class="orderedlist">
2953
<li class="li-first">
2955
Cut the profile to be moved, select the profile before which
2956
you want yout cut profile to be inserted, and paste it.
2961
Cick on the profile to be moved, and drag it to its right place.
2967
<div class="division sect2">
2968
<a name="usage-menus"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.5. </span>Organizing actions in menus</span></h3></div>
2969
<p class="para block block-first">
2970
As your list of actions will grow, you most probably will want organize
2971
them into menus, submenus, and so on.
2973
<p class="para block">
2974
In order to create a new menu, choose
2975
<span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guimenuitem">New menu</span></span>.
2977
<p class="para block">
2978
A menu may be created anywhere in the list of your actions, but inside
2979
of an action (<span class="abbrev">i.e.</span> not between two profiles of an action).
2981
<p class="para block">
2982
As an action, the exact place where a new menu will be inserted
2983
depends of the current sort order:
2985
<div class="block list variablelist"><dl class="variablelist">
2986
<dt class="term dt-first">
2990
<p class="para block block-first">
2991
The new menu is inserted just before the current action or menu.
2993
<p class="para block">
2994
This place will not change when you later modify the label of the menu.
2998
Ascending (resp. descending) alphabetical order:
3001
<p class="para block block-first">
3002
The new menu is inserted at the correct place, regarding the default
3003
« <span class="literal" dir="ltr">New Nautilus menu</span> » label.
3005
<p class="para block">
3006
This place will be automatically changed, each time you modify the
3011
<p class="para block">
3012
As an action, too, a menu requires a label, and may have an icon and a
3013
tooltip. Also, you may define some conditions in order your menu be
3014
candidate to be displayed in <span class="productname">Nautilus™</span> context menu. If the defined
3015
conditions are not met at runtime, then your whole menu, including
3016
its submenus, its actions and so on, will not be displayed.
3019
<div class="division sect2">
3020
<a name="usage-sorting"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.6. </span>Sorting the items list</span></h3></div>
3021
<p class="para block block-first">
3022
Your actions and menus will be displayed in file manager context menus
3023
in the same order that they are listed in the <span class="guilabel">Items list</span>,
3024
on the left pane of the main <span class="application">Nautilus-Actions Configuration Tool</span> window.
3026
<p class="para block">
3029
<div class="block list itemizedlist"><ul class="itemizedlist">
3030
<li class="li-first">
3032
sort your actions and menus in ascending or descending alphabetical
3033
order of their label,
3038
or do not sort, and manually organize your actions and menus
3043
<div class="autotoc"><ul>
3045
<span class="label">3.6.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-sorting-alpha" title="Alphabetically sorting your actions and menus">Alphabetically sorting your actions and menus</a>
3048
<span class="label">3.6.2. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-sorting-manual" title="Manually organizing your actions and menus">Manually organizing your actions and menus</a>
3051
<div class="division sect3">
3052
<a name="usage-sorting-alpha"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.6.1. </span>Alphabetically sorting your actions and menus</span></h4></div>
3053
<p class="para block block-first">
3054
In these modes, actions and menus are sorted depending of their label,
3055
inside of their parent.
3057
<div class=" block figure block-indent">
3058
<a name="nact-FIG-sort-buttons"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 24</span> </span>Sort buttons in the main window</span></div>
3059
<div class="figure-inner">
3061
<div class=" block screenshot block-first">
3062
<div class="mediaobject">
3063
<img src="figures/sort-buttons-frame.png"><div class=" block caption">
3064
<p class="para block block-first">Sort buttons in the main window</p>
3070
<p class="para block">
3071
You may sort your actions by:
3073
<div class="block list itemizedlist"><ul class="itemizedlist">
3074
<li class="li-first">
3077
<span class="guibutton"><span class="inlinegraphic"><img src="figures/sort-asc.png"></span></span>
3078
(<span class="abbrev">resp.</span>
3079
<span class="guibutton"><span class="inlinegraphic"><img src="figures/sort-desc.png"></span></span>)
3080
button to sort your actions in ascending (<span class="abbrev">resp.</span> descending)
3086
Or edit your corresponding preference.
3091
<div class="division sect3">
3092
<a name="usage-sorting-manual"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.6.2. </span>Manually organizing your actions and menus</span></h4></div>
3093
<p class="para block block-first">
3094
In this mode, a new action or a new menu will be inserted just before
3095
the current action or menu, inside of the same parent if apply.
3097
<p class="para block">
3098
To choose this mode:
3100
<div class="block list itemizedlist"><ul class="itemizedlist">
3101
<li class="li-first">
3104
<span class="guibutton"><span class="inlinegraphic"><img src="figures/sort-manual.png"></span></span>
3110
Or edit your corresponding preference.
3116
<div class="division sect2">
3117
<a name="usage-edit"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.7. </span>Editando</span></h3></div>
3118
<p class="para block block-first">
3119
With <span class="application">Nautilus-Actions Configuration Tool</span>, you may safely cut, copy, paste to and from the clipboard.
3121
<div class="autotoc"><ul>
3123
<span class="label">3.7.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-edit-cut" title="Cut/Delete">Cut/Delete</a>
3126
<span class="label">3.7.2. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-edit-multiple" title="Multiple selection">Multiple selection</a>
3129
<div class="division sect3">
3130
<a name="usage-edit-cut"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.7.1. </span>Cut/Delete</span></h4></div>
3131
<p class="para block block-first">
3132
Deletion applies to current selection.
3133
When the current selection covers all profiles of an action, the
3134
delete action really delete the selected profiles, leaving the action
3135
as invalid if all profiles were selected.
3138
<div class="division sect3">
3139
<a name="usage-edit-multiple"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.7.2. </span>Multiple selection</span></h4></div>
3140
<p class="para block block-first">
3141
Multiple selection is possible in <span class="application">Nautilus-Actions Configuration Tool</span>.
3142
You can extend the current selection
3143
by pressing the touch <span class="keycap">Ctrl</span> or <span class="keycap">Shift</span>
3144
while selecting an item to add to the selection.
3146
<p class="para block">
3147
<span class="application">Nautilus-Actions Configuration Tool</span> only accepts homogeneous multiple selections. That is, you may
3148
select one or more profiles, or one or more actions or menus. A multiple
3149
selection containing both profiles and actions or menus is not allowed.
3150
This is because <span class="application">Nautilus-Actions Configuration Tool</span> would not know where to paste such a selection.
3152
<p class="para block">
3153
Note that selecting any row means also selecting children of this row.
3154
These childs are said « implicitely selected »:
3155
they will be part of next edition operations, but are not considered
3156
when verifying if selection is homogeneous. Also, they cannot be unselected.
3160
<div class="division sect2">
3161
<a name="usage-save"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.8. </span>Saving your modifications</span></h3></div>
3162
<p class="para block block-first">
3163
To save your modifications, choose
3164
<span class="menuchoice"><span class="guimenu">File</span> ▸ <span class="guisubmenu">Save</span> <span class="shortcut">(
3165
<span class="keycombo"><span class="keycap">Ctrl</span>+<span class="keycap">S</span></span>
3168
<p class="para block">
3169
All your pending modifications will be saved.
3170
New items will be created by the first available writable I/O provider.
3172
<p class="para block">
3173
<span class="productname">Nautilus-Actions™</span> also has an Auto-save feature which is configurable in
3174
<span class="guimenuitem">Preferences</span> dialog box.
3177
<div class="division sect2">
3178
<a name="usage-export"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.9. </span>Exporting your actions</span></h3></div>
3179
<p class="para block block-first">
3182
<div class="division sect2">
3183
<a name="usage-import"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.10. </span>Acciones de importación</span></h3></div>
3184
<p class="para block block-first">
3187
<div class="division sect2">
3188
<a name="usage-prefs"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">3.11. </span>Setting your own preferences</span></h3></div>
3189
<p class="para block block-first">
3191
<span class="menuchoice"><span class="guimenu">Edit</span> ▸ <span class="guimenuitem">Preferences</span></span>
3192
to access to the configuration of your preferences.
3194
<div class="autotoc"><ul>
3196
<span class="label">3.11.1. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-prefs-runtime" title="Preferencias de ejecución">Preferencias de ejecución</a>
3199
<span class="label">3.11.2. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-prefs-ui" title="User interface preferences">User interface preferences</a>
3202
<span class="label">3.11.3. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-prefs-import" title="Preferencias de importación">Preferencias de importación</a>
3205
<span class="label">3.11.4. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-prefs-export" title="Preferencias de exportación">Preferencias de exportación</a>
3208
<span class="label">3.11.5. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-prefs-schemes" title="Preferencias de esquemas">Preferencias de esquemas</a>
3211
<span class="label">3.11.6. </span><a class="xref" href="nautilus-actions-config-tool.html#usage-prefs-providers" title="I/O providers preferences">I/O providers preferences</a>
3214
<div class="division sect3">
3215
<a name="usage-prefs-runtime"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.11.1. </span>Preferencias de ejecución</span></h4></div>
3216
<div class=" block figure block-first block-indent">
3217
<a name="nact-FIG-prefs-runtime"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 25</span> </span>Preferencias de ejecución</span></div>
3218
<div class="figure-inner">
3220
<div class=" block screenshot block-first">
3221
<div class="mediaobject">
3222
<img src="figures/nact-preferences-runtime.png"><div class=" block caption">
3223
<p class="para block block-first">Preferencias de ejecución</p>
3230
<div class="division sect3">
3231
<a name="usage-prefs-ui"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.11.2. </span>User interface preferences</span></h4></div>
3232
<div class=" block figure block-first block-indent">
3233
<a name="nact-FIG-prefs-ui"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 26</span> </span>Preferencias de la IU</span></div>
3234
<div class="figure-inner">
3236
<div class=" block screenshot block-first">
3237
<div class="mediaobject">
3238
<img src="figures/nact-preferences-ui.png"><div class=" block caption">
3239
<p class="para block block-first">Preferencias de la IU</p>
3246
<div class="division sect3">
3247
<a name="usage-prefs-import"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.11.3. </span>Preferencias de importación</span></h4></div>
3248
<div class=" block figure block-first block-indent">
3249
<a name="nact-FIG-prefs-import"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 27</span> </span>Preferencias de importación</span></div>
3250
<div class="figure-inner">
3252
<div class=" block screenshot block-first">
3253
<div class="mediaobject">
3254
<img src="figures/nact-preferences-import.png"><div class=" block caption">
3255
<p class="para block block-first">Preferencias de importación</p>
3261
<p class="para block">
3264
<div class="division sect3">
3265
<a name="usage-prefs-export"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.11.4. </span>Preferencias de exportación</span></h4></div>
3266
<div class=" block figure block-first block-indent">
3267
<a name="nact-FIG-prefs-export"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 28</span> </span>Preferencias de exportación</span></div>
3268
<div class="figure-inner">
3270
<div class=" block screenshot block-first">
3271
<div class="mediaobject">
3272
<img src="figures/nact-preferences-export.png"><div class=" block caption">
3273
<p class="para block block-first">Preferencias de exportación</p>
3279
<p class="para block">
3282
<div class="division sect3">
3283
<a name="usage-prefs-schemes"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.11.5. </span>Preferencias de esquemas</span></h4></div>
3284
<div class=" block figure block-first block-indent">
3285
<a name="nact-FIG-prefs-schemes"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 29</span> </span>Preferencias de esquemas</span></div>
3286
<div class="figure-inner">
3288
<div class=" block screenshot block-first">
3289
<div class="mediaobject">
3290
<img src="figures/nact-preferences-schemes.png"><div class=" block caption">
3291
<p class="para block block-first">Preferencias de esquemas</p>
3297
<p class="para block">
3300
<div class="division sect3">
3301
<a name="usage-prefs-providers"></a><div class="header"><h4 class="sect3 title"><span class="title"><span class="label">3.11.6. </span>I/O providers preferences</span></h4></div>
3302
<div class=" block figure block-first block-indent">
3303
<a name="nact-FIG-prefs-io-providers"></a><div class="block block-first title title-formal"><span class="title"><span class="label"><span style="font-style: italic; ">Figura 30</span> </span>I/O providers preferences</span></div>
3304
<div class="figure-inner">
3306
<div class=" block screenshot block-first">
3307
<div class="mediaobject">
3308
<img src="figures/nact-preferences-io-providers.png"><div class=" block caption">
3309
<p class="para block block-first">I/O providers preferences</p>
3315
<p class="para block">
3320
<div class="division sect1">
3321
<a name="misc"></a><div class="header"><h2 class="sect1 title"><span class="title"><span class="label">4. </span>Miscellaneous informations</span></h2></div>
3322
<p class="para block block-first">
3323
The new action is also displayed in red color in the items list.
3324
Red color is used as an indicator that the item
3325
is invalid, that is that the item cannot be candidate to be displayed in a
3326
<span class="productname">Nautilus™</span> context menu because some of its informations are missing or erroneous.
3327
Here, and though this newly inserted action has some suitable defaults, it lacks a
3328
command to be executed to be considered valid by <span class="application">Nautilus-Actions Configuration Tool</span>
3331
<div class="division sect1">
3332
<a name="bugs"></a><div class="header"><h2 class="sect1 title"><span class="title"><span class="label">5. </span>Errores conocidos y limitaciones</span></h2></div>
3333
<div class="autotoc"><ul>
3335
<span class="label">5.1. </span><a class="xref" href="nautilus-actions-config-tool.html#bugs-bugs" title="Errores conocidos">Errores conocidos</a>
3338
<span class="label">5.2. </span><a class="xref" href="nautilus-actions-config-tool.html#bugs-limits" title="Known limitations">Known limitations</a>
3341
<div class="division sect2">
3342
<a name="bugs-bugs"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">5.1. </span>Errores conocidos</span></h3></div>
3343
<p class="para block block-first">
3344
Known bugs are available on
3345
<a class="ulink" href="https://bugzilla.gnome.org/buglist.cgi?product=nautilus-actions&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED" title="https://bugzilla.gnome.org/buglist.cgi?product=nautilus-actions&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED">Bugzilla summary page</a>.
3347
<p class="para block">
3348
If you find some new bug in <span class="productname">Nautilus-Actions™</span>, you are welcome to open it by pointing
3349
your favorite browser to
3350
<a class="ulink" href="https://bugzilla.gnome.org/enter_bug.cgi?product=nautilus-actions" title="https://bugzilla.gnome.org/enter_bug.cgi?product=nautilus-actions">Bugzilla web site</a>.
3352
<div class=" block formalpara">
3353
<div class="block block-first title title-formal"><span class="title"><span class="label"></span><a class="ulink" href="https://bugzilla.gnome.org/show_bug.cgi?id=616532" title="https://bugzilla.gnome.org/show_bug.cgi?id=616532">#616532</a> Directory selection</span></div>
3354
<p class="para block block-first">
3355
When you're browsing the folder you want to export to in the <span class="application">Nautilus-Actions Configuration Tool</span>'s
3356
export assistant you can't select it as the directory to export to.
3357
Instead you have to go to the directory a level up and select the directory
3358
you want to export to there.
3362
<div class="division sect2">
3363
<a name="bugs-limits"></a><div class="header"><h3 class="sect2 title"><span class="title"><span class="label">5.2. </span>Known limitations</span></h3></div>
3364
<div class=" block formalpara block-first">
3365
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Modo de ejecución</span></div>
3366
<p class="para block block-first">
3367
As of version 3.0, execution mode may be configured in <span class="application">Nautilus-Actions Configuration Tool</span> but is
3368
not yet honored by <span class="productname">Nautilus™</span> plugin.
3371
<p class="para block">
3372
This concern working directory, execution mode, startup notification and
3373
execution's owner parameters.
3375
<div class=" block formalpara">
3376
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Atajo de teclado sugerido</span></div>
3377
<p class="para block block-first">
3378
As of version 3.0, suggested shortcut, as described in <a class="ulink" href="http://www.nautilus-actions.org/?q=node/377" title="http://www.nautilus-actions.org/?q=node/377">DES-EMA specification</a> cannot be
3379
configured in <span class="application">Nautilus-Actions Configuration Tool</span>, and is not honored by <span class="productname">Nautilus™</span> plugin.
3382
<div class=" block formalpara">
3383
<div class="block block-first title title-formal"><span class="title"><span class="label"></span>Separador de menú</span></div>
3384
<p class="para block block-first">
3385
As of version 3.0, menu separators cannot be
3386
configured in <span class="application">Nautilus-Actions Configuration Tool</span>, and are not honored by <span class="productname">Nautilus™</span> plugin.
3389
<p class="para block">
3390
One has to note that, for now, <span class="productname">Nautilus™</span> file manager does not
3391
allow its plugins to define separators in the context menu.
3395
<div class="division sect1">
3396
<a name="about"></a><div class="header"><h2 class="sect1 title"><span class="title"><span class="label">6. </span>About <span class="application">Nautilus-Actions Configuration Tool</span></span></h2></div>
3397
<p class="para block block-first">
3398
The first version of <span class="productname">Nautilus-Actions™</span> was initially written by
3399
Frederic Ruaudel (<span class="email" dir="ltr"><<a href="mailto:grumz@grumz.net" title="Envíe un correo-e a <grumz@grumz.net>.">grumz@grumz.net</a>></span>) and
3400
Rodrigo Moya (<span class="email" dir="ltr"><<a href="mailto:rodrigo@gnome-db.org" title="Envíe un correo-e a <rodrigo@gnome-db.org>.">rodrigo@gnome-db.org</a>></span>).
3401
It has been thoroughly improved and is currently maintained by
3402
Pierre Wieser (<span class="email" dir="ltr"><<a href="mailto:pwieser@trychlos.org" title="Envíe un correo-e a <pwieser@trychlos.org>.">pwieser@trychlos.org</a>></span>).
3404
<p class="para block">
3405
Artwork is due to courtesy of
3406
Ulisse Perusin (<span class="email" dir="ltr"><<a href="mailto:uli.peru@gmail.com" title="Envíe un correo-e a <uli.peru@gmail.com>.">uli.peru@gmail.com</a>></span>) and
3408
(<a class="ulink" href="http://www.dragonartz.net/" title="http://www.dragonartz.net/">http://www.dragonartz.net</a>).
3410
<p class="para block">
3411
To find more information about <span class="productname">Nautilus-Actions™</span>, please visit the
3412
<a class="ulink" href="http://www.nautilus-actions.org/" title="http://www.nautilus-actions.org/">http://www.nautilus-actions.org/</a>.
3414
<p class="para block">
3415
To report a bug or make a suggestion regarding the <span class="productname">Nautilus-Actions™</span>,
3416
the <span class="application">Nautilus-Actions Configuration Tool</span> or this manual, follow the directions in the
3417
<a class="ulink" href="ghelp:user-guide#feedback" title="ghelp:user-guide#feedback">GNOME Feedback Page</a>,
3418
or you may prefer, at your convenience, directly open a bug
3419
or a request for enhancement to
3420
<a class="ulink" href="https://bugzilla.gnome.org/enter_bug.cgi?product=nautilus-actions" title="https://bugzilla.gnome.org/enter_bug.cgi?product=nautilus-actions">Bugzilla website</a>.
3423
<div class="division appendix">
3424
<a name="appendix-gnu-fdl"></a><div class="header"><h2 class="appendix title"><span class="title"><span class="label">A. </span>GNU Free Documentation License</span></h2></div>
3425
<p class="simpara block block-first">Version 1.3, 3 November 2008</p>
3426
<p class="simpara block">
3427
Copyright © 2000, 2001, 2002, 2007, 2008
3428
<a class="ulink" href="http://www.fsf.org/" title="http://www.fsf.org/">Free Software Foundation, Inc.</a>
3430
<p class="simpara block">Se permite la copia y distribución de copias literales de este documento, pero no se permite su modificación.</p>
3431
<p class="simpara block">
3432
The purpose of this License is to make a manual, textbook, or other
3433
functional and useful document “free” in the sense of freedom:
3434
to assure everyone the effective freedom to copy and redistribute it, with
3435
or without modifying it, either commercially or
3436
noncommercially. Secondarily, this License preserves for the author and
3437
publisher a way to get credit for their work, while not being considered
3438
responsible for modifications made by others.
3440
<p class="simpara block">
3441
This License is a kind of “copyleft”, which means that
3442
derivative works of the document must themselves be free in the same
3443
sense. It complements the GNU General Public License, which is a copyleft
3444
license designed for free software.
3446
<p class="simpara block">Hemos diseñado esta Licencia para usarla en manuales de software libre, ya que el software libre necesita documentación libre: Un programa libre debe venir con los manuales que ofrezcan la mismas libertades que da el software. Pero esta licencia no se limita a manuales de software; puede ser usada para cualquier trabajo textual, sin tener en cuenta su temática o si se publica como libro impreso. Recomendamos esta licencia principalmente para trabajos cuyo fin sea instructivo o de referencia.</p>
3447
<p class="simpara block">
3448
This License applies to any manual or other work, in any medium, that
3449
contains a notice placed by the copyright holder saying it can be
3450
distributed under the terms of this License. Such a notice grants a
3451
world-wide, royalty-free license, unlimited in duration, to use that work
3452
under the conditions stated herein. The “Document”, below,
3453
refers to any such manual or work. Any member of the public is a licensee,
3454
and is addressed as “you”. You accept the license if you copy,
3455
modify or distribute the work in a way requiring permission under
3458
<p class="simpara block">
3459
A “Modified Version” of the Document means any work containing
3460
the Document or a portion of it, either copied verbatim, or with
3461
modifications and/or translated into another language.
3463
<p class="simpara block">
3464
A “Secondary Section” is a named appendix or a front-matter
3465
section of the Document that deals exclusively with the relationship of
3466
the publishers or authors of the Document to the Document’s overall
3467
subject (or to related matters) and contains nothing that could fall
3468
directly within that overall subject. (Thus, if the Document is in part a
3469
textbook of mathematics, a Secondary Section may not explain any
3470
mathematics.) The relationship could be a matter of historical connection
3471
with the subject or with related matters, or of legal, commercial,
3472
philosophical, ethical or political position regarding them.
3474
<p class="simpara block">
3475
The “Invariant Sections” are certain Secondary Sections whose
3476
titles are designated, as being those of Invariant Sections, in the notice
3477
that says that the Document is released under this License. If a section
3478
does not fit the above definition of Secondary then it is not allowed to
3479
be designated as Invariant. The Document may contain zero Invariant
3480
Sections. If the Document does not identify any Invariant Sections then
3483
<p class="simpara block">
3484
The “Cover Texts” are certain short passages of text that are
3485
listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says
3486
that the Document is released under this License. A Front-Cover Text may
3487
be at most 5 words, and a Back-Cover Text may be at most 25 words.
3489
<p class="simpara block">
3490
A “Transparent” copy of the Document means a machine-readable
3491
copy, represented in a format whose specification is available to the
3492
general public, that is suitable for revising the document
3493
straightforwardly with generic text editors or (for images composed of
3494
pixels) generic paint programs or (for drawings) some widely available
3495
drawing editor, and that is suitable for input to text formatters or for
3496
automatic translation to a variety of formats suitable for input to text
3497
formatters. A copy made in an otherwise Transparent file format whose
3498
markup, or absence of markup, has been arranged to thwart or discourage
3499
subsequent modification by readers is not Transparent. An image format is
3500
not Transparent if used for any substantial amount of text. A copy that is
3501
not “Transparent” is called “Opaque”.
3503
<p class="simpara block">
3504
Examples of suitable formats for Transparent copies include plain ASCII
3505
without markup, Texinfo input format, LaTeX input format, SGML or XML
3506
using a publicly available DTD, and standard-conforming simple HTML,
3507
PostScript or PDF designed for human modification. Examples of transparent
3508
image formats include PNG, XCF and JPG. Opaque formats include proprietary
3509
formats that can be read and edited only by proprietary word processors,
3510
SGML or XML for which the DTD and/or processing tools are not generally
3511
available, and the machine-generated HTML, PostScript or PDF produced by
3512
some word processors for output purposes only.
3514
<p class="simpara block">
3515
The “Title Page” means, for a printed book, the title page
3516
itself, plus such following pages as are needed to hold, legibly, the
3517
material this License requires to appear in the title page. For works in
3518
formats which do not have any title page as such, “Title Page”
3519
means the text near the most prominent appearance of the work’s
3520
title, preceding the beginning of the body of the text.
3522
<p class="simpara block">
3523
The “publisher” means any person or entity that distributes
3524
copies of the Document to the public.
3526
<p class="simpara block">
3527
A section “Entitled XYZ” means a named subunit of the Document
3528
whose title either is precisely XYZ or contains XYZ in parentheses
3529
following text that translates XYZ in another language. (Here XYZ stands
3530
for a specific section name mentioned below, such as
3531
“Acknowledgements”, “Dedications”,
3532
“Endorsements”, or “History”.) To “Preserve
3533
the Title” of such a section when you modify the Document means that
3534
it remains a section “Entitled XYZ” according to this
3537
<p class="simpara block">
3538
The Document may include Warranty Disclaimers next to the notice which
3539
states that this License applies to the Document. These Warranty
3540
Disclaimers are considered to be included by reference in this License,
3541
but only as regards disclaiming warranties: any other implication that
3542
these Warranty Disclaimers may have is void and has no effect on the
3543
meaning of this License.
3545
<p class="simpara block">
3546
You may copy and distribute the Document in any medium, either
3547
commercially or noncommercially, provided that this License, the copyright
3548
notices, and the license notice saying this License applies to the
3549
Document are reproduced in all copies, and that you add no other
3550
conditions whatsoever to those of this License. You may not use technical
3551
measures to obstruct or control the reading or further copying of the
3552
copies you make or distribute. However, you may accept compensation in
3553
exchange for copies. If you distribute a large enough number of copies you
3554
must also follow the conditions in section 3.
3556
<p class="simpara block"> Usted también puede prestar copias, bajo las mismas condiciones establecidas anteriormente, y puede exhibir copias públicamente.</p>
3557
<p class="simpara block">
3558
If you publish printed copies (or copies in media that commonly have
3559
printed covers) of the Document, numbering more than 100, and the
3560
Document’s license notice requires Cover Texts, you must enclose
3561
the copies in covers that carry, clearly and legibly, all these Cover
3562
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the
3563
back cover. Both covers must also clearly and legibly identify you as the
3564
publisher of these copies. The front cover must present the full title
3565
with all words of the title equally prominent and visible. You may add
3566
other material on the covers in addition. Copying with changes limited to
3567
the covers, as long as they preserve the title of the Document and satisfy
3568
these conditions, can be treated as verbatim copying in other respects.
3570
<p class="simpara block"> Si los textos requeridos para la cubierta son muy voluminosos para que ajusten legiblemente, debe colocar los primeros (tantos como sea razonable colocar) en la verdadera cubierta y situar el resto en páginas adyacentes.</p>
3571
<p class="simpara block">
3572
If you publish or distribute Opaque copies of the Document numbering more
3573
than 100, you must either include a machine-readable Transparent copy
3574
along with each Opaque copy, or state in or with each Opaque copy a
3575
computer-network location from which the general network-using public has
3576
access to download using public-standard network protocols a complete
3577
Transparent copy of the Document, free of added material. If you use the
3578
latter option, you must take reasonably prudent steps, when you begin
3579
distribution of Opaque copies in quantity, to ensure that this Transparent
3580
copy will remain thus accessible at the stated location until at least one
3581
year after the last time you distribute an Opaque copy (directly or
3582
through your agents or retailers) of that edition to the public.
3584
<p class="simpara block">
3585
It is requested, but not required, that you contact the authors of the
3586
Document well before redistributing any large number of copies, to give
3587
them a chance to provide you with an updated version of the Document.
3589
<p class="simpara block">
3590
You may copy and distribute a Modified Version of the Document under the
3591
conditions of sections 2 and 3 above, provided that you release the
3592
Modified Version under precisely this License, with the Modified Version
3593
filling the role of the Document, thus licensing distribution and
3594
modification of the Modified Version to whoever possesses a copy of it. In
3595
addition, you must do these things in the Modified Version:
3597
<div class="block list orderedlist"><ol class="orderedlist" type="A">
3598
<li class="li-first">
3599
<p class="simpara block block-first">
3600
Use in the Title Page (and on the covers, if any) a title distinct
3601
from that of the Document, and from those of previous versions (which
3602
should, if there were any, be listed in the History section of the
3603
Document). You may use the same title as a previous version if the
3604
original publisher of that version gives permission.
3608
<p class="simpara block block-first">
3609
List on the Title Page, as authors, one or more persons or entities
3610
responsible for authorship of the modifications in the Modified
3611
Version, together with at least five of the principal authors of the
3612
Document (all of its principal authors, if it has fewer than five),
3613
unless they release you from this requirement.
3617
<p class="simpara block block-first">
3618
State on the Title page the name of the publisher of the Modified
3619
Version, as the publisher.
3623
<p class="simpara block block-first">
3624
Preserve all the copyright notices of the Document.
3628
<p class="simpara block block-first">Añadir una nota de copyright apropiada a sus modificaciones, adyacente a las otras notas de copyright.</p>
3631
<p class="simpara block block-first">
3632
Include, immediately after the copyright notices, a license notice
3633
giving the public permission to use the Modified Version under the
3634
terms of this License, in the form shown in the Addendum below.
3638
<p class="simpara block block-first">
3639
Preserve in that license notice the full lists of Invariant Sections
3640
and required Cover Texts given in the Document’s license
3645
<p class="simpara block block-first">Incluir una copia sin modificación de esta Licencia.</p>
3648
<p class="simpara block block-first">
3649
Preserve the section Entitled “History”, Preserve its
3650
Title, and add to it an item stating at least the title, year, new
3651
authors, and publisher of the Modified Version as given on the Title
3652
Page. If there is no section Entitled “History” in the
3653
Document, create one stating the title, year, authors, and publisher
3654
of the Document as given on its Title Page, then add an item
3655
describing the Modified Version as stated in the previous sentence.
3659
<p class="simpara block block-first">
3660
Preserve the network location, if any, given in the Document for
3661
public access to a Transparent copy of the Document, and likewise the
3662
network locations given in the Document for previous versions it was
3663
based on. These may be placed in the “History”
3664
section. You may omit a network location for a work that was published
3665
at least four years before the Document itself, or if the original
3666
publisher of the version it refers to gives permission.
3670
<p class="simpara block block-first">
3671
For any section Entitled “Acknowledgements” or
3672
“Dedications”, Preserve the Title of the section, and
3673
preserve in the section all the substance and tone of each of the
3674
contributor acknowledgements and/or dedications given therein.
3678
<p class="simpara block block-first">
3679
Preserve all the Invariant Sections of the Document, unaltered in
3680
their text and in their titles. Section numbers or the equivalent are
3681
not considered part of the section titles.
3685
<p class="simpara block block-first">
3686
Delete any section Entitled “Endorsements”. Such a section
3687
may not be included in the Modified Version.
3691
<p class="simpara block block-first">
3692
Do not retitle any existing section to be Entitled
3693
“Endorsements” or to conflict in title with any Invariant
3698
<p class="simpara block block-first">
3699
Preserve any Warranty Disclaimers.
3703
<p class="simpara block">
3704
If the Modified Version includes new front-matter sections or appendices
3705
that qualify as Secondary Sections and contain no material copied from the
3706
Document, you may at your option designate some or all of these sections
3707
as invariant. To do this, add their titles to the list of Invariant
3708
Sections in the Modified Version’s license notice. These titles
3709
must be distinct from any other section titles.
3711
<p class="simpara block">
3712
You may add a section Entitled “Endorsements”, provided it
3713
contains nothing but endorsements of your Modified Version by various
3714
parties — for example, statements of peer review or that the text
3715
has been approved by an organization as the authoritative definition of a
3718
<p class="simpara block">
3719
You may add a passage of up to five words as a Front-Cover Text, and a
3720
passage of up to 25 words as a Back-Cover Text, to the end of the list of
3721
Cover Texts in the Modified Version. Only one passage of Front-Cover Text
3722
and one of Back-Cover Text may be added by (or through arrangements made
3723
by) any one entity. If the Document already includes a cover text for the
3724
same cover, previously added by you or by arrangement made by the same
3725
entity you are acting on behalf of, you may not add another; but you may
3726
replace the old one, on explicit permission from the previous publisher
3727
that added the old one.
3729
<p class="simpara block">
3730
The author(s) and publisher(s) of the Document do not by this License give
3731
permission to use their names for publicity for or to assert or imply
3732
endorsement of any Modified Version.
3734
<p class="simpara block">
3735
You may combine the Document with other documents released under this
3736
License, under the terms defined in section 4 above for modified versions,
3737
provided that you include in the combination all of the Invariant Sections
3738
of all of the original documents, unmodified, and list them all as
3739
Invariant Sections of your combined work in its license notice, and that
3740
you preserve all their Warranty Disclaimers.
3742
<p class="simpara block">
3743
The combined work need only contain one copy of this License, and multiple
3744
identical Invariant Sections may be replaced with a single copy. If there
3745
are multiple Invariant Sections with the same name but different contents,
3746
make the title of each such section unique by adding at the end of it, in
3747
parentheses, the name of the original author or publisher of that section
3748
if known, or else a unique number. Make the same adjustment to the section
3749
titles in the list of Invariant Sections in the license notice of the
3752
<p class="simpara block">
3753
In the combination, you must combine any sections Entitled
3754
“History” in the various original documents, forming one
3755
section Entitled “History”; likewise combine any sections
3756
Entitled “Acknowledgements”, and any sections Entitled
3757
“Dedications”. You must delete all sections Entitled
3760
<p class="simpara block">
3761
You may make a collection consisting of the Document and other documents
3762
released under this License, and replace the individual copies of this
3763
License in the various documents with a single copy that is included in
3764
the collection, provided that you follow the rules of this License for
3765
verbatim copying of each of the documents in all other respects.
3767
<p class="simpara block">
3768
You may extract a single document from such a collection, and distribute
3769
it individually under this License, provided you insert a copy of this
3770
License into the extracted document, and follow this License in all other
3771
respects regarding verbatim copying of that document.
3773
<p class="simpara block">
3774
A compilation of the Document or its derivatives with other separate and
3775
independent documents or works, in or on a volume of a storage or
3776
distribution medium, is called an “aggregate” if the copyright
3777
resulting from the compilation is not used to limit the legal rights of
3778
the compilation’s users beyond what the individual works
3779
permit. When the Document is included in an aggregate, this License does
3780
not apply to the other works in the aggregate which are not themselves
3781
derivative works of the Document.
3783
<p class="simpara block">
3784
If the Cover Text requirement of section 3 is applicable to these copies
3785
of the Document, then if the Document is less than one half of the entire
3786
aggregate, the Document’s Cover Texts may be placed on covers that
3787
bracket the Document within the aggregate, or the electronic equivalent of
3788
covers if the Document is in electronic form. Otherwise they must appear
3789
on printed covers that bracket the whole aggregate.
3791
<p class="simpara block">
3792
Translation is considered a kind of modification, so you may distribute
3793
translations of the Document under the terms of section 4. Replacing
3794
Invariant Sections with translations requires special permission from
3795
their copyright holders, but you may include translations of some or all
3796
Invariant Sections in addition to the original versions of these Invariant
3797
Sections. You may include a translation of this License, and all the
3798
license notices in the Document, and any Warranty Disclaimers, provided
3799
that you also include the original English version of this License and the
3800
original versions of those notices and disclaimers. In case of a
3801
disagreement between the translation and the original version of this
3802
License or a notice or disclaimer, the original version will prevail.
3804
<p class="simpara block">
3805
If a section in the Document is Entitled “Acknowledgements”,
3806
“Dedications”, or “History”, the requirement
3807
(section 4) to Preserve its Title (section 1) will typically require
3808
changing the actual title.
3810
<p class="simpara block">
3811
You may not copy, modify, sublicense, or distribute the Document except as
3812
expressly provided under this License. Any attempt otherwise to copy,
3813
modify, sublicense, or distribute it is void, and will automatically
3814
terminate your rights under this License.
3816
<p class="simpara block">
3817
However, if you cease all violation of this License, then your license
3818
from a particular copyright holder is reinstated (a) provisionally, unless
3819
and until the copyright holder explicitly and finally terminates your
3820
license, and (b) permanently, if the copyright holder fails to notify you
3821
of the violation by some reasonable means prior to 60 days after the
3824
<p class="simpara block">
3825
Moreover, your license from a particular copyright holder is reinstated
3826
permanently if the copyright holder notifies you of the violation by some
3827
reasonable means, this is the first time you have received notice of
3828
violation of this License (for any work) from that copyright holder, and
3829
you cure the violation prior to 30 days after your receipt of the notice.
3831
<p class="simpara block">
3832
Termination of your rights under this section does not terminate the
3833
licenses of parties who have received copies or rights from you under this
3834
License. If your rights have been terminated and not permanently
3835
reinstated, receipt of a copy of some or all of the same material does not
3836
give you any rights to use it.
3838
<p class="simpara block">
3839
The Free Software Foundation may publish new, revised versions of the GNU
3840
Free Documentation License from time to time. Such new versions will be
3841
similar in spirit to the present version, but may differ in detail to
3842
address new problems or concerns. See
3843
<a class="ulink" href="http://www.gnu.org/copyleft/" title="http://www.gnu.org/copyleft/">Copyleft</a>.
3845
<p class="simpara block">
3846
Each version of the License is given a distinguishing version number. If
3847
the Document specifies that a particular numbered version of this License
3848
“or any later version” applies to it, you have the option of
3849
following the terms and conditions either of that specified version or of
3850
any later version that has been published (not as a draft) by the Free
3851
Software Foundation. If the Document does not specify a version number of
3852
this License, you may choose any version ever published (not as a draft)
3853
by the Free Software Foundation. If the Document specifies that a proxy
3854
can decide which future versions of this License can be used, that
3855
proxy’s public statement of acceptance of a version permanently
3856
authorizes you to choose that version for the Document.
3858
<p class="simpara block">
3859
“Massive Multiauthor Collaboration Site” (or “MMC
3860
Site”) means any World Wide Web server that publishes copyrightable
3861
works and also provides prominent facilities for anybody to edit those
3862
works. A public wiki that anybody can edit is an example of such a
3863
server. A “Massive Multiauthor Collaboration” (or
3864
“MMC”) contained in the site means any set of copyrightable
3865
works thus published on the MMC site.
3867
<p class="simpara block">
3868
“CC-BY-SA” means the Creative Commons Attribution-Share Alike
3869
3.0 license published by Creative Commons Corporation, a not-for-profit
3870
corporation with a principal place of business in San Francisco,
3871
California, as well as future copyleft versions of that license published
3872
by that same organization.
3874
<p class="simpara block">
3875
“Incorporate” means to publish or republish a Document, in
3876
whole or in part, as part of another Document.
3878
<p class="simpara block">
3879
An MMC is “eligible for relicensing” if it is licensed under
3880
this License, and if all works that were first published under this
3881
License somewhere other than this MMC, and subsequently incorporated in
3882
whole or in part into the MMC, (1) had no cover texts or invariant
3883
sections, and (2) were thus incorporated prior to November 1, 2008.
3885
<p class="simpara block">
3886
The operator of an MMC Site may republish an MMC contained in the site
3887
under CC-BY-SA on the same site at any time before August 1, 2009,
3888
provided the MMC is eligible for relicensing.
3890
<p class="simpara block">Para usar esta licencia en un documento que usted haya escrito, incluya una copia de la Licencia en el documento y ponga el siguiente copyright y notificación de licencia justo después de la página de título:</p>
3891
<div dir="ltr" class=" block screen block-indent"><pre class="screen">Copyright © YEAR YOUR NAME
3893
Permission is granted to copy, distribute and/or modify this document under the
3894
terms of the GNU Free Documentation License, Version 1.3 or any later version
3895
published by the Free Software Foundation; with no Invariant Sections, no
3896
Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in
3897
the section entitled “GNU Free Documentation License”.</pre></div>
3898
<p class="simpara block">
3899
If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
3900
replace the “with… Texts.” line with this:
3902
<div dir="ltr" class=" block screen block-indent"><pre class="screen">with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts
3903
being LIST, and with the Back-Cover Texts being LIST.</pre></div>
3904
<p class="simpara block">
3905
If you have Invariant Sections without Cover Texts, or some other
3906
combination of the three, merge those two alternatives to suit the
3909
<p class="simpara block">
3910
If your document contains nontrivial examples of program code, we
3911
recommend releasing these examples in parallel under your choice of free
3912
software license, such as the GNU General Public License, to permit their
3913
use in free software.
3917
<div class="navbar navbar-bottom"><table class="navbar"><tr>
3918
<td class="navbar-prev"></td>
3919
<td class="navbar-next"></td>