# Variabili del documento

Una variabile è un metodo semplice per permettere a &kword; di modificare il documento in maniera molto mirata, per riflettere la natura dei cambiamenti ad un documento o ad un rapporto.

Una variabile può essere un numero (come un numero di pagina, il numero totale di pagine nel documento, etc), una selezione di parole (il nome del cliente, il nome del prodotto, il nome del file del documento, etc.) una data, un'ora o praticamente ogni cosa desideri.

Una volta che la variabile è definita, un riferimento è inserito nel documento. &kword; sostituirà questo riferimento con il valore di questa variabile ogni volta che il riferimento è usato.

Le variabili possono essere fisse (che significa che una volta inserite il loro valore non cambia), oppure variabili (dove il riferimento è aggiornato da &kword; per riflettere il valore corrente della variabile).

Questo capitolo comincia con alcuni esempi di variabili comunemente usate (data, ora, e numeri di pagina), quindi dettaglia le variabili rimanenti che sono a tua disposzione. Finalmente, esaminerà in dettaglio come creare varibili personalizzate per i documenti.

## Data ed ora

Molte lettere, rapporti e documenti contengono informazioni sulla data o sull'ora a cui corrispondono. Le informazioni sulla data e sull'ora possono stabilire la creazione di un documento (che rimarrà fissata fino a che il documento circola), oppure la data e l'ora possono servire come una nota della data dell'ultima modifica (che cambierà ad ogni giorno che passa).

&kword; permette di avere data e ora sia fisse che variabili nel documento.

### Inserisci data

Per inserire la data nel documento, porta semplicemente il cursore nella posizione del testo dove la data dovrebbe essere inserita e seleziona Inserisci Variabile Data dalla barra dei menu. Questo farà apparire due possibilità: Data corrente (fissa) e Data corrente (variabile).

Data corrente (fissa)

- Selezionando quest'opzione si inserirà la data corrente nella posizione corrente del cursore. Questa data è stabilita dall'orologio di sistema del computer. Una volta inserita, questo valore non cambierà, anche se si chiede a &kword; di aggiornare le variabili del documento.

  Questo tipo di variabile è l'ideale per le date di creazione del documento, o quando si include la data in un rapporto del lavoro di oggi. Confronta questa scelta con la Data corrente (variabile).

Data corrente (variabile)

- Selezionando quest'opzione si inserirà la data corrente nella posizione corrente del cursore. Questa data è stabilita dall'orologio di sistema del computer. Questo valore cambierà quando si chiede a &kword; di aggiornare le variabili del documento.

  Quest'opzione è una buona scelta per un punto del documento in cui si vuole sempre la data corrente. Confronta questa scelta con la Data corrente (fissa)

Una volta che la data è stata scelta, apparirà una finestra di dialogo.

La lista a comparsa in alto determina l'aspetto della variabile. Le scelte possibili sono:

Impostazioni nazionali

- Questo inserisce la data nel formato specificato nel Centro di controllo di KDE.

  Per selezionare quest'opzione, accertati che la lista a comparsa riporti Impostazioni nazionali. Un'anteprima del formato della data apparirà sotto la casella di spunta Personalizzato. Se sei soddisfatto fai click su OK.

Forme di data preformattate

- &kword; possiede 12 tipi di data predefiniti. Questi tipi di data sono tutto quello che servono nella maggior parte dei casi. Seleziona semplicemente la data predefinita nella lista a comparsa in alto. Un'anteprima del formato della data apparirà sotto la casella di spunta Personalizzata. Se sei soddisfatto, fai click su OK.

Formato personalizzato

