# Menu configurabile dall'utente

## Configurazione

&kile; supporta un menu configurabile dall'utente, che comparirà come parte del menu di &kile;. Lo si può configurare con la finestra di configurazione di &kile;, con Impostazioni Configura Kile Menu dell'utente.

Configurare il menu dell'utente
Configurare il menu dell'utente

Hai due scelte per dove mettere questo menu:

- O il Menu dell'utente apparirà nella barra dei menu principale tra i menu LaTeX e Assistente, e l'assistente di configurazione Modifica il menu dell'utente nel menu Assistente;

  Il menu dell'utente è nel menu principale
  Il menu dell'utente è nel menu principale

- O entrambi gli elementi appariranno in fondo al menu LaTeX.

  Il menu dell'utente come parte del menu LaTeX
  Il menu dell'utente come parte del menu LaTeX

Le etichette definite dall'utente preesistenti da versioni precedenti di &kile; vengono trasformate automaticamente nel nuovo menu configurabile dall'utente. Le etichette vengono salvate in un file di nome `usertags.xml`, e come tutti i file di definizione dei menu è reperibile nella cartella locale dei menu dell'utente di &kile;: `KILE_APP_DIR/usermenu/`, per esempio `/home/utente/.kde/share/apps/kile/usermenu/`.

Puoi usare diversi file di definizione dei menu per diversi compiti. Richiama l'assistente del menu dell'utente con Assistente Modifica il menu dell'utente o LaTeX Modifica il menu dell'utente per installare o modificare un file di definizione dei menu.

## Assistente

Puoi creare nuovi menu o cambiare gli attuali con un comodo assistente di configurazione dei menu dell'utente, accessibile da Assistente Modifica il menu dell'utente.

Assistente del menu dell'utente
Assistente del menu dell'utente

Sul lato sinistro vedrai l'albero del menu attuale. Come per un normale menu, sono disponibili tre tipi di elementi:

- voci del menu normali, assegnate ad un'azione;

- sottomenu, che contengono altri elementi;

- separatori, per dare una struttura visibile di tutte le voci.

Per modificare questo menu, usa i sei pulsanti sul lato sinistro. Altre azioni sono disponibili nel menu contestuale degli elementi preesistenti.

Albero del menu definito dall'utente
Albero del menu definito dall'utente

Ogni elemento normale del menu è assegnato a uno tra tre tipi di azione, dove ognuno ha diversi attributi impostabili:

- Testo &kile; dà la possibilità di creare le tue etichette. Un'etichetta è come una scorciatoia che avvia un comando o scrive del testo inserito di frequente: per esempio, un avvocato potrebbe usare sempre le stesse clausole nei suoi contratti. Questa etichetta sarà inserita alla posizione attuale del cursore alla chiamata di questa azione (vedi sopra). Sono disponibili anche i caratteri meta, vedi .

- Inserisci i contenuti del file: inserisce tutti i contenuti di un file indicato.

  Inserimento dei contenuti di un file
  Inserimento dei contenuti di un file

- Esegui programma: il risultato prodotto da questo programma può essere inserito nel documento aperto. Anche il carattere meta `%M` è disponibile nella riga di comando di questo programma: il testo selezionato verrà salvato in un file temporaneo, e `%M` indicherà il nome di questo file temporaneo.

  Eseguire un programma esterno
  Eseguire un programma esterno

Se mancano delle informazioni importanti per un'azione, gli elementi del menu sono colorati in rosso. Questo potrebbe indicare un file mancante.

File mancante
File mancante

o un titolo mancante per una voce del menu, che verrà mostrata con dei punti interrogativi, come ???.

Titolo mancante di una voce del menu
Titolo mancante di una voce del menu

Se apri il menu contestuale di un elemento così colorato in rosso, otterrai un'opzione aggiuntiva riguardo a questo errore.

Informazioni aggiuntive
Informazioni aggiuntive

Maggiori informazioni potrebbero essere disponibili con la funzionalità Che cos'è? della maggior parte degli oggetti.

## Segnaposti

### Inserire del testo

Ci sono alcuni segnaposti che puoi usare nelle etichette definibili dall'utente: `%C`, `%B`, `%M`, `%E`, `%R` e `%T`.

