<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kile "<application
>Kile</application
>">
  <!ENTITY latex "L<superscript
>A</superscript
>T<subscript
>E</subscript
>X">
  <!ENTITY pdflatex "PDFL<superscript
>A</superscript
>T<subscript
>E</subscript
>X">
  <!ENTITY tex "T<subscript
>E</subscript
>X">
  <!ENTITY tetex "<application
>teT<subscript
>E</subscript
>X</application
>">
  <!ENTITY texlive "<application
>TeX Live</application
>">
  <!ENTITY bibtex "BibT<subscript
>E</subscript
>X">
  <!ENTITY makeindex "makeindex">
  <!ENTITY kbibtex "KBibT<subscript
>E</subscript
>X">
  <!ENTITY kbib "KBib">
  <!ENTITY asymptote "Asymptote">
  <!ENTITY imagemagick "<application
>ImageMagick</application
>">
  <!ENTITY dvipng "<application
>dvipng</application
>">
  <!ENTITY makeidx "<application
>makeidx</application
>">
  <!ENTITY cjk "<abbrev
>CJK</abbrev
>">
  <!ENTITY ucs "<abbrev
>ucs</abbrev
>">
  <!ENTITY kappname "&kile;">
  <!ENTITY package "extragear">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>O Manual do &kile;</title>

<authorgroup>
	<author
><firstname
>Jonathan</firstname
><surname
>Pechta</surname
></author>
	<author
><firstname
>Federico</firstname
><surname
>Zenith</surname
> <affiliation
><address
><email
>federico.zenith@member.fsf.org</email
></address
></affiliation
></author>
	<author
><firstname
>Holger</firstname
><surname
>Danielsson</surname
> <affiliation
><address
><email
>holger.danielsson@versanet.de</email
></address
></affiliation
></author>
	<author
><firstname
>Thomas</firstname
><surname
>Braun</surname
></author>
	<author
><firstname
>Michel</firstname
><surname
>Ludwig</surname
> <affiliation
><address
><email
>michel.ludwig@kdemail.net</email
></address
></affiliation
></author>
	<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2003</year>
<holder
>Jonathan Pechta</holder>
</copyright>

<copyright>
<year
>2003</year
><year
>2005</year
><year
>2006</year>
<holder
>Federico Zenith</holder>
</copyright>

<copyright>
<year
>2005</year
><year
>2006</year>
<holder
>Holger Danielsson</holder>
</copyright>

<copyright>
<year
>2007</year>
<holder
>Thomas Braun</holder>
</copyright>

<copyright>
<year
>2007</year>
<holder
>Michel Ludwig</holder>
</copyright>

<date
>June 13, 2009</date>
<releaseinfo
>2.1</releaseinfo>

<legalnotice>
&FDLNotice;
</legalnotice>

<abstract>
<para
>O &kile; é um editor de código e uma linha de comandos de &tex; e &latex;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdenonbeta</keyword>
<keyword
>Kile</keyword>
<keyword
>LaTeX</keyword>
<keyword
>TeX</keyword>
</keywordset>

</bookinfo>

<chapter id="preface">

<title
>Prefácio</title>

	<sect1 id="preface_sect">

		<title
>Requisitos</title>
			
		<para
>To Run &kile;, you will be required to have the following components installed on your system:</para>

		<itemizedlist>
			<listitem
><para
><ulink url="http://www.kde.org/"
>Ambiente de Trabalho K (&kde;)</ulink
>: &kde; é um popular ambiente de trabalho "open source".</para
></listitem>
			<listitem
><para
><ulink url="http://www.trolltech.com/products/qt/"
>&Qt;</ulink
>: o &Qt; é uma ferramenta de desenvolvimento em C++ necessária para compilar o &kile;.</para
></listitem>
			<listitem
><para
><ulink url="http://www.ctan.org/"
>&latex;</ulink
>: 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.</para
></listitem>
		</itemizedlist>

		<para
>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.</para>

		<para
>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 <ulink url="http://kile.sourceforge.net/"
>&kile; homepage</ulink
>.</para>

	</sect1>

	<sect1 id="preface_audience">

		<title
>Público Alvo</title>

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

		<para
>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 <ulink url="http://kile.sourceforge.net/"
>página Web do &kile;</ulink
>.</para>

		<para
>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: <email
>kile-devel@lists.sourceforge.net</email
>.</para>

	</sect1>

</chapter>

<chapter id="introduction">

	<title
>Introdução</title>

	<sect1 id="intro_about">

		<title
>Factos básicos</title>

		<sect2>

			<title
>Acerca do &kile;</title>

			<para
>&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.</para>

		</sect2>

		<sect2>

			<title
>&kile; and &kate;</title>

			<para
>&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 <ulink url="help:kate"
>&kate; Handbook</ulink
>. &kile; users should start reading from the chapters <quote
>Working with the &kate; Editor</quote
> and <quote
>Configuring &kate;</quote
>.</para>

		</sect2>

		<sect2>

			<title
>What is &latex;</title>

			<para
>&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 <emphasis
>by no chance</emphasis
> 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 <emphasis
>will</emphasis
> look good!</para>

		</sect2>

		<sect2>

			<title
>Como é que se pronuncia? Porquê a formatação estranha?</title>

			<para
>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 <emphasis
>τεχ</emphasis
>, in Latin letters <emphasis
>tech</emphasis
>. 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.</para>
			<para
>The pronunciation is supposed to be as follows: <emphasis
>T</emphasis
> as you would expect, <emphasis
>E</emphasis
> as in <emphasis
>get</emphasis
>, and <emphasis
>X</emphasis
> as in the German i<emphasis
>ch</emphasis
>. If you do not know what <emphasis
>ch</emphasis
> sounds like, it is more or less as an hissing cat; the IPA symbol is /ç/. Many people report the different pronunciation of <emphasis
>ach</emphasis
> (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/.</para>
			<para
>Last, in &latex; the first L<superscript
>A</superscript
> is pronounced as <emphasis
>lay</emphasis
>: the idea is that, while raw &tex; is difficult, even a <emphasis
>lay</emphasis
>man 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!</para>

		</sect2>

	</sect1>

	<sect1 id="intro_latexbasics">

		<title
>Introdução ao &latex;</title>

		<para
>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 <emphasis
> tags</emphasis
>, 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 <guimenu
>LaTeX</guimenu
> in the menu bar.</para>

		<para
>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.</para>

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

	</sect1>

	<sect1 id="intro_mainfeat">

		<title
>Características Principais do &kile;</title>

		<sect2 id="intro_docwizard">

			<title
>Assistente de Arranque Rápido</title>

			<para
>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.</para>

			<para
>Opções da classe:</para>

			<itemizedlist>
				<listitem
><para
>A <guilabel
>Classe do Documento</guilabel
>: escolha o tipo do documento que deseja criar: article, book, letter, report, scrartcl, scrreprt, scrbook, prosper, beamer ou outra classe personalizada.</para
></listitem>
				<listitem
><para
><guilabel
>Tamanho da Letra</guilabel
>: indique ao &kile; qual o tamanho de letra (em pontos) que irá usar.</para
></listitem>
				<listitem
><para
><guilabel
>Tamanho do Papel</guilabel
>: escolha o tamanho ou o estilo das folhas.</para
></listitem>
				<listitem
><para
><guilabel
>Encoding</guilabel
>: 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). </para
></listitem>
				<listitem
><para
><guilabel
>Outras opções</guilabel
>: isto permite-lhe definir mais opções como a impressão, os rascunhos, entre outras.</para
></listitem>
			</itemizedlist>
			
			<para
>Pacotes</para>
			<para
>Esta lista apresenta alguns dos pacotes adicionais mais comuns para usar no &latex;. Seleccione a opção respectiva para o incluir.</para>

			<para
>Propriedades do Documento</para>
			<itemizedlist>
				<listitem
><para
><guilabel
>Autor</guilabel
>: coloque aqui o seu nome.</para
></listitem>
				<listitem
><para
><guilabel
>Título</guilabel
>: adicione aqui o título do seu documento.</para
></listitem>
				<listitem
><para
><guilabel
>Data</guilabel
>: defina a data.</para
></listitem>
			</itemizedlist>

		</sect2>

		<sect2 id="intro_templates">

			<title
>Modelos Predefinidos</title>

			<para
>Os modelos predefinidos no &kile; são:</para>

			<itemizedlist>
				<listitem
><para
>Documento vazio: os verdadeiros adeptos começam do zero!</para
></listitem>
				<listitem
><para
>Artigo: define o formato do artigo para um documento que seja curto o suficiente para não ser dividido em capítulos.</para
></listitem>
				<listitem
><para
>Report: sets the report format, for a middle-sized document, with for example page numbering on the page's outer edge.</para
></listitem>
				<listitem
><para
>Livro: define o formato de um livro, uma variante completa, tão poderosa que é usada para escrever vários textos de livros universitários.</para
></listitem>
				<listitem
><para
>Letter: sets the letter format, that can automatically do those nasty indentations that nobody really remembers.</para
></listitem>
				<listitem
><para
>Beamer,HA-Prosper: create nice presentations in PDF with a superior look and all &latex; power.</para
></listitem>
				<listitem
><para
>Powerdot: Powerdot is the follower of the packages <userinput
>seminar</userinput
> and <userinput
>HA-Prosper</userinput
>. It hasn't so much options like Beamer, but it is easy to use and creates really nice presentations in PDF.</para
></listitem>
				<listitem
><para
>Scrartcl,Scrbook,Scrreprt,Scrlttr2: the KOMA-Script document classes, especially adapted to german typography. Use them whenever you write german texts.</para
></listitem>
				<listitem
><para
>PDF: a modified <userinput
>Article</userinput
> template to use with <userinput
>PdfLaTeX</userinput
>.</para
></listitem>
				<listitem
><para
>Xelatex: um modelo de <userinput
>Article</userinput
> modificado para usar com o <userinput
>XeLaTeX</userinput
>.</para
></listitem>
			</itemizedlist>
			
			<para
>Remember that you can take all these templates as starting point for your own requirements.</para>

			<para
>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 <xref linkend="quickstart"/>.</para>

		</sect2>

		<sect2 id="intro_highlight">

			<title
>Realce de Sintaxe</title>

			<para
>&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.</para>

		</sect2>

		<sect2 id="intro_autocoml">

			<title
>Auto-Completação de Ambientes</title>

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

		</sect2>

		<sect2 id="intro_jump">

			<title
>Saltar para Elemento Estrutural</title>

			<para
>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):</para>

			<itemizedlist>
				<listitem
><para
>\part</para
></listitem>
				<listitem
><para
>\chapter</para
></listitem>
				<listitem
><para
>\section</para
></listitem>
				<listitem
><para
>\subsection</para
></listitem>
				<listitem
><para
>\subsubsection</para
></listitem>
				<listitem
><para
>\paragraph</para
></listitem>
				<listitem
><para
>\subparagraph</para
></listitem>
			</itemizedlist>

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

		</sect2>

		<sect2 id="intro_inverse">

			<title
>Pesquisa Inversa</title>

			<para
>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;.</para>

			<para
>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.</para>

		</sect2>

		<sect2 id="intro_forward">

			<title
>Pesquisa Normal</title>

			<para
>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.</para>

		</sect2>

	</sect1>

	<sect1 id="intro_toolbar">

		<title
>A Barra de Ferramentas</title>

		<itemizedlist>
			<listitem
><para
><guibutton
>Novo</guibutton
>: começa um novo documento.</para
></listitem>
			<listitem
><para
><guibutton
>Abrir</guibutton
>: abre um novo documento.</para
></listitem>
			<listitem
><para
><guibutton
>Fechar</guibutton
>: fecha o documento.</para
></listitem>
			<listitem
><para
><guibutton
>Definir o documento como mestre</guibutton
>: este é usado quando se lida com vários ficheiros. Se tiver um documento-mestre, poderá lidar mais facilmente com outros ficheiros <literal role="extension"
>.tex</literal
> incluídos no seu documento. Se estiver a usar os projectos, poderá também definir um documento-mestre do projecto em <menuchoice
><guimenu
>Projecto-></guimenu
><guisubmenu
>Opções do Projecto</guisubmenu
></menuchoice
>.</para
></listitem>
			<listitem
><para
><guibutton
>Quickbuild</guibutton
>: compiles your &latex; source code and displays the results automatically, unless you have code errors.</para
></listitem>
			<listitem
><para
><guibutton
>Modo de vigia de ficheiros</guibutton
>: 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 <guibutton
>Construção Rápida</guibutton
>.</para
></listitem>
			<listitem
><para
><guibutton
>Ver o ficheiro de registo</guibutton
>: vê o ficheiro <literal role="extension"
>.log</literal
>, onde poderá localizar erros.</para
></listitem>
			<listitem
><para
><guibutton
>Previous error</guibutton
>: jumps backward through the <literal role="extension"
>.log</literal
> file and highlights errors in source.</para
></listitem>
			<listitem
><para
><guibutton
>Next error</guibutton
>: jumps forward through <literal role="extension"
>.log</literal
> file and highlights errors in source.</para
></listitem>
			<listitem
><para
><guibutton
>Parar</guibutton
>: pára a ferramenta actual.</para
></listitem>
			<listitem
><para
><guibutton
>LaTeX</guibutton
>: executa o &latex; sobre o documento activo.</para
></listitem>
			<listitem
><para
><guibutton
>Ver DVI</guibutton
>: inicia o visualizador de &DVI;s.</para
></listitem>
			<listitem
><para
><guibutton
>DVI para PS</guibutton
>: converte o ficheiro &DVI; para &PostScript; (PS).</para
></listitem>
			<listitem
><para
><guibutton
>Ver PS</guibutton
>: iniciar o visualizador de &PostScript; (PS).</para
></listitem>
			<listitem
><para
><guibutton
>PDFLaTeX</guibutton
>: executa o &pdflatex; sobre o documento activo.</para
></listitem>
			<listitem
><para
><guibutton
>Ver o PDF</guibutton
>: inicia o visualizador de PDFs.</para
></listitem>
			<listitem
><para
><guibutton
>DVI para PDF</guibutton
>: converte um &DVI; para PDF.</para
></listitem>
			<listitem
><para
><guibutton
>PS para PDF</guibutton
>: converte um PS para PDF.</para
></listitem>
			<listitem
><para
><guibutton
>Ver HTML</guibutton
>: vê o &HTML; criado.</para
></listitem>
			<listitem
><para
><guibutton
>Pesquisa Normal do DVI</guibutton
>: salta para a página do ficheiro &DVI; que corresponde à linha actual no editor.</para
></listitem>
			<listitem
