# Caja-Actions Configuration Tool User's Manual

## Introduzione

Caja-Actions è una estensione di Caja la cui funzione principale è consentire all'utente di aggiungere azioni arbitrarie ai menù contestuali del file manager. Queste azioni possono essere organizzate in menù e sottomenù, esportate o condivise con altri ambienti desktop.

Lo Strumento di configurazione di Caja-Actions è l'interfaccia utente che permette di configurare con precisione come, dove e quando far comparire le vostre azioni nei menù contestuali di Caja, ed il modo in cui esse saranno eseguite.

Lo Strumento di configurazione di Caja-Actions fornisce le seguenti funzionalità:

- Definire e configurare le azioni partendo da zero.

- Organizzare le azioni in menù, sottomenù eccetera.

- Importare ed esportare le azioni e i menù da e verso il mondo esterno.

Caja-Actions inoltre viene fornito con le seguenti caratteristiche aggiuntive:

- Un plugin Caja che esporta in tempo reale sul D-Bus i file correntemente selezionati.

- Un programma a linea di comando in grado di eseguire ogni azione.

  Associato all'interfaccia D-Bus, questo programma consente all'utente di eseguire ogni azione da una combinazione di tasti scorciatoia, applicando questa azione agli elementi correntemente selezionati nel file manager.

- Un programma a linea di comando in grado di creare una nuova azione.

Tutte queste caratteristiche sono spiegate con maggiori dettagli nella documentazione generale di Caja-Actions.

## Per Iniziare

### Starting Caja-Actions Configuration Tool

You can start Caja-Actions Configuration Tool in the following ways:

System menu

- Choose Preferences Look and Feel Caja-Actions Configuration Tool.

Riga di comando

- To start Caja-Actions Configuration Tool from a command line, type the following command:

  ``caja-actions-config-tool``

  then press Return.

  Per visualizzare le opzioni dalla riga di comando, digitare:

  ``caja-actions-config-tool` `--help-all``

  then press Return.

#### La prima esecuzione

When you start Caja-Actions Configuration Tool, the following window is displayed.

##### Caja-Actions Configuration Tool Start Up Window

Shows Caja-Actions Configuration Tool main window. Contains menubar, toolbar, display area, an empty items list in the left, several disabled properties tabs, and statusbar.

The Caja-Actions Configuration Tool main window contains the following elements:

Barra dei menù.

- The menus on the menubar contain all of the commands you need to use in Caja-Actions Configuration Tool.

  Le scorciatoie disponibili per alcuni comandi:

  Ctrl N

- Crea una nuova azione.

Ctrl S

- Salva le azioni ed i menù modificati.

Ctrl Q

- Esce dall'applicazione.

Ctrl X

- Taglia la selezione corrente, mantenendola negli appunti.

Ctrl C

- Copia la selezione corrente negli appunti.

Ctrl V

- Inserisce il contenuto degli appunti prima dell'elemento corrente.

Shift Ctrl V

- Inserisce il contenuto degli appunti come sotto-elementi dell'elemento corrente.

Delete

- Elimina la selezione corrente.

F5

- Carica nuovamente i menù e le azioni.

F1

- Mostra l'aiuto.

Barra degli strumenti.

- Several toolbars may be displayed below the menubar, depending of your choices in the View Toolbars submenu.

Elenco degli elementi.

- The list on the left of the main window contains all items, whether they are actions or menus, currently available for edition in Caja-Actions Configuration Tool.

  Gli elementi possono essere ordinati in ordine alfabetico crescente o decrescente, oppure non essere ordinati affatto, essendo organizzati e gestiti direttamente dall'utente.

  i elementi non validi saranno mostrati in colore rosso.

  Gli elementi modificati saranno mostrati con il carattere corsivo.

ulsanti di ordinamento.

- Tre pulsanti che consentono di alternare tra le modalità di ordinamento disponibili.

Le schede delle proprietà.

- La parte destra della finestra principale mostra tutto ciò che serve per definire come, quando e dove dovrebbero essere visualizzate le azioni e i menù.

  Azione/Menù

- Define in which Caja menus the item should appear, and how it will be displayed.

Comando

- Specifica quale comando eseguire, e quali parametri passargli.

Esecuzione

- Specifica come dovrebbe essere eseguito il comando.

Nomi-base

- Define the basename filters the Caja selection must satisfy in order the action or menu be candidate for display.

Tipi mime

- Define the mimetype filters the Caja selection must satisfy in order the action or menu be candidate for display.

Cartelle

- Define the folder filters the Caja selection must satisfy in order the action or menu be candidate for display.

Schemi

- Define the scheme filters the Caja selection must satisfy in order the action or menu be candidate for display.

Capacità

- Define the capability filters the Caja selection must satisfy in order the action or menu be candidate for display.

Ambiente

- Define some environment conditions the Caja selection must satisfy in order the action or menu be candidate for display.

Proprietà

- Mostra le proprietà dell'elemento.

Barra di stato.

- La barra di stato mostra alcune informazioni sullo stato della riga attualmente selezionata nell'elenco degli elementi.

  Quando non ci sono informazioni rilevanti da mostrare, la barra di stato visualizza il conteggio dei menù, delle azioni e dei profili caricati.

  The « read-only » icon is displayed in the right of the statusbar when appropriate.

#### Creare la vostra prima azione

In questo esempio, mostreremo come creare una azione che mostra alcune interessanti informazioni sulla selezione corrente.

#### Verifica dei prerequisiti

This action will require MateDialog.

MateDialog is a program which will allow you to create a graphical user interface from a command-line.

Si dovrebbe verificare che questo programma sia installato sul sistema, digitando ad esempio in un terminale il comando seguente:

``matedialog``

then press Return.

#### Creare l'azione

To create a new action, choose Ctrl N File New action.

Verrà inserita una nuova azione nell'elenco degli elementi, e le sue proprietà saranno mostrate nelle schede sul pannello di destra.

L'etichetta dell'azione attualmente modificata (quella creata) viene aggiunta al nome dell'applicazione nella barra del titolo.

##### Azioni predefinite della nuova azione

Shows the default properties of a newly created action.

In the Items list, the new action is displayed in italic characters.

Il carattere corsivo è impiegato come promemoria per indicare che l'elemento non è stato salvato.

As another reminder that there is some pending modifications, an asterisk (« `*` ») comes to prefix the application name in the title bar.

#### Qualificare la vostra nuova azione

Consiste semplicemente nello scegliere come verrà visualizzata la vostra azione nel menù contestuale del file manager.

- Enter `My first action` in the Context label entry box.

  The Context label entry box contains the label of the action as you want it to be displayed in the file manager context menu.

  The label is a mandatory property of your action. If it happens to be empty, then your action will be considered as invalid by Caja-Actions: it will be displayed in red in Items list and will never be candidate to be displayed in the file manager context menus.

- Enter `This will execute an action with some parameters` in the Tooltip entry box.

  The Tooltip entry box contains the text you want to be displayed as a short help to your action.

- Select in the Icon drop-down list.

  The Icon selection defines the icon which will be associated with your action in file manager context menus and in the toolbar.

  Ci sono due possibilità per poter scegliere l'icona associata alla vostra azione:

  - Click on the Icon drop-down list to select an icon.

  - Click on Browse to search for an image in the filesystem.

#### Specificare il comando da eseguire

Quando selezionerete la vostra azione dal menù contestuale del file manager, questa verrà eseguita con argomenti a vostra scelta.

Click on the Command tab to show the page which will permit you to enter the command.

##### Pagina del comando

Shows the Command tab. This tab contains the name of the profile, the command to be executed along with its parameters, and the configuration of the starting working directory.

- Enter `matedialog` in the Path entry box.

  The Path entry box defines the command which will be executed when you will select your action in the file manager context menu.

  Ci sono due modi per definire il comando da eseguire:

  - Enter it in the Path entry box.

  - Click on Browse to select the executable file on the filesystem.

  If the command you enter does not have an absolute path, then it will be searched for in the `PATH` variable at execution time.

- Enter `--info --text='%c selected item(s): %U'` in the Parameters entry box.

  The Parameters contains the arguments which will be passed to your command when it will be executed. These arguments may embed parameters which will be expanded at runtime.

  If both Path and Parameters are empty, then this action will be considered as invalid: it will be displayed in red in Items list and will never be candidate to be displayed in the file manager context menus.

#### Salvataggio

To save all pending modifications, choose Ctrl S File Save.

Caja automatically takes into account your new action, and displays it in its context menu.

##### Your first action in the Caja context menu

Shows the first action in the Caja context menu.

Cliking of the item in the Caja context menu activates it, and executes the corresponding command.

##### Il risultato dell'esecuzione del vostro primo comando

Shows the result of the execution of your first action. This is MateDialog dialog box, displaying the URI of the selected item.

## Utilizzare lo Strumento di configurazione di Caja-Actions

### Definire le condizioni

