# Variáveis do Documento

Uma variável é uma forma simples de permitir ao &kword; modificar o documento de formas muito específicas de modo a reflectir a natureza evolutiva do documento ou relatório.

Uma variável poderá ser um número (como um número de página, o número total de páginas num documento, etc.), uma selecção de palavras (o nome do cliente, do produto, do nome do ficheiro do documento, etc.), uma data, uma hora ou praticamente tudo o que desejar.

Logo que a variável esteja definida, é inserido um elemento de substituição no documento. O &kword; irá substituir este elemento pelo valor dessa variável sempre que o elemento de substituição for usado.

As variáveis podem ser fixas (o que significa que, quando forem inseridas, o seu valor não irá mudar), ou variáveis (onde a substituição é actualizada pelo &kword; para reflectir o valor actual da variável).

Este capítulo irá começar com alguns exemplos de variáveis usadas com frequência (data, hora e os números de páginas), detalhando depois as restantes variáveis para si. Finalmente, irá detalhar como criar variáveis personalizadas para os documentos.

## Data e Hora

Muitas das cartas, relatórios e documentos contêm informações sobre as datas e horas a que correspondem. A informação da data e hora pode estabelecer a criação de um documento (o qual poderá ficar fixo enquanto o documento circular) ou servir de aviso da última data de modificação (o que iria mudar com cada dia que passasse).

O &kword; permite tanto as variáveis de data e hora fixas como as variáveis no documento.

### Inserir a Data

Para inserir a data no documento, basta colocar o cursor no campo de texto em que a data será inserida e seleccione a opção Inserir Variável Data no menu. Isto irá mostrar diversas selecções. Para inserir a data actual, escolha uma de duas opções: a Data actual (fixa) e a Data actual (variável).

Data actual (fixa)

- Se seleccionar esta opção irá inserir a data actual na posição actual do cursor. Esta data é determinada ao verificar a data do sistema. Logo que seja introduzido, este valor não irá alterar mesmo quando o &kword; for indicado para actualizar as variáveis do documento.

  Este item é ideal para as datas de criação dos documentos ou para incluir dados num relatório sobre o trabalho de hoje. Compare esta opção com a Data actual (variável).

Data actual (variável)

- Se seleccionar esta opção irá inserir a data actual na posição actual do cursor. Esta data é determinada ao verificar a data do sistema. Este valor irá alterar quando o &kword; for indicado para actualizar as variáveis do documento.

  Esta opção é boa para qualquer ponto no documento em que a data actual é sempre pretendida. Compare esta escolha com a Data actual (fixa)

Logo que a data seja seleccionada, irá aparecer uma janela.

A lista do topo determina o formato da variável. As suas escolhas são:

Formato local da data

- Isto insere a data no formato indicado pelo Centro de Controlo do &kde;.

  Para seleccionar esta opção, basta garantir que a lista do topo indica Localização. Irá aparecer uma antevisão do formato da data por baixo da opção OK. Se estiver satisfeito, carregue em OK.

Textos de data pré-formatados

- O &kword; vem com 19 textos de data predefinidos. Estes formatos predefinidos serão tudo o que é necessário na maior parte das circunstâncias. Irá aparecer uma antevisão do formato da data por baixo da opção OK. Se estiver satisfeito, carregue em OK.

Texto Personalizado

- Se o formato apropriado para a data não for encontrado, é possível criar textos de formatos de data personalizados.

  Um texto de formato de datas consiste numa lista de letras e números que seguem regras específicas (que são indicadas em baixo) para criar a data completa.

  O texto do formato da data consiste em substituições e separadores. As substituições estão definidas nas três tabelas seguintes.

  Dias

  Símbolos de dia | d | dd | ddd | dddd
  Exemplo | 6 | 06 | Qui | Quinta

  Meses

  Símbolos de mês | M | MM | MMM | MMMM
  Exemplo | 3 | 03 | Mar | Março

  Ano

  Símbolos de ano | yy | yyyy
  Exemplo | 02 | 2002

  Basta combinar as substituições com o texto normal (separadores) para criar textos de datas completos.

  Por exemplo:

  MM/dd/yyyy é transformado em 01/06/2004

  e

  MMMM d, yyyy fica Janeiro 6, 2004

  Repare que só as substituições mudam. Os espaços, vírgulas, barras e outro texto ficarão inalterados.

  É importante recordar que as substituições fazem distinção entre maiúsculas e minúsculas. O DD não é uma substituição, só o dd é que sim.

  Para criar um texto de data personalizado, assinale a opção Personalizado.

  Agora escreva as substituições e o texto dos separadores na lista de cima. Em alternativa, seleccione o formato da lista Inserir: para que a substituição seja introduzida no texto do formato da data na posição do cursor.

