# Variabili del documento

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

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

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

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

Questo capitolo comincerà da alcuni esempi di variabili comunemente usate (data, ora, e numeri di pagina), quindi vedrà in dettaglio le altre variabili che sono a tua disposizione. Infine, esaminerà in dettaglio come creare variabili 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 indicare la creazione di un documento (che rimarrà fissa finché il documento circola), oppure possono servire come una nota della data dell'ultima modifica (che cambierà col passare del tempo).

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

### Inserire la data

Per inserire la data nel documento, porta semplicemente il cursore nel riquadro di testo dove dovrebbe essere inserita la data, e seleziona Inserimento Variabile Data dalla barra dei menu. Ciò farà apparire varie opzioni selezionabili. Per inserire la data attuale, scegli fra Data attuale (fissa) e Data attuale (variabile).

Data attuale (fissa)

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

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

Data attuale (variabile)

- Selezionando quest'opzione si inserirà la data corrente nella posizione attuale del cursore. Questa data è stabilita dall'orologio di sistema del computer. Questo valore cambierà quando si chiederà 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 attuale (fissa)

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

La casella combinata in alto determina lo schema della variabile. Le scelte possibili sono:

Formato locale data

- Questo inserisce la data nel formato specificato nel Centro di controllo di &kde;.

  Per selezionare questa opzione, basta accertarsi che la casella combinata riporti Formato locale data. Un'anteprima del formato del formato della data apparirà sopra il pulsante OK. Se ti va bene, fai clic su OK.

Forme di data preformattate

- &kword; possiede 19 stringhe di data predefiniti. Queste stringhe predefinite sono tutto quello che serve nella maggior parte dei casi. Basta che selezi la stringa predefinita nella casella combinata in alto. Un'anteprima del formato della data apparirà sopra il pulsante OK. Se ti va bene, fai clic su OK.

Stringa personalizzata

- Se non si trova un formato appropriato per la data, è possibile creare una stringa personalizzata per la data.

  Una stringa per il formato della data consiste di una serie di lettere e numeri che seguono delle regole specifiche, delineate di seguito, per creare la data completa.

  La stringa del formato di data consiste di segnaposti e separatori. I segnaposti sono definiti nelle seguenti tre tabelle.

  Giorni

  Segnaposti dei giorni | d | dd | ddd | dddd
  Esempio | 6 | 06 | gio | giovedì

  Mesi

  Segnaposti per i mesi | M | MM | MMM | MMMM
  Esempio | 3 | 03 | mar | marzo

  Anno

  Segnaposti per gli anni | yy | yyyy
  Esempio | 02 | 2002

  Per creare sequenze di data complete basta combinare i segnaposti con del testo normale (separatori).

  Per esempio:

  dd/MM/yyyy viene tradotto in 06/01/2004

  e

  d MMMM yyyy diventa 6 gennaio 2004

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

  È importante ricordare che i segnaposti fanno differenza tra le maiuscole e le minuscole. DD non è un segnaposto, solamente dd.

  Per creare una stringa di data personalizzata, segna la casella Personalizzato.

  Adesso digita i segnaposti e i separatori nella casella combinata. In alternativa, seleziona il formato dalla casella a discesa Inserisci:, e il segnaposto sarà inserito nella stringa della data nella posizione voluta.

C'è una casella numerica denominata Correggi in giorni. Puoi usare questa casella per regolare la data in avanti o indietro di uno o più giorni dalla data attuale.

Sotto la casella Personalizzata è visibile un'anteprima della stringa della data attuale. Fai clic su OK quando la stringa della data è giusta per inserire la variabile nel documento.

Una volta che la data è stata inserita nel documento, può essere modificata per cambiarne il formato, ed è possibile passare da una data fissa a una variabile. Basta fare clic una volta con il &RMB; sulla data. Apparirà un menu, da cui dovrai selezionare Modifica variabile per far comparire un sottomenu. Seleziona la nuova variabile o il nuovo formato dal menu, e la variabile sarà aggiornata subito.

Ci sono altre tre date che puoi inserire nel documento:

Data dell'ultima stampa

- Se selezioni questa opzione verrà inserita alla posizione attuale del cursore la data in cui il documento è stato stampato più di recente.

Data di creazione del file

- Se selezioni questa opzione verrà inserita alla posizione attuale del cursore la data in cui il documento è stato creato.

Data di modifica del file

- Se selezioni questa opzione verrà inserita alla posizione attuale del cursore la data più recente in cui il documento è stato modificato.

### Inserire l'ora

Per inserire l'ora nel documento, basta posizionare il cursore nel riquadro di testo dove inserire l'ora, e selezionare Inserimento Variabile Ora dalla barra dei menu. Questo farà apparire due scelte: Ora attuale (fissa) e Ora attuale (variabile).

