# O Manual do &kile;

Jonathan
Pechta
Federico
Zenith

    federico.zenith@member.fsf.org

Holger
Danielsson

    holger.danielsson@versanet.de

Thomas
Braun
Michel
Ludwig

    michel.ludwig@kdemail.net

José
Pires

    zepires@gmail.com

Tradução
2003
Jonathan Pechta
2003
2005
2006
Federico Zenith
2005
2006
Holger Danielsson
2007
Thomas Braun
2007
Michel Ludwig
June 13, 2009
2.1
&FDLNotice;

O &kile; é um editor de código e uma linha de comandos de &tex; e &latex;.

KDE
kdenonbeta
Kile
LaTeX
TeX

## Prefácio

### Requisitos

To Run &kile;, you will be required to have the following components installed on your system:

- Ambiente de Trabalho K (&kde;): &kde; é um popular ambiente de trabalho "open source".

- &Qt;: o &Qt; é uma ferramenta de desenvolvimento em C++ necessária para compilar o &kile;.

- &latex;: um programa de formatação de documentos de alta qualidade. O mais provável é que você tenha o pacote &texlive; (ou o &tetex; nos sistemas mais antigos) se estiver num sistema semelhante ao Unix.

Alguns destes itens poderão estar incluídos na sua distribuição de &Linux;; por favor veja a documentação da sua distribuição ou veja o &CD; ou DVD de instalação da mesma para adicionar estes pacotes ao seu computador.

The &kile; project includes several binary packages of &kile; for different distributions that can be easily installed and run without having to compile; check out the &kile; homepage.

### Público Alvo

Este manual é destinado a qualquer indivíduo, independentemente da sua experiência com o &latex;, o &kde;, o &kile; ou o &Linux;.

Os utilizadores avançados provavelmente não irão ler este manual, mas todas as sugestões sobre a documentação serão tidas em consideração. Se quiser contribuir para este projecto ou para a documentação, por favor consulte a página Web do &kile;.

Need answers about &kile;? Are you stuck with your compile? Want to see a new feature? The preferred way to ask technical questions or start a discussion is to use our mailing list: kile-devel@lists.sourceforge.net.

## Introdução

### Factos básicos

#### Acerca do &kile;

&kile; is an integrated &latex; environment for the &kde; desktop. &kile; gives you the ability to use all the functionalities of &latex; in a graphical interface, giving you easy, immediate, and customized access to all programs for &latex; codecompletion, compiling, postprocessing, debugging, conversion and viewing tools; you also get very handy wizards, a &latex; reference and a powerful project management.

#### &kile; and &kate;

&kile; is based on &kate;, so a lot of editing capabilities come from &kate; and &kile; extends these capabilities to edit &latex; documents. To learn more about &kate; and its capabilities, see the &kate; Handbook. &kile; users should start reading from the chapters Working with the &kate; Editor and Configuring &kate;.

#### What is &latex;

&latex; is a text-processing system derived from &tex;, a program developed originally in 1977 by Donald Knuth to help him layout his work professionally, obtaining a work similar to a typesetter's; the typesetter is the professional that styles a document's look according to specifications for the type of document. &latex; was created by Leslie Lamport to give authors an automatic typesetter, especially when it came to the expensive and painstaking typesetting of mathematical formulas and expressions, that by no chance are enclosed in dollar signs in &latex;. Today, word-processing programs let any user be the typesetter; but what you often want is a document that looks good, not one that you spent hours on to make it look good. &latex; takes that burden, and lets you think of the document, not of the layout. And yes, it will look good!

#### Como é que se pronuncia? Porquê a formatação estranha?

There is a funny traditions of &tex;-related packages to have the strangest pronunciation and typesetting possible. &tex; was supposed to be brought in from the Greek τεχ, in Latin letters tech. There are a lot of explanations why, but most likely it is because &tex; was originally conceived for technical reports, and indeed its foremost ability was the correct and easy typesetting of mathematical formulae, then an extremely expensive, time-consuming and frustrating business.

The pronunciation is supposed to be as follows: T as you would expect, E as in get, and X as in the German ich. If you do not know what ch sounds like, it is more or less as an hissing cat; the IPA symbol is /ç/. Many people report the different pronunciation of ach (IPA symbol /x/), but I have personally asked some Greeks, and can confirm the first version. You should be aware that a lot of people mispronounce /teks/ or /tek/.

Last, in &latex; the first LA is pronounced as lay: the idea is that, while raw &tex; is difficult, even a layman can use &latex; macros. A less inspiring, but more realistic explanation is that it stems from the surname of Leslie Lamport, the creator of &latex;. Now you know!

### Introdução ao &latex;

The &latex; typesetting system is similar to other markup languages as &XML;, used for many types of documents (including the one you are reading), or &HTML;, used for web pages. The general idea is about having specially wrapped keywords, called tags, that tell a program (a word processor, a web browser, or the &latex; compiler) how to present text. &kile; offers you a good number of such tags in the menu LaTeX in the menu bar.

While we will try to give you a good idea of what &latex; is, this is not The Definitive Book on &latex;. If you want to learn &latex; well, you may want to loan a book in your library. The writer has had a good experience with A Guide to &latex; by H. Kopka and P. W. Daly, and still keeps it on the shelf.

As other markup languages, &latex; contains a preamble, which sets global commands, such as paper size, page numbering, dimensions of the text on the page, and a body, that contains the document text; the preamble contains at least the `\documentclass` command, and precedes the body, that starts with the command `\begin{document}`, and is quite predictably concluded by the command `\end{document}`.

### Características Principais do &kile;

#### Assistente de Arranque Rápido

O assistente de Introdução Rápida incorporado no &kile; é uma funcionalidade útil para começar a criar rapidamente documentos no &kile;. A selecção do assistente no menu dá-lhe várias opções para a criação do seu documento: artigo, livro, carta, relatório ou vazio. Poderá também indicar algumas opções relacionadas com o documento logo à partida.

Opções da 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 Letra: indique ao &kile; qual o tamanho de letra (em pontos) que irá usar.

- Tamanho do Papel: escolha o tamanho ou o estilo das folhas.

- Encoding: In general it is a good idea to use your systems standard encoding. Modern systems now move more and more to UTF-8 as the standard encoding. If you can, use utf8x (which is indeed the correct spelling for &latex; documents).

- Outras opções: isto permite-lhe definir mais opções como a impressão, os rascunhos, entre outras.

Pacotes

Esta lista apresenta alguns dos pacotes adicionais mais comuns para usar no &latex;. Seleccione a opção respectiva para o incluir.

Propriedades do Documento

- Autor: coloque aqui o seu nome.

- Título: adicione aqui o título do seu documento.

- Data: defina a data.

#### Modelos Predefinidos

Os modelos predefinidos no &kile; são:

- Documento vazio: os verdadeiros adeptos começam do zero!

- Artigo: define o formato do artigo para um documento que seja curto o suficiente para não ser dividido em capítulos.

- Report: sets the report format, for a middle-sized document, with for example page numbering on the page's outer edge.

- Livro: define o formato de um livro, uma variante completa, tão poderosa que é usada para escrever vários textos de livros universitários.

- Letter: sets the letter format, that can automatically do those nasty indentations that nobody really remembers.

- Beamer,HA-Prosper: create nice presentations in PDF with a superior look and all &latex; power.

- Powerdot: Powerdot is the follower of the packages `seminar` and `HA-Prosper`. It hasn't so much options like Beamer, but it is easy to use and creates really nice presentations in PDF.

- Scrartcl,Scrbook,Scrreprt,Scrlttr2: the KOMA-Script document classes, especially adapted to german typography. Use them whenever you write german texts.

- PDF: a modified `Article` template to use with `PdfLaTeX`.

- Xelatex: um modelo de `Article` modificado para usar com o `XeLaTeX`.

Remember that you can take all these templates as starting point for your own requirements.

New users need not to worry, this list is just a brief description of features, and more attention will be paid to complete these tasks in detail later in .

#### Realce de Sintaxe

&kile; is similar to programs that deal with source code and editing, and will automatically highlight commands, options and items that are used (and abused). &kile; makes it possible to spot easily problem areas: for example, if you see major areas of text turned green, it is likely that you forgot closing a math environment somewhere; you would have noticed anyway by how crappy the output file would have looked, but highlighting really saves you time and frustration.

#### Auto-Completação de Ambientes

A completação automática de ambientes significa que, quando você começar um novo ambiente com o comando `\begin{ambiente}`, o &kile; irá inserir automaticamente um `\end{ambiente}`, com uma linha entre eles para o seu texto. Você poderá, obviamente, desactivar esta opção se quiser na janela em Configuração Configurar o Kile...LaTeXAmbientes.

#### Saltar para Elemento Estrutural

Todos os documentos estão normalmente estruturados numa hierarquia de algum tipo. O &latex; permite-lhe repartir os documentos na hierarquia seguinte (sendo o 'part' o mais elevado na hierarquia e o 'subparagraph' o mais baixo):

- \part

- \chapter

- \section

- \subsection

- \subsubsection

- \paragraph

- \subparagraph

Ao ver um documento na área de Estrutura, poderá saltar entre elementos ao carregar no elemento que deseja ver.

#### Pesquisa Inversa

Ao criar os seus próprios ficheiros de &latex;, a pesquisa inversa poderá ser bastante útil. Logo que tenha criado um ficheiro &DVI; (DeVice Independent File - Ficheiro Independente do Dispositivo) ou PDF, ao carregar com o botão esquerdo do rato, enquanto carrega na tecla &Shift;, sobre o visualizador, o &kile; irá saltar para a linha correspondente no ficheiro de código em &latex;.

Um ficheiro &DVI; é um tipo de ficheiro que contém uma descrição de um documento formatado, em conjunto com outras informações, incluindo o tipo de letra do texto e é o resultado normal do &tex; ou do &latex;. Existe uma quantidade de utilitários para ver e imprimir os ficheiros &DVI; nos vários sistemas e dispositivos.

#### Pesquisa Normal

Ao usar a pesquisa inversa, a selecção dos itens no ficheiro &DVI; ou PDF está associada com o editor, por isso, quando carregar no ficheiro &DVI; ou PDF, a janela principal salta para a secção correspondente de código em &latex; do editor. A pesquisa normal é o oposto disto. A pesquisa normal permitir-lhe-á carregar numa dada secção de texto no código de &latex;, saltando para a posição associada na janela do visualizador de &DVI;s.

### A Barra de Ferramentas

- Novo: começa um novo documento.

- Abrir: abre um novo documento.

- Fechar: fecha o documento.

- Definir o documento como mestre: este é usado quando se lida com vários ficheiros. Se tiver um documento-mestre, poderá lidar mais facilmente com outros ficheiros `.tex` incluídos no seu documento. Se estiver a usar os projectos, poderá também definir um documento-mestre do projecto em Projecto->Opções do Projecto.

- Quickbuild: compiles your &latex; source code and displays the results automatically, unless you have code errors.

- Modo de vigia de ficheiros: este modo irá "vigiar" as alterações no ficheiro &DVI; e não irá lançar nenhuma sessão nova do &okular; após a Construção Rápida.

- Ver o ficheiro de registo: vê o ficheiro `.log`, onde poderá localizar erros.

- Previous error: jumps backward through the `.log` file and highlights errors in source.

- Next error: jumps forward through `.log` file and highlights errors in source.

- Parar: pára a ferramenta actual.

- LaTeX: executa o &latex; sobre o documento activo.

- Ver DVI: inicia o visualizador de &DVI;s.

- DVI para PS: converte o ficheiro &DVI; para &PostScript; (PS).

- Ver PS: iniciar o visualizador de &PostScript; (PS).

- PDFLaTeX: executa o &pdflatex; sobre o documento activo.

- Ver o PDF: inicia o visualizador de PDFs.

- DVI para PDF: converte um &DVI; para PDF.

- PS para PDF: converte um PS para PDF.

- Ver HTML: vê o &HTML; criado.

- Pesquisa Normal do DVI: salta para a página do ficheiro &DVI; que corresponde à linha actual no editor.

- Pesquisa Normal do PDF: salta para a página do ficheiro PDF que corresponde à linha actual no editor.

Se você olhar para a barra de ferramentas Editar, irá reparar em três 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 por partes, capítulos, secções e assim por diante; os comandos disponíveis para adicionar segmento ao seu código-fonte de &latex; são:

- part: o nível mais elevado de seccionamento de um documento.

- chapter: cria um novo capítulo.

- section: cria uma nova secção.

- subsection: cria uma nova subsecção.

- subsubsection: uma secção secundária entre a subsecção e o parágrafo.

- paragraph: cria um novo parágrafo.

- subparagraph: cria um novo sub-parágrafo.

A lista chamada label é usada para inserir itens no seu documento, como índices, notas de rodapé e referências; os comandos disponíveis são:

- label: um comando que produz uma legenda para um capítulo, uma figura ou outro elemento.

- index: cria uma entrada no índice.

- footnote: adiciona uma nota de rodapé ao documento.