><para
><guibutton
>Pesquisa Normal do PDF</guibutton
>: salta para a página do ficheiro PDF que corresponde à linha actual no editor.</para
></listitem>
		</itemizedlist>

		<para
>Se você olhar para a barra de ferramentas <guilabel
>Editar</guilabel
>, 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:</para>

		<itemizedlist>
			<listitem
><para
><guilabel
>part</guilabel
>: o nível mais elevado de seccionamento de um documento.</para
></listitem>
			<listitem
><para
><guilabel
>chapter</guilabel
>: cria um novo capítulo.</para
></listitem>
			<listitem
><para
><guilabel
>section</guilabel
>: cria uma nova secção.</para
></listitem>
			<listitem
><para
><guilabel
>subsection</guilabel
>: cria uma nova subsecção.</para
></listitem>
			<listitem
><para
><guilabel
>subsubsection</guilabel
>: uma secção secundária entre a subsecção e o parágrafo.</para
></listitem>
			<listitem
><para
><guilabel
>paragraph</guilabel
>: cria um novo parágrafo.</para
></listitem>
			<listitem
><para
><guilabel
>subparagraph</guilabel
>: cria um novo sub-parágrafo.</para
></listitem>
		</itemizedlist>

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

		<itemizedlist>
			<listitem
><para
><guilabel
>label</guilabel
>: um comando que produz uma legenda para um capítulo, uma figura ou outro elemento.</para
></listitem>
			<listitem
><para
><guilabel
>index</guilabel
>: cria uma entrada no índice.</para
></listitem>
			<listitem
><para
><guilabel
>footnote</guilabel
>: adiciona uma nota de rodapé ao documento.</para
></listitem>
			<listitem
><para
><guilabel
>ref</guilabel
>: é usado para se referir a uma legenda predefinida, a qual poderá escolher numa lista.</para
></listitem>
			<listitem
><para
><guilabel
>pageref</guilabel
>: tal como o <guilabel
>ref</guilabel
>, mas referindo-se a uma página em vez de um elemento da estrutura.</para
></listitem>
			<listitem
><para
><guilabel
>cite</guilabel
>: cria uma referência com dados de uma bibliografia.</para
></listitem>
			<listitem
><para
><guilabel
>cite from ViewBib</guilabel
>: ask the ViewBib tool for all selected references and insert them. Currently this is only available with <ulink url="http://user.digisurf.com.au/~thachly/kbib/"
>&kbib;</ulink
> as ViewBib tool.</para
></listitem>
		</itemizedlist>

		<screenshot>
			<screeninfo
>O menu <guilabel
>Label</guilabel
></screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_ref_choose.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>O menu <guilabel
>Label</guilabel
></phrase>
			</textobject>
			<caption
><para
>O menu <guilabel
>Label</guilabel
></para
></caption>
			</mediaobject>
		</screenshot>

		<screenshot>
			<screeninfo
>Seleccionar a legenda de uma referência</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_ref_select.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Seleccionar a legenda de uma referência</phrase>
			</textobject>
			<caption
><para
>Seleccionar a legenda de uma referência</para
></caption>
			</mediaobject>
		</screenshot>

		<para
>Ao usar o <guilabel
>cite</guilabel
>, 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;.</para>

		<para
>A última lista chamada <guilabel
>pequena</guilabel
> é 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:</para>

		<itemizedlist>
			<listitem
><para
><guilabel
>tiny</guilabel
>: o mais pequeno.</para
></listitem>
			<listitem
><para
><guilabel
>scriptsize</guilabel
>: muito pequeno.</para
></listitem>
			<listitem
><para
><guilabel
>footnotesize</guilabel
>: mais pequeno.</para
></listitem>
			<listitem
><para
><guilabel
>small</guilabel
>: pequeno.</para
></listitem>
			<listitem
><para
><guilabel
>normalsize</guilabel
>: normal.</para
></listitem>
			<listitem
><para
><guilabel
>large</guilabel
>: grande.</para
></listitem>
			<listitem
><para
><guilabel
>Large</guilabel
>: maior.</para
></listitem>
			<listitem
><para
><guilabel
>LARGE</guilabel
>: ainda maior.</para
></listitem>
			<listitem
><para
><guilabel
>huge</guilabel
>: muito maior.</para
></listitem>
			<listitem
><para
><guilabel
>Huge</guilabel
>: o maior.</para
></listitem>
		</itemizedlist>

	</sect1>

</chapter>
<chapter id="quickstart">

	<title
>Arranque Rápido</title>

	<sect1 id="quick_begin">

		<title
>Escrever um Documento em &latex; com o &kile; para Principiantes</title>

		<para
>Os utilizadores do &kile; tem duas opções ao iniciar um documento novo: poderão usar o <guimenu
>Assistente</guimenu
> 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.</para>

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

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

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

		<screenshot>
			<screeninfo
>Texto compilado com resultado em &DVI;</screeninfo>
			<mediaobject>
				<imageobject>
					<imagedata fileref="latex_example.png" format="PNG"/>
				</imageobject>
				<textobject>
					<phrase
>Texto compilado com resultado em &DVI;</phrase>
				</textobject>
				<caption
><para
>Texto compilado com resultado em &DVI;</para
></caption>
			</mediaobject>
		</screenshot>

		<para
>Os parêntesis que vêm a seguir ao comando <userinput
>\documentclass</userinput
> contêm as opções para o comando. A opção <userinput
>[12pt]</userinput
> 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.</para>

		<para
>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 <guimenu
>Criar</guimenu
> ou usando o botão <guilabel
>Criação Rápida</guilabel
>.</para>

		<para
>O <keycombo
>&Alt;<keycap
>2</keycap
></keycombo
> é o atalho de teclado para compilar o seu código-fonte.</para>

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

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

	</sect1>

	<sect1 id="quick_env">
		<title
>Ambientes</title>

		<para
>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 <userinput
>\begin{ambiente}</userinput
>, <userinput
>\huge</userinput
> e <userinput
>\end{ambiente}</userinput
> permitir-lhe-ão alterar temporariamente o texto dentro dos comandos de controlo para ter um tamanho enorme.</para>

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

		<para
>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 <userinput
>\end</userinput
> ou no fim do seu ambiente.</para>

		<itemizedlist>
			<listitem
><para
><userinput
>\begin{emph}</userinput
>: este comando coloca o texto em itálico e isto é válido até que o código passe por um <userinput
>\end{em}</userinput
>, <userinput
>\end{emph}</userinput
> ou outro ambiente. Para colocar uma palavra em itálico, poderá usar a sintaxe: esta é a <userinput
>\em{minha}</userinput
> frase.</para
></listitem>
			<listitem
><para
><userinput
>\textbf{Vou tornar este texto dentro dos parêntesis negrito}</userinput
>: este comando coloca o seu texto a negrito.</para
></listitem>
			<listitem
><para
><userinput
>\quote</userinput
>: para criar uma citação dentro do seu document; coloque a sua citação com um <userinput
>\begin{quote}</userinput
> e termine-a com um <userinput
>\end{quote}</userinput
>.</para
></listitem>
			<listitem
><para
><userinput
>\center</userinput
>: centra o texto.</para
></listitem>
			<listitem
><para
><userinput
>\verse</userinput
>: cria algum texto de deslocamento para poemas.</para
></listitem>
			<listitem
><para
><userinput
>\itemize</userinput
>: cria uma lista de itens.</para
></listitem>
		</itemizedlist>

	</sect1>

	<sect1 id="quick_using">

		<title
>Utilizar o &kile;</title>

		<para
>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.</para>

		<procedure>
			<step
><para
>Inicie o &kile;.</para
></step>
			<step
><para
>Seleccione o <menuchoice
><guimenu
>Assistente</guimenu
><guimenuitem
>Arranque Rápido</guimenuitem
></menuchoice
>, depois escolha um formato e defina as suas preferências no assistente.</para
></step>
			<step
><para
>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.</para
></step>
			<step
><para
>Grave o seu ficheiro e dê-lhe o nome <filename
>intro.tex</filename
>.</para
></step>
			<step
><para
>Crie (compile) o seu documento com a sequência <keycombo
>&Alt;<keycap
>2</keycap
></keycombo
> ou com o botão intitulado <guilabel
>LaTeX</guilabel
>.</para
></step>
			<step
><para
>Seleccione <guibutton
>Ver o DVI</guibutton
>.</para
></step>
			<step
><para
>Verifique todo o novo texto.</para
></step>
			<step
><para
>Agora que você acabou de ver o seu documento, carregue no botão <guibutton
>Janela do Editor</guibutton
> ou carregue em <keycombo
>&Ctrl;<keycap
>E</keycap
></keycombo
> 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.</para
></step>
		</procedure>

		<para
>É tudo! Acabou agora de criar o seu primeiro documento em &latex;!</para>

		<para
>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!</para>

	</sect1>

	<sect1 id="quick_dvi">

		<title
>Ficheiros &DVI;</title>

		<para
>O &DVI; significa <emphasis
>DeVice Independent</emphasis
> ou <emphasis
>Independente do Dispositivo</emphasis
>. 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 <literal role="extension"
>DVI</literal
>, como uma impressora, um conversor para ficheiros &PostScript; ou PDF ou para o ecrã do seu computador.</para>

	 	<sect2 id="quick_viewdvi">

			<title
>Ver um &DVI;</title>

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

		</sect2>

		<sect2 id="quick_printdvi">

		<title
>Imprimir um &DVI;</title>

			<para
>To print a &DVI;, you can use the same process that you used to create your document earlier (see <xref linkend="quick_using"/>). At step 7, after clicking <guibutton
>ViewDVI</guibutton
>, select <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Print</guimenuitem
></menuchoice
> in the viewer, and if you have your printer properly configured, you will be able to print the &DVI;.</para>

		</sect2>

		<sect2 id="quick_exportdvi">

			<title
>Converter os ficheiros &DVI;</title>

			<para
>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.</para>

		</sect2>

	</sect1>

	<sect1 id="quick_forward">

		<title
>Pesquisa Normal entre o &kile; e o &okular;</title>

		<para
>As funções de pesquisa normal permitem-lhe saltar directamente do seu editor para a posição associada no ficheiro &DVI; ou PDF. </para>
		<para
>O &kile; oferece uma configuração com esta opção para todos os executáveis de &latex;. Vá a <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>Ferramentas</guimenuitem
><guimenuitem
>Compilar</guimenuitem
></menuchoice
> e escolha sempre a configuração <userinput
>Moderna</userinput
>.</para>

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

		<title
>Pesquisa Inversa entre o &kile; e o &okular;</title>

		<para
>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 <mousebutton
>esquerdo</mousebutton
> 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 <guilabel
>Moderna</guilabel
>.</para>

		<para
>A pesquisa inversa não poderá funcionar a menos que:</para>

		<itemizedlist>
			<listitem
><para
>O ficheiro de código tenha sido compilado com sucesso.</para
></listitem>
			<listitem
><para
>O &okular; saiba qual o editor que desejaria usar.</para
></listitem>
		</itemizedlist>

		<para
>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; <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o Okular...</guimenuitem
></menuchoice
> (na página <guimenuitem
>Editor</guimenuitem
>).</para>
			
		<screenshot>
			<screeninfo
>Configurar o &okular;</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_okular_settings.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Configurar o &okular;</phrase>
			</textobject>
			<caption
><para
>Configurar o &okular;</para
></caption>
			</mediaobject>
		</screenshot>
	</sect1>

	<sect1 id="quick_errors">

		<title
>Resolver Erros</title>

		<para
>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.</para>

		<para
>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 <guibutton
>Erro de LaTeX Anterior</guibutton
> e <guibutton
>Erro de LaTeX Seguinte</guibutton
> 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.</para>

	</sect1>

</chapter>
<chapter id="startnew">

	<title
>Iniciar um Novo Documento</title>

	<para
>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:</para>

	<itemizedlist>
		<listitem
><para
>Documento vazio</para
></listitem>
		<listitem
><para
>Artigo</para
></listitem>
		<listitem
><para
>Beamer</para
></listitem>
		<listitem
><para
>Livro</para
></listitem>
		<listitem
><para
>HA-Prosper</para
></listitem>
		<listitem
><para
>Powerdot</para
></listitem>
		<listitem
><para
>Carta</para
></listitem>
		<listitem
><para
>Relatório</para
></listitem>
		<listitem
><para
>Scrartcl (do pacote KOMA-Script)</para
></listitem>
		<listitem
><para
>Scrbook (do pacote KOMA-Script)</para
></listitem>
		<listitem
><para
>Scrlttr2 (do pacote KOMA-Script)</para
></listitem>
		<listitem
><para
>Scrreprt (do pacote KOMA-Script)</para
></listitem>
		<listitem
><para
>PDF</para
></listitem>
		<listitem
><para
>XeLaTeX</para
></listitem>
	</itemizedlist>

	<para
>If you selected an <guilabel
>Empty document</guilabel
>, you can either start writing a document from scratch, or you can use the wizard to quickly start a new document (see <xref linkend="intro_docwizard"/>).</para>


	<sect1 id="startnew_templates">

		<title
>Modelos</title>

		<para
>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.</para>


		<sect2>
			<title
>Criar um Novo Modelo</title>

			<para
>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 <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Criar Modelo a Partir de Documento</guimenuitem
></menuchoice
>.</para>

		</sect2>

		<sect2>

			<title
>Configurar as Substituições Automáticas</title>

			<para
>Ao criar um novo documento através da selecção de um modelo na opção <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Novo</guimenuitem
></menuchoice
>, 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 <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>Configuração</guimenuitem
><guimenuitem
>Geral</guimenuitem
></menuchoice
>.</para>

			<para
>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:</para>

			<itemizedlist>
				<listitem
><para
><userinput
>$$AUTHOR$$</userinput
>: Este texto será substituído pela variável do autor.</para
></listitem>
				<listitem
><para
><userinput
>$$DOCUMENTCLASSOPTIONS$$</userinput
>: Este texto será substituído pela variável das opções do 'documentclass' (classe do documento). Tipicamente é usado da seguinte forma: <userinput
>\documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}</userinput
>.</para
></listitem>
				<listitem
><para
><userinput
>$$INPUTENCODING$$</userinput
>: Se a variável da codificação de entrada estiver configurada, por exemplo, como <userinput
>latin1</userinput
> este texto será substituído por <userinput
>\input[latin1]{inputenc}</userinput
>.</para
></listitem>
			</itemizedlist>

		</sect2>

		<sect2 id="templ_wiz">

			<title
>Criar Modelo utilizando o Assistente</title>

			<para
>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:</para>

			<procedure>
				<step