- Se non si trova un formato appropriato per la data, è possibile creare sequenza personalizzate per la data.

  Una sequenza per il formato della data consiste di una lista di lettere e numeri che seguono delle regole specifiche (che sono delineate di seguito) per creare la data completa.

  La sequenza del formato della date consiste di segnaposti e separatori. I segnaposti sono definiti nelle seguenti tre tabelle.

  Giorni

  Segnaposti dei giorni | g | gg | ggg | gggg
  Esempio | 6 | 06 | Gio | Giovedì

  Mesi

  Segnaposto per i mesi | M | MM | MMM | MMMM
  Esempio | 3 | 03 | Mar | Marzo

  Anno

  Segnaposti per gli anni | aa | aaaa
  Esempio | 02 | 2002

  Combina semplicemente i segnaposto con il testo normale (separatori) per creare sequenze di data complete.

  Per esempio:

  MM/gg/aaaa è trasformato in 03/06/2002

  e

  MMMM g, aaaa diventa Marzo 6, 2002

  Nota che solo i segnaposto cambiano. Spazi, virgole, barre ed altri elementi di testo rimangono invariati.

  E' importante ricordare che i segnaposti fanno differenza tra le maiuscole e le minuscole. GG non è un segnaposto, solamente gg.

  Per creare una sequenza di data personalizzata, metti un segno nella casella Personalizzata.

  Adesso digita i segnaposto ed i separatori nella casella a discesa. Alternativamente seleziona il formato dalla casella a discesa Inserisci, ed il segnaposto sarà inserito nella sequenza di data alla posizione voluta.

Un'anteprima della sequenza di data corrente è visibile sotto la casella Personalizzata. Fai clik su OK quando la sequenza della data è corretta, per inserire la variabile nel documento.

Una volta che la data è stata inserita nel documento, può essere modificata per avere un formato diverso ed è possibile passare da data fissa a variabile. Fai semplicemente click una volta con il &RMB; sulla data. Apparirà un piccolo menu. Seleziona Modifica variabile ed un sotto menu apparirà. Seleziona la nuova variabile o il nuovo formato dal menu e la variabile è subito aggiornata.

### Inserisci ora

Per inserire l'ora nel documento, posiziona semplicemente il cursore nella casella di testo dove l'ora dovrebbe essere inserita e seleziona Inserisci Variabile Ora dalla barra dei menu. Questo farà apparire due scelte: Ora corrente (fissa) e Ora corrente (variabile).

Ora corrente (fissa)

- Selezionando questa opziona si inserirà l'ora corrente nella posizione corrente del cursore. Quest'ora è determinata dall'ora di sistema del computer. Una volta inserito, il suo valore non cambierà, anche quando si chiede a &kword; di aggiornare le variabili del documento.

  Questo è l'ideale per i segnatempo. Confronta questa scelta con Ora corrente (variabile).

Ora corrente (variabile)

- Selezionando questa opzione si inserirà l'ora corrente nella posizione corrente del cursore. Quest'ora è determinata dall'ora di sistema del computer. Il suo valore cambierà quando si chiede a &kword; di aggiornare le variabili del documento.

  Quest'opzione va bene per un qualsiasi punto del tuo documento dove l'ora corrente è desiderata. Confronta questa scelta con Ora corrente (fissa)

Questo fa apparire una finestra di dialogo.

La lista a comparsa in alto determina l'aspetto della variabile. Le scelte sono:

Impostazioni nazionali

- Questo inserisce l'ora nel formato specificato nel centro di controllo di KDE.

  Per selezionare quest'opzione, accertati solamente che la lista a discesa riporti Impostazioni nazionali. Un'anteprima del formato dell'ora apparirà sotto la casella Personalizzato. Se sei soddisfatto, fai click su OK.

Frasi relative al tempo preimpostate

- &kword; ha 5 sequenze di data predefinite. Queste sequenze predefinite sono quelle che si usano in molte circostanze. Seleziona solamente la sequenza predefinita nella casella a discesa. Un'anteprima del formato della data apparirà sotto la casella Personalizzata. Se sei soddisfatto, fai click su OK.

Formato personalizzato