- ref: é usado para se referir a uma legenda predefinida, a qual poderá escolher numa lista.

- pageref: tal como o ref, mas referindo-se a uma página em vez de um elemento da estrutura.

- cite: cria uma referência com dados de uma bibliografia.

- cite from ViewBib: ask the ViewBib tool for all selected references and insert them. Currently this is only available with &kbib; as ViewBib tool.

O menu Label
O menu Label

O menu Label

Seleccionar a legenda de uma referência
Seleccionar a legenda de uma referência

Seleccionar a legenda de uma referência

Ao usar o cite, ser-lhe-á apresentada uma lista de itens bibliográficos, mas se estiver a usar o &bibtex; isto só irá funcionar se o ficheiro pertencer a um projecto. Para editar ficheiros do &bibtex;, recomenda-se a utilização de editores especializados. O autor tem alguma boa experiência com o &kbibtex; e o &kbib;. Obviamente, poderá também escrever os ficheiros do &bibtex; à mão no &kile;.

A última lista chamada pequena é usada para indicar o tamanho do texto. Poderá definir o tamanho do texto principal, das notas de rodapé e assim por diante. Os comandos disponíveis são:

- tiny: o mais pequeno.

- scriptsize: muito pequeno.

- footnotesize: mais pequeno.

- small: pequeno.

- normalsize: normal.

- large: grande.

- Large: maior.

- LARGE: ainda maior.

- huge: muito maior.

- Huge: o maior.

## Arranque Rápido

### Escrever um Documento em &latex; com o &kile; para Principiantes

Os utilizadores do &kile; tem duas opções ao iniciar um documento novo: poderão usar o Assistente para iniciar um documento novo, seleccionar o tipo de documento que gostariam de criar e as opções como o tamanho da letra, do papel e assim por diante; caso contrário, poderão escrever o código à mão.

                    \documentclass[12pt]{article}
                    \begin{document}
                    Here is a bunch of text coded in \LaTeX.
                    \end{document}

Todos os documentos no &latex; começam pelo comando `\documentclass[argumento opcional]{classe}`, onde a classe define o tipo de documento.

A escrita do exemplo de código acima no campo de texto dar-lhe-á o seguinte resultado:

Texto compilado com resultado em &DVI;
Texto compilado com resultado em &DVI;

Texto compilado com resultado em &DVI;

Os parêntesis que vêm a seguir ao comando `\documentclass` contêm as opções para o comando. A opção `[12pt]` define o tamanho da letra para o seu artigo; se não definir o tamanho da letra no início, podê-lo-á fazer mais tarde no texto.

Logo que tenha escrito o exemplo de código no campo acima, terá de compilar o seu código-fonte de &latex;. A forma mais simples para você compilar o &latex; é usar o menu Criar ou usando o botão Criação Rápida.

O &Alt;2 é o atalho de teclado para compilar o seu código-fonte.

Terá de gravar o seu código-fonte antes de poder compilar; o &kile; fará isso automaticamente por si.

Se o seu documento não compilou, verifique os erros no registo. Ao usar a opção Criação Rápida, o visualizador &okular; deverá ser lançado automaticamente; se não o fizer, dê uma vista de olhos no registo.

### Ambientes

Um ambiente é um segmento de texto que é gerido de forma diferente do resto do documento. Por exemplo, você cria um relatório com um tamanho de letra 12, mas precisa de alterar o tamanho da sua letra para algumas frases. Os comandos `\begin{ambiente}`, `\huge` e `\end{ambiente}` permitir-lhe-ão alterar temporariamente o texto dentro dos comandos de controlo para ter um tamanho enorme.

As alterações só são efectivas desde o `\begin{ambiente}` até ao `\end{ambiente}`. Não existem limites para o número de alterações que poderá fazer dentro de um ambiente.

Existem várias funcionalidades que poderá adicionar ao seu documento que o poderão tornar mais legível e amigável. Você poderá adicionar funcionalidades como, por exemplo, tipos de letra diferentes, negritos, itálicos, sublinhados, &etc;, ao seu documento e estes comandos irão terminar com um comando `\end` ou no fim do seu ambiente.

- `\begin{emph}`: este comando coloca o texto em itálico e isto é válido até que o código passe por um `\end{em}`, `\end{emph}` ou outro ambiente. Para colocar uma palavra em itálico, poderá usar a sintaxe: esta é a `\em{minha}` frase.

- `\textbf{Vou tornar este texto dentro dos parêntesis negrito}`: este comando coloca o seu texto a negrito.

- `\quote`: para criar uma citação dentro do seu document; coloque a sua citação com um `\begin{quote}` e termine-a com um `\end{quote}`.

- `\center`: centra o texto.

- `\verse`: cria algum texto de deslocamento para poemas.

- `\itemize`: cria uma lista de itens.

### Utilizar o &kile;

Agora que já lhe foram dadas algumas bases sobre como escrever código com a linguagem de formatação &latex;, vai-se mostrar a si como criar um documento com o &kile;, passo-a-passo.

1. Inicie o &kile;.

2. Seleccione o Assistente Arranque Rápido, depois escolha um formato e defina as suas preferências no assistente.

3. Logo que o assistente tenha introduzido algum texto, faça algumas configurações para tornar o documento mais legível, adicione no mínimo uma citação, algum texto em negrito, itálico e um verso para ver a diferença entre os comandos.

4. Grave o seu ficheiro e dê-lhe o nome `intro.tex`.

5. Crie (compile) o seu documento com a sequência &Alt;2 ou com o botão intitulado LaTeX.

6. Seleccione Ver o DVI.

7. Verifique todo o novo texto.

8. Agora que você acabou de ver o seu documento, carregue no botão Janela do Editor ou carregue em &Ctrl;E para voltar ao editor se você estiver a usar o visualizador incorporado ou feche a janela de visualização se estiver a utilizar um programa separado.

É tudo! Acabou agora de criar o seu primeiro documento em &latex;!

Logo que tenha criado o seu &DVI;, você será capaz de imprimir o seu documento ou transformá-lo num ficheiro &PostScript; ou PDF se o desejar. Experimente e divirta-se!

### Ficheiros &DVI;

O &DVI; significa DeVice Independent ou Independente do Dispositivo. Estes ficheiros são produzidos pelo &tex; ou pelo &latex; para serem lidos por um controlador de determinado tipo no seu computador. Existem vários tipos de resultado para onde poderá ser enviado um ficheiro `DVI`, como uma impressora, um conversor para ficheiros &PostScript; ou PDF ou para o ecrã do seu computador.

#### Ver um &DVI;

Já acabou de ver como visualizar um ficheiro &DVI; com a opção Ver o DVI na barra de ferramentas.

#### Imprimir um &DVI;

To print a &DVI;, you can use the same process that you used to create your document earlier (see ). At step 7, after clicking ViewDVI, select File Print in the viewer, and if you have your printer properly configured, you will be able to print the &DVI;.

#### Converter os ficheiros &DVI;

A barra de ferramentas dá-lhe as opções para exportar um &DVI; para outros formatos. Logo que tenha criado um ficheiro &DVI; a partir do seu código-fonte em &latex;, será capaz de o exportar para um formato à sua escolha com os botões da barra de ferramentas.

### Pesquisa Normal entre o &kile; e o &okular;

As funções de pesquisa normal permitem-lhe saltar directamente do seu editor para a posição associada no ficheiro &DVI; ou PDF.

O &kile; oferece uma configuração com esta opção para todos os executáveis de &latex;. Vá a Configuração Configurar o Kile...FerramentasCompilar e escolha sempre a configuração `Moderna`.

Para executar uma pesquisa normal, posicione o cursor sobre uma linha de código e carregue em Pesquisa Normal para saltar para a posição associada na janela de visualização do &DVI; ou PDF.

### Pesquisa Inversa entre o &kile; e o &okular;

A pesquisa inversa é uma funcionalidade muito útil quando está a escrever um documento de &latex; você mesmo. Se tudo estiver configurado convenientemente, poderá carregar na janela do &okular; com o botão esquerdo do rato, enquanto carrega na tecla &Shift;. Depois disso, o &kile; irá abrir, carregar o ficheiro de código de &latex; e saltar para o parágrafo correspondente. Para usar a pesquisa inversa, terá de compilar o seu ficheiro de &latex; com a configuração Moderna.

A pesquisa inversa não poderá funcionar a menos que:

- O ficheiro de código tenha sido compilado com sucesso.

- O &okular; saiba qual o editor que desejaria usar.

Com esta funcionalidade do &okular;, um 'click' com o botão esquerdo do rato, enquanto mantém a tecla &Shift; carregada, no documento &DVI; ou PDF, fará com que o &kile; abra o documento de &latex; e tente ir para a linha correspondente. Lembre-se de indicar ao &okular; para usar o &kile; como um editor de texto, no item do &okular; Configuração Configurar o Okular... (na página Editor).

Configurar o &okular;
Configurar o &okular;

Configurar o &okular;

### Resolver Erros

Se você está a tentar usar a criação rápida e o visualizador do &DVI; não abrir, as hipóteses serão que você tenha um erro. Se for o caso, ele ficará visível na área de mensagens/ficheiros do registo e o resumo do erro será indicado.

O ficheiro de registo irá explicar a origem do erro no seu código. No editor, poderá usar os botões da barra de ferramentas Erro de LaTeX Anterior e Erro de LaTeX Seguinte para saltar de um erro para outro. O ficheiro de registo indica sempre em que linha ocorreu o erro. Para ver a linha em que ocorreu um determinado erro, carregue no erro na janela de registo, para que o &kile; o leve para essa linha.

## Iniciar um Novo Documento

Quando carregar no botão 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 por omissão são:

- Documento vazio

- Artigo

- Beamer

- Livro

- HA-Prosper

- Powerdot

- Carta

- Relatório

- Scrartcl (do pacote KOMA-Script)

- Scrbook (do pacote KOMA-Script)

- Scrlttr2 (do pacote KOMA-Script)

- Scrreprt (do pacote KOMA-Script)

- PDF

- XeLaTeX

If you selected an Empty document, you can either start writing a document from scratch, or you can use the wizard to quickly start a new document (see ).

### Modelos

Os utilizadores frequentes do &latex; usam tipicamente o mesmo preâmbulo para quase todos os documentos que usam. Os modelos poderão ser criados, gravados e carregados no &kile; para tornar mais fácil o início de um documento novo.

#### Criar um Novo Modelo

Para criar um modelo novo, você precisa de abrir primeiro um ficheiro &tex; / &latex; ou criar um ficheiro por si só. O &kile; poderá gerar um modelo a partir de um documento existente se abrir o documento desejado e seleccionar a opção Ficheiro Criar Modelo a Partir de Documento.

#### Configurar as Substituições Automáticas

Ao criar um novo documento através da selecção de um modelo na opção Ficheiro Novo, certas combinações de caracteres serão substituídas por alguns dados como o seu nome ou a codificação que estiver a usar. Estas variáveis poderão ser configuradas em Configuração Configurar o Kile...ConfiguraçãoGeral.

Ao desenhar o seu próprio modelo, é útil saber quais as combinações de caracteres que são substituídas por determinadas variáveis-modelo:

- `$$AUTHOR$$`: Este texto será substituído pela variável do autor.

- `$$DOCUMENTCLASSOPTIONS$$`: Este texto será substituído pela variável das opções do 'documentclass' (classe do documento). Tipicamente é usado da seguinte forma: `\documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}`.

- `$$INPUTENCODING$$`: Se a variável da codificação de entrada estiver configurada, por exemplo, como `latin1` este texto será substituído por `\input[latin1]{inputenc}`.

#### Criar Modelo utilizando o Assistente

A forma mais simples de criar um novo modelo é iniciar o assistente e adicionar então os comandos no editor. Logo que tenha o seu documento configurado da forma que desejar:

1. Grave o seu ficheiro;

2. Vá a Ficheiro;

3. Escolha Criar Modelo a partir do Documento;

4. Efectue quaisquer correcções necessárias ao modelo;

5. Indique um nome para o novo modelo;

6. Carregue em OK para adicionar o seu modelo ao menu.

Da próxima vez que iniciar um documento novo, será então capaz de escolher o seu modelo personalizado em vez dos modelos predefinidos.

#### Criar Modelo a partir de qualquer Ficheiro

A template can be created from any &latex; file. If you are looking for an easy way to configure a template, go find one you like on the Internet and follow the same steps listed in .

Por exemplo, poderá querer criar um poster completo em A0. Estes posters são normalmente vistos nas conferências científicas e o &latex; ajudá-lo-á a criar um poster bonito e interessante. Poderá obter um modelo para os posters em A0 na página pessoal de Jonathan Marchini, mas existem muitas mais disponíveis. Lembre-se que irá necessitar do pacote `a0poster`, o qual não está normalmente incluído numa distribuição normal do &tetex;, por isso terá de o obter a partir daqui e copiar para a mesma pasta que o seu ficheiro de &latex;.

#### Remover um Modelo

Para remover um modelo do &kile;, faça o seguinte:

1. Vá a Ficheiro Remover Modelo...;

2. Irá aparecer uma janela com todos os modelos listados: seleccione um deles;

3. Carregue em OK e o modelo será removido.

Os modelos marcados com um asterisco (*) não poderão ser removidos sem a devida permissão.

## Editar Documentos &latex;

O editor interno que o &kile; usa é o &kate;. O &kate; é um editor de texto criado para programadores e que incorpora a capacidade de ler e realçar vários tipos diferentes de ficheiros de texto, entre os quais o &latex; e o &bibtex;; poderá aceder a várias opções do &kate; directamente a partir do menu Ferramentas do &kile;.

Para aprender mais sobre o &kate; e as suas capacidades, veja o Manual do &kate;. Os utilizadores do &kile; poderão começar a ler a partir do capítulo Trabalhar com o Editor &kate;.

### A Referência de &latex;

O &kile; oferece uma referência das marcas de &latex; muito prática, à qual poderá aceder se escolher a opção Ajuda Referência de LaTeX. Ela contém uma descrição detalhada de quase todos os comandos que poderá usar no &latex; e a sua sintaxe.

### Movimentos de Cursor

Para seleccionar texto, tem as seguintes opções:

- Mantenha carregado o botão esquerdo do rato e arraste o rato para seleccionar algum texto.

- Carregue uma vez sobre uma palavra para mover o cursor para uma nova área.

- Carregue duas vezes numa palavra para seleccionar a palavra inteira.

- Carregue duas vezes numa palavra e em &Ctrl; para seleccionar a palavra de Tex completa. Isto significa que, se carregar desta forma em `\par` na expressão `\par\bigskip`, só irá seleccionar o \par.

- Carregue três vezes para seleccionar a frase inteira.

Se mantiver carregado o botão esquerdo do rato e arrastar o texto que deseja seleccionar, irá copiar automaticamente o texto seleccionado para a área de transferência.

Se carregar no &Shift; e usar as teclas de cursores, poderá seleccionar partes do código-fonte na janela do editor.

### Parêntesis

A completação de parêntesis é uma ferramenta visual que o editor usa para lhe indicar qual o parêntesis que corresponde a outro. Se você abrir qualquer ficheiro `.tex` e seleccionar qualquer parêntesis, seja ele um normal (), recto [] ou chaveta {}, o editor irá realçar o parêntesis recto e a sua correspondência a amarelo (esta cor predefinida poderá ser alterada). Por isso, por exemplo, se posicionar o cursor nas chavetas em `\section{Introdução}`, irá ver o `\section{Introdução}` no realce amarelo por omissão, mostrando-lhe a localização dos parêntesis inicial e final.

### Realce

O &kile; tem a capacidade de procurar e realçar vários tipos diferentes de código. Por exemplo, os comandos de &latex; são distinguidos do texto normal e as fórmulas matemáticas são também realçadas com uma cor diferente.

### Pontos

Vários assistentes poderão introduzir pontos opcionais, uma espécie de marcadores de favoritos no texto. Os itens do menu Editar Pontos ou os atalhos de teclado correspondentes permitir-lhe-ão saltar para o próximo ou último ponto. Isso irá também realçar este ponto, de modo que seja removido automaticamente, sempre que você introduzir a sua primeira letra.

Pontos
Pontos

&Ctrl;&Alt;Direita Próximo Ponto

  Salta para o próximo ponto do texto, se existir.

&Ctrl;&Alt;Esquerda Último Ponto

  Salta para o ponto anterior no texto, se existir.

### Seleccionar

A edição é, obviamente, um dos aspectos principais quando você usar um programa como o &kile;. Ainda que o &kate; já tenha óptimas capacidades, o &kile; adiciona algumas funcionalidades importantes, as quais são especialmente necessárias para escrever código em Latex. O &latex; necessita sempre de vários ambientes e grupos, como tal o &kile; suporta comandos muito especiais para os seleccionar. Sob o menu Editar Seleccionar, irá encontrar os seguintes comandos para seleccionar texto.

Editar -> Seleccionar os itens
Editar -> Seleccionar os itens

&Ctrl;&Alt;S , E Ambiente (dentro)

  Seleccione um ambiente sem as marcas envolventes. Se este comando for invocado, quando já estiver seleccionado um ambiente, o &kile; irá expandir a sua selecção para o ambiente envolvente seguinte.

&Ctrl;&Alt;S , F Ambiente (fora)

  Selecciona um ambiente, incluindo as marcas envolventes. Esta selecção também poderá ser expandida com uma segunda invocação deste comando.

&Ctrl;&Alt;S , T Grupo de TeX (dentro)

  Selecciona um grupo de TeX, dentro dos parêntesis envolventes.

&Ctrl;&Alt;S , U Grupo de TeX (fora)

  Selecciona um grupo de TeX, incluindo os parêntesis envolventes.

&Ctrl;&Alt;S , M Grupo Matemático

  Selecciona o grupo matemático actual, incluindo os comandos matemáticos.

&Ctrl;&Alt;S , P Parágrafo

  Selecciona um parágrafo inteiro, i.e., um grupo de linhas de texto separadas em ambos os lados por linhas vazias. Como tal, um parágrafo não significa apenas linhas contínuas de texto, como está habituado nos editores de texto normais. Este significado extendido também inclui tabelas, comandos de &latex; e outras linhas de código. A única coisa importante do &kile; é que o parágrafo é separado por duas linhas vazias.

&Ctrl;&Alt;S , L Linha

  Selecciona a linha de texto na posição actual do cursor.

&Ctrl;&Alt;S , W Palavra do TeX

  Selecciona a palavra sob a posição actual do cursor. Esta selecção tem também um significado extendido, dado que este comando também permite seleccionar comandos de &latex;, que comecem por uma barra invertida e que possam também ter um asterisco opcional no fim.

#### Seleccionar os comandos de &latex;

O &kile; tem uma funcionalidade extendida para seleccionar comandos de &latex;. Se, por exemplo, você tiver escrito

    text \bfseries\itshape more text

e fizer duplo-click sobre algum dos comandos do &latex;, ambos serão seleccionados. Mas provavelmente só quererá seleccionar um dos dois ou mais comandos. Isso pode ser feito com a tecla &Ctrl;. Só terá de carregar na tecla &Ctrl; e fazer duplo-click para seleccionar apenas o comando desejado.

### Apagar

Para remover algumas partes de um documento, poderá seleccioná-lo e usar então a tecla Delete. O &kate; já oferece um comando destes com a combinação &Ctrl;K, de modo que não há necessidade de adicionar outro. Em Editar Remover, irá encontrar os seguintes comandos para remover texto.

Editar -> Remover os itens
Editar -> Remover os itens

&Ctrl;&Alt;T , E Ambiente (dentro)

  Remove um ambiente, sem as marcas envolventes.

&Ctrl;&Alt;T , F Ambiente (fora)

  Remove um ambiente, incluindo as marcas envolventes.

&Ctrl;&Alt;T , T Grupo de TeX (dentro)

  Remove um grupo de TeX, dentro dos parêntesis envolventes.

&Ctrl;&Alt;T , U Grupo de TeX (fora)

  Remove um grupo de TeX, incluindo os parêntesis envolventes.

&Ctrl;&Alt;T , M Grupo Matemático

  Remove o grupo matemático actual, incluindo os comandos matemáticos.

&Ctrl;&Alt;T , P Parágrafo

  Remove um parágrafo completo. Veja o comando Seleccionar Parágrafo para saber como se define um parágrafo no &kile;.

&Ctrl;&Alt;T , I Para o Fim da Linha

  Remove o texto da posição actual do cursor até ao fim da linha.

&Ctrl;&Alt;T , W Palavra do TeX

  Remove a palavra ou comando de &latex; sob a posição actual do cursor.

### Ambiente

Já foi mencionado anteriormente que os ambientes são um ponto central no &latex;. Como tal, o &kile; oferece outros cinco comandos para facilitar ao máximo o trabalho com o &latex;, sob os submenus Editar Ambiente.

Editar -> Itens do ambiente
Editar -> Itens do ambiente

&Ctrl;&Alt;E , B Ir Para o Início

  Este comando irá saltar para o início do ambiente actual, seja qual for a sua posição actual. O cursor será colocado directamente à frente da marca de abertura do ambiente.

&Ctrl;&Alt;E , E Ir Para o Fim

  Este comando irá saltar para o fim do ambiente actual, seja qual for a sua posição actual. O cursor será colocado directamente atrás da marca de fecho do ambiente.

&Ctrl;&Alt;E , M Correspondência

  Quando o seu cursor estiver à frente ou por cima da marca `\begin{ambiente}`, ele irá parar no extremo oposto do ambiente, e vice-versa.

&Ctrl;&Alt;E , C Fechar

  Se escrever um conjunto de marcas aninhadas, poderá perder o controlo de todos esses ambientes. Este comando irá fechar o último ambiente aberto, de modo que a estrutura aninhada dos ambientes não se quebre.

&Ctrl;&Alt;E , A Fechar Tudo

  Isto fecha todos os ambientes abertos, não só o ambiente aberto pela última vez.

### Grupo de &tex;

O &kile; também oferece alguns comandos especiais para os grupos de &latex;, os quais são determinados pelas chavetas `{...}`. No submenu Editar Grupo de TeX, irá encontrar alguns comandos importantes que correspondem aos do Editar Ambiente.

Editar -> Grupo de TeX
Editar -> Grupo de TeX

&Ctrl;&Alt;G , B Ir Para o Início

  Este comando irá saltar para o início do grupo actual, seja qual for a sua posição actual. O cursor será colocado directamente à frente do parêntesis de abertura.

&Ctrl;&Alt;G , E Ir Para o Fim

  Este comando irá saltar para o fim do grupo actual, seja qual for a sua posição actual. O cursor será colocado directamente antes do parêntesis de fecho.

&Ctrl;&Alt;G , M Correspondência

  Quando o seu cursor estiver à frente ou por cima da chaveta de abertura de um grupo do &tex;, ele irá parar no extremo oposto do grupo, e vice-versa.

&Ctrl;&Alt;G , C Fechar

  Se escrever um conjunto de chavetas de grupos aninhados, poderá perder o controlo de todos esses grupos. Este comando irá fechar o último grupo aberto, de modo que a estrutura aninhada dos grupos não se quebre.

### Aspas

No &latex;, são usadas duas plicas como aspas. Para o ajudar a inseri-las de forma eficiente, o &kile; permite-lhe carregar em " para inserir duas plicas de abertura. Para além disso, se quiser fechar as aspas, terá também de carregar em ". O &kile; será suficientemente inteligente para reconhecer este caso e introduz duas plicas de fecho no &latex;.

Para obter umas aspas literais do outro lado, carregue duas vezes em ".

Poderá activar ou desactivar esta inserção automática das aspas de abertura e fecho em Configuração Configurar o Kile...LaTeX.

Aspas
Aspas

Se também incluir opções específicas da língua ou ficheiros de estilos como o `ngerman` ou o `french`, poderá também ser capaz de usar as aspas alemãs ou francesas. Estão disponíveis muitas mais línguas.

### Mudança de Linha Inteligente

Se carregar em &Shift;Return, o &kile; irá inserir uma mudança de linha inteligente. Se a sua posição actual for dentro do ambiente de uma lista, como o `enumerate` ou o `itemize`, o &kile; não só irá inserir uma mudança de linha, como também irá adicionar um comando `\item`.

Se estiver dentro do ambiente de uma tabela, o &kile; irá terminar a linha actual com um `\\`, seguido da linha nova.

Se estiver dentro de um comentário de &latex;, o &kile; irá iniciar a linha seguinte com um `%`.

Ainda melhor, o &kile; é inteligente o suficiente para suportar o &latex; predefinido e o ambiente definido pelo utilizador, que poderá ser adicionado na secção Configuração Configurar o Kile...LaTeX.

### Tabulação Inteligente

Alguns utilizadores 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 carregar em &Shift;&Alt;&, o &kile; irá procurar a próxima tabulação na linha acima. Ainda que isto possa não corresponder à tabulação certa, o &kile; irá adicionar alguns espaços para ajustar a posição da coluna à página actual.

## Completação de Código

Ainda que o &kate; já ofereça um bom modo de completação, a completação de código extendida do &kile; suporta alguns métodos especiais para o &latex;. Estão integrados seis modos diferentes. Três deles funcionam a pedido, enquanto os outros dois são modos de completação automática. Todos os modos podem ser configurados para funcionar de forma bastante diferente em Configuração Configurar o &kile;....

### Completação Automática de Ambientes

Quando você começa um ambiente novo, se escrever `\begin{ambiente}`, o &kile; irá adicionar automaticamente um `\end{ambiente}`, com uma linha no meio para o seu texto.

A completação automática poderá ser desactivada na secção do &latex; na opção Configuração Configurar o Kile...LaTeX Ambientes.

Completar um Ambiente de Equação
Completar um Ambiente de Equação

Completar um Ambiente de Equação

### Comandos de &latex;

