# Variáveis do Documento

Uma variável é um modo simples de permitir ao &kword; modificar o documento de modo muito específico para refletir a mudança natural do documento ou relatório.

Uma variável pode ser um número (como um número de página, o número total de páginas no documento, etc), um seleção de palavras (nome de clientes, nome de produtos, o nome de arquivo do documento, etc), uma data, uma hora, ou praticamente tudo que você desejar.

Uma vez que a variável é definida, um elemento de substituição é inserido no documento. O &kword; substituirá este elemento com o valor de cada variável cada vez que ele é usado.

Variáveis podem ser fixas (o que significa que uma vez inserida, seu valor não muda), ou variáveis (onde o elemento de substituição é atualizado pelo &kword; para refletir o valor atual da variável).

Este capítulo começará com alguns exemplos de variáveis usadas com mais freqüência (data, hora e os números de páginas), detalhando depois as demains variáveis disponíveis. 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 se referem. A informação da data e hora pode estabelecer a criação de um documento (que permanecerá fixa enquanto o documento circular) ou servir de aviso da última data de modificação (o que iria mudar a cada dia que passe).

O &kword; permite datas e horas tanto fixas como variáveis no documento.

### Inserindo uma Data

Para inserir uma data no documento, basta posicionar o cursor no ponto do texto onde a data deverá ser inserida e selecionar Inserir Variável Data no menu. Isto exibirá uma lista com várias opções. Para inserir a data atual, selecione uma das duas opções: Data Atual (fixa) e Data Atual (variável).

Data Atual (fixa)

- Selecionar esta opção inserirá a data atual na posição atual do cursor. Esta data é determinada com base na data e hora do sistema. Uma vez inserida, este valor não mudará, mesmo quando solicitado ao &kword; que atualize as variáveis do documento.

  Este ítem é ideal para datas de criação do documento, ou quando da inclusão de datas num relatório de trabalho diário. Compare esta opção com a Data Atual (variável).

Data Atual (variável)

- Selecionar esta opção inserirá a data atual na posição atual do cursor. Esta data é determinada com base na data e hora do sistema. Este valor mudará quando for solicitado ao &kword; que atualize as variáveis do documento.

  Esta opção é ideal para qualquer ponto no documento onde a data atual é sempre desejada. Compare esta opção com a Data Atual (fixa)

Uma vez que o tipo de data é selecionado, uma janela aparecerá.

A lista superior determina a aparência da variável. Suas opções são:

Formato de data local

- Isto insere a data no formato especificado no Centro de Controle do &kde;.

  Para selecionar esta opção, basta certificar-se de que a lista superior exiba Formato de data local. Irá aparecer uma previsão do formato da data acima do botão OK. Se estiver satisfeito, clique OK.

Textos de data pré-formatados

- O &kword; vem com 19 textos de data pré-formatados. Estes textos pré-definidos são tudo o que você precisará na maioria dos casos. Simplesmente selecione o texto pré-definido na caixa combinada. Uma previsão do formato da data aparecerá acima do botão OK. Se estiver satisfeito clique OK.

Formato Personalizado

- Se o formato de data apropriado não puder ser encontrado, é possível criar um texto de formato de data personalizado.

  Um texto de formato de data consiste de uma lista de letras e números que seguem regras específicas (que estão listadas abaixo) para criar a data completa.

  O texto de formato de data consiste de códigos e separadores. Os códigos são definidos nas três tabelas a seguir.

  Dias

  Códigos de dia | d | dd | ddd | dddd
  Exemplo | 6 | 06 | Qui | Quinta-feira

  Meses

  Códigos de mês | M | MM | MMM | MMMM
  Exemplo | 3 | 03 | Mar | Março

  Ano

  Códigos de ano | yy | yyyy
  Exemplo | 02 | 2002

  Basta combinar os códigos com texto normal (separadores) para criar textos de data completos.

  Por exemplo:

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

  e

  d de MMMM de yyyy se torna 6 de Janeiro de 2004

  Observe que somente os códigos mudam. Espaços, vírgulas, barras e qualquer outro texto permanecem inalterados.

  É importante lembrar que códigos são sensíveis à caixa. DD não é um código, somente dd.

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

  Agora digite os códigos e separadores na lista acima. Em alternativa, selecione o formato na caixa combinada Inserir:, e o código será inserido no texto de formato de data na posição do cursor.