Whether your action will eventually be displayed in Caja file manager context menus or in its toolbar depends on the conditions you will have defined for it.

Le condizioni possono essere poste contro la posizione a cui il file manager attualmente punta, o contro gli elementi correntemente selezionati in questa posizione.

Each time the selection or the location change in the file manager, Caja-Actions checks all your actions, comparing the defined conditions against the new location and selection: all defined conditions must be satisfied in order your action be actually displayed.

#### Condizioni basate sul nome-base

Si può decidere che la propria azione comparirà in base ai nome-base degli elementi attualmente selezionati nel file manager; si può definire che ciascun elemento della selezione debba soddisfare un certo nome-base, e si può decidere simultaneamente che nessuno degli elementi selezionati possa avere qualche altro nome-base.

Click on the Basenames tab to show the page which will permit you to configure your basename-based conditions.

##### Condizioni basate sul nome-base

Shows the tab which lets you define basename-based conditions.

Essenzialmente, le condizioni basate sui nomi-base sono costruite come un elenco di schemi « deve corrispondere ad uno di » e « non deve corrispondere a nessuno di ». Perché una azione possa essere candidata rispetto a queste condizioni basate sui nomi-base, ciascun elemento della selezione deve essere valido per tutte le condizioni elencate: il nome-base di ciascun elemento dovrà corrispondere ad almeno uno degli schemi « deve corrispondere ad uno di », e non dovrà corrispondere a nessuno degli schemi « non deve corrispondere a nessuno di ».

Se almeno un elemento della selezione non corrisponde a tutte le condizioni definite, la vostra azione non sarà visualizzata.

Quando mirano al menù contestuale di selezione, le vostre condizioni basate sui nomi-base saranno verificate per gli elementi attualmente selezionati. Quando mirano al menù contestuale di posizione o alla barra degli strumenti, le vostre condizioni basate sui nomi-base verranno verificate per il nome-base della posizione corrente.

Definire una nuova condizione basata sui nome-base richiede due fasi.

1. Definire il filtro per la nuova condizione.

   - Press Insert or click on button to insert a new condition filter

   - Modificare il filtro per la condizione appena inserito per il nome-base che si vuole identificare.

     A basename-based condition may use « `*` » or « `?` » wildcard characters.

2. Indica se è una condizione « deve corrispondere ad uno di » o « non deve corrispondere a nessuno di ».

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Depending of your target operating system, make sure that the Match case checkbox is activated (or not).

- When activated, all filters are considered as case sensitive, which means that `/my/file` filename is considered distinct from `/My/File` one.

  Questa è il comportamento predefinito sui sistemi tipo-Unix.

- When deactivated, filters are considered as case insensitive, which means that `/my/file` and `/My/File` filenames are considered the same name.

  This is most probably what you want if you target some sort of Windows system.

Removing a defined basename-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the basename-based condition is just one « `must match one of *` » condition. As all basenames always match the « `*` » condition, this just means that basename-based conditions are not considered as relevant for the action.

#### Condizioni basate sul tipo mime

Si può decidere che la propria azione comparirà in base al tipo mime degli elementi attualmente selezionati nel file manager; si può definire che ciascun elemento della selezione debba soddisfare un certo tipo mime, e si può decidere simultaneamente che nessuno degli elementi selezionati possa avere qualche altro tipo mime.

Click on the Mimetypes tab to show the page which will permit you to configure your mimetype-based conditions.

##### Condizioni basate sul tipo mime

Shows the tab which lets you define mimetype-based conditions.

Essenzialmente, le condizioni basate sui tipi mime sono costruite come un elenco di schemi « deve corrispondere ad uno di » e « non deve corrispondere a nessuno di ». Perché una azione possa essere candidata rispetto a queste condizioni basate sui tipi mime, ciascun elemento della selezione deve essere valido per tutte le condizioni elencate: il tipo mime di ciascun elemento dovrà corrispondere ad almeno uno degli schemi « deve corrispondere ad uno di », e non dovrà corrispondere a nessuno degli schemi « non deve corrispondere a nessuno di ».

Se almeno un elemento della selezione non corrisponde a tutte le condizioni definite, la vostra azione non sarà visualizzata.

Quando mirano al menù contestuale di selezione, le vostre condizioni basate sui tipi mime saranno verificate per gli elementi attualmente selezionati. Quando mirano al menù contestuale di posizione o alla barra degli strumenti, le vostre condizioni basate sui tipi mime verranno verificate per il nome-base della posizione corrente, che risulta essere il ben noto tipo mime « inode/directory ».

Definire una nuova condizione basata sui tipo mime richiede due fasi.

1. Definire il filtro per la nuova condizione.

   - Press Insert or click on button to insert a new condition filter

   - Modificare il filtro per la condizione appena inserito per il tipo mime che si vuole identificare.

     A mimetype must be defined as a `group/subgroup` expression.

     The « `*` » wildcard is supported only in some situations:

     - The « `*/*` » expression matches all mimetypes. As a convenient shortcut, the « `*` » literal is also accepted for this same purpose.

     - A `group/*` string matches all subgroups of `group` mimetype.

     - The `*/subgroup` string is not accepted as a valid wildcard.

2. Indica se è una condizione « deve corrispondere ad uno di » o « non deve corrispondere a nessuno di ».

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined mimetype-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the mimetype-based condition is just one « `must match one of */*` » condition. As all mimetypes always match the « `*/*` », this just means that mimetypes are not considered as relevant for the action.

##### Esempio di tipi mime comuni

`all/all`

- Corrisponde a tutti gli elementi.

`all/allfiles`

- Corrisponde a tutti i file regolari.

`inode/directory`

- Corrisponde solo alle directory.

#### Condizioni basate sulle cartelle

Si può decidere che la propria azione comparirà in base alla directory nella quale sono contenuti i file attualmente selezionati nel file manager: è possibile stabilire che ciascun elemento della selezione debba essere posizionato in una gerarchia o in un'altra; ed è inoltre possibile decidere simultaneamente che nessuno degli elemento selezionati possa essere posizionato in qualche altra gerarchia.

Una condizione basata sulle cartelle deve essere intesa come la specificazione della gerarchia in cui l'oggetto attualmente esaminato dovrebbe (o non dovrebbe) risiedere: è uno schema sul nome di percorso dell'elemento.

Click on the Folders tab to show the page which will permit you to configure your folder-based conditions.

##### Condizioni basate sulle cartelle

Shows the tab which lets you define folder-based conditions.

Essenzialmente, le condizioni basate sulle cartelle sono costruite come un elenco di schemi « deve corrispondere ad uno di » e « non deve corrispondere a nessuno di ». Perché una azione possa essere candidata rispetto a queste condizioni basate sulle cartelle, ciascun elemento della selezione deve essere valido per tutte le condizioni elencate: ciascun elemento dovrà essere posizionato in una una delle cartelle « deve corrispondere ad uno di », e non dovrà corrispondere a nessuna delle cartelle « non deve corrispondere a nessuno di ».

Se almeno un elemento della selezione non corrisponde a tutte le condizioni definite, la vostra azione non sarà visualizzata.

Quando mirano al menù contestuale di selezione, le vostre condizioni basate sulle cartelle saranno verificate per il nome del percorso dell'elemento attualmente selezionato. Quando mirano al menù contestuale di posizione o alla barra degli strumenti, le vostre condizioni basate sulle cartelle verranno verificate per la posizione corrente.

Definire una nuova condizione basata sulle cartelle richiede due fasi.

1. Definire il filtro per la nuova condizione.

   - Press Insert or click on button to insert a new condition filter

   - Modificare il filtro per la condizione appena inserito per la cartella che si vuole identificare.

     The « `*` » and « `?` » characters are accepted as wildcards at any level of the defined folder filter.

   - Or click on Browse to select a folder on the file system.

2. Indica se è una condizione « deve corrispondere ad uno di » o « non deve corrispondere a nessuno di ».

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined folder-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the folder-based condition is just one « `must match one of /` » condition. As `/` is always the top of an Unix-like file system, then all selected items always match this condition.

If you target a Windows system, then this default value may not be what you actually want.

#### Condizioni basate sugli schemi

Si può decidere che la propria azione comparirà in base agli schemi degli elementi attualmente selezionati nel file manager; si può definire che ciascun elemento della selezione debba possedere un certo schema, e si può decidere simultaneamente che nessuno degli elementi selezionati possa avere qualche altro schema.

Click on the Schemes tab to show the page which will permit you to configure your scheme-based conditions.

##### Condizioni basate sugli schemi

Shows the tab which lets you define scheme-based conditions.

Essenzialmente, le condizioni basate sugli schemi sono costruite come un elenco di modelli « deve corrispondere ad uno di » e « non deve corrispondere a nessuno di ». Perché una azione possa essere candidata rispetto a queste condizioni basate sugli schemi, ciascun elemento della selezione deve essere valido per tutte le condizioni elencate: lo schema di ciascun elemento dovrà corrispondere ad almeno uno dei modelli « deve corrispondere ad uno di », e non dovrà corrispondere a nessuno dei modelli « non deve corrispondere a nessuno di ».