Quando você escrever algumas letras, poderá activar este modo de completação para os comandos de &latex; e para as palavras normais com a opção de menu Editar Completar Comando de LaTeX ou com o atalho de teclado &Ctrl;Espaço. O &kile; irá ler primeiro as letras da posição actual do cursor à esquerda e pára no primeiro carácter que não seja uma letra ou uma barra invertida. Se este padrão começar por uma barra invertida, o &kile; irá entrar no modo de completação de comandos de &tex; ou &latex;. Caso contrário, irá entrar no modo normal de dicionário, onde não irá encontrar quaisquer comandos do &latex;. Dependendo do modo escolhido, será aberta uma janela de completação. Irá ver todos os comandos ou palavras, onde o início corresponde ao padrão actual. Poderá navegar com as teclas de cursores por esta lista e seleccionar um item com a tecla &Enter;, ou ainda com um duplo-click com o rato.

Completar um Comando do LaTeX
Completar um Comando do LaTeX

Quando você carregar na tecla &Backspace;, a última letra do seu padrão será removida e a lista de palavras da completação poderá crescer automaticamente. Por outro lado, se escrever outra letra, o padrão será extendido e a lista de palavras visíveis poderá diminuir.

Se optar por não seleccionar nenhuma das propostas, poderá sair desta janela com o &Esc;.

O utilizador irá ver que todos os comandos estão escritos com uma pequena descrição dos seus parâmetros. Estas descrições estão, claro, cortadas quando você seleccionar um comando. Opcionalmente, poderá deixar que o &kile; introduza pontos nestes locais, para que possa saltar facilmente para estas posições com a opção Editar Pontos Ponto Seguinte e inserir o parâmetro que deseja.

Completar um Comando do LaTeX
Completar um Comando do LaTeX

Vá a Configuração Configurar o Kile...KileCompletação para configurar uma ou mais listas deste tipo. Poderá então escolher listas de palavras diferentes para os comandos de &tex; e &latex;, bem como um modo de dicionário para as palavras normais.

Se escolher a opção Mostrar os comandos de Latex, os itens em todos os ficheiros CWL escolhidos, usados na completação dos comandos de &latex;, serão apresentados numa zona em separado da barra lateral do &kile;. Por isso, irá ter uma boa visão geral sobre os comandos disponíveis e as opções que poderão ser indicadas para uma dada completação. Poderá também simplesmente seleccionar um item com o botão do rato, de modo que possa ser inserida no documento, em que todos os parâmetros e opções com nome são retirados.

Comandos do LaTex na barra lateral
Comandos do LaTex na barra lateral

Dado que cada lista de palavras escolhida será apresentada numa área em separado, poderão existir demasiadas áreas, de modo que a janela principal poderá ficar demasiado grande para ecrãs pequenos. Dado que isto fica muito feio, o &kile; funciona com um número máximo de áreas permitidas, estando este configurado como sendo 10. Se este valor for demasiado grande para o seu ecrã, deverá reduzir este número.

### Ambientes

O modo de comandos não é útil para ambientes completos. Terá sempre de escrever algumas letras do `\begin` e invocar o modo de completação, o que irá resultar numa lista enorme de marcas de ambientes. Por outro lado, os ambientes são usados com tanta frequência que o &kile; oferece um modo especial para completar os ambientes. Esqueça a marca de abertura e, simplesmente, escreva `eq`, por exemplo.

Quando agora invocar o modo de completação com a opção Editar Completar Ambiente ou o atalho de teclado &Alt;Espaço, a marca de abertura é adicionada automaticamente e você verá o `\begin{eq}`. Após esta alteração, a lista de completação estará muito mais limpa.

Completar um Comando do LaTeX
Completar um Comando do LaTeX

Agora, seleccione um ambiente para ver este a fechar-se automaticamente. Para além disso, se o &kile; reconhecer um ambiente de listas, irá também introduzir uma primeira marca `\item`.

Completar um Comando do LaTeX
Completar um Comando do LaTeX

Vá a Configuração Configurar o &kile;...KileCompletação para configurar uma ou mais listas deste tipo. Este modo usa as mesmas listas de palavras que o modo de completação dos comandos de &tex; e &latex;.

### Abreviaturas

O &kile; suporta as listas de abreviaturas definidas pelo utilizador, as quais são substituídas a pedido por sequências de texto maiores. Veja em Configuração Configurar o &kile;...KileCompletação para configurar uma ou mais listas destas. Para o exemplo acima indicado, a lista de abreviaturas em `exemplo.cwl` deverá ser escolhido. Neste ficheiro, irá encontrar o item `L=\LaTeX`, por exemplo.

Vamos começar agora e escrever, por exemplo, apenas a letra `L`. Agora, invoque o modo de abreviatura da completação de palavras com Editar Completar Abreviaturas ou com o atalho de teclado &Ctrl;&Alt;Espaço para a letra `L` ser substituída pelo texto `\LaTeX`.

A completação de abreviaturas também suporta a mudança de linha `%n` e o `%C` para colocar o cursor, caso estes caracteres estejam presentes no texto da expansão. Por isso, se tiver o item

    en1=\begin{enumerate}%n\item %C%n\end{enumerate}%n

no ficheiro da completação, e invocar a completação da abreviatura, a expansão ficará parecida com a seguinte, onde o `x` mostra a posição final do cursor.

                    \begin{enumerate}
                    \item x
                    \end{enumerate}

#### Abreviaturas

Se escolher a opção Mostrar as abreviaturas, todas as possíveis abreviaturas são apresentadas numa área da barra lateral. Por isso, irá ter uma boa visão geral sobre todas as abreviaturas possíveis.

### Modos de Auto-Completação

#### Comandos de &latex;

Poderá também activar um modo de completação para os comandos de &latex;. Quando se atingir um dado limite de letras (por omissão: 3), aparece uma janela com uma lista de todos os comandos de &latex; correspondentes. Poderá seleccionar um destes comandos ou ignorar esta janela e escrever mais letras. Os itens da área de completação irão sempre alterar e corresponder à sua palavra escrita.

Vá a Configuração Configurar o &kile;...KileCompletação para activar e desactivar este modo ou mudar o limite.

Completar um Ambiente de Equação
Completar um Ambiente de Equação

#### Palavras do Documento

Os dicionários bons não são úteis no modo de completação. Porém, já se viu que algumas das palavras de um documento são escritas mais que uma vez. Como tal, o &kile; oferece a completação de todas as palavras do documento que o utilizador já escreveu anteriormente. Poderá invocar manualmente esta completação, se carregar em &Ctrl;Espaço. Lembre-se que este modo é diferente do modo de completação dos comandos do &latex;.

Se quiser activar ou desactivar este modo, vá a Configuração Configurar o Kile...EditorEdiçãoCompletação Automática. Nesta janela de configuração, poderá configurar se o modo de completação das palavras do documento deverá ser activado. Existe também uma opção para alterar o valor-limite a partir do qual aparece a janela de completação.

### Escrever os Próprios Ficheiros de Completação

A especificação do formato do ficheiro de completação pode ser encontrada na especificação do formato de ficheiros CWL.

Os ficheiros de completação poderão ser instalados na área pessoal de um utilizador na sub-pasta `~/.kde/share/apps/kile/complete/<modo>/`, onde o `<modo>` tanto poderá ser `abbreviation`, `dictionary` ou `tex`.

## Assistentes e Janelas

### Incluir Gráficos

The Include Graphics dialog makes insertion of graphics as easy as possible. Please take a look at and to get an overview of some basic facts concerning graphic formats.

Incluir um elemento gráfico
Incluir um elemento gráfico

1. Choose a graphics file. This can be a JPEG, PNG, EPS or even a zipped or gzipped EPS file. If you have installed &imagemagick; and also configured &kile; to use it (Settings Configure Kile... LaTeX General), the width and the height of the graphic is automatically shown. If &imagemagick; can determine a resolution, the size of the graphics is also shown in centimeters.

2. Decida se a sua imagem deverá ficar centrada na página.

3. Choose either traditional &latex; or &pdflatex;. Please remember that &pdflatex; can also create &DVI; output, not only PDF.

4. You can choose whether the filename should be taken relative. This is the preferred way, when you use the `\graphicspath` command.

   By default graphics files have to be in the same folder than your master document. However it is possible to put them in other folders to make things tidier. Without a `\graphicspath` command, &kile; would include the path for the graphics file. But if you use `\graphicspath`, like:

       \graphicspath{{/localizacao/das/minhas/imagens}{outro/local/para/mais/imagens}}

   e assinalar esta opção, o &kile; irá usar apenas o nome de base do ficheiro da imagem.

   Outro exemplo: se configurar o comando `\graphicspath` da seguinte forma:

       \graphicspath{{./}{camara/}{imagens/}}

   o &latex; irá procurar na pasta actual, depois na `camara` e finalmente em `imagens`, para descobrir o seu ficheiro de imagem.

5. Se indicar uma largura ou uma altura, a imagem completa será redimensionada de forma proporcional. Por favor, não define dois valores para a largura e para a altura ao mesmo tempo. Isto redimensiona a imagem com factores diferentes para a largura e a altura, o que de certeza não será o que deseja. Veja também a informação perto do topo da janela, para ver o tamanho original da imagem.

6. Indique um ângulo, para a imagem ser rodada no sentido contrário ao dos ponteiros do relógio.

7. A informação da caixa envolvente é configurada automaticamente, quando você escolher um ficheiro gráfico. Esta informação só é necessária quando você trabalhar com o &latex; tradicional e com imagens rasterizadas. Veja a discussão sobre as imagens EPS.

   If &latex; needs a bounding box and you don't want to generate a bb file, &kile; supports this option. On the other side, &pdflatex; will give a warning, when you want to include a png or jpg graphics with this option. This checkbox enables or disables the bounding box option.

8. Scale the image by the desired scale factor. e.g, 0.5 to reduce by half, or 2 to double.

9. The trim option will crop the imported image by l from the left, b from the bottom, r from the right, and t from the top. Where l, b, r and t are lengths.

10. Your last choice is whether to embed this graphics into a figure environment. If you decide to do so, you can also insert a caption and a label. It is a good idea to add a different prefix to each kind of label. It is common to use the prefix `fig:` for images.

11. If may prefer that some floats do not break the flow of text, but instead allow text to wrap around it, you have another choice here. To use wrapfig, you must first add `\usepackage{wrapfig}` to the preamble and set some of the parameter here.

### Array Wizard

One of the most boring jobs one can do in &latex; is to write a matrix or a tabular environment. One has to keep track of all the elements, ensure that the environment is well formed, and that all things are where they are supposed to be. Good indentation helps, but there is a simpler way: using &kile;'s Wizard menu. It contains Tabular and Array (used in math environments). You will then have a matrix-formed input form that you can easily fill in with your entries. This dialog also offers some options to typeset the tabular material.

Inserir um ambiente tabular
Inserir um ambiente tabular

The Tabbing option will display a simpler menu to set up a tabbing environment. In all these environments, you can easily set the number of rows and columns, along with other specific options.

### Utilitários de &PostScript;

Os ficheiros PS não são tão conhecidos como os ficheiros PDF, mas são uma base excelente para as manipulações e reorganizações das páginas. Se precisar de um resultado em PDF, poderá reorganizar as páginas com alguns utilitários de &PostScript; e depois convertê-las para PDF com o comando `ps2pdf`.

The &PostScript; Wizard will suggest the most popular rearrangements, but you are free to do your own choice. Work is done by the programs `pstops` and `psselect`, which you will find in most distributions in the package `psutils`. If one of these programs is not available, the corresponding item will not be visible.

Janelas das PSTools
Janelas das PSTools

Escolha primeiro o seu ficheiro de entrada. Se o &kile; encontrar um ficheiro PS, que corresponda ao seu documento-mestre actual, este estará já preenchido como ficheiro de entrada. Porém, você está à vontade para escolher outro ficheiro. Escolha então um ficheiro de saída, bem como uma das tarefas. Finalmente, terá de decidir se só pretende fazer a conversão ou também invocar o &okular; para ver o resultado.

1 página A5 + página vazia --> A4

  Combinar uma página A5 em conjunto com uma página vazia numa página A4. Sempre que duas páginas A5 forem combinadas em conjunto, estas são rodadas 90 graus e serão organizadas numa página DIN A4 no modo de paisagem.

  A5 + página vazia
  A5 + página vazia
1 página A5 + duplicado --> A4

  Colocar uma página A5 e um duplicado em conjunto numa página A4.

  páginas A5 duplicadas
  Duplicar uma página A5
2 páginas A5 --> A4

  Colocar sempre duas páginas A5 consecutivas numa única página A4.

  combinar duas páginas A5
  combinar duas páginas A5
2 páginas A5L --> A4

  Colocar duas páginas A5 consecutivas no modo paisagem em conjunto numa página A4.

4 páginas A5 --> A4

  Combina quatro páginas A5 consecutivas em conjunto, numa única página A4. As páginas A5 terão de ser redimensionadas com um factor de 0,7 para caber na página.

  4 páginas A5 --> A4
  4 páginas A5 --> A4