><para
>Grave o seu ficheiro;</para
></step>
				<step
><para
>Vá a <guimenu
>Ficheiro</guimenu
>;</para
></step>
				<step
><para
>Escolha <guimenuitem
>Criar Modelo a partir do Documento</guimenuitem
>;</para
></step>
				<step
><para
>Efectue quaisquer correcções necessárias ao modelo;</para
></step>
				<step
><para
>Indique um nome para o novo modelo;</para
></step>
				<step
><para
>Carregue em <guibutton
>OK</guibutton
> para adicionar o seu modelo ao menu.</para
></step>
			</procedure>

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

		</sect2>

		<sect2>

			<title
>Criar Modelo a partir de qualquer Ficheiro</title>

			<para
>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 <xref linkend="templ_wiz"/>.</para>

			<para
>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 <ulink url="http://www.stats.ox.ac.uk/~marchini/a0poster.html"
>página pessoal de Jonathan Marchini</ulink
>, mas existem muitas mais disponíveis. Lembre-se que irá necessitar do pacote <filename
>a0poster</filename
>, o qual não está normalmente incluído numa distribuição normal do &tetex;, por isso terá de o <ulink url="http://www.tug.org/tex-archive/help/Catalogue/entries/a0poster.html"
>obter a partir daqui</ulink
> e copiar para a mesma pasta que o seu ficheiro de &latex;.</para>
		</sect2>

		 <sect2 id="templ_rem">

	 		<title
>Remover um Modelo</title>

			<para
>Para remover um modelo do &kile;, faça o seguinte:</para>

			<procedure>
				<step
><para
>Vá a <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Remover Modelo...</guimenuitem
></menuchoice
>;</para
></step>
				<step
><para
>Irá aparecer uma janela com todos os modelos listados: seleccione um deles;</para
></step>
				<step
><para
>Carregue em <guilabel
>OK</guilabel
> e o modelo será removido.</para
></step>
			</procedure>
			
			<para
>Os modelos marcados com um asterisco (*) não poderão ser removidos sem a devida permissão.</para>

		</sect2>

	</sect1>

</chapter>
<chapter id="editing">

	<title
>Editar Documentos &latex;</title>

	<para
>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 <guimenu
>Ferramentas</guimenu
> do &kile;.</para>

	 <para
>Para aprender mais sobre o &kate; e as suas capacidades, veja o <ulink url="help:kate"
>Manual do &kate;</ulink
>. Os utilizadores do &kile; poderão começar a ler a partir do capítulo <quote
>Trabalhar com o Editor &kate;</quote
>.</para>

	 <sect1 id="editing_sect">

		<title
>A Referência de &latex;</title>

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

	</sect1>

	<sect1 id="editing_cursor">

	 	<title
>Movimentos de Cursor</title>
		
		<para
>Para seleccionar texto, tem as seguintes opções:</para>

		<itemizedlist>
			<listitem
><para
>Mantenha carregado o botão esquerdo do rato e arraste o rato para seleccionar algum texto.</para
></listitem>
			<listitem
><para
>Carregue uma vez sobre uma palavra para mover o cursor para uma nova área.</para
></listitem>
			<listitem
><para
>Carregue duas vezes numa palavra para seleccionar a palavra inteira.</para
></listitem>
			<listitem
><para
>Carregue duas vezes numa palavra e em <keycombo
>&Ctrl;</keycombo
> para seleccionar a palavra de Tex completa. Isto significa que, se carregar desta forma em <userinput
>\par</userinput
> na expressão <userinput
>\par\bigskip</userinput
>, só irá seleccionar o \par.</para
></listitem>
			<listitem
><para
>Carregue três vezes para seleccionar a frase inteira.</para
></listitem>
		</itemizedlist>

		<para
>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.</para>

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

	</sect1>

	<sect1 id="editing_bracket">

		<title
>Parêntesis</title>

		<para
>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 <literal role="extension"
>.tex</literal
> 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 <userinput
>\section{Introdução}</userinput
>, irá ver o <userinput
>\section{Introdução}</userinput
> no realce amarelo por omissão, mostrando-lhe a localização dos parêntesis inicial e final.</para>

	</sect1>

	<sect1 id="editing_highlight">

		<title
>Realce</title>

		<para
>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.</para>
	
	</sect1>

	<sect1 id="editing_bullets">

		<title
>Pontos</title>

		<para
>Vários assistentes poderão introduzir pontos opcionais, uma espécie de marcadores de favoritos no texto. Os itens do menu <menuchoice
><guimenu
>Editar</guimenu
><guisubmenu
>Pontos</guisubmenu
></menuchoice
> 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.</para>
		
		<screenshot>
			<screeninfo
>Pontos</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="bullets.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Pontos</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<variablelist>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>Direita</keycap
></keycombo
></shortcut
> <guimenuitem
>Próximo Ponto</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Salta para o próximo ponto do texto, se existir.</para
></listitem>
		</varlistentry>
	 
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>Esquerda</keycap
></keycombo
></shortcut
> <guimenuitem
>Último Ponto</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Salta para o ponto anterior no texto, se existir.</para
></listitem>
		</varlistentry>
		
		</variablelist>
		
	</sect1>
	
	<sect1 id="editing_select">

		<title
>Seleccionar</title>
	
		<para
>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 <menuchoice
><guimenu
>Editar</guimenu
><guisubmenu
>Seleccionar</guisubmenu
></menuchoice
>, irá encontrar os seguintes comandos para seleccionar texto.</para
> 

		<screenshot>
			<screeninfo
>Editar -> Seleccionar os itens</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="select.png" format="PNG"/>
			</imageobject>
			<textobject>
				<phrase
>Editar -> Seleccionar os itens</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		<variablelist>
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>S</keycap
></keycombo
> <keycap
>, E</keycap
></shortcut
> <guimenuitem
>Ambiente (dentro)</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>S</keycap
></keycombo
> <keycap
>, F</keycap
></shortcut
> <guimenuitem
>Ambiente (fora)</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Selecciona um ambiente, incluindo as marcas envolventes. Esta selecção também poderá ser expandida com uma segunda invocação deste comando. </para
></listitem>
		</varlistentry>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>S</keycap
></keycombo
> <keycap
>, T</keycap
></shortcut
> <guimenuitem
>Grupo de TeX (dentro)</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Selecciona um grupo de TeX, dentro dos parêntesis envolventes.</para
></listitem>
		</varlistentry>
				
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>S</keycap
></keycombo
> <keycap
>, U</keycap
></shortcut
> <guimenuitem
>Grupo de TeX (fora)</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Selecciona um grupo de TeX, incluindo os parêntesis envolventes.</para
></listitem>
		</varlistentry>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>S</keycap
></keycombo
> <keycap
>, M</keycap
></shortcut
> <guimenuitem
>Grupo Matemático</guimenuitem
></menuchoice
></term>
			<listitem
><para
>Selecciona o grupo matemático actual, incluindo os comandos matemáticos.</para
></listitem>
		</varlistentry>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>S</keycap
></keycombo
> <keycap
>, P</keycap
></shortcut
> <guimenuitem
>Parágrafo</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>S</keycap
></keycombo
> <keycap
>, L</keycap
></shortcut
> <guimenuitem
>Linha</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Selecciona a linha de texto na posição actual do cursor.</para
></listitem>
		</varlistentry>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>S</keycap
></keycombo
> <keycap
>, W</keycap
></shortcut
> <guimenuitem
>Palavra do TeX</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>

		</variablelist>
		
		<sect2 id="editing_select_latex_commands">
		
		<title
>Seleccionar os comandos de &latex;</title>
		
		<para
>O &kile; tem uma funcionalidade extendida para seleccionar comandos de &latex;. Se, por exemplo, você tiver escrito</para>
		
		<screen
><userinput
>text \bfseries\itshape more text</userinput
></screen>

		<para
>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 <keycombo
>&Ctrl;</keycombo
>. Só terá de carregar na tecla <keycombo
>&Ctrl;</keycombo
> e fazer duplo-click para seleccionar apenas o comando desejado.</para>

		</sect2>
		
	</sect1>

	<sect1 id="editing_delete">

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

		<screenshot>
			<screeninfo
>Editar -> Remover os itens</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="delete.png" format="PNG"/>
			</imageobject>
			<textobject>
				<phrase
>Editar -> Remover os itens</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		<variablelist>
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>T</keycap
></keycombo
> <keycap
>, E</keycap
></shortcut
> <guimenuitem
>Ambiente (dentro)</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Remove um ambiente, sem as marcas envolventes.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>T</keycap
></keycombo
> <keycap
>, F</keycap
></shortcut
> <guimenuitem
>Ambiente (fora)</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Remove um ambiente, incluindo as marcas envolventes.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>T</keycap
></keycombo
> <keycap
>, T</keycap
></shortcut
> <guimenuitem
>Grupo de TeX (dentro)</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Remove um grupo de TeX, dentro dos parêntesis envolventes.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>T</keycap
></keycombo
> <keycap
>, U</keycap
></shortcut
> <guimenuitem
>Grupo de TeX (fora)</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Remove um grupo de TeX, incluindo os parêntesis envolventes.</para
></listitem>
		</varlistentry>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keycap
>T</keycap
></keycombo
> <keycap
>, M</keycap
></shortcut
> <guimenuitem
>Grupo Matemático</guimenuitem
></menuchoice
></term>
			<listitem
><para
>Remove o grupo matemático actual, incluindo os comandos matemáticos.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>T</keycap
></keycombo
> <keycap
>, P</keycap
></shortcut
> <guimenuitem
>Parágrafo</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Remove um parágrafo completo. Veja o comando <menuchoice
><guisubmenu
>Seleccionar</guisubmenu
><guimenuitem
>Parágrafo</guimenuitem
></menuchoice
> para saber como se define um parágrafo no &kile;.</para
></listitem>
		</varlistentry>
		
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keycap
>T</keycap
></keycombo
> <keycap
>, I</keycap
></shortcut
> <guimenuitem
>Para o Fim da Linha</guimenuitem
></menuchoice
></term>
			<listitem
><para
>Remove o texto da posição actual do cursor até ao fim da linha. </para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>T</keycap
></keycombo
> <keycap
>, W</keycap
></shortcut
> <guimenuitem
>Palavra do TeX</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Remove a palavra ou comando de &latex; sob a posição actual do cursor.</para
></listitem>
		</varlistentry>
		
		</variablelist>

	</sect1>

	<sect1 id="editing_environment">

		<title
>Ambiente</title>
	
		<para
>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 <menuchoice
><guimenu
>Editar</guimenu
><guisubmenu
>Ambiente</guisubmenu
></menuchoice
>.</para>

		<screenshot>
			<screeninfo
>Editar -> Itens do ambiente</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="environment.png" format="PNG"/>
			</imageobject>
			<textobject>
				<phrase
>Editar -> Itens do ambiente</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		<variablelist>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>E</keycap
></keycombo
> <keycap
>, B</keycap
></shortcut
> <guimenuitem
>Ir Para o Início</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>
		
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>E</keycap
></keycombo
> <keycap
>, E</keycap
></shortcut
> <guimenuitem
>Ir Para o Fim</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>E</keycap
></keycombo
> <keycap
>, M</keycap
></shortcut
> <guimenuitem
>Correspondência</guimenuitem
></menuchoice
></term>
		<listitem
><para
>Quando o seu cursor estiver à frente ou por cima da marca <userinput
>\begin{ambiente}</userinput
>, ele irá parar no extremo oposto do ambiente, e vice-versa.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>E</keycap
></keycombo
> <keycap
>, C</keycap
></shortcut
> <guimenuitem
>Fechar</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keycap
>E</keycap
></keycombo
> <keycap
>, A</keycap
></shortcut
> <guimenuitem
>Fechar Tudo</guimenuitem
></menuchoice
></term>
			<listitem
><para
>Isto fecha todos os ambientes abertos, não só o ambiente aberto pela última vez.</para
></listitem>
		</varlistentry>

		</variablelist>
		
	</sect1>
	
	<sect1 id="editing_texgroup">

		<title
>Grupo de &tex;</title>
		
		<para
>O &kile; também oferece alguns comandos especiais para os grupos de &latex;, os quais são determinados pelas chavetas <userinput
>{...}</userinput
>. No submenu <menuchoice
><guimenu
>Editar</guimenu
><guisubmenu
>Grupo de TeX</guisubmenu
></menuchoice
>, irá encontrar alguns comandos importantes que correspondem aos do <menuchoice
><guimenu
>Editar</guimenu
><guisubmenu
>Ambiente</guisubmenu
></menuchoice
>. </para>
		
		<screenshot>
			<screeninfo
>Editar -> Grupo de TeX</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="texgroup.png" format="PNG"/>
			</imageobject>
			<textobject>
				<phrase
>Editar -> Grupo de TeX</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		<variablelist>
		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keycap
>G</keycap
></keycombo
> <keycap
>, B</keycap
></shortcut
> <guimenuitem
>Ir Para o Início</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keycap
>G</keycap
></keycombo
> <keycap
>, E</keycap
></shortcut
> <guimenuitem
>Ir Para o Fim</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keycap
>G</keycap
></keycombo
> <keycap
>, M</keycap
></shortcut
> <guimenuitem
>Correspondência</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>

		<varlistentry
><term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keycap
>G</keycap
></keycombo
> <keycap
>, C</keycap
></shortcut
> <guimenuitem
>Fechar</guimenuitem
></menuchoice
></term>
		<listitem
><para
>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.</para
></listitem>
		</varlistentry>
		
		</variablelist>
		
	</sect1>

	<sect1 id="editing_dblquotes">

		<title
>Aspas</title>

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

		<para
>Para obter umas aspas literais do outro lado, carregue duas vezes em <keycap
>"</keycap
>.</para>

		<para
>Poderá activar ou desactivar esta inserção automática das aspas de abertura e fecho em <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>LaTeX</guimenuitem
></menuchoice
>.</para>

		<screenshot>
			<screeninfo
>Aspas</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="config-dblquotes.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Aspas</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

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

	</sect1>

	<sect1 id="editing_smartnewline">

		<title
>Mudança de Linha Inteligente</title>

		<para
>Se carregar em <keycombo
>&Shift;<keycap
>Return</keycap
></keycombo
>, 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 <userinput
>enumerate</userinput
> ou o <userinput
>itemize</userinput
>, o &kile; não só irá inserir uma mudança de linha, como também irá adicionar um comando <userinput
>\item</userinput
>.</para>

		<para
>Se estiver dentro do ambiente de uma tabela, o &kile; irá terminar a linha actual com um <userinput
>\\</userinput
>, seguido da linha nova.</para>
  
    <para
