Manual do Kile

Jonathan Pechta Federico Zenith Holger Danielsson Thomas Braun Michel Ludwig Felix Mauch Traduo: Marcus Gama Traduo: Rubens de Souza Matos Jnior

Manual do Kile

Contedo
1 Prefcio 1.1 Requisitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 2 Pblico alvo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 9 9 10 10 10 10 10 10 11 11 11 12 12 13 13 13 13 14 17 17 18 18 19 19 19 19 19 19 20

Introduo 2.1 Fatos bsicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.1 Sobre o Kile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.2 O Kile e o componente de edio do Kate . . . . . . . . . . . . . . . . . . . . 2.1.3 2.1.4 2.2 2.3 LA TE X 2.3.1 2.3.2 2.3.3 2.3.4 2.3.5 O que LA TE X? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Como se pronuncia? Por que essa graa estranha? . . . . . . . . . . . . . . . 101 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assistente de incio rpido . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modelos predenidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Destaque de sintaxe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Auto-completamento de ambientes . . . . . . . . . . . . . . . . . . . . . . . Pular para elemento da estrutura . . . . . . . . . . . . . . . . . . . . . . . . .

Principais recursos do Kile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2.4 3

2.3.6 Busca reversa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3.7 Busca direta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A barra de ferramentas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Incio rpido 3.1 3.2 3.3 3.4 Escrevendo um documento LA TE X com o Kile para Iniciantes . . . . . . . . . . . . Ambientes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Usando o Kile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Arquivos DVI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.4.1 3.4.2 3.4.3 3.5 3.6 3.7 Visualizando um DVI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Imprimindo um DVI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Convertendo arquivos DVI . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Busca direta entre Kile e Okular . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Busca inversa entre o Kile e o Okular . . . . . . . . . . . . . . . . . . . . . . . . . . . Resolvendo erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Manual do Kile

Iniciando um novo documento 4.1 Modelos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1.1 Criar um novo modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1.2 Congurando substituies automticas . . . . . . . . . . . . . . . . . . . . 4.1.3 4.1.4 4.1.5 Cria um modelo a partir do assistente . . . . . . . . . . . . . . . . . . . . . . Criando um modelo a partir de qualquer arquivo . . . . . . . . . . . . . . . Removendo um modelo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21 21 22 22 22 22 23 24

Editando Documentos LA TE X 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 Referncia . . . Movimentos do cursor Colchetes . . . . . . . . Destaque . . . . . . . . LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24 24 25 25 25 25 26 27 28 28 29 29 30 31 31 31 33 34 34 34 34 35 35 36 36 36 38 39 40 40 44 44 48 49 50

Marcadores . . . . . . . . . . . . . . . . . Selecionar . . . . . . . . . . . . . . . . . . 5.6.1 Selecione os comandos do LA TE X Excluir . . . . . . . . . . . . . . . . . . . . Ambiente . . . . . . . . . . . . . . . . . . . Grupo TE X . . . . . . . . . . . . . . . . . .

5.10 Aspas Duplas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.11 Nova linha inteligente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.12 Tabulao inteligente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Complementao de cdigo 6.1 6.2 6.3 6.4 6.5 Complementao automtica de ambiente . . . . . . . . . . . . . . . . . . . . . . . . Comandos . . . . . . . . . Ambientes . . . . . . . . . . . . . Abreviaturas . . . . . . . . . . . . 6.4.1 Abreviaturas . . . . . . . Modos de auto-complementao LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6.6 7

6.5.1 Comandos LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.5.2 Palavras do documento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Escrever os Prprios Arquivos de Completamento . . . . . . . . . . . . . . . . . . .

Assistentes e Dilogos 7.1 7.2 7.3 7.4 7.5 7.6 7.7 Assistente de incio rpido . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Incluir imagens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Matrizes e tabelas . . . . . . . . Inserindo elementos utuantes Inserir ambientes matemticos Utilitrios de PostScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Utilitrios de PDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.7.1 Reorganizaes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.7.2 Propriedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.7.3 Permisses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Estatsticas do Documento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

7.8

Manual do Kile

Marcas Especiais em LA TE X 8.1 8.2 Usar a Biblioteca de Marcas do LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . Usar os Itens Bibliogrcos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

51 51 53 55 55 56 60 60 62 62 62 63 65 65 65 65 65 66 66 66 67 67 68 68 68 68 68 68 69 70 70 70 71 72 72 72 73

Menu congurvel pelo usurio 9.1 9.2 9.3 Congurao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assistente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Substituies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3.1 9.3.2 9.3.3 9.4 9.5 Inserir um texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inserir o contedo do arquivo . . . . . . . . . . . . . . . . . . . . . . . . . . . Executar um programa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Parmetro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Arquivos de denio do menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10 As Ferramentas de Construo 10.1 Compilar, converter e visualizar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.1.1 BibTE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.1.2 MetaPost e o Asymptote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.1.3 PDFLA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.1.4 O LA TE X para a Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.1.5 Passar Parmetros da Linha de Comando . . . . . . . . . . . . . . . . . . . . 10.2 Previso Rpida . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.1 Modo de Seleo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.2 Modo do Ambiente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.3 Modo de Sub-Documento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.4 Modo de Grupo Matemtico . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.2.5 Previso Rpida na barra inferior . . . . . . . . . . . . . . . . . . . . . . . . . 10.3 Formatos de Arquivos Grcos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.3.1 LA TE X e PDFLA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.3.2 Converso de Imagens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.3.3 Use o arquivo correto para a imagem correta . . . . . . . . . . . . . . . . . . 10.4 Imagens EPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.4.1 O LA TE X e as Imagens EPS . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10.4.2 O Formato PostScript do Kile . . . . . . . . . . . . . . . . . . . . . . . . . . 10.4.3 O Formato PostScript e as Imagens Rasterizadas . . . . . . . . . . . . . . . 10.4.4 O PDFLA TE X e as Imagens EPS . . . . . . . . . . . . . . . . . . . . . . . . . .

10.5 Documento-Mestre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.6 Tratamento de Erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10.7 O Modo de Vigiar Arquivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Manual do Kile

11 Navegar no Cdigo LA TE X 11.1 Utilizar a Vista de Estrutura . . . . . 11.1.1 Usar o Menu de Contexto . . 11.1.2 Atualizar a Vista de Estrutura 11.2 Favoritos . . . . . . . . . . . . . . . . 12 Projetos 12.1 Trabalhar com Projetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.2 Criar um Projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.3 A rea dos Arquivos e Projetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.4 Adicionar e Remover Arquivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.4.1 Arquivar o seu Projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.5 Opes do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.6 Fechar um Projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Codicao do Documento 13.1 O Pacote ucs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13.2 XeLaTeX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13.3 Suporte ao CJK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13.3.1 Resoluo de Problemas com CJK . . . . . . . . . . . . . . . . . . . . . . . . 13.3.2 Como eu insiro caracteres do CJK em Unicode? . . . . . . . . . . . . . . . . 14 Programao 14.1 Programao no Kile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.2 Executar um programa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.3 Referncia da API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.3.1 Funes Globais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.3.2 O Prottipo do Cursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.3.3 O Prottipo do Intervalo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.3.4 A API do View . . . 14.3.5 A API do Document 14.3.6 A API do Kile . . . . 14.3.6.1 Alerta . . . 14.3.6.2 Entrada . . 14.3.6.3 Assistente . 14.3.6.4 Programa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

74 74 74 76 76 77 77 77 78 78 79 79 80 81 82 82 82 83 84 85 85 86 87 88 88 89 90 93 101 101 102 103 103

14.3.6.5 Arquivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 14.4 Exemplos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 14.4.1 Exemplo 1: substituir o nome do ambiente . . . . . . . . . . . . . . . . . . . 104 14.4.2 Exemplo 2: substituir um comando de fonte do LA TE X . . . . . . . . . . . . 105 14.4.3 Exemplo 3: envolver texto selecionado . . . . . . . . . . . . . . . . . . . . . 106

Manual do Kile

15 Ajuda

108

15.1 Documentos de ajuda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 15.2 Ajuda sensvel ao contexto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 15.3 Pesquisando por palavras-chave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 15.4 Ajuda denida pelo usurio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 16 Crditos e licena 113

Resumo Kile um editor de arquivos TE X e LA TE X e um shell.

Manual do Kile

Captulo 1

Prefcio
1.1 Requisitos

Para executar o Kile, voc precisar ter os seguintes componentes instalados em seu sistema: Ambiente de Trabalho K (KDE): KDE um popular ambiente de trabalho de cdigo aberto. Qt: Qt uma GUI em C++ e a biblioteca de rede necessria para compilar o Kile. LATEX: programa de formatao de documentos de alta qualidade. Provavelmente voc quer o pacte TeX Live (ou, em sistemas mais antigos, o teTE X), se voc est em um sistema semelhante ao Unix. A maioria desses itens pode estar includa em sua distribuio Linux ; por favor, procure a documentao da sua distribuio, ou procure seu CD ou DVD de instalao, para adicionar esses pacotes ao seu computador. O Kile pode tambm j estar disponvel como um pacote pr-compilado por sua distribuio Linux . Por favor, verique o gerenciador de pacotes de sua distribuio.

1.2

Pblico alvo

Esse manual destinado a qualquer pessoa, independentemente de sua experincia com LA TE X, KDE, Kile ou Linux . No espera-se que usurios avanados leiam este manual, mas todas as sugestes sobre a documentao sero consideradas. Se voc gostaria de contribuir para esse projeto ou para a documentao, por favor consulte a pgina do Kile na web. Voc precisa de respostas sobre o Kile? Voc emperrou durante o processo de compilao? Deseja ver uma nova caracterstica implementada? A melhor maneira para fazer perguntas tcnicas ou iniciar uma discusso usar nossa lista de discusso: kile-devel@lists.sourceforge.net.

Manual do Kile

Captulo 2

Introduo
2.1
2.1.1

Fatos bsicos
Sobre o Kile

O Kile um ambiente integrado de LA TE X para o ambiente de trabalho do KDE. O Kile possibilita usar todas as funcionalidades do LA TE X numa interface grca, dando-lhe um acesso simples, imediato e personalizado a todos os programas de completamento de cdigo, compilao, ps-processamento, depurao, converso e visualizao do LA TE X; voc ir tambm obter assistentes muito teis, uma referncia ao LA TE X e o gerenciamento dos projetos.

2.1.2

O Kile e o componente de edio do Kate

O Kile baseia-se no componente de edio do Kate, isto , vrias das capacidades de edio vm do componente de edio de Kate em si. O Kile estende estas capacidades para lidar com a edio de documentos LA TE X. Para aprender mais sobre o componente de edio Kate e as suas capacidades, veja a Pgina Web do Kate .

2.1.3

O que LA TE X?

O LA TE X um sistema de processamento de texto derivado do TE X, um programa desenvolvido originalmente em 1977 por Donald Knuth para auxiliar na formatao de texto de uma maneira prossional e obter uma qualidade compatvel com o trabalho de um prossional de tipograa. O LA TE X foi criado por Leslie Lamport para dar aos autores um tipgrafo automtico, especialmente para facilitar a rdua tarefa de formatar as frmulas e expresses matemticas, que por alguma razo so rodeadas por cifres no LA TE X. Hoje em dia, os programas de processamento de texto permitem a qualquer usurio ser o tipgrafo, mas o que normalmente se precisa de um documento que parea bonito sem ter que perder horas tentando faz-lo parecer bonito. O LA TE X liberta-o desse fardo e permite que voc pense no documento ao invs da formatao. E sim, ele ir car bonito!

2.1.4

Como se pronuncia? Por que essa graa estranha?

Existe uma tradio engraada de que os pacotes relacionados com o TE X tenham a pronncia e a formatao mais estranha possvel. O TE X foi supostamente derivado do grego , o que em 10

Manual do Kile

letras latinas equivale a teq. Existem vrias explicaes para isso, mas a mais provvel porque o TE X foi originalmente concebido para relatrios tcnicos e, de fato, a sua melhor capacidade era a formatao correta e simples de frmulas matemticas, o que era ento uma tarefa bastante dispendiosa, morosa e frustrante. A pronncia supostamente a seguinte: o T como de se esperar, o E como em metro e o X como o ich do Alemo. Se no souber como soa o ch, mais ou menos como o som que um gato assanhado produz; o smbolo do IPA o //. Muitas pessoas usam uma pronncia diferente do acho (smbolo do IPA /x/), mas foi perguntado pessoalmente a alguns Gregos que conrmaram a primeira verso. Voc dever notar que vrias pessoas pronunciam de forma errada TE X como /teks/ ou /tek/. Por ltimo, no LA TE X os primeiros LA so pronunciados de forma semelhante a lei: a ideia que, ainda que o TE X em bruto seja difcil, at mesmo um homem lay (leigo) poder usar macros de LA TE X. Uma forma menos inspiradora, mas mais realista, o fato de poder derivar do apelido de Leslie Lamport, o criador do LA TE X. Agora voc j sabe!

2.2

LA TE X 101

O sistema de formatao LA TE X semelhante a outras linguagens de formatao como o XML, que usado para vrios tipos de documentos (incluindo o que voc est lendo) ou o HTML, usado para as pginas Web. A ideia geral por trs das linguagens de formatao usar palavraschave especiais chamadas marcas ou tags, que dizem a um programa (um processador de texto, um navegador Web ou o compilador do LA TE X) como apresentar o texto. O Kile oferece-lhe um conjunto razovel destas marcas no menu LaTeX. Embora ns tentaremos lhe dar uma boa ideia do que o LA TE X, este no O Livro Denitivo sobre LA TE X. Se voc quiser aprender LA TE X em profundidade, talvez voc queira pegar um livro emprestado em sua biblioteca local. Como qualquer outra linguagem de formatao, o LA TE X contm um prembulo, que dene comandos globais como o tamanho do papel, a numerao das pginas, dimenses do texto na pgina, e um corpo do documento, que contm o texto do documento. O prembulo contm pelo menos o comando \documentclass e antecede o corpo do documento, que comea com o comando \begin{document} e , previsivelmente, terminado pelo comando \end{document}.

2.3
2.3.1

Principais recursos do Kile

Assistente de incio rpido

O assistente de Incio Rpido incorporado no Kile uma funcionalidade til para comear a criar rapidamente documentos no Kile. A seleo do assistente no menu fornece vrias opes para a criao do seu documento. Voc poder tambm indicar algumas opes relacionadas com o documento logo de incio. Opes de Classe: A Classe do Documento: escolha o tipo do documento que deseja criar: article, book, letter, report, scrartcl, scrreprt, scrbook, prosper, beamer ou outra classe personalizada. Tamanho da fonte: diz ao Kile qual tamanho em pontos (pt) voc quer usar. Tamanho do papel: escolha o tamanho ou estilo das folhas. Codicao: De um modo geral, uma boa ideia usar a codicao do seu sistema. Os sistemas modernos cada vez mais usam o UTF-8 como codicao padro. Se puder, use o utf8 ou utf8x (que a ortograa correta de fato para os documentos do LA TE X). 11

Manual do Kile

Outras opes: isto te permite denir demais opes tais como impresso, rascunho, e outras. Pacotes Isto lista alguns dos pacotes adicionais mais comuns usados no LA TE X. Marque a caixa de seleo para inclu-lo. Propriedades do documento Autor: ponha seu nome aqui. Ttulo: adicione o ttulo do documento aqui. Data: especique a data.

2.3.2

Modelos predenidos

Os modelos predenidos no Kile so: Documento vazio: verdadeiras aberraes comeam do nada! Article: dene o formato de artigo, para um documento curto o bastante para no ser dividido em captulos. Report: dene o formato de relatrio, para um documento de tamanho mdio, com numerao de pgina na margem da pgina, por exemplo. Book: dene o formato de livro, uma opo completa, to poderosa que usada para escrever muitos livros-texto universitrios. Carta: dene o formato da carta. Beamer, HA-Prosper: cria belas apresentaes em PDF com uma aparncia superior e todo o poder do LA TE X. Powerdot: O Powerdot o seguimento dos pacotes seminar e HA-Prosper. No possui tantas opes como o Beamer, mas fcil de usar e cria apresentaes realmente bonitas em PDF. Scrartcl, Scrbook, Scrreprt, Scrlttr2: as classes de documento KOMA-Script, especialmente adaptadas tipograa alem. Use-as sempre que voc escrever textos em alemo. Xelatex: um modelo de Article modicado para usar com o XeLaTeX. Lembre-se de que todos estes modelos podem ser ajustados de acordo com as necessidades do usurio. Novos usurios no precisam se preocupar, essa lista s uma breve descrio de recursos, e uma descrio mais detalhada pode ser encontrada em captulo 3.

2.3.3

Destaque de sintaxe

O Kile semelhante a outros programas que lidam com o cdigo-fonte e com a edio e ir automaticamente realar os comandos, opes e itens que so usados e abusados. O Kile torna assim possvel a localizao de reas problemticas com facilidade: por exemplo, se voc ver as rea de texto principais carem verdes, provavelmente ser porque se esqueceu de fechar um ambiente math em algum lugar.

12

Manual do Kile

2.3.4

Auto-completamento de ambientes

O completamento automtico de ambientes signica que, quando voc comear um novo ambiente com o comando \begin{ambiente}, o Kile ir inserir automaticamente um \end{ambie nte}, com uma linha entre eles para o seu texto. Voc poder, obviamente, desativar esta opo se quiser na janela em Conguraes Congurar o Kile... LaTeX Ambientes.

2.3.5

Pular para elemento da estrutura

Todos os documentos normalmente so estruturados em algum tipo de hierarquia. O LA TE X permite que voc divida os documentos na seguinte hierarquia (part sendo o mais alto na hierarquia, e subparagraph sendo o mais baixo): \part \chapter \section \subsection \subsubsection \paragraph \subparagraph Ao visualizar um documento na viso de Estrutura, voc pode pular entre elementos, clicando no elemento que voc gostaria de ver.

2.3.6

Busca reversa

Ao criar seus prprios arquivos LA TE X, a busca reversa pode ser muito til. Uma vez que voc tenha criado um arquivo DVI (DeVice Independent File - Arquivo Independente de Dispositivo) ou PDF, voc pode clicar com o boto esquerdo do mouse, enquanto pressiona Shift no visualizador e o Kile pular para a linha correspondente no cdigo-fonte em LA TE X. Um DVI um tipo de arquivo que contm uma descrio de documento formatado, alm de outras informaes, incluindo fonte dos caracteres, e , junto com o PDF, a sada usual do TE X ou LA TE X. Existem muitos utilitrios para visualizar, converter e imprimir arquivos DVI em vrios sistemas e dispositivos.

2.3.7

Busca direta

Ao usar a pesquisa inversa, a seleo dos itens no arquivo DVI ou PDF est associada com o editor, por isso, quando clicar no arquivo DVI ou PDF, a janela principal salta para a seo correspondente do cdigo em LA TE X do editor. A pesquisa normal o oposto disto. Ela ir permitir que voc clique em uma seo especca de texto no cdigo em LA TE X, saltando para a posio associada na janela do visualizador.

13

Manual do Kile

2.4

A barra de ferramentas

Novo: comea um novo documento. Abrir: abre um novo documento. Fecha: fecha seu documento. Denir o documento como mestre: isto usado quando se lida com vrios arquivos. Se voc tiver um documento-mestre, poder lidar mais facilmente com outros arquivos .tex includos no seu documento. Se estiver usando os projetos, poder tambm denir um documentomestre do projeto em Projeto-> Opes do Projeto. Construo Rpida: compila o seu cdigo de LA TE X e mostra os resultados automaticamente, a menos que existam erros no documento. Modo de vigia de arquivos: este modo ir vigiar as alteraes no arquivo DVI e no ir lanar nenhuma sesso nova do Okular aps a Construo Rpida. Ver o arquivo de registro: v o arquivo .log, onde poder localizar erros. Erro anterior: recua no arquivo .log e assinala os erros no cdigo. Erro seguinte: avana no arquivo .log e assinala os erros no cdigo. Parar: interrompe a ferramenta atual. LaTeX: executa o LA TE X sobre o documento ativo. ViewDVI: executa o visualizador de DVI. DVItoPS: converte um DVI para um PostScript (PS). ViewPS: executa o visualizador de PostScript (PS). PDFLaTeX: executa o PDFLA TE X sobre o documento ativo. ViewPDF: executa o visualizador de PDF. DVItoPDF: converte um DVI para um PDF. PStoPDF: converte um PS para um PDF. ViewHTML: visualiza o HTML criado. PesquisaDVI: pula para a pgina do arquivo DVI, que corresponde linha atual no editor. PesquisaPDF: pula para a pgina do arquivo PDF, que corresponde linha atual no editor. Se voc olhar para a barra de ferramentas Editar, ir reparar em trs sub-menus. Estes menus foram desenhados para voc ser capaz de adicionar certas funcionalidades comuns ao seu documento. A primeira lista usada para dividir rapidamente o seu documento em partes, captulos, sees e assim por diante; os comandos disponveis para adicionar segmento ao seu cdigo-fonte de LA TE X so: part: nvel mais alto da diviso de um documento. chapter: inicia uma novo captulo. section: cria uma nova seo. subsection: cria uma nova subseo. subsubsection: uma seo secundria entre uma subseo e um pargrafo. paragraph: cria um novo pargrafo. 14

