MikeMcBrideMarcusGamamarcus.gama@gmail.comTraduçãoVariáveis do Documento variáveisintroduçãoUma 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 HoraMuitas 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 Datavariáveisinserir datainserir dataPara inserir uma data no documento, basta posicionar o cursor no ponto do texto onde a data deverá ser inserida e selecionar InserirVariávelData 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 localIsto 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é-formatadosO &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 PersonalizadoSe 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.DiasCódigos de diaddddddddddExemplo606QuiQuinta-feiraMesesCódigos de mêsMMMMMMMMMMExemplo303MarMarçoAnoCódigos de anoyyyyyyExemplo022002Basta combinar os códigos com texto normal (separadores) para criar textos de data completos. Por exemplo:dd/MM/yyyy é transformado em 01/06/2004ed de MMMM de yyyy se torna 6 de Janeiro de 2004Observe 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ãoSelecionando 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 ArquivoSelecionando 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 ArquivoSelecionando esta opção, você irá inserir a data em que este documento foi modificado da última vez, na posição atual do cursor. Inserindo Horavariáveisinserir horainserir horaPara inserir a hora no documento, basta posicionar o cursor no ponto do texto onde você deseja inserir e selecione InserirVariávelHora 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 localIsto 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é-formatadosO &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 PersonalizadoSe 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.HorasCódigos de horahhhExemplo606MinutosCódigos de minutosmmmExemplo303SegundosCódigos de segundossssExemplo202MilisegundosCódigos de milisegundoszzzExemplo022SegundosCódigos de AM/PMapAPExemploamAMBasta combinar os códigos com texto normal (separadores) para criar textos de hora completos. Por exemplo:hh:mm:ss exibe 06:23:13eh:mm ap exibe 6:23 amObserve 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 variáveisinserir número de páginainserir números de páginaInserir 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 InserirVariávelPáginaNú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 InserirVariávelPáginaNú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 InserirVariávelPáginaTítulo da Seção no menu. O título da seção será inserido na posição atual do cursor.Selecione a opção InserirVariávelPáginaPró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 InserirVariávelPáginaPá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çãoVocê pode inserir o título da seção em qualquer ponto do seu documento selecionando a opção InserirVariávelPáginaTí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 variáveisvariáveis personalizadasO &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 InserirVariávelInformações do Documento no menu. Isto exibirá uma lista de variáveis. As variáveis são detalhadas abaixo. VariávelExemploDetalhesNome do AutorUsuário JoséO nome do autor como especificado nas Informações do Documento.CidadeRio de JaneiroA cidade especificada nas Informações do Documento.Empresa&kde;O nome da empresa especificado nas Informações do Documento.PaísBrasilO nome do país especificado nas Informações do Documento.Nome da Pasta/home/usuario/kwordEste é 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.kwdA pasta e o nome do arquivo do arquivo atual.Resumo do DocumentoEste é o resumo.O resumo do documento especificado nas Informações do Documento.Palavras-Chave do DocumentoCurrículo, trabalho, requerimentoAs palavras-chave do documento especificadas nas Informações do Documento.Assunto do DocumentoMeu currículo.O assunto do documento especificado nas Informações do Documento.Título do DocumentoMeu CurrículoO título do documento especificado nas Informações do Documento.Emailjose@kde.orgO endereço de email do autor como especificado nas Informações do Documento.FaxQualquer número de telefone válidoO número do fax especificado nas Informações do Documento.Nome do ArquivoDocumento.kwdO nome completo do arquivo.Nome do Arquivo sem ExtensãoDocumentoO nome do arquivo sem o sufixo (normalmente .kwd).IniciaisJCUAs iniciais especificadas na seção autor das Informações do Documento.Código PostalQualquer código postal válidoO código postal como especificado nas Informações do Documento.RuaRua Tiradentes, 123A rua especificada nas Informações do Documento.Telefone (trabalho)Qualquer número de telefone válidoO número de telefone especificado nas Informações do Documento.Telefone (privativo)Qualquer número de telefone válidoO número de telefone especificado nas Informações do Documento.TítuloDiretor de Sistemas de InformaçãoO 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 variáveispersonalizadaO &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 personalizadavariáveiscriar variável personalizadaPara criar uma nova variável personalizada, posicione o cursor num ponto do documento para inserir a nova variável.Selecione InserirVariávelPersonalizadaNova... 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 personalizadavariáveiseditar variáveis personalizadasPara 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 FerramentasVariá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 personalizadavariáveisinserir variável personalizadaPara inserir uma nova variável personalizada, selecione a opção InserirVariávelPersonalizada 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 variáveisatualizarVocê 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 InserirVariávelAtualizar 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.