>Se estiver dentro de um comentário de &latex;, o &kile; irá iniciar a linha seguinte com um <userinput
>%</userinput
>.</para>

		<para
>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 <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>LaTeX</guimenuitem
></menuchoice
>.</para>

	</sect1>

	<sect1 id="editing_tabulator">

		<title
>Tabulação Inteligente</title>

		<para
>Alguns utilizadores gostam de organizar as colunas nos ambientes de tabelas e colocar todos os caracteres de E-comerciais <keycap
>&amp;</keycap
> por baixo uns dos outros. O  &kile; tenta suportar isto. Se carregar em <keycombo
>&Shift;&Alt;<keycap
>&amp;</keycap
></keycombo
>, 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.</para>

	</sect1>

</chapter>

<chapter id="completion">

	<title
>Completação de Código</title>
	
	<para
>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 <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &kile;...</guimenuitem
></menuchoice
>.</para>

	<sect1 id="complete_autoenvironment">

		<title
>Completação Automática de Ambientes</title>

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

		<para
>A completação automática poderá ser desactivada na secção do &latex; na opção <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>LaTeX</guimenuitem
><guilabel
>Ambientes</guilabel
></menuchoice
>.</para>

		<screenshot>
			<screeninfo
>Completar um Ambiente de Equação</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_autocomplete.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Completar um Ambiente de Equação</phrase>
			</textobject>
			<caption
><para
>Completar um Ambiente de Equação</para
></caption>
			</mediaobject>
		</screenshot>

	</sect1>
	
	<sect1 id="complete_command">
	
		<title
>Comandos de &latex;</title>

		<para
>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 <menuchoice
><guimenu
>Editar</guimenu
><guisubmenu
>Completar</guisubmenu
><guimenuitem
>Comando de LaTeX</guimenuitem
></menuchoice
> ou com o atalho de teclado <keycombo
>&Ctrl;<keycap
>Espaço</keycap
></keycombo
>. 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.</para>

		<screenshot>
			<screeninfo
>Completar um Comando do LaTeX</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="complete_cmd1.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Completar um Comando do LaTeX</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		<para
>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.</para>

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

		<para
>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 <menuchoice
><guimenu
>Editar</guimenu
><guisubmenu
>Pontos</guisubmenu
><guimenuitem
>Ponto Seguinte</guimenuitem
></menuchoice
> e inserir o parâmetro que deseja.</para>

		<screenshot>
			<screeninfo
>Completar um Comando do LaTeX</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="complete_cmd2.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Completar um Comando do LaTeX</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		<para
>Vá a <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>Kile</guimenuitem
><guimenuitem
>Completação</guimenuitem
></menuchoice
> 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.</para
> 
		
		<para
>Se escolher a opção <guimenuitem
>Mostrar os comandos de Latex</guimenuitem
>, 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.</para>

		<screenshot>
			<screeninfo
>Comandos do LaTex na barra lateral</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="command-view.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Comandos do LaTex na barra lateral</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>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.</para>

	</sect1>

	<sect1 id="complete_environment">

		<title
>Ambientes</title>
		
		<para
>O <emphasis
>modo de comandos</emphasis
> não é útil para ambientes completos. Terá sempre de escrever algumas letras do <userinput
>\begin</userinput
> 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 <userinput
>eq</userinput
>, por exemplo.</para
> 

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

		<screenshot>
			<screeninfo
>Completar um Comando do LaTeX</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="complete_env1.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Completar um Comando do LaTeX</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>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 <userinput
>\item</userinput
>.</para>
		
		<screenshot>
			<screeninfo
>Completar um Comando do LaTeX</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="complete_env2.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Completar um Comando do LaTeX</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		<para
>Vá a <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o &kile;...</guisubmenu
><guimenuitem
>Kile</guimenuitem
><guimenuitem
>Completação</guimenuitem
></menuchoice
> 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;.</para
> 

	</sect1>
	
	<sect1 id="complete_abbreviation">

		<title
>Abreviaturas</title>

		<para
>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 <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o &kile;...</guisubmenu
><guimenuitem
>Kile</guimenuitem
><guimenuitem
>Completação</guimenuitem
></menuchoice
> para configurar uma ou mais listas destas. Para o exemplo acima indicado, a lista de abreviaturas em <filename
>exemplo.cwl</filename
> deverá ser escolhido. Neste ficheiro, irá encontrar o item <userinput
>L=\LaTeX</userinput
>, por exemplo.</para>

		<para
>Vamos começar agora e escrever, por exemplo, apenas a letra <userinput
>L</userinput
>. Agora, invoque o modo de abreviatura da completação de palavras com <menuchoice
><guimenu
>Editar</guimenu
><guisubmenu
>Completar</guisubmenu
><guimenuitem
>Abreviaturas</guimenuitem
></menuchoice
> ou com o atalho de teclado <keycombo
><keycap
>&Ctrl;&Alt;</keycap
><keycap
>Espaço</keycap
></keycombo
> para a letra <userinput
>L</userinput
> ser substituída pelo texto <userinput
>\LaTeX</userinput
>.</para>
		
		<para
>A completação de abreviaturas também suporta a mudança de linha <userinput
>%n</userinput
> e o <userinput
>%C</userinput
> para colocar o cursor, caso estes caracteres estejam presentes no texto da expansão. Por isso, se tiver o item</para>

		<screen
><userinput
>en1=\begin{enumerate}%n\item %C%n\end{enumerate}%n</userinput
></screen>

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

		<screen
><userinput>
                \begin{enumerate}
                \item x
                \end{enumerate}</userinput
></screen>

		<sect2 id="complete_abbrev_view">
	
			<title
>Abreviaturas</title>

			<para
>Se escolher a opção <guimenuitem
>Mostrar as abreviaturas</guimenuitem
>, 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.</para>

		</sect2>

	</sect1>
	
	<sect1 id="complete_auto">

		<title
>Modos de Auto-Completação</title>

		<sect2 id="complete_autolatex">

			<title
>Comandos de &latex;</title>

			<para
>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.</para>

			<para
>Vá a <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o &kile;...</guisubmenu
><guimenuitem
>Kile</guimenuitem
><guimenuitem
>Completação</guimenuitem
></menuchoice
> para activar e desactivar este modo ou mudar o limite.</para>
			
		<screenshot>
			<screeninfo
>Completar um Ambiente de Equação</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="config-complete.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Completar um Ambiente de Equação</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		</sect2>
				
		<sect2 id="complete_autotext">

			<title
>Palavras do Documento</title>

			<para
>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 <keycombo
>&Ctrl;<keycap
>Espaço</keycap
></keycombo
>. Lembre-se que este modo é diferente do modo de completação dos comandos do &latex;.</para>

			<para
>Se quiser activar ou desactivar este modo, vá a <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>Editor</guimenuitem
><guimenuitem
>Edição</guimenuitem
><guimenuitem
>Completação Automática</guimenuitem
></menuchoice
>. 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.</para>
	
		</sect2
>	

	</sect1>
	
	<sect1 id="complete_own_files">

		<title
>Escrever os Próprios Ficheiros de Completação</title>

    <para
>A especificação do formato do ficheiro de completação pode ser encontrada na <ulink url="http://projects.kde.org/projects/extragear/office/kile/repository/revisions/master/raw/README.cwl"
> especificação do formato de ficheiros CWL</ulink
>. </para>

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

	</sect1>
</chapter>

<chapter id="wizard">

	<title
>Assistentes e Janelas</title>

	<sect1 id="wizard_graphics">

		<title
>Incluir Gráficos</title>

		<para
>The <guilabel
>Include Graphics</guilabel
> dialog makes insertion of graphics as easy as possible. Please take a look at <xref linkend="build_graphics"/> and <xref linkend="build_epsgraphics"/> to get an overview of some basic facts concerning graphic formats.</para>

		<screenshot>
			<screeninfo
>Incluir um elemento gráfico</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="includegraphics.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Incluir um elemento gráfico</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<procedure>
		<step
><para
>Choose a graphics file. This can be a JPEG, PNG, EPS or even a zipped or gzipped EPS file. If you have installed <ulink url="http://www.imagemagick.org/"
>&imagemagick;</ulink
> and also configured &kile; to use it (<menuchoice
><guimenu
>Settings</guimenu
><guisubmenu
>Configure Kile...</guisubmenu
> <guimenuitem
>LaTeX</guimenuitem
><guilabel
>General</guilabel
></menuchoice
>), 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.</para
></step>

		<step
><para
>Decida se a sua imagem deverá ficar centrada na página.</para
></step>

		<step
><para
>Choose either traditional &latex; or &pdflatex;. Please remember that &pdflatex; can also create &DVI; output, not only PDF.</para
></step>

		<step
><para
>You can choose whether the filename should be taken relative. This is the preferred way, when you use the <userinput
>\graphicspath</userinput
> command.</para>

		<para
>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 <userinput
>\graphicspath</userinput
> command, &kile; would include the path for the graphics file. But if you use <userinput
>\graphicspath</userinput
>, like:</para>

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

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

		<para
>Outro exemplo: se configurar o comando <userinput
>\graphicspath</userinput
> da seguinte forma:</para>

<programlisting
>\graphicspath{{./}{camara/}{imagens/}}
</programlisting>

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

		<step
><para
>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.</para
></step>

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

		<step
><para
>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 <link linkend="build_epsgraphics"
>imagens EPS</link
>. </para>
		
		<para
>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.</para
></step
> 

		<step
><para
>Scale the image by the desired scale factor. e.g, 0.5 to reduce by half, or 2 to double.</para
></step
> 
		
		<step
><para
>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.</para
></step
> 
		
		<step
><para
>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 <userinput
>fig:</userinput
> for images.</para
></step
> 
		
		<step
><para
>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 <userinput
>\usepackage{wrapfig}</userinput
> to the preamble and set some of the parameter here.</para
></step
> 
		</procedure>
		
	</sect1>
	
	<sect1 id="wizard_array">

		<title
>Array Wizard</title>

		<para