Manual do Kile

subparagraph: cria um novo subpargrafo. A lista chamada Outro usada para inserir itens no seu documento, como ndices, notas de rodap e referncias; os comandos disponveis so: label: um comando que produz um rtulo para um captulo, uma gura ou outro elemento. index: cria uma entrada para o ndice. footnote: cria uma nota de rodap em seu documento. ref: usado para referenciar um rtulo, que voc pode escolher de uma lista suspensa. pageref: como ref, porm referencia uma pgina ao invs de um elemento da estrutura. cite: cria uma referncia com dados de uma bibliograa.

O menu suspensoOutro

15

Manual do Kile

Selecionando o rtulo para uma referncia Ao usar o cite, ser apresentada uma lista de itens bibliogrcos, mas se estiver usando o BibTE X isto s ir funcionar se o arquivo pertencer a um projeto. Para editar arquivos do BibTE X, recomenda-se a utilizao de editores especializados. O autor tem boa experincia com o KBibTE X e o KBib. Obviamente, voc poder tambm escrever os arquivos do BibTE X mo no Kile. A ltima lista chamada pequena usada para indicar o tamanho do texto. Voc poder denir o tamanho do texto principal, das notas de rodap e assim por diante. Os comandos disponveis so: tiny: o menor de todos. scriptsize: muito pequeno. footnotesize: menor. small: pequeno. normalsize: normal. large: grande. Large: maior. LARGE: at maior. huge: ainda maior. Huge: o maior de todos.

16

Manual do Kile

Captulo 3

Incio rpido
3.1 Escrevendo um documento LA TE X com o Kile para Iniciantes

Os usurios do Kile tem duas opes ao iniciar um documento novo: podero usar o Assistente para iniciar um documento novo, selecionar o tipo de documento que gostariam de criar e as opes como o tamanho da fonte, do papel e assim por diante; caso contrrio, podero escrever o cdigo mo.
\ documentclass [12 pt ]{ article } \ begin { document } Aqui est um pedao de texto escrito em \ LaTeX . \ end { document }

Todo documento em LA TE X comea com o comando \documentclass[argumento opcion al]{class}, onde class especica o tipo de documento. Digitar o cdigo de exemplo acima da caixa de texto te fornece a seguinte sada:

Texto compilado em sada DVI Os parnteses que vm aps ao comando \documentclass contm as opes para o comando. A opo [12pt] dene o tamanho da fonte para o seu artigo; se no denir o tamanho da fonte no incio, poder fazer isso mais tarde no texto. Logo que tenha escrito o exemplo de cdigo no campo acima, voc ter que compilar o seu cdigo-fonte de LA TE X. A forma mais simples para voc compilar o LA TE X usar o menu Criar ou usando o boto Criao Rpida. Alt-2 o atalho de teclado para compilar seu cdigo-fonte. Voc tem que salvar seu cdigo-fonte antes que voc possa compilar; o Kile far isso automaticamente para voc. Se o seu documento no compilou, verique os erros no registro. Ao usar a opo Criao Rpida, o visualizador Okular dever ser lanado automaticamente; se no o zer, d uma olhada no registro. 17

Manual do Kile

3.2

Ambientes

Um ambiente um segmento de texto que gerenciado de forma diferente do resto do documento. Por exemplo, voc cria um relatrio com um tamanho de fonte 12, mas precisa alterar o tamanho da sua letra para algumas frases. Os comandos \begin{ambiente}, \huge e \end{ ambiente} permitiro alterar temporariamente o texto dentro dos comandos de controle para ter um tamanho enorme. As alteraes s so efetivas a partir do \begin{ambiente} at o \end{ambiente}. No existem limites para o nmero de alteraes que poder fazer dentro de um ambiente. Existem vrias funcionalidades que voc poder adicionar ao seu documento que podero tornlo mais legvel e amigvel. Voc poder adicionar funcionalidades como, por exemplo, tipos de fonte diferentes, negritos, itlicos, sublinhados, etc, ao seu documento e estes comandos iro terminar com um comando \end ou no m do seu ambiente. \begin{emph}: este comando coloca o texto em itlico e isto vlido at que o cdigo passe por um \end{emph} ou outro ambiente. Para colocar uma palavra em itlico, voc poder usar a sintaxe: esta a \emph{minha} frase. \textbf{Vou tornar este texto dentro dos parnteses em negrito}: comando coloca o seu texto a negrito. este

\quote: para criar uma citao dentro do seu documento; coloque a sua citao com um \begin{quote} e termine-a com um \end{quote}. \center: centraliza o texto. \verse: cria texto deslocado para poemas. \itemize: cria uma lista de itens.

3.3

Usando o Kile

Agora que j lhe foram dadas algumas informaes bsicas sobre como escrever cdigo com a linguagem de formatao LA TE X, ns iremos mostrar como criar um documento com o Kile, passo-a-passo. 1. Iniciar o Kile. 2. Selecione o Assistente Incio Rpido, depois escolha um formato e dena as suas preferncias no assistente. 3. Logo que o assistente tenha inserido algum texto, faa algumas conguraes para tornar o documento mais legvel, adicione no mnimo uma citao, algum texto em negrito, itlico e um verso para ver a diferena entre os comandos. 4. Salve seu arquivo, e d o nome intro.tex. 5. Compile seu documento usando Alt-2, ou o boto chamado LaTeX. 6. Selecione ViewDVI. 7. Verique todo o seu novo texto. 8. Agora que voc acabou de ver o seu documento, clique no boto Janela do Editor ou pressione Ctrl-E para voltar ao editor se voc estiver usando o visualizador incorporado ou feche a janela de visualizao se estiver utilizando um programa separado. Isso mesmo! Voc acabou de criar seu primeiro documento LA TE X! Uma vez que voc criou seu DVI voc ser capaz de imprimir seu documento, ou transform-lo num arquivo PostScript ou PDF, se quiser. Experimente e divirta-se! 18

Manual do Kile

3.4

Arquivos DVI

O DVI signica DeVice Independent ou Independente do Dispositivo. Estes arquivos so produzidos pelo TE X ou pelo LA TE X para serem lidos por um controlador de determinado tipo no seu computador. Existem vrios tipos de resultado para onde poder ser enviado um arquivo DVI, como uma impressora, um conversor para arquivos PostScript ou PDF ou para a tela do seu computador.

3.4.1

Visualizando um DVI

Voc j viu como visualizar um arquivo DVI na tela, ao usar o boto ViewDVI na barra de ferramentas.

3.4.2

Imprimindo um DVI

Para imprimir um DVI, voc poder usar o mesmo processo que usou para criar o seu documento anteriormente (veja em Seo 3.3). No passo 7, depois de ter clicado em Ver o DVI, selecione a opo Arquivo Imprimir no visualizador e, se j tiver a sua impressora devidamente congurada, ser capaz de imprimir o DVI.

3.4.3

Convertendo arquivos DVI

A barra de ferramentas fornece as opes para exportar um DVI para outros formatos. Logo que tenha criado um arquivo DVI a partir do seu cdigo-fonte em LA TE X, ser capaz de o exportar para um formato sua escolha com os botes da barra de ferramentas.

3.5

Busca direta entre Kile e Okular

As funes de busca direta permitem-lhe saltar do seu editor diretamente para a posio associada no arquivo DVI. ou PDF. O Kile oferece uma congurao com esta opo para todos os executveis de LA TE X. V a Conguraes Congurar o Kile... Ferramentas+Compilar e escolha sempre a congurao Moderna. Para executar uma busca direta, posicione o cursor em uma linha do cdigo-fonte, e clique em Busca direta para saltar para a posio associada na janela do visualizador DVI ou PDF.

3.6

Busca inversa entre o Kile e o Okular

A pesquisa inversa uma funcionalidade muito til quando voc mesmo est escrevendo um documento em LA TE X. Se tudo estiver congurado convenientemente, voc pode clicar na janela do Okular com o boto esquerdo do mouse, enquanto pressiona Shift. Aps isso, o Kile carrega o de cdigo LA TE X e salta para o pargrafo correspondente. Para usar a pesquisa inversa, voc ter que compilar o seu arquivo LA TE X com a congurao Moderna. A busca inversa no pode funcionar a menos que: O arquivo fonte tenha sido compilado com sucesso. O Okular conhea qual editor voc gostaria de usar. 19

Manual do Kile

Com esta funcionalidade do Okular, um clique com o boto esquerdo do mouse, enquanto pressiona Shift no documento DVI ou PDF, far com que o Kile abra o documento em LA TE X e tente ir para a linha correspondente. Lembre-se de indicar ao Okular para usar o Kile como um editor de texto no item de menu Conguraes Congurara o Okular... (na pgina Editor).

Congurando o Okular

3.7

Resolvendo erros

Se voc est tentando usar a criao rpida e o visualizador do DVI no abrir, as chances sero que voc tenha um erro. Se for o caso, ele car visvel na rea de mensagens/arquivos do registro e o resumo do erro ser indicado. O arquivo de registro ir explicar a origem do erro no seu cdigo. No editor, voc poder usar os botes da barra de ferramentas Erro de LaTeX Anterior e Erro de LaTeX Seguinte para saltar de um erro para outro. O arquivo de registro indica sempre em que linha ocorreu o erro. Para ver a linha em que ocorreu um determinado erro, clique no erro na janela de registro, para que o Kile o leve para essa linha.

20

Manual do Kile

Captulo 4

Iniciando um novo documento

Quando clicar no boto da barra de ferramentas para iniciar um documento novo, ir aparecer uma janela que lhe perguntar o tipo de modelo que gostaria de usar para escrever o seu documento. As escolhas padro so: Documento vazio Artigo Beamer Livro HA-Prosper Powerdot Carta Relatrio Scrartcl (do pacote KOMA-Script) Scrbook (do pacote KOMA-Script) Scrlttr2 (do pacote KOMA-Script) Scrreprt (do pacote KOMA-Script) PDF XeLaTeX Se voc tiver selecionado um Documento vazio, poder tanto comear a escrever um documento do zero como poder usar o assistente para iniciar rapidamente um documento novo (veja em Seo 2.3.1).

4.1

Modelos

Usurios frequentes de LA TE X tipicamente usam o mesmo prembulo para quase todos os documentos que eles usam. Modelos podem ser criados, salvos e carregados dentro do Kile para tornar mais fcil iniciar um novo documento.

21

Manual do Kile

4.1.1

Criar um novo modelo

Para criar um modelo novo, voc precisa abrir primeiro um arquivo TE X / LA TE X ou criar um arquivo por si s. O Kile poder gerar um modelo a partir de um documento existente se abrir o documento desejado e selecionar a opo Arquivo Criar modelo a partir de documento.

4.1.2

Congurando substituies automticas

Ao criar um novo documento atravs da seleo de um modelo na opo Arquivo Novo, certas combinaes de caracteres sero substitudas por alguns dados como o seu nome ou a codicao que estiver usando. Estas variveis podero ser conguradas em Conguraes Congurar o Kile... Congurao Geral. Quando estiver elaborando seu prprio modelo, til conhecer quais combinaes de caracteres so substitudos por quais variveis do modelo: $$AUTHOR$$: Esse texto ser substitudo pela varivel autor. $$DOCUMENTCLASSOPTIONS$$: Esse texto ser substitudo pela varivel de opes documentclass. Tipicamente isto usado da seguinte maneira: \documentclass[$$DOCUMENTC LASSOPTIONS$$]{article}. $$INPUTENCODING$$: Se a varivel inputencoding congurada para, digamos, latin1 esse texto ser substitudo por \input[latin1]{inputenc}.

4.1.3

Cria um modelo a partir do assistente

A maneira mais fcil de criar um novo modelo iniciar o assistente, e ento adicionar comandos no editor. Uma vez que voc tenha seu documento congurado da maneira que voc quer: 1. Salve seu arquivo; 2. V para Arquivo; 3. Escolha Criar modelo a partir do documento; 4. Faa quaisquer correes necessrias ao modelo; 5. Digite um nome para seu novo modelo; 6. Clique em OK para adicionar seu modelo ao menu. Na prxima vez que voc iniciar um novo documento, voc poder escolher seu modelo personalizado ao invs dos padres.

4.1.4

Criando um modelo a partir de qualquer arquivo

Um modelo pode ser criado a partir de qualquer arquivo LA TE X. Se voc est procurando uma maneira fcil de congurar um modelo, procure uma que voc goste na Internet e siga os mesmos passos listados em Seo 4.1.3. Por exemplo, voc poder querer criar um poster completo em A0. Estes posters so normalmente vistos nas conferncias cientcas e o LA TE X o ajudar a criar um poster bonito e interessante. Voc poder obter um modelo para os posters em A0 na pgina pessoal de Jonathan Marchini, mas existem muitas mais disponveis. Lembre-se de que ir precisar do pacote a0post er, o qual no est normalmente includo numa distribuio normal do tex. Baixe ele neste local e coloque-o na mesma pasta do seu arquivo LA TE X. 22

Manual do Kile

4.1.5

Removendo um modelo

Para remover um modelo do Kile, faa o seguinte: 1. V para Arquivo Remover modelo...; 2. Uma caixa de dilogo aparecer com todos os modelos listados: selecione um modelo; 3. Clique em OK, e seu modelo ser removido. Modelos marcados com um asterisco (*) no podem ser removidos sem a permisso adequada.

23

Manual do Kile

Captulo 5

Editando Documentos LATEX

O editor interno que o Kile usa o Kate. O Kate um editor de texto criado para programadores, que incorpora a habilidade de ler e destacar muitos tipos diferentes de arquivos de texto, entre os quais esto o LA TE X e o BibTE X; voc pode acessar muitas opes para o Kate diretamente do menu Ferramentas do Kile. Para aprender mais sobre o Kate e suas capacidades, veja o Manual do Kate. Usurios do Kile podem comear a ler do captulo Trabalhando com o Editor do Kate.

5.1

Referncia LA TE X

O Kile oferece uma referncia das marcas de LA TE X muito prtica, qual poder acessar se escolher a opo Ajuda Referncia de LaTeX. Ela contm uma descrio detalhada de quase todos os comandos que poder usar no LA TE X e a sua sintaxe.

5.2

Movimentos do cursor

Para selecionar um texto, voc tem as seguintes opes: Segure o boto esquerdo do mouse, e arraste o mouse para destacar o texto. Clique uma vez numa palavra para mover o cursor para uma nova rea. Clique duas vezes numa palavra para selecionar a palavra inteira. Clique duas vezes numa palavra e pressionando Ctrl para selecionar a palavra do tex completa. Isso signica que clicar dessa maneira em \par de \par\bigskip somente seleciona \par. Clique trs vezes para selecionar a frase inteira. Se mantiver pressionado o boto esquerdo do mouse e arrastar o texto que deseja selecionar, ir copiar automaticamente o texto selecionado para a rea de transferncia. Se pressionar o Shift e usar as teclas de cursores, voc poder selecionar partes do cdigo-fonte na janela do editor.

24

Manual do Kile

5.3

Colchetes

O completamento de parnteses uma ferramenta visual que o editor usa para lhe indicar qual o parnteses corresponde a outro. Se voc abrir qualquer arquivo .tex e selecionar qualquer parnteses, seja ele um normal (), colchete [] ou chave {}, o editor ir realar o colchete e a sua correspondncia em amarelo (esta cor padro poder ser alterada). Por isso, por exemplo, se posicionar o cursor nas chaves em \section{Introduo}, ir ver o \section{Introdu o} no realce amarelo por padro, mostrando-lhe a localizao dos parnteses inicial e nal.

5.4

Destaque

O Kile tem a habilidade de procurar e destacar diferentes tipos de cdigo. Por exemplo, comandos LA TE X so distinguidos de texto normal, e frmulas matemticas tambm so destacadas com uma cor diferente.

5.5

Marcadores

Muitos assistentes podem inserir marcadores opcionais, um tipo especial de marcadores dentro do texto. As opes do menu Editar Marcadores ou os atalhos de teclado correspondentes te permitiro pular parar o prximo ou ltimo marcador. Isso tambm destacar esse marcador, de forma que ele ser removido automaticamente, quando voc digitar sua primeira letra.

Prximo marcador (Ctrl+Alt+Direita) Pula para o prximo marcador no texto se houver algum. ltimo marcador (Ctrl+Alt+Esquerda) Pula para o ltimo marcador no texto se houver algum.

5.6

Selecionar

A edio , obviamente, um dos aspectos principais quando voc usar um programa como o Kile. Ainda que o Kate j tenha timas capacidades, o Kile adiciona algumas funcionalidades importantes, as quais so especialmente necessrias para escrever cdigo em LA TE X. O LA TE X necessita sempre de vrios ambientes e grupos, como tal o Kile suporta comandos muito especiais para os selecionar. Sob o menu Editar Selecionar, ir encontrar os seguintes comandos para selecionar texto.

25

Manual do Kile

Ambiente (dentro) (Ctrl+Alt+S,E) Selecione um ambiente sem as marcas envolventes. Se este comando for invocado, quando j estiver selecionado um ambiente, o Kile ir expandir a sua seleo para o ambiente envolvente seguinte. Ambiente (fora) (Ctrl+Alt+S,F) Seleciona um ambiente, incluindo as marcas envolventes. Esta seleo tambm poder ser expandida com uma segunda invocao deste comando. Grupo de TeX (dentro) (Ctrl+Alt+S,T) Seleciona um grupo TeX dentro das chaves abrindo e fechando. Grupo de TeX (fora) (Ctrl+Alt+S,U) Seleciona um grupo TeX incluindo as chaves abrindo e fechando. Grupo matemtico (Ctrl+Alt+S,M) Seleciona o grupo matemtico atual, incluindo os comandos matemticos. Pargrafo (Ctrl+Alt+S,P) Seleciona um pargrafo inteiro, isto , um grupo de linhas de texto separadas em ambos os lados por linhas vazias. Como tal, um pargrafo no signica apenas linhas contnuas de texto, como est habituado nos editores de texto normais. Este signicado estendido tambm inclui tabelas, comandos de LA TE X e outras linhas de cdigo. A nica coisa importante do Kile que o pargrafo separado por duas linhas vazias. Linha (Ctrl+Alt+S,L) Seleciona a linha de texto da posio atual do cursor. Palavra TeX (Ctrl+Alt+S,W) Seleciona a palavra sob a posio atual do cursor. Esta seleo tem tambm um signicado estendido, uma vez que este comando tambm permite selecionar comandos de LA TE X, que comecem por uma barra invertida e que possam tambm ter um asterisco opcional no m.

5.6.1

Selecione os comandos do LA TE X

O Kile tem uma funcionalidade estendida para selecionar comandos de LA TE X. Se, por exemplo, voc tiver escrito
text \ bfseries \ itshape mais texto

26

Manual do Kile

e zer duplo-clique sobre algum dos comandos do LA TE X, ambos sero selecionados. Mas provavelmente voc s desejar selecionar um dos dois ou mais comandos. Isso pode ser feito com a tecla Ctrl. S ter que pressionar a tecla Ctrl e fazer duplo-clique para selecionar apenas o comando desejado.

5.7

Excluir

Para remover alguma parte de um documento, voc poder selecion-la e usar ento a tecla Delete. O Kate j oferece um comando destes com a combinao Ctrl-K, de modo que no h necessidade de adicionar outro. Em Editar Remover, ir encontrar os seguintes comandos para remover texto.

Ambiente (dentro) (Ctrl+Alt+T,E) Remove um ambiente sem as tags em volta. Ambiente (fora) (Ctrl+Alt+T,F) Remove um ambiente incluindo as tags em volta. Grupo de TeX (dentro) (Ctrl+Alt+T,T) Remove um grupo de TeX, dentro dos parnteses envolventes. Grupo de TeX (fora) (Ctrl+Alt+T,U) Remove um grupo de TeX, incluindo os parnteses envolventes. Grupo Matemtico (Ctrl+Alt+T, M) Remove o grupo matemtico atual, incluindo os comandos matemticos. Pargrafo (Ctrl+Alt+T,P) Remove um pargrafo completo. Veja o comando Selecionar Pargrafo para saber como se dene um pargrafo no Kile. Para o Fim da Linha (Ctrl+Alt+T,I) Remove o texto da posio atual do cursor at ao m da linha. Palavra TeX (Ctrl+Alt+T,W) Remove a palavra ou comando de LA TE X sob a posio atual do cursor.