- Se un formato appropriato non può essere trovato, può essere creata una sequenza per il formato del tempo.

  Una sequenza per il formato di tempo consiste di una lista di lettere e numeri che seguono alcune regole specifiche (che sono delineate di seguito) per creare l'ora completa.

  La sequenza del formato del tempo consiste di segnaposto e separatori. I segnaposto sono definiti nelle seguenti cinque tabelle.

  Ore

  Segnaposto per le ore | h | hh
  Esempio | 6 | 06

  Minuti

  Segnaposti per i minuti | m | mm
  Esempio | 3 | 03

  Secondi

  Segnaposto per i secondi | s | ss
  Esempio | 2 | 02

  Millisecondi

  Segnaposto per i millisecondi | zzz
  Esempio | 022

  Secondi

  Segnaposto per AM/PM | ap | AP
  Esempio | am | AM

  Combina semplicemente i segnaposto con il testo normale (separatori) per creare sequenze di tempo complete.

  Per esempio:

  oo:mm:ss diventa 06:23:13

  e

  o:mm ap diventa 6:23 am

  Nota che solamente i segnaposti cambiano. Gli spazi, i due punti e l'altro testo rimane invariato.

  E' importante notare che i segnalibri fanno distinzione tra maiuscole e minuscole. OO non è un segnaposto, solo oo lo è.

  Per creare una sequenza di tempo personalizzata, metti un segno nella casella Personalizzata.

  Digita i segnaposto ed i separatori nella casella a discesa. Alternativamente, puoi selezionare il formato dalla casella Inserisci, ed il segnaposto sarà inserito nella sequenza di tempo alla posizione corrente del cursore.

  Un'anteprima della sequenza di tempo corrente è visibile sotto la casella Personalizza. Fai click su OK quando la sequenza di tempo è completa per inserire la variabile nel tuo documento.

Un'anteprima della sequenza di tempo corrente è visibile sotto la casella Personalizza. Fai click su OK quando la sequenza di tempo è completa per inserire la variabile nel tuo documento.

Una volta che un riferimento temporale è stato inserito nel documento, può essere modificato per fargli assumere un altro aspetto, e cambiato da tempo fisso a tempo variabile. Fai semplicemente click una volta con il &RMB; sulla variabile di tempo nel decumento. Apparirà un piccolo menu. Seleziona Cambia la variabile... ed un sottomenu apparirà. Seleziona la tua nuova variabile o il nuovo aspetto dal menu e la variabile è immediatamente aggiornata.

## Numerazione della pagina

Inserire i numeri di pagina è semplice in &kword;.

Ci sono due variabili correlate ai numeri di pagina: Pagina corrente e Numero di pagine

Per inserire il numero della pagina corrente, porta il cursore dove vuoi il numero della pagina e seleziona Inserisci Variabile Pagina Numero di pagina dalla barra dei menu. Il numero di pagina sarà inserito alla posizione corrente del cursore.

Per inserire il numero totale di pagine, porta il cursore dove vuoi che sia inserita la variabile e seleziona Inserisci Variabile Pagina Numero di paginedalla barra dei menu. Il numero totale di pagine sarà inserito.

I numeri di pagina sono aggiornati dinamicamente mentre il documento viene modificato.

I numeri di pagina sono normalmente posizionati all'interno delle intestazioni e dei piè di pagina. Questo assicura che ogni pagina avrà un numero di pagina al posto giusto.

## Sezione titolo

Puoi inserire la sezione del titolo in un punto qualsiasi del tuo documento selezionando Inserisci Variabile Pagina Titolo della sezione dalla barra dei menu.

&kword; determina il titolo della sezione iniziando una ricerca dall'inizio della pagina corrente. Il primo paragrafo con uno stile Intestazione 1 è il titolo della sezione. Se non ci sono paragrafi nella pagina corrente, &kword; esegue la stessa ricerca lungo le pagine precedenti fino a che non trova un titolo di sezione.

## Altre variabili

&kword; fornisce altre variabili usate comunemente che puoi trovare utili. Questo insieme di variabili è specifico al documento. Puoi inserire queste variabili selezionando Inserisci Variabile Informazioni sul documento dalla barra dei menu. Questo farà apparire un elenco di variabili. Le variabili sono dettagliate di seguito.