Se almeno un elemento della selezione non corrisponde a tutte le condizioni definite, la vostra azione non sarà visualizzata.

Quando mirano al menù contestuale di selezione, le vostre condizioni basate sugli schemi saranno verificate per gli elementi attualmente selezionati. Quando mirano al menù contestuale di posizione o alla barra degli strumenti, le vostre condizioni basate sugli schemi verranno verificate per lo schema della posizione corrente.

Definire una nuova condizione basata sullo schema richiede due fasi.

1. Definire il filtro per la nuova condizione.

   - Press Insert or click on button to insert a new condition filter

   - Modificare il filtro per la condizione appena inserito per lo schema che si vuole identificare.

     Scheme-based conditions only accept « `*` » wildcard, which stands for « any scheme ».

   - Or click on Common to select a scheme among those predefined in Edit Preferences.

     ##### Selezionare uno schema tra quelli predefiniti.

     Show the list of predefined schemes.

     Un nuovo schema può essere qui selezionato solo se non è già definito come filtro di schema.

     To select a new scheme, click OK, or double-click on the desired row.

2. Indica se è una condizione « deve corrispondere ad uno di » o « non deve corrispondere a nessuno di ».

   Click on the Must match one of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined scheme-based condition is as simple as selecting it, and pressing Del (or clicking on button).

By default, the scheme-based condition is just one « `must match one of *` » condition, which means that schemes are not relevant for this action.

#### Condizioni basate sulle capacità

Le capacità sono certe proprietà che un file può mostrare all'utente.

But except for the `Local` capability, all others depend on the user who executes the command.

You may so decide that your action will appear, or not, depending on the capabilities of the selected item(s) vs. the current user.

Click on the Capabilities tab to show the page which will permit you to configure your capability-based conditions.

##### Condizioni basate sulle capacità

Shows the tab which lets you define capability-based conditions.

Essenzialmente, le condizioni basate sulle capacità sono costruite come un elenco di schemi « deve corrispondere ad uno di » e « non deve corrispondere a nessuno di ». Perché una azione possa essere candidata rispetto a queste condizioni basate sulle capacità, ciascun elemento della selezione deve essere valido per tutte le condizioni elencate: la capacità di ciascun elemento dovrà corrispondere ad almeno uno dei modelli « deve corrispondere ad uno di », e non dovrà corrispondere a nessuno dei modelli « non deve corrispondere a nessuno di ».

Se almeno un elemento della selezione non corrisponde a tutte le condizioni definite, la vostra azione non sarà visualizzata.

Quando mirano al menù contestuale di selezione, le vostre condizioni basate sulle capacità saranno verificate per gli elementi attualmente selezionati. Quando mirano al menù contestuale di posizione o alla barra degli strumenti, le vostre condizioni basate sulle capacità verranno verificate per lo schema della posizione corrente.

Definire una nuova condizione basata sulle capacità richiede due fasi.

1. Definire il filtro per la nuova condizione.

   - Press Insert to insert a new condition filter.

   - Modificare il filtro per la condizione appena inserito per la capacità che si vuole identificare.

   - Or click on to open the Adding a new capability dialog box.

     ##### Capacità gestite

     Shows the list of managed capabilities.

     Una nuova capacità può essere qui selezionato solo se non è già definito come filtro di capacità.

     To select a new capability, click OK, or double-click on the desired row.

2. Indica se è una condizione « deve corrispondere ad uno di » o « non deve corrispondere a nessuno di ».

   Click on the Must match all of or Must not match any of radio button in the same row to set the corresponding condition.

Removing a defined capability-based condition is as simple as selecting it, and pressing Del (or clicking on button).

Come valore predefinito, la condizione basata sulla capacità è un elenco vuoto. Questo significa che le capacità non sono rilevanti per questa azione.

#### Condizione di conteggio della selezione

È possibile stabilire che la vostra azione sarà visualizzata se la selezione corrente nel file manager ha un preciso conteggio, o una particolare relazione con un dato conteggio.

##### Un caso d'uso del conteggio della selezione

If your action consists in displaying the differences between two files, you may define here « `Count = (equal to) 2` ».

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

##### Condizioni basate sull'ambiente

Shows the tab which lets you define environment-based conditions. This includes the selection count configuration, the desktop selection, along with the runtime filters.

The selection count condition is defined in the 'Appears if selection contains' frame.

##### Cornice per la selezione del conteggio della selezione

Focus on the Appears if selection contains frame.

Quando mirano al menù contestuale di selezione, le condizioni basate sul conteggio saranno verificate per il conteggio degli elementi attualmente selezionati. Quando mirano al menù contestuale di posizione o alla barra degli strumenti, le vostre condizioni basate sui nomi-base verranno verificate contro lo zero perché in questo caso non c'è una selezione.

Per selezionare una condizione per il conteggio della selezione:

- Select in the Count drop-down list the operator you want apply to the selection count:

  - `<` (strictly less than)
  - `=` (equal to)
  - `>` (strictly greater than)

- Inserire il conteggio di riferimento che si desidera.

The selection count defaults to « `Count > (strictly greater than) 0` », which means that the action will be a candidate to be displayed as soon as at least one item is selected in the file manager.

#### Selezione del Desktop

Si può definire che la vostra azione:

- comparirà sempre,

- o comparirà solo in un dato ambiente desktop,

- o non comparirà in un particolare ambiente desktop.

È possibile solo una condizione fra questi tre elementi.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

The desktop selection is defined in the Desktop environment frame.

##### Cornice di selezione del desktop

Focus on the Desktop environment frame.

Per definire la condizione sull'ambiente desktop:

1. Selezionare per prima cosa il tipo di filtro:

   - la vostra azione dovrà apparire indipendentemente dall'ambiente desktop ?
   - la vostra azione dovrà apparire solo in alcuni ambienti desktop ?
   - La vostra azione non deve mai comparire in alcuni ambienti desktop ?

2. Se la vostra azione non compare sempre, selezionate l'ambiente o gli ambienti desktop nella casella ad elenco sul lato destro.

The targeted desktop environment condition defaults to « `Always appear` », which means that the action will be a candidate to be displayed regardless of the current desktop environment.

#### Condizione di eseguibile trovato

È possibile definire che la vostra azione compaia se un qualche pacchetto prerequisito è installato sul vostro sistema. Questo viene controllato qui indicando che un file specifico, conosciuto o almeno ipotizzato come fornito dal pacchetto, debba essere presente sul file system, ed eseguibile.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions.

The executable found condition is defined in the Execution environment frame.

##### Cornice dell'ambiente di esecuzione

Focus on the Execution environment frame.

To define the relevant file, enter its full filename in the Appears if the file is executable entry box, or click on Browse to select a file on the file system.

Lasciare il campo bianco se questa condizione non è rilevante per la vostra azione.

È possibile inserire alcuni parametri nel nome-file cercato. Questi parametri saranno sostituiti dinamicamente al runtime con valori che dipenderanno dagli elementi correntemente selezionati.

#### Condizione di registrazione D-Bus

È possibile definire che la vostra azione compaia se un qualche dato nome è registrato sul sistema D-Bus al runtime.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

To define the relevant name, enter it in the Appears if the name is registered on D-Bus entry box.

Lasciare il campo bianco se questa condizione non è rilevante per la vostra azione.

È possibile inserire alcuni parametri nel nome cercato. Questi parametri saranno sostituiti dinamicamente al runtime con valori che dipenderanno dagli elementi correntemente selezionati.

#### Condizioni personalizzate

You may define that your action will only appear if some given command outputs a `true` string on its standard output.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

This lets you define your own customized condition filter, by writing a small script which outputs, or not, the `true` string on stdout when it is ran.

To define the command, enter it in the Appears if the command outputs "true" entry box.

Lasciare il campo bianco se questa condizione non è rilevante per la vostra azione.

È possibile inserire alcuni parametri nel nome-file eseguito o nelle sue opzioni. Questi parametri saranno sostituiti dinamicamente al runtime con valori che dipenderanno dagli elementi correntemente selezionati.

#### Condizione sul processo in esecuzione

È possibile definire che la vostra azione compaia se un qualche file binario è attualmente in esecuzione.

Click on the Environment tab to show the page which will permit you to configure your environment-based conditions, and focus on Execution environment frame.

To define the binary, enter its name in the Appears if the binary is running entry box, or click on Browse to select a file on the file system.

Anche se si inserisce il nome-file completo del file binario, nella lista dei processi in esecuzione sarà cercato solo il suo nome-base.

Lasciare il campo bianco se questa condizione non è rilevante per la vostra azione.

È possibile inserire alcuni parametri nel nome cercato. Questi parametri saranno sostituiti dinamicamente al runtime con valori che dipenderanno dagli elementi correntemente selezionati.

