# Variáveis de Documento

Uma variável é um modo simples de permitir ao &kword; modificar o documento de modos muito específicos 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 produto, 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 descritor é inserido no documento. O &kword; substituirá este descritor com o valor de cada variável cada vez que o descritor é usado.

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

Este capítulo iniciará com alguns exemplos das variáveis mais comumente usadas ( data, hora, e números de página), e então detalhará as variáveis restantes disponíveis. Finalmente, ele detalhará como criar variáveis personalizadas para documentos.

## Data e Hora

Muitas cartas, relatórios e documentos contém informações sobre datas ou horas em que eles foram escritos. As informações de data e hora podem estabelecer a criação de um documento (que permanecerá fixa tanto tempo quanto ele existir), ou a data e hora pode servir como uma informação da última data de modificação (que mudará com o passar dos dias).

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

### Inserir Data

To insert the date in the document, simply place the cursor in the text box where the date should be inserted and select Insert Variable Date from the menubar. This will bring up two selections: Current date (fixed) and Current date (variable).

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 o solicitado ao &kword; que atualize as variáveis do documento.

  Este item é 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 o 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 é solicitado ao &kword; que atualize as variáveis do documento.

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

Uma vez que o tipo de data é selecionado, uma caixa de diálogo aparecerá.

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

Locale

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

  To select this option, simply make sure the upper combo box says Locale. A preview of the date format will appear below the Custom check box. If satisfied click OK.

Strings de data pré-formatados

- &kword; comes with 12 predefined date strings. These predefined strings will be all that are needed in most circumstances. Simply select the predefined string in the upper combo box. A preview of the date format will appear below the Custom check box. If satisfied click OK.

String Personalizado

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

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

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

  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 | aa | aaaa
  Exemplo | 02 | 2002

  Simplesmente combine os códigos com texto normal (separadores) para criar strings de data completos.

  Por exemplo:

  MM/dd/yyyy is translated to 03/06/2002

  e

  MMMM d, yyyy becomes March 6, 2002

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

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

  Para criar um string personalizado de data, coloque um x na caixa de checagem Personalizado.

  Agora digite os códigos e separadores na caixa combinada superior. Alternativamente selecione o formato na caixa combinada Inserir:, e o código será inserido no string de formato de data na posição do cursor.

A preview of the current date string is visible below the Custom > check box. Click OK when the date format string is correct to insert the variable into the document.

Uma vez que a data foi inserida no documento, ela pode ser reformatada para uma aparência diferente e alternada entre fixa e variável. Simplesmente clique uma vez com o &RMB; na data. Um pequeno menu aparecerá. Selecione Mudar variável para... e um sub-menu aparecerá. Selecione seu novo tipo de variável ou nova aparência no menu e a variável será atualizada imediatamente.

### Inserir Hora

Para inserir a hora no documento, simplesmente posicione o cursor na caixa de texto onde você deseja inserir e selecione Inserir Variável Hora na barra de menu. Isto trará duas seleçõ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 solicitado ao &kword; que atualize as variáveis do documento.

  Esta opção é ideal para horas instantâneas. Compare esta opção com 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 é 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 Hora atual (fixa)

Isto trará uma caixa de diálogo.

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

Locale

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

  To select this option, simply make sure the upper combo box says Locale. A preview of the time format will appear below the Custom check box. If satisfied click OK.

Strings de hora pré-formatados

- &kword; comes with 5 predefined date strings. These predefined strings will be all that are needed in most circumstances. Simply select the predefined string in the upper combo box. A preview of the time format will appear below the Custom check box. If satisfied click OK.

String Personalizado

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

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

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

  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

  Simplesmente combine os códigos com texto normal (separadores) para criar strings de hora completos.

  Por exemplo:

  hh:mm:ss retorna 06:23:13

  e

  h:mm ap retorna 6:23 am

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

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

  Para criar um string personalizado de hora, coloque uma marca na caixa de checagem Personalizado.

  Digite os códigos e separadores na caixa combinada. Alternativamente, você pode selecionar o formato na caixa combinada Inserir:, e o código será inserido no string de formato de hora na posição do cursor.

  A preview of the current time string is visible below the Custom > check box. Click OK when the time format string is correct to insert the variable into your document.

