# Variables de documento

Una variable es una forma sencilla de permitir a &kword; que modifique el documento de maneras muy específicas para reflejar la naturaleza de los cambios del documento o del informe.

Una variable puede ser un número (como un número de página, el número total de páginas de un documento, etc), una selección de palabras (nombres de clientes, nombre de producto, el nombre de archivo del documento, etc), una fecha, una hora, o casi cualquier cosa que desee.

Una vez que la variable esté definida. se inserta un mantenedor de posición en el documento. &kword; reemplazará este mantenedor con el valor de esa varaible cada vez que se use el mantenedor.

Las variables pueden ser fijas (lo que significa que una vez insertadas, su valor no cambia) o variables (&kword; actualiza el mantenedor de posición para reflejar el valor actual de la variable).

Este capítulo empezará con unos pocos ejemplos de variables comúnmente usadas (fecha, hora y números de página), luego detallará las restantes variables disponibles. Finalmente, detallará cómo crear variables personalizadas para documentos.

## Fecha y hora

Many letters, reports and documents contain information about the dates or times they correspond to. The date and time information may establish the creation of a document (this will not change as long as the document is around), or the date and time may serve as a notice of the last date of modification (which would change with each passing day).

&kword; le permite tanto variables de fecha como de hora fijas y variables en el documento.

### Insertar fecha

Para insertar la fecha en el documento, simplemente ponga el cursor en el cuadro de texto donde debe insertarse la fecha y seleccione Insertar Variable Fecha desde la barra de menú. Esto le mostrará varias selecciones. Para insertar la fecha actual, seleccione una de estas dos opciones: Fecha actual (fija) y Hora actual (variable).

Fecha actual (fija)

- Al seleccionar esta opción se insertará la fecha atual en la posición actual del cursor. Esta fecha se determina comprobando el reloj del sistema. Una vez introducido, este valor no cambiará, incluso si &kword; pide actualizar las variables del documento.

  Este elemento es ideal para fechas de creación del documento, o al incluir datos en un informe relativos al trabajo de hoy. Compare esta opción con Fecha actual (variable).

Fecha actual (variable)

- Al seleccionar esta opción, se insertará la fecha actual en la posición actual del cursor. Esta fecha se determina comprobando el reloj del sistema. Este valor cambiará cuando se le pida a &kword; actualizar las variables del documento.

  Esta opción es buena para cualquier punto del documento en el que se quiera siempre la fecha actual. Compare esta opción a Fecha actual (fija)

Una vez que se ha seleccionado la fecha, aparecerá un cuadro de diálogo.

La lista desplegable de arriba determina la distribución de la variable. Sus opciones son:

Formato local de fecha

- Esto inserta la fecha en el formato especificado en el Centro de control de &kde;.

  Para seleccionar esta opción, simplemente asegúrese de que la lista desplegable de abajo dice Formato de fecha local como su opción. Aparecerá una vista preliminar del formato de fecha por encima del botón Aceptar. Si le satisface, haga clic en el botón Aceptar.

Cadenas de fecha preformateadas

- &kword; viene con 19 cadenas de texto predefinidas. Estas cadenas predefinidas serán las que necesite en la mayoría de circunstancias. Simplemente seleccione las cadena predefinida en la lista desplegable superior. Aparecerá una vista preliminar del formato de fecha por encima del botón Aceptar. Si le satisface, haga clic en el botón Aceptar.

Cadena personalizada

- Si no puede encontrar el formato de fecha adecuado, es posible crear cadenas de formato de fecha personalizadas.

  Una cadena de formato de fecha consta de una lista de letras y números que siguen unas reglas específicas (que se subrayan abajo) para crear la fecha completa.

  La cadena de formato de fecha consta de mantenedores de posición y separadores. Los mantenedores de posición se definen en las siguientes tres tablas.

  Días

  Ubicadores del día | d | dd | ddd | dddd
  Ejemplo | 6 | 06 | Jue | Jueves

  Meses

  Ubicadores de meses | M | MM | MMM | MMMM
  Ejemplo | 3 | 03 | Mar | Marzo

  Año

  Ubicadores de año | yy | yyyy
  Ejemplo | 02 | 2002

  Simplemente combine los mantenedores de posición con el texto normal (separadores) para crear cadenas de fecha completas.

  Por ejemplo:

  MM/dd/yyyy is translated to 01/30/2005

  y

  MMMM d, yyyy becomes January 30, 2005

  Tenga en cuenta que sólo cambian los mantenedores de posición. Los espacios, comas, barras y otro texto permanece inalterado.

  Es importante recordar que los mantenedores de posición son sensibles a las mayúsculas, DD no es un mantenedor de posición, sólo dd.

  Para crear una cadena de fecha personalizada, ponga una marca en la casilla de verificación Personalizado.

  Ahora teclee los mantenedores de posición y los separadores de texto en la lista desplegable de arriba. O, si así lo prefiere, seleccione el formato de la lista desplegable Insertar: y se insertará el mantenedor de posición en la cadena de formato de fecha de la ubicación del cursor.