>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 <guimenu
>Wizard</guimenu
> menu. It contains <guimenuitem
>Tabular</guimenuitem
> and <guimenuitem
>Array</guimenuitem
> (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.</para>

		<screenshot>
			<screeninfo
>Inserir um ambiente tabular</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="dialog-tabular.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Inserir um ambiente tabular</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>The <guimenuitem
>Tabbing</guimenuitem
> 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.</para>
	</sect1>

	<sect1 id="wizard_postscript">

		<title
>Utilitários de &PostScript;</title>

		<para
>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 <command
>ps2pdf</command
>.</para>
		
		<para
>The <emphasis
>&PostScript; Wizard</emphasis
> will suggest the most popular rearrangements, but you are free to do your own choice. Work is done by the programs <command
>pstops</command
> and <command
>psselect</command
>, which you will find in most distributions in the package <userinput
>psutils</userinput
>. If one of these programs is not available, the corresponding item will not be visible.</para>
		
		<screenshot>
			<screeninfo
>Janelas das PSTools</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="dialog-pstools.png" format="PNG"/>
			</imageobject>
			<textobject>
				<phrase
>Janelas das PSTools</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>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.</para>
		
		<variablelist>
		
		<varlistentry>
		<term
>1 página A5 + página vazia --> A4</term>
		<listitem
><para
>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.</para>
		<screenshot>
			<screeninfo
>A5 + página vazia</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils1.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>A5 + página vazia</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
	
		<varlistentry>
		<term
>1 página A5 + duplicado --> A4</term>
		<listitem
><para
>Colocar uma página A5 e um duplicado em conjunto numa página A4.</para>
		<screenshot>
			<screeninfo
>páginas A5 duplicadas</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils2.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Duplicar uma página A5</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
		
		<varlistentry>
		<term
>2 páginas A5 --> A4</term>
		<listitem
><para
>Colocar sempre duas páginas A5 consecutivas numa única página A4.</para>
		<screenshot>
			<screeninfo
>combinar duas páginas A5</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils3.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>combinar duas páginas A5</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
		
		<varlistentry>
		<term
>2 páginas A5L --> A4</term>
		<listitem
><para
>Colocar duas páginas A5 consecutivas no modo paisagem em conjunto numa página A4.</para
></listitem>
		</varlistentry>
		
		<varlistentry>
		<term
>4 páginas A5 --> A4</term>
		<listitem
><para
>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.</para>
		<screenshot>
			<screeninfo
>4 páginas A5 --> A4</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils5.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>4 páginas A5 --> A4</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
		
		<varlistentry>
		<term
>1 página A4 + página vazia --> A4</term>
		<listitem
><para
>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.</para>
		<screenshot>
			<screeninfo
>1 página A4 + página vazia --> A4</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils6.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>1 página A4 + página vazia --> A4</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
		
		<varlistentry>
		<term
>1 página A4 + duplicado --> A4</term>
		<listitem
><para
>Colocar uma página A4 e um duplicado em conjunto numa página A4.</para>
		<screenshot>
			<screeninfo
>1 página A4 + duplicado --> A4</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils7.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>1 página A4 + duplicado --> A4</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
		
		<varlistentry>
		<term
>2 páginas A4 --> A4</term>
		<listitem
><para
>Colocar sempre duas páginas A4 consecutivas numa única página A4.</para>
		<screenshot>
			<screeninfo
>combinar duas páginas A4</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils8.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>combinar duas páginas A4</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>2 páginas A4L --> A4</term>
		<listitem
><para
>Colocar duas páginas A4 consecutivas, no modo de paisagem, numa única página A4.</para
></listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>escolher as páginas pares</term>
		<listitem
><para
>Seleccionar todas as páginas pares de um documento.</para
></listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>escolher as páginas ímpares</term>
		<listitem
><para
>Seleccionar todas as páginas ímpares de um documento.</para
></listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>escolher as páginas pares (ordem inversa)</term>
		<listitem
><para
>Seleccionar todas as páginas pares de um documento e inverter a ordem.</para
></listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>escolher as páginas ímpares (ordem inversa)</term>
		<listitem
><para
>Seleccionar todas as páginas pares de um documento e inverter a ordem.</para
></listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>inverter todas as páginas</term>
		<listitem
><para
>Inverter todas as páginas de um documento.</para
></listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>copiar todas as páginas (ordenado)</term>
		<listitem
><para
>Copiar todas as páginas de um documento. Terá de escolher o número de cópias ordenadas.</para>
		<screenshot>
			<screeninfo
>Copiar todas as páginas (ordenado)</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils15.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Copiar todas as páginas (ordenado)</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>copiar todas as páginas (não ordenado)</term>
		<listitem
><para
>Copiar todas as páginas de um documento. Terá de escolher o número de cópias não ordenadas.</para>
		<screenshot>
			<screeninfo
>Copiar todas as páginas (sem ordem)</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="psutils16.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Copiar todas as páginas (sem ordem)</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>pstops: escolha o parâmetro</term>
		<listitem
><para
>Existem muitas mais possibilidades para usar os utilitários de &PostScript; <command
>pstops</command
> e <command
>psselect</command
>. Se necessitar de uma opção muito especial, poderá invocar o comando <command
>pstops</command
> com uma opção à sua escolha. Leia por favor o manual para conhecer todas as opções possíveis.</para
></listitem>
		</varlistentry>
			
		<varlistentry>
		<term
>psselect: escolha o parâmetro</term>
		<listitem
><para
>Poderá invocar o comando <command
>psselect</command
> com uma opção à sua escolha. Veja por favor o manual para descobrir todas as opções possíveis.</para
></listitem>
		</varlistentry>
		
		</variablelist>
		
	</sect1>

	<sect1 id="statistics"
>	
		<title
>Estatísticas do Documento</title>
		
		<para
>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 <menuchoice
><guimenu
>File</guimenu
><guisubmenu
>Open All Project Files</guisubmenu
></menuchoice
> for an easy and quick way to open all source files of your project.</para>
		<para
>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.</para>
	</sect1>

</chapter>

<chapter id="latex">

	<title
>Marcas Especiais em &latex;</title>

	<sect1 id="latex_library">
		<title
>Usar a Biblioteca de Marcas do &latex;</title>

		<para
>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.</para>

		<screenshot>
			<screeninfo
>O Menu da Barra Lateral</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_sidebarmenu.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>O Menu da Barra Lateral</phrase>
			</textobject>
			<caption
><para
>A Barra Lateral</para
></caption>
			</mediaobject>
		</screenshot>
		<para
>Estão disponíveis os seguintes tipos:</para>

		<itemizedlist>
			<listitem
><para
>Os Mais Usados</para
></listitem>
			<listitem
><para
>Relação</para
></listitem>
			<listitem
><para
>Operadores</para
></listitem>
			<listitem
><para
>Setas</para
></listitem>
			<listitem
><para
>Matemática Diversa</para
></listitem>
			<listitem
><para
>Texto Diverso</para
></listitem>
			<listitem
><para
>Delimitadores</para
></listitem>
			<listitem
><para
>Grego</para
></listitem>
			<listitem
><para
>Caracteres Especiais</para
></listitem>
			<listitem
><para
>Caracteres Cirílicos</para
></listitem>
			<listitem
><para
>Definidos pelo Utilizador</para
></listitem>
		</itemizedlist>
		<para
>As dicas dos ícones mostram os comandos de &latex; e os pacotes adicionais necessários.</para>
		<para
>Se carregar em <keycombo
>&Shift;</keycombo
> e num símbolo, irá inserir um <userinput
>$\comando-símbolo$</userinput
>. Da mesma forma, se carregar em <keycombo
>&Ctrl;</keycombo
>, inseri-lo-á com chavetas.</para>
		<para
>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.</para>
		<para
>A primeira lista de símbolos contém os símbolos <guilabel
>Mais Usados</guilabel
>. 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.</para>
		<para
>A lista de símbolos <guilabel
>Definidos pelo Utilizador</guilabel
> 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 <ulink url="http://www.dvipng.sourceforge.net"
>&dvipng;</ulink
> (versão 1.7 ou posterior). O procedimento consiste em criar um ficheiro de &latex; com o <userinput
>\input{definitions}</userinput
>, o que faz com que os comandos abaixo fiquem disponíveis, fazendo com que o <userinput
>gesymb os-meus-simbolos.tex utilizador</userinput
> (que invoca o &latex; e o &dvipng;) crie os ícones. Depois de os copiar para a pasta <userinput
>$HOME/.kde/share/apps/kile/mathsymbols/user/</userinput
> e reinicie o 'kile', poderá usar os seus próprios símbolos. </para>
		<para
>Estão definidos os seguintes comandos em 'definitions.tex': <itemizedlist>
			<listitem>
				<para
><userinput
>\command[\arg-opcional]{\símbolo}</userinput
>: Inclui o símbolo <userinput
>\símbolo</userinput
> na lista de símbolos; o argumento opcional <userinput
>\arg-opcional</userinput
> define o comando que o kile deverá introduzir. Se não for indicado, é usado o comando no argumento obrigatório. </para>
			</listitem>
			<listitem>
				<para
><userinput
>\mathcommand[\arg-opcional]{\símbolo}</userinput
>: O mesmo que a anterior, excepto que o comando no argumento obrigatório é inserido no modo matemático. </para>
			</listitem>
			<listitem>
				<para
><userinput
>\pkgs[argumento]{pacote}</userinput
>: Declara que o comando indicado nesta linha precisa do pacote de &latex; <userinput
>pacote</userinput
> com o argumento opcional <userinput
>argumento</userinput
>. Este comando tem de estar à frente do comando <userinput
>\command</userinput
> e substitui todas as definições de pacotes do ambiente 'neededpkgs'. </para>
			</listitem>
			<listitem>
				<para
><userinput
>\begin{neededpkgs}[args-pacotes]{pacotes} ... \end{neededpkgs}</userinput
>: Tem o mesmo efeito que o anterior, mas serve para todos os comandos englobados por ele. </para>
			</listitem>
		</itemizedlist>
		</para>
		<para
>Um exemplo completo é dado aqui: <screen
><userinput>
                \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}
                </userinput
></screen>
		</para>
	</sect1>

	<sect1 id="latex_bib">

		<title
>Usar os Itens Bibliográficos</title>

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

		<para
>A <userinput
>[legenda]</userinput
> 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;</para>

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

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

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

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

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

		<para
>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 <guilabel
>Edit</guilabel
> toolbar click on the second drop-down box (usually it reads <guilabel
>label</guilabel
>) and select <guilabel
>cite</guilabel
>. 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 <menuchoice
><guimenu
>Edit</guimenu
><guimenuitem
>Refresh Structure</guimenuitem
></menuchoice
>, or press <keycap
>F12</keycap
>.</para>

		<para
>The final product in your document's bibliography would then look like this:</para>

		<para