Existe um campo incremental chamado Corrigir em Dias. Poderá usar este campo para ajustar a data para cima ou para baixo com um ou mais dias em relação à data actual.

Irá aparecer uma antevisão do formato da data por baixo da opção OK. Se estiver satisfeito, carregue em OK para inserir a variável no documento.

Logo que a data tenha sido introduzida no documento, poderá ser formatada de novo com uma disposição diferente e poder-se-á alternar entre datas fixas e variáveis. Basta carregar uma vez com o &RMB; na data. Irá aparecer um pequeno menu. Seleccione a opção Mudar a Variável Para, pelo que aparecerá um submenu. Seleccione a sua variável ou disposição nova no menu e a variável é imediatamente actualizada.

Existem três datas adicionais que poderá inserir no seu documento:

Data da Última Impressão

- Se seleccionar esta opção, irá inserir a data em que este documento foi impresso da última vez na posição actual do cursor.

Date de Criação do Ficheiro

- Se seleccionar esta opção, irá inserir a data em que este documento foi criado, na posição actual do cursor.

Data de Modificação do Ficheiro

- Se seleccionar esta opção, irá inserir a data em que este documento foi modificado da última vez, na posição actual do cursor.

### Inserir a Hora

Para inserir a hora no documento, basta colocar o cursor no campo de texto em que a data será inserida e seleccione a opção Inserir Variável Hora no menu. Isto irá mostrar duas selecções: a Hora actual (fixa) e a Hora actual (variável).

Hora actual (fixo)

- Se seleccionar esta opção irá inserir a hora actual na posição actual do cursor. Esta hora é determinada ao verificar a hora do sistema. Logo que seja introduzido, este valor não irá alterar mesmo quando o &kword; for indicado para actualizar as variáveis do documento.

  Este item é ideal para marcações horárias. Compare esta escolha com a Hora actual (variável).

Hora actual (variável)

- Se seleccionar esta opção irá inserir a hora actual na posição actual do cursor. Esta hora é determinada ao verificar a hora do sistema. Este valor irá alterar quando o &kword; for indicado para actualizar as variáveis do documento.

  Esta opção é boa para qualquer ponto no seu documento em que a hora actual seja sempre necessária. Compare esta opção com a Hora actual (fixa)

Isto faz aparecer uma janela.

A lista de topo determina o formato da variável. As escolhas são:

Formato local

- Isto insere a hora no formato indicado pelo Centro de Controlo do &kde;.

  Para seleccionar esta opção, basta garantir que a lista do topo indica Formato da localização. Irá aparecer uma antevisão do formato da hora por baixo da opção OK. Se estiver satisfeito, carregue em OK.

Texto de horas pré-formatado

- O &kword; vem com 6 textos de hora predefinidos. Estes formatos predefinidos serão tudo o que é necessário na maior parte das circunstâncias. Irá aparecer uma antevisão do formato da hora por baixo da opção OK. Se estiver satisfeito, carregue em OK.

Texto Personalizado

- Se o formato apropriado não for encontrado, pode-se criar um texto de formato personalizado.

  Um texto de formato de horas consiste numa lista de letras e números que seguem regras específicas (que são indicadas em baixo) para criar a hora completa.

  O texto do formato da hora consiste em substituições e separadores. As substituições estão definidas nas três tabelas seguintes.

  Horas

  Símbolos de hora | h | hh
  Exemplo | 6 | 06

  Minutos

  Símbolos de minuto | m | mm
  Exemplo | 3 | 03

  Segundos

  Símbolos de segundo | s | ss
  Exemplo | 2 | 02

  Milisegundos

  Símbolos de milisegundos | zzz
  Exemplo | 022

  Segundos

  Símbolos de AM/PM | ap | AP
  Exemplo | am | AM

  Basta combinar as substituições com o texto normal (separadores) para criar textos de horas completos.

  Por exemplo:

  hh:mm:ss fica 06:23:13

  e

  h:mm ap fica 6:23 am

  Repare que só as substituições mudam. Os espaços, dois-pontos e outro texto ficarão inalterados.

  É importante recordar que as substituições fazem distinção entre maiúsculas e minúsculas. O HH não é uma substituição, só o hh é que sim.

  Para criar um texto de hora personalizado, carregue na opção Personalizado.

  Escreva as substituições e o texto dos separadores na lista de cima. Em alternativa, seleccione o formato da lista Inserir: para que a substituição seja introduzida no texto do formato da hora na posição do cursor.

  Irá aparecer uma antevisão do formato da hora por baixo da opção Personalizado. Se estiver satisfeito, carregue em OK quando o texto do formato da hora para inserir a variável no documento.