Hay una casilla de selección numérica llamada Corrección en días. Puede usar esta casilla para ajustar la fecha, indicando la diferencia en días hacia arriba o hacia abajo desde la fecha actual.

Se puede ver una vista preliminar de la cadena de fecha actual por encima del botón Aceptar. Haga clic sobre Aceptar cuando la cadena con el formato de fecha sea el correcto para insertar la variable en el documento.

Una vez que la fecha se haya insertado en el documento, se puede volver a formatear a una distribución diferente y cambiar entre fechas fijas y variables. Simplemente haga clic una vez con el &RMB; sobre la fecha. Aparecerá un pequeño menú. Seleccione Cambiar variable a... y aparecerá un submenú. Seleccione su nueva variable o nueva distribución del menú y la variable se actualiza inmediatamente.

### Insertar la hora

Para insertar la hora en un documento, simplemente ponga el cursor en el cuadro de texto donde se deba insertar la hora y seleccione Insertar Variable Hora desde la barra de menú. Esto hará surgir dos selecciones: Hora actual (fija) y Hora actual (variable).

Hora actual (fija)

- Seleccionando esta opción se insertará la hora actual en la posición actual del cursor. Esta hora se determina comprobando el reloj del sistema. Una vez entrado, este valor no cambiará, aunque a &kword; se le pida actualizar las variables del documento.

  Este elemento es ideal para los sellos temporales. Compare esta opción con Hora actual (variable).

Hora actual (variable)

- Seleccionando esta opción insertará la hora actual en la posición actual del cursor. Esta hora se determina comprobando con el reloj del sistema. Este valor cambiará cuando a &kword; se le pida actualizar las variables del documento.

  Esta opción es buena para todos los puntos de su documento donde se quiera la hora actual. Compare esta opción con Hora actual (fija)

Esto hacer surgir un cuadro de diálogo.

La lista desplegable de arriba determina la disposición de la variable. Las opciones son:

Formato local

- Esto inserta la hora en el formato especificado en el Centro de control de &kde;

  Para seleccionar esta opción, simplemente asegúrese de que la lista desplegable de arriba dice Local. Aparecerá una vista preliminar de la cadena con la hora actual por encima del botón Aceptar. Si le satisfacte, haga clic en el botón Aceptar.

Cadenas de hora preformateadas

- &kword; viene con 6 cadenas de hora predefinidas. Estas cadenas predefinidas cubrirán sus necesidades en la mayor parte de circunstancias. Simplemente, seleccione la cadena predefinida de la lista desplegable superior. Aparecerá una vista preliminar de la cadena con la hora actual por encima del botón Aceptar. Si le satisface, haga clic en Aceptar.

Cadena personalizada

- Si no puede encontrar el formato adecuado, puede crear una cadena de formato personalizada.

  Una cadena de formato consta de una lista de letras y números que siguen reglas específicas (que se apuntan debajo) para crear la hora completa.

  La cadena de formato de hora consta de mantenedores de posición y separadores. Los mantenedores de posición se definen en las siguientes cinco tablas.

  Horas

  Ubicadores de hora | h | hh
  Ejemplo | 6 | 06

  Minutos

  Ubicadores de minutos | m | mm
  Ejemplo | 3 | 03

  Segundos

  Ubicadores de segundos | s | ss
  Ejemplo | 2 | 02

  Milisegundos

  Ubicadores de milisegundos | zzz
  Ejemplo | 022

  Segundos

  Ubicadores de AM/PM | ap | AP
  Ejemplo | am | AM

  Simplemente combine los mantenedores de posición con texto normal (o separadores) para crear cadenas de hora completas.

  Por ejemplo:

  hh:mm:ss se convierte en 06:23:13

  y

  h:mm ap se convierte en 6:23 am

  Tenga en cuenta que sólo cambian los mantenedores de posición. Los espacios, comas y otro texto permanecen sin cambios.

  Es importante recordar que los mantenedores de posición son sensibles a mayúsculas. HH no es un mantenedor de posición, sólo hh

  Para crear una cadena de hora personalizada, ponga una marca en la casilla de verificaión Personalizar.

  Teclee los mantenedores de posición y el texto del separador en la lista desplegable de arriba. O, si lo prefiere, puede seleccionar el formato de la lista desplegable Inserar:, y se insertará en mantenedor de posición en la cadena de formato de hora en la ubicación del cursor.

  Puede ver preliminarmente la cadena de hora actual bajo la lista desplegable Personalizar. Haga clic sobre Aceptar cuando la cadena de formato de hora sea la correcta para insertar la variable en su documento.

