# Variables de document

Una variable és una manera simple de permetre que &kword; modifiqui el document en maneres molt específiques per a reflectir la naturalesa dels canvis del document o informe.

Una variable pot ser un número (com un número de pàgina, el nombre total de pàgines en un document, &etc;), una selecció de paraules (noms de client, nom de producte, el nom de fitxer del document, &etc;), una data, una hora, o gairebé qualsevol cosa que desitgeu.

Una vegada la variable estigui definida. s'insereix un marcador de posició en el document. &kword; substituirà aquest marcador de posició amb el valor d'aquesta variable cada vegada que s'usi el marcador.

Les variables poden ser fixes (el qual vol dir que una vegada inserides, el seu valor no canvia) o variables (&kword; actualitza el marcador de posició per a reflectir el valor actual de la variable).

Aquest capítol començarà amb uns quants exemples de variables comunament usades (data, hora i números de pàgina), després detallarà les restants variables disponibles. Finalment, detallarà com crear variables a mida per a documents.

## Data i hora

Moltes cartes, informes i documents contenen informació sobre les dates o hores a les que corresponen. La informació de data i hora es pot establir durant la creació d'un document (la qual romandrà fixa al llarg de la vida del document) o la data i hora poden servir per avisar de l'última modificació (el que hauria de canviar a cada dia que passi).

&kword; us permet tant variables de data com d'hora fixes i variables en el document.

### Inserir la data

Per a inserir la data en el document, simplement situeu el cursor en la caixa de text a on s'ha d'inserir la data i seleccioneu Insereix Variable Data des de la barra de menú. Us mostrarà diverses seleccions. Per a inserir la data actual, seleccioneu una d'aquestes dues opcions: Data actual (fixa) i Hora actual (variable).

Data actual (fixa)

- Seleccionant aquesta opció s'inserirà la data actual a la posició actual del cursor. Aquesta data es determina comprovant el rellotge del sistema. Una vegada introduït, aquest valor no canviarà, fins i tot si &kword; demana actualitzar les variables del document.

  Aquest ítem és ideal per a dates de creació del document, o quan s'incloguin dades en un informe relatiu a la feina d'avui. Compareu aquesta opció amb Data actual (variable).

Data actual (variable)

- Seleccionant aquesta opció s'inserirà la data actual a la posició actual del cursor. Aquesta data es determina comprovant amb el rellotge del sistema. Aquest valor canviarà quan &kword; us demani actualitzar les variables del document.

  Aquesta opció és bona per a qualsevol punt en el document en el que es vulgui sempre la data actual. Compareu aquesta opció a Data actual (fixa)

Una vegada la data ha estat seleccionada, apareixerà una caixa de diàleg.

La llista desplegable de a sobre determina la distribució de la variable. Les vostres opcions són:

Format de data local

- Això insereix la data en el format especificat en el Centre de control de &kde;.

  Per a seleccionar aquesta opció, simplement assegureu-vos de que la llista desplegable de a sota diu Format de data local. Apareixerà una vista prèvia del format de data a sobre del botó Bé. Si us satisfà, feu clic a Bé.

Cadenes de data preformatades

- &kword; ve amb 19 cadenes de text predefinides. Aquestes cadenes predefinides seran les que us calguin en la majoria de circumstàncies. Simplement seleccioneu la cadena per omissió en la llista desplegable superior. Apareixerà una vista preliminar del format de data per sobre del botó Bé. Si us satisfà, feu clic a Bé.

Cadena a mida

- Si no es pot trobar el format de data adequat, és possible crear cadenes de format de data a mida.

  Una cadena de format de data consisteix d'una llista de lletres i números que segueixen unes regles específiques (les quals es subratllen a sota) per a crear la data sencera.

  La cadena de format de data consta de marcadors de posició i separadors. Els marcadors de posició s'estableixen en les següents tres taules.

  Dies

  Marcadors de posició del dia | d | dd | ddd | dddd
  Exemple | 6 | 06 | Dij | Dijous

  Mesos

  Marcadors de posició del mes | M | MM | MMM | MMMM
  Exemple | 3 | 03 | Mar | Març

  Any

  Marcadors de posició de l'any | yy | yyyy
  Exemple | 02 | 2002

  Simplement combineu els marcadors de posició amb el text normal (separadors) per a crear cadenes de data completes.

  Per exemple:

  dd/MM/yyyy es tradueix com a 06/01/2004

  i

  d MMMM, yyyy es converteix en 6 gener, 2004

  Tingueu present que tan sols es canvien els marcadors de posició. Els espais, comes, barres i altra text romandrà sense alterar.

  És important recordar que els marcadors de posició són sensibles a majúscules, DD no és un marcador de posició, tan sols dd.

  Per a crear una cadena de data a mida, situeu una marca en la caixa de selecció A mida.

  Ara escriviu els marcadors de posició i els separadors de text en la llista desplegable de a sobre. O, si així ho preferiu, seleccioneu el format des de la llista desplegable Insereix: i s'inserirà el marcador de posició en la cadena de format de la data a la localització del cursor.