### Trovare l'azione

#### Configurazione del luogo di visualizzazione

Shows the three fields which let you configure the target of your action.

Caja file manager may display your action in different places, depending on what you will request here, and if some item is currently selected (or not).

Click on the Action tab to show the page which will permit you to configure the locations your action targets.

#### Fare riferimento al menù contestuale della selezione

When Display item in selection context menu is checked, then your action will be a candidate to be displayed in Caja' context menu as soon as at least one item is selected in the file manager. Your action will so deal with currently selected item(s).In order to be actually displayed, all the conditions defined in your candidate action must be met by each item currently selected in the Caja file manager.

When an action targets the selection context menu, and is actually displayed in Caja' context menu, then it is also displayed in Caja' Edit menu.

Questa posizione è spuntata per valore predefinito.

#### Fare riferimento al menù contestuale della posizione

When Display item in location context menu checkbox is activated, then your action will be a candidate to be displayed in Caja' context menu when the file manager selection is empty. Your action will so deal with currently displayed location. In order to be actually displayed, all the conditions defined in your candidate action must be met by the location currently displayed in the Caja file manager.

When an action targets the location context menu, and is actually displayed in Caja' context menu, then it is also displayed in Caja' File menu.

#### Mirare alla barra degli strumenti

When Display item in the toolbar checkbox is activated, then your action will be a candidate to be displayed in Caja' toolbar.

Le azioni visualizzate nella barra degli strumenti gestiscono la posizione attualmente visualizzata nel file manager, non gli elementi che possono essere attualmente selezionati. Affinché siano visualizzate, tutte le condizioni definite nella vostra azione dovranno essere soddisfatte dalla posizione corrente.

#### Annotazioni

#### Se una azione deve essere visualizzata in un menù contestuale

Whether it is the selection context menu or the location context menu, and both in Caja' context menus and in File or Edit menus, it will be displayed as

- the Context label as a label,

- the Icon,

- these two properties being associated with the Tooltip.

A seconda dell'esatta configurazione del vostro ambiente desktop, l'icona può essere o non essere visualizzata davanti all'etichetta nel menù.

E' possibile inglobare alcuni paramenti nell'etichetta, nel nome dell'icona o nel suggerimento. Questi parametri saranno sostituiti dinamicamente al runtime con valori che dipenderanno dagli elementi correntemente selezionati.

#### Se l'azione deve essere visualizzata nella barra degli strumenti

essa sarà visualizzata come

- the Toolbar label as a label,

- the Icon,

- these two properties being associated with the Tooltip.

A seconda dell'esatta configurazione del vostro ambiente desktop, l'etichetta può essere o non essere visualizzata davanti all'icona nella barra degli strumenti.

The toolbar label defaults to the same label as those used in menus. By unchecking the Use same label for icon in the toolbar checkbox you can define a label specific to the toolbar, which is usually shorter that those defined for the menus.

È possibile incorporare dei parametri nell'etichetta della barra degli strumenti, nel nome dell'icona o nel suggerimento. Questi parametri verranno automaticamente sostituiti al runtime con i valori che dipenderanno dagli elementi correntemente selezionati.

#### Definire diversi bersagli

Un'azione può mirare al menù contestuale di selezione, al menù contestuale della posizione e alla barra degli strumenti, o ad una o più di essi.

#### Non definire alcun bersaglio

If no target is defined, i.e. if the three checkboxes are unchecked, then your action will never be displayed.

### Quale azione dovrebbe essere eseguita ?

Con molta probabilità si desidera che la propria azione esegua qualcosa. E, come dato di fatto, avere qualcosa da eseguire è una delle poche condizioni richieste perché una azione sia considerata valida.

As we have already seen, the command to be executed is configured in the Command page.

Questo comando può prendere argomenti, i quali a loro volta possono essere parametri integrati. Questi parametri saranno espansi al runtime, con valori che dipenderanno dagli elementi correntemente selezionati.

#### Parametri disponibili

In the Command page, click on Legend button to see the list of available parameters.

##### Elenco dei parametri disponibili

Shows the list of available parameters.

The Legend button has a toggling action: click once to display the Parameter Legend dialog box; click a second time to hide it.

The word « first » may be misleading as it only refers to the list of selected items internally provided by the file manager to the Caja-Actions plugin.

In particular, it has nothing to do with the visual selection you may have done in the file manager window. And, in fact, which is the « first » selected item in a multiple selection is absolutely undefined and rather unpredictable.

#### Dove dovrebbe essere eseguita l'azione ?

La vostra azione può essere eseguita in una particolare cartella di lavoro.

You may specify it in the Command tab, in the Working directory entry box, or by clicking on Browse to select a folder on the filesystem.

##### Cornice della cartella di lavoro

Focus on the working directory selection frame.

The working directory defaults to `%d`, which runs the command in the base directory of the (first) selected item.

In the particular case of the `%d` parameter, the « first » selected item is not very important because it is very likely that all selected items are located in the same base directory.

#### Come dovrebbe essere eseguita l'azione ?

Apart from configuring the conditions, the selection must be met in order your action be displayed in file manager menus, Caja-Actions allows you to configure how exactly your command will be executed.

Click on the Execution tab to show the page which configures the execution of your command.

##### Configurazione delle modalità di esecuzione

Shows how to configure the execution modes of a command.

##### Modalità di esecuzione

###### Configurazione della modalità di esecuzione

Focus on the execution mode frame.

La modalità di esecuzione del vostro comando può essere scelta tra questi valori:

Normale

- Avvia il comando come interfaccia utente grafica standard.

Terminale

- Avvia il terminale preferito dell'ambiente desktop, e vi esegue all'interno il comando.

Incorporato

- Fa uso di una speciale caratteristica del file manager che può consentire ad un terminale di essere eseguito al suo interno.

  As Caja does not have this feature, this option is strictly equivalent to `Terminal` option.

Mostra l'output

- Avvia il terminale preferito dell'ambiente desktop e vi esegue il comando. Alla fine, saranno visualizzati i flussi standard (stdout, stderr).

The execution mode of a command defaults to `Normal`. That is, the command is executed without any particular pre- or post-work.

##### Notifica di avvio

###### Configurazione delle modalità di avvio

Focus on the Startup mode frame.

If the execution mode of the command is `Normal`, and if you know that the application will send a `remove` message with the `DESKTOP_STARTUP_ID` environment variable set, then check the Startup notify checkbox.

See the Startup Notification Protocol Specification for more details.

##### Classe di finestra

If the execution mode of the command is `Normal`, and if you know that the application will map at least one window with a given class name, then enter that name into the Startup Window Manager class entry box.

See the Startup Notification Protocol Specification for more details.

##### Proprietario dell'esecuzione

###### Configurazione del proprietario dell'esecuzione

Focus on the Execute as frame.

Enter in the Execute as user entry box the username or the UID of the user your command will be run as.

Se non si inserisce nulla in questo campo, il comando verrà eseguito come utente corrente.

##### Esecuzioni multiple

Si può desiderare che il vostro comando sia eseguito una sola volta, fornendogli l'elenco degli elementi selezionati come argomento.

Oppure preferire che il vostro comando sia ripetuto per ciascun elemento selezionato, fornendo per ciascuna esecuzione un diverso elemento come argomento.

Actually, Caja-Actions automatically handles these two behaviors, depending of the form and the order of the parameters in the command arguments.

Though some parameters are not depending on the count of the selection (e.g. « `%c` », the selection count itself), most have two declensions:

- a « singular » one, e.g. « `%b` », the basename of the selected item;

- a « plural » one, e.g. « `%B` », the space-separated list of the basenames of selected items.

Quando la selezione è vuota o contiene solo un elemento, da questo punto di vista, queste due forme sono esattamente equivalenti.

Quando la selezione contiene più di un elemento:

- if the first relevant parameter is of a singular form, then Caja-Actions will consider that the command is only able to deal with one item at a time, and thus that it has to be ran one time for each selected item;

- contrarily, if the first relevant parameter found is of the plural form, then Caja-Actions will consider that the command is able to deal with a list of items, and thus the command will be executed only once;

- if all found parameters are irrelevant, then Caja-Actions defaults to consider that the command should be executed only once.

##### Characterization of the parameters vs. multiple execution