><computeroutput
>[1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, Estados Unidos, 1998.</computeroutput
></para>

		<para
>The easiest way to work with <userinput
>\bibitem</userinput
> and <userinput
>\cite</userinput
> is to use the toolbar drop-down box marked <guilabel
>cite</guilabel
>. When you select a citation to insert, you will be given the list of <userinput
>bibitem</userinput
>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.</para>

	</sect1>

	<sect1 id="latex_usertags">

		<title
>Marcas Definidas pelo Utilizador</title>

		<para
>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 <userinput
>Prefiro o \LaTeX\ ao \TeX\</userinput
> e <userinput
>O que faria sem o &Linux;?</userinput
>. Para criar marcas definidas pelo utilizador para escrever estas frases, ele iria aceder à opção <menuchoice
><guimenu
>Utilizador</guimenu
><guisubmenu
>Marcas do Utilizador</guisubmenu
><guimenuitem
>Editar as Marcas do Utilizador...</guimenuitem
></menuchoice
>; isto irá apresentar-lhe uma janela em que ele poderá criar as suas próprias marcas.</para>
		<screenshot>
			<screeninfo
>A Janela de Edição de Marcas do Utilizador</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_editusertag.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>A Janela de Edição de Marcas do Utilizador</phrase>
			</textobject>
			<caption
><para
>A Janela de Edição de Marcas do Utilizador</para
></caption>
			</mediaobject>
		</screenshot>

		<screenshot>
			<screeninfo
>Invocar uma Marca Definida pelo Utilizador</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_usertag.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Invocar uma Marca Definida pelo Utilizador</phrase>
			</textobject>
			<caption
><para
>Invocar uma Marca Definida pelo Utilizador</para
></caption>
			</mediaobject>
		</screenshot>

		<para
>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 <guilabel
>Item do menu</guilabel
> e o texto do comando usado frequentemente seria indicado no campo <guilabel
>Valor</guilabel
>. Logo que os comandos forem introduzidos, ele podê-los-á usar rapidamente com o atalho <keycombo
>&Ctrl;&Shift; <keycap
>1</keycap
></keycombo
> para a primeira marca para introduzir <userinput
>Prefiro o \LaTeX\ ao \TeX\</userinput
> e o <keycombo
>&Ctrl;&Shift; <keycap
>2</keycap
></keycombo
> para introduzir o <userinput
>O que faria sem o &Linux;?</userinput
>.</para>

		<sect2 id="latex_usertags_uc">

			<title
>Substituições nas Marcas Definidas pelo Utilizador</title>

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

			<itemizedlist>
				<listitem
><para
><userinput
>%B</userinput
>: será substituído por um ponto.</para
></listitem>
				<listitem
><para
><userinput
>%C</userinput
>: aqui é onde o cursor será colocado depois de usar uma marca do utilizador.</para
></listitem>
				<listitem
><para
><userinput
>%M</userinput
>: corresponde ao texto marcado; o texto seleccionado é inserido no seu lugar ao usar as marcas definidas pelo utilizador.</para
></listitem>
				<listitem
><para
><userinput
>%S</userinput
>: será substituído pelo nome do ficheiro de código sem a extensão do ficheiro.</para
></listitem>
			</itemizedlist>

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

		</sect2>

	</sect1>

</chapter>

<chapter id="build">

	<title
>As Ferramentas de Construção</title>

	<sect1 id="build_sect">

		<title
>Compilar, converter e visualizar</title>

		<para
>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 <menuchoice
><guimenu
>Criar</guimenu
><guisubmenu
>Compilar</guisubmenu
></menuchoice
>, <menuchoice
><guimenu
>Criar</guimenu
><guisubmenu
>Converter</guisubmenu
></menuchoice
> e <menuchoice
><guimenu
>Criar</guimenu
><guisubmenu
>Ver</guisubmenu
></menuchoice
>.</para>

		<para
>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 <keycombo
>&Alt;<keycap
>2</keycap
></keycombo
>. Aí, poderá ver o ficheiro &DVI; com o seu visualizador por omissão com o <keycombo
>&Alt;<keycap
>3</keycap
></keycombo
>, converter o &DVI; para um ficheiro PS com o <keycombo
>&Alt;<keycap
>4</keycap
></keycombo
> e ver o ficheiro PS com o  <keycombo
>&Alt;<keycap
>5</keycap
></keycombo
>.</para>

		<sect2>

		<title
>&bibtex;</title>

			<para
>If you are using <ulink url="http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html"
>&bibtex;</ulink
> 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 <menuchoice
><guimenu
>Settings</guimenu
><guisubmenu
>Configure Kile...</guisubmenu
><guisubmenu
>Tools</guisubmenu
><guilabel
>Build</guilabel
></menuchoice
> in the <guilabel
>General</guilabel
> tab in the &latex; and &pdflatex; tools. </para>

		</sect2>

		<sect2>

			<title
>&makeidx;</title>

			<para
>If you are using the <ulink url="http://ipagwww.med.yale.edu/latex/makeindex.pdf"
>&makeidx;</ulink
> 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.</para>

		</sect2>

		<sect2>

			<title
>MetaPost e o &asymptote;</title>

			<para
>Se quiser compilar o seu documento com o <application
>MetaPost</application
> ou o <application
>&asymptote;</application
>, os programas de desenho de imagens, podê-lo-á fazer com a opção <menuchoice
><guimenu
>Criar</guimenu
><guisubmenu
>Compilar</guisubmenu
><guimenuitem
>Metapost</guimenuitem
></menuchoice
> ou <menuchoice
><guimenu
>Criar</guimenu
><guisubmenu
>Compilar</guisubmenu
><guimenuitem
>&asymptote;</guimenuitem
></menuchoice
>.</para>

		</sect2>
		
		<sect2>

			<title
>&pdflatex;</title>

			<para
>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 <keycombo
>&Alt;<keycap
>6</keycap
></keycombo
>: poderá então ver o ficheiro compilado se carregar em <keycombo
>&Alt;<keycap
>7</keycap
></keycombo
>.</para>

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

			<para
>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.</para>
			
		</sect2>

		<sect2>

			<title
>O &latex; para a Web</title>

			<para
>Finalmente, poderá querer publicar o seu trabalho na Web e não apenas no papel. Poderá então, neste caso, usar o programa <application
>latex2html</application
>, que poderá ser invocado a partir do menu do &kile; em <menuchoice
><guimenu
>Criar</guimenu
><guisubmenu
>Converter</guisubmenu
><guimenuitem
>LaTeX para Web</guimenuitem
></menuchoice
>. O resultado será colocado numa subpasta da pasta de trabalho, sendo para si possível ver o resultado da conversão com o item <menuchoice
><guimenu
>Criar</guimenu
><guisubmenu
>Ver</guisubmenu
><guimenuitem
>Ver o &HTML;</guimenuitem
></menuchoice
>.</para>

		</sect2>

		<sect2 id="build_cl">

			<title
>Passar Parâmetros da Linha de Comandos</title>

			<para
>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 <menuchoice
><guimenu
>Configuração</guimenu
> <guisubmenu
>Configurar o Kile...</guisubmenu
><guisubmenu
>Ferramentas</guisubmenu
><guilabel
>Compilar</guilabel
></menuchoice
>.</para>

		</sect2>
				
	</sect1>

	<sect1 id="build_preview">
		<title
>Antevisão Rápida</title>

		<para
>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 <emphasis
>Antevisão Rápida</emphasis
>, 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.</para
> 
		
		<screenshot>
			<screeninfo
>Antevisão Rápida</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="quickpreview.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Antevisão Rápida</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>Toda a configuração deverá ser feita em <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>Ferramentas</guimenuitem
><guimenuitem
>Antevisão</guimenuitem
></menuchoice
>.</para>

		<screenshot>
			<screeninfo
>Configuração da Antevisão Rápida</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="config-quickpreview.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Configuração da Antevisão Rápida</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<sect2 id="build_qp_selection">
		
			<title
>Modo de Selecção</title>

			<para
>The user has to select a part of the document. Menu entry <menuchoice
><guimenu
>Build</guimenu
><guisubmenu
>QuickPreview</guisubmenu
><guimenuitem
>Selection</guimenuitem
></menuchoice
> or the keyboard shortcut <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>P</keycap
></keycombo
>,<keycap
>S</keycap
> 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:</para>

			<itemizedlist>
			<listitem
><para
><application
>LaTeX+&DVI; (visualizador incorporado)</application
></para
></listitem>
			<listitem
><para
><application
>LaTeX+&DVI; (KDVI)</application
></para
></listitem>
			<listitem
><para
><application
>LaTeX+PS (visualizador incorporado)</application
></para
></listitem>
			<listitem
><para
><application
>LaTeX+PS (&okular;)</application
></para
></listitem>
			<listitem
><para
><application
>PDFLaTeX+PDF (visualizador incorporado)</application
></para
></listitem>
			<listitem
><para
><application
>PDFLaTeX+PDF (&okular;)</application
></para
></listitem>
			<listitem
><para
><application
>PDFLaTeX+PDF (&okular;)</application
></para
></listitem>
			</itemizedlist>

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

		</sect2>
		
		<sect2 id="build_qp_environment">
		
			<title
>Modo do Ambiente</title>
			
			<para
>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 <menuchoice
><guimenu
>Compilar</guimenu
><guisubmenu
>Antevisão Rápida</guisubmenu
><guimenuitem
>Ambiente</guimenuitem
></menuchoice
> ou o atalho de teclado <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>P</keycap
></keycombo
><keycap
>E</keycap
>, para que o ambiente actual seja compilado e apresentado.</para>

		</sect2>
		
		<sect2 id="build_qp_subdocument">
		
			<title
>Modo de Sub-Documento</title>
			
			<para
>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 <menuchoice
><guimenu
>Compilar</guimenu
><guisubmenu
>Antevisão Rápida</guisubmenu
><guimenuitem
>Sub-documento</guimenuitem
></menuchoice
> ou o atalho de teclado <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>P</keycap
></keycombo
><keycap
>D</keycap
>.</para
> 
			
		</sect2>

		<sect2 id="build_qp_mathgroup">
		
			<title
>Modo de Grupo Matemático</title>
			
			<para
>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 <menuchoice
><guimenu
>Construir</guimenu
><guisubmenu
>Antevisão Rápida</guisubmenu
><guimenuitem
>Grupo Matemático</guimenuitem
></menuchoice
> ou escolher o atalho de teclado <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>P</keycap
></keycombo
>,<keycap
>M</keycap
>.</para
> 
			
		</sect2>

		<sect2 id="qp_bottombar">
		
			<title
>Antevisão Rápida na Barra Inferior</title>
			
			<para
>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.</para
>	
			
		</sect2>

	</sect1
>	
		
	<sect1 id="build_graphics">

		<title
>Formatos de Ficheiros Gráficos</title>

		<sect2 id="build_graphics_latex">
		
		<title
>O &latex; e o &pdflatex;</title>
		
		<para
>O &pdflatex;, quando for usado com os pacotes <userinput
>graphics</userinput
> ou o <userinput
>graphicx</userinput
>, 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.</para
> 
		
		<para
>Diversos utilizadores desejam criar documentos PDF mas, por exemplo, tiram partido do pacote excelente <application
>Pstricks</application
> para criar imagens &PostScript;; ou, por outro lado, desejam usar o resultado em &PostScript; do 'software' matemático/científico, como o  <application
>Mathematica</application
>, o <application
>Maple</application
> ou o <application
>MuPAD</application
>. 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.</para>
		
		</sect2>
		
		<sect2 id="build_graphics_conversion">
		
		<title
>Conversão de Imagens</title>

		<para
>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:</para>

		<itemizedlist>
			<listitem
><para
>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 <application
>dvips</application
>. Irá ver que o &pdflatex; é uma escolha muito boa, se o seu código não tiver qualquer código em &PostScript;.</para
></listitem>
			
			<listitem
><para
>Poderá converter os ficheiros EPS para PNG ou outros formatos com alguns utilitários como o <ulink url="http://www.gimp.org/"
><application
>Gimp</application
></ulink
> ou o <ulink url="http://www.imagemagick.org/"
>&imagemagick;</ulink
> e usar o &pdflatex;.</para
></listitem>
			
			<listitem
><para
><anchor id="build_graphics_epstopdf"
></anchor
>Uma das formas preferidas é converter as imagens EPS para imagens PDF com o <command
>epstopdf</command
>, 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: <programlisting
>-dAutoFilterColorImages=false
        -dAutoFilterGrayImages=false
        -sColorImageFilter=FlateEncode
        -sGrayImageFilter=FlateEncode
        -dPDFSETTINGS=/prepress
        -dUseFlateCompression=true
</programlisting>
			</para>
			
			<para
>Ainda melhor: se o seu sistema permitir o <userinput
>shell-escape</userinput
>, a conversão poderá ser feita na altura. Tudo o que terá de fazer é incluir o pacote <application
>epstopdf</application
>, que faz parte de todas as distribuições do &tex;, com o comando <userinput
>\usepackage{epstopdf}</userinput
>. Assumindo que o seu código é <programlisting>
        \includegraphics[width=5cm]{teste.eps}
</programlisting
> Ao invocar o PDF&latex; com a opção <command
>pdflatex --shell-input</command
>, a imagem <filename
>teste.eps</filename
> é convertida automaticamente para <filename
>teste.pdf</filename
>.</para>
			
			<para
>Esta conversão irá tomar lugar de cada vez que você executar o &pdflatex;. Se o seu comando gráfico é dado implicitamente <programlisting>
        \includegraphics[width=5cm]{teste}
</programlisting
>, o <application
>epstopdf</application
> verifica se o <filename
>teste.pdf</filename
> já está disponível, de modo que o passo de conversão poderá ser ignorado.</para
></listitem>

			<listitem
><para
>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, <emphasis
>altamente</emphasis
> 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 <ulink url="http://www.imagemagick.org"
><application
>ImageMagick</application
></ulink
>. Outro programa simples que faz este processo correctamente é o <ulink url="http://www.tex.uniyar.ac.ru/win32/tools/jpg2ps/"
><application
>jpg2ps</application
></ulink
>. </para
></listitem>
			
			<listitem
><para
>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 <link linkend="build_epsgraphics"
>Imagens EPS</link
>.</para
></listitem>
			
		</itemizedlist>

		</sect2>
		
		<sect2 id="build_graphics_type">
		
		<title
>Use o ficheiro correcto para a imagem correcta</title>

	 	<itemizedlist>
			<listitem
><para
>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.</para
></listitem>
			<listitem
><para
>O PNG (ou o desactualizado &GIF;) é um formato de ficheiro <emphasis
>sem-perdas</emphasis
>, 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.</para
></listitem>
			<listitem
><para
>O JPG é um formato <emphasis
>com perdas</emphasis
> 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.</para
></listitem>
		</itemizedlist>

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

		</sect2>
		
	</sect1>

	<sect1 id="build_epsgraphics">
		
		<title
>Imagens EPS</title>
		
		<para
>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.</para>
		
		<sect2 id="build_graphics_eps">
		
		<title
>O &latex; e as Imagens EPS</title>

		<para
>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 <link linkend="build_graphics_conversion"
>conversores</link
>, como o <command
>convert</command
> do excelente pacote que é o <ulink url="http://www.imagemagick.org/"
><application
>&imagemagick;</application
></ulink
>. Contudo, é necessário algum tempo, como é óbvio.</para
> 
		
		<para
>Os ficheiros EPS são usados tanto pelo &latex; como pelos conversores &DVI;-PS:</para>
		
		<itemizedlist>
		<listitem
><para
>O &latex; procura no ficheiro EPS pela linha da caixa envolvente, a qual indica ao &latex; quanto espaço deverá reservar para a imagem.</para
></listitem>
		
		<listitem
><para
>O conversor &DVI;-PS lê então o ficheiro EPS e insere a imagem no ficheiro PS.</para
></listitem>
		</itemizedlist>

		<para
>Isto tem algumas implicações:</para>
 
		<itemizedlist>
		<listitem
><para
>O &latex; nunca lê o ficheiro EPS se os parâmetros da caixa envolvente forem indicados no comando de inserção da imagem.</para
></listitem>

		<listitem
><para
>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.</para
></listitem>
		
		<listitem
><para
>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.</para
></listitem>
		</itemizedlist>
		
		<para
>Agora poderá invocar o &latex;, e um conversor &DVI;-PS como o <application
>dvips</application
> para criar o seu documento em PostScript. Se o seu objectivo for um documento PDF, deverá executar o <application
>dvips</application
> com a opção <userinput
>-Ppdf</userinput
> e depois invocar o <command
>ps2pdf</command
>. Irá encontrar bastantes documentos que descrevem esta solução.</para>
	
		</sect2>
	
		<sect2 id="build_graphics_epskile">
		
		<title
>O Formato &PostScript; do &kile;</title>
		
		<para
>O &kile; ajuda-o a obter a informação da Caixa Envolvente. Se tiver instalado o <ulink url="http://www.imagemagick.org/"
>&imagemagick;</ulink
>, 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:</para>

		<itemizedlist>
		<listitem
><para
>A informação já está extraída durante a janela e não é preciso fazê-lo de novo pelo &latex;.</para
></listitem>
		<listitem
><para
>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.</para
></listitem>
		<listitem
><para
>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 <link linkend="build_graphics_bitmap"
>Imagens Rasterizadas</link
>.</para
></listitem
> 
		</itemizedlist>
	<!-- FIXME I don't understand the following sentence, tbraun	
		<para
> The <emphasis
>&PostScript; Way of &kile;</emphasis
> can be turned off or on in
		<menuchoice
><guimenu
>Settings</guimenu
><guisubmenu
>Configure Kile...</guisubmenu>
		<guimenuitem
>LaTeX</guimenuitem
><guilabel
>General</guilabel
></menuchoice
>.</para>
		-->
	</sect2>
		
	<sect2 id="build_graphics_bitmap">
		
		<title
>O Formato &PostScript; e as Imagens Rasterizadas</title>
		
		<para
>Se o seu sistema permitir o <userinput
>shell-escape</userinput
>, 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.</para>
		
		<para
>O &latex; necessita de alguma informação acerca dos sufixos de ficheiros. O pacote <userinput
>graphicx</userinput
> irá procurar por um ficheiro <filename
>graphics.cfg</filename
>, que deverá estar algures no seu local de procura de documentos do &latex;. Procure por itens do género:</para>

<programlisting
>\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}{}%
</programlisting>

		<para
>e substitua estas linhas por:</para>
		
<programlisting
>\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
</programlisting>

		<para
>Irá encontrar este ficheiro, por exemplo no <emphasis
>Debian</emphasis
> com a localização <filename
>/etc/texmf/latex/graphics.cfg</filename
>. 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;.</para>
		
		<para
>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 <command
>dvips</command
>. 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;.</para>
		
		<para
>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.</para>

		</sect2>
		
		<sect2 id="build_graphics_pdflatex">
		
		<title
>O &pdflatex; e as Imagens EPS</title>

		<para
>Tal como foi dito, o &pdflatex; não é capaz de lidar com ficheiros gráficos EPS; contudo, os conversores como o <link linkend="build_graphics_epstopdf"
>epstopdf</link
> poderão ajudar. A melhor forma é incluir o pacote <filename
>epstopdf</filename
>, o que deverá ser feito após carregar o pacote <userinput
>graphicx</userinput
>.</para>
		
<programlisting
>\usepackage[pdftex]{graphicx}
   \usepackage{epstopdf}
</programlisting>

		<para
>Agora já pode incluir imagens EPS, se executar o <command
>pdflatex</command
> com a opção <option
>--shell-escape</option
>. 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 <filename
>graphics.cfg</filename
>, como descrito acima. Desta vez, o texto a procurar será:</para>

<programlisting
>% pdfTeX is running in pdf mode
   \ExecuteOptions{pdftex}%
</programlisting>

		<para
>e bastará apenas adicionar algumas linhas.</para>
		
<programlisting
>% 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}}%
   }%
</programlisting>
		
		<para
>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.</para>
	
	</sect2>
		
	</sect1>
 
	<sect1 id="build_master">

		<title
>Documento-Mestre</title>

		<para
>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 <guimenu
>Configuração</guimenu
>, todos os comandos do menu <guimenu
>Ferramentas</guimenu
> aplicar-se-ão só a este documento, mesmo que esteja a lidar com os documentos-filhos. Poderá até fechar o documento-mestre.</para>
	</sect1>

	<sect1 id="build_errorhandling">

		<title
>Tratamento de Erros</title>

		<para
>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 <guilabel
>Registo e Mensagens</guilabel
>. Pode-se dar uma vista de olhos com atenção às mensagens ao seleccionar a opção <menuchoice
><guimenu
>Criar</guimenu
><guimenuitem
>Ver o Ficheiro de Registo</guimenuitem
></menuchoice
> ou usando o atalho de teclado <keycombo
>&Alt;<keycap
>0</keycap
></keycombo
>. O registo gerado é então apresentado na janela de <guilabel
>Registo&nbsp;/&nbsp;Mensagens</guilabel
>; os erros e os avisos ficam então realçados.</para>

		<screenshot>
			<screeninfo
>Ver o registo</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_compile_error.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Ver o registo</phrase>
			</textobject>
			<caption
><para
>Ver o registo</para
></caption>
			</mediaobject>
		</screenshot>

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

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

	</sect1>

	<sect1 id="build_watch">

			<title
>O Modo de Vigiar Ficheiro</title>

			<para
>Quando invocar a <guibutton
>Construção Rápida</guibutton
>, 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.</para>

			<para
>Se estiver a ajustar a aparência do seu documento, poderá invocar a <guibutton
>Construção Rápida</guibutton
> 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 <guibutton
>Vigiar o ficheiro</guibutton
>, o que irá evitar que a <guibutton
>Construção Rápida</guibutton
> lance um visualizador.</para>
			
			<para
>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.</para>

	</sect1>

</chapter>

<chapter id="navigating">

	<title
>Navegar no Código &latex;</title>

	<sect1 id="navigating_struct">

		<title
>Utilizar a Vista de Estrutura</title>

		<para
>A área da <guilabel
>Estrutura</guilabel
> 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.</para>
		
		<para
>Se incluiu um ficheiro de &latex; separado no sue código com as marcas <userinput
>\input</userinput
> ou <userinput
>\include</userinput
>, estes ficheiros ficarão referenciado na área da <guilabel
>Estrutura</guilabel
>; se fizer duplo-click nos seus nomes, irá fazer com que o &kile; abra o ficheiro incluído na janela do editor.</para>
		
		<para
>A árvore da hierarquia também tem um ramo em separado para as legendas usadas no texto.</para>

		<screenshot>
			<screeninfo
>Utilizar a Vista de Estrutura</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_structview_label.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Utilizar a Vista de Estrutura</phrase>
			</textobject>
			<caption
><para
>Using the Structure View</para
></caption>
			</mediaobject>
		</screenshot>

		<sect2 id="navigating_contextmenu">

			<title
>Usar o Menu de Contexto</title>

			<para