Variabile | Esempio | Dettagli
Nome del file | Resume.kwd | Inserisci il nome del file del documento.
Nome dell'autore | Paolo Rossi | Il nome dell'autore è specificato nella casella Informazioni sul documento.
Città | Firenze | Il codice postale specificato nella casella Informazioni sul documento.
Società | KDE | Il nome della società specificato nella casella Informazioni sul documento.
Stato | Italia | Il nome dello Stato specificato nella finestra Informazioni sul documento.
Nome della directory | /home/prossi/kword | Questo è il nome della directory per il documento. Il nome del file non è incluso nella variabile nome directory.
Directory e nome del file | /home/prossi/kword/Resume.kwd | La directory ed il nome del file del documento corrente.
Riassunto del documento | Questo è il mio attuale Curriculum Vitae | Il riassunto del documento specificato nella finestra Informazioni sul documento.
Titolo del documento | Il mio Curriculum Vitae | Il titolo del documento specificato nella finestra Informazioni sul documento.
Posta elettronica | prossi@kde.org | L'indirizzo di posta elettronica dell'autore così come specificato nella finestra Informazioni sul documento.
Fax | Un qualsiasi numero di telefono valido | Il numero di fax specificato nella finestra Informazioni sul documento.
Nome del file | Resume.kwd | Il nome completo del file.
Nome del file senza estensione | Resume | Questo elimina il suffisso del nome del file (normalmente .kwd) dal nome del file.
CAP (Codice di Avviamento Postale) | Un qualsiasi codice postale valido | Il codice postale specificato nella casella Informazioni sul documento.
Via | via Aurelia, n.123 | L'indirizzo della strada specificato nella finestra Informazioni sul documento.
Telefono | Un qualsiasi numero di telefono valido | Il numero di telefono specificato nella finestra Informazioni sul documento.
Titolo | Responsabile dei sistemi di comunicazione | Il titolo specificato nella sezione autore della finestra Informazioni sul documento.

Le varibili non inizializzate appariranno com <niente> fino a che non definisci il loro valore nella casella Informazioni sul documento.

## Variabili personalizzate

&kword; ha molte variabili preimpostate. Puoi trovare dei documenti dove sarebbe opportuno definire le tue variabili per un documento.

Utilizzando Variabili personalizzate puoi creare un numero illimitato di variabili per ogni documento.

### Creare una nuova variabile personalizzata

Per creare una nuova variabile personalizzata, porta il cursore nella posizione del documento in cui vuoi inserire la nuova variabile.

Seleziona Inserisci Variabile Personalizzata Nuova dalla barra dei menu. Questo farà apparire una finestra di dialogo.

Inserisci il nome della variabile ed il suo valore corrente nelle caselle di testo fornite.

Fai click su OK per creare il nuovo nome di variabile ed inserirlo alla posizione corrente del cursore. Fai click su Annulla per annullare la creazione della nuova variabile.

Adesso è possibile inserire questa nuova variabile in ogni posizione nel tuo documento.

### Modificare il valore di una variabile personalizzata

Perchè una variabile sia utile, hai bisogno di assegnarle un valore, ed anche di poterlo cambiare facilmente. Per cambiare il valore di una variabile:

Seleziona Strumenti Variabili personalizzate... dalla barra dei menu. Questo farà apparire una finestra di dialogo.

Ogni variabile personalizzata ha una riga in questa tabella. La prima colonna è il nome della variabile, la seconda il suo valore.

Per cambiare il valore di una variabile, fai semplicemente click dentro la casella di testo alla destra del nome della variabile. Inserisci il valore desiderato.

Quando tutte le modifiche sono state apportate, fai semplicemente click su OK e tutte le variabili saranno aggiornate.

### Inserire una variabile personalizzata.

Per inserire una nuova variabile personalizzata, seleziona Inserisci Variabile Personalizzata dalla barra dei menu. La variabile personalizzata è elencata nel sotto menu. Fai click sul nome della variabile e &kword; inserirà la variabile, con il valore corrente, alla posizione del cursore.

## Aggiornare i valori di tutte le variabili

Puoi dire a &kword; di aggiornare i valori di tutte le variabili (per essere sicuro che tutte le variabili siano impostate ai loro valori correnti). Questo è specialmente importante con le date e le variabili di tempo.

Seleziona semplicemente Inserisci Variabile Aggiorna tutte le variabili dalla barra dei menu.

## Aggiornare il valore di una data o di una variabile di tempo

Puoi dire a &kword; di aggiornare una singola data o variabile di tempo, e lasciare le altre come sono.

Porta semplicemente il puntatore del mouse sopra la variabile che vuoi aggiornare e fai click con il &RMB;. Apparirà un piccolo sotto menu che ti mostrerà varie nuove date o opzioni di formattazione per il tempo e l'opzione per cambiare una variabile di data o di tempo al formato fisso o a quello variabile. Seleziona semplicemente questa nuova opzione e questa variabile sarà aggiornata.