27

Manual do Kile

5.8

Ambiente

J foi mencionado anteriormente que os ambientes so um ponto central no LA TE X. Como tal, o Kile oferece outros cinco comandos para facilitar ao mximo o trabalho com o LA TE X, sob os submenus Editar Ambiente.

Ir para Incio (Ctrl+Alt+E,B) Este comando ir saltar para o incio do ambiente atual, seja qual for a sua posio atual. O cursor ser colocado diretamente frente da marca de abertura do ambiente. Ir para o Fim (Ctrl+Alt+E,E) Este comando ir saltar para o m do ambiente atual, seja qual for a sua posio atual. O cursor ser colocado diretamente atrs da marca de fecho do ambiente. Correspondncia (Ctrl+Alt+E,M) Quando o seu cursor estiver frente ou acima da marca \begin{ambiente}, ele ir parar no extremo oposto do ambiente, e vice-versa. Fechar (Ctrl+Alt+E,C) Se escrever um conjunto de marcas aninhadas, voc poder perder o controle de todos esses ambientes. Este comando ir fechar o ltimo ambiente aberto, de modo que a estrutura aninhada dos ambientes no se quebre. Fechar Tudo (Ctrl+Alt+E,A) Isto fecha todos os ambientes abertos, no s o ambiente aberto pela ltima vez.

5.9

Grupo TE X

O Kile tambm oferece alguns comandos especiais para os grupos de LA TE X, os quais so determinados pelas chaves {...}. No submenu Editar Grupo de TeX, ir encontrar alguns comandos importantes que correspondem aos do Editar Ambiente.

Ir para o Incio (Ctrl+Alt+G,B) Este comando pular para o incio do grupo atual, onde quer que seja sua posio atual. O cursor ser colocado diretamente na frente da chave de abertura. 28

Manual do Kile

Ir para o Fim (Ctrl+Alt+G,E) Este comando pular para o nal do grupo atual, onde quer que seja sua posio atual. O cursor ser colocado diretamente na frente da chave de fechamento. Correspondncia (Ctrl+Alt+G, M) Quando o seu cursor estiver frente ou acima da chave de abertura de um grupo do TE X, ele ir parar no extremo oposto do grupo, e vice-versa. Fechar (Ctrl+Alt+G, C) Se escrever um conjunto de chaves de grupos aninhados, voc poder perder o controle de todos esses grupos. Este comando ir fechar o ltimo grupo aberto, de modo que a estrutura aninhada dos grupos TE X no se quebre.

5.10

Aspas Duplas

No LA TE X, so usadas dois apstrofos como aspas. Para o ajudar a inseri-las de forma eciente, o Kile permite-lhe pressionar para inserir dois apstrofos de abertura. Alm disso, se voc quiser fechar as aspas, ter tambm que pressionar . O Kile ser sucientemente inteligente para reconhecer este caso e inserir dois apstrofos de fecho no LA TE X. Para obter aspas duplas literalmente, por outro lado, pressione duas vezes. Voc poder ativar ou desativar esta insero automtica das aspas de abertura e fecho em Conguraes Congurar o Kile... LaTeX.

Se voc tambm incluir opes especcas do idioma ou arquivos de estilos como o ngerman ou o french, poder tambm ser capaz de usar as aspas alems ou francesas. Esto disponveis muitas mais lnguas.

5.11

Nova linha inteligente

Se voc pressionar Ctrl-Return, o Kile ir inserir uma mudana de linha inteligente. Se a sua posio atual for dentro do ambiente de uma lista, como o enumerate ou o itemize, o Kile no 29

Manual do Kile

s ir inserir uma mudana de linha, como tambm ir adicionar um comando \item. Se voc estiver dentro do ambiente de uma tabela, o Kile ir terminar a linha atual com um \\, seguido da linha nova. Se voc estiver dentro de um comentrio de LA TE X, o Kile ir iniciar a linha seguinte com um %. Ainda melhor, o Kile inteligente o suciente para suportar o LA TE X padro e o ambiente denido pelo usurio, que poder ser adicionado na seo Conguraes Congurar o Kile... LaTeX.

5.12

Tabulao inteligente

Alguns usurios gostam de organizar as colunas nos ambientes de tabelas e colocar todos os caracteres de E-comerciais & por baixo uns dos outros. O Kile tenta suportar isto. Se pressionar em Shift-Alt-&, o Kile ir procurar a prxima tabulao na linha acima. Ainda que isto possa no corresponder tabulao certa, o Kile ir adicionar alguns espaos para ajustar a posio da coluna pgina atual.

30

Manual do Kile

Captulo 6

Complementao de cdigo
Ainda que o Kate j oferea um bom modo de completamento, o completamento de cdigo estendido do Kile suporta alguns mtodos especiais para o LA TE X. Esto integrados seis modos diferentes. Trs deles funcionam sob demanda, enquanto os outros dois so modos de completamento automtico. Todos os modos podem ser congurados para funcionar de forma bastante diferente em Conguraes Congurar o Kile....

6.1

Complementao automtica de ambiente

Quando voc comea um ambiente novo, se escrever \begin{ambiente}, o Kile ir adicionar automaticamente um \end{ambiente}, com uma linha no meio para o seu texto. O completamento automtico poder ser desativado na seo do LA TE X na opo Conguraes Congurar o Kile... LaTeX+Ambientes.

Completar um Ambiente de Equao

6.2

Comandos LA TE X

Quando voc digitar algumas letras, poder ativar este modo de completamento para os comandos de LA TE X e para as palavras normais com a opo de menu Editar Completar Comando de (La)TeX ou com o atalho de teclado Ctrl-Shift-Espao. O Kile ir ler primeiro as letras da posio atual do cursor esquerda e pra no primeiro caractere que no seja uma letra ou uma barra invertida. Se este padro comear por uma barra invertida, o Kile ir entrar no modo de completamento de comandos de TE X ou LA TE X. Caso contrrio, ir entrar no modo normal de dicionrio, onde no ir procurar quaisquer comandos do LA TE X. Dependendo do modo escolhido, ser aberta uma janela de completamento. Voc ver todos os comandos ou palavras, onde o incio corresponde ao padro atual. Poder navegar com as teclas de cursores por esta lista e selecionar um item com a tecla Enter, ou ainda com um duplo-clique com o mouse.

31

Manual do Kile

Quando voc pressionar a tecla Backspace, a ltima letra do seu padro ser removida e a lista de palavras do completamento poder crescer automaticamente. Por outro lado, se escrever outra letra, o padro ser estendido e a lista de palavras visveis poder diminuir. Se optar por no selecionar nenhuma das propostas, poder sair desta janela com o Esc. O usurio ir ver que todos os comandos esto escritos com uma pequena descrio dos seus parmetros. Estas descries esto, claro, cortadas quando voc selecionar um comando. Opcionalmente, poder deixar que o Kile insira pontos nestes locais, para que possa saltar facilmente para estas posies com a opo Editar Pontos Ponto Seguinte e inserir o parmetro que deseja.

V para Conguraes Congurar o Kile... Kile+Completamento para congurar uma ou mais listas deste tipo. Voc poder ento escolher listas de palavras diferentes para os comandos de TE X e LA TE X, bem como um modo de dicionrio para as palavras normais. Se voc escolher a opo Mostrar os comandos de Latex, os itens em todos os arquivos CWL escolhidos, usados no completamento dos comandos de LA TE X, sero apresentados numa zona em separado da barra lateral do Kile. Por isso, ir ter uma boa viso geral sobre os comandos disponveis e as opes que podero ser indicadas para um determinado completamento. Voc poder tambm simplesmente selecionar um item com o boto do mouse, de modo que possa ser inserido no documento, em que todos os parmetros e opes com nome so retirados.

32

Manual do Kile

Uma vez que cada lista de palavras escolhida ser apresentada numa rea em separado, podero existir muitas reas, de modo que a janela principal poder car muito grande para telas pequenas. Como isto ca muito feio, o Kile funciona com um nmero mximo de reas permitidas, estando isto congurado como sendo 10. Se este valor for muito grande para a sua tela, voc dever reduzir este nmero.

6.3

Ambientes

O modo de comando no til para ambientes completos. Voc ter sempre que escrever algumas letras do \begin e invocar o modo de completamento, o que ir resultar numa lista enorme de marcas de ambientes. Por outro lado, os ambientes so usados com tanta frequncia que o Kile oferece um modo especial para completar os ambientes. Esquea a marca de abertura e, simplesmente, escreva eq, por exemplo. Quando agora invocar o modo de completamento com a opo Editar Completar Ambiente ou o atalho de teclado Alt-Espao, a marca de abertura adicionada automaticamente e voc ver o \begin{eq}. Aps esta alterao, a lista de completamento estar muito mais limpa.

Agora, selecione um ambiente para v-lo fechando-se automaticamente. Alm disso, se o Kile reconhecer um ambiente de listas, ir tambm inserir uma primeira marca \item.

V para Conguraes Congurar o Kile... Kile Completamento para congurar uma ou mais listas deste tipo. Este modo usa as mesmas listas de palavras que o modo de completamento dos comandos de TE X e LA TE X.

33

Manual do Kile

6.4

Abreviaturas

O Kile suporta as listas de abreviaturas denidas pelo usurio, as quais so substitudas a pedido por sequncias de texto maiores. Veja em Conguraes Congurar o Kile... Kile Completamento para congurar uma ou mais destas listas. Para o exemplo acima indicado, a lista de abreviaturas em exemplo.cwl dever ser escolhida. Neste arquivo, voc encontrar o item L=\LaTeX, por exemplo. Vamos comear agora e escrever, por exemplo, apenas a letra L. Agora, invoque o modo de abreviatura do completamento de palavras com Editar Completar Abreviaturas ou com o atalho de teclado CtrlAlt-Espao para a letra L ser substituda pelo texto \LaTeX. O completamento de abreviaturas tambm suporta a mudana de linha %n e o %C para colocar o cursor, caso estes caracteres estejam presentes no texto da expanso. Por isso, se voc tiver o item
en1 =\ begin { enumerate }% n\ item %C%n\ end { enumerate }% n

no arquivo de completamento, e invocar o completamento da abreviatura, a expanso car parecida com a seguinte, onde o x mostra a posio nal do cursor.
\ begin { enumerate } \ item x \ end { enumerate }

6.4.1

Abreviaturas

Se escolher a opo Mostrar as abreviaturas, todas as possveis abreviaturas so apresentadas numa rea da barra lateral. Assim, voc ir ter uma boa viso geral sobre todas as abreviaturas possveis.

6.5
6.5.1

Modos de auto-complementao
Comandos LA TE X

Voc poder tambm ativar um modo de completamento para os comandos de LA TE X. Quando se atingir um determinado limite de letras (por padro: 3), aparece uma janela com uma lista de todos os comandos de LA TE X correspondentes. Voc poder selecionar um destes comandos ou ignorar esta janela e escrever mais letras. Os itens da rea de completamento iro sempre se alterar e corresponder sua palavra escrita. V para Conguraes Congurar o Kile... Kile Completamento para ativar e desativar este modo ou mudar o limite.

34

Manual do Kile

6.5.2

Palavras do documento

Os grandes dicionrios no so teis no modo de completamento. Porm, ns j vimos que algumas das palavras de um documento so escritas mais de uma vez. Como tal, o Kile oferece o completamento de todas as palavras do documento que o usurio j escreveu anteriormente. Voc poder invocar manualmente este completamento, se clicar em Ctrl-Espao. Lembre-se de que este modo diferente do modo de completamento dos comandos do LA TE X. Se voc quiser ativar ou desativar este modo, v para Conguraes Congurar o Kile... Editor Edio Completamento Automtico. Nesta janela de congurao, voc poder congurar se o modo de completamento das palavras do documento dever ser ativado. Existe tambm uma opo para alterar o valor-limite a partir do qual aparece a janela de completamento.

6.6

Escrever os Prprios Arquivos de Completamento

A ltima especicao do formato do arquivo de completamento pode ser encontrada na especicao do formato de arquivos CWL. Os arquivos de completamento podero ser instalados na rea pessoal de um usurio na subpasta ~/.kde/share/apps/kile/complete/<mode>/ , onde o <mode> tanto poder ser abbreviation, d ictionary ou tex.

35

Manual do Kile

Captulo 7

Assistentes e Dilogos
7.1 Assistente de incio rpido

Este assistente j foi descrito na seo Seo 2.3.1.

7.2

Incluir imagens

A janela Incluir grcos torna a insero de imagens a mais simples possvel. Voc pode acessla por meio do menu com LaTeX Insero de imagens. Por favor, d uma olhada em Seo 10.3 e Seo 10.4 para obter uma viso geral de alguns fatos relacionados com formatos grcos.

1. Escolha um arquivo grco. Ele poder ser um arquivo JPEG, PNG, PDF, EPS ou ainda um arquivo EPS comprimido com o zip ou o gzip. Se tiver instalado o ImageMagick e tambm tiver congurado o Kile para us-lo (Conguraes Congurar o Kile 36

Manual do Kile

LaTeX+Grcos), a largura e a altura da imagem ser mostrada automaticamente. Se o ImageMagick conseguir determinar uma resoluo, o tamanho da imagem ser tambm mostrado em centmetros. 2. Decida se sua imagem deve ser centralizada na pgina. 3. Escolha se deseja a notao \graphicspath para o seu arquivo grco. Por padro, os arquivos grcos tero que estar na mesma pasta que o seu documentomestre, para encontr-los. Contudo, possvel coloc-los em outras pastas para tornar as coisas mais claras. Sem um comando \graphicspath, o Kile iria incluir a localizao do arquivo de imagem. Mas, se usar o \graphicspath no seu prembulo da seguinte forma:
\ graphicspath {{/ caminho / para / minhas / imagens }{ outro / caminho / para / mais / imagens }}

e assinalar esta opo, o Kile ir usar apenas o nome de base do arquivo da imagem. Outro exemplo: se congurar o comando \graphicspath da seguinte forma:
\ graphicspath {{./}{ cmera /}{ imagens /}}

O LA TE X buscar do diretrio atual, em seguida em cmera e nalmente em imagens para encontrar seu arquivo de imagem. 4. Se indicar uma largura ou uma altura, a imagem completa ser redimensionada de forma proporcional. Por favor, no dene os valores para a largura e para a altura ao mesmo tempo. Isto redimensiona a imagem com fatores diferentes para a largura e a altura, o que com certeza no ser o que deseja. Veja tambm a informao perto do topo da janela, para ver o tamanho original da imagem. 5. Indique um ngulo, para a imagem ser rodada no sentido contrrio ao dos ponteiros do relgio. 6. A informao da caixa envolvente congurada automaticamente, quando voc escolher um arquivo grco. Esta informao s necessria quando voc trabalhar com o LA TE X tradicional e com imagens rasterizadas. Veja a discusso sobre as imagens EPS. Se o LA TE X precisar de uma rea envolvente e no quiser gerar um arquivo bb, o Kile suporta esta opo. Por outro lado, o PDFLA TE X ir dar um aviso, sempre que quiser incluir uma imagem PNG ou JPG com esta opo. Ela ativa ou desativa a opo da rea envolvente. 7. Ajustar a escala da imagem com o seguinte fator; por exemplo, 0,5 para reduzir para metade, ou 2 para duplicar. Quando usar esta opo, voc no ter que denir nenhuma largura ou altura para a imagem. 8. Na aba Trim Image voc pode cortar sua imagem em todas as quatro direes. 9. Por m, voc tem que especicar se deseja incorporar essa imagem em um ambiente de guras. Quando desejar que o texto seja disposto em torno da gura, use o ambiente wrapgure.

NOTA
Quando voc escolhe o ambiente wrapgure, voc precisa incluir o pacote wrapg em seu prembulo.

Em qualquer dos casos, voc poder inserir uma legenda e um ttulo para a sua imagem. uma boa ideia dar prexos diferentes aos vrios tipos de legenda. O Kile sugere o prexo fig: para as imagens.

37

Manual do Kile

10. Se voc escolher o ambiente de gura, voc pode escolher onde preferencialmente o LA TE Xdeve posicionar a gura. 11. No ambiente wrapgure voc pode (a) Escolha uma regra de colocao para a gura e decida se a gura deve utuar ou no. Em um documento de dois lados voc pode denir se a gura deve ser do lado de dentro da pgina ou do lado de fora. (b) Dena quantas linhas do texto devem ser quebradas. Se voc deixar em branco, o LA TE X determinar isso por si s da melhor forma possvel. (c) Dene uma sobreposio para o lado escolhido. Isto especialmente til quando voc possui colunas no seu documento e quer uma gura com extenso maior do que apenas uma coluna ou a quer disposta em duas colunas. (d) Escolha uma largura para a gura. Esta deve ser um pouco maior que a largura real da imagem, ento haver algum espao vazio entre a gura e o texto.

7.3

Matrizes e tabelas

Um dos trabalhos mais aborrecidos que uma pessoa poder fazer no LA TE X criar uma matriz ou um ambiente de tabelas. Voc ter que ter uma ideia de todos os elementos, garantir que o ambiente est denido de forma vlida e que todas as coisas esto nos seus locais corretos. Uma boa endentao ajuda, mas existe uma forma mais simples: usando os menus Assistente Matriz ou Assistente Tabular do Kile. Voc ir ter ento um formulrio em forma de matriz onde poder preencher facilmente os seus itens. Esta janela tambm oferece algumas opes para digitar o contedo da tabela.

Se usar a barra de ferramentas no topo da janela, poder denir o alinhamento de uma clula, denir um certo estilo de fonte, mesclar e dividir clulas, escolher uma borda e indicar as cores do texto e do fundo. A direita existe um boto Colar. Com este boto, voc poder inserir uma tabela a partir da rea de transferncia na janela, a qual lhe permite copiar e colar tabelas de uma planilha, por exemplo. No fundo, voc pode escolher quantas linhas e colunas deseja, podendo ainda ajustar algumas coisas sobre a sua matriz: 38

Manual do Kile

Com a opo Nome, voc poder selecionar o ambiente que ser usado para o seu item de lista ou tabela. Voc pode selecionar o alinhamento vertical das clulas com a opo Parmetro. Isto s ca ativado para os ambientes que suportem essa funcionalidade. Se existir para o ambiente selecionado, poder selecionar a opo usar a verso com asterisco. Quando selecionar esta opo, ter tambm que indicar uma largura da tabela. As tabelas normalmente parecem mais bonitas quando selecionar a opo usar o pacote booktabs. claro, voc tambm pode Centrar toda a sua lista. A opo Inserir marcadores ajuda-o quando deseja preencher o seu contedo no editor. Com esta opo, o Kile ir inserir marcadores com pontos para cada elemento da sua lista. A opo Assistente Tabelas ir mostrar um menu mais simples para congurar um ambiente em tabelas. Em todos estes ambientes, voc poder congurar facilmente o nmero de linhas e colunas, assim como o espao necessrio.

7.4

Inserindo elementos utuantes

O Kile o auxilia a inserir os seus elementos utuantes. Com a opo Assistente Flutuantes, bastante simples criar um novo ambiente de guras ou tabelas.

Para inserir um novo ambiente utuante basta seguir estes passos: 1. Escolha se deseja inserir uma gura ou uma tabela. 2. Selecione as regras de posicionamento desejado. 3. Insira um ttulo para o seu elemento utuante. 4. Digite uma legenda para o seu novo elemento utuante. O Kile ir sugerir um prexo apropriado, por exemplo g: para as guras e tab: para as tabelas. 39

Manual do Kile

7.5

Inserir ambientes matemticos

Recordar como todos os diferentes elementos matemticos funcionam pode ser bastante incmodo. Obviamente, o Kile pode fazer a mgica para voc aqui: Assistente Matemtica

Opes: Nome: escolha o tipo de elemento matemtico que deseja criar. Sem numerao: Isto poder desativar a numerao dos elementos numerados, como as equaes ou os alinhamentos. Comando de espao para separar os grupos: Num ambiente que suporta vrios grupos, como o alignat, voc poder denir um separador de espaos quando tiver mais de um grupo. Poder inserir qualquer comando de espaos aqui que exista no mathmode, por exemplo \quad. Tabulao normal: Selecione a tabulao que dever ser usada. O Kile dever escolher automaticamente a correta. Modo do displaymath: Para os ambientes como as matrizes ou as listas, voc poder escolher com que ambiente matemtico dever mostrar o seu texto matemtico. Usar marcadores: Com esta opo assinalada, o Kile ir inserir marcadores com pontos para cada elemento do seu texto matemtico.

7.6