1 página A4 + página vazia --> A4

  Combinar uma página A4 em conjunto com uma página vazia numa página A4. Sempre que duas páginas A4 forem combinadas em conjunto numa única página A4 resultante, estas terão de ser redimensionadas com um factor de 0,7 e organizadas numa página A4 no modo de retrato.

  1 página A4 + página vazia --> A4
  1 página A4 + página vazia --> A4
1 página A4 + duplicado --> A4

  Colocar uma página A4 e um duplicado em conjunto numa página A4.

  1 página A4 + duplicado --> A4
  1 página A4 + duplicado --> A4
2 páginas A4 --> A4

  Colocar sempre duas páginas A4 consecutivas numa única página A4.

  combinar duas páginas A4
  combinar duas páginas A4
2 páginas A4L --> A4

  Colocar duas páginas A4 consecutivas, no modo de paisagem, numa única página A4.

escolher as páginas pares

  Seleccionar todas as páginas pares de um documento.

escolher as páginas ímpares

  Seleccionar todas as páginas ímpares de um documento.

escolher as páginas pares (ordem inversa)

  Seleccionar todas as páginas pares de um documento e inverter a ordem.

escolher as páginas ímpares (ordem inversa)

  Seleccionar todas as páginas pares de um documento e inverter a ordem.

inverter todas as páginas

  Inverter todas as páginas de um documento.

copiar todas as páginas (ordenado)

  Copiar todas as páginas de um documento. Terá de escolher o número de cópias ordenadas.

  Copiar todas as páginas (ordenado)
  Copiar todas as páginas (ordenado)
copiar todas as páginas (não ordenado)

  Copiar todas as páginas de um documento. Terá de escolher o número de cópias não ordenadas.

  Copiar todas as páginas (sem ordem)
  Copiar todas as páginas (sem ordem)
pstops: escolha o parâmetro

  Existem muitas mais possibilidades para usar os utilitários de &PostScript; `pstops` e `psselect`. Se necessitar de uma opção muito especial, poderá invocar o comando `pstops` com uma opção à sua escolha. Leia por favor o manual para conhecer todas as opções possíveis.

psselect: escolha o parâmetro

  Poderá invocar o comando `psselect` com uma opção à sua escolha. Veja por favor o manual para descobrir todas as opções possíveis.

### Estatísticas do Documento

The statistics dialog gives you an statistical overview for a selection, a document or an whole project. It includes the number of words, &latex; commands/environments and also includes the number of characters for each type. The statistical numbers can be copied as text or as a nice formatted &latex; tabular to the clipboard. If you want to get statistics for the whole project you can use File Open All Project Files for an easy and quick way to open all source files of your project.

A note of caution has to be sounded about the accuracy of the numbers. We have included some logic to get a good estimate, &eg; K\"uhler gives one word and one command, with six resp. two characters. But there are other combinations in which parts of commands are counted as words and vice versa. It is also implied that the algorithm was developed and tested for languages similar to English or German. So don't take the numbers for granted. If you have to make an report with an exact numbers of words or characters, make some tests to check whether &kile;'s accuracy satisfies your needs.

## Marcas Especiais em &latex;

### Usar a Biblioteca de Marcas do &latex;

O &latex; tem milhares de marcas para os símbolos e caracteres especiais. A forma mais simples de inserir caracteres especiais é usar o menu lateral, à esquerda da janela do editor.

O Menu da Barra Lateral
O Menu da Barra Lateral

A Barra Lateral

Estão disponíveis os seguintes tipos:

- Os Mais Usados

- Relação

- Operadores

- Setas

- Matemática Diversa

- Texto Diverso

- Delimitadores

- Grego

- Caracteres Especiais

- Caracteres Cirílicos

- Definidos pelo Utilizador

As dicas dos ícones mostram os comandos de &latex; e os pacotes adicionais necessários.

Se carregar em &Shift; e num símbolo, irá inserir um `$\comando-símbolo$`. Da mesma forma, se carregar em &Ctrl;, inseri-lo-á com chavetas.

Se inserir um comando que necessite de um pacote que não esteja incluído no seu documento em &latex;, irá ver uma mensagem de aviso na janela do registo.

A primeira lista de símbolos contém os símbolos Mais Usados. Os símbolos inseridos serão adicionados a esta lista, para uma referência rápida e simples. A ordenação dos símbolos não será alterada com a adição de símbolos novos, sendo que será aumentado um contador de referências em alternativa. Se o número de itens ultrapassar os 30, o item com a quantidade menor será removido.

A lista de símbolos Definidos pelo Utilizador poderá conter os seus próprios símbolos. Para criar os seus próprios símbolos, irá necessitar do programa 'gesymb' e do ficheiro 'definitions.tex' do pacote de código-fonte do 'kile'. Para além disso, irá necessitar de um compilador de &latex; (como seria de esperar) e do &dvipng; (versão 1.7 ou posterior). O procedimento consiste em criar um ficheiro de &latex; com o `\input{definitions}`, o que faz com que os comandos abaixo fiquem disponíveis, fazendo com que o `gesymb os-meus-simbolos.tex utilizador` (que invoca o &latex; e o &dvipng;) crie os ícones. Depois de os copiar para a pasta `$HOME/.kde/share/apps/kile/mathsymbols/user/` e reinicie o 'kile', poderá usar os seus próprios símbolos.

Estão definidos os seguintes comandos em 'definitions.tex':

- `\command[\arg-opcional]{\símbolo}`: Inclui o símbolo `\símbolo` na lista de símbolos; o argumento opcional `\arg-opcional` define o comando que o kile deverá introduzir. Se não for indicado, é usado o comando no argumento obrigatório.

- `\mathcommand[\arg-opcional]{\símbolo}`: O mesmo que a anterior, excepto que o comando no argumento obrigatório é inserido no modo matemático.

- `\pkgs[argumento]{pacote}`: Declara que o comando indicado nesta linha precisa do pacote de &latex; `pacote` com o argumento opcional `argumento`. Este comando tem de estar à frente do comando `\command` e substitui todas as definições 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 é dado aqui:

                    \documentclass[a4paper,10pt]{article}
                    \usepackage{amssymb}
                    \input{definitions}
                    %
                    \begin{document}
                    \pagestyle{empty}
                    %
                    \begin{neededpkgs}{amssymb}
                    \mathcommand{\surd}
                    \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}
                    % this would need to include the packages
                    % \usepackage{mathtext}
                    % \usepackage[T2C]{fontenc}
                    % \usepackage[russian]{babel}
                    % \usepackage[koi8-r]{inputenc}
                    %  just to explain the format
                    \end{document}

### Usar os Itens Bibliográficos

O `\bibitem` é um comando usado para introduzir uma referência num ambiente `thebibliography` (a bibliografia) do seu documento. A sintaxe para usar o using `\bibitem` é `\bibitem[legenda]{chave}`.

A `[legenda]` opcional é para você adicionar o seu próprio sistema de legendagem para o item da bibliografia. Se não estiver definida nenhuma legenda, os itens serão definidos por ordem numérica: [1], [2], [3], &etc;

O argumento `{chave}` é usado para referenciar e associar os comandos `\bibitem` e `\cite` um ao outro, bem como a informação que estes contêm. O comando `\cite` contém a legenda associada com o `\bibitem` pretendido, o qual se localiza dentro de um ambiente `thebibliography` e que contém os dados de referência. Ambos os comandos `\bibitem` e `\cite` deverão ter a mesma `{chave}`; a forma mais simples de organizar as chaves é pelo último nome do autor. Os parêntesis secundários no ambiente `thebibliography` indicam a legenda mais longa que poderá ter. Por isso, se introduzir um `{xpto}` significa que você poderá ter qualquer legenda mais pequena ou tão grande quanto a expressão `xpto`. Se não definir este parâmetro correctamente, poderá obter uma indentação não tão atractiva da sua bibliografia.

A bibliografia é uma secção à parte do seu documento principal e um exemplo de código para a bibliografia seria semelhante ao seguinte:

                    \begin{thebibliography}{50}
                    \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...donuts}.
                    Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998
                    \end{thebibliography)

Neste caso, o seu código-fonte principal iria conter a localização da informação referente ao `\bibitem`, usando o `\cite`. Este código-fonte seria semelhante a este:

                    My thesis, about the philosophy of The Simpsons\copyright
                    comes from my favorite book \cite{Simpson}.

As it is often difficult to remember the exact citation key once you have many references, &kile; provides an easy way to insert a citation. On the Edit toolbar click on the second drop-down box (usually it reads label) and select cite. A list with all the citation keys pops up: select the correct reference and a citation will be inserted into your document. To update the list of keys, either save the file, or Edit Refresh Structure, or press F12.

The final product in your document's bibliography would then look like this:

`[1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, Estados Unidos, 1998.`

The easiest way to work with `\bibitem` and `\cite` is to use the toolbar drop-down box marked cite. When you select a citation to insert, you will be given the list of `bibitem`s you have created so far, and will be able to select the reference from the list. &kile; can also work together with &bibtex; editor applications, such as &kbibtex; to help make citations easier.

### Marcas Definidas pelo Utilizador