Parametro | Descrizione | Ripetizione
`%b` | (primo) nome-base | singolare |  |
`%B` | elenco separato da spazi di nomi-base |  |  | plurale
`%c` | conteggio degli elementi selezionati |  | irrilevante |
`%d` | (prima) cartella base | singolare |  |
`%D` | elenco separato da spazi delle cartelle base di ciascun elemento selezionato |  |  | plurale
`%f` | (primo) nome file | singolare |  |
`%F` | elenco separato da spazi dei nomi file selezionati |  |  | plurale
`%h` | nome host del (primo) URI |  | irrilevante |
`%m` | Tipo mime del (primo) elemento selezionato. | singolare |  |
`%M` | elenco separato da spazi dei tipi mime degli elementi selezionati |  |  | plurale
`%n` | nome utente del (primo) URI |  | irrilevante |
`%o` | operatore no-op che forza l'esecuzione singolare | singolare |  |
`%O` | operatore no-op che forza una forma di esecuzione plurale. |  |  | plurale
`%p` | Numero di porta del (primo) URI |  | irrilevante |
`%s` | Schema del (primo) URI |  | irrilevante |
`%u` | (primo) URI | singolare |  |
`%U` | elenco separato da spazi degli URI selezionati |  |  | plurale
`%w` | (primo) nome-base senza estensione | singolare |  |
`%W` | elenco separato da spazi dei nomi-base senza le loro estensioni |  |  | plurale
`%x` | (prima) estensione | singolare |  |
`%X` | elenco separato da spazi delle estensioni |  |  | plurale
`%%` | the « `%` » character |  | irrilevante |

###### Usage of singular vs. plural forms

Say the current folder is `/data`, and the current selection contains the three files `pierre`, `paul` and `jacques`.

###### If we have requested `echo %b`,

allora saranno eseguiti i seguenti comando:

- `echo pierre`
- `echo paul`
- `echo jacques`

This is because `%b` marks a singular parameter. The command is then run once for each of the selected items.

###### Contrarily, if we have requested `echo %B`,

allora sarà eseguito il seguente comando:

- `echo pierre paul jacques`

This is because `%B` marks a plural parameter. The command is then run only once, with the list of selected items as arguments.

###### If we have requested `echo %b %B`,

allora saranno eseguiti i seguenti comando:

- `echo pierre pierre paul jacques`
- `echo paul pierre paul jacques`
- `echo jacques pierre paul jacques`

This is because the first relevant parameter is `%b`, and so the command is run once for each selected item, replacing at each occurrence the `%b` parameter with the corresponding item. The second parameter is computed and added as arguments to the executed command.

###### And if we have requested `echo %B %b`,

sarebbero eseguiti i seguenti comandi:

- `echo pierre paul jacques pierre`

This is because the first relevant parameter here is `%B`. The command is then run only once, replacing `%B` with the space-separated list of basenames. As the command is only run once, the `%b` is substituted only once with the (first) basename.

### Utilizzare i profili per estendere una vostra azione

Ci sono situazioni in cui si desidera che una data azione si comporti in modo leggermente diverso a seconda degli elementi correntemente selezionati o dell'ambiente di runtime.

#### Apri un terminale qui

Supponiamo che si abbia un'azione che apre un terminale nella posizione corrente.

La avete configurate configurata per aprire il vostro terminale preferito nella posizione in cui il file manager attualmente punta.

Ma come fare se si seleziona una cartella nel file manager e si vuole aprire un terminale in quella posizione ? se vi basate sulla posizione corrente del file manager, il terminale si aprirà nella cartella genitrice della cartella specificata.

Una soluzione è quella di definire un nuovo profilo per la vostra azione, configurando questo profilo per aprire il terminale nella cartella specificata.

At runtime, Caja-Actions will successively examine each profile attached to your action. If the first profile targets a file while you have selected a directory, then Caja-Actions will just try with your second profile.

To create a new profile, first select the action in the items list, then choose File New profile.

Verrà creato un nuovo profilo nella vostra azione.

Si può quindi definire le condizioni che devono essere soddisfatte perché questo profilo sia selezionato, ed il comando che verrà eseguito.

#### Ordinare i profili dentro una azione

At runtime, Caja-Actions will begin with examining the conditions set on your action.

If these conditions (the action-conditions) are met, then Caja-Actions will examine in order each profile.

If these conditions (the action-conditions) are met, then Caja-Actions will examine in order each profile.

Se non viene trovato valido alcun profilo al runtime, l'azione sarà essa stessa considerata non valida, e non visualizzata nel menù contestuale del file manager.

Profiles of an action are ordered, and they are examined in that order at runtime. The first profile whose conditions are met will be validated, and made selectable in the Caja context menu.

Quindi l'ordine dei vostri profili è fondamentale in una azione: il primo profilo trovato valido sarà il solo ad essere selezionato.

È possibile ordinar i profili in una azione in due modi differenti.

1. Tagliare il profilo che si vuole spostare, selezionare quello prima del quale lo si vuole inserire, ed incollare il profilo.

2. Fare clic sul profilo da spostare, e trascinarlo nella posizione voluta.

### Organizzare gli elementi in menù

Al crescere del numero delle vostre azioni, vorrete organizzarle in menù, sottomenù, etc.

In order to create a new menu, choose File New menu.

A menu may be created anywhere in the list of your actions, but inside of an action (i.e. not between two profiles of an action).

Come azione, l'esatto posizionamento del nuovo menù dipenderà dal modo di ordinamento corrente:

Ordinamento manuale:

- Il nuovo menù è inserito proprio prima dell'azione o del menù corrente.

  Questa posizione non cambierà se successivamente si modifica l'etichetta del menù.

Ordine alfabetico crescente (decrescente):

- The new menu is inserted at the correct place, regarding the default « `New Caja menu` » label.

  Questo posto verrà cambiato automaticamente, ogni volta che si modifica l'etichetta del menù.

As an action, too, a menu requires a label, and may have an icon and a tooltip. Also, you may define some conditions in order your menu be candidate to be displayed in Caja context menu. If the defined conditions are not met at runtime, then your whole menu, including its submenus, its actions and so on, will not be displayed.

### Ordinare l'elenco degli elementi

Your actions and menus will be displayed in file manager context menus in the same order that they are listed in the Items list, on the left pane of the main Caja-Actions Configuration Tool window.

È possibile decidere di:

- Ordinare le vostre azioni e i vostri menù in ordine alfabetico o alfabetico inverso in base alla loro etichetta,

- Non ordinare, ed organizzare manualmente nell'ordine desiderato le proprie azioni o menù.

#### Ordinamento delle azioni e dei menù in ordine alfabetico

In queste modalità, le azioni ed i menù saranno ordinati nel loro genitore, a seconda della loro etichetta.

##### I pulsanti di ordinamento nella finestra principale

Shows the three sort buttons in the main window.

È possibile ordinare le azioni per:

- Click on (resp.)button to sort your actions in ascending (resp. descending) order.

- O modificare la preferenza corrispondente.

#### Organizzare le azioni e i menù in modo manuale

Quando gli elementi nella lista sono ordinati manualmente, i nuovi elementi saranno solitamente inseriti nella posizione corrente.

C'è però il caso in cui una azione sia selezionata, e non espansa (o che possiede solo un profilo). Inserire un nuovo profilo non lo posizionerà prima dell'azione, ma al suo interno.

Per selezionare questa modalità:

- Click on button.

- O modificare la preferenza corrispondente.

### Modifica

With Caja-Actions Configuration Tool, you may safely cut, copy, paste to and from the clipboard.

#### Taglia/Cancella

La cancellazione si applica alla selezione corrente.

Siate avvertiti che selezionando e cancellando tutti i profili di un'azione la si lascia senza alcun profilo, quindi in uno stato non valido. Il nome dell'azione sarà scritto in rosso (perché non è valida) ed in caratteri corsivi (perché è stata modificata).

#### Selezione multipla

Multiple selection is possible in Caja-Actions Configuration Tool. You can extend the current selection by pressing Ctrl or Shift while selecting an item to add to the selection.

Caja-Actions Configuration Tool only accepts homogeneous multiple selections. That is, you may select one or more profiles, or one or more actions or menus. A multiple selection containing both profiles and actions or menus is not allowed. This is because Caja-Actions Configuration Tool would not know where to paste such a selection.

Si noti che selezionando una qualsiasi riga significa selezionare anche i figli di quella riga. Questi figli sono detti « implicitamente selezionati »: essi saranno parte delle successive operazioni di modifica, ma non sono considerati quando si verifica se la selezione è omogenea. Inoltre essi non potranno essere selezionati (né deselezionati) esplicitamente.

### Salvare le modifiche

To save your modifications, choose Ctrl S File Save.

Verranno salvate tutte le modifiche effettuate. Verranno creati nuovi elementi dal primo provider di I/O disponibile.

Caja-Actions also has an Auto-save feature which is configurable in Preferences dialog box.

### Esportare le vostre azioni

### Importare le azioni

### Impostare le proprie preferenze

Choose Edit Preferences to access to the configuration of your preferences.

#### Preferenze di esecuzione

Shows the tab which lets you define runtime preferences.

#### Preferenze di esecuzione al runtime

Shows the tab which lets you define runtime execution preferences.

##### Selezione del Desktop

Let the user explicitely configure the current desktop.

#### Preferenze dell'interfaccia utente

##### preferenze UI

Shows the tab which lets you define UI preferences.

#### Preferenze di importazione

Shows the tab which lets you define import preferences.

#### Preferenze di esportazione

Shows the tab which lets you define export preferences.