Ora attuale (fissa)

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

  Questo elemento è l'ideale per le ore di creazione. Confronta questa scelta con Ora attuale (variabile).

Ora attuale (variabile)

- Selezionando questa opzione si inserirà l'ora attuale nella posizione corrente del cursore. Quest'ora è determinata dall'orologio 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 punto del documento dove si vuole avere l'ora attuale. Confronta questa scelta con Ora attuale (fissa)

Questo fa apparire una finestra.

La casella combinata in alto determina lo schema della variabile. Le scelte sono:

Formato locale

- Questo inserisce l'ora nel formato specificato nel centro di controllo di &kde;.

  Per selezionare questa opzione, accertati che la casella combinata in alto riporti Formato locale. Un'anteprima del formato dell'ora apparirà sopra il pulsante OK. Se sei soddisfatto, fai clic su OK.

Stringhe dell'ora preimpostate

- &kword; ha 6 stringhe predefinite per l'ora. Queste stringhe predefinite sono quelle che si usano nella maggior parte dei casi. Basta selezionare la stringa predefinita nella casella a discesa. Un'anteprima del formato dell'ora apparirà sotto la casella Personalizzato. Se sei soddisfatto, fai clic su OK.

Stringa personalizzata

- Se non c'è un formato appropriato, si può creare una stringa per il formato dell'ora.

  Una stringa per il formato dell'ora consiste in un elenco di lettere e numeri che seguono alcune regole specifiche, delineate di seguito, per creare l'ora completa.

  La stringa del formato dell'ora consiste in segnaposti e separatori. I segnaposti sono definiti nelle cinque tabelle seguenti.

  Ore

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

  Minuti

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

  Secondi

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

  Millisecondi

  Segnaposti per i millisecondi | zzz
  Esempio | 022

  Secondi

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

  Basta che combini i segnaposti con il testo normale (separatori) per creare stringhe dell'ora complete.

  Per esempio:

  hh:mm:ss diventa 06:23:13

  e

  h:mm ap diventa 6:23 am

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

  È importante ricordare che i segnaposti fanno distinzione tra maiuscole e minuscole. HH non è un segnaposto, solo hh lo è.

  Per creare una stringa dell'ora personalizzata, segna la casella Personalizzato.

  Digita i segnaposti e i separatori nella casella combinata in alto. In alternativa, puoi selezionare il formato dalla casella Inserisci:, e il segnaposto sarà inserito nella stringa dell'ora nell'attuale posizione del cursore.

  Sotto la casella Personalizzato è visibile un'anteprima del formato dell'ora corrente. Fai clic su OK quando la stringa di formato dell'ora è adatta per l'inserimento della variabile nel documento.

Sotto la casella Personalizzato è visibile un'anteprima del formato dell'ora corrente. Fai clic su OK quando la stringa di formato dell'ora è adatta per l'inserimento della variabile nel documento.

Un riferimento orario già inserito in un documento si può modificare per cambiarne l'aspetto e si può scegliere se deve rimanere fisso o riflettere l'ora corrente. Basta fare clic una volta con il &RMB; sulla variabile oraria nel documento. Apparirà un piccolo menu. Seleziona Modifica variabile e apparirà un sottomenu. Seleziona la tua nuova variabile o il nuovo aspetto dal menu e la variabile verrà immediatamente aggiornata.

## Numerazione delle pagine

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

Ci sono cinque variabili correlate ai numeri di pagina: Numero della pagina, Numero di pagine, Titolo sezione, Pagina precedente, Pagina successiva.

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

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

Per inserire il titolo della sezione, porta il cursore dove vuoi che sia inserita la variabile e seleziona Inserimento Variabile Pagina Titolo sezionedalla barra dei menu.

Selezionando Inserimento Variabile Pagina Pagina successiva dalla barra dei menu, verrà inserito un riferimento al numero della pagina successiva rispetto a quella attuale nella posizione attuale del cursore.

Allo stesso modo, selezionando Inserimento Variabile Pagina Pagina precedente dalla barra dei menu, verrà inserito un riferimento al numero della pagina precedente rispetto a quella attuale nella posizione attuale del cursore.

I numeri di pagina sono aggiornati dinamicamente durante la modifica del documento.

Il posto migliore per i numeri di pagina sono le intestazioni e i piè di pagina. Ciò garantisce che ogni pagina avrà un numero di pagina al posto giusto.

## Titolo della sezione

Puoi inserire il titolo della sezione in qualsiasi parte del documento selezionando Inserimento Variabile Pagina Titolo sezione dalla barra dei menu.

&kword; determina il titolo della sezione iniziando una ricerca dall'inizio della pagina attuale. Il primo paragrafo con uno stile Titolo 1 è il titolo della sezione. Se non ci sono paragrafi nella pagina attuale, &kword; eseguirà la stessa ricerca nelle pagine precedenti fino a che non troverà un titolo di sezione.