Hi ha una caixa incremental anomenada Correcció en dies. Podeu usar-la per ajustar la data, indicant la diferència en dies cap amunt o cap avall a partir de la data actual.

Es pot veure una vista prèvia de la cadena de data actual per sobre del botó Bé. Feu clic a Bé quan la cadena amb el format de data sigui el correcte per a inserir la variable en el document.

Una vegada que la data hagi estat inserida en el document, es pot tornar a formatar a una distribució diferent i canviar entre dates fixes i variables. Simplement feu clic una vegada amb el &BDR; sobre la data. Apareixerà un petit menú. Seleccioneu Canvia variable a i apareixerà un submenú. Seleccioneu la vostra nova variable o distribució des del menú i la variable serà actualitzada immediatament.

Hi ha tres dates addicionals que podeu inserir en el document:

Data de l'última impressió

- Seleccionant aquesta opció s'inserirà la data en la que es va imprimir per última vegada a la posició actual del cursor.

Data de creació del fitxer

- Seleccionant aquesta opció s'inserirà la data de creació d'aquest document a la posició actual del cursor.

Data de modificació del fitxer

- Seleccionant aquesta opció s'inserirà la data en la que es va editar el document per última vegada a la posició actual del cursor.

### Inserir l'hora

Per a inserir l'hora en un document, simplement situeu el cursor en la caixa de text a on s'hagi d'inserir l'hora i seleccioneu Insereix Variable Hora des de la barra de menú. Això farà aparèixer dues seleccions: Hora actual (fixa) i Hora actual (variable).

Hora actual (fixa)

- Seleccionant aquesta opció s'inserirà l'hora actual en la posició actual del cursor. Aquesta hora es determina comprovant el rellotge del sistema. Una vegada introduït, aquest valor no canviarà, encara que a &kword; se us demani actualitzar les variables del document.

  Aquest ítem és ideal per als marcadors de temps. Compareu aquesta opció amb Hora actual (variable).

Hora actual (variable)

- Seleccionant aquesta opció s'inserirà l'hora actual en la posició actual del cursor. Aquesta hora es determina comprovant amb el rellotge del sistema. Aquest valor canviarà quan a &kword; se us demani actualitzar les variables del document.

  Aquesta opció és bona per a tots els punts en el vostre document a on es vulgui l'hora actual. Compareu aquesta opció amb Hora actual (fixa)

Això farà aparèixer una caixa de diàleg.

La llista desplegable de a sobre determina la disposició de la variable. Les opcions són:

Format local

- Aquesta insereix l'hora en el format especificat en el ¢recontrol;.

  Per a seleccionar aquesta opció, simplement assegureu-vos de que la llista desplegable de a sobre diu Format local. Apareixerà una vista prèvia de la cadena amb l'hora actual per sobre del botó Bé. Si us satisfà, feu clic a Bé.

Cadenes d'hora preformatades

- &kword; ve amb 6 cadenes d'hora predefinides. Aquestes cadenes predefinides cobriran les vostres necessitats en la majoria de circumstàncies. Simplement, seleccioneu la cadena per omissió des de la llista desplegable superior. Apareixerà una vista prèvia de la cadena amb l'hora actual per sobre del botó Bé. Si us satisfà, feu clic a Bé.

Cadena a mida