>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.</para>
			
			<screenshot>
				<screeninfo
>Utilizar a Vista de Estrutura</screeninfo>
				<mediaobject>
				<imageobject>
				<imagedata fileref="structureview.png" format="PNG"/>
				</imageobject>
				<textobject>
				<phrase
>Utilizar a Vista de Estrutura</phrase>
				</textobject>
				</mediaobject>
			</screenshot>
			
			<para
>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 <guibutton
>Select</guibutton
>, <guibutton
>Delete</guibutton
> or <guibutton
>Comment</guibutton
> will work with all lines, which belong to this section.</para>
	
			<screenshot>
				<screeninfo
>Menu de contexto para os itens de secções</screeninfo>
				<mediaobject>
				<imageobject>
				<imagedata fileref="structureview-context1.png" format="PNG"/>
				</imageobject>
				<textobject>
				<phrase
>Menu de contexto para os itens de secções</phrase>
				</textobject>
				</mediaobject>
			</screenshot>

			<para
>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.</para>

			<screenshot>
				<screeninfo
>Menu de contexto para as tabelas/figuras e elementos gráficos</screeninfo>
				<mediaobject>
				<imageobject>
				<imagedata fileref="structureview-context2.png" format="PNG"/>
				</imageobject>
				<textobject>
				<phrase
>Menu de contexto para as tabelas/figuras e elementos gráficos</phrase>
				</textobject>
				</mediaobject>
			</screenshot>

			</sect2>

		<sect2 id="navigating_update">

			<title
>Actualizar a Vista de Estrutura</title>

			<para
>Para actualizar a sua área da estrutura, poderá tanto ir ao item <menuchoice
><guimenu
>Editar</guimenu
><guimenuitem
>Actualizar Estrutura</guimenuitem
></menuchoice
>, carregue em <keycombo
><keycap
>F12</keycap
></keycombo
> ou poderá gravar o seu documento, o que fará com que o &kile; actualize a sua área de <guilabel
>Estrutura</guilabel
>.</para>

		</sect2>

	</sect1>

	<sect1 id="navigating_bookmarks">

		<title
>Favoritos</title>

		<para
>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 <keycombo
>&Ctrl; <keycap
>B</keycap
></keycombo
>, 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 <menuchoice
><guimenu
>Favorito</guimenu
><guimenuitem
>Comutar o Favorito</guimenuitem
></menuchoice
>.</para>

		<para
>Para remover todos os seus favoritos, seleccione os <menuchoice
><guimenu
>Favoritos</guimenu
> <guimenuitem
>Limpar Todos os Favoritos</guimenuitem
></menuchoice
>.</para>

    <para
>Please note that currently the bookmarks are not saved after exiting &kile;.</para>

	</sect1>

</chapter>

<chapter id="projects">

	<title
>Projectos</title>

	<sect1 id="projects_working">
	
		<title
>Trabalhar com Projectos</title>

		<para
>No &kile;, poderá criar e trabalhar com os <emphasis
>projectos</emphasis
>. 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 <literal role="extension"
>.tex</literal
> 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 <literal role="extension"
>.kilepr</literal
>.</para>

		<para
>Um projecto adiciona as seguintes funcionalidades:</para>

		<itemizedlist>
			<listitem
><para
>Não precisa de definir nenhum documento-mestre; o &kile; fará isto automaticamente.</para
></listitem>
			<listitem
><para
>Os ficheiros do projecto poderão ser arquivados facilmente em conjunto com a opção <menuchoice
><guimenu
>Construir</guimenu
><guisubmenu
>Outro</guisubmenu
><guimenuitem
>Arquivar</guimenuitem
></menuchoice
></para
></listitem>
			<listitem
><para
>A área dos <guilabel
>Ficheiros e Projectos</guilabel
> mostra quais os ficheiros que estão incluídos no projecto.</para
></listitem>
			<listitem
><para
>Depois de abrir um projecto, todos os ficheiros que foram abertos anteriormente serão repostos com a codificação e realce originais.</para
></listitem>
      <listitem
><para
>A completação de código funciona em todos os ficheiros do projecto.</para
></listitem
> 
      <listitem
><para
>A completação de referências funciona em todos os ficheiros do projecto.</para
></listitem
> 
      <listitem
><para
>A completação de citações funciona em todos os ficheiros do projecto.</para
></listitem
> 
      <listitem
><para
>Procurar em todos os ficheiros do projecto.</para
></listitem
> 
      <listitem
><para
>Indicar um comando de compilação e do &makeidx; personalizado.</para
></listitem>
		</itemizedlist>

	</sect1>

	<sect1 id="projects_creating">

		<title
>Criar um Projecto</title>

		<para
>Para criar um projecto, seleccione a opção <menuchoice
><guimenu
>Projecto</guimenu
> <guimenuitem
>Novo Projecto...</guimenuitem
></menuchoice
>. Ser-lhe-ão pedidas as seguintes informações para criar o seu projecto:</para>
		<itemizedlist>
			<listitem
><para
>Título do seu projecto.</para
></listitem>
			<listitem
><para
>Nome do ficheiro de projecto com a extensão <literal role="extension"
>.kilepr</literal
>.</para
></listitem>
			<listitem
><para
>Nome do ficheiro.</para
></listitem>
			<listitem
><para
>O tipo do ficheiro a criar: Documento Vazio, Artigo, Livro, Carta, Relatório, ....</para
></listitem>
		</itemizedlist>

		<para
>Quando preencher o campo do <guilabel
>nome do ficheiro</guilabel
>, terá de incluir uma referência relativa do local onde o ficheiro <literal role="extension"
>.kilepr</literal
> está guardado para o ficheiro do documento em si.</para>

	</sect1>

	<sect1 id="projects_view">

		<title
>A Área dos Ficheiros e Projectos</title>

		<para
>A área dos <guilabel
>Ficheiros e do Projecto</guilabel
> é um botão do menu lateral. Nesta área, poderá ver a estrutura do seu projecto, os seus ficheiros e o nome do ficheiro <literal role="extension"
>.kilepr</literal
> 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 <guilabel
>Ficheiros e Projectos</guilabel
>.</para>

		<screenshot>
			<screeninfo
>A Área dos Ficheiros e Projectos</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_projectview.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>A Área dos Ficheiros e Projectos</phrase>
			</textobject>
			<caption
><para
>A Área dos Ficheiros e Projectos</para
></caption>
			</mediaobject>
		</screenshot>

	</sect1>

	<sect1 id="projects_adding">

		<title
>Adicionar e Remover Ficheiros</title>

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

		<para
>Se tiver vários ficheiros para adicionar a um projecto, poderá seleccionar o projecto em si na área dos <guilabel
>Ficheiros e Projectos</guilabel
> e carregar com o botão direito e seleccionar a opção <guilabel
>Adicionar Ficheiros...</guilabel
>; poderá então seleccionar os seus ficheiros numa janela.</para>
		
<!--		<para
>You can also right-click on the project's name in the <guilabel
>Files and 
		Projects</guilabel
> view, and select <guilabel
>Add Files...</guilabel
> to bring
		up a file selection dialog.</para>
-->
		<screenshot>
			<screeninfo
>Adicionar um ficheiro a um projecto</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="snap_projectview_add.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Adicionar um ficheiro a um projecto</phrase>
			</textobject>
			<caption
><para
>Adicionar um ficheiro a um projecto</para
></caption>
			</mediaobject>
		</screenshot>

		<para
>Para remover um ficheiro de um projecto, carregue com o botão direito do rato nele e seleccione a opção <guilabel
>Remover o Ficheiro</guilabel
>. Isto <emphasis
>não</emphasis
> remove de facto o seu ficheiro (e também não o fecha), mas só o retira da lista de ficheiros contida no ficheiro <literal role="extension"
>.kilepr</literal
>.</para>

	</sect1>

	<sect1 id="projects_options">

		<title
>Opções do Projecto</title>

		<para
>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 <guilabel
>Opções do Projecto</guilabel
>, onde poderá então alterar:</para>

		<itemizedlist>
			<listitem
><para
>O título do seu projecto.</para
></listitem>
 			<listitem
><para
>O documento-mestre.</para
></listitem>
 			<listitem
><para
>O comando de Compilação Rápida.</para
></listitem>
 			<listitem
><para
>As opções do &makeidx;.</para
></listitem>
		</itemizedlist>

		<sect2 id="projects_archive">

			<title
>Arquivar o seu Projecto</title>

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

			<para
>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 <guilabel
>Ficheiros e Projectos</guilabel
> e desligue a opção <guilabel
>Incluir no Arquivo</guilabel
>.</para>

			<para
>Archive commands are simple shell commands that are executed from the project folder (where the <literal role="extension"
>.kilepr</literal
> file is located).</para>

		</sect2>

<!-- FIXME not working in kile, tbraun 11/3/2007
		<sect2 id="projects_ext">

			<title
>Extensions for Non-Source Files</title>

			<para
>Non-source files are files such as pictures, PDF or &PostScript; files, etc. that are 
			to be included in the project, but are not source files with the extension <literal role="extension"
>.tex</literal
>. You have 
			the option to use your own regular expressions to match non-source files.</para>
		</sect2>
-->

	</sect1>

	<sect1 id="projects_closing">

		<title
>Fechar um Projecto</title>

		<para
>Para fechar um projecto, seleccione a área <guilabel
>Ficheiros e Projectos</guilabel
> na barra de ferramentas vertical, carregue com o botão direito do rato e seleccione então a opção <guimenuitem
>Fechar</guimenuitem
>. 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 <guisubmenu
>Abrir um Projecto Recente...</guisubmenu
> do menu <guimenu
>Projecto</guimenu
>.</para>

	</sect1>

</chapter>

<chapter id="lang">

	<title
>Codificação do Documento</title>

	<para
>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:</para>

	<itemizedlist>
		<listitem
><para
>One way to set the encoding is to use the <guilabel
>Set encoding</guilabel
> combo box, located at the bottom of the <guilabel
>Open File</guilabel
> sidebar view.</para
></listitem>
		<listitem
><para
>Another way is using the submenu <menuchoice
><guimenu
>Settings</guimenu
><guisubmenu
>Configure Kile...</guisubmenu
><guimenuitem
>Editor</guimenuitem
></menuchoice
>, where you can set the default character encoding for all files.</para>
		<screenshot>
			<screeninfo
>Definir a codificação predefinida</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="config-encoding.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Definir a codificação predefinida</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		</listitem>
		<listitem
><para
>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.</para
></listitem>
	</itemizedlist>

	<para
>&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 <userinput
>\"e</userinput
> for <computeroutput
>ë</computeroutput
>. There is a package to help you with this, called <application
>inputenc</application
>, and is included in the preamble using <userinput
>\usepackage[latin1]{inputenc}</userinput
>, where the optional argument is the encoding you would like to use (nowadays in most cases <userinput
>utf8x</userinput
>). This tells &latex; to translate all of the <userinput
>ë</userinput
>'s you wrote to <userinput
>\"e</userinput
>'s before compiling. Please refer to the <application
>inputenc</application
> documents directly for more information on <application
>inputenc</application
>. Last but not least: remember to make sure that your file is <emphasis
>actually</emphasis
> encoded in the same encoding you told <application
>inputenc</application
>!</para>

	<screenshot>
		<screeninfo
>Choosing the source file's encoding</screeninfo>
		<mediaobject>
		<imageobject>
		<imagedata fileref="snap_encoding.png" format="PNG"/>
		</imageobject>
		<textobject>
		<phrase
>Choosing the source file's encoding</phrase>
		</textobject>
		<caption
><para
>Choosing the source file's encoding</para
></caption>
		</mediaobject>
	</screenshot>

	<para
>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 <ulink url="http://www.unicode.org"
>Unicode</ulink
>. There are many implementations of Unicode, and <abbrev
>UTF-8</abbrev
> is the most successful in &Linux;; &Windows;&reg; relies instead on the more cumbersome and less flexible <abbrev
>UCS-2</abbrev
>. Some distributions, as RedHat, have already begun setting their default encoding to <abbrev
>UTF-8</abbrev
>, and therefore you may be very interested in using of the <userinput
>utf8x</userinput
> argument to the <userinput
>inputenc</userinput
> package.</para>

	<sect1 id="ucs">
	
		<title
>O Pacote &ucs;</title>
		<para
>Se não tiver o pacote &ucs; instalado, poderá proceder da seguinte forma:</para>
		<itemizedlist>
		<listitem
><para
>Get the &ucs; package from the home page of <ulink url="http://www.unruh.de/DniQ/latex/unicode/"
>Unicode support for &latex;</ulink
>, by Dominique Unruh from the University of Karlsruhe.</para
></listitem>
		<listitem>
		<para
>To install it, unpack the downloaded file and place it in a folder listed in your $<envar
>TEXINPUTS</envar
> envirnoment variable. This can also be set inside kile.</para>
		</listitem>
		</itemizedlist>
		
		<screen
><userinput>
                \usepackage{ucs}
                \usepackage[utf8x]{inputenc}</userinput
></screen>

	</sect1>
	
	<sect1 id="xelatex">
	
		<title
>XeLaTeX</title>
		
		<para
>If you are using <userinput
>XeLaTeX</userinput
> you can simply load the <userinput
>xltxtra</userinput
> package. It will load all required packages.</para>
		<screen
><userinput>
                \usepackage{xltxtra}</userinput
></screen>
		
	</sect1>

	<sect1 id="cjk">
		
		<title
>Suporte de &cjk;</title>
		
		<para
>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.</para>
		
		<tip
><para
>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!</para
></tip>
		
		<para
>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 <ulink url="http://www.ece.uci.edu/~chou/"
>Pai H. Chou</ulink
>'s <ulink url="http://www.ece.uci.edu/~chou/unicode-tex.html"
>page about how to setup &pdflatex;</ulink
>.</para>
		
		<orderedlist>
		
		<listitem
><para
>Download the <ulink url="http://www.ctan.org/tex-archive/help/Catalogue/entries/cjk.html"
>&cjk;</ulink
> package. Copy its unpacked files to an appropriate subfolder of $<envar
>TEXMF</envar
>, just like you did with the &ucs; package before (see <xref linkend="ucs"/>). The files will be unpacked in a <filename
>CJK/X_Y.Z</filename
> folder, it is not important that you take them out, though it will probably be tidier for you to maintain.</para
></listitem>
		
		<listitem