Existe um campo incremental chamado Corrigir em Dias. Você pode usar este campo para ajustar a data acima ou abaixo em um ou mais dias a partir da data atual.

Uma previsão do texto atual da data está visível acima do botão OK. Clique OK quando o texto de formato de data estiver correto para inserir a variável no documento.

Uma vez que a data tenha sido inserida no documento, ela poderá ser formatada novamente com uma disposição diferente e poderá ser alternada entre datas fixas e variáveis. Basta clicar uma vez com o &RMB; na data. Irá aparecer um pequeno menu. Selecione a opção Mudar Variável Para, e um submenu aparecerá. Selecione a sua variável ou disposição nova no menu e a variável é imediatamente atualizada.

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

Data da Última Impressão

- Selecionando esta opção, você irá inserir a data em que este documento foi impresso da última vez na posição atual do cursor.

Data da Criação do Arquivo

- Selecionando esta opção, você irá inserir a data em que este documento foi criado, na posição atual do cursor.

Data da Modificação do Arquivo

- Selecionando esta opção, você irá inserir a data em que este documento foi modificado da última vez, na posição atual do cursor.

### Inserindo Hora

Para inserir a hora no documento, basta posicionar o cursor no ponto do texto onde você deseja inserir e selecione Inserir Variável Hora no menu. Isto exibirá duas opções: Hora Atual (fixa) e Hora Atual (variável).

Hora Atual (fixa)

- Selecionar esta opção inserirá a hora atual na posição atual do cursor. Esta hora é determinada com base na data e hora do sistema. Uma vez inserida, este valor não mudará, mesmo quando for solicitado ao &kword; que atualize as variáveis do documento.

  Esta opção é ideal para horas instantâneas. Compare esta opção com a Hora Atual (variável).

Hora Atual (variável)

- Selecionar esta opção inserirá a hora atual na posição atual do cursor. Esta hora é determinada com base na data e hora do sistema. Este valor mudará quando for solicitado ao &kword; que atualize as variáveis do documento.

  Esta opção é boa para qualquer ponto em seu documento onde a hora atual é desejada. Compare esta opção com a Hora Atual (fixa)

Isto exibirá uma janela.

A lista superior determina a aparência da variável. As opções são:

Formato local

- Isto insere a hora no formato especificado no Centro de Controle do &kde;.

  Para selecionar esta opção, basta certificar-se der que a lista exibe Formato local. Irá aparecer uma previsão do formato da hora acima do botão OK. Se estiver satisfeito, clique OK.

Textos de hora pré-formatados

- O &kword; vem com 6 textos de hora pré-definidos. Estes formatos pré-definidos serão tudo o que é necessário na maioria das circunstâncias. Basta selecionar o texto pré-definido na lista superior. Aparecerá uma previsão do formato da hora acima do botão OK. Se estiver satisfeito, clique OK.

Formato Personalizado