A preview of the current time string is visible below the Custom > check box. Click OK when the time format string is correct to insert the variable into your document.

Uma vez que a hora foi inserida no documento, ela pode ser reformatada para uma aparência diferente e alternada entre fixa e variável. Simplesmente clique uma vez com o &RMB; na hora. Um pequeno menu aparecerá. Selecione Mudar variável para... e um sub-menu aparecerá. Selecione seu novo tipo de variável ou nova aparência no menu e a variável será atualizada imediatamente.

## Numeração de Páginas

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

There are two variables that relate to page numbers: Current page and Number of pages

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 de Página na barra de menu. O número de 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 na barra de menu. O número total de páginas será inserido.

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 de Seção

Você pode inserir o título de seção em qualquer lugar de seu documento selecionando Inserir Variável Página Título de seção na barra de 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 Head 1 é o título de seção. Se não existem 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 você pode achar úteis. Este conjunto de variáveis são específicas do documento. Você pode inserir estas variávies selecionando Inserir Variável Infomações do Documento a partir da barra de menu. Isto trará uma lista de variáveis. As variáveis são detalhadas abaixo.

Variável | Exemplo | Detalhes
Filename | Resumo.kwd | Inserts the file name of the document.
Nome do Autor | Usuário José | O nome do autor como especificado na caixa Informações do Documento.
Cidade | Rio de Janeiro | O código postal como especificado na caixa Informações do Documento.
Company Name | &kde; | O nome da compania especificado na caixa Informações do Documento.
País | Brasil | O nome do país especificado na caixa Informações do Documento.
Folder Name | /home/juser/kword | Este é o nome da pasta para o documento. O nome do arquivo não é incluído na variável nome da pasta.
Folder and Filename | /home/juser/kword/Resumo.kwd | A pasta e o nome do arquivo do arquivo atual.
Resumo do Documento | Este é o resumo atual. | O resumo do documento especificado na caixa Informações do Documento.
Título do Documento | Meu Resumo | O título do documento especificado na caixa Informações do Documento.
Email | jose@kde.org | O endereço de email do autor como especificado na caixa Informações do Documento.
Fax | Qualquer número de telefone válido | O número do fax especificado na caixa Informações do Documento.
Filename | Resumo.kwd | O nome completo do arquivo.
Filename without extension | Resumo | Isto remove o sufixo do nome do arquivo (comumente .kwd) do nome do arquivo.
Código postal | Qualquer código postal válido | O código postal como especificado na caixa Informações do Documento.
Rua | Rua Principal 123 | A rua especificada na caixa Informações do Documento.
Telephone | Qualquer número de telefone válido | O número de telefone especificado na caixa Informações do Documento.
Título | Diretor de Sistemas de Informação | O título especificado na seção autor na caixa Informações do Documento.

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

## Variáveis Personalizadas

O &kword; possui muitas variáveis pré-definidas. Você pode encontrar documentos onde seria melhor que você definisse suas próprias variáveis para um documento.

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

### Criar 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 na barra de menu. Isto trará uma caixa de diálogo.

Insira o nome da variável e seu valor atual nas caixas de texto que surgirão.

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 lugar de seu documento.

### Editar um valor de 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... na barra de menu. Isto trará uma caixa de diálogo.

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, simplesmente clique dentro da caixa de texto à direita do nome da variável. Insira o valor desejado.

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

### Inserir uma variável personalizada

Para inserir uma nova variável personalizada selecione Inserir Variável Personalizada na barra de menu. A variável personalizada é listada no submenu. Clique no nome da variável e o &kword; inserirá a variável, com 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.

Simplesmente selecione Inserir Variável Atualizar Todas Variáveis na barra de menu.

## Atualizando Uma Data ou Valor de Variável de Hora

Você pode dizer ao &kword; para atualizar uma data simples ou valor de variável de hora, de deixar as outras sem modificação.

Simplesmente posicione o ponteiro do mouse sobre a variável que você deseja atualizar e clique com o &RMB;. Um pequeno menu aparecerá que mostrará diversas opções de novas data ou de formatação de hora e a opção de mudar as datas e horas para o formato fixo ou variável. Simplesmente selecione a nova opção e a variável será atualizada.