Irá aparecer uma antevisão do formato da hora por baixo da opção Personalizado. Se estiver satisfeito, carregue em OK quando o texto do formato da hora para inserir a variável no documento.

Logo que a hora tenha sido introduzida no documento, poderá ser formatada de novo com uma disposição diferente e poder-se-á alternar entre horas fixas e variáveis. Basta carregar uma vez com o &RMB; na data. Irá aparecer um pequeno menu. Seleccione a opção Mudar a Variável Para, pelo que aparecerá um submenu. Seleccione a sua variável ou disposição nova no menu e a variável é imediatamente actualizada.

## Numeração de Páginas

Inserir números de página é fácil no &kword;.

Existem quatro variáveis relacionadas com os números de páginas: a Número de Página, a Número de Páginas, a Página Anterior, a Página Seguinte e o Título da Secção.

Para inserir o número da página actual, coloque o cursor onde deseja o número da página e seleccione a opção Inserir Variável Página Número da Página no menu. O número da página será introduzido na posição actual do cursor.

Para inserir o número total de páginas, coloque o cursor onde deseja a variável e seleccione a opção Inserir Variável Página Número de Páginas no menu. O número total será introduzido na posição actual do cursor.

Para inserir o título da secção, coloque o cursor onde deseja a variável e seleccione a opção Inserir Variável Página Título da Secção no menu. O título da secção será introduzido na posição actual do cursor.

Seleccione a opção Inserir Variável Página Página Seguinte no menu. Isto irá mostrar uma referência do número da página a seguir à actual na posição actual do cursor.

Do mesmo modo, seleccione a opção Inserir Variável Página Página Anterior no menu. Isto irá mostrar uma referência do número da página anterior à actual.

Os números das páginas são actualizados dinamicamente à medida que o documento é editado.

Os números das páginas são normalmente melhor localizados dentro dos cabeçalhos e rodapés. Isto garante que todas as páginas terão um número de página no local apropriado.

## Título da Secção

Você pode inserir o título da secção em qualquer ponto do seu documento se seleccionar a opção Inserir Variável Página Título da Secção no menu.

O &kword; determina o título da secção ao iniciar uma procura a partir do topo da página actual. O primeiro parágrafo com um estilo Cabeçalho 1 é o título da secção. Se não existirem outros parágrafos na página actual, o &kword; faz a mesma procura ao longo das páginas anteriores até que encontre um título de secção.

## Outras Variáveis

O &kword; oferece outras variáveis comuns que você poderá achar úteis. Este conjunto de variáveis são específicos do documento. Você poderá inserir estas variáveis se seleccionar a opção Inserir Variável Informação do Documento no menu. Isto irá mostrar uma lista de variáveis, as quais se encontram detalhadas em baixo.