- Se o formato apropriado não puder ser encontrado, um texto de formato de hora personalizado pode ser criado.

  Um texto de formato consiste de uma lista de letras e números que seguem regras específicas (que serão exibidas abaixo) para criar a hora completa.

  O texto de formato de hora consiste de códigos e separadores. Os códigos são definidos nas três tabelas a seguir.

  Horas

  Códigos de hora | h | hh
  Exemplo | 6 | 06

  Minutos

  Códigos de minutos | m | mm
  Exemplo | 3 | 03

  Segundos

  Códigos de segundos | s | ss
  Exemplo | 2 | 02

  Milisegundos

  Códigos de milisegundos | zzz
  Exemplo | 022

  Segundos

  Códigos de AM/PM | ap | AP
  Exemplo | am | AM

  Basta combinar os códigos com texto normal (separadores) para criar textos de hora completos.

  Por exemplo:

  hh:mm:ss exibe 06:23:13

  e

  h:mm ap exibe 6:23 am

  Observe que somente os códigos mudam. Espaços, vírgulas e qualquer outro texto permanecem inalterados.

  É importante lembrar que os códigos são sensíveis à caixa. HH não é um código, somente hh.

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

  Digite os códigos e separadores na lista acima. Em alternativa, você pode selecionar o formato na lista Inserir:, e o código será inserido no texto de formato de hora na posição do cursor.

  Uma previsão do texto atual da hora está visível abaixo da caixa de opção Personalizado. Clique OK quando o texto de formato de hora estiver correto para inserir a variável no documento.

Uma previsão do texto atual da hora está visível abaixo da caixa de opção Personalizado. Clique OK quando o texto de formato de hora estiver correto para inserir a variável no documento.

Logo que a hora tenha sido inserida no documento, ela poderá ser formatada novamente com uma disposição diferente e poderá alternar entre horas fixas e variáveis. Basta clicar uma vez com o &RMB; na data. Irá aparecer um pequeno menu. Selecione a opção Mudar Variável Para, e um submenu aparecerá. Selecione a sua variável ou disposição nova no menu e a variável é imediatamente atualizada.

## Numeração de Páginas

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

Existem cinco variáveis relacionadas com os números de páginas: a Número da Página, a Número de Páginas, a Página Anterior, a Próxima Página e o Título da Seção.

Para inserir o número da página atual, posicione o cursor onde você deseja o número de página e selecione Inserir Variável Página Número da Página no menu. O número da página será inserido na posição atual do cursor.

Para inserir o número total de páginas, posicione o cursor onde você deseja a variável e selecione Inserir Variável Página Número de Páginas no menu. O número total de páginas será inserido.

Para inserir o título da seção, coloque o cursor onde deseja a variável e selecione a opção Inserir Variável Página Título da Seção no menu. O título da seção será inserido na posição atual do cursor.

Selecione a opção Inserir Variável Página Próxima Página no menu. Isto irá mostrar uma referência do número da próxima página a ser inserida na posição atual do cursor.

Do mesmo modo, selecione 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 à atual.

Números de página são atualizados dinamicamente conforme o documento é editado.

Números de página são comumente melhor localizados em cabeçalhos e rodapés. Isto faz com que cada página tenha um número de página no local apropriado.

## Título da Seção

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

O &kword; determina o título de Seção iniciando a busca a partir do início da página atual. O primeiro parágrafo com um estilo de Cabeçalho 1 é o título de seção. Se não existirem parágrafos na página atual, o &kword; faz a mesma busca nas páginas anteriores até encontrar um título de seção.

## Outras Variáveis

O &kword; fornece outras variáveis comumente usadas que podem ser úteis. Este conjunto de variáveis são específicas do documento. Você pode inserir estas variáveis selecionando Inserir Variável Informações do Documento no menu. Isto exibirá uma lista de variáveis. As variáveis são detalhadas abaixo.