><para
>Now you have to download a font that supports all the &cjk; characters you need. You can choose any <literal role="extension"
>*.ttf</literal
> file that covers them, but in this walkthrough we will use <ulink url="ftp://ftp.netscape.com/pub/communicator/extras/fonts/windows/Cyberbit.ZIP"
>Cyberbit</ulink
>. Unzip the file and rename <filename
>Cyberbit.ttf</filename
> to <filename
>cyberbit.ttf</filename
>, since uppercase might confuse your system.</para>
		<para
>Coloque o <filename
>cyberbit.ttf</filename
> numa pasta em conjunto com o <ulink url="http://delloye.free.fr/Unicode.sfd"
><filename
>Unicode.sfd</filename
></ulink
> e gere os ficheiros <literal role="extension"
>*.tfm</literal
> e <literal role="extension"
>*.enc</literal
> com o comando <command
>$ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@</command
>. 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 <ulink url="http://www.ece.uci.edu/~chou/unicode/cyberbit-tfm.tgz"
><literal role="extension"
>*.tfm</literal
></ulink
> como os <ulink url="http://www.ece.uci.edu/~chou/unicode/cyberbit-enc.tgz"
><literal role="extension"
>*.enc</literal
></ulink
>.</para>
		<para
>Coloque os ficheiros <literal role="extension"
>*.tfm</literal
> numa pasta apropriada, como por exemplo <filename
>$<envar
>TEXMF</envar
>/fonts/tfm/bitstream/cyberbit/</filename
>; os ficheiros <literal role="extension"
>*.enc</literal
> poderão estar instalados na pasta <filename
>$<envar
>TEXMF</envar
>/pdftex/enc/cyberbit/</filename
>.</para
></listitem>
		
		<listitem
><para
>Agora, é necessário um ficheiro de mapa para ligar os ficheiros <literal role="extension"
>*.enc</literal
> ao tipo de letra. Obtenha o <ulink url="http://delloye.free.fr/cyberbit.map"
><filename
>cyberbit.map</filename
></ulink
> e instale-o em <filename
>$<envar
>TEXMF</envar
>/pdftex/config/</filename
>.</para
></listitem>
		
		<listitem
><para
>Obtenha outro ficheiro, o <ulink url="http://delloye.free.fr/c70cyberbit.fd"
><filename
>c70cyberbit.fd</filename
></ulink
> e coloque-o numa pasta apropriada. Poderá escolher, por exemplo, o <filename
>$<envar
>TEXMF</envar
>/tex/misc/</filename
>.</para
></listitem>
		
		<listitem
><para
>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 <command
>$ ttf2pfb cyberbit.ttf -o cyberbit.pfb</command
> e copie o ficheiro resultante <filename
>cyberbit.pfb</filename
> numa pasta como a <filename
>$<envar
>TEXMF</envar
>/fonts/type1/cyberbit/</filename
>.</para
></listitem>
		
		<listitem
><para
>Coloque-se então o <filename
>cyberbit.ttf</filename
> entre os tipos de letra, onde o &latex; o possa encontrar. Poderá colocá-lo numa pasta chamada <filename
>$<envar
>TEXMF</envar
>/fonts/truetype/</filename
>.</para
></listitem>
		
		<listitem
><para
>Verifique o ficheiro de configuração que encontra em <filename
>$<envar
>TEXMF/web2c</envar
>/texmf.cnf</filename
> e certifique-se que a linha que menciona o <envar
>TTFONTS</envar
> está sem comentários e aponta para a pasta onde gravou o <filename
>cyberbit.ttf</filename
>.</para
></listitem>
		
		<listitem
><para
>Para possibilitar ao &pdflatex; usar os seus tipos de letra do &cjk;, é necessário que adicione uma linha ao ficheiro de configuração <filename
>$<envar
>TEXMF</envar
>/pdftex/config/pdftex.cfg</filename
>. Adicione o texto <userinput
>map +cyberbit.map</userinput
> no ficheiro para completar a configuração no &pdflatex;.</para
></listitem>
		
		<listitem
><para
>To configure &latex; so that you can produce &DVI; files with &cjk; characters, you have to add a line in file <filename
>ttfonts.map</filename
>. The file might be in a folder named <filename
>$<envar
>TEXMF</envar
>/ttf2pk/</filename
>, but you will probably have to look for it. Add the line <userinput
>cyberbit@Unicode@ cyberbit.ttf</userinput
> into it.</para
></listitem>
		
		<listitem
><para
>Agora, só terá de correr o <userinput
><command
>texhash</command
></userinput
> para que o sistema fique pronto.</para
></listitem>
		
		</orderedlist>
		
		<para
>Para testar se a sua configuração ficou correcta, poderá tentar compilar <ulink url="http://www.math.nus.edu.sg/aslaksen/cs/sample-utf8.tex"
>este ficheiro de teste</ulink
>.</para>
		
		<sect2>
			<title
>Resolução de Problemas com &cjk;</title>
			
			<para
>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.</para>
			
			<itemizedlist>
			
			<listitem
><para
>Obviamente, dado que executa o &latex; como um utilizador normal e não como 'root', deverá <emphasis
>permitir</emphasis
> aos utilizadores normais acederem aos ficheiros novos. Certifique-se que todas as pastas e ficheiros estão acessíveis com o comando <command
>chmod</command
>.</para
></listitem>
			
			<listitem
><para
>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 <literal role="extension"
>*.pk</literal
>. 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 <filename
>ttfonts.map</filename
> à procura da sua linha personalizada, em primeiro lugar. Contudo, poderá acontecer que o seu comando <command
>ttf2pk</command
>, que é invocado normalmente pelo visualizador de &DVI;s, tenha sido compilado <emphasis
>sem</emphasis
> o suporte para as bibliotecas do <application
>kpathsea</application
>. Se for este o caso, o <userinput
><command
>$ ttf2pk</command
><option
>--version</option
></userinput
> não fará menção alguma ao <application
>kpathsea</application
>. Como o suporte para estas bibliotecas é necessário, poderá ter de encontrar um novo pacote ou recompilar você mesmo o <application
>FreeType 1</application
>.</para
></listitem>
			
			</itemizedlist>
			
		</sect2>
			
		
		<sect2>
		
			<title
>Como é que introduzo caracteres do &cjk; em Unicode?</title>
			
			<para
>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 <ulink url="http://www.scim-im.org/projects/skim"
><application
>Skim</application
></ulink
>, uma versão para o &kde; do motor <ulink url="http://www.scim-im.org"
><application
>Scim</application
></ulink
>. 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 <application
>Skim</application
>, terá de definir uma variável de ambiente <userinput
><envar
>XMODIFIERS</envar
>="@im=SCIM"</userinput
> <emphasis
>antes</emphasis
> de iniciar o <application
>X</application
>.</para>
		
		</sect2>
	
	</sect1>

</chapter>

<chapter id="scripting">

	<title
>Programação</title>

	<sect1 id="scripting_test">

		<title
>Programação no &kile;</title>

		<para
>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. </para>

	</sect1>

	<sect1 id="scripting_api">

		<title
>Referência da API</title>

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

		<important>
			<para
>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;. </para>
		</important>

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

		<variablelist>
			<varlistentry>
				<term
>(kile).<function
>currentTextDocument()</function
></term>
				<listitem>
					<para
>Devolve um objecto <classname
>KileTextDocument</classname
> que reflecte o documento activo de momento. Devolve <constant
>null</constant
> se não estiver activo nenhum documento. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(kile).<function
>getInputValue(<parameter
>titulo</parameter
>, <parameter
>legenda</parameter
>)</function
></term>
				<listitem>
					<para
>Abre uma janela com o título e legenda indicados. Devolve o valor introduzido pelo utilizador. </para>
				</listitem>
			</varlistentry>
		</variablelist>

		<para
>Os objectos do tipo <classname
>KileTextDocument</classname
> representam os documentos de texto no &kile;. Têm as seguintes propriedades: </para>

		<variablelist>
			<varlistentry>
				<term
>(KileTextDocument).<function
>backspace()</function
></term>
				<listitem>
					<para
>Apaga o carácter localizado imediatamente antes da posição actual do cursor e recua o cursor uma posição no texto. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>cursorLeft()</function
></term>
				<listitem>
					<para
>Move o cursor uma posição para trás no texto.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>cursorRight()</function
></term>
				<listitem>
					<para
>Move o cursor uma posição para a frente no texto.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>insertText(<parameter
>texto</parameter
>)</function
></term>
				<listitem>
					<para
>Insere o texto na variável <parameter
>texto</parameter
> no documento, na posição actual do cursor. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>insertBullet()</function
></term>
				<listitem>
					<para
>Insere um ponto de tópico na posição actual do cursor no documento.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>nextBullet()</function
></term>
				<listitem>
					<para
>Selecciona o primeiro ponto localizado no documento, imediatamente a seguir à posição actual do cursor. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>previousBullet()</function
></term>
				<listitem>
					<para
>Selecciona o primeiro ponto localizado no documento, imediatamente antes da posição actual do cursor. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>up()</function
></term>
				<listitem>
					<para
>Sobe o cursor uma posição no documento.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>down()</function
></term>
				<listitem>
					<para
>Desce o cursor uma posição no documento.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>cursorLine()</function
></term>
				<listitem>
					<para
>Devolve a linha onde o cursor se encontra de momento.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>cursorColumn()</function
></term>
				<listitem>
					<para
>Devolve a coluna onde o cursor se encontra de momento.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>setCursorLine(<parameter
>linha</parameter
>)</function
></term>
				<listitem>
					<para
>Move o cursor para a linha indicada por <parameter
>linha</parameter
>.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term
>(KileTextDocument).<function
>setCursorColumn(<parameter
>coluna</parameter
>)</function
></term>
				<listitem>
					<para
>Move o cursor para a coluna indicada por <parameter
>coluna</parameter
>.</para>
				</listitem>
			</varlistentry>
		</variablelist>

	</sect1>
	
</chapter>

<chapter id="help">
	
	<title
>Ajuda</title>
	
	<sect1 id="help_documents">
		
		<title
>Documentos de Ajuda</title>

		<para
>&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.</para>

		<variablelist>

		<varlistentry>
		<term
><guimenu
>Referência de LaTeX</guimenu
></term
> 
		<listitem
><para
>Um índice alfabético com os comandos mais comuns do &latex;.</para
></listitem>
		</varlistentry>
		
		<varlistentry>
		<term
><guimenu
>Documentação TeX</guimenu
></term>
		<listitem
><para
>&tetex;/&texlive; comes with a huge amount of documents. This includes a documentation for all included packages and an additional &latex; reference.</para
></listitem>
		</varlistentry>

		<varlistentry>
		<term
><guimenu
>LaTeX</guimenu
></term>
		<listitem
><para
>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&mdash;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.</para
></listitem>
		</varlistentry>

		<varlistentry>
		<term
><guimenu
>Comando LaTeX</guimenu
></term>
		<listitem
><para
>Outro índice alfabético dos comandos mais comuns do &latex;.</para
></listitem>
		</varlistentry>

		<varlistentry>
		<term
><guimenu
>Assunto LaTeX</guimenu
></term>
		<listitem
><para
>Uma descrição de assuntos importantes do &latex;.</para
></listitem>
		</varlistentry>

		<varlistentry>
		<term
><guimenu
>Env LaTeX</guimenu
></term>
		<listitem
><para
>Um índice alfabético dos ambientes de &latex; mais comuns.</para
></listitem>
		</varlistentry>

		</variablelist>
		
	</sect1>
	
	<sect1 id="help_contextsentitive">
	
		<title
>Ajuda de Contexto</title>

		<para
>O &kile; suporta também uma ajuda dependente do contexto, a qual é invocada com o comando <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>H</keycap
></keycombo
><keycap
>K</keycap
>. Em <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Configurar o Kile...</guisubmenu
><guimenuitem
>Kile</guimenuitem
><guimenuitem
>Ajuda</guimenuitem
></menuchoice
>, 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.</para>

		<screenshot>
			<screeninfo
>Pontos</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="config-userhelp.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Pontos</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

	</sect1>
	
	<sect1 id="help_search">
	
		<title
>Procurar por Palavras-Chave</title>
		
		<para
>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 <application
>texdoctk</application
>. It comes with a database of all documents that &kile; uses to offer an interface to it.</para>

		<screenshot>
			<screeninfo
>Pontos</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="dialog-docbrowser1.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Pontos</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>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.</para
> 
		
		<screenshot>
			<screeninfo
>Pontos</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="dialog-docbrowser2.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Pontos</phrase>
			</textobject>
			</mediaobject>
		</screenshot>
		
		<para
>A mouse double click or the <keycap
>Space</keycap
> 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.</para>

		
	</sect1>
	
	<sect1 id="help_userdefined">
	
		<title
>Ajuda Definida pelo Utilizador</title>
	
		<para
>Beside this static &tetex;/&texlive; documentation, &kile; supports also another variable way for user-help documents. In <guimenu
>Help</guimenu
> menu &kile; has a special <guimenu
>User help</guimenu
> 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.</para
> 

		<para
>Go to <menuchoice
><guimenu
>Settings</guimenu
><guisubmenu
>Configure Kile...</guisubmenu
> <guimenuitem
>Kile</guimenuitem
><guilabel
>Help</guilabel
></menuchoice
> and choose <guibutton
>Configure</guibutton
> button to configure this <guimenu
>User help</guimenu
> menu. You can add, remove or navigate menu entries, and also insert separators to get a better structure.</para>

		<screenshot>
			<screeninfo
>Janela: configurar os itens de ajuda do utilizador</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="dialog-userhelp.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Janela: configurar os itens de ajuda do utilizador</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>Pressing the <guibutton
>Add</guibutton
> 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;.</para>

		<screenshot>
			<screeninfo
>Janela: adicionar um novo item de ajuda</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="dialog-addhelp.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Janela: adicionar um novo item de ajuda</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

		<para
>After configuration all chosen entries will appear in the <guimenu
>Help</guimenu
> menu of &kile; as a special menu entry <guimenu
>User help</guimenu
>.</para>
		
		<screenshot>
			<screeninfo
>Menu de ajuda do utilizador</screeninfo>
			<mediaobject>
			<imageobject>
			<imagedata fileref="menu-userhelp.png" format="PNG"/>
			</imageobject>
			<textobject>
			<phrase
>Menu de ajuda do utilizador</phrase>
			</textobject>
			</mediaobject>
		</screenshot>

	</sect1>

</chapter>

<chapter id="credits">

	<title
>Créditos e Licença</title>

	<para
>&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.</para>

	<para
>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 <guimenuitem
>About &kile;</guimenuitem
> dialog from the <guimenu
>Help</guimenu
> menu. </para>

	<para
>Contributions among others from: Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson</para>

	<para
>Muito obrigado a todos os envolvidos!</para>
	
<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>


&documentation.index;

</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
-->