Variável | Exemplo | Detalhes
Nome do Autor | Zé Utilizador | O nome do autor, tal como é indicado no campo da Informação do documento.
Cidade | Lisboa | A cidade indicada no campo da Informação do documento.
Companhia | &kde; | O nome da empresa indicado no campo da Informação do documento.
País | Estados Unidos | O nome do país indicado no campo da Informação do documento.
Nome da Pasta | /home/zutilizador/kword | Este é o nome da pasta para o documento. O nome do ficheiro não está incluído na variável do nome da pasta.
Pasta e Nome de Ficheiro | /home/zuser/kword/Documento.kwd | O nome da pasta e do ficheiro do ficheiro actual.
Informação sobre o Documento | Este é o documento actualizado. | O resumo do documento, tal como é indicado no campo da Informação do documento.
Palavras-chave do Documento | Currículo, trabalho, candidatura | As palavras-chave do documento indicadas no campo da Informação do documento.
Assunto do Documento | O meu currículo. | O assunto do documento indicado no campo da Informação do documento.
Título do Documento | O Meu Documento | O título do documento indicado no campo da Informação do documento.
E-mail | zeutilizador@kde.org | O endereço de e-mail do autor indicado no campo da Informação do documento.
Fax | Qualquer número de telefone válido | O número de fax indicado no campo da Informação do documento.
Nome do Ficheiro | Documento.kwd | O nome completo do ficheiro.
O nome do ficheiro sem extensão | Documento | O nome do ficheiro sem o sufixo (normalmente .kwd).
Iniciais | JCU | As iniciais indicadas na secção de autores na caixa de Informação do documento.
Código postal | Qualquer código postal válido | O código postal indicado no campo da Informação do documento.
Rua | Rua Almirante Barroso, 52 | O endereço indicado no campo da Informação do documento.
Telefone (trabalho) | Qualquer número de telefone válido | O número de telefone indicado no campo da Informação do documento.
Telefone (privado) | Qualquer número de telefone válido | O número de telefone indicado no campo da Informação do documento.
Título | Director de Sistemas de Informações | O título indicado na secção de autores no campo da Informação do documento.

Adicionalmente, existem numerosas variáveis no submenu Estatísticas para inserir o número de palavras, linhas, molduras, etc. Estas variáveis deverão ser auto-explicativas.

As variáveis não inicializadas irão aparecer como <nenhum>, até que defina o seu valor no campo Informação do documento.

## Variáveis Personalizadas

O &kword; tem diversas variáveis predefinidas. Você poderá encontrar alguns documentos em que seria bom definir as suas próprias variáveis para um documento.

Se usar as Variáveis Personalizadas, poderá criar um número ilimitado de variáveis para cada documento.

### Criar uma nova variável personalizada

Para criar uma nova variável personalizada, coloque o cursor na posição do documento onde a deseja inserir.

Seleccione a opção Inserir Variável Personalizada Nova no menu. Isto irá mostrar uma janela.

Indique o nome da variável e o seu valor actual nos campos de texto que aparecem.

Carregue em OK para criar o nome da variável nova e inseri-la na posição actual do cursor. Carregue em Cancelar para ignorar a criação da variável nova.

Agora é possível inserir esta variável nova em qualquer ponto do seu documento.

### Editar o valor de variável personalizada

De modo a que as variáveis sejam úteis, você precisa de ser capaz de lhes atribuir um valor, assim como alterar esse valor facilmente. Para alterar o valor de uma variável:

Seleccione a opção Ferramentas Variáveis Personalizadas... do menu. Isto irá invocar uma janela.

Cada variável personalizada tem uma linha respectiva nesta tabela. A primeira coluna é o nome da variável e a segunda é o seu valor.

Para alterar o valor de uma variável, basta carregar no campo de texto à direita do nome da variável. Indique o valor desejado.

Quando todas as alterações estiverem completas, basta carregar em OK e todas as variáveis serão actualizadas.

### Inserir uma variável personalizada

Para inserir uma nova variável personalizada, seleccione a opção Inserir Variável Personalizada no menu. A variável em questão estará listada no submenu. Carregue no nome da variável e o &kword; irá inserir a variável, em conjunto com o seu valor actual, na posição do cursor.

## Actualizar Todos os Valores das Variáveis

Você poderá indicar ao &kword; para actualizar todos os valores das variáveis (para garantir que todas elas ficam com os seus valores actuais). Isto é especialmente importante com as datas e horas.

Basta seleccionar a opção Inserir Variável Actualizar Todas as Variáveis no menu.

## Actualizar um Valor de uma Variável de Data ou Hora

Você poderá indicar ao &kword; para actualizar apenas uma única data ou hora, deixando as outras inalteradas.

Basta colocar o cursor do rato sobre a variável que deseja actualizar e carregar com o &RMB;. Irá aparecer um pequeno menu que lhe mostrará várias opções de formatação de datas e horas ou ainda para mudar as datas e horas de fixas para variáveis e vice-versa. Basta seleccionar a nova opção e esta variável será actualizada.