Utilitrios de PostScript

Os arquivos PS no so to conhecidos como os arquivos PDF, mas so uma base excelente para as manipulaes e reorganizaes das pginas. Se precisar de um resultado em PDF, poder reorganizar as pginas com alguns utilitrios de PostScript e depois convert-las para PDF com o comando ps2pdf. O Assistente de PostScript em Assistente Ferramenta de PostScript sero sugeridas as reorganizaes mais conhecidas, mas voc est livre para fazer as suas prprias escolhas. O trabalho feito pelos programas pstops e psselect, os quais ir encontrar, na maioria das distribuies, no pacote psutils. Se um destes programas no estiver disponvel, o item correspondente no car visvel. 40

Manual do Kile

Escolha primeiro o seu arquivo de entrada. Se o Kile encontrar um arquivo PS, que corresponda ao seu documento-mestre atual, ele estar j preenchido como arquivo de entrada. Porm, voc est livre para escolher outro arquivo. Escolha ento um arquivo de sada, bem como uma das tarefas. Finalmente, voc ter que decidir se s pretende fazer a converso ou tambm invocar o Okular para ver o resultado. 1 pgina A5 + pgina vazia --> A4 Combinar uma pgina A5 em conjunto com uma pgina vazia numa pgina A4. Sempre que duas pginas A5 forem combinadas em conjunto, elas so rodadas 90 graus e sero organizadas numa pgina A4 no modo de paisagem.

1 pgina A5 + duplicado --> A4 Colocar uma pgina A5 e um duplicado em conjunto numa pgina A4.

2 pginas A5 --> A4 41

Manual do Kile

Colocar sempre duas pginas A5 consecutivas numa nica pgina A4.

2 pginas A5L --> A4 Colocar duas pginas A5 consecutivas no modo paisagem em conjunto numa pgina A4. 4 pginas A5 --> A4 Combina quatro pginas A5 consecutivas em conjunto, numa nica pgina A4. As pginas A5 tero que ser redimensionadas com um fator de 0,7 para caber na pgina.

1 pgina A4 + pgina vazia --> A4 Combinar uma pgina A4 em conjunto com uma pgina vazia numa pgina A4. Sempre que duas pginas A4 forem combinadas em conjunto numa nica pgina A4 resultante, elas tero que ser redimensionadas com um fator de 0,7 e organizadas numa pgina A4 no modo paisagem.

1 pgina A4 + duplicado --> A4 Colocar uma pgina A4 e um duplicado em conjunto numa pgina A4.

42

Manual do Kile

2 pginas A4 --> A4 Colocar sempre duas pginas A4 consecutivas numa nica pgina A4.

2 pginas A4L --> A4 Colocar duas pginas A4 consecutivas, no modo de paisagem, numa nica pgina A4. selecionar as pginas pares Selecionar todas as pginas pares de um documento. selecionar as pginas mpares Selecionar todas as pginas mpares de um documento. selecionar as pginas pares (ordem inversa) Selecionar todas as pginas pares de um documento e inverter a ordem. selecionar as pginas mpares (ordem inversa) Selecionar todas as pginas pares de um documento e inverter a ordem. inverter todas as pginas Inverter todas as pginas de um documento. copiar todas as pginas (ordenado) Copiar todas as pginas de um documento. Voc ter que escolher o nmero de cpias ordenadas.

43

Manual do Kile

copiar todas as pginas (no ordenado) Copiar todas as pginas de um documento. Voc ter que escolher o nmero de cpias no ordenadas.

pstops: escolha o parmetro Existem muitas mais possibilidades para usar os utilitrios de PostScript pstops e psselect. Se voc precisar de uma opo muito especial, poder invocar o comando pstops com uma opo sua escolha. Leia por favor o manual para conhecer todas as opes possveis. psselect: escolha o parmetro Voc poder invocar o comando psselect com uma opo sua escolha. Veja por favor o manual para descobrir todas as opes possveis.

7.7

Utilitrios de PDF

Muitas pessoas pensam nos PDFs como arquivos estticos, que no podem ser modicados. Contudo, isto no verdade, pois existem excelentes ferramentas para a manipulao e reorganizao das pginas para ler e atualizar as informaes do documento para ler, denir e alterar algumas permisses de um documento PDF existente. O assistente de PDF do Kile, disponvel em Assistente Ferramentas de PDF, usa dois mtodos diferentes para manipular e reorganizar os documentos em PDF: O pacote LA TE X pdfpages, que faz parte de cada distribuio do LA TE X. O pdfpages no funciona com pginas criptografadas. O pdftk, que uma ferramenta de linha de comando excelente para as tarefas do dia a dia com documentos em PDF (veja o PDF Toolkit). Se algum destes utilitrios, o pdfpages ou o pdftk, no estiver presente no seu sistema, os itens correspondentes no sero visveis. Alm disso, lembre-se de que somente o pdftk funciona com arquivos criptografados.

7.7.1

Reorganizaes

Se o assistente de PDFs do Kile for carregado, ele ir iniciar com o carto de registro das Reorga nizaes.

44

Manual do Kile

Escolha primeiro o seu arquivo de entrada. Se o Kile encontrar um arquivo PDF que corresponda ao seu documento mestre atual, ele j estar preenchido como arquivo de entrada, mas voc est livre para escolher outro arquivo. Escolha ento um arquivo de sada ou sobrescreva um arquivo PDF existente, assim como uma das tarefas. Finalmente, voc precisa decidir se pretende apenas fazer a converso ou tambm carregar o visualizador (por exemplo o Okular) para ver o resultado. Se o arquivo PDF estiver criptografado, somente a ferramenta pdftk ir funcionar e voc tem que denir a senha deste documento para executar as tarefas. 1 pgina + pgina vazia --> A4 Combinar uma pgina em conjunto com uma pgina vazia em uma pgina A4. Sempre que duas pginas A5 forem combinadas em conjunto, elas so giradas 90 graus e sero organizadas em uma pgina A4 no modo de paisagem.

Sempre que duas pginas A4 forem combinadas em conjunto, elas sero ajustadas, giradas 90 graus e organizadas em uma pgina A4 no modo de paisagem.

45

Manual do Kile

1 pgina + duplicado --> A4 Colocar uma pgina e um duplicado em conjunto em uma pgina A4.

Se a pgina a ser duplicada tiver o tamanho A4, ser ajustada para caber na pgina.

2 pginas --> A4 Combinar duas pginas consecutivas em conjunto em uma pgina A4. Sempre que duas pginas A5 forem combinadas em conjunto, elas so giradas 90 graus e sero organizadas em uma pgina A4 no modo de paisagem.

Sempre que duas pginas A4 forem combinadas em conjunto, elas sero ajustadas, giradas 90 graus e organizadas em uma pgina A4 no modo de paisagem. 46

Manual do Kile

2 pginas (paisagem) --> A4 Colocar duas pginas consecutivas no modo paisagem em conjunto em uma pgina A4.

4 pginas --> A4 Combina quatro pginas consecutivas em conjunto em numa nica pgina A4. As pginas precisam ser ajustadas para caber na pgina.

4 pginas (paisagem) --> A4 Combina quatro pginas consecutivas no modo paisagem em conjunto em uma nica pgina A4. As pginas precisam ser ajustadas caber na pgina.

selecionar as pginas pares Selecionar todas as pginas pares de um documento.

47

Manual do Kile

selecionar as pginas mpares Selecionar todas as pginas mpares de um documento. selecionar as pginas pares (ordem inversa) Selecionar todas as pginas pares de um documento e inverter a ordem. selecionar as pginas mpares (ordem inversa) Selecionar todas as pginas pares de um documento e inverter a ordem. inverter todas as pginas Inverter todas as pginas de um documento. descriptografar um arquivo Se o arquivo PDF estiver criptografado, voc pode descriptografa este arquivo. selecionar as pginas Adiciona uma lista separada por vrgulas de pginas ou intervalos de pginas, por exemplo 1,4-7,9. Somente estas pginas iro aparecer no arquivo PDF resultante. excluir pginas Adiciona uma lista separada por vrgulas de pginas ou intervalos de pginas que devem ser removidas do documento PDF escolhido. aplicar uma marca dgua no fundo Aplica uma marca dgua do PDF ao fundo de um PDF nico. O assistente s usa a primeira pgina do PDF de fundo e aplica-a a todas as pginas do PDF de entrada. Esta pgina ajustada e girada para caber na pgina de entrada. aplicar uma cor de fundo Aplica uma cor de fundo a todas as pginas do documento atual. Isto s pode ser feito uma vez, pois a segunda cor ser colocada atrs da primeira e deixar de ser visvel. aplicar uma estampa em primeiro plano Aplica uma estampa em primeiro plano no topo das pginas do documento PDF de entrada. O assistente s usa a primeira pgina do PDF da estampa e aplica-a a todas as pginas do PDF de entrada. Esta pgina ajustada e girada para caber na pgina de entrada. Isto funciona melhor se a pgina do PDF de estampa tiver um fundo transparente. pdftk: escolha o parmetro Voc pode carregar o comando pdftk com uma opo sua escolha. Leia o manual para descobrir todas as opes possveis. pdfpages: escolha o parmetro Voc pode carregar o comando pdfpages com uma opo sua escolha. Leia o manual para descobrir todas as opes possveis.

7.7.2

Propriedades

A denio, alterao e remoo das propriedades s ser possvel caso o pdftk esteja instalado e se o Kile foi compilado com a biblioteca libpoppler.

48

Manual do Kile

Os metadados tradicionais do PDF incluem o ttulo do documento, o seu autor, assunto, palavraschave, criador, produtor e datas da criao e ltima modicao.

7.7.3

Permisses

Tambm a denio, alterao e remoo das permisses s ser possvel se tiver o pdftk estiver instalado.

necessria uma senha para denir ou alterar estas denies do documento. Alm disso, a criptograa do PDF feita para bloquear o contedo do arquivo atrs desta senha ou para aplicar restries mais leves impostas pelo autor. Assim, o autor poder permitir ou restringir 49

Manual do Kile

a impresso de pginas a modicao de pginas a cpia do texto e dos grcos das pginas a alterao ou adio de anotaes o preenchimento dos campos com dados A alterao das permisses fora sempre a criptograa associada segurana de 128 bits do Acr obat 5 e 6, necessitando tambm de uma senha. Mas lembre-se sempre: a criptograa e uma senha no oferecem nenhuma segurana real para o PDF. O contedo est criptografado, mas a senha conhecida. Voc deve ver isto como um pedido educado, mas rme, para respeitar a vontade do autor.

7.8

Estatsticas do Documento

A janela de estatsticas em Arquivo Estatsticas fornece uma viso geral estatstica para uma seleo, um documento ou um projeto inteiro. Inclui o nmero de palavras, comandos/ambientes de LA TE X, incluindo tambm o nmero de caracteres para cada tipo. As estatsticas obtidas podero ser copiadas como texto ou como uma tabela de LA TE X devidamente formatada para a rea de transferncia. Quando selecionar um texto e abrir a janela de estatsticas, voc ir obter os dados sobre o texto selecionado de momento. Se abrir a janela sem qualquer texto selecionado, sero apresentadas as estatsticas para todos os arquivos abertos. Se quiser obter estatsticas para todo o projeto, poder usar a opo Projeto Abrir todos os arquivos do projeto para uma forma simples e rpida de abrir todos os arquivos de cdigo do seu projeto. A seguir, faremos uma observao sobre a preciso dos valores. Foi includa alguma lgica para obter uma boa estimativa; por exemplo, K\uhler d uma palavra e um comando, com seis e dois caracteres, respectivamente. Mas existem outras combinaes, com as quais partes dos comandos contam como palavras e vice-versa. Por favor, note que o algoritmo foi desenvolvido e testado para lnguas semelhantes ao ingls ou ao alemo. Assim, no assuma os nmeros como certos. Se tiver que fazer um relatrio com um nmero exato de palavras ou caracteres, faa alguns testes primeiro para vericar se a preciso do Kile satisfaz as suas necessidades.

50

Manual do Kile

Captulo 8

Marcas Especiais em LATEX

8.1 Usar a Biblioteca de Marcas do LA TE X

O LA TE X possui milhares de marcas para os smbolos e caracteres especiais. A forma mais simples de inserir caracteres especiais usar o menu lateral, esquerda da janela do editor.

A Barra Lateral Esto disponveis os seguintes tipos: Mais frequentemente usados Relao Operadores Setas Matemtica 51

Manual do Kile

Texto Delimitadores Grego Caracteres Especiais Caracteres cirlicos Denido pelo Usurio As dicas dos cones mostram os comandos de LA TE X e os pacotes adicionais necessrios. Pressionar Shift e um smbolo, ir inserir um $\comando-smbolo$. Da mesma forma, pressionar Ctrl, ir inseri-lo entre chaves. Se inserir um comando que necessite de um pacote que no esteja includo no seu documento em LA TE X, ir ver uma mensagem de aviso na janela do registro. A primeira lista de smbolos contm os smbolos Mais Usados. Os smbolos inseridos sero adicionados a esta lista, para uma referncia rpida e simples. A ordenao dos smbolos no ser alterada com a adio de smbolos novos, sendo que ser aumentado um contador de referncias em alternativa. Se o nmero de itens ultrapassar os 30, o item com a quantidade menor ser removido. A lista de smbolos Denidos pelo Usurio poder conter os seus prprios smbolos. Para criar os seus prprios smbolos, ir precisar do programa gesymb e do arquivo denitions.tex do pacote de cdigo-fonte do kile. Alm disso, ir necessitar de um compilador de LA TE X (como seria de esperar) e do dvipng (verso 1.7 ou posterior). O procedimento consiste em criar um arquivo de LA TE X com o \input{definitions}, o que faz com que os comandos abaixo quem disponveis, fazendo com que o gesymb meus-smbolos.tex usurio (que invoca o LA TE X e o dvipng) crie os cones. Depois de copi-los para a pasta $HOME/.kde/share/apps/ kile/mathsymbols/user/ e reiniciar o kile, voc poder usar os seus prprios smbolos. Esto denidos os seguintes comandos em denitions.tex: \command[\arg-opcional]{\smbolo}: Inclui o smbolo \smbolo na lista de smbolos; o argumento opcional \arg-opcional dene o comando que o kile dever inserir. Se no for indicado, usado o comando no argumento obrigatrio. \mathcommand[\arg-opcional]{\smbolo}: O mesmo que a anterior, exceto que o comando no argumento obrigatrio inserido no modo matemtico. \pkgs[argumento]{pacote}: Declara que o comando indicado nesta linha precisa do pacote de LA TE X pacote com o argumento opcional argumento. Este comando tem que estar frente do comando \command e substitui todas as denies de pacotes do ambiente neededpkgs. \begin{neededpkgs}[args-pacotes]{pacotes} ... \end{neededpkgs}: Tem o mesmo efeito que o anterior, mas serve para todos os comandos englobados por ele. Um exemplo completo fornecido aqui:
\ documentclass [ a4paper ,10 pt ]{ article } \ usepackage { amssymb } \ input { definitions } % \ begin { document } \ pagestyle { empty } % \ begin { neededpkgs }{ amssymb } \ mathcommand {\ surd }

52

Manual do Kile