Puede ver preliminarmente la cadena de hora actual bajo la lista desplegable Personalizar. Haga clic sobre Aceptar cuando la cadena de formato de hora sea la correcta para insertar la variable en su documento.

Una vez que la hora haya sido insertada en el documento, se puede volver a formatear con una distribución diferente y cambiarla de hora fija a hora variable y viceversa. Simplemente, haga clic una vez con el &RMB; sobre la hora del documento. Aparecerá un menú pequeño. Seleccione Cambiar variable a... y aparecerá un submenú. Seleccione su nueva variable o una nueva distribución desde el menú y se actualizará inmediatamente la variable.

## Numeración de páginas

Insertar números de página es fácil en &kword;.

Hay cuatro variables relacionadas con las números de página: Página actual, Página siguiente, Página anterior y Número de páginas

Para insertar el número de página actual, ponga el cursor donde quiera el número de página y seleccione Insertar Variable Página Número de página desde la barra de menú. El número de página se insertará en la ubicación actual del cursor.

Para insertar el número total de páginas, ponga el cursor donde quiera la variable y seleccione Insertar Variable Página Número de página desde la barra de menú. Se insertará el número total de páginas.

Seleccione Insertar Variable Página Página siguiente de la barra de menús, y se insertará en la posición actual del cursor una referencia al número de página después de la página actual.

Del mismo modo, seleccione Insertar Variable Página Página anterior desde la barra de menús, y se insertará en la posición actual del cursor una referencia al número de página antes de la página actual.

El número de páginas se actualiza dinámicamente cuando se edita el documento.

Los números de página se suelen colocar principalmente en los encabezados y pies. Esto asegura que cada página tendrá un número de página en el lugar adecuado.

## Título de la sección

Puede insertar el título de la sección en cualquier sitio de su documento seleccionando Insertar Variable Página Título de la sección desde la barra de menú.

&kword; determina el título de la sección comenzando a buscar desde arriba de la página actual. El primer párrafo con un estilo de Encabezado 1 es el título de la sección. Si no hay párrafos de ese estilo en la página actual, &kword; hace la misma búsqueda por las páginas anteriores hasta que encuentra un título de sección.

## Otras variables

&kword; proporciona otras variables que se usan con frecuencia y que pueden serle útiles. Este conjunto de variables son específicas del documento. Puede insertar estas variables seleccionando Insertar Variable Información del documento en la barra de menús. Esto le mostrará una lista de variables. Las variables se detallas abajo.