## Altre variabili

&kword; fornisce altre variabili usate comunemente che potresti trovare utili. Questo insieme di variabili è specifico per il documento. Puoi inserire queste variabili selezionando Inserimento Variabile Informazioni sul documento dalla barra dei menu. Questo farà apparire un elenco di variabili. Le variabili sono di seguito descritte in dettaglio.

Variabile | Esempio | Dettagli
Nome dell'autore | Paolo Rossi | Il nome dell'autore è specificato nella finestra Informazioni sul documento.
Città | Firenze | La città specificata nella finestra Informazioni sul documento.
Società | &kde; | Il nome della società specificato nella finestra Informazioni sul documento.
Stato | Italia | Il nome dello Stato specificato nella finestra Informazioni sul documento.
Nome della cartella | /home/prossi/kword | Questo è il nome della cartella del documento. Il nome del file non è incluso nella variabile del nome della cartella.
Nome cartella e file | /home/prossi/kword/Curriculum.kwd | La cartella e il nome del file del documento attuale.
Riassunto del documento | Questo è il mio curriculum vitæ. | Il riassunto del documento specificato nella finestra Informazioni sul documento.
Parole chiave del documento | Curriculum, lavoro, richiesta | Le parole chiave del documento specificato nella finestra Informazioni sul documento.
Oggetto del documento | Il mio curriculum. | L'oggetto del documento specificato nella finestra Informazioni sul documento.
Titolo del documento | Il mio curriculum vitæ | 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 | Curriculum.kwd | Il nome completo del file.
Nome del file senza estensione | Curriculum | Il nome del file senza suffisso (normalmente .kwd).
Iniziali | MR | Le iniziali specificate nella sezione dell'autore della finestra Informazioni sul documento.
CAP | Un qualsiasi codice d'avviamento 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 (lavoro) | Un qualsiasi numero di telefono valido | Il numero di telefono specificato nella finestra Informazioni sul documento.
Telefono (privato) | Un qualsiasi numero di telefono valido | Il numero di telefono specificato nella finestra Informazioni sul documento.
Titolo | Responsabile dei sistemi informatici | Il titolo specificato nella sezione dell'autore della finestra Informazioni sul documento.

Inoltre, ci sono parecchie variabili nel sottomenu Statistiche per inserire il numero di parole, righe, riquadri, eccetera. Il significato di queste variabili dovrebbe essere chiaro.

Le variabili non inizializzate appariranno come <nessuno> fino a che non definirai il loro valore nella finestra Informazioni sul documento.

## Variabili personalizzate

&kword; ha molte variabili preimpostate. Puoi trovare dei documenti dove sarebbe opportuno definire altre variabili.

Usando le 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 dove vuoi inserire la nuova variabile.

Seleziona Inserimento Variabile Personalizzato Nuova dalla barra dei menu. Ciò farà apparire una finestra.

Inserisci il nome della variabile e il suo attuale corrente nelle caselle di testo fornite.

Fai clic su OK per creare il nuovo nome di variabile e inserirlo alla posizione attuale del cursore. Fai clic su Annulla per annullare la creazione della nuova variabile.

Adesso è possibile inserire questa nuova variabile in qualsiasi posto del tuo documento.

### Modificare il valore di una variabile personalizzata

Perché una variabile sia utile, hai bisogno di assegnarle un valore, e 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, basta che fai clic nella casella di testo alla destra del nome della variabile. Inserisci il valore desiderato.

Quando tutte le modifiche sono state apportate, basta che fai clic su OK e tutte le variabili saranno aggiornate.

### Inserire una variabile personalizzata

Per inserire una nuova variabile personalizzata, seleziona Inserimento Variabile Personalizzato dalla barra dei menu. La variabile personalizzata è elencata nel sottomenu. Fai clic sul nome della variabile e &kword; la inserirà, con il suo valore attuale, 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 attuali). Questo è particolarmente importante con le date e le ore.

Basta che selezioni Inserimento Variabile Aggiorna tutte le variabili dalla barra dei menu.

## Aggiornare il valore di una data o di un'ora

Puoi dire a &kword; di aggiornare una sola data o una sola ora, e lasciare le altre come sono.

Porta semplicemente il puntatore del mouse sopra la variabile che vuoi aggiornare, e fai clic con il &RMB;. Seleziona Modifica variabile. Apparirà un piccolo sottomenu che ti mostrerà varie nuove opzioni di formattazione per la data e l'ora e l'opzione per cambiare una variabile di data o d'ora al formato fisso o a quello variabile. Basta selezionare la nuova opzione e questa variabile sarà aggiornata.