- Si no es pot trobar el format apropiat, podeu crear una cadena de format d'hora a mida.

  Una cadena de format consisteix d'una llista de lletres i números que segueixen regles específiques (el qual es subratlla a sota) per a crear l'hora completa.

  La cadena de format d'hora consisteix de marcadors de posició i separadors. Els marcadors de posició s'estableixen en les següents cinc taules.

  Hores

  Marcadors de posició d'hora | h | hh
  Exemple | 6 | 06

  Minuts

  Marcadors de posició de minuts | m | mm
  Exemple | 3 | 03

  Segons

  Marcadors de posició de segons | s | ss
  Exemple | 2 | 02

  Milisegons

  Marcadors de posició de milisegons | zzz
  Exemple | 022

  Segons

  Marcadors de posició de AM/PM | ap | AP
  Exemple | am | AM

  Simplement combineu els marcadors de posició amb text normal (o separadors) per a crear cadenes d'hora completes.

  Per exemple:

  hh:mm:ss es converteix en 06:23:13

  i

  h:mm ap es converteix en 6:23 am

  Tingueu present que tan sols canvien els marcadors de posició. Els espais, comes i altra text romandran sense canvis.

  És important recordar que els marcadors de posició són sensibles a majúscules. HH no és un marcador de posició, tan sols hh

  Per a crear una cadena d'hora a mida, situeu una marca en la caixa de selecció A mida.

  Escriviu els marcadors de posició i el text del separació a la llista desplegable de a sobre. Alternativament, podeu seleccionar el format des de la llista desplegable Insereix:, i s'inserirà el marcador de posició en la cadena de format d'hora a la localització del cursor.

  Hi ha visible una vista prèvia de la cadena d'hora actual sota la llista desplegable A mida. Feu clic a Bé quan la cadena de format d'hora sigui la correcta per a inserir la variable en el vostre document.

Hi ha visible una vista prèvia de la cadena d'hora actual sota la llista desplegable A mida. Feu clic a Bé quan la cadena de format d'hora sigui la correcta per a inserir la variable en el vostre document.

Una vegada que l'hora hagi estat inserida en el document, es pot tornar a formatar amb una disposició diferent i canviar l'hora fixa a hora variable i viceversa. Simplement, feu clic una vegada amb el &BDR; sobre l'hora del document. Apareixerà un petit menú. Seleccioneu Canvia variable a i apareixerà un submenú. Seleccioneu la vostra nova variable o una nova distribució des del menú i la variable serà actualitzada immediatament.

## Numeració de pàgines

Inserir números de pàgina és fàcil en &kword;.

Hi ha cinc variables relacionades amb les números de pàgina: Número de pàgina, Nombre de pàgines, Títol de secció, Pàgina següent i Pàgina anterior.

Per a inserir el número de pàgina actual, situeu el cursor a on voleu el número de pàgina i seleccioneu Insereix Variable Pàgina Número de pàgina des de la barra de menú. S'inserirà el número de pàgina a la localització actual del cursor.

Per a inserir el nombre total de pàgines, situeu el cursor a on voleu la variable i seleccioneu Insereix Variable Pàgina Nombre de pàgines des de la barra de menú. S'inserirà el nombre total de pàgines.

Per a inserir el títol de la secció, situeu el cursor a on voleu la variable i seleccioneu Insereix Variable Pàgina Títol de secció des de la barra de menú. S'inserirà el títol de la secció.

Seleccionant Insereix Variable Pàgina Pàgina següent des de la barra de menú, i s'inserirà una referència al número de pàgina després de la pàgina actual a la localització actual del cursor.

De la mateixa manera, seleccionant Insereix Variable Pàgina Pàgina anterior des de la barra de menú, i s'inserirà una referència al número de pàgina abans de la pàgina actual a la localització actual del cursor.

El nombre de pàgines és actualitzat dinàmicament quan s'edita el document.

Els nombres de pàgina es solen localitzar principalment en les capçaleres i peus. Això assegura que cada pàgina tindrà un número de pàgina en el lloc apropiat.

## Títol de secció

Podeu inserir el títol de la secció a qualsevol lloc en el vostre document seleccionant Insereix Variable Pàgina Títol de secció des de la barra de menú.

&kword; determina el títol de la secció començant a cercar des de la part superior de la pàgina actual. El primer paràgraf amb un estil de Capçalera 1 és el títol de la secció. Si no hi ha paràgrafs sobre la pàgina actual, &kword; farà la mateixa recerca per les pàgines anteriors fins que trobi un títol de secció.

## Altres variables

&kword; proveeix altres variables que s'usen amb freqüència i que poden ser-vos d'utilitat. Aquest conjunt de variables és específic del document. Les podeu inserir seleccionant Insereix Variable Informació del document des de la barra de menú. Això us mostra una llista de variables. Les variables es detallen a sota.