#### Preferenze degli schemi

Shows the tab which lets you define schemes preferences.

#### Preferenze del provider di I/O

Shows the tab which lets you define I/O providers preferences.

## Informazioni varie

The new action is also displayed in red color in the items list. Red color is used as an indicator that the item is invalid, that is that the item cannot be candidate to be displayed in a Caja context menu because some of its informations are missing or erroneous. Here, and though this newly inserted action has some suitable defaults, it lacks a command to be executed to be considered valid by Caja-Actions Configuration Tool

## Malfunzionamenti noti e Limitazioni

### Malfunzionamenti conosciuti

Known bugs are available on Bugzilla summary page.

If you find some new bug in Caja-Actions, you are welcome to open it by pointing your favorite browser to Bugzilla web site.

#### Limitazioni conosciute

#### Modalità di esecuzione

As of version 3.0, execution mode may be configured in Caja-Actions Configuration Tool but is not yet honored by Caja plugin.

Questo riguarda la cartella di lavoro, la modalità di esecuzione, la notifica di avvio e i parametri del proprietario dell'esecuzione.

#### Scorciatoia suggerita

As of version 3.0, suggested shortcut, as described in DES-EMA specification, cannot be configured in Caja-Actions Configuration Tool, and is not honored by Caja plugin.

#### Separatore dei menù

As of version 3.0, menu separators cannot be configured in Caja-Actions Configuration Tool, and are not honored by Caja plugin.

One has to note that, for now, Caja file manager does not allow its plugins to define separators in the context menu.

## Informazioni su Strumento di configurazione di Caja-Actions

La prima versione di Caja-Actions è stata inizialmente scritta da Frederic Ruaudel (grumz@grumz.net) e Rodrigo Moya (rodrigo@gnome-db.org). È stata estesamente migliorata da Pierre Wieser (pwieser@trychlos.org) e Wolfgang Ulbrich (mate@raveit.de). Viene attualmente mantenuta dagli sviluppatori di MATE.

L'artwork è merito di una cortesia di of Ulisse Perusin (uli.peru@gmail.com) e DragonArtz (http://www.dragonartz.net).

Per segnalare un malfunzionamento o un suggerimento su Caja-Actions, sulloStrumento di configurazione di Caja-Actions, o su questo manuale, seguire le indicazioni nella Pagina di feedback di MATE, oppure potreste preferire, in base alle vostre preferenze, aprire direttamente un bug o una richiesta di miglioramento sul sito web Bugzilla.

## GNU Free Documentation License

Versione 1.3, 3 Novembre 2008

Copyright © 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.

Viene concesso a chiunque il diritto di distribuire riproduzioni fedeli di questo documento di licenza, ma la sua modifica non è permessa.

0. PREAMBOLO

Lo scopo di questa Licenza è quello di rendere un manuale, un libro di testo, o un qualsiasi altro documento utile e funzionale "libero" nel senso di libertà: per assicurare a chiunque il diritto di copiarlo e ridistribuirlo, con o senza modifiche, sia per scopi commerciali che non. In secondo luogo, questa Licenza garantisce all'autore e all'editore un modo per avere credito del proprio lavoro, non essendo questi responsabili delle modifiche fatte da terze parti.

Questa Licenza è una specie di "copyleft", che significa che i lavori derivati da questo documento devono essere essi stessi liberi nel medesimo senso. Essa completa la GNU General Public License, che è una licenza di copyleft redatta per il software libero.

Abbiamo redatto questa Licenza per poterla utilizzare per manuali di software libero, perché il software libero necessita di documentazione libera: il software libero dovrebbe essere accompagnato da manuali che forniscono la medesima libertà garantita dal software. Ma questa Licenza non è limitata ai manuali software; può essere impiegata per una qualsiasi opera di testo, indipendentemente dal contenuto e dal fatto che essa sia pubblicata come libro stampato. Suggeriamo questa Licenza principalmente per lavori il cui scopo sia l'istruzione o il riferimento.

1. APPLICABILITÀ E DEFINIZIONI

Questa Licenza si applica ad ogni manuale o altro lavoro, su qualsiasi mezzo, che contenga un avviso posto del detentore del copyright in cui si affermi che esso può essere distribuito sotto i termini di questa Licenza. Questo avviso garantisce una licenza senza royalty e di validità globale, di durata illimitata, per utilizzare quel lavoro sotto le condizioni qui affermate. Il "Documento", qui sotto, si riferisce ad ogni tale manuale o lavoro. Ciascun membro del pubblico è un licenziatario, e ci si riferisce ad esso come "voi". Si accetta la licenza se si copia, modifica o ridistribuisce il lavoro in un modo che richieda un permesso sotto la legge del copyright.

Una "Versione Modificata" del Documento significa un qualsiasi lavoro che contenga il Documento o una sua porzione, riprodotto fedelmente, o con modifiche e/o tradotto in un'altra lingua.

Una "Sezione Secondaria" è un'appendice con nome o una sezione preliminare del Documento che si occupi esclusivamente delle relazioni tra gli editori o gli autori del Documento e l'argomento generale del Documento stesso (o argomenti correlati) e non contiene nulla che possa rientrare direttamente nell'argomento complessivo. (quindi, se il Documento è in parte un libro di matematica, Una Sezione Secondaria non deve spiegare nulla di matematica). La relazione può essere un fatto di connessione storica con l'argomento o con argomenti correlati, o di posizione legale, commerciale, filosofica, etica o politica riguardo ad esse.

Le "Sezioni Non Modificabili" sono certe Sezioni Secondarie i cui titoli sono designati, come quelli di Sezioni Non Modificabili, nell'avviso che dice che il Documento è rilasciato sotto questa Licenza. Se una sezione non si adatta alla definizione precedente, allora non è permesso definirla come Non Modificabile. Il Documento può contenere zero Sezioni Non Modificabili. Se il Documento non identifica alcuna Sezione Non Modificabile, allora non ce n'è alcuna.

I "Testi di Copertina" sono certi brevi passaggi di testo che sono elencati, come Testi di Copertina e di Retro-Copertina, in un avviso che dica che il Documento viene rilasciato sotto questa Licenza. Un testo di Copertina può essere al massimo di 5 parole, e un testo di Retro-Copertina può essere al massimo di 25 parole.

Una copia "Trasparente" del Documento significa una copia leggibile meccanicamente, rappresentata in un formato la cui specifica è disponibile al pubblico generale, che è adatto per la revisione diretta del documento con editor di testo o (per immagini composte da pixel) con programmi di disegno generici o (per disegni) qualche editor di disegno largamente reperibile, e che è capace di fornire input a programmi di formattazione di testo o a traduttori automatici in una varietà di formati che possono essere usati come input per programmi di formattazione del testo. Una copia fatta in un formato file Trasparente la cui formattazione, o l'assenza di formattazione, è stata predisposta per impedire o scoraggiare la successiva modifica dai lettori non è Trasparente. Un formato di immagine non è Trasparente se utilizzato per ogni sostanziale quantitativo di testo. Una copia che non è "Trasparente" viene definita "Opaca".

Esempi di formati adatti per copie Trasparenti includono il formato ASCII semplice senza formattatori, il formato di input Texinfo, il formato di input LaTeX, l'SGML o lo XML che utilizzano un DTD disponibile pubblicamente, e testo semplice HTML conforme allo standard, il PostScript o il PDF creati per la modifica umana. Esempi di file di immagine trasparenti includono PNG, XCF, e JPG. I formati opachi includono formati proprietari che possono essere modificati solo con elaboratori di testo proprietari, l'SGML o lo XML per i quali il DTD e/o gli strumenti di elaborazione non sono disponibili pubblicamente, e il codice HTML generato automaticamente, il PostScript o il PDF prodotti da qualche elaboratore di testi per la sola visualizzazione.

Il "Frontespizio" indica, per un libro stampato, la pagina del titolo stessa più quelle successive atte a contenere, in modo leggibile, il materiale che questa Licenza richiede che compaia nella pagina del titolo. Per lavori in formati che non hanno alcun frontespizio come tale, "Frontespizio" significa il testo vicino al più evidente titolo dell'opera, che precede l'inizio del testo.

L'"Editore" indica ogni persona o entità che distribuisce al pubblico copie del Documento.

Una sezione "Intitolata XYZ" indica una sottounità del Documento il cui titolo o è precisamente XYZ o contine XYZ tra le parentesi che seguono il testo che traduce XYZ in un altro linguaggio. (Qui XYZ sta per un nome di una specifica sezione menzionata più avanti, come ad esempio "Ringraziamenti", "Dediche", "Approvazioni", "Storia"). Per "Mantenere il Titolo" di una tale sezione quando si modifica il Documento significa che rimane una sezione "Intitolata XYZ" secondo questa definizione.