Variável | Exemplo | Detalhes
Nome do Autor | Usuário José | O nome do autor como especificado nas Informações do Documento.
Cidade | Rio de Janeiro | A cidade especificada nas Informações do Documento.
Empresa | &kde; | O nome da empresa especificado nas Informações do Documento.
País | Brasil | O nome do país especificado nas Informações do Documento.
Nome da Pasta | /home/usuario/kword | Este é o nome da pasta do documento. O nome do arquivo não é incluído na variável nome da pasta.
Pasta & Nome do Arquivo | /home/usuario/kword/Resumo.kwd | A pasta e o nome do arquivo do arquivo atual.
Resumo do Documento | Este é o resumo. | O resumo do documento especificado nas Informações do Documento.
Palavras-Chave do Documento | Currículo, trabalho, requerimento | As palavras-chave do documento especificadas nas Informações do Documento.
Assunto do Documento | Meu currículo. | O assunto do documento especificado nas Informações do Documento.
Título do Documento | Meu Currículo | O título do documento especificado nas Informações do Documento.
Email | jose@kde.org | O endereço de email do autor como especificado nas Informações do Documento.
Fax | Qualquer número de telefone válido | O número do fax especificado nas Informações do Documento.
Nome do Arquivo | Documento.kwd | O nome completo do arquivo.
Nome do Arquivo sem Extensão | Documento | O nome do arquivo sem o sufixo (normalmente .kwd).
Iniciais | JCU | As iniciais especificadas na seção autor das Informações do Documento.
Código Postal | Qualquer código postal válido | O código postal como especificado nas Informações do Documento.
Rua | Rua Tiradentes, 123 | A rua especificada nas Informações do Documento.
Telefone (trabalho) | Qualquer número de telefone válido | O número de telefone especificado nas Informações do Documento.
Telefone (privativo) | Qualquer número de telefone válido | O número de telefone especificado nas Informações do Documento.
Título | Diretor de Sistemas de Informação | O título especificado na seção autor nas Informações do Documento.

Adicionalmente, existem diversas variáveis no sub-menu Estatísticas para inserção de números de palavras, linhas, quadros, etc. Estas variáveis são auto-explicativas.

Variáveis não inicializadas aparecerão como <nenhum>, até que você defina seus valores na janela de Informações do Documento.

## Variáveis Personalizadas

O &kword; possui muitas variáveis pré-definidas. No entanto, você pode encontrar documentos onde seria melhor que você definisse suas próprias variáveis.

Usando Variáveis Personalizadas, você pode criar um número ilimitado de variáveis para cada documento.

### Criando uma nova variável personalizada

Para criar uma nova variável personalizada, posicione o cursor num ponto do documento para inserir a nova variável.

Selecione Inserir Variável Personalizada Nova... no menu. Isto irá exibir uma janela.

Insira o nome da variável e seu valor atual nos campos de texto exibidos.

Clique OK para criar a nova variável e inserí-la na posição atual do cursor. Clique Cancelar para cancelar a criação da nova variável.

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

### Editando o valor de uma variável personalizada

Para que as variáveis sejam úteis, você precisa conseguir fornecer-lhes um valor, e também mudar este valor facilmente. Para mudar o valor de uma variável:

Selecione Ferramentas Variáveis Personalizadas... no menu. Isto exibirá uma janela.

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

Para mudar o valor das variáveis, basta clicar dentro da caixa de texto à direita do nome da variável. Insira o valor desejado.

Quando todas as mudanças estiverem completas, clique OK e todas as variáveis serão atualizadas.

### Inserindo uma variável personalizada

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

## Atualizando Todos os Valores das Variáveis

Você pode dizer ao &kword; para atualizar todos os valores das variáveis (certificar-se de que todas as variáveis estão configuradas para seus valores mais atuais). Isto é especialmente importante com datas e horas.

Basta selecionar Inserir Variável Atualizar Todas Variáveis no menu.

## Atualizando o Valor de uma Variável de Data ou Hora

Você pode dizer ao &kword; para atualizar uma única data ou hora, deixando as outras variáveis inalteradas.

Basta colocar o cursor do mouse sobre a variável que deseja atualizar e clicar com o &RMB;. Selecione Mudar Variável Para. Irá aparecer um pequeno menu que lhe mostrará várias opções de formatação de datas e horas e a opção para mudar as datas e horas de fixas para variáveis e vice-versa. Basta selecionar a nova opção e esta variável será atualizada.