Variable | Exemple | Detalls
Nom de l'autor | Josep Usuari | El nom de l'autor tal i com s'especifica en la caixa Informació del document.
Ciutat | Tarragona | La ciutat especificada en la caixa Informació del document.
Empresa | &kde; | El nom de l'empresa especificada en la caixa Informació del document.
País | Espanya | El nom de país especificat en la caixa Informació del document.
Nom de directori | /home/jusuari/kword | Aquest és el nom de la carpeta per al document. El nom de fitxer no està inclòs en la variable de nom de la carpeta.
Directori i nom de fitxer | /home/jusuari/kword/Resum.kwd | La carpeta i el nom de fitxer actual.
Resum del document | Aquest és un resum del document. | El resum del document especificat en la caixa Informació del document.
Paraules clau del document | Resum, treball, aplicació | Les paraules clau del document especificades en la caixa Informació del document.
Assumpte del document | El meu resum. | L'assumpte del document especificat en la caixa Informació del document.
Títol del document | El meu resum | El títol del document especificat en la caixa Informació del document.
Correu electrònic | josepusuari@kde.org | L'adreça de correu electrònic de l'autor tal i com s'especifica en la caixa Informació del document.
Fax | Qualsevol número de telèfon vàlid | El número de fax especificat en la caixa Informació del document.
Nom de fitxer | Resum.kwd | El nom complet del fitxer.
Nom del fitxer sense extensió | Resum | El nom de fitxer sense el sufix (normalment .kwd).
Inicials | JU | Les inicials especificades en la secció autors de la caixa Informació del document.
Codi postal | Qualsevol codi postal vàlid | El codi postal especificat en la caixa Informació del document.
Carrer | c/ Principal, 123 | L'adreça del carrer especificat en la caixa Informació del document.
Telèfon (treball) | Qualsevol número de telèfon vàlid | El número de telèfon especificat en la caixa Informació del document.
Telèfon (privat) | Qualsevol número de telèfon vàlid | El número de telèfon especificat en la caixa Informació del document.
Títol | Director de sistemes d'informació | El títol especificat en la secció autors de la caixa Informació del document.

A més, hi ha nombroses variables en el submenú Estadístiques, per a inserir el nombre de paraules, línies, marcs, &etc; Aquestes variables són autoexplicatives.

Les variables no iniciades apareixeran com a <cap> fins que definiu el seu valor en la caixa Informació del document.

## Variables a mida

&kword; te moltes variables predefinides. Podeu trobar casos en els que seria bo definir les vostres pròpies variables per a un document.

Usant Variables a mida, podeu crear un nombre il·limitat de variables per a cada document.

### Crear una nova variable a mida

Per a crear una nova variable a mida, situeu el cursor a la localització en el document per a inserir la nova variable.

Seleccioneu Insereix Variable A mida Nova des de la barra de menú. Això farà aparèixer una caixa de diàleg.

Introduïu el nom de variable i el seu valor actual en les caixes de text proveïdes.

Feu clic a Bé per a crear el nou nom de variable i inserir-la a la posició actual del cursor. Feu clic a Bé per a cancel·lar la creació de la nova variable.

Ara és possible inserir aquesta nova variable a qualsevol lloc en el vostre document.

### Editar un valor de variables a mida

Per a que les variables siguin útils, necessitareu poder-lis donar un valor, i canviar aquest valor amb facilitat. Per a canviar el valor d'una variable:

Seleccioneu Eines Variables personalitzades... des de la barra de menú. Això farà aparèixer una caixa de diàleg.

Cada variable a mida te una línia en aquesta taula. La primera columna és el nom de la variable, i la segona columna és el valor.

Per a canviar el valor d'una variable, simplement feu clic en la caixa de text de la dreta del nom de la variable. Introduïu el valor desitjat.

Una vegada finalitzats tots els canvis, simplement feu clic a Bé i s'actualitzaran totes les variables.

### Inserir una variable a mida

Per a inserir una nova variable a mida, seleccioneu Insereix Variable A mida des de la barra de menú. La variable a mida serà llistada en el submenú. Feu clic sobre el nom de la variable i &kword; inserirà la variable amb el seu valor actual, a la posició del cursor.

## Actualitzar tots els valors de la variable

Podeu indicar-li a &kword; per actualitzar tots els valors de variable (per assegurar-se de que totes les variables estan establertes als seus valors actuals). Això és especialment important per a dates i hores.

Simplement seleccioneu Insereix Variable Refresca totes les variables des de la barra de menú.

## Actualitzar un valor de data o hora

Podeu indicar-li a &kword; que actualitzi un únic valor de variable de data o hora, i que deixi les d'altres sense canviar.

Simplement situeu el punter del ratolí sobre la variable que voleu actualitzar i feu clic amb el &BDR;. Seleccioneu Canvia la variable a. Apareixerà un petit menú el qual mostra algunes dates noves o opcions del format d'hora i l'opció per a canviar si els formats de data i hora han de ser fixes o variables. Simplement seleccioneu l'opció nova i s'actualitzarà aquesta variable.