Il Documento può includere Dichiarazioni di Esclusione di Responsabilità e di Garanzia accanto all'avviso che indichi che questa licenza si applica al Documento. Queste Dichiarazioni si considerano incluse per riferimento all'interno di questa Licenza, ma solo per quello che riguarda le dichiarazioni di esclusione di responsabilità o di garanzia: ogni altra implicazione che queste dichiarazioni possono avere è vana e non ha effetto sul significato di questa Licenza.

2. COPIE FEDELI

Potete copiare e distribuire il Documento su qualsiasi mezzo, sia per copi commerciali che non, a patto che questa Licenza, gli avvisi di copyright, e l'avviso di licenza che affermano che questa Licenza si applica al Documento vengano riprodotti su ogni copia e che voi non aggiungiate alcuna ulteriore condizione oltre quelle previste da questa Licenza. Non è possibile impiegare mezzi tecnici che impediscano o controllino la lettura o la creazione di nuove copie delle copie create e distribuite. È tuttavia possibile ricevere un compenso in cambio delle copie. Se distribuite un numero cospicuo di copie si applicano anche le condizioni della sezione 3.

È inoltre possibile dare copie in prestito, sotto le medesime condizioni stabile in precedenza, ed è possibile mostrare le copie al pubblico.

3. COPIE IN GRANDE QUANTITÀ

Se si pubblicano copie del Documento stampate (o copie su un qualsiasi mezzo che richieda copertine stampate), in numero superiore a 100, e l'avviso di licenza del Documento richiede Testi di Copertina, si dovrà accludere le copie in copertine che riportino, chiaramente e in modo leggibile, tutti questi Testi di Copertina: Testi di Copertina sulla prima di copertina e testi di Retro-Copertina sulla quarta di copertina. Entrambe le copertine dovranno indicarvi in modo chiaro e leggibile come editori di queste copie. La prima di copertina dovrà riportare il titolo completo con tutte le parole ugualmente evidenti e visibili. Sulle copertine è possibile riportare altro materiale in aggiunta. Copie le cui modifiche sono limitate alle copertine, purché preservino il titolo del Documento e soddisfino queste condizioni, possono essere considerate copie fedeli negli altri rispetti.

Se i testi richiesti per una copertina sono troppo voluminosi, dovreste mettere quelli elencati per prima (tanti quanti ne sono possibili in modo ragionevole) sulla copertina effettiva, e continuare il resto su pagine adiacenti.

Se pubblicate o distribuite copie Opache del Documento in numero superiore a 100, si dovrà includere una copia Trasparente leggibile da una macchina con ciascuna copia Opaca, o indicare in ogni copia Opaca un indirizzo di rete di computer da cui il pubblico che usa la rete abbia accesso per scaricare, usando protocolli di rete standard, una copia Trasparente completa del Documento, senza materiale aggiunto.. Se si utilizza questa seconda opzione, occorre prendere ragionevoli precauzioni, quando si inizia la distribuzione delle copie Opache in grande quantità, per garantire che questa copia Trasparente rimanga e sia accessibile alla posizione indicata fino ad almeno un anno dopo l'ultima volta che avrete distribuito al pubblico una copia Opaca di quella edizione (direttamente o attraverso vostri agenti o rivenditori).

È richiesto, ma non un requisito, che contattiate gli autori del Documento ben prima di ridistribuirne un grosso numero di copie, per dar loro la possibilità di fornirvi di una versione aggiornata del Documento.

4. MODIFICHE

Potete copiare e distribuire una Versione Modificata del Documento secondo le condizioni delle sezioni 2 e 3 precedenti, a patto che rilasciate la Versione Modificata precisamente sotto questa Licenza, con la Versione Modificata che prenda il posto del Documento, quindi dando in licenza la distribuzione e la modifica della Versione Modificata a chiunque ne possieda una copia. Inoltre, nella Versione Modificata occorre adempiere alle seguenti azioni:

1. Nel Frontespizio (e sulle copertine, qualora presenti) utilizzare un titolo diverso da quello del Documento e da quelli delle precedenti versioni (che dovrebbero, se ce ne fossero, essere elencate nella sezione Storia del Documento). Si può utilizzare uno dei titoli delle versioni precedenti se l'editore originale di quella versione ne dà il consenso.

2. Elencare nel Frontespizio, come autori, uno o più persone responsabili delle creazione delle modifiche della versione Modificata, insieme ad almeno cinque dei principali autori del Documento (tutti gli autori, qualora fossero meno di cinque), almeno che essi non vi sollevino da questa richiesta.

3. Indicare sul Frontespizio il nome dell'editore della Versione Modificata, espressamente come editore.

4. Mantenere inalterati tutti gli avvisi di copyright del Documento.

5. Aggiungere un avviso di copyright per le vostre modifiche accanto agli altri avvisi di copyright.

6. Includere, immediatamente sotto gli avvisi di copyright, un avviso di licenza che dia al pubblico la possibilità di utilizzare la Versione Modificata sotto i termini di questa Licenza, nella forma mostrata nell'Addendum più sotto.

7. Preservare in quell'avviso di licenza l'elenco completo delle Sezioni Non Modificabili e i Testi di Copertina richiesti, dati negli avvisi di licenza del Documento.

8. Includere una copia inalterata di questa Licenza.

9. Preservare la sezione Intitolata "Storia", mantenendone il Titolo e aggiungere ad essa una nota che indichi al meno il titolo, l'anno, i nuovi autori e l'editore della Versione Modificata come indicato sul Frontespizio. Se non esiste alcun sezione Intitolata "Storia" nel Documento, crearne una indicando titolo, anno, autori ed editore del Documento così come riportato nel suo Frontespizio, quindi aggiungere una nota che descriva la Versione Modificata così come riportato nella frase precedente.

10. Preservare la posizione sulla rete, se esiste, riportata nel Documento per l'accesso pubblico alla copia Trasparente del Documento e, parimenti, le posizioni sulla rete riportate nel Documento per le versioni precedenti su cui era basato. Queste posizioni possono essere poste nella sezione "Storia". Si possono omettere le posizioni di rete a lavori che sono stati pubblicati almeno quattro anni prima del Documento stesso, o se l'editore originale della versione a cui si riferisce ne dà il permesso.

11. Per ciascuna sezione intitolata "Ringraziamenti" o "Dediche", preservare il Titolo della sezione, e preservare nella sezione tutta la sostanza ed il tono di ciascuno dei ringraziamenti dei contributori o le dediche in essa riportati.

12. Preservare tutte le Sezioni Non Modificabili del Documento, inalterate nel testo e nei loro titoli. I numeri della sezione o equivalenti, non sono considerati parte dei titoli delle sezioni.

13. Cancellare ogni sezione Intitolata "Approvazioni". Tale sezione non può essere inclusa nella Versione Modificata.

14. Non ri-titolare alcuna sezione esistente che sia intitolata "Approvazioni" o andare in conflitto nel titolo con qualsiasi Sezione Non Modificabile.

15. Preservare ogni Dichiarazione di Esclusione di Garanzia.

Se la Versione Modificata include nuove sezioni di materiale di copertina o appendici che si qualificano come Sezioni Secondarie e non contengono materiale copiato dal Documento, potete a vostra discrezione definire alcune o tutte queste sezioni come non modificabili. Per fare ciò, aggiungere i loro titoli all'elenco delle Sezioni Non Modificabili nella nota di licenza della Versione Modificata. Questi titoli devono essere differenti da ogni altro titolo di sezione.

Potete aggiungere una sezione intitolata "Approvazioni", a patto che contenga null'altro che approvazioni della vostra Versione Modificata da varie parti — ad esempio, valutazioni da colleghi o che affermino che il testo è stato approvato da un'organizzazione come definizione autorevole di uno standard.

Nella Versione Modificata potete aggiungere un messaggio lungo fino a 5 parole come Testo di Copertina ed uno fino a 25 parole come testo di Retro-copertina, alla fine dell'elenco dei Testi di Copertina. Può essere aggiunto solo un passaggio di Testo di Copertina ed uno di Retro-copertina a (o per accorsi presi da) ciascuna entità. Se il Documento include già un testo di copertina per la stessa copertina, aggiunto in precedenza da voi o tramite accordi presi dalla stessa entità per conto della quale state agendo, non è possibile aggiungerne un altro; ma si può sostituire il vecchio testo, su esplicito permesso dell'editore precedente che ha aggiunto quello vecchio.

Autore(i) ed editore(i) del Documento non danno diritto mediante questa Licenza ad utilizzare il proprio nome per pubblicizzare od affermare o implicare approvazioni di alcuna Versione Modificata.

5. COMBINARE DOCUMENTI

Si può combinare il Documento con altri documenti rilasciati sotto questa Licenza, sotto le condizioni definite alla sezione 4 precedente relativa alle versioni modificate, a patto che si inseriscano nella combinazione tutte le Sezioni Non Modificabili di tutti i documenti originari, senza modifiche, e le si elenchi tutte come Sezioni Non Modificabili del vostro lavoro combinato nel suo avviso di licenza, e che si preservino inoltre tutte le loro Dichiarazioni di Esclusione di Garanzia.