Variable | Ejemplo | Detalles
Nombre del autor | María Ejemplo | El nombre del autor tal y como se especifica en el cuadro Información del documento.
Ciudad | Azuaga | La ciudad que ha indicado en el cuadro Información del documento.
Empresa | &kde; | El nombre de la empresa especificado en el cuadro Información del documento box.
España | Estados Unidos | El nombre de país especificado en el cuadro Información del documento.
Fecha de creación del archivo | Cualquier formato de fecha | La fecha en la que se creó este documento.
Fecha de modificación del archivo | Cualquier formato de fecha | La fecha en la que se editó este documento.
Fecha de la última impresión | Cualquier formato de fecha | La fecha en la que se imprimió por última vez este documento.
Nombre de directorio | /home/mejemplo/kword | Este es el nombre de la carpeta del documento. El nombre de archivo no está incluído en la variable de nombre de la carpeta.
Directorio y nombre del archivo | /home/mejemplo/kword/Resume.kwd | La carpeta y el nombre del archivo actual.
Resumen del documento | Este es el extracto del documento. | El resumen del documento especificado en el cuadro Información del documento.
Palabras claves del documento | Resumen, trabajo, aplicación | Las palabras claves del documento especificadas en la casilla Información del documento.
Asunto del documento | Mi resumen. | El asunto del documento especificado en la casilla Información del documento.
Título del documento | Mi extracto | El título del documento especificado en el cuadro Información del documento.
Correo electrónico | mejemplo@kde.org | La dirección de correo del autor tal y como se especificó en el cuadro Información del documento.
Fax | Cualquier número de teléfono válido | El número de fax especificado en el cuadro Información del documento.
Nombre del archivo | Resume.kwd | El nombre completo del archivo.
Nombre del archivo sin extensión | Extracto | El nombre del archivo sin el sufijo (normalmente, .kwd).
Iniciales | JCU | Las iniciales especificadas en la sección «autores» de la casilla Información del documento.
Código postal | Cualquier código postal válido | El código postal especificado en el cuadro Información del documento.
Calle | C/ Mayor, 123 | La dirección de la calle especificada en el cuadro Información del documento.
Teléfono (del trabajo) | Cualquier número de teléfono válido | El número de teléfono especificado en el cuadro Información del documento.
Teléfono (privado) | Cualquier número de teléfono válido | El número de teléfono especificado en el cuadro Información del documento.
Título | Director de sistemas de información | El título especificado en la sección «autores» del cuadro Información del documento.

Además, hay numerosas variables en el submenú Estadísticas, para insertar el número de palabras, de líneas, de marcos, etc. Estas variables son auto-explicativas.

Las variables no iniciadas aparecerán como <ninguna> hasta que defina su valor en el cuadro Información del documento.

## Variables personalizadas

&kword; tiene muchas variables predefinidas. Puede encontrar casos en los que sería bueno definir sus propias variables para un documento.

Usando Variables personalizadas puede crear un número ilimitado de variables para cada documento.

### Crea una nueva variable personalizada

Para crear una nueva variable personalizada, ponga el cursor en la ubicación del documento para insertar la nueva variable.

Seleccione Insertar Variable Personalizada Nueva desde la barra de menú. Esto hará salir un cuadro de diálogo.

Introduzca el nombre de variable y su valor actual en los cuadros de texto proporcionados.

Clic sobre Aceptar el nuevo nombre de variable e insertarla en la posición del cursor actual. Clic sobre Cancelar para cancelar la creación de la nueva variable.

Ahora es posible insertar esta nueva variable en cualquier lugar de su documento.

### Edita unos valores de variable personalizados

Para que las variables sean útiles, tiene que ser capaz de darles un valor, y ser capaz de cambiar ese valor fácilmente. Para cambiar el valor de una variable:

Selecione Herramientas Variables personalizadas... desde la barra de menú. Esto hará surgir un cuadro de diálogo.

Cada variable personalizada tiene una línea en su tabla. La primera columna es el nombre de la variable, y la segunda columna es el valor.

Para cambiar el valor de una variable, simplemente haga clic en el cuadro de texto de la derecha del nombre de la variable. Introduzca el valor deseado.

Cuando haya completado todos los cambios, simplemente haga clic sobre Aceptar y se actualizarán todas las variables.

### Insertar una variable personalizada

Para insertar una nueva variable personalizada, seleccione Insertar Variable Personalizada desde la barra de menú. La variable personalizada se lista en el submenú. Clic sobre el nombre de la variable y &kword; insertará la variable con su valor actual en la posición del cursor.

## Actualizar todos los valores de la variable

Puede decirle a &kword; para actualizar todos los valores de variables (para asegurarse de que todoas las variables están fijadas a sus valores actuales). Esto es especialmente importante para fechas y horas.

Simplemente seleccione Insertar Variable Refrescar todas las variables desde la barra de menú.

## Actualizando un valor de fecha u hora

Puede decirle a &kword; que actualice un solo valor de variable de fecha u hora, y deje los otros sin cambiar.

Simplemente ponga el puntero del ratón sobre la variable que quiera actualizar y haga clic con el &RMB;. Seleccione Cambiar variable a. Aparecerá un pequeño menú que le mostrará algunas fechas nuevas u opciones del formato de hora y la opción para cambiar si los formatos de fecha y hora son fijos o variables. Simplemente seleccione la opción nueva y se actualizará esta variable.