\ pkgs { amsmath }\ mathcommand [\ ddddot {}]{\ ddddot {a }} \ mathcommand {\ angle } \ end { neededpkgs } \ command {\" A} \ mathcommand {\ exists } \ mathcommand [\ stackrel {}{}]{\ stackrel { abc }{=}} %\ begin { neededpkgs }[ russian , koi8 -r ,T2C ,]{ babel , inputenc , fontenc , mathtext } % % \ end { neededpkgs } % isto iria necessitar de incluir os pacotes % \ usepackage { mathtext } % \ usepackage [ T2C ]{ fontenc } % \ usepackage [ russian ]{ babel } % \ usepackage [ koi8 -r ]{ inputenc } % apenas para explicar o formato \ end { document }

8.2

Usar os Itens Bibliogrcos

O \bibitem um comando usado para inserir uma referncia num ambiente thebibliograp hy (a bibliograa) do seu documento. A sintaxe para usar o using \bibitem \bibitem[leg enda]{chave}. A [legenda] opcional para voc adicionar o seu prprio sistema de legendagem para o item da bibliograa. Se no estiver denida nenhuma legenda, os itens sero denidos por ordem numrica: [1], [2], [3], etc O argumento {chave} usado para referenciar e associar os comandos \bibitem e \cite um ao outro, bem como a informao que estes contm. O comando \cite contm a legenda associada com o \bibitem pretendido, o qual se localiza dentro de um ambiente thebibliogr aphy e que contm os dados de referncia. Ambos os comandos \bibitem e \cite devero ter a mesma {chave}; a forma mais simples de organizar as chaves pelo ltimo nome do autor. Os parnteses secundrios no ambiente thebibliography indicam a legenda mais longa que poder ter. Por isso, se inserir um {xpto} signica que voc poder ter qualquer legenda menor ou to grande quanto a expresso xpto. Se no denir este parmetro corretamente, poder obter um recuo no to atrativo da sua bibliograa. A bibliograa uma seo parte do seu documento principal e um exemplo de cdigo para a bibliograa seria semelhante ao seguinte:
\ begin { thebibliography }{50} \ bibitem { Simpson } Homer J. Simpson . \ textsl { Mmmmm ... donuts }. Evergreen Terrace Printing Co ., Springfield , Em algum lugar , 1998 \ end { thebibliography }

Neste caso, o seu cdigo-fonte principal iria conter a localizao da informao referente ao \bi bitem, usando o \cite. Este cdigo-fonte seria semelhante a este:
A minha tese sobre a filosofia dos Simpsons \ copyright vem do meu livro favorito \ cite { Simpson }.

Um vez ser normalmente difcil recordar a citao exata, considerando que possua muitas referncias, o Kile oferece uma forma simples de inserir uma citao. Se usar a opo LaTeX Referncias Citar, ir aparecer uma lista com todas as chaves de citao. Selecione a referncia correta, para que possa introduzir uma citao no seu documento. Para atualizar a lista 53

Manual do Kile

de chaves, voc tanto poder salvar o arquivo, invocar Editar Atualizar a estrutura ou pressionar em F12. Com o completamento de cdigo, o Kile exibe uma lista com todos os itens bibitem, assim que abrir um comando \cite. O resultado nal da bibliograa do seu documento iria ento car parecido com o seguinte: [1] Homer J. Simpson. Mmmmm...donuts. , Estados Unidos, 1998. Evergreen Terrace Printing Co., Springfield

O Kile tambm pode trabalhar em conjunto com os editores do BibTE X, como o KBibTE X, para facilitar a insero de citaes. Quando for adicionado um arquivo do BibTE X ao projeto, o Kile lhe auxilia a completar os comandos de citao, tal como descrito acima

54

Manual do Kile

Captulo 9

Menu congurvel pelo usurio

9.1 Congurao

O Kile suporta um menu congurvel pelo usurio, que ir aparecer como parte do menu do Kile. Este menu pode ser congurado com a opo Conguraes Congurar o Kile Menu do Usurio.

Voc tem duas opes para colocar este menu: ou o item do menu Menu do Usurio ir aparecer no menu principal, entre os itens de menu LaTeX e Assistente e o assistente de congurao Editar o Menu do Usurio no menu Assistente

55

Manual do Kile

ou ambos os itens iro aparecer no fundo do item LaTeX do menu.

As marcas denidas pelo usurio j existentes em verses mais antigas do Kile so transformadas automaticamente para o novo menu congurvel pelo usurio. As marcas so guardadas num arquivo chamado usertags.xml e, como em todos os arquivos de denio do menu, podero ser encontrados na pasta local dos menus do usurio do Kile: KILE_APP_DIR/usermenu/ , por exemplo, /home/usurio/.kde/share/apps/kile/usermenu/ . Voc poder usar diferentes arquivos de denio do menu para diferentes tarefas. Invoque o assistente do menu do usurio Assistente Editar o Menu do Usurio ou LaTeX Editar o Menu do Usurio para instalar ou editar um arquivo de denio do menu.

9.2

Assistente

Voc pode criar menus novos ou alterar os existentes com um assistente de congurao de menus do usurio que poder ser encontrado em Assistente Editar o Menu do Usurio.

56

Manual do Kile

Do lado esquerdo voc ver uma rvore de menu existente. Como em um menu normal, esto disponveis trs tipos de itens do menu: itens de menu normais, atribudos a uma ao submenus, que contm mais itens de menu separadores, para obter uma estrutura visvel de todos os itens Para modicar este menu, use os seis botes do lado esquerdo. Esto disponveis ainda mais aes no menu de contexto dos itens j existentes.

Cada item de menu normal est atribudo a um de trs tipos de aes, onde cada um possui diferentes atributos a denir: 57

Manual do Kile

Texto: o Kile d-lhe a possibilidade de criar as suas prprias marcas. Uma marca semelhante a um atalho que invoca algum comando ou escreve um texto frequente, por exemplo o Marcus usa bastante a frase Ol, eu anexei.... Esta marca ser inserida na posio atual do cursor, quando esta ao for invocada (ver acima). Esto tambm disponveis meta-caracteres (ver em Seo 9.3). Inserir o contedo de um arquivo: Insere o contedo completo de um determinado arquivo.

Executar um programa externo: O resultado deste comando poder ser inserido no documento aberto. O meta-caractere %M tambm possvel na linha de comando deste programa, uma vez que o texto selecionado ser salvo em um arquivo temporrio. Use o %M para o nome deste arquivo temporrio.

Se faltar alguma informao importante para uma ao, os itens do menu aparecem em vermelho. Poder ser, por exemplo, um arquivo inexistente

58

Manual do Kile

ou a falta de um ttulo para a opo do menu, o qual ser apresentado com pontos de interrogao do tipo ???.

Se voc abrir o menu de contexto de um desses itens do menu, ir obter uma opo adicional com mais informaes sobre esse erro.

59

Manual do Kile

Mais informaes podem estar disponveis com a funcionalidade O que isto da maior parte dos itens.

9.3
9.3.1

Substituies
Inserir um texto

Existem alguns itens de substituio que voc poder usar nas marcas que voc denir: %C, %B, %M, %E, %R e %T. %C: aqui ser onde o cursor ser colocado depois de inserir uma marca denida pelo usurio.

%B: ser substitudo por um ponto (veja em Seo 5.5).

60

Manual do Kile

%M: ser substitudo pelo texto selecionado.

%E: dene a profundidade de indentao do texto dentro de um ambiente.

%R: ir invocar uma janela de referncia para escolher uma legenda j denida. Isto pode ser usado para referenciar uma legenda predenida, que voc poder escolher numa lista (ver tambm em LaTeX Referncias ref ou LaTeX Referncias pageref).

%T: ir invocar uma janela de citao para escolher uma j existente. Como no uso da opo LaTeX Referncias Citar, ir aparecer uma lista com todas as chaves de citao.

61

Manual do Kile

Vejamos outro exemplo, com uma macro do tipo \frac{%M}{%C}. Primeiro, iremos selecionar um nmero no nosso texto, como por exemplo 42. Agora iremos invocar esta macro e obter \frac{42}{} com o cursor localizado dentro do segundo par de chavetas.

9.3.2

Inserir o contedo do arquivo

Se voc quiser inserir o contedo de um arquivo de texto, poder usar os mesmos itens de substituio.

9.3.3

Executar um programa

Se voc quiser executar um programa externo, s reconhecido o %M para o texto selecionado na linha de comando. A seleo ser salva em um arquivo temporrio e o item de substituio %M substitudo por este nome de arquivo.

Outro item de substituio o %S, que substitudo pelo nome de base completo do documento atual, sem a respectiva pasta. Este nome de base consiste em todos os caracteres no nome do arquivo at o ltimo caractere . (exclusive).

9.4

Parmetro

A maioria dos itens de menu podero ter parmetros intuitivos adicionais, os quais podero ser vericados. Se alguns destes parmetros no estiverem disponveis para algum tipo de ao, sero desativados.

62

Manual do Kile

Aqui est um exemplo de execuo de um programa externo:

Voc poder ver que invocado um programa em perl, o qual dever funcionar com a seleo atual. O parmetro Necessita de texto selecionado est assinalado para garantir que exista um texto selecionado. O resultado deste programa ser inserido (Inserir o resultado do programa escolhido) e substituir a seleo atual (Substituir o texto selecionado), mas no car selecionado por si s.

9.5

Arquivos de denio do menu

Voc poder instalar diferentes menus durante a execuo para diferentes tarefas. Quando invocar o assistente do menu, ser carregado o arquivo de denio do menu atual. Se o modicar e fechar a janela com o OK, as suas alteraes sero salvas e instaladas como um novo menu de usurio. Se fechar a janela com o Cancelar, ir ignorar todas as alteraes.

63

Manual do Kile

Mas voc tambm est livre para modicar o arquivo modicado na pasta de menus do usurio ou para carregar outro arquivo de denies e instal-lo. Todos os arquivos de denio dos menus devero ser salvos na pasta local dos menus do usurio do Kile: KILE_APP_DIR/usermen u/ . Veja o arquivo de denio do menu de exemplo example.xml para ver mais itens de menu com os seus parmetros.

64

Manual do Kile

Captulo 10

As Ferramentas de Construo
10.1 Compilar, converter e visualizar

Para ver o resultado do seu trabalho, voc precisa primeiro compilar o cdigo. Todas as ferramentas de compilao esto agrupadas nos menus Criar Compilar, Criar Converter e Criar Ver. Para compilar o seu cdigo-fonte para os visualizadores como o Okular ou outras converses, voc poder usar o atalho Alt-2. A, poder ver o arquivo DVI com o seu visualizador padro com o Alt-3, converter o DVI para um arquivo PS com o Alt-4 e ver o arquivo PS com o Alt-5.

10.1.1

BibTE X

Se voc estiver usando o BibTEX para os seus elementos bibliogrcos, ter normalmente que seguir um esquema de compilao especial. Isto signica a invocao do LA TE X, do BibTE X e depois do LA TE X de novo. Felizmente, o Kile sucientemente inteligente para detectar automaticamente se necessrio invocar as ferramentas adicionais, como o BibTE X, o makeidx e o Asymptote. Esta lgica est ativada por padro e poder ser modicada na opo Conguraes Congurar o Kile... Ferramentas+Compilao da pgina Geral das ferramentas LA TE X e PDFLA TE X.

10.1.2

MetaPost e o Asymptote

Se voc quiser compilar o seu documento com o MetaPost ou o Asymptote, os programas de desenho de imagens, poder fazer isso com a opo Criar Compilar Metapost ou Criar Compilar Asymptote.

10.1.3

PDFLA TE X

Existe tambm outra forma de compilar o seu documento, se quiser um PDF: voc poder executar o PDFLA TE X, que ir compilar o cdigo diretamente para um arquivo PDF, com o Alt-6: poder ento ver o arquivo compilado se pressionar Alt-7. Em alternativa, poder converter um PS num PDF com o Alt-8 ou, diretamente, um DVI para um PDF com o Alt-9. Se usar o PDFLA TE X em vez do LA TE X, poder ser uma questo de simplicidade ou hbito, mas em algumas ocasies o comportamento dos dois programas poder ser diferente. 65

Manual do Kile

10.1.4

O LA TE X para a Web

Finalmente, voc poder querer publicar o seu trabalho na Web e no apenas no papel. Poder ento, neste caso, usar o programa latex2html, que poder ser invocado a partir do menu do Kile em Criar Converter LaTeX para Web. O resultado ser colocado numa subpasta da pasta de trabalho, sendo para voc possvel ver o resultado da converso com o item Criar Ver Ver o HTML.

10.1.5

Passar Parmetros da Linha de Comando

Se voc quiser passar alguns parmetros especcos da linha de comando para as ferramentas de compilao, converso ou visualizao, poder congurar as invocaes das mesmas em Conguraes Congurar o Kile... Ferramentas+Compilar.

10.2

Previso Rpida

Voc Ir necessitar sempre de algum tempo para ver o resultado, ao trabalhar com o LA TE X. O LA TE X tem que compilar o cdigo e o visualizador ter que ser invocado. Isto poder ser incmodo, quando alterou apenas algumas letras de uma equao, o que difcil de escrever. O Kile oferece agora um modo de Previso Rpida, onde poder compilar apenas uma parte de um documento e poupar bastante tempo. Ele suporta quatro modos diferentes, os quais podero ser combinados em sete conguraes.

Toda a congurao dever ser feita em Conguraes Congurar o Kile... Ferramentas Previso.

66

Manual do Kile

10.2.1

Modo de Seleo

O usurio ter que selecionar uma parte do documento. O item do menu Compilar Previso Rpida Seleo ou o atalho de teclado Ctrl+Alt+PS ir iniciar os programas selecionados. O Kile usa o prembulo do texto original, de modo que todos os pacotes e os comandos denidos pelo usurio sero includos. O usurio poder ento escolher uma das oito conguraes predenidas: LaTeX+DVI (visualizador incorporado) LaTeX+DVI (Okular) LaTeX+PS (visualizador incorporado) LaTeX+PS (Okular) PDFLaTeX+PDF (visualizador incorporado) PDFLaTeX+PDF (Okular) XeLaTeX+PS (visualizador incorporado) XeLaTeX+PDF (Okular) Isto dever ser suciente para todas as situaes necessrias numa previso rpida.

10.2.2

Modo do Ambiente

Muitas das vezes, voc poder querer antever o ambiente atual. Especialmente no caso de ambientes matemticos, o que poder ser difcil de escrever. O Kile oferece uma forma muito rpida para o fazer. No necessria qualquer seleo, bastando para tal escolher Compilar Previso Rpida Ambiente ou o atalho de teclado Ctrl+Alt+PE, para que o ambiente atual seja compilado e apresentado.

67

Manual do Kile

10.2.3

Modo de Sub-Documento

Tambm frequente que voc tenha projetos com vrios documentos. Compilar todo o projeto no ser uma boa ideia, no caso de ter feito apenas alteraes num nico documento. O Kile ser capaz de compilar e mostrar uma previso do sub-documento atual. Ele retira o prembulo de um documento-mestre denido e compila apenas este nico documento, quando voc escolher a opo Compilar Previso Rpida Sub-documento ou o atalho de teclado Ctrl+Alt+PD.

10.2.4

Modo de Grupo Matemtico

O modo de previso do grupo matemtico permite-lhe antever o grupo matemtico que est editando no momento. O Kile obtm o prembulo do documento-mestre e s compila o grupo matemtico sobre o qual o cursor se encontra, quando escolher o Construir Previso Rpida Grupo Matemtico ou escolher o atalho de teclado Ctrl+Alt+P,M.

10.2.5

Previso Rpida na barra inferior

Em vez de mostrar a previso num documento novo, o Kile poder tambm ser congurado para usar a barra inferior para as compilaes da previso. Voc poder ativar esta funcionalidade no painel de congurao da previso rpida.

10.3
10.3.1

Formatos de Arquivos Grcos

LA TE X e PDFLA TE X

O PDFLA TE X, quando for usado com os pacotes graphics ou o graphicx, poder compilar corretamente os arquivos PNG e JPG num DVI ou PDF, mas no capaz de lidar com os arquivos EPS. Por outro lado, o processo de compilao para um DVI e a converso para PS e, eventualmente, PDF suporta os EPS, mas no os arquivos PNG e JPG. Diversos usurios desejam criar documentos PDF mas, por exemplo, tiram partido do excelente pacote Pstricks para criar imagens PostScript ; ou, por outro lado, desejam usar o resultado em PostScript do software matemtico/cientco, como o Mathematica, o Maple ou o MuPAD. Estes usurios de LA TE X tm que selecionar o formato PostScript , mesmo que desejem criar documentos PDF, uma vez que estes programas produzem cdigo PostScript que no pode ser gerido pelo PDFLA TE X. Todavia, no assim to complicado como parece, uma vez que o Kile ir ajudar.

10.3.2

Converso de Imagens

Para dar a volta a este ciclo frustrante, no caso de desejar tanto o cdigo em PostScript como os arquivos PNG ou JPG, voc tem um conjunto de solues alternativas: Se necessitar de um arquivo no formato PS, mas se tiver imagens JPG ou PNG, poder tambm usar simplesmente o PDFLA TE X com o resultado em DVI e depois usar a instruo da linha de comando dvips. Ir ver que o PDFLA TE X uma escolha muito boa, se o seu cdigo no tiver qualquer cdigo em PostScript . Voc poder converter os arquivos EPS para PNG ou outros formatos com alguns utilitrios como o Gimp ou o ImageMagick e usar o PDFLA TE X.

68

Manual do Kile

Uma das formas preferidas converter as imagens EPS para imagens PDF com o epstopdf, que vem com cada distribuio do TE X e ento usar o PDFLA TE X. Ele produz imagens de alta qualidade e voc poder at controlar o resultado com algumas das opes seguintes:
- dAutoFilterColorImages = false - dAutoFilterGrayImages = false - sColorImageFilter = FlateEncode - sGrayImageFilter = FlateEncode - dPDFSETTINGS =/ prepress - dUseFlateCompression = true

Ainda melhor: se o seu sistema permitir o shell-escape, a converso poder ser feita em tempo real. Tudo o que ter que fazer incluir o pacote epstopdf, que faz parte de todas as distribuies do TE X, com o comando \usepackage{epstopdf}. Assumindo que o seu cdigo
\ includegraphics [ width =5 cm ]{ teste . eps }

Ao executar o PDFLA TE X com a opo pdatex --shell-input, a imagem teste.eps convertida automaticamente para teste.pdf. Esta converso ir ocorrer cada vez que voc executar o PDFLA TE X. Se o seu comando grco dado implicitamente
\ includegraphics [ width =5 cm ]{ teste }

, o epstopdf verica se o teste.pdf j est disponvel, de modo que o passo de converso poder ser ignorado. Voc poder converter da forma inversa e usar o LA TE X e a converso PS-PDF; esta nem sempre uma boa ideia, uma vez que o encapsulamento em EPS dos JPGs ou PNGs poder criar arquivos maiores, que por sua vez geram documentos desnecessariamente grandes; isto , contudo, altamente dependente do utilitrio grco que usar, dado que o EPS pode encapsular outros grcos, mas nem todas as aplicaes suportam isto perfeitamente; algumas podero, de fato, tentar criar a sua imagem JPG com vetores e programao diversa, o que ir resultar em arquivos gigantes. A converso de todos os formatos grcos para EPS poder ser conseguida com o ImageMagick. Outro programa simples que faz este processo corretamente o jpg2ps. Voc poder tambm usar uma forma automtica de converso. Todos os arquivos grcos so convertidos na compilao para EPS e inseridos no documento PS. Esta uma forma confortvel, mas o usurio ter que congurar o seu sistema convenientemente. Isto discutido na seo das Imagens EPS.

10.3.3

Use o arquivo correto para a imagem correta

O EPS uma espcie de linguagem de programa de grcos vetoriais, descrevendo todas as linhas e pontos que constituem o grco; parece muito bom, mesmo quando ampliado para alm do seu tamanho padro e adequa-se bem a diagramas e a imagens vetoriais produzidas nativamente em EPS, parecendo bastante claro e denido e mantendo ainda um tamanho de arquivo bastante pequeno. O PNG (ou o desatualizado GIF) um formato de arquivo sem-perdas, com boa compresso e qualidade. muito bom para diagramas, digitalizaes de desenhos ou todo o tipo de imagens em que queira manter a denio. Ele pode se tornar um grande abuso quando usado para fotos.

69

Manual do Kile

O JPG um formato com perdas que comprime melhor os arquivos do que o PNG, sob pena de algumas perdas dos detalhes das imagens. Isto normalmente irrelevante para as fotos, poder causar uma m qualidade para os diagramas, desenhos e poder fazer com que algumas linhas nas desapaream; nesses casos, use o EPS ou o PNG. Porm lembre-se sempre: entra lixo, sai lixo! No h nenhuma converso que transforme uma imagem m numa boa.

10.4

Imagens EPS

Os arquivos grcos EPS so a forma tradicional de inserir arquivos grcos em documentos do LA TE X. Uma vez que as listas de correio esto cheias de dvidas no que diz respeito s imagens EPS, sero discutidos alguns aspectos importantes e ser demonstrada a forma como o Kile ir suportar esta tarefa.

10.4.1

O LA TE X e as Imagens EPS

Se voc optou por usar o LA TE X tradicional para produzir resultados em PS ou PDF, provvel que tenha alguns problemas com as imagens. Voc ter que usar as imagens EPS (Encapsulated PostScript ), e no os arquivos JPEG ou PNG. Isto no dever ser qualquer problema, uma vez que existem vrios conversores, como o convert do excelente pacote que o ImageMagick. Contudo, necessrio algum tempo, obviamente. Os arquivos EPS so usados tanto pelo LA TE X como pelos conversores DVI-PS: O LA TE X procura no arquivo EPS pela linha da caixa envolvente, a qual indica ao LA TE X quanto espao dever reservar para a imagem. O conversor DVI-PS l ento o arquivo EPS e insere a imagem no arquivo PS. Isto tem algumas implicaes: O LA TE X nunca l o arquivo EPS se os parmetros da caixa envolvente forem indicados no comando de insero da imagem. Uma vez que o LA TE X no consegue ler arquivos que no sejam ASCII, ele no consegue ler a informao da caixa envolvente a partir de arquivos comprimidos ou que no sejam EPS. As imagens EPS no so includas no arquivo DVI. Uma vez que os arquivos EPS devero estar presentes quando o arquivo DVI for convertido para PS, os arquivos EPS devero acompanhar os arquivos DVI, sempre que estes forem movidos. Agora voc poder invocar o LA TE X, e um conversor DVI-PS como o dvips para criar o seu documento em PostScript . Se o seu objetivo for um documento PDF, dever executar o dvips com a opo -Ppdf e depois executar o ps2pdf. Voc ir encontrar vrios documentos que descrevem esta soluo.

10.4.2

O Formato PostScript do Kile

O Kile ajuda-o a obter a informao da Caixa Envolvente. Se voc tiver instalado o ImageMagick, o Kile ir extrair esta informao do arquivo EPS e inseri-la como uma opo. Isto feito automaticamente, quando voc selecionar o arquivo da imagem. Existem duas vantagens para este procedimento: 70

Manual do Kile

A informao j est extrada na janela e no preciso fazer isso de novo pelo LA TE X. Ainda mais importante tambm o fato de a largura e a altura da imagem poderem ser calculadas, quando a resoluo da imagem for conhecida. Esta informao ser apresentada perto do topo da janela e poder servir como uma pista, sempre que o usurio desejar dimensionar as imagens. O Kile poder tambm suportar arquivos EPS comprimidos com o zip ou com o gzip, os quais so muito menores que os arquivos EPS no comprimidos. Contudo, esta funcionalidade s poder ser usada com uma congurao especial do sistema e com uma alterao na sua congurao local de imagens, como est descrito na seo Imagens Rasterizadas.

10.4.3

O Formato PostScript e as Imagens Rasterizadas

Se o seu sistema permitir o shell-escape, o Kile tambm suporta uma forma simples de incluir imagens rasterizadas, se voc congurar o seu sistema TE X convenientemente. No existe a necessidade de converter as imagens JPEG ou PNG, sendo que isto pode ser feito automaticamente quando o arquivo DVI for convertido para PS. O LA TE X necessita de alguma informao sobre os suxos de arquivos. O pacote graphicx ir procurar por um arquivo graphics.cfg, que dever estar em algum lugar no seu local de procura de documentos do LA TE X. Procure por itens do gnero:
\ DeclareGraphicsRule {. pz }{ eps }{. bb }{}% \ DeclareGraphicsRule {. eps .Z }{ eps }{. eps . bb }{}% \ DeclareGraphicsRule {. ps .Z }{ eps }{. ps . bb }{}% \ DeclareGraphicsRule {. ps . gz }{ eps }{. ps . bb }{}% \ DeclareGraphicsRule {. eps . gz }{ eps }{. eps . bb }{}%

e substitua estas linhas por:

\ DeclareGraphicsRule {. pz }{ eps }{. bb }{}% \ DeclareGraphicsRule {. eps .Z }{ eps }{. eps . bb }{}% \ DeclareGraphicsRule {. ps .Z }{ eps }{. ps . bb }{}% \ DeclareGraphicsRule {. ps . gz }{ eps }{. ps . bb }{}% % changed or new graphic rules \ DeclareGraphicsRule {. eps . zip }{ eps }{. eps . bb }{ unzip -p #1}% \ DeclareGraphicsRule {. eps . gz }{ eps }{. eps . bb }{ gunzip -c #1}% EPS \ DeclareGraphicsRule {. jpg }{ eps }{}{ convert #1 eps : -}% \ DeclareGraphicsRule {. gif }{ eps }{. bb }{ convert #1 eps : -}% \ DeclareGraphicsRule {. png }{ eps }{. bb }{ convert #1 eps : -}% \ DeclareGraphicsRule {. tif }{ eps }{. bb }{ convert #1 eps : -}% \ DeclareGraphicsRule {. pdf }{ eps }{. bb }{ convert #1 eps : -}% graphics

zipped EPS gzipped JPEG GIF PNG TIFF PDF -

No Debian, por exemplo, voc encontrar este arquivo em /etc/texmf/latex/graphics.cfg. A melhor forma de proceder copiar este arquivo para o local do seu tex e ento alterar este arquivo. Veja o manual do TE X para saber como obter uma lista das suas pastas do TE X. Com este arquivo de congurao, voc poder ser capaz de inserir imagens rasterizados e EPS comprimidos no LA TE X. O comando de converso dado pelo dvips. Quando voc olhar para o comando de converso, ir ver que no ser criado qualquer arquivo extra. O resultado do processo de converso diretamente encaminhado para o arquivo PS. A nica coisa que o LA TE X precisa saber o tamanho da imagem e, como tal, necessria a Caixa Envolvente, que fornecida pelo Kile. Algumas pessoas dizem que esta forma insegura; voc ter que decidir como ir funcionar. Em qualquer um dos casos, no ser necessria a caixa envolvente, uma vez que o Kile ir extrair esta informao de todos os tipos de imagens. 71

Manual do Kile

10.4.4

O PDFLA TE X e as Imagens EPS

Tal como foi dito, o PDFLA TE X no capaz de lidar com arquivos grcos EPS; contudo, os conversores como o epstopdf podero ajudar. A melhor forma incluir o pacote epstopdf, o que dever ser feito aps carregar o pacote graphicx.
\ usepackage [ pdftex ]{ graphicx } \ usepackage { epstopdf }

Agora voc j pode incluir imagens EPS, se executar o pdatex com a opo --shell-escape. Mas poderemos fazer ainda melhor e lidar tambm com arquivos EPS comprimidos com o zip e o gzip. Mais uma vez, voc ter que alterar o arquivo de congurao de imagens graphics. cfg, como descrito acima. Desta vez, o texto a procurar ser:
% pdfTeX is running in pdf mode \ ExecuteOptions { pdftex }%

e bastar apenas adicionar algumas linhas.

% pdfTeX is running in pdf mode \ ExecuteOptions { pdftex }% \ AtEndOfPackage {% \ g@addto@macro \ Gin@extensions {. eps .gz ,. eps . zip }% \ @namedef { Gin@rule@ . eps . gz }#1{{ pdf }{. pdf }{ gunzip -c #1 | epstopdf -f >\ Gin@base . pdf }}% \ @namedef { Gin@rule@ . eps . zip }#1{{ pdf }{. pdf }{ unzip -p #1 | epstopdf -f >\ Gin@base . pdf }}% }%

Com estas linhas, o PDFLA TE X ser capaz de lidar com os arquivos EPS e, provavelmente, no existiro mais dvidas no que diz respeito s imagens.

10.5

Documento-Mestre

Denir o seu documento como mestre permite-lhe trabalhar com arquivos separados, o que lhe concede um documento-pai (ou documento-mestre) e os documentos-lhos, compondo assim um trabalho completo. Depois de ter denido o seu documento-mestre, com o comando respectivo no menu Conguraes, todos os comandos do menu Ferramentas aplicar-se-o s a este documento, mesmo que esteja lidando com os documentos-lhos. Voc poder at fechar o documento-mestre.

10.6

Tratamento de Erros

Depois de ter compilado algo, o Kile d uma olhada nas mensagens de erros que foram geradas. Se ocorreram alguns erros ou avisos, eles so mostrados brevemente na janela de Registro e Mensagens. Voc pode dar uma olhada com ateno s mensagens ao selecionar a opo Criar Ver o Arquivo de Registro ou usando o atalho de teclado Alt-0. O registro gerado ento apresentado na janela de Registro e mensagens; os erros e os avisos cam ento realados.

72

Manual do Kile

Ver o registro Voc poder saltar facilmente de uma mensagem no arquivo de registro para outra com as opes Criar Aviso / Erro de LaTeX Anterior / Seguinte ou usando os botes correspondentes na barra de ferramentas. Para saltar para a linha do arquivo de LA TE X onde ocorreu o erro ou o aviso, clique neste na janela de Registro e Mensagens. O Kile ir lev-lo automaticamente para a linha correspondente.

10.7

O Modo de Vigiar Arquivo

Quando invocar a Construo Rpida, ir aparecer um visualizador depois da compilao. Se voc no estiver usando um visualizador incorporado, ser aberta uma nova janela de cada vez. Se voc estiver ajustando a aparncia do seu documento, poder invocar a Construo Rpida com bastante frequncia e ter vrias janelas de visualizao abertas na sua tela; para evitar esta confuso, poder ativar o modo para Vigiar o arquivo, o que ir evitar que a Construo Rpida lance um visualizador. Este modo obviamente intil com os visualizadores incorporados, uma vez que voc deve ainda fech-los antes de voltar a editar o documento e a recompilar.

73

Manual do Kile

Captulo 11

Navegar no Cdigo LATEX

11.1 Utilizar a Vista de Estrutura

A rea da Estrutura mostra a hierarquia do documento que est sendo criado no Kile e permitelhe navegar rapidamente por ela, mostrando a sua segmentao. Para navegar pelo seu documento, tudo o que precisa clicar em qualquer legenda, captulo, seo, sub-seo, etc., para que v para o incio da rea correspondente. Se voc incluiu um arquivo de LA TE X separado no seu cdigo com as marcas \input ou \in clude, estes arquivos caro referenciados na rea da Estrutura; se zer duplo-clique nos seus nomes, ir fazer com que o Kile abra o arquivo includo na janela do editor. A rvore da hierarquia tambm tem um ramo em separado para as legendas usadas no texto.

11.1.1

Usar o Menu de Contexto

A maioria dos itens nesta rea de estrutura possuem vrios itens no menu de contexto, os quais poder abrir com o boto direito do mouse. Assim, veja a rea de estrutura na imagem a seguir.

74

Manual do Kile

Voc ir encontrar algumas legendas, alguns itens de sees, dois ambientes de guras e trs imagens. Se voc clicar com o boto direito num dos itens de sees, ir aparecer um menu com alguns comandos teis. Todos os comandos, como o Selecionar, Apagar ou Comentar iro funcionar em todas as linhas que pertenam a esta seo.

Se clicar numa gura ou item de tabela, ir obter algumas aes relacionadas com as referncias, sendo que se clicar com o boto direito num item grco, ir apresentar alguns programas para abrir as imagens.

75

Manual do Kile

11.1.2

Atualizar a Vista de Estrutura

Para atualizar a sua rea da estrutura, voc poder tanto ir ao item Editar Atualizar Estrutura, pressionar F12 ou poder gravar o seu documento, o que far com que o Kile atualize a sua rea de Estrutura.

11.2

Favoritos

Os favoritos so a sua referncia para um segmento de texto ou uma linha no ambiente do Kile. Para usar um favorito, selecione uma linha especca do seu documento para a qual gostaria de ir, pressionando em Ctrl-B, para que o Kile adicione um favorito a esta linha. Em alternativa, voc poder tambm denir um favorito se selecionar uma linha e escolher o menu Favorito Denir o Favorito. Para remover todos os seus favoritos, selecione Favoritos Limpar Todos os Favoritos.

76

Manual do Kile

Captulo 12

Projetos
12.1 Trabalhar com Projetos

No Kile, voc poder criar e trabalhar com os projetos. Um projeto um grupo de documentos de LA TE X, BibTE X, grcos ou de outro formato que contenham toda a informao usada para criar o seu documento completo. Um projeto tpico seria um documento que consiste em vrios captulos, estando cada um deles escrito em arquivos .tex diferentes; todos eles poderiam ser includos num projeto, para tornar o documento inteiro mais fcil de gerenciar. Voc poder tambm guardar arquivos que no sejam de cdigo, como por exemplo as imagens, num projeto. As denies do projeto so salvas num arquivo especial com a extenso .kilepr. Um projeto adiciona as seguintes funcionalidades: Voc no precisa denir nenhum documento-mestre; o Kile far isto automaticamente. Os arquivos do projeto podero ser arquivados facilmente em conjunto com a opo Projeto Arquivar A rea dos Arquivos e Projetos mostra quais os arquivos que esto includos no projeto. Depois de abrir um projeto, todos os arquivos que foram abertos anteriormente sero restaurados com a codicao e realce originais. O completamento de cdigo funciona em todos os arquivos do projeto. O completamento de referncias funciona em todos os arquivos do projeto. O completamento de citaes funciona em todos os arquivos do projeto. Procurar em todos os arquivos do projeto. Indicar um comando de compilao e do makeidx personalizado. Voc poder encontrar todos os comandos relacionados com o projeto no menu Projeto. A, poder abrir, fechar e gerenciar os seus projetos.

12.2

Criar um Projeto

Para criar um projeto, selecione a opo Projeto Novo Projeto.... Sero pedidas as seguintes informaes para criar o seu projeto:

77

Manual do Kile

Ttulo do seu projeto. Nome do arquivo de projeto com a extenso .kilepr. Nome do arquivo. O tipo do arquivo a criar: Documento Vazio, Artigo, Livro, Carta, Relatrio, .... Quando preencher o campo do nome do arquivo, voc ter que incluir uma referncia relativa do local onde o arquivo .kilepr est guardado para o arquivo do documento em si.

12.3

A rea dos Arquivos e Projetos

A rea dos Arquivos e do Projeto um boto do menu lateral. Nesta rea, voc poder ver a estrutura do seu projeto, os seus arquivos e o nome do arquivo .kilepr que guarda a informao do projeto. As opes para adicionar, remover e modicar o seu projeto so feitas com a rea dos Arquivos e Projetos.

A rea dos Arquivos e Projetos

12.4

Adicionar e Remover Arquivos

Para adicionar um arquivo ao seu projeto, abra qualquer arquivo de TE X, clique com o boto direito no seu nome na rea dos Arquivos e Projetos e selecione a opo Adicionar ao Projeto. Se voc tiver vrios projetos abertos, aparecer uma janela na qual poder especicar qual arquivo de projeto deve ser adicionado. Voc poder tambm clicar com o boto direito sobre o nome do projeto na rea dos Arquivos e projetos e selecionar a opo Adicionar arquivos.... Ento, poder selecionar os seus arquivos numa janela.

78

Manual do Kile

Adicionar um arquivo a um projeto Para remover um arquivo de um projeto, clique com o boto direito do mouse nele e selecione a opo Remover o Arquivo. Isto no remove de fato o seu arquivo (e tambm no o fecha), mas s o retira da lista de arquivos contida no arquivo .kilepr.

12.4.1

Arquivar o seu Projeto

O Kile permite-lhe arquivar ou salvaguardar o seu projeto, gravando todos os seus arquivos num nico pacote (chamado normalmente de pacote TAR ou tarball). Para arquivar o seu projeto, clique com o boto direito no seu nome na rea dos Arquivos e Projetos ou selecione a opo Projeto Arquivar. Por padro, todos os arquivos de um projeto sero adicionados ao pacote. Se no quiser incluir um determinado arquivo no pacote, clique com o boto direito na rea dos Arquivos e Projetos e desligue a opo Incluir no Arquivo. As operaes de arquivo so realizadas atualmente com o comando tar a partir da pasta do projeto (onde se encontra o arquivo .kilepr).

12.5

Opes do projeto

O Kile tem algumas opes relacionadas com o seu projeto que podero ser denidas. Para alter-las, clique com o boto direito no ttulo do seu projeto e selecione as Opes do Projeto, onde poder ento alterar: O ttulo do seu projeto. As extenses padro dos arquivos. O documento-mestre. O comando de Compilao Rpida. As opes do makeidx. 79

Manual do Kile

12.6

Fechar um Projeto

Para fechar um projeto, selecione a rea Arquivos e Projetos na barra de ferramentas vertical, clique com o boto direito do mouse e selecione ento a opo Fechar. Isto ir fechar o seu projeto, todos os arquivos a ele associados e ir tambm adicionar o nome do projeto que fechou opo Abrir um Projeto Recente... do menu Projeto.

80

Manual do Kile

Captulo 13

Codicao do Documento
O editor Kile permite-lhe ler, converter e salvar o texto para a codicao que o seu documento necessita. Com isto, possvel, por exemplo, usar caracteres acentuados do Portugus, do Francs ou do Italiano em documentos do LA TE X. A seleo da codicao do seu documento poder ser feita de duas formas: Uma forma denir a codicao do documento usando o submenu Conguraes Congurar o Kile... Editor onde poder denir a codicao padro para todos os arquivos.

Uma segunda maneira denindo a codicao para o documento com a opo que usa ao criar um documento novo com o assistente. O LA TE X propriamente dito s compreende o ASCII, que representa um conjunto muito limitado de caracteres. Assim, no possvel usar diretamente os caracteres acentuados ou especiais. Para usar os caracteres acentuados, foi criada uma sintaxe especial, como por exemplo o \e para o . Existe um pacote que o ajuda nisto chamado inputenc, que includo no prembulo ao usar o comando \usepackage[latin1]{inputenc}, onde o argumento da opo a codicao que gostaria de usar (na maioria dos casos o utf8). Isto diz ao LA TE X para traduzir todos os s que digitar em \es antes da compilao. Por favor veja a documentao do inputenc diretamente para mais informaes sobre o inputenc. Por ltimo, mas no menos importante: lembre-se de conrmar que o seu arquivo est de fato codicado com a mesma codicao que indicou no inputenc! 81

Manual do Kile

Esta variedade de tabelas de codicao de caracteres diferentes tem criado muitos problemas: por exemplo, voc no pode escrever um curso de Turco em Francs, sem que perca os caracteres especiais de uma das lnguas. Existe um consenso geral de que, mais cedo mais tarde, todos iro mudar para o Unicode. Existem vrias implementaes do Unicode e a UTF-8 a mais bem sucedida no Linux ; o Windows (R) baseia-se na codicao mais estranha e menos exvel que a UCS-2. A maioria das distribuies j comearam a congurar a sua codicao padro como sendo a UTF-8, por isso voc poder estar bastante interessado em usar um argumento utf8 no pacote inputenc.

13.1

O Pacote ucs

Se voc no tiver o pacote ucs instalado, poder proceder da seguinte forma: Obtenha o pacote ucs do CTAN. Para o instalar, descomprima o pacote transferido e coloque-o numa pasta que conste da sua varivel de ambiente $TEXINPUTS. Isto poder tambm ser denido dentro do Kile.
\ usepackage { ucs } \ usepackage [ utf8 ]{ inputenc }

13.2

XeLaTeX

Se voc estiver usando o XeLaTeX, poder simplesmente carregar o xltxtra. Ele ir carregar adicionalmente todos os pacotes necessrios.
\ usepackage { xltxtra }

13.3

Suporte ao CJK

A adio do suporte para lnguas ideogrcas tem vrios truques. Contudo, logo que tenha conseguido, ir funcionar muito bem. Alm da instalao dos pacotes, necessria alguma congurao extra.

DICA
A sua distribuio de Linux poder j ter um pacote CJK (Chins, Japons, Coreano) pronto para voc, assim poder poupar o trabalho de instalar manualmente tudo. Verique antes de seguir em frente!

Existe a possibilidade de usar o pacote ucs para escrever alguns trechos de texto do CJK, mas essa opo seriamente limitada, uma vez que no lida, entre outras coisas, com mudanas de linha. Ser instalado em alternativa o pacote completo do CJK-LA TE X e ser posto funcionando tanto para o LA TE X como para o PDFLA TE X. Muito material deste inspirado pela pgina de Pai H. Chou sobre como congurar o PDFLATEX. 1. Obtenha o pacote do CJK. Copie os seus arquivos descomprimidos para uma subpasta apropriada do $TEXMF, tal como fez com o pacote ucs anterior (veja em Seo 13.1). Os arquivos sero extrados para uma pasta CJK/X_Y.Z; no importante que os retire, ainda que seja mais limpo e fcil para manter. 82

Manual do Kile

2. Agora, voc ter que obter um tipo de fonte que suporte todos os caracteres do CJK que necessita. Poder escolher qualquer arquivo *.ttf que os cubra mas, neste caso, ser usado o Cyberbit. Descomprima o arquivo e mude o nome de Cyberbit.ttf para cyberbit.ttf, uma vez que as maisculas podero confundir o seu sistema. Coloque o cyberbit.ttf numa pasta em conjunto com o Unicode.sfd e gere os arquivos *.tfm e *.enc com o comando $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Por algumas razes, isto s vezes poder no produzir as centenas de arquivos que deveria produzir. Se for esse o caso, poder obter tanto os arquivos *.tfm como os *.enc. Coloque os arquivos *.tfm numa pasta apropriada, como por exemplo $TEXMF /fonts/ tfm/bitstream/cyberbit/ ; os arquivos *.enc podero estar instalados na pasta $TEXMF /pdftex/enc/cyberbit/ . 3. Agora, necessrio um arquivo de mapa para ligar os arquivos *.enc ao tipo de fonte. Obtenha o cyberbit.map e instale-o em $TEXMF /pdftex/config/ . 4. Obtenha outro arquivo, o c70cyberbit.fd e coloque-o numa pasta apropriada. Voc poder escolher, por exemplo, o $TEXMF /tex/misc/ . 5. O ltimo arquivo que ter que ser gerado um tipo de fonte PostScript Type 1, que necessrio para ler os arquivos DVI gerados com o LA TE X. Execute o comando $ ttf2pfb cyberbit.ttf -o cyberbit.pfb e copie o arquivo resultante cyberbit.pfb numa pasta como a $TEXMF /fonts/type1/cyberbit/ . 6. Coloque ento o cyberbit.ttf entre os tipos de fonte, onde o LA TE X o possa encontrar. Voc poder coloc-lo numa pasta chamada $TEXMF /fonts/truetype/ . 7. Verique o arquivo de congurao encontrado em $TEXMF/web2c /texmf.cnf e certiquese de que a linha que menciona o TTFONTS est sem comentrios e aponta para a pasta onde salvou o cyberbit.ttf. 8. Para permitir ao PDFLA TE X usar os seus tipos de fonte do CJK, necessrio que adicione uma linha ao arquivo de congurao $TEXMF /pdftex/config/pdftex.cfg. Adicione o texto map +cyberbit.map no arquivo para completar a congurao no PDFLA TE X. 9. Para congurar o LA TE X de modo a que possa produzir arquivos DVI com caracteres do CJK, voc ter que adicionar uma linha ao arquivo ttfonts.map. O arquivo poder estar numa pasta chamada $TEXMF /ttf2pk/ , mas voc poder ter que procurar por ela. Adicione a linha cyberbit@Unicode@ cyberbit.ttf a ele. 10. Agora, voc s ter que rodar o texhash para que o sistema que pronto. Para testar se a sua congurao cou correta, voc poder tentar compilar este arquivo de teste.

13.3.1

Resoluo de Problemas com CJK

Existem vrias coisas que podero correr mal ao congurar o suporte para o CJK manualmente. Se algo parecer no funcionar, a seguinte lista poder ajud-lo. Obviamente, uma vez que voc executa o LA TE X como um usurio normal e no como root, dever permitir aos usurios normais acessarem aos arquivos novos. Certique-se de que todas as pastas e arquivos esto acessveis com o comando chmod. Se o LA TE X escrever um DVI sem problemas, mas no conseguir v-lo, bem provvel que seja devido a algum problema na gerao automtica dos arquivos de tipos de fonte *.pk. Supostamente, eles so gerados em tempo real ao se visualizar um arquivo DVI, mas isto poder correr mal por um conjunto de razes: verique bem o ttfonts.map procura da sua linha personalizada, em primeiro lugar. Contudo, poder acontecer que o seu comando ttf2pk, que invocado normalmente pelo visualizador de DVIs, tenha sido compilado sem o suporte para as bibliotecas do kpathsea. Se for este o caso, o ttf2pk--version no far meno alguma ao kpathsea. Como o suporte para estas bibliotecas necessrio, voc poder ter que encontrar um novo pacote ou recompilar voc mesmo o FreeType 1. 83

Manual do Kile

13.3.2

Como eu insiro caracteres do CJK em Unicode?

Existe um conjunto de diferentes motores de insero de dados, e a escolha poder tambm depender das preferncias pessoais. O autor usa o Skim, uma verso para o KDE do motor Scim. Veja na documentao da sua distribuio para aprender como instalar estes programas. A congurao dos mesmos poder tambm ser complicada; no caso do Skim, voc ter que denir uma varivel de ambiente XMODIFIERS=@im=SCIM antes de iniciar o X.

84

Manual do Kile

Captulo 14

Programao
14.1 Programao no Kile

A funcionalidade de programao do Kile permite a execuo de cdigo em ECMAScript, vulgarmente conhecido como JavaScript. Voc ir encontrar um enorme conjunto de tutoriais, que fornecem informaes sobre os objetos (variveis), funes e propriedades suportadas pelo JavaScript. O suporte de programao poder ser ativado na janela de congurao do Kile: Conguraes Congurar o Kile... Kile+Programao.

Se a programao estiver ativa, car visvel um painel de programao adicional na barra lateral, onde poder gerenciar os programas:

85

Manual do Kile

Este elemento contm seis cones, que oferecem diferentes tarefas: Executar o programa selecionado. Criar um novo programa. Abrir o programa selecionado no editor. Congurar uma sequncia de teclas para o programa selecionado. Remover uma sequncia de teclas atribuda. Atualizar a lista de programas disponveis, que poder ser encontrada em $KDEDIR /share/a pps/kile/scripts/ .

14.2

Executar um programa

Voc poder executar um programa de trs formas diferentes: 1. Selecione o programa desejado e clique no boto Executar do lado esquerdo do item de gerenciamento dos programas.

2. Usar um atalho de teclado.

86

Manual do Kile

Voc poder atribuir um atalho de teclado a um programa, usando o boto Congurar no item de gerenciamento dos programas.

3. Usar uma sequncia de teclas do editor. O programa ser executado se digitar a sequncia de teclas atribuda no editor.

Este mtodo poder ser estendido a um tipo de complementao relativamente sosticado. Iremos assumir que acabou de escrever um programa que insere simplesmente o comando de LA TE X \textbf{} no documento atual.
document . insertText ("\\ textbf {% C }") ;

Se voc agora digitar a sequencia de teclas atribuda bfx no seu documento de texto, esta sequencia de teclas ser removida e o programa ser executado. Ele ir inserir \textbf{} e o cursor colocado entre chaves.

realmente um mtodo confortvel e poderoso de completar cdigo.

14.3

Referncia da API

O programa da API apresentado aqui est disponvel para todos os programas. Antes de o contedo do programa ser carregado, o Kile inicialmente adiciona diversos prottipos e funes para o contexto de programao. Esta conveniente API contm prottipos como cursores de texto e intervalos de texto e est localizada na pasta KILE_APP_DIR/script-plugins/ . 87

Manual do Kile

Os programas do Kile diferem levemente dos programas do Kate, que usam outro desenho, uma vez que eles tambm podem ser iniciados a partir da linha de comando. Mas todas as funes da API de programao do Kate esto tambm disponveis no na API de programao do Kile, assim portar cdigo do JavaScript a partir do Kate para o to Kile deve ser muito simples. Mas uma vez que o Kile um editor de LA TE X com muitos recursos, sua prpria API de programao oferece muito mais possibilidades do que a do Kate. Comentrio: A descrio das chamadas da API que esto disponveis na programao do Kate foram retiradas da documentao do Kate.

14.3.1

Funes Globais

Esta seo apresenta as funes globais. void debug(String texto); Imprime o texto para o stdout no console. O texto impresso colorido para distingu-lo de outros dados de depurao.

14.3.2

O Prottipo do Cursor

Uma vez que o Kile um editor de texto, toda a API de programao baseia-se em cursores e intervalos sempre que possvel. Um Cursor um simples tuplo (linha, coluna) que representa uma posio de texto no documento. Cursor(); Construtor: Devolve um Cursor na posio (0,0). Exemplo: var cursor = new Cursor(); Cursor(int linha, int coluna); Construtor: Devolve um Cursor na posio (linha,coluna). Exemplo: var cursor = new Cursor(3,42); Cursor(Cursor outro); Construtor por cpia: Devolve uma cpia do cursor outro. Exemplo: var copia = new Cursor(outro); Cursor Cursor.clone(); Devolve um clone do cursor. Exemplo: var clone = cursor.clone(); bool Cursor.isValid(); Verica se o cursor vlido. O cursor invlido no caso em que a linha e/ou coluna sejam iguais a -1. Exemplo: var valido = cursor.isValid(); Cursor Cursor.invalid(); Devolve um novo cursor invlido que se localiza em (-1,-1). Exemplo: var cursorInvalido = cursor.invalid();

88

Manual do Kile

int Cursor.compareTo(Cursor outro); Compara este cursor com o cursor outro. Devolve -1, se este cursor se localizar antes do cursor outro, 0, se ambos os cursores forem iguais e +1, se este cursor se localizar depois do cursor outro. bool Cursor.equals(Cursor outro); Devolve true (verdadeiro), se este cursor e o cursor outro forem iguais, caso contrrio devolve false (falso). String Cursor.toString(); Devolve o cursor como uma sequncia de texto no formato Cursor(linha,coluna).

14.3.3

O Prottipo do Intervalo

Uma vez que o Kile um editor de texto, toda a API de programao baseada em cursores e intervalos, sempre que possvel. Como um Cursor um tuplo (linha, coluna) simples representando uma posio de texto no documento, um Intervalo estende o texto de uma posio inicial do cursor at uma posio nal do cursor. Range(); Construtor: Se invocar new Range(), ir obter um intervalo Range de (0,0) - (0,0). Range(Cursor inicio, Cursor fim); Construtor: A invocao de new Range(incio, fim) devolve o intervalo do cursor incio at ao cursor fim. Range(int linhaInicial, int colunaInicial, int linhaFinal, int colunaFinal); Construtor A invocao de new Range(linhaInicial, colunaInicial, linhaFinal, col unaFinal) devolve um intervalo Range de (linhaInicial, colunaInicial) at (linhaFinal, colunaFinal). Range(Range outro); Construtor por cpia: Devolve uma cpia do intervalo Range outro. Range Range.clone(); Devolve um clone do intervalo. Exemplo: var clone = intervalo.clone(); bool Range.isValid(); Devolve true (verdadeiro), se tanto o cursor de incio como o de m forem vlidos, caso contrrio devolve false (falso). Exemplo: var valido = intervalo.isValid(); bool Range.invalid(); Devolve o intervalo Range de (-1,-1) at (-1,-1).

89

Manual do Kile

bool Range.contains(Cursor cursor); Devolve true (verdadeiro) se este intervalo contiver a posio do cursor, caso contrrio devolve false. bool Range.contains(Range outro); Devolve true (verdadeiro) se este intervalo tiver dentro dele o intervalo outro, caso contrrio false (falso). bool Range.containsColumn(int coluna); Devolve true (verdadeiro), se a coluna est no intervalo semi-aberto [incio.coluna, fi m.coluna), caso contrrio devolve false (falso). bool Range.containsLine(int linha); Devolve true (verdadeiro), se a linha est no intervalo semi-aberto [incio.linha, fim. linha), caso contrrio devolve false (falso). bool Range.overlaps(Range outro); Devolve true (verdadeiro) se este intervalo e o outro compartilharem uma regio em comum, caso contrrio devolve false (falso). bool Range.overlapsLine(int linha); Devolve true, se a linha estiver no intervalo [incio.linha, fim.linha], caso contrrio false. bool Range.overlapsColumn(int coluna); Devolve true, se a coluna estiver no intervalo [incio.coluna, fim.coluna], caso contrrio false. bool Range.equals(Range outro); Devolve true se este intervalo e o outro forem iguais, caso contrrio devolve false. String Range.toString(); Devolve o intervalo como um texto no formato Range(Cursor(linha,coluna) - Cursor(l inha,coluna)).

14.3.4

A API do View

Sempre que um programa est sendo executado, existe um objeto global (varivel) view representando a viso do editor atualmente ativo. Todas as funes do view trabalham com posies do cursor ou com o texto selecionado. A seguir apresentada uma lista de todas as funes disponveis do view. void view.backspace(); Efetua, de forma programada, o equivalente a pressionar a tecla Backspace. Cursor view.cursorPosition(); Devolve a posio atual do cursor na janela.

90

Manual do Kile

void view.setCursorPosition(int linha, int coluna); void view.setCursorPosition(Cursor cur Muda a posio atual do cursor para linha, coluna ou para o cursor indicado. void view.cursorLeft(); Move o cursor uma posio para trs no texto. void view.cursorRight(); Move o cursor uma posio para a frente no texto. void view.cursorUp(); Move o cursor uma linha para cima no texto. void view.cursorDown(); Move o cursor uma linha para baixo no texto. int view.cursorLine(); Devolve a linha onde o cursor est localizado atualmente. int view.cursorColumn(); Devolve a coluna onde o cursor est localizado atualmente. void view.setCursorLine(int linha); Muda a linha do cursor para a linha indicada. void view.setCursorColumn(int coluna); Muda a coluna do cursor para a coluna indicada. Cursor view.virtualCursorPosition(); Obtm a atual posio virtual do cursor. Virtual signica que o caractere de tabulao (TAB) vale por mltiplos caracteres, conforme congurado pelo usurio (por exemplo, um TAB equivale a 8 espaos). O posio virtual do cursor fornece acesso aos valores visveis pelo usurio da posio atual do cursor. bool view.hasSelection(); Devolve true (verdadeiro) se a janela contiver algum texto selecionado, caso contrrio devolve false. String view.selectedText(); Devolve o texto selecionado. Se no tiver nenhum texto selecionado, o texto devolvido vem vazio. Range view.selectionRange(); Devolve o intervalo de texto selecionado. O intervalo devolvido invlido, caso no esteja selecionado nenhum texto.

91

Manual do Kile

void view.setSelection(Range intervalo); Muda o texto selecionado para o intervalo indicado. void view.selectAll(); Seleciona todo o texto no documento. void view.clearSelection(); Limpa a seleo de texto atual, sem remover o texto. void view.removeSelectedText(); Remove o texto selecionado. Se a janela no tiver nenhuma seleo feita, isto no faz nada. void view.selectLine(); Seleciona o texto na linha atual. void view.selectLine(int linha); Seleciona o texto na linha indicada. void view.selectLines(int de, int ate); Seleciona o texto inteiro desde a linha de at linha ate. void view.selectWord(); Seleciona a palavra atual. Se no tiver sido encontrada nenhuma palavra na posio atual do cursor, no feito nada. void view.selectLatexCommand(); Seleciona o comando de LA TE X atual. Se no for encontrado nenhum comando na posio atual do cursor, no feito nada. void view.selectEnvironment(bool inside = false); Seleciona todo o texto do ambiente LA TE X atual. Se inside for false, o texto do ambiente incluindo as marcas envolventes do LA TE X \begin{...}...\end{...} ser selecionado, caso contrrio ser sem estas marcas. Se nenhum parmetro for fornecido, inside denido para false. void view.selectTexgroup(bool dentro = true); Seleciona o texto do grupo LA TE X atual. Se inside for true, somente o grupo de texto sem as chaves envolventes ser selecionado. Se nenhum parmetro for fornecido, inside denido para true. void view.selectMathgroup(); Seleciona o texto do grupo matemtico atual. void view.selectParagraph(bool wholeLines = true); Seleciona o texto inteiro do pargrafo de LA TE X atual. Se o parmetro linhasCompleta s for true, sero includas a primeira e ltima linhas do pargrafo na seleo por inteiro (incluindo o caractere de m-de-linha); caso contrrio, a seleo s ir conter caracteres no-brancos. 92

Manual do Kile

14.3.5

A API do Document

Sempre que um programa est sendo executado, existe um objeto global (varivel) document representando o documento ativo atual. A seguir apresentada uma lista de todas as funes disponveis para o document. void document.insertText(String texto); Insere o texto na posio atual do cursor.

void document.insertText(int linha, int coluna, String texto); void document.insertText(Cur Insere o texto na posio do cursor indicada.

bool document.removeText(int daLinha, int dacoluna, int ateLinha, int ateColuna); bool docum Remove o texto no intervalo indicado. Devolve true (verdadeiro), em caso de sucesso, ou false (falso), se o documento estiver no modo apenas para leitura. bool document.replaceText(Range intervalo, String texto); Substitui o texto do intervalo indicado pelo texto passado como parmetro. int document.lines(); Devolve o nmero de linhas do documento. int document.length(); Devolve o nmero de caracteres do documento. Range document.documentRange(); Devolve um intervalo que engloba todo o documento. Cursor document.documentEnd(); Devolve a posio de cursor do m do documento. String document.text(); Devolve todo o contedo do documento numa nica sequncia de texto. As mudanas de linhas so marcadas com o caractere de mudana de linha \n.

String document.text(int daLinha, int daColuna, int ateLinha, int ateColuna); String documen Devolve o texto no intervalo indicado. Recomenda-se que use a verso baseada nos cursores e nos intervalos, de modo a ter uma melhor visibilidade do cdigo-fonte. bool document.setText(String texto); Altera o texto do documento por inteiro. bool document.clear(); Limpa o texto no documento por inteiro.

93

Manual do Kile

String document.line(); Devolve a linha do texto atual no formato de texto. String document.line(int linha); Devolve a linha de texto indicada como uma sequncia de texto. O texto devolvido ca em branco, caso a linha pedida esteja fora do intervalo. int document.lineLength(); Devolve o comprimento da linha atual. int document.lineLength(int linha); Devolve o comprimento da linha. bool document.insertLine(String s); Insere o texto na linha atual. Devolve true em caso de sucesso, ou false, caso o documento esteja no modo apenas para leitura ou se a linha no estiver no intervalo do documento. bool document.insertLine(int linha, String s); Insere o texto na linha indicada. Devolve true (verdadeiro), em caso de sucesso, ou false (falso), caso o documento esteja apenas para leitura ou se a linha no estiver no intervalo do documento. bool document.removeLine(); Remove a linha de texto atual. Devolve true em caso de sucesso ou false se o documento estiver no modo apenas para leitura. bool document.removeLine(int linha); Remove a linha de texto indicada. Devolve true (verdadeiro), em caso de sucesso, ou false (falso), caso o documento esteja no modo apenas para leitura ou se a linha no estiver no intervalo do documento. bool document.replaceLine(String texto); Substitui o texto da linha atual pelo texto indicado. bool document.replaceLine(int linha, String texto); Substitui o texto da linha indicada pelo texto passado como parmetro. bool document.truncateLine(); Trunca a linha atual na coluna ou posio do cursor indicada. Devolve true em caso de sucesso ou false se a linha indicada no zer parte do intervalo do documento. bool document.truncate(int linha, int coluna); bool document.truncate(Cursor cursor); Trunca a linha indicada, na coluna ou posio do cursor indicadas. Devolve true (verdadeiro) em caso de sucesso ou false (falso) se a linha no estiver dentro do intervalo do documento.

94

Manual do Kile

String document.word(); Devolve a palavra na posio atual do cursor. Se no for encontrada nenhuma palavra nesta posio, o texto devolvido vem vazio. String document.wordAt(int linha, int coluna); String document.wordAt(Cursor cursor); Devolve a palavra na posio atual do cursor. Se no for encontrada nenhuma palavra na posio do cursor, o texto devolvido ser vazio. Range document.wordRange(); Devolve o intervalo da palavra na posio atual do cursor. Se no for encontrada nenhuma palavra, ser devolvido Range.invalid(), valor que poder ser testado com o Range.isVa lid(). String document.latexCommand(); Devolve o comando de LA TE X na posio atual do cursor. Se no for encontrado nenhum comando nesta posio do cursor, o texto devolvido estar em branco.

String document.latexCommandAt(int linha, int coluna); String document.latexCommandAt(Curs Devolve o comando de LA TE X na posio indicada pelo cursor. Se no for encontrado nenhum comando nesta posio, o texto devolvido estar vazio. Range document.latexCommandRange(); Devolve o intervalo do comando de LA TE X na posio atual do cursor. Se no for encontrado nenhum comando de LA TE X, devolvido Range.invalid(), o que poder ser testado com o Range.isValid(). String document.charAt(int linha, int coluna); String document.charAt(Cursor cursor); Devolve o caractere na posio do cursor indicada. String document.firstChar(int linha); Devolve o primeiro caractere na linha que no seja um espao em branco. O primeiro caractere encontra-se na coluna 0. Se a linha estiver em branco ou se s tiver espaos em branco, o texto devolvido est vazio. String document.lastChar(int linha); Devolve o ltimo caractere na linha que no seja um espao em branco. Se a linha estiver em branco ou se s tiver espaos em branco, o texto devolvido est vazio. bool document.isSpace(int linha, int coluna); bool document.isSpace(Cursor cursor); Devolve true (verdadeiro), se o caractere na posio indicada do cursor for um espao em branco, caso contrrio devolve false (falso). void document.insertBullet(); Insere um marcador do Kile. Lembre-se que voc pode facilmente saltar para o prximo marcador ou para o anterior. Isto tambm realar este marcador de modo que ele ser excludo automaticamente quando voc inserir sua primeira letra.

95

Manual do Kile

void document.nextBullet(); Salta para o prximo marcador no texto se houver algum. void document.previousBullet(); Salta para o marcador anterior no texto, se existir. bool document.hasEnvironment(); Devolve true se for encontrado um ambiente de LA TE X envolvente, caso contrrio devolve false. String document.environment(bool inside = false); Devolve todo o texto do ambiente envolvente do LA TE X. Se inside for false, o ambiente de texto incluindo as marcas envolventes do LA TE X \begin{...}...\end{...} ser devolvido, caso contrrio ser sem estas marcas. Se nenhum parmetro for fornecido, in side denido para false. Se nenhum ambiente for encontrado, o texto devolvido est vazio. Range document.environmentRange(bool dentro = false); Devolve o intervalo do ambiente envolvente do LA TE X. Se inside for false, o ambiente de texto incluindo as marcas envolventes do LA TE X \begin{...}...\end{...} ser devolvido, caso contrrio ser sem estas marcas. Se nenhum parmetro for fornecido, i nside denido para false. Se nenhum ambiente for encontrado, Range.invalid() retornado, o que pode ser testado com Range.isValid(). String document.environmentName(); Devolve o nome do ambiente de LA TE X envolvente, ou ento um texto vazio. void document.removeEnvironment(bool dentro = false); Remove o texto ao redor do ambiente LA TE X. Se inside for false, o texto do ambiente incluindo as marcas envolventes do LA TE X \begin{...}...\end{...} ser removido, caso contrrio ser sem estas marcas. Se nenhum parmetro for fornecido, inside denido para false. void document.closeEnvironment(); Insere uma marca de fecho do ambiente, caso esteja um ambiente de LA TE X aberto na posio atual do cursor. void document.closeAllEnvironments(); Insere marcas de fecho dos ambientes para todos os ambientes de LA TE X abertos que tenham sido encontrados na posio atual do cursor. bool document.hasTexgroup(); Devolve true se tiver sido encontrado um grupo de LA TE X envolvente na posio atual do cursor, caso contrrio devolve false. String document.texgroup(bool dentro = true); Devolve o texto do entorno do grupo LA TE X. Se inside for false, o texto do grupo LA TE X incluindo as chaves envolventes {...} ser devolvido, caso contrrio ser sem estas chaves. Se nenhum parmetro for fornecido, inside denido para false. O texto retornado vazio se nenhum texto envolvente do grupo LA TE X for encontrado na posio atual do cursor. 96

Manual do Kile

Range document.texgroupRange(bool dentro = true); Devolve o intervalo do grupo LA TE X envolvente. Se inside for falso, o intervalo incluindo as chaves envolventes {...} ser devolvido, caso contrrio ser sem estas chaves. Se nenhum parmetro for fornecido, inside denido para false. Se nenhum grupo for encontrado, Range.invalid() retornado, o que pode ser testado com Range.isValid(). void document.removeTexgroup(bool dentro = true); Remove o texto do grupo LA TE X envolvente. Se inside for false, o texto deste grupo LA TE X incluindo as chaves envolventes {...} ser removido, caso contrrio sem estas chaves. Se nenhum parmetro for fornecido, inside denido como false. bool document.hasMathgroup(); Devolve true se for encontrado um grupo matemtico de LA TE X na posio atual do cursor, caso contrrio false. String document.mathgroup(); Devolve o texto do grupo matemtico de LA TE X envolvente. O texto devolvido ser vazio se no for encontrado nenhum grupo matemtico de LA TE X na posio atual do cursor. Range document.mathgroupRange(); Devolve o intervalo do grupo matemtico envolvente do LA TE X. Se nenhum grupo for matemtico, Range.invalid() devolvido, que poder ser testado com Range.isValid(). void document.removeMathgroup(); Remove o texto do grupo matemtico de LA TE X envolvente. String document.paragraph(); Devolve o texto do pargrafo de LA TE X atual. Range document.paragraphRange(); Devolve o intervalo do pargrafo de LA TE X envolvente. void document.removeParagraph(); Remove o texto do pargrafo de LA TE X atual.

bool document.matchesAt(int linha, int coluna, String texto); bool document.matchesAt(Curso Devolve true se o texto indicado corresponder posio atual do cursor, caso contrrio devolve false. bool document.startsWith(int linha, String padrao, bool ignorarEspacos = true); Devolve true, se a linha inicia com padrao, caso contrrio false. O argumento ignorarEs pacos controla se os espaos em branco iniciais so ignorados. bool document.endsWith(int linha, String padrao, bool ignorarEspacos = true); Devolve true, se a linha termina com padrao, caso contrrio false. O argumento ignorar Espacos controla se os espaos em branco iniciais so ignorados. 97

Manual do Kile

int document.firstColumn(int linha); Devolve a primeira coluna sem espaos em branco na linha indicada. Se s existirem espaos em branco nessa linha, o valor devolvido -1. int document.lastColumn(int linha); Devolve a ltima coluna sem espaos em branco na linha indicada. Se s existirem espaos em branco nessa linha, o valor devolvido -1.

int document.prevNonSpaceColumn(int linha, int coluna); int document.prevNonSpaceColumn(C Devolve a coluna com caracteres no-brancos que comea na posio de cursor indicada e pesquisa para trs.

int document.nextNonSpaceColumn(int linha, int coluna); int document.nextNonSpaceColumn(C Devolve a coluna com caracteres no-brancos que comea na posio de cursor indicada e pesquisa para a frente. int document.prevNonEmptyLine(int linha); Devolve a primeira linha no-vazia que contm caracteres no-nulos, pesquisando depois para trs. int document.nextNonEmptyLine(int linha); Devolve a primeira linha no-vazia que contm caracteres no-nulos, pesquisando depois para a frente. void document.gotoBeginEnv(); Vai para o incio de um ambiente de LA TE X envolvente. void document.gotoEndEnv(); Vai para o m de um ambiente de LA TE X envolvente. void document.gotoBeginTexgroup(); Vai para o incio de um grupo de LA TE X envolvente. void document.gotoEndTexgroup(); Vai para o m de um grupo de LA TE X envolvente. void document.gotoNextParagraph(); Vai para o pargrafo de LA TE X seguinte. void document.gotoPrevParagraph(); Vai para o pargrafo de LA TE X anterior. void document.gotoNextSectioning(); Vai para a seo de LA TE X seguinte.

98

Manual do Kile

void document.gotoPrevSectioning(); Vai para a seo de LA TE X anterior. void document.gotoLine(int linha); Vai para a linha indicada. void document.insertChapter(); Insere um comando \chapter (ver tambm document.insertSection()). void document.insertSection(); Insere um comando \section. Da mesma maneira que selecionar a entrada de menu LaTeX Criando sees section, uma janela ser apresentada, aonde voc poder selecionar o ttulo e uma legenda opcional para este comando de criao de sees.

void document.insertSubsection(); Insere um comando \subsection (ver tambm o document.insertSection()). void document.insertSubsubsection(); Insere um comando \subsubsection (ver tambm o document.insertSection()). void document.insertParagraph(); Insere um comando \paragraph (ver tambm o document.insertSection()). void document.insertSubparagraph(); Insere um comando \subparagraph (ver tambm o document.insertSection()). void document.insertLabel(); Insere um comando \label. void document.insertReference(); Insere um comando \ref. Da mesma maneira que ocorre ao selecionar a entrada de menu LA TE X Referncias ref uma janela ser apresentada, aonde voc poder selecionar a partir de legendas j denidas, que so listadas em uma caixa combinada. 99

Manual do Kile

void document.insertPageref(); Insere um comando \pageref (ver tambm o document.insertReference()). void document.insertCitation(); Insere um comando \cite. void document.insertIndex(); Insere um comando \index. void document.insertFootnote(); Insere um comando \footnote. void document.comment(); Insere marcadores de comentrios para tornar o texto selecionado ou a linha atual um comentrio. void document.uncomment(); Remove os marcadores de comentrios da seleo ou da linha atual. void document.uppercase(); Coloca o texto selecionado ou a letra a seguir ao cursor em maisculas. void document.lowercase(); Coloca o texto selecionado ou a letra aps o cursor em minsculas. void document.capitalize(); Capitaliza (coloca a primeira letra em maisculas e as restantes em minsculas) o texto selecionado ou a palavra atual. void document.joinLines(); Junta as linhas da seleo atual. Duas linhas consecutivas so sempre separadas por um nico espao. void document.insertIntelligentNewline(); Insere uma mudana de linha inteligente (ver em Seo 5.11).

100

Manual do Kile

void document.insertIntelligentTabulator(); Insere uma tabulao inteligente (ver em Seo 5.12). void document.editBegin(); Inicia um grupo de edio para agrupar operaes a desfazer/refazer. Certique-se de invocar sempre o editEnd() tantas vezes quanto invoca o editBegin(). A invocao do ed itBegin() usa um contador de referncias interno, i.e., esta chamada pode ser encadeada. void document.editEnd(); Termina um grupo de edio. A ltima invocao do editEnd() (i.e., a correspondente primeira chamada do editBegin()) termina o passo de edio. StringList document.labelList(); Devolve todas as legendas como um StringList, que poder ser usado no JavaScript como uma lista de objetos. StringList document.bibitemList(); Devolve todos os itens bibliogrcos como um StringList, que poder ser usada no JavaScript como uma lista de objetos. void document.refreshStructure(); Atualiza a rea da estrutura (ver em captulo 11).

14.3.6

A API do Kile

O objeto global (varivel) kile usado para manipular interaes de alto nvel com o mundo externo, mensagens de entrada e interfaces de janelas. Estas chamadas de API so divididas em subobjetos para estruturar esta parte da programao da API. Conceitualmente, o kile um pouco como a janela em um navegador de API. kile.alert: janelas de mensagens kile.input: obter dados do usurio kile.wizard: invoca um dos assistentes do Kile kile.script: obter informaes sobre um programa em execuo kile.file: operaes de arquivos, como a leitura ou escrita 14.3.6.1 Alerta

void kile.alert.information(String texto, String titulo); Exibe uma janela de Informaes. O texto o texto da mensagem e o titulo o ttulo da caixa de mensagem. O ttulo padro o nome do programa. void kile.alert.sorry(String texto, String titulo); Exibe uma janela de Alerta. O texto o texto da mensagem e o titulo o ttulo da caixa de mensagem. O ttulo padro o nome do programa.

101

Manual do Kile

void kile.alert.error(String texto, String titulo); Exibe uma janela de Erro. O texto o texto da mensagem e o titulo o ttulo da caixa de mensagem. O ttulo padro o nome do programa. String kile.alert.question(String texto, String titulo); Exibe uma janela de pergunta. O texto o texto da mensagem e o titulo o ttulo da caixa de mensagem. O ttulo padro o nome do programa. O texto retornado sim ou no. String kile.alert.warning(String texto, String titulo); Exibe uma janela simples de alerta. O texto o texto da mensagem e o titulo o ttulo da caixa de mensagem. O ttulo padro o nome do programa. O texto retornado continuar ou cancelar. 14.3.6.2 Entrada

String kile.input.getListboxItem(String titulo, String legenda, StringList lista); Funo que permite ao usurio selecionar um item a partir de uma lista, que exibida como uma caixa de listagem. O titulo o texto que exibido na barra de ttulo, a legenda o texto que aparece como a legenda da lista e a lista a lista de texto que inserida na lista. String kile.input.getComboboxItem(String titulo, String legenda, StringList lista); Funo que permite ao usurio selecionar um item a partir de uma lista, que exibida como uma caixa combinada. O titulo o texto que exibido na barra de ttulo, a legenda o texto que aparece como a legenda da lista e a lista a lista de texto que inserida na lista. String kile.input.getText(String titulo, String legenda); Funo para obter uma sequncia de texto do usurio. O titulo o texto que apresentado na barra de ttulo e a legenda o texto que aparece como legenda do campo de texto. String kile.input.getLatexCommand(String titulo, String legenda); Funo para obter um comando de LA TE X do usurio. Isto signica que s so permitidas letras maisculas e minsculas. O titulo o texto que apresentado na barra de ttulo e a legenda o texto que aparece como legenda do campo de texto.

int kile.input.getInteger(String titulo, String legenda, int min = INT_MIN, int max = INT_MAX Funo para obter um inteiro do usurio. O titulo o texto que exibido na barra de ttulo. A legenda o texto que aparece como legenda da caixa de contagem. O min e max so os valores mnimos e mximos permitidos que o usurio escolha. Os valores padro so INT_MIN e INT_MAX. int kile.input.getPosInteger(String titulo, String legenda, int min = 1, int max = INT_MAX); Funo para obter um inteiro positivo do usurio. O titulo o texto que exibido na barra de ttulo. A legenda o texto que aparece como legenda da caixa de contagem. O min e max so os valores mnimos e mximos permitidos que o usurio escolha. Os valores padro so 1 e INT_MAX.

102

Manual do Kile

14.3.6.3

Assistente

void kile.wizard.tabular(); Invoca o Assistente de tabelas, que ajuda a criar um ambiente para o efeito (ver em Seo 7.3). void kile.wizard.array(); Invoca o Assistente de listas, que o ajuda a criar um ambiente de listas (ver em Seo 7.3). void kile.wizard.tabbing(); Invoca o Assistente de separadores, que o ajuda a criar um ambiente de separadores (ver em Seo 7.3). void kile.wizard.floatEnvironment(); Invoca o Assistente de utuantes, que o ajuda a criar um ambiente de elementos utuantes (ver em Seo 7.4). void kile.wizard.mathEnvironment(); Invoca o Assistente matemtico, que o ajuda a criar um ambiente de elementos utuantes (ver em Seo 7.5). void kile.wizard.postscript(); Invoca o Assistente de ferramentas PostScript, que o ajuda a manipular ou reorganizar documentos em PostScript (ver em Seo 7.6). 14.3.6.4 Programa

String kile.script.name(); Devolve o nome de base de um programa em execuo (sem pasta nem extenso). String kile.script.caption(); Devolve um texto para poder ser usado como ttulo de janelas de alerta. Parece-se com o Script: scriptname.js. 14.3.6.5 Arquivo

Object kile.file.read(String arquivo); L o contedo de um arquivo de texto. usado da seguinte forma Exemplo: var res = kile.file.read(local/do/arquivo.txt); O valor devolvido res um objeto (um dicionrio) com trs propriedades: status: Fornece o estado do cdigo da operao, que pode ser 0 (sem erros), 1 (falha de acesso) ou 2 (acesso negado). Assim, se nenhum erro ocorrer, o valor de res.status ou res[status] ser 0. result: Contm o texto do arquivo indicado. message: Contm uma mensagem de erro, caso tenha ocorrido algum.

103

Manual do Kile

Object kile.file.read(); Como o read(arquivo), mas sem indicar qualquer arquivo. Ir aparecer uma janela que lhe permite selecionar o arquivo a ler. Object kile.file.write(String arquivo, String texto); Grava o texto indicado num arquivo. usado da seguinte forma Exemplo: var res = kile.file.write(local/do/arquivo.txt,Algum texto... ); O valor devolvido res um objeto (de fato, um mapa) com duas propriedades: status e message (ver o read() para mais informaes). Object kile.file.write(String texto); Como o write(arquivo,texto), s que no indicado nenhum arquivo. Ir aparecer uma janela para o escolher. String kile.file.getOpenFileName(String pastaInicial, String filtro); Cria uma janela de arquivos modal e devolve o arquivo selecionado ou um texto vazio se nenhum arquivo tiver sido selecionado. Lembre-se que, com este mtodo, o usurio dever selecionar um arquivo existente. Parmetros: pastaInicial: A pasta onde iniciada a janela de abertura. ltro: Um padro de console ou um ltro de tipos MIME que indica os tipos de arquivos a mostrar. Veja a documentao do KFileDialog para obter mais informaes sobre este parmetro. Ambos os parmetros so opcionais. Se voc omitir o filtro, todos os arquivos sero exibidos. Se omitir tambm o pastaInicial, a janela usar a pasta atual do documento como ponto inicial. String kile.file.getSaveFileName(String pastaInicial, String filtro); Cria uma janela de arquivos modal e devolve o arquivo selecionado ou um texto vazio se nenhum arquivo tiver sido selecionado. Lembre-se que, com este mtodo, o usurio no precisa de selecionar um arquivo existente. Veja o getOpenFileName() para obter uma explicao dos parmetros.

14.4

Exemplos

Alguns exemplos podero ajudar a compreender como usar a API de programao. Estes exemplos, bem como outros mais, encontram-se na pasta de programao do Kile: KILE_APP_DIR/scr ipts/ . Cada programa contm uma breve descrio.

14.4.1

Exemplo 1: substituir o nome do ambiente

Substitui o ambiente LA TE X envolvente com outro, onde a posio relativa do cursor no ser modicada. O \begin{abc}...\end{abc} por exemplo pode ser alterado para \begin{xy z}...\end{xyz}.

104

Manual do Kile

var intervalo = document . environmentRange ( false ); if ( intervalo . isValid () ) { var nomeAmb = kile . input . getLatexCommand (" Insira o ambiente " ," Nome do novo ambiente :") ; if ( nomeAmb != ) { replaceEnvCommand ( nomeAmb , intervalo ); } } else { kile . alert . sorry (" Nenhum ambiente LaTeX envolvente encontrado .") ; } function replaceEnvCommand ( novoAmb ,r) { var c = view . cursorPosition () ; var nomeAmb = document . environmentName () ; if ( nomeAmb != "" ) { var iniIntervalo = new Range (r. start , new Cursor (r. start . line ,r. start . column +8+ nomeAmb . length )); var fimIntervalo = new Range ( new Cursor (r. end . line ,r. end . column -6 - nomeAmb . length ) ,r. end ); document . editBegin () ; document . replaceText ( fimIntervalo ,"\\ end {"+ novoAmb +"}") ; document . replaceText ( iniIntervalo ,"\\ begin {"+ novoAmb +"}") ; document . editEnd () ; } }

14.4.2

Exemplo 2: substituir um comando de fonte do LA TE X

Substitui o comando de fonte do LA TE X envolvente com outro comando de fonte, quando o cursor posicionado dentro do grupo de texto. A posio relativa do cursor no ser alterada. O \textbf{abc} por exemplo pode ser alterado para \textit{abc}.
var comandosFonte = new Array ("\\ textbf " ,"\\ textit " ,"\\ textsl " ,"\\ texttt ", "\\ textsc " ,"\\ textrm " ,"\\ textsf " ,"\\ emph ") ; var intervalo = document . texgroupRange ( false ); if ( intervalo . isValid () ) { replaceFontCommand ( intervalo ); } else { kile . alert . sorry (" Nenhum grupo TeX envolvente encontrado .") ; } function replaceFontCommand (r) { var c = view . cursorPosition () ; document . editBegin () ; view . setCursorPosition (r. start ); var cmd = document . latexCommand () ; var index = comandosFonte . indexOf ( cmd );

105

Manual do Kile

if ( index >= 0 ) { var cmdRange = document . latexCommandRange () ; if ( cmdRange . isValid () ) { var novocomando = kile . input . getListboxItem (" Selecione ", " Selecione o comando de fonte :" , buildCmdList ( cmd )); if ( novocomando != "" ) { document . replaceText ( cmdRange , newcommand ); c. column = c. column - ( cmd . length - novocomando . length ); } } view . setCursorPosition (c); } else { kile . alert . sorry (" Nenhum comando de fonte envolvente encontrado .") ; } document . editEnd () ; } function buildCmdList ( current ) { var resultado = new Array () ; for ( i =0; i < comandosFonte . length ; ++ i ) { if ( comandosFonte [i] != current ) { result . push ( comandosFonte [i ]) ; } } return resultado ; }

14.4.3

Exemplo 3: envolver texto selecionado

Envolve o texto selecionado com um comando TeX, onde a posio relativa do cursor no ser alterada. O abc por exemplo pode ser alterado para \texcommand{abc}.
var intervalo = view . selectionRange () ; if ( intervalo . isValid () ) { var cmd = kile . input . getLatexCommand (" Selecionar " ," Selecione o comando LaTeX envolvente :") ; if ( cmd != "" ) { surroundTexCommand ("\\"+ cmd , range ); } } else { kile . alert . sorry (" Nenhuma seleo encontrada .") ; } function surroundTexCommand (cmd ,r) { var c = view . cursorPosition () ;

106

Manual do Kile

document . editBegin () ; view . clearSelection () ; document . insertText (r.end ,"}") ; document . insertText (r. start , cmd +"{") ; c. column = c. column + cmd . length + 2; view . setCursorPosition (c); document . editEnd () ; }

107

Manual do Kile

Captulo 15

Ajuda
15.1 Documentos de ajuda

O LA TE X um sistema relativamente sosticado, onde as funcionalidades bsicas podero ser expandidas com uma grande variedade de pacotes adicionais. O Kile oferece diversas maneiras de ajudar o usurio. Referncia LaTeX Um ndice alfabtico dos comandos LA TE X mais comuns. Documentao TeX teTE X/TeX Live vm com uma quantidade enorme de documentos. Isto inclui uma documentao para todos os pacotes inclusos e uma referncia LA TE X adicional. LaTeX Uma referncia completa para o TE X e os seus amigos. Isto no s uma descrio de todos os programas, mas alguns pacotes importantes so tambm mencionados. Inclui tambm um manual de referncia completo dos comandos do LA TE X - o que ideal para procurar por uma determinada pea de formatao, ao escrever um documento. Uma vez que este documento realmente extenso, ele referenciado no Kile por trs marcadores. Comando LaTeX Outro ndice alfabtico dos ambientes LA TE X mais comuns. Assunto LaTeX Uma descrio de importantes assuntos do LA TE X. Ambiente LaTeX Um ndice alfabtico dos ambientes LA TE X mais comuns.

15.2

Ajuda sensvel ao contexto

O Kile suporta tambm uma ajuda dependente do contexto, a qual invocada com o comando Ctrl+Alt+HK. Em Conguraes Congurar o Kile... Kile Ajuda, voc poder escolher se deseja usar a referncia de LA TE X do Kile ou o sistema de ajuda do teTE X/TeX Live, o qual tambm a congurao padro.

108

Manual do Kile

15.3

Pesquisando por palavras-chave

Nem sempre fcil procurar o documento correto, uma vez que o teTE X/TeX Live vem com uma quantidade enorme de documentos. Para facilitar este processo, o teTE X/TeX Live oferece um programa minsculo chamado texdoctk. Ele vem com uma base de dados com todos os documentos, para a qual o Kile oferece uma interface amigvel.

Todos os documentos so agrupados em categorias. Alm disso, voc poder procurar pelos nomes dos pacotes e por palavras-chave. O Kile ir ento mostrar apenas os resultados que corresponde ao texto de busca.

109

Manual do Kile

Fazer um duplo-clique com o mouse ou pressionar a tecla Espao, ir iniciar o visualizador para o documento selecionado. Isto poder ser um documento qualquer, no apenas um documento DVI, PS, PDF ou HTML. O Kile ir usar a congurao do KDE para iniciar um visualizador apropriado.

15.4

Ajuda denida pelo usurio

Alm desta documentao esttica do teTE X/TeX Live, o Kile suporta uma maneira mais exvel de documentao de ajuda ao usurio. No menu Ajuda, o Kile suporta um submenu especial Ajuda do usurio, onde o usurio poder adicionar documentos sua escolha. Estes podero ser os documentos mais importantes da documentao do teTE X/TeX Live, ou at mesmo documentos escritos pelo prprio usurio. tambm possvel inserir alguns URLs da Web. V para Conguraes Congurar o Kile... Kile Ajuda e escolha o boto Congurar para modicar este menu Ajuda do usurio. Voc poder adicionar, remover ou mover os itens do menu, assim como inserir separadores para otimizar a estrutura do menu.

110

Manual do Kile

Se clicar no boto Adicionar, ir obter outra janela, onde poder editar o nome do item do menu e escolher o arquivo ou URL correspondente. O segundo boto direita do campo de texto inicia o Konqueror, que pode ser usado para determinar a URL correta.

Depois de terminar a congurao, todos os itens escolhidos iro aparecer no menu Ajuda do Kile, como um item de menu especial chamado Ajuda do usurio.

111

Manual do Kile

112

Manual do Kile

Captulo 16

Crditos e licena
O Kile um editor de cdigo de LA TE X / TE X aberto e amigvel. Ele ir rodar nos sistemas que tenham o Ambiente de Trabalho KDE. O KDE est disponvel para vrias arquiteturas com o Linux e outros sistemas do tipo Unix instalados. Muito obrigado a todas as pessoas os que se esforam para prosseguir com o projeto do Kile e todos que sacricaram horas do seu tempo para desenvolver ferramentas que todos podero usar segundo a licena da GNU. Voc poder encontrar uma lista atualizada dos contribuintes na janela Sobre o Kile do menu de Ajuda. Muito obrigado a todos os envolvidos! Traduo de Marcus Gama marcus.gama@gmail.com e Rubens de Souza Matos Jnior rubens.matos@gmail.com Esta documentao licenciada sob os termos da Licena de Documentao Livre GNU. Este programa licenciado sob os termos da Licena Pblica Geral GNU.

113