Il lavoro combinato deve contenere solo una copia di questa Licenza, e le diverse Sezioni Non Modificabili aventi il medesimo testo possono essere sostituite da una singola copia di esse. Se ci sono più Sezioni Non Modificabili con lo stesso nome ma contenuto differente, rendere ciascuno dei nomi unico aggiungendo alla fine del titolo, tra parentesi, il nome dell'autore o dell'editore originale di quella sezione, se noti, o, in alternativa, aggiungendo un numero univoco. Apportare i medesimi cambiamenti ai titoli dell'elenco delle Sezioni Non Modificabili nell'avviso di licenza del lavoro combinato.

Nel lavoro combinato, si dovrà raccogliere ogni sezione intitolata "Storia" dei vari documenti formandone una sola Intitolata "Storia"; si dovrà fare lo stesso per le sezioni Intitolate "Ringraziamenti" e per quelle Intitolate "Dediche". Si dovranno cancellare tutte le sezioni Intitolate "Approvazioni".

6. COLLEZIONI DI DOCUMENTI

Potete creare una collezione composta dal Documento e da altri documenti rilasciati sotto questa Licenza, e sostituire le copie individuali di questa Licenza dei vari documenti con una singola inclusa nella raccolta, a patto che si seguano i termini di questa Licenza per le riproduzioni fedeli di ciascun documento in tutti gli altri aspetti.

È possibile estrarre un singolo documento dalla raccolta e distribuirlo individualmente sotto i termini di questa Licenza, a patto che si inserisca una copia della Licenza nel documento estratto, e si segua questa Licenza in tutti gli altri aspetti riguardanti le riproduzioni fedeli di quel documento.

7. AGGREGAZIONI CON LAVORI INDIPENDENTI

Una collezione del Documento o suoi derivati assieme ad altri documenti o lavori separati ed indipendenti, in o su un mezzo per la memorizzazione o la distribuzione, è chiamato "aggregato" se le norme sul copyright che risultano dalla collezione non sono impiegate per limitare i diritti legali degli usufruitori della collezione oltre a quanto permesso dai singoli lavori. Quando il Documento è incluso in un aggregato, questa Licenza non si applica agli altri documenti dell'aggregato che non sono essi stessi lavori derivati dal Documento.

Se il requisito dei Testi di Copertina della sezione 3 è applicabile a queste copie del Documento, qualora il Documento sia meno della metà dell'intero aggregato, i Testi di Copertina del Documento possono essere posti sulle copertine che racchiudono il Documento all'interno dell'aggregato, o l'equivalente delle copertine qualora il Documento fosse in formato elettronico. In caso contrario, questi testi devono comparire sulle copertine che racchiudono l'intero aggregato.

8. TRADUZIONE

La traduzione è considerata una specie di modifica, per cui è possibile distribuire traduzioni del Documento sotto i termini della sezione 4. Sostituire le Sezioni Non Modificabili con le loro traduzioni richiede permessi speciali da parte dei loro detentori del copyright, ma è possibile includere la traduzione di alcune o tutte le Sezioni Non Modificabili assieme alle versioni originali di queste Sezioni Non Modificabili. È possibile includere una traduzione di questa Licenza e di tutti gli avvisi di licenza del Documento, e delle Dichiarazioni di Esclusioni di Garanzia, purché si accludano le versioni originali di quegli avvisi di licenza e le dichiarazioni di esclusione di garanzia. In caso di discrepanza tra la traduzione e la versione originale di questa Licenza, di un avviso o di una dichiarazione di esonero di responsabilità, prevarrà la versione originale.

Se una sezione del Documento è Intitolata "Ringraziamenti", "Dediche", o "Storia", il requisito (sezione 4) di preservarne il Titolo (sezione 1) richiederà tipicamente di cambiare il titolo attuale.

9. TERMINE

Non è possibile copiare, modificare, sub-licenziare o distribuire il Documento se non come espressamente stabilito da questa Licenza. Ogni diverso tentativo di copia, modifica, sub-licenziamento o distribuzione è vano e farà cessare automaticamente i vostri diritti previsti da questa Licenza.

Tuttavia, se si cessa ogni violazione di questa Licenza, allora la licenza di un particolare titolare del copyright viene ripristinata (a) provvisoriamente, a meno che e finché il titolare del copyright non ponga esplicitamente e definitivamente fine alla vostra licenza, e (b) permanentemente, se il titolare del copyright non riesce a notificare la violazione con un qualche mezzo ragionevole entro 60 giorni dalla cessazione.

Inoltre, la vostra licenza da un particolare detentore del copyright viene ripristinata permanentemente se il detentore del copyright vi notifica la violazione con qualche mezzo ragionevole, se questa è la prima volta che si riceve un avviso di violazione di questa Licenza (per qualsiasi opera) da quel detentore del copyright, e voi ponete rimedio alla violazione entro 30 giorni dal ricevimento dell'avviso.

La cessazione dei vostri diritti in base a questa sezione non pone fine alle licenze delle parti che hanno ricevuto copie o diritti da voi nei termini di questa Licenza. Se i vostri diritti sono cessati e non sono stati ripristinati in modo permanente, la ricezione di una copia di una parte o di tutto lo stesso materiale non ti dà alcun diritto di usarlo.

10. REVISIONI FUTURE DI QUESTA LICENZA

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See Copyleft.

Ogni versione della Licenza riceve un numero di versione distintivo. Se il Documento specifica che si applica ad esso un particolare numero di versione di questa Licenza "o ogni versione successiva", avete la scelta di seguire i termini e le condizioni o di quella versione specifica o quelli di una qualsiasi versione successiva che sia stata pubblicata (non come bozza) dalla Free Software Foundation. Se il Documento non specifica un numero di versione di questa Licenza, potete scegliere una qualsiasi versione pubblicata (non come bozza) dalla Free Software Foundation. Se il Documento stabilisce che un delegato possa decidere quale versione futura di questa Licenza possa essere utilizzata, la dichiarazione pubblica di accettazione di una versione da parte di quel delegato vi autorizza permanentemente a scegliere quella versione per il documento.

11. RI-LICENZIAMENTO

"Massive Multiauthor Collaboration Site" (o "Sito MMC ) significa qualsiasi server World Wide Web che pubblica opere soggette a diritto d'autore e fornisce anche ingenti strutture per chiunque voglia modificare tali opere. Un wiki pubblico che chiunque può modificare è un esempio di tale server. Una "Massive Multiauthor Collaboration" (o "MMC") contenuta nel sito significa qualsiasi insieme di opere soggette a diritto d'autore così pubblicate sul sito MMC.

"CC-BY-SA" indica la licenza Creative Commons Attribution-Share Alike 3.0 pubblicata dalla Creative Commons Corporation, una società senza scopi di lucro con sede principale a San Francisco, California, così come le future versioni copyleft di tale licenza pubblicate dalla stessa organizzazione.

"Incorporare" significa pubblicare o ripubblicare un documento, in tutto o in parte, come parte di un altro documento.

Una MMC è "eleggibile per il ri-licenzamento" se è concessa in licenza sotto questa licenza, e se tutte le opere che sono state pubblicate per la prima volta sotto questa licenza in un luogo diverso da questo MMC, e successivamente incorporate in tutto o in parte nella MMC, (1) non hanno testi di copertina o sezioni invarianti, e (2) sono state così incorporate prima del 1 novembre 2008.

L'operatore di un sito MMC può ripubblicare un MMC contenuto nel sito sotto CC-BY-SA sullo stesso sito in qualsiasi momento prima del 1 agosto 2009, a condizione che l'MMC sia eleggibile per il ri-licenziamento.

ADDENDUM: Come utilizzare questa Licenza per i vostri documenti.

Per utilizzare questa Licenza in un documento che avete scritto, includere una copia della licenza nel documento e mettere i seguenti avvisi di copyright e di licenza subito dopo la pagina del titolo:

    Copyright © YEAR YOUR NAME

    Permission is granted to copy, distribute and/or modify this document under the
    terms of the GNU Free Documentation License, Version 1.3 or any later version
    published by the Free Software Foundation; with no Invariant Sections, no
    Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in
    the section entitled “GNU Free Documentation License”.

Se ci sono Sezioni Non Modificabili, Testi di Copertina e Testi di Retro-copertina, sostituire la frase "senza...Retro-copertina" con questa:

    with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts
    being LIST, and with the Back-Cover Texts being LIST.

Se si dispone di Sezioni Non Modificabili ma non di Testi di Copertina, o di una qualche altra combinazione delle tre, combinare quelle due alternative per meglio adattarle alla situazione.

Se il vostro documento contiene esempi significativi di codice di programmazione, raccomandiamo di rilasciare questi esempi in parallelo sotto una licenza di software libero di vostra scelta, come ad esempio la GNU General Public License, per consentire il loro impiego in software libero.