O &kile; dá-lhe a possibilidade de criar as suas próprias marcas. Uma marca é semelhante a um atalho que invoca algum comando ou escreve algum texto usado frequentemente. Por exemplo, o Zé Maria usa com frequência as frases `Prefiro o \LaTeX\ ao \TeX\` e `O que faria sem o &Linux;?`. Para criar marcas definidas pelo utilizador para escrever estas frases, ele iria aceder à opção Utilizador Marcas do Utilizador Editar as Marcas do Utilizador...; isto irá apresentar-lhe uma janela em que ele poderá criar as suas próprias marcas.

A Janela de Edição de Marcas do Utilizador
A Janela de Edição de Marcas do Utilizador

A Janela de Edição de Marcas do Utilizador

Invocar uma Marca Definida pelo Utilizador
Invocar uma Marca Definida pelo Utilizador

Invocar uma Marca Definida pelo Utilizador

Ele iria dar provavelmente a cada marca um nome que a pudesse identificar claramente. O nome que der à sua marca é indicado na secção chamada Item do menu e o texto do comando usado frequentemente seria indicado no campo Valor. Logo que os comandos forem introduzidos, ele podê-los-á usar rapidamente com o atalho &Ctrl;&Shift; 1 para a primeira marca para introduzir `Prefiro o \LaTeX\ ao \TeX\` e o &Ctrl;&Shift; 2 para introduzir o `O que faria sem o &Linux;?`.

#### Substituições nas Marcas Definidas pelo Utilizador

Existem algumas substituições que poderá usar nas marcas definidas pelo utilizador: elas são o `%S`, o `%B`, o `%M` e o `%C`.

- `%B`: será substituído por um ponto.

- `%C`: aqui é onde o cursor será colocado depois de usar uma marca do utilizador.

- `%M`: corresponde ao texto marcado; o texto seleccionado é inserido no seu lugar ao usar as marcas definidas pelo utilizador.

- `%S`: será substituído pelo nome do ficheiro de código sem a extensão do ficheiro.

To show you how this works let's say for example that we have a user-defined tag, which contains the value `\bfseries{%M}%C`, and I have a selection of text highlighted in my document that we want to turn into bold text. So, we highlight the phrase `I love Fridays`, apply our user-defined tag by pressing &Ctrl;&Shift;1, and we get the text `\bfseries{I love Fridays}`, with the cursor placed at the end of the text.

## As Ferramentas de Construção

### Compilar, converter e visualizar

Para ver o resultado do seu trabalho, precisa primeiro de compilar o código. Todas as ferramentas de compilação estão agrupadas nos menus Criar Compilar, Criar Converter e Criar Ver.

Para compilar o seu código-fonte para os visualizadores como o &kdvi;, o &kghostview;, o &okular; ou outras conversões, poderá usar o atalho &Alt;2. Aí, poderá ver o ficheiro &DVI; com o seu visualizador por omissão com o &Alt;3, converter o &DVI; para um ficheiro PS com o &Alt;4 e ver o ficheiro PS com o &Alt;5.

#### &bibtex;

If you are using &bibtex; for your bibliography entries, you usually have to follow a special compiling scheme. This means calling &latex; and then &bibtex; and then &latex; twice again. Fortunately &kile; is clever enough to detect automatically if it is necessary to call additional tools like &bibtex;, &makeidx; and &asymptote;. This logic is by default turned on and can be changed in Settings Configure Kile...Tools Build in the General tab in the &latex; and &pdflatex; tools.

#### &makeidx;

If you are using the &makeidx; package to make a final, alphabetical index for your document, you have also to follow a certain compilation pattern or let &kile; do this for you in the same way as with &bibtex; files.

#### MetaPost e o &asymptote;

Se quiser compilar o seu documento com o MetaPost ou o &asymptote;, os programas de desenho de imagens, podê-lo-á fazer com a opção Criar Compilar Metapost ou Criar Compilar&asymptote;.

#### &pdflatex;

Existe também outra forma de compilar o seu documento, se quiser um PDF: poderá executar o &pdflatex;, que irá compilar o código directamente para um ficheiro PDF, com o &Alt;6: poderá então ver o ficheiro compilado se carregar em &Alt;7.

Em alternativa, poderá converter um PS num PDF com o &Alt;8 ou, directamente, um &DVI; para um PDF com o &Alt;9.

Se usar o &pdflatex; em vez do &latex;, poderá ser uma questão de simplicidade ou hábito, mas em algumas ocasiões o comportamento dos dois programas poderá ser diferente.

#### O &latex; para a Web

Finalmente, poderá querer publicar o seu trabalho na Web e não apenas no papel. Poderá então, 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 si possível ver o resultado da conversão com o item Criar Ver Ver o &HTML;.

#### Passar Parâmetros da Linha de Comandos

Se quiser passar alguns parâmetros específicos da linha de comandos para as ferramentas de compilação, conversão ou visualização, poderá configurar as invocações das mesmas em Configuração Configurar o Kile...Ferramentas Compilar.

### Antevisão Rápida

Irá necessitar sempre de algum tempo para ver o resultado, ao trabalhar com o &latex;. O &latex; tem de compilar o código e o visualizador terá de ser invocado. Isto poderá ser incómodo, quando alterou apenas algumas letras de uma equação, o que é difícil de escrever. O &kile; oferece agora um modo de Antevisão Rápida, onde poderá compilar apenas uma parte de um documento e poupar bastante tempo. Ele suporta quatro modos diferentes, os quais poderão ser combinados em sete configurações.

Antevisão Rápida
Antevisão Rápida

Toda a configuração deverá ser feita em Configuração Configurar o Kile...FerramentasAntevisão.

Configuração da Antevisão Rápida
Configuração da Antevisão Rápida

#### Modo de Selecção

The user has to select a part of the document. Menu entry Build QuickPreview Selection or the keyboard shortcut &Ctrl;&Alt;P,S will start the selected programs. &kile; takes the preamble of the original text, so that all packages and user defined commands are included. The user can choose one of seven predefined configurations:

- LaTeX+&DVI; (visualizador incorporado)

- LaTeX+&DVI; (KDVI)

- LaTeX+PS (visualizador incorporado)

- LaTeX+PS (&okular;)

- PDFLaTeX+PDF (visualizador incorporado)

- PDFLaTeX+PDF (&okular;)

- PDFLaTeX+PDF (&okular;)

Isto deverá ser suficiente para todas as situações necessárias numa antevisão rápida.

#### Modo do Ambiente

Muitas das vezes, poderá querer antever o ambiente actual. Especialmente no caso de ambientes matemáticos, o que poderá ser difícil de escrever. O &kile; oferece uma forma muito rápida para o fazer. Não é necessária qualquer selecção, bastando para tal escolher Compilar Antevisão Rápida Ambiente ou o atalho de teclado &Ctrl;&Alt;P E, para que o ambiente actual seja compilado e apresentado.

#### Modo de Sub-Documento

Também é frequente que você tenha projectos com vários documentos. Se compilar todo o projecto, não será uma boa ideia, no caso de ter feito apenas alterações num único documento. O &kile; será capaz de compilar e mostrar uma antevisão do sub-documento actual. Ele retira o preâmbulo de um documento-mestre definido e compila apenas este único documento, quando você escolher a opção Compilar Antevisão Rápida Sub-documento ou o atalho de teclado &Ctrl;&Alt;P D.

#### Modo de Grupo Matemático

O modo de antevisão do grupo matemático permite-lhe antever o grupo matemático que está a editar de momento. O &kile; obtém o preâmbulo do documento-mestre e só compila o grupo matemático sobre o qual o cursor se encontra, quando escolher o Construir Antevisão Rápida Grupo Matemático ou escolher o atalho de teclado &Ctrl;&Alt;P,M.

#### Antevisão Rápida na Barra Inferior

Em vez de mostrar a antevisão num documento novo, o &kile; poderá também ser configurado para usar a barra inferior para as compilações da antevisão. Poderá activar esta funcionalidade no painel de configuração da antevisão rápida.

### Formatos de Ficheiros Gráficos

#### O &latex; e o &pdflatex;

O &pdflatex;, quando for usado com os pacotes `graphics` ou o `graphicx`, poderá compilar correctamente os ficheiros PNG e JPG num &DVI; ou PDF, mas não é capaz de lidar com os ficheiros EPS. Por outro lado, o processo de compilação para um &DVI; e a conversão para PS e, eventualmente, PDF suporta os EPS, mas não os ficheiros PNG e JPG.

Diversos utilizadores desejam criar documentos PDF mas, por exemplo, tiram partido do pacote excelente Pstricks para criar imagens &PostScript;; ou, por outro lado, desejam usar o resultado em &PostScript; do 'software' matemático/científico, como o Mathematica, o Maple ou o MuPAD. Estes utilizadores de &latex; têm de seleccionar o formato &PostScript;, mesmo que desejem criar documentos PDF, dado que estes programas produzem código &PostScript; que não pode ser gerido pelo &pdflatex;. Todavia, não é assim tão complicado como parece, dado que o &kile; irá ajudar.

#### Conversão de Imagens

Para dar a volta a este ciclo frustrante, no caso de desejar tanto o código em &PostScript; como os ficheiros PNG ou JPG, tem um conjunto de soluções alternativas:

- Se necessitar de um ficheiro no formato PS, mas se tiver imagens JPG ou PNG, poderá também usar simplesmente o &pdflatex; com o resultado em &DVI; e depois usar a instrução da linha de comandos dvips. Irá ver que o &pdflatex; é uma escolha muito boa, se o seu código não tiver qualquer código em &PostScript;.

- Poderá converter os ficheiros EPS para PNG ou outros formatos com alguns utilitários como o Gimp ou o &imagemagick; e usar o &pdflatex;.

- Uma das formas preferidas é converter as imagens EPS para imagens PDF com o `epstopdf`, que vem com cada distribuição do &tex; e então usar o &pdflatex;. Produz imagens de alta qualidade e poderá até controlar o resultado com algumas das opções seguintes:

      -dAutoFilterColorImages=false
              -dAutoFilterGrayImages=false
              -sColorImageFilter=FlateEncode
              -sGrayImageFilter=FlateEncode
              -dPDFSETTINGS=/prepress
              -dUseFlateCompression=true

  Ainda melhor: se o seu sistema permitir o `shell-escape`, a conversão poderá ser feita na altura. Tudo o que terá de fazer é incluir o pacote epstopdf, que faz parte de todas as distribuições do &tex;, com o comando `\usepackage{epstopdf}`. Assumindo que o seu código é

              \includegraphics[width=5cm]{teste.eps}

  Ao invocar o PDF&latex; com a opção `pdflatex --shell-input`, a imagem `teste.eps` é convertida automaticamente para `teste.pdf`.

  Esta conversão irá tomar lugar de cada vez que você executar o &pdflatex;. Se o seu comando gráfico é dado implicitamente

              \includegraphics[width=5cm]{teste}

  , o epstopdf verifica se o `teste.pdf` já está disponível, de modo que o passo de conversão poderá ser ignorado.

- Poderá converter da forma inversa e usar o &latex; e a conversão PS-PDF; esta nem sempre é uma boa ideia, dado que o encapsulamento em EPS dos JPGs ou PNGs poderá criar ficheiros maiores, que por sua vez geram documentos desnecessariamente grandes; isto é, contudo, altamente dependente do utilitário gráfico que usar, dado que o EPS pode encapsular outros gráficos, mas nem todas as aplicações suportam isto perfeitamente; algumas poderão, de facto, tentar criar a sua imagem JPG com vectores e programação diversa, o que irá resultar em ficheiros gigantes. A conversão de todos os formatos gráficos para EPS poderá ser conseguida com o ImageMagick. Outro programa simples que faz este processo correctamente é o jpg2ps.

- Poderá também usar uma forma automática de conversão. Todos os ficheiros gráficos são convertidos na altura para EPS e introduzidos no documento PS. Esta é uma forma confortável, mas o utilizador terá de configurar o seu sistema convenientemente. Isto é discutido na secção das Imagens EPS.

#### Use o ficheiro correcto para a imagem correcta

- O EPS é uma espécie de linguagem de programa de gráficos vectoriais, descrevendo todas as linhas e pontos que constituem o gráfico; parece bastante bom, mesmo quando é ampliado para além do seu tamanho por omissão e adequa-se bem a diagramas e a imagens vectoriais produzidas nativamente em EPS, parecendo bastante claro e definido e mantendo à mesma um tamanho de ficheiro bastante pequeno.

- O PNG (ou o desactualizado &GIF;) é um formato de ficheiro sem-perdas, com boa compressão e qualidade. É bastante bom para diagramas, digitalizações de desenhos ou todo o tipo de imagens em que queira manter a definição. Pode-se tornar um grande abuso quando é usado para fotos.

- O JPG é um formato com perdas que comprime melhor os ficheiros do que o PNG, conduzindo por outro a algumas perdas dos detalhes das imagens. Isto é normalmente irrelevante para as fotos, para poderá causar uma má qualidade para os diagramas, desenhos e poderá fazer com que algumas linhas finas desapareçam; nesses casos, use o EPS ou o PNG.

Porém lembre-se sempre: entra lixo, sai lixo! Não há nenhuma conversão que transforme uma imagem má numa boa.

### Imagens EPS

Os ficheiros gráficos EPS são a forma tradicional de inserir ficheiros gráficos em documentos do &latex;. Dado que as listas de correio estão cheias de dúvidas no que respeita às imagens EPS, serão discutidos alguns aspectos importantes e será demonstrada a forma como o &kile; irá suportar esta tarefa.

#### O &latex; e as Imagens EPS

Se optou por usar o &latex; tradicional para produzir resultados em PS ou PDF, é provável que tenha alguns problemas com as imagens. Terá de usar as imagens EPS (Encapsulated &PostScript;), e não os ficheiros JPEG ou PNG. Isto não deverá ser qualquer problema, dado que existem vários conversores, como o `convert` do excelente pacote que é o &imagemagick;. Contudo, é necessário algum tempo, como é óbvio.

Os ficheiros EPS são usados tanto pelo &latex; como pelos conversores &DVI;-PS:

- O &latex; procura no ficheiro EPS pela linha da caixa envolvente, a qual indica ao &latex; quanto espaço deverá reservar para a imagem.

- O conversor &DVI;-PS lê então o ficheiro EPS e insere a imagem no ficheiro PS.

Isto tem algumas implicações:

- O &latex; nunca lê o ficheiro EPS se os parâmetros da caixa envolvente forem indicados no comando de inserção da imagem.

- Dado que o &latex; não consegue ler ficheiros que não sejam ASCII, não consegue ler a informação da caixa envolvente a partir de ficheiros comprimidos ou que não sejam EPS.

- As imagens EPS não são incluídas no ficheiro &DVI;. Dado que os ficheiros EPS deverão estar presentes quando o ficheiro &DVI; for convertido para PS, os ficheiros EPS deverão acompanhar os ficheiros &DVI;, sempre que estes forem movidos.

Agora poderá invocar o &latex;, e um conversor &DVI;-PS como o dvips para criar o seu documento em PostScript. Se o seu objectivo for um documento PDF, deverá executar o dvips com a opção `-Ppdf` e depois invocar o `ps2pdf`. Irá encontrar bastantes documentos que descrevem esta solução.

#### O Formato &PostScript; do &kile;

O &kile; ajuda-o a obter a informação da Caixa Envolvente. Se tiver instalado o &imagemagick;, o &kile; irá extrair esta informação do ficheiro EPS e inseri-la como uma opção. Isto é feito automaticamente, quando você seleccionar o ficheiro da imagem. Existem duas vantagens para este procedimento:

- A informação já está extraída durante a janela e não é preciso fazê-lo de novo pelo &latex;.

- Ainda mais importante é o facto de também a largura e a altura da imagem poderem ser calculadas, quando a resolução da imagem for conhecida. Esta informação será apresentada perto do topo da janela e poderá servir como uma pista, sempre que o utilizador desejar dimensionar as imagens.

- O &kile; poderá também suportar ficheiros EPS comprimidos com o 'zip' ou com o 'gzip', os quais são muito mais pequenos que os ficheiros EPS não comprimidos. Contudo, esta funcionalidade só poderá ser usada com uma configuração especial do sistema e com uma alteração na sua configuração local de imagens, como está descrito na secção Imagens Rasterizadas.

#### O Formato &PostScript; e as Imagens Rasterizadas

Se o seu sistema permitir o `shell-escape`, o &kile; também suporta uma forma simples de incluir imagens rasterizadas, se você configurar o seu sistema &tex; convenientemente. Não existe a necessidade de converter as imagens JPEG ou PNG, sendo que isto pode ser feito automaticamente quando o ficheiro &DVI; for convertido para PS.

O &latex; necessita de alguma informação acerca dos sufixos de ficheiros. O pacote `graphicx` irá procurar por um ficheiro `graphics.cfg`, que deverá estar algures no seu local de procura de documentos do &latex;. Procure por itens do género:

    \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}%   EPS 'zipado'
       \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}%   EPS 'gzipado'
       \DeclareGraphicsRule{.jpg}{eps}{}{`convert #1 eps:-}%         JPEG
       \DeclareGraphicsRule{.gif}{eps}{.bb}{`convert #1 eps:-}%      GIF
       \DeclareGraphicsRule{.png}{eps}{.bb}{`convert #1 eps:-}%      PNG
       \DeclareGraphicsRule{.tif}{eps}{.bb}{`convert #1 eps:-}%      TIFF
       \DeclareGraphicsRule{.pdf}{eps}{.bb}{`convert #1 eps:-}%      imagens PDF

Irá encontrar este ficheiro, por exemplo no Debian com a localização `/etc/texmf/latex/graphics.cfg`. As outras distribuições poderão ter outro local, mas cada sistema &tetex; tem um destes ficheiros de configuração para as imagens. A melhor forma de proceder é copiar este ficheiro para o local do seu 'tex' e então alterar este ficheiro. Veja o manual do &tex; para saber como obter uma lista das suas pastas do &tex;.

Com este ficheiro de configuração, você poderá ser capaz de introduzir imagens rasterizados e EPS comprimidos no &latex;. O comando de conversão é dado pelo `dvips`. Quando você olhar para o comando de conversão, irá ver que não será criado qualquer ficheiro extra. O resultado do processo de conversão é directamente encaminhado para o ficheiro PS. A única coisa que o &latex; precisa de saber é o tamanho da imagem e, como tal, é necessária a Caixa Envolvente, que é fornecida pelo &kile;.

Algumas pessoas dizem que esta forma é insegura; terá de decidir como irá funcionar. Em qualquer um dos casos, não será necessária a caixa envolvente, atendendo a que o &kile; irá extrair esta informação de todos os tipos de imagens.

#### O &pdflatex; e as Imagens EPS

Tal como foi dito, o &pdflatex; não é capaz de lidar com ficheiros gráficos EPS; contudo, os conversores como o epstopdf poderão ajudar. A melhor forma é incluir o pacote `epstopdf`, o que deverá ser feito após carregar o pacote `graphicx`.

    \usepackage[pdftex]{graphicx}
       \usepackage{epstopdf}

Agora já pode incluir imagens EPS, se executar o `pdflatex` com a opção `--shell-escape`. Mas poderemos fazer ainda melhor e lidar também com ficheiros EPS comprimidos com o 'zip' e o 'gzip'. Mais uma vez, terá de alterar o ficheiro de configuração 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 &pdflatex; será capaz de lidar com os ficheiros EPS e, provavelmente, não existirão mais dúvidas no que respeite às imagens.

### Documento-Mestre

Ao definir o seu documento como mestre permite-lhe trabalhar com ficheiros separados, o que lhe concede um documento-pai (ou documento-mestre) e os documentos-filhos, compondo assim um trabalho completo. Depois de ter definido o seu documento-mestre, com o comando respectivo no menu Configuração, todos os comandos do menu Ferramentas aplicar-se-ão só a este documento, mesmo que esteja a lidar com os documentos-filhos. Poderá até fechar o documento-mestre.

### Tratamento de Erros

Depois de ter compilado algo, o &kile; dá uma vista de olhos nas mensagens de erros que foram geradas. Se ocorreram alguns erros ou avisos, eles são mostrados brevemente na janela de Registo e Mensagens. Pode-se dar uma vista de olhos com atenção às mensagens ao seleccionar a opção Criar Ver o Ficheiro de Registo ou usando o atalho de teclado &Alt;0. O registo gerado é então apresentado na janela de Registo / Mensagens; os erros e os avisos ficam então realçados.

Ver o registo
Ver o registo

Ver o registo

Poderá saltar facilmente de uma mensagem no ficheiro de registo para outra com as opções Criar Aviso / Erro de LaTeX Anterior / Seguinte ou usando os botões correspondentes na barra de ferramentas.

Para saltar para a linha do ficheiro de &latex; onde ocorreu o erro ou o aviso, carregue neste na janela de Registo e Mensagens. O &kile; levá-lo-á automaticamente para a linha correspondente.

### O Modo de Vigiar Ficheiro

Quando invocar a Construção Rápida, irá aparecer algum visualizador depois da compilação. Se não estiver a usar um visualizador incorporado, será aberta uma nova janela de cada vez.

Se estiver a ajustar a aparência do seu documento, poderá invocar a Construção Rápida com bastante frequência e ter várias janelas de visualização abertas no seu ecrã; para evitar esta confusão, poderá activar o modo para Vigiar o ficheiro, o que irá evitar que a Construção Rápida lance um visualizador.

Este modo é obviamente inútil com os visualizadores incorporados, dado que tem de os fechar à mesma antes de voltar a editar o documento e a recompilar.

## Navegar no Código &latex;

### Utilizar a Vista de Estrutura

A área da Estrutura mostra a hierarquia do documento que está a ser criado no &kile; e permite-lhe navegar rapidamente por ela, mostrando a sua segmentação. Para navegar pelo seu documento, tudo o que precisa é de carregar em qualquer legenda, capítulo, secção, sub-secção, etc., para que vá para o início da área correspondente.

Se incluiu um ficheiro de &latex; separado no sue código com as marcas `\input` ou `\include`, estes ficheiros ficarão referenciado na área da Estrutura; se fizer duplo-click nos seus nomes, irá fazer com que o &kile; abra o ficheiro incluído na janela do editor.

A árvore da hierarquia também tem um ramo em separado para as legendas usadas no texto.

Utilizar a Vista de Estrutura
Utilizar a Vista de Estrutura

Using the Structure View

#### Usar o Menu de Contexto

A maioria dos itens nesta área de estrutura têm bastantes itens no menu de contexto, os quais poderá abrir com o botão direito do rato. Como tal, veja a área de estrutura na imagem seguinte.

Utilizar a Vista de Estrutura
Utilizar a Vista de Estrutura

You will find some labels, some sectioning entries, one figure environment and three pictures. If you right click on one of the sectioning entries, a menu with some useful commands will popup. All commands like Select, Delete or Comment will work with all lines, which belong to this section.

Menu de contexto para os itens de secções
Menu de contexto para os itens de secções

Se carregar numa figura ou item de tabela, irá obter algumas acções relacionadas com as referências, sendo que se carregar com o botão direito num item gráfico, irá apresentar alguns programas para abrir as imagens.

Menu de contexto para as tabelas/figuras e elementos gráficos
Menu de contexto para as tabelas/figuras e elementos gráficos

#### Actualizar a Vista de Estrutura

Para actualizar a sua área da estrutura, poderá tanto ir ao item Editar Actualizar Estrutura, carregue em F12 ou poderá gravar o seu documento, o que fará com que o &kile; actualize a sua área de Estrutura.

### Favoritos

Os favoritos são a sua referência para um segmento de texto ou uma linha no ambiente do &kile;. Para usar um favorito, seleccione uma linha específica do seu documento para a qual gostaria de ir, carregando para tal em &Ctrl; B, para que o &kile; adicionasse um favorito a esta linha. Em alternativa, poderá também definir um favorito se seleccionar uma linha e escolher o menu Favorito Comutar o Favorito.

Para remover todos os seus favoritos, seleccione os Favoritos Limpar Todos os Favoritos.

Please note that currently the bookmarks are not saved after exiting &kile;.

## Projectos

### Trabalhar com Projectos

No &kile;, poderá criar e trabalhar com os projectos. Um projecto é um grupo de documentos de &latex;, &bibtex;, gráficos ou de outro formato que contenham toda a informação usada para criar o seu documento completo. Um projecto típico seria um documento que consiste em vários capítulos, estando cada um deles escrito em ficheiros `.tex` diferentes; todos eles poderiam ser incluídos num projecto, para tornar o documento inteiro mais fácil de gerir. Poderá também guardar ficheiros que não sejam de código, como por exemplo as imagens, num projecto. As definições do projecto são gravadas num ficheiro especial com a extensão `.kilepr`.

Um projecto adiciona as seguintes funcionalidades:

- Não precisa de definir nenhum documento-mestre; o &kile; fará isto automaticamente.

- Os ficheiros do projecto poderão ser arquivados facilmente em conjunto com a opção Construir Outro Arquivar

- A área dos Ficheiros e Projectos mostra quais os ficheiros que estão incluídos no projecto.

- Depois de abrir um projecto, todos os ficheiros que foram abertos anteriormente serão repostos com a codificação e realce originais.

- A completação de código funciona em todos os ficheiros do projecto.

- A completação de referências funciona em todos os ficheiros do projecto.

- A completação de citações funciona em todos os ficheiros do projecto.

- Procurar em todos os ficheiros do projecto.

- Indicar um comando de compilação e do &makeidx; personalizado.

### Criar um Projecto

Para criar um projecto, seleccione a opção Projecto Novo Projecto.... Ser-lhe-ão pedidas as seguintes informações para criar o seu projecto:

- Título do seu projecto.

- Nome do ficheiro de projecto com a extensão `.kilepr`.

- Nome do ficheiro.

- O tipo do ficheiro a criar: Documento Vazio, Artigo, Livro, Carta, Relatório, ....

Quando preencher o campo do nome do ficheiro, terá de incluir uma referência relativa do local onde o ficheiro `.kilepr` está guardado para o ficheiro do documento em si.

### A Área dos Ficheiros e Projectos

A área dos Ficheiros e do Projecto é um botão do menu lateral. Nesta área, poderá ver a estrutura do seu projecto, os seus ficheiros e o nome do ficheiro `.kilepr` que guarda a informação do projecto. As opções para adicionar, remover e modificar o seu projecto são feitas com a área dos Ficheiros e Projectos.

A Área dos Ficheiros e Projectos
A Área dos Ficheiros e Projectos

A Área dos Ficheiros e Projectos

### Adicionar e Remover Ficheiros

To add a file to your project, open any &tex; file, right click on its name in the Files and Projects view, and select Add to Project. If you have multiple projects open, a dialog box will ask you which project the file has to be added to.

Se tiver vários ficheiros para adicionar a um projecto, poderá seleccionar o projecto em si na área dos Ficheiros e Projectos e carregar com o botão direito e seleccionar a opção Adicionar Ficheiros...; poderá então seleccionar os seus ficheiros numa janela.

Adicionar um ficheiro a um projecto
Adicionar um ficheiro a um projecto

Adicionar um ficheiro a um projecto

Para remover um ficheiro de um projecto, carregue com o botão direito do rato nele e seleccione a opção Remover o Ficheiro. Isto não remove de facto o seu ficheiro (e também não o fecha), mas só o retira da lista de ficheiros contida no ficheiro `.kilepr`.

### Opções do Projecto

O &kile; tem algumas opções relacionadas com o seu projecto que poderão ser definidas. Para as alterar, carregue com o botão direito no título do seu projecto e seleccione as Opções do Projecto, onde poderá então alterar:

- O título do seu projecto.

- O documento-mestre.

- O comando de Compilação Rápida.

- As opções do &makeidx;.

#### Arquivar o seu Projecto

&kile; allows you to easily backup your project by storing all its files into a single archive (often known as tarball). To archive your project right-click on its name in the Files and Projects view, or select Build Other Archive.

Por omissão, todos os ficheiros de um projecto serão adicionados ao pacote. Se não quiser incluir um dado ficheiro no pacote, carregue com o botão direito na área dos Ficheiros e Projectos e desligue a opção Incluir no Arquivo.

Archive commands are simple shell commands that are executed from the project folder (where the `.kilepr` file is located).

### Fechar um Projecto

Para fechar um projecto, seleccione a área Ficheiros e Projectos na barra de ferramentas vertical, carregue com o botão direito do rato e seleccione então a opção Fechar. Isto irá fechar o seu projecto, todos os ficheiros a ele associados e irá também adicionar o nome do projecto que fechou à opção Abrir um Projecto Recente... do menu Projecto.

## Codificação do Documento

The &kile; editor allows you to read, convert and set the text to the encoding your document needs. This allows you to use non-standard letters and symbols; you can use, for example, accented characters for Italian or French. Selecting the encoding for your document can be done in three ways:

- One way to set the encoding is to use the Set encoding combo box, located at the bottom of the Open File sidebar view.

- Another way is using the submenu Settings Configure Kile...Editor, where you can set the default character encoding for all files.

  Definir a codificação predefinida
  Definir a codificação predefinida

- A third way to set the encoding for a document is to set the option when you use the wizard to create a new document.

&latex; itself understands only ASCII, a very limited set of characters, so you could not use accented or special letters directly. To use accented letters, a special syntax was created: such as for example `\"e` for `ë`. There is a package to help you with this, called inputenc, and is included in the preamble using `\usepackage[latin1]{inputenc}`, where the optional argument is the encoding you would like to use (nowadays in most cases `utf8x`). This tells &latex; to translate all of the `ë`'s you wrote to `\"e`'s before compiling. Please refer to the inputenc documents directly for more information on inputenc. Last but not least: remember to make sure that your file is actually encoded in the same encoding you told inputenc!

Choosing the source file's encoding
Choosing the source file's encoding

Choosing the source file's encoding

This host of different character coding tables has been creating problems on many applications: for example, you cannot write a course of Turkish in French without losing one language's special characters. There is general agreement that, sooner or later, everybody will switch to Unicode. There are many implementations of Unicode, and UTF-8 is the most successful in &Linux;; &Windows;® relies instead on the more cumbersome and less flexible UCS-2. Some distributions, as RedHat, have already begun setting their default encoding to UTF-8, and therefore you may be very interested in using of the `utf8x` argument to the `inputenc` package.

### O Pacote &ucs;

Se não tiver o pacote &ucs; instalado, poderá proceder da seguinte forma:

- Get the &ucs; package from the home page of Unicode support for &latex;, by Dominique Unruh from the University of Karlsruhe.

- To install it, unpack the downloaded file and place it in a folder listed in your $`TEXINPUTS` envirnoment variable. This can also be set inside kile.

                    \usepackage{ucs}
                    \usepackage[utf8x]{inputenc}

### XeLaTeX

If you are using `XeLaTeX` you can simply load the `xltxtra` package. It will load all required packages.

                    \usepackage{xltxtra}

### Suporte de &cjk;

A adição do suporte para línguas ideográficas tem bastantes truques. Contudo, logo que tenha conseguido, irá funcionar bastante bem. Para além da instalação dos pacotes, é necessária alguma configuração extra.

A sua distribuição de &Linux; poderá já ter um pacote &cjk; (Chinês, Japonês, Coreano) pronto para si, como tal poderá poupar o trabalho de instalar manualmente tudo. Verifique tudo antes de seguir em diante!

There is the possibility of using the &ucs; package in order to write short snippets of &cjk; text, but that option is seriously limited as it does not handle, among other things, newlines. We will instead install the complete &cjk;-&latex; package and make it work for both &latex; and &pdflatex;. A lot of this material has been inspired by Pai H. Chou's page about how to setup &pdflatex;.

1. Download the &cjk; package. Copy its unpacked files to an appropriate subfolder of $`TEXMF`, just like you did with the &ucs; package before (see ). The files will be unpacked in a `CJK/X_Y.Z` folder, it is not important that you take them out, though it will probably be tidier for you to maintain.

2. Now you have to download a font that supports all the &cjk; characters you need. You can choose any `*.ttf` file that covers them, but in this walkthrough we will use Cyberbit. Unzip the file and rename `Cyberbit.ttf` to `cyberbit.ttf`, since uppercase might confuse your system.

   Coloque o `cyberbit.ttf` numa pasta em conjunto com o `Unicode.sfd` e gere os ficheiros `*.tfm` e `*.enc` com o comando `$ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@`. Por algumas razões, isto às vezes poderá não produzir as centenas de ficheiros que deveria produzir. Se for esse o caso, poderá obter tanto os ficheiros `*.tfm` como os `*.enc`.

   Coloque os ficheiros `*.tfm` numa pasta apropriada, como por exemplo `$`TEXMF`/fonts/tfm/bitstream/cyberbit/`; os ficheiros `*.enc` poderão estar instalados na pasta `$`TEXMF`/pdftex/enc/cyberbit/`.

3. Agora, é necessário um ficheiro de mapa para ligar os ficheiros `*.enc` ao tipo de letra. Obtenha o `cyberbit.map` e instale-o em `$`TEXMF`/pdftex/config/`.

4. Obtenha outro ficheiro, o `c70cyberbit.fd` e coloque-o numa pasta apropriada. Poderá escolher, por exemplo, o `$`TEXMF`/tex/misc/`.

5. O último ficheiro que terá de ser gerado é um tipo de letra PostScript Type 1, que é necessário para ler os ficheiros &DVI; gerados com o &latex;. Execute o comando `$ ttf2pfb cyberbit.ttf -o cyberbit.pfb` e copie o ficheiro resultante `cyberbit.pfb` numa pasta como a `$`TEXMF`/fonts/type1/cyberbit/`.

6. Coloque-se então o `cyberbit.ttf` entre os tipos de letra, onde o &latex; o possa encontrar. Poderá colocá-lo numa pasta chamada `$`TEXMF`/fonts/truetype/`.

7. Verifique o ficheiro de configuração que encontra em `$`TEXMF/web2c`/texmf.cnf` e certifique-se que a linha que menciona o `TTFONTS` está sem comentários e aponta para a pasta onde gravou o `cyberbit.ttf`.

8. Para possibilitar ao &pdflatex; usar os seus tipos de letra do &cjk;, é necessário que adicione uma linha ao ficheiro de configuração `$`TEXMF`/pdftex/config/pdftex.cfg`. Adicione o texto `map +cyberbit.map` no ficheiro para completar a configuração no &pdflatex;.

9. To configure &latex; so that you can produce &DVI; files with &cjk; characters, you have to add a line in file `ttfonts.map`. The file might be in a folder named `$`TEXMF`/ttf2pk/`, but you will probably have to look for it. Add the line `cyberbit@Unicode@ cyberbit.ttf` into it.

10. Agora, só terá de correr o ``texhash`` para que o sistema fique pronto.

Para testar se a sua configuração ficou correcta, poderá tentar compilar este ficheiro de teste.

#### Resolução de Problemas com &cjk;

Existem várias coisas que poderão correr mal ao configurar o suporte para o &cjk; manualmente. Se algo parecer não funcionar, a seguinte lista podê-lo-á ajudar.

- Obviamente, dado que executa o &latex; como um utilizador normal e não como 'root', deverá permitir aos utilizadores normais acederem aos ficheiros novos. Certifique-se que todas as pastas e ficheiros estão acessíveis com o comando `chmod`.

- Se o &latex; escrever um &DVI; sem problemas, mas não o conseguir ver, é quase de certeza devido a alguns problemas na geração automática dos ficheiros de tipos de letra `*.pk`. Supostamente, estes são gerados na altura ao ver um ficheiro &DVI;, mas isto poderá correr mal por um conjunto de razões: verifique 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 &DVI;s, tenha sido compilado sem o suporte para as bibliotecas do kpathsea. Se for este o caso, o ``$ ttf2pk``--version`` não fará menção alguma ao kpathsea. Como o suporte para estas bibliotecas é necessário, poderá ter de encontrar um novo pacote ou recompilar você mesmo o FreeType 1.

#### Como é que introduzo caracteres do &cjk; em Unicode?

Existe um conjunto de diferentes motores de introdução de dados, e a escolha poderá também depender das preferências pessoais. O autor usa o Skim, uma versão para o &kde; do motor Scim. Veja na documentação da sua distribuição para aprender como instalar estes programas. A configuração dos mesmos poderá também ser complicada; no caso do Skim, terá de definir uma variável de ambiente ``XMODIFIERS`="@im=SCIM"` antes de iniciar o X.

## Programação

### Programação no &kile;

A funcionalidade de programação do &kile; permite a execução de código em ECMAScript. Os programas podem ser geridos através do painel de programação na barra lateral.

### Referência da API

Nesta secção, descreve-se a interface de programação do &kile;.

Lembre-se que a API de programação ainda não foi finalizada. A API descrita abaixo poderá mudar em versões futuras do &kile;.

Primeiro que tudo, o ambiente de execução de programas do &kile; oferece um objecto global chamado 'kile', que possui os seguintes métodos:

(kile).`currentTextDocument()`

  Devolve um objecto `KileTextDocument` que reflecte o documento activo de momento. Devolve `null` se não estiver activo nenhum documento.

(kile).`getInputValue(`titulo`, `legenda`)`

  Abre uma janela com o título e legenda indicados. Devolve o valor introduzido pelo utilizador.

Os objectos do tipo `KileTextDocument` representam os documentos de texto no &kile;. Têm as seguintes propriedades:

(KileTextDocument).`backspace()`

  Apaga o carácter localizado imediatamente antes da posição actual do cursor e recua o cursor uma posição no texto.

(KileTextDocument).`cursorLeft()`

  Move o cursor uma posição para trás no texto.

(KileTextDocument).`cursorRight()`

  Move o cursor uma posição para a frente no texto.

(KileTextDocument).`insertText(`texto`)`

  Insere o texto na variável `texto` no documento, na posição actual do cursor.

(KileTextDocument).`insertBullet()`

  Insere um ponto de tópico na posição actual do cursor no documento.

(KileTextDocument).`nextBullet()`

  Selecciona o primeiro ponto localizado no documento, imediatamente a seguir à posição actual do cursor.

(KileTextDocument).`previousBullet()`

  Selecciona o primeiro ponto localizado no documento, imediatamente antes da posição actual do cursor.

(KileTextDocument).`up()`

  Sobe o cursor uma posição no documento.

(KileTextDocument).`down()`

  Desce o cursor uma posição no documento.

(KileTextDocument).`cursorLine()`

  Devolve a linha onde o cursor se encontra de momento.

(KileTextDocument).`cursorColumn()`

  Devolve a coluna onde o cursor se encontra de momento.

(KileTextDocument).`setCursorLine(`linha`)`

  Move o cursor para a linha indicada por `linha`.

(KileTextDocument).`setCursorColumn(`coluna`)`

  Move o cursor para a coluna indicada por `coluna`.

## Ajuda

### Documentos de Ajuda

&latex; is a rather sophisticated system, where the basic features can be expanded by a great variety of additional packages. &kile; provides a lot of different help to support the user.

Referência de LaTeX

  Um índice alfabético com os comandos mais comuns do &latex;.

Documentação TeX

  &tetex;/&texlive; comes with a huge amount of documents. This includes a documentation for all included packages and an additional &latex; reference.

LaTeX

  A full reference for &tex; and friends. This is not only a description of all programs, some important packages are also mentioned. And it includes a full reference manual of &latex; commands—ideal for looking up a particular piece of formatting while writing a document. As this document is really extensive, &kile; separates it with three important bookmarks.

Comando LaTeX

  Outro índice alfabético dos comandos mais comuns do &latex;.

Assunto LaTeX

  Uma descrição de assuntos importantes do &latex;.

Env LaTeX

  Um índice alfabético dos ambientes de &latex; mais comuns.

### Ajuda de Contexto

O &kile; suporta também uma ajuda dependente do contexto, a qual é invocada com o comando &Ctrl;&Alt;H K. Em Configuração Configurar o Kile...KileAjuda, poderá escolher se deseja usar a referência de &latex; do &kile; ou o sistema de ajuda do &tetex;/&texlive;, o qual é também a configuração predefinida.

Pontos
Pontos

### Procurar por Palavras-Chave

It is not always easy to find the right document, as &tetex;/&texlive; comes with a huge amount of documents. As one possible help, &tetex;/&texlive; provides a tiny program texdoctk. It comes with a database of all documents that &kile; uses to offer an interface to it.

Pontos
Pontos

All documents are grouped into some categories, and the main advantage is that you can search for packages names or keywords. &kile; will then show only the results.

Pontos
Pontos

A mouse double click or the Space key will start the viewer for this document. This can be a arbitrary document, not only a &DVI;, PS, PDF or &HTML; document. &kile; will take &kde; settings to start a appropriate viewer.

### Ajuda Definida pelo Utilizador

Beside this static &tetex;/&texlive; documentation, &kile; supports also another variable way for user-help documents. In Help menu &kile; has a special User help submenu, where the user can add documents of his own choice. These can be the most important documents of &tetex;/&texlive; documentation, or even self written documents. It is even possible to choose some Web URLs.

Go to Settings Configure Kile... Kile Help and choose Configure button to configure this User help menu. You can add, remove or navigate menu entries, and also insert separators to get a better structure.

Janela: configurar os itens de ajuda do utilizador
Janela: configurar os itens de ajuda do utilizador

Pressing the Add button will open another dialog, where you must edit the name of the menu entry, and choose the corresponding file or Web &URL;. If you choose a Web &URL;, &konqueror; is started and you should copy the final &URL;.

Janela: adicionar um novo item de ajuda
Janela: adicionar um novo item de ajuda

After configuration all chosen entries will appear in the Help menu of &kile; as a special menu entry User help.

Menu de ajuda do utilizador
Menu de ajuda do utilizador

## Créditos e Licença

&kile; is an open-source user-friendly &latex; / &tex; source code editor. It will run on systems with the &kde; Desktop Environment installed. &kde; is available for several architectures with &Linux; and other Unix-like systems installed. &kile; is also part of the Fink project, which means you can run &kile; on a &Mac; with OS-X.

Many thanks are owed to those who strive to continue the &kile; project, and the many hours of contributions made by those who sacrifice their time to develop tools we can all use under the &GNU; license. Up-to-date information about contributors can be found in the About &kile; dialog from the Help menu.

Contributions among others from: Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson

Muito obrigado a todos os envolvidos!

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;

&documentation.index;