- `%C`: questo è dove il cursore sarà posizionato dopo l'inserimento di un'etichetta definita dall'utente.

  Posizione del cursore (%C)
  Posizione del cursore (%C)

- `%B`: sarà sostituito da un punto (vedi ).

  Punto (%B)
  Punto (%B)

- `%M`: sarà sostituito dal testo selezionato.

  Testo selezionato (%M)
  Testo selezionato (%M)

- `%E`: indica la profondità di rientro del testo in un ambiente.

  Rientro del testo dell'ambiente (%E)
  Rientro del testo dell'ambiente (%E)

- `%R`: richiamerà una finestra di riferimento per scegliere un'etichetta precedentemente definita. Questo si può usare per riferirsi a un'etichetta predefinita, selezionabile da un menu a cascata (vedi anche LaTeX Riferimenti ref o LaTeX Riferimenti pageref).

  Riferimenti (%R)
  Riferimenti (%R)

- `%T`: richiamerà una finestra di citazioni per scegliere una citazione definita in precedenza. Come nell'uso di LaTeX Riferimenti Cita, appare un elenco con tutte le chiavi di citazione.

  Chiavi di citazione (%T)
  Chiavi di citazione (%T)

Consideriamo un altro esempio, con la macro seguente `\frac{%M}{%C}`. Per prima cosa, selezioniamo un numero nel testo, poniamo `42`. Adesso invochiamo questa macro e otteniamo `\frac{42}{}` con il cursore posizionato nella seconda coppia di graffe.

### Inserire i contenuti di un file

Se vuoi inserire i contenuti di un file di testo, puoi usare gli stessi segnaposti.

### Eseguire un programma

Se vuoi eseguire un programma esterno, dalla riga di comando viene riconosciuto solo `%M` per il testo selezionato. La selezione verrà salvata in un file temporaneo e il segnaposto `%M` verrà sostituito con il nome di questo file.

Eseguire un programma esterno (%M)
Eseguire un programma esterno (%M)

Un altro segnaposto è `%S`, che viene sostituito dal nome di base completo del documento attuale senza il percorso. Questo nome di base è costituito da tutti i caratteri del file fino all'ultimo punto (`.`) escluso.

## Parametri

La maggior parte delle voci dei menu hanno altri parametri che si spiegano da sé che possono essere selezionati. Se alcuni di questi parametri non sono disponibili per qualche tipo di azione, vengono disabilitati.

Parametri del menu dell'utente
Parametri del menu dell'utente

Ecco un esempio di esecuzione di un programma esterno:

Esempio di parametro
Esempio di parametro

Puoi vedere che viene richiamato uno script `Perl`, che dovrebbe lavorare con la selezione attuale. Il parametro È necessario avere selezionato del testo è spuntato per assicurare la presenza di una selezione. Il risultato di questo script verrà inserito (Inserisci il risultato del programma scelto) e sostituirà la selezione attuale (Sostituisci il testo selezionato, ma non verrà selezionato.

Naturalmente puoi anche chiamare il tuo programma o il tuo script. Per esempio, seleziona una lista di numeri separati da spazi, e chiama uno script o un programma in Perl che trasformi questa selezione in un codice &latex; per una matrice. Qualunque possano essere le tue idee, puoi realizzarle utilizzando la seguente voce di menu dell'utente.

Esempio di parametro 2
Esempio di parametro 2

## File di definizione dei menu

Puoi installare diversi menu durante l'esecuzione per diversi compiti. Quando richiami l'assistente dei menu dell'utente, viene caricato l'attuale file di definizione dei menu. Se lo modifichi e chiudi la finestra con OK, le tue modifiche verranno salvate e installate come il nuovo menu dell'utente. Chiudere la finestra con Annulla scarterà le modifiche.

File di definizione dei menu
File di definizione dei menu

Sei anche libero di salvare il file modificato nella cartella dei menu dell'utente o caricare un altro file di definizione dei menu e installarlo. Tutti i file di definizione dei menu dell'utente vanno salvati nella cartella locale dei menu dell'utente di &kile;: ``KILE_APP_DIR`/usermenu/`.

Guarda il file di definizione dei menu d'esempio `example.xml` per vedere altre voci del menu coi loro parametri.