<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [
  <!ENTITY kappname "&kwrite;"
>  
  <!ENTITY package "kdebase">
  <!ENTITY % addindex "IGNORE"
> 
  <!ENTITY % Portuguese "INCLUDE"
> <!-- change language only here -->   
]>  
  
<book lang="&language;"
>  

<bookinfo
>  
<title
>O Manual do &kwrite;</title
>  
<authorgroup
>  
<author
>&Thad.McGinnis; &Thad.McGinnis.mail;</author>

<othercredit role="developer"
>&Christoph.Cullmann; &Christoph.Cullmann.mail; </othercredit>

<othercredit role="reviewer"
>&Lauri.Watts; &Lauri.Watts.mail; </othercredit>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 

</authorgroup>

<copyright>
<year
>2000</year
><year
>2001</year>
<holder
>&Thad.McGinnis;</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2001-06-13</date>
<releaseinfo
>2.00.00</releaseinfo>

<abstract>
<para
>O &kwrite; é um editor de texto para o &kde;</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KWrite</keyword>
<keyword
>texto</keyword>
<keyword
>editor</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &kwrite; é mais do que um editor de texto para o ambiente de trabalho do &kde;. Pretende-se que seja um editor para o programador, e poderia ser considerado pelo menos como uma alternativa parcial para a maioria dos editores poderosos. Poderá ser melhor usado em conjunto com o &konqueror; para a navegação por ficheiros de código das diferentes linguagens. O &kwrite; também funciona muito bem como um editor de texto simples. Uma das funcionalidades principais do &kwrite; é a sintaxe colorida personalizada para muitas das diferentes linguagens de programação como por exemplo: C/C++, &Java;, Python, Perl, Bash, Modula 2, <acronym
>HTML</acronym
> e Ada. </para>

</chapter>

<chapter id="on-screen-fundamentals"
>  
<title
>Alguns Fundamentos</title
>  
  
<para
>O &kwrite; é muito simples de usar. Toda a gente que já usou um editor de texto não deverá ter problemas. </para>
  
<sect1 id="drag-and-drop"
>  
<title
>Arrastar e Largar</title
>  
  
<para
>O &kwrite; utiliza o protocolo 'Drag and Drop' do &kde;. Os ficheiros podem ser arrastados e largados no &kwrite; a partir do ecrã, do &konqueror; ou de algum 'site' &FTP; remoto aberto numa das janelas do &konqueror;. </para>
</sect1>
  
<sect1 id="command-line-options"
>  
<title
>Opções da Linha de Comandos</title
>  
  
<para
>Ainda que o &kwrite; possa ser geralmente iniciado a partir do menu de programas do &kde; ou de um ícone do ecrã, poderá ser aberto a partir da linha de comandos de uma janela de terminal. Existem algumas opções úteis que estão disponíveis ao fazer isto. </para>
  
<sect2 id="specify-a-file"
>  
<title
>Indicar um Ficheiro</title
>  
  
<para
>Ao indicar a localização e o nome de um ficheiro em particular, o utilizador poderá fazer com que o &kwrite; abra (ou crie) esse ficheiro imediatamente no seu arranque. Esta opção poderá traduzir-se em algo como o que se segue:</para>

<informalexample
><screen
><prompt
>%</prompt
><userinput
><command
>kwrite</command
> <option
><replaceable
>ficheiro.txt</replaceable
></option
></userinput
>
</screen>
</informalexample>
</sect2>
<sect2 id="editing-files-on-the-internet">
<title
>Especificar um ficheiro na Internet</title>

<para
>O método acima descrito poderia ser usado até para abrir os ficheiros na Internet (se o utilizador tiver uma ligação activa na altura). Um exemplo disso poderia ser o seguinte:</para>

<informalexample
><screen
><prompt
>%</prompt
><userinput
><command
>kwrite</command
> <option
><replaceable
>ftp://ftp.kde.org/pub/kde/Welcome.msg</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect2>

<sect2 id="other-command-line-options">
<title
>Outras Opções da Linha de Comandos</title>

<para
>De momento, estão disponíveis as seguintes opções da linha de comandos:</para>

<variablelist>
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--help</option
></userinput
></term
>  
<listitem
><para
>Isto lista as opções mais básicas que estão disponíveis na linha de comandos.</para
></listitem
>  
</varlistentry
>  
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--help-qt</option
></userinput
></term>
<listitem
><para
>Isto lista as opções disponíveis para mudar a forma como o &kwrite; interage com o &Qt;.</para
></listitem
>  
</varlistentry
>  
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--help-kde</option
></userinput
></term>
<listitem
><para
>Isto lista as opções disponíveis para alterar a forma como o &kwrite; interage com o &kde;.</para
></listitem
>  
</varlistentry
>  
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--help-all</option
></userinput
></term>
<listitem
><para
>Isto lista todas as opções da linha de comandos.</para
></listitem
>  
</varlistentry
>  
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--author</option
></userinput
></term>
<listitem
><para
>Lista os autores do &kwrite; na janela do terminal.</para
></listitem
>  
</varlistentry
>  
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--version</option
></userinput
></term>
<listitem
><para
>Lista a informação de versão do &Qt;, do &kde; e do &kwrite;. Também está disponível como <userinput
><command
>kwrite</command
> <option
>-V</option
></userinput
> </para
></listitem>
</varlistentry
>  
</variablelist
>  
</sect2>
</sect1
>  
  
<sect1 id="keybindings"
>  
<title
>Associações de Teclas</title
>  
  
<para
>Muitos dos comandos de teclado do &kwrite; (atalhos) são configuráveis através do menu <link linkend="settings"
>Configuração</link
>. Por omissão o &kwrite; respeita a seguinte configuração de teclas.</para
>  
  
<informaltable
>  
<tgroup cols="2"
>  
<tbody
>  
  
<row
><entry
><para
><keycombo 
action="simul"
><keycap
>Insert</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Alterna entre o modo de Inserção e Sobreposição. Quando está no modo de inserção, o editor irá adicionar os caracteres introduzidos ao texto e empurrar os dados introduzidos anteriormente à direita do cursor do texto. O modo de sobreposição fará com que a introdução de cada carácter elimine o carácter imediatamente à direita do cursor.</para
></entry>
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Esquerda</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor um carácter para a esquerda </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Direita</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor um carácter para a direita </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Cima</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Sobe o cursor uma linha </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Baixo</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Desce o cursor uma linha </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Page Up</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor uma página para cima </para
></entry
>  
</row>
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Page Down</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor uma página para baixo </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
><keycap
>Backspace</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Apaga o carácter à esquerda do cursor </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
><keycap
>Home</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor para o início da linha </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
><keycap
>End</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor para o fim da linha </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
><keycap
>Delete</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Apaga o carácter à direita do cursor (ou qualquer texto seleccionado)</para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
>&Shift;<keycap
>Esquerda</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Marca o texto que está um carácter à esquerda </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
>&Shift;<keycap
>Direita</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Marca o texto que está um carácter à direita </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
><keycap
>F1</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Ajuda</para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></para
></entry>
<entry
><para
>O que é isto?</para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
></para
></entry
>  
<entry
><para
><link linkend="find"
>Procurar</link
></para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
><keycap
>F3</keycap
></keycombo
></para
></entry
>  
<entry
><para
><link linkend="find-again"
>Procurar seguinte</link
></para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Copia o texto seleccionado para a área de transferência. </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Marca um Favorito</para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Cria um <link linkend="new"
>Novo</link
> documento</para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
></para
></entry
>  
<entry
><para
><link linkend="print"
>Imprimir</link
> </para
></entry
>  
</row
>  
<row>
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></para
></entry>
<entry
><para
>Sair - fecha a cópia activa do editor </para
></entry>
</row>
<row>
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
></para
></entry>
<entry
><para
><link linkend="replace"
>Substituir</link
></para
></entry>
</row>
<row>
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
></para
></entry>
<entry
><para
>Invoca o comando <link linkend="save"
><guilabel
>Gravar</guilabel
></link
>.</para
></entry>
</row>
<row>
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>V</keycap
></keycombo
></para
></entry>
<entry
><para
>Cola o texto da área de transferência no campo de edição. </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>X</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Apaga o texto seleccionado e copia-o para a área de transferência. </para
></entry>
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></para
></entry
>  
<entry
><para
><link linkend="undo"
>Desfazer</link
></para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></para
></entry
>  
<entry
><para
><link linkend="redo"
>Refazer</link
></para
></entry
>  
</row
>  
</tbody
>  
</tgroup
>  
</informaltable
>  
</sect1
>  
</chapter
>  
  
<chapter id="the-menu-entries"
>  
<title
>As Opções do Menu</title
>  
  
<sect1 id="file"
>  
<title
>O Menu <guimenu
>Ficheiro</guimenu
></title
>  
  
<variablelist
>  
  
<varlistentry
>  
<term id="new">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Novo</guimenuitem
></menuchoice
></term
>  
<listitem>
<para
>Isto inicia um novo documento no editor. Se existir um documento na altura com alterações por gravar, é dada ao utilizador a oportunidade de o gravar. </para
>  
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="open">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Abrir...</guimenuitem
> </menuchoice>
</term
>  

<listitem>
<para
>Este comando abre um ficheiro. Efectua esta operação através de uma janela que permite ao utilizador navegar pelo sistema de ficheiros. A janela funciona como um pequeno gestor de ficheiros. Se carregar nas pastas mostradas na janela central direcciona a janela para entrar dentro dessa pasta, mostrando o seu conteúdo. Existe uma lista que pode ser usada para indicar directamente a localização e o nome do ficheiro ou carregando na seta ao lado para escolher uma das localizações mais recentes. Por baixo desta, existem um filtro que, de forma semelhante, poderá ter dados introduzidos directamente ou escolhidos a partir de uma lista de tipos de filtros recentes. A funcionalidade dos filtro permite apenas aos ficheiros que obedeçam a essa especificação serem visualizados na janela central. Se o filtro contivesse texto do tipo <literal role="extension"
>*.txt</literal
>, então apenas os ficheiros com a extensão <literal role="extension"
>txt</literal
> seriam visíveis na janela de selecção. Por baixo do filtro, existe uma barra de estado que indica informações sobre o número de ficheiros e sub-pastas na pasta actual. </para>

<para
>A barra de ferramentas, a qual se encontra no topo da janela, tem uns botões com setas para a esquerda e para a direita que permitem ao utilizador andar para trás e para a frente nas pastas seleccionadas previamente, assim como uma seta para cima para subir na estrutura de pastas. O botão com a pequena casa leva o utilizador para a sua pasta pessoal, correspondendo finalmente o botão com as setas curvas à actualização da vista sobre a pasta actual. O botão da bandeira permite ao utilizador atribuir um novo favorito à pasta actual ou saltar para um favorito previamente definido. </para>

<para
>O último botão na barra de ferramentas permite-lhe criar uma nova pasta e mesmo alterar algumas opções básicas da janela; finalmente existe uma lista com as pastas mais frequentadas. </para>
</listitem>
</varlistentry
>  
  
<varlistentry
>  
<term id="open-recent">
<menuchoice
><guimenu
>Ficheiro</guimenu
> <guimenuitem
>Abrir um Recente</guimenuitem
> </menuchoice>
</term
> 
<listitem>
<para
>Este é um atalho para aceder aos documentos gravados mais recentemente. Se carregar neste item abre uma lista ao lado do menu com alguns dos ficheiros gravados mais recentemente. Se carregar num desses ficheiros em particular abri-lo-á no &kwrite; - isto se o ficheiro ainda existir na mesma localização. </para>
</listitem>
</varlistentry>
  
<varlistentry
>  
<term id="save">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Gravar</guimenuitem
> </menuchoice>
</term
>  
<listitem>
<para
>Isto grava o documento actual. Se já existir uma gravação do documento esta irá sobrepor o ficheiro já gravado sem pedir o consentimento ao utilizador. Se for a primeira gravação de um documento, aparecerá então a janela 'Gravar Como' (descrita em baixo). </para>
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="save-as">
<menuchoice
><guimenu
>Ficheiro</guimenu
> <guimenuitem
>Gravar Como...</guimenuitem
> </menuchoice>
</term
>  
<listitem>
<para
>Isto permite a um documento ser gravado com outro nome. Isto é conseguido através da janela de ficheiros descrita na secção <link linkend="open"
>Abrir</link
> deste ficheiro de ajuda. </para>
</listitem>
</varlistentry>
  
<varlistentry
>  
<term id="print">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Imprimir...</guimenuitem
> </menuchoice>
</term
>  
<listitem
>  
<para
>Abre uma única janela de impressão que permite ao utilizador especificar o quê, onde e como imprimir. </para
>  
</listitem
>  
</varlistentry
>  
  
<!--
<varlistentry
>  
<term id="new-view">
<menuchoice
>  
<guimenu
>File</guimenu>
<guimenuitem
>New View</guimenuitem>
</menuchoice>
</term
>  
<listitem
>  
<para>
This creates a new view of the current document, &ie;, a new instance of
&kwrite; (as explained in the previous entry) but containing the same
document.
</para>
</listitem
>  
</varlistentry
>  
  //-->

<varlistentry
>  
<term id="close">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Isto irá fechar a janela do editor; se tiver mais do que uma instância do &kwrite; a correr, através dos itens de menu <guimenuitem
>Nova Vista</guimenuitem
> ou <guimenuitem
>Nova Janela</guimenuitem
> essas instâncias não serão fechadas. </para>
</listitem>
</varlistentry
>  
  
</variablelist
>  
  
</sect1
>  
  
<sect1 id="edit"
>  
<title
>O Menu <guimenu
>Editar</guimenu
></title
>  
  
<variablelist
>  
<varlistentry>
<term id="undo"
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Desfazer</guimenuitem
></menuchoice
></term>
<listitem
>  
<para
>Isto é usado para eliminar ou reverter a última acção ou operação feita pelo utilizador. O que corresponde uma destas acção poderá ser melhor compreendido na secção de <link linkend="group-undos"
>Agrupar o Desfazer</link
> deste ficheiro de ajuda.</para
>   
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="redo"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
><guimenuitem
>Refazer</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Isto irá repor a última alteração (se houver alguma) que foi anulada pelo Desfazer</para
>  
</listitem
>  
</varlistentry
>  
  
<!--<varlistentry
>  
<term
><anchor id="undohistory"/><menuchoice
>  
<guimenu
>Edit</guimenu
><guimenuitem
>Undo/Redo 
History</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>This will call a display box showing a list of the most recent actions on  


the left and another list of actions which have been 'undone' on the right.  
There are also three buttons at the right of the box labeled  
<guibutton
>Undo</guibutton
>, <guibutton
>Redo</guibutton
>, and  
<guibutton
>Close</guibutton
>.  Clicking on the <guibutton
>Undo</guibutton
>  
button will cause the action at the top of the Undo list to be reversed which  
will place that particular action at the top of the Redo list. Likewise,  
clicking on the <guibutton
>Redo</guibutton
> button will reinstate the reversed  
action and move it back to the top of the Undo list.  Clicking on an item below  


the top item in either list will select all the items from the top down to that  


point.  A subsequent click on the corresponding button will cause all the  
selected actions to be undone or redone accordingly.  This would be particularly 

 
useful when the user knows precisely the point to which she or he would like to  


proceed - making it unnecessary to go through a series of single undo or redo  
actions.</para
>   
</listitem
>  
</varlistentry
>  //-->
  
<varlistentry
>  
<term
><anchor id="cut"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>X</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
><guimenuitem
>Cortar</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Este comando apaga a selecção actual e coloca-a na área de transferência. A área de transferência é uma funcionalidade do KDE que funciona invisivelmente para oferecer uma forma de transferir os dados entre as aplicações.</para
>  
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="copy"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Copiar</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Isto copia o texto seleccionado no momento para a área de transferência de modo a poder ser colado noutro local. A área de transferência é uma funcionalidade do KDE que funciona invisivelmente para oferecer uma forma de transferir os dados entre as aplicações.</para
>   
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="paste"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>V</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Colar</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Isto irá inserir o conteúdo da área de transferência na posição do cursor. A área de transferência é uma funcionalidade do KDE que funciona invisivelmente para oferecer uma forma de transferir os dados entre as aplicações.</para
>  
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="select-all"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
><guimenuitem
>Seleccionar Tudo</guimenuitem
></menuchoice
></term>
<listitem
>  
<para
>Isto irá seleccionar o documento por inteiro. Tal poderá ser muito útil para copiar o ficheiro inteiro para outra aplicação.</para
>  
</listitem
>  
</varlistentry
>  
  
<!--<varlistentry
>  
<term
><anchor id="invert-the-selection"/><menuchoice
>  
<guimenu
>Edit</guimenu
><guimenuitem
>Invert 
Selection</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>This selects any unselected text while unselecting any selected text -  
effectively reversing the current state of selection.</para
>  
</listitem
>  
</varlistentry
>  //-->
  
<varlistentry
>  
<term id="go-to-line">
<menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Ir para a linha</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Isto abre a janela de salto para uma linha em particular (indicada por um número) no documento. O número da linha poderá ser indicado directamente no campo de texto ou de forma gráfica, carregando nos botões com as setas para cima e para baixo ao lado do campo de texto. A pequena seta para cima irá aumentar o número de linha, enquanto que a outra decrementa o mesmo número de linha. Existe também uma barra deslizante à direita do campo de texto que permite ao utilizador mover-se de uma forma análoga no documento. </para
> 
</listitem
> 
</varlistentry>
        
<varlistentry
>  
<term
><anchor id="find"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Procurar</guimenuitem
></menuchoice
></term>
<listitem
>  
<para
>Isto abre a janela de procura, a qual é usada para especificar o <guilabel
>Texto a Procurar</guilabel
> no documento. Existe um pequeno campo de texto onde se deve indicar o padrão de procura, o qual é também uma lista. Se carregar na seta da lista poderá usar os padrões de pesquisa mais recentes. Os outros parâmetros são incluídos para tornar a pesquisa mais eficiente. A selecção do <guilabel
>Distinguir Maiúsculas</guilabel
> irá limitar as pesquisas aos registos que correspondam à capitalização (maiúsculas ou minúsculas) de cada um dos caracteres no padrão de procura. O <guilabel
>Procurar para Trás</guilabel
> direcciona a pesquisa para percorrer no sentido superior. A opção <guilabel
>Texto Seleccionado</guilabel
> mantém a procura apenas no texto seleccionado no momento. A opção <guilabel
>Apenas Palavras Completas</guilabel
> evita que a procura pare nas palavras que contêm o padrão a procurar. A opção <guilabel
>A Partir do Cursor</guilabel
> inicia a procura a partir da posição actual do cursor dentro do documento em vez de ser a partir do início.</para
>   
</listitem
>  
</varlistentry
>  

<varlistentry
>  
<term
><anchor id="find-again"/><menuchoice
><shortcut
><keycombo action="simul"
><keycap
>F3</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
><guimenuitem
>Procurar o Próximo</guimenuitem
></menuchoice
></term
>  


<listitem
>  
<para
>Isto repete a última operação de procura, se ocorreu alguma, sem chamar a janela de procura.</para
> </listitem
>  
</varlistentry
>  
  
<varlistentry>
<term id="find-previous">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Shift;<keycap
>F3</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Procurar Anterior</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Isto repete a última operação de procura, se ocorreu alguma, sem chamar a janela de procura, efectuando a procura para trás em vez de o fazer para a frente no documento. </para>
</listitem>
</varlistentry>

<varlistentry
>  
<term
><anchor id="replace"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
><guimenuitem
>Substituir</guimenuitem
></menuchoice
></term>
<listitem
>  
<para
>Este comando abre a janela de substituição. Esta é praticamente idêntica à janela de procura descrita acima. Para além das funcionalidades da janela de procura, contém um campo de texto/lista <guilabel
>Substituir Por:</guilabel
>. Com esta janela, o utilizador pode especificar tanto o texto a ser encontrado como o texto com o qual o substituir. A opção adicional <guilabel
>Perguntar ao Substituir</guilabel
> permite ao utilizador confirmar sempre que o &kwrite; pedir essa confirmação antes de cada substituição.</para
> </listitem>
</varlistentry>

<!--<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"
>&Ctrl;<keycap
>M</keycap
></keycombo>
</shortcut>
<guimenu
>Edit</guimenu>
<guimenuitem
>Editing Command</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
To be written
</para>
</listitem>
</varlistentry
>//-->
</variablelist>

</sect1
>  
  
<sect1 id="go"
>  
<title
>O Menu <guimenu
>Favoritos</guimenu
></title
>  

<variablelist
>  
<varlistentry>
<term id="toggle-bookmarks">
<menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
></shortcut
> <guimenu
>Favoritos</guimenu
><guimenuitem
>Comutar o Favorito</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>A ser escrito </para>
</listitem>
</varlistentry>

<varlistentry>
<term id="clear-bookmarks">
<menuchoice
><guimenu
>Favoritos</guimenu
> <guimenuitem
>Limpar os Favoritos</guimenuitem
> </menuchoice>
</term
>  
<listitem
>  
<para
>Este comando irá remover todas as marcações do documento, assim como a lista de marcações que está no fim deste item do menu. </para
> 
</listitem
> 
</varlistentry
> 
</variablelist>
  
<para
>No fundo deste menu, tal como se disse, existe uma lista de marcações para esta janela, se foram previamente atribuídas. </para>

</sect1
>  
  
<sect1 id="tools"
>  
<title
>O Menu <guimenu
>Ferramentas</guimenu
></title
>  
  
<variablelist>
<varlistentry>
<term
><anchor id="Spelling..."/><menuchoice
><guimenu
>Ferramentas</guimenu
><guimenuitem
>Verificação Ortográfica...</guimenuitem
></menuchoice
></term>

<listitem
><para
><action
>Isto inicia o programa de verificação ortográfica - um programa que é desenhado para ajudar o utilizador a descobrir e a corrigir os erros ortográficos.</action
> Ao carregar nesta opção irá iniciar o verificador ortográfico e trazer a janela com o suporte ortográfico. Existem três campos  de texto alinhados verticalmente no centro da janela com as suas legendas correspondentes à sua esquerda. A começar por cima estas são:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Palavra desconhecida:</guilabel
></term>
<listitem
><para
>Aqui, o verificador ortográfico indica a palavra sob consideração neste momento. Isto acontece quando o verificador ortográfico encontra uma palavra que não se encontra no seu dicionário - um ficheiro que contém uma lista com as palavras correctas com as quais compara cada palavra no editor.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Substituir por:</guilabel
></term>
<listitem
><para
>Se o verificador ortográfico encontrar alguma palavra semelhante no seu dicionário, é listada aqui a primeira. O utilizador poderá aceitar a sugestão, escrever a sua própria correcção ou escolher uma sugestão diferente na próxima lista.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Palavras Sugeridas:</guilabel
></term>
<listitem
><para
>O verificador poderá enumerar aqui uma quantidade de substituições possíveis para a palavra em consideração. Se carregar em alguma das sugestões fará com que a mesma seja introduzida no campo <guilabel
>Substituição</guilabel
> em cima.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Língua:</guilabel
></term>
<listitem
><para
>Se você tiver instalado vários dicionários, aqui você poderá seleccionar qual o dicionário/língua que deverá ser usado.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Do lado direito da janela existem 5 botões que permitem ao utilizador controlar o processo de verificação ortográfica. São estes:</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Adicionar ao Dicionário</guibutton
></term>
<listitem
><para
>Se carregar neste botão irá adicionar a palavra no campo <guilabel
>Palavra Errada:</guilabel
> ao dicionário do corrector. Isto significa que, no futuro, o verificador ortográfico irá considerar sempre esta palavra como correcta.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Substituir</guibutton
></term>
<listitem
><para
>Este botão faz com que o corrector substitua a palavra em consideração no documento com a palavra no campo <guilabel
>Substituição:</guilabel
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Substituir Tudo</guibutton
></term>
<listitem
><para
>Este botão faz com que o corrector não só substitua a <guilabel
>Palavra desconhecida:</guilabel
> actual mas também faça a mesma substituição para todas as outras ocorrências desta <guilabel
>Palavra Errada:</guilabel
> no documento.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Ignorar</guibutton
></term>
<listitem
><para
>Ao activar este botão fará com que o verificador ortográfico siga em frente sem efectuar nenhumas alterações.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Ignorar Tudo</guibutton
></term>
<listitem
><para
>Este botão diz ao corrector ortográfico para não fazer nada com a <guilabel
>Palavra desconhecida:</guilabel
> actual e para seguir em frente com todas as instâncias da mesma palavra.</para
> <note
><para
>Isto só se aplica a esta ronda de verificação ortográfica. Se o verificador for executado de novo mais tarde ele irá parar na mesma palavra.</para
></note
></listitem>
</varlistentry>
</variablelist>

<!--<para
>Located horizontally along the bottom of the spell check dialog is a
progress bar.  As the checking process proceeds the bar will fill from left to
right providing a graphical representation of how far along in the document the
process has reached.  In addition, the progress is displayed numerically in
the center of the progress bar.</para
>//-->

<!--<note
><para
>A numerical display of the spell check
process is simultaneously displayed in the status bar of the editor.  The <link
linkend="show-statusbar"
>status bar</link
> is the horizontal strip at the bottom
of the editor just outside of the text entry area.</para
></note
>//-->

<para
>Existem mais três botões por baixo da janela de verificação ortográfica. Estes são:</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Ajuda</guibutton
></term>
<listitem
><para
>Este invoca o sistema de ajuda tendo como base as páginas de ajuda do &kwrite; (este documento).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Terminado</guibutton
></term>
<listitem
><para
>Este botão cancela o processo de verificação ortográfica e volta para o documento.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Cancelar</guibutton
></term>
<listitem
><para
>Este botão cancela o processo de verificação ortográfica, todas as modificações são anuladas e você irá voltar ao seu documento.</para
></listitem>
</varlistentry>

<varlistentry
>  
<term
><anchor id="indent"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>I</keycap
></keycombo
></shortcut
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Indentar</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Isto aumenta a indentação do parágrafo de um passo. O tamanho do passo depende da <link linkend="pref-indent"
>configuração da indentação</link
>.</para
>  
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="unindent"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>I</keycap
></keycombo
></shortcut
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Desindentar</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Isto reduz a indentação do parágrafo de um passo. O tamanho do passo depende da <link linkend="pref-indent"
>configuração da indentação</link
>.</para
>  
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="cleanindent"/><menuchoice
><guimenu
>Ferramentas</guimenu
><guimenuitem
>Limpar a Indentação</guimenuitem
></menuchoice
></term
>  <listitem
>  
<para
>Ainda não implementado</para>
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>D</keycap
></keycombo
></shortcut
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Comentar</guimenuitem
></menuchoice
></term>
<listitem
><para
>Isto adiciona mais um espaço ao início da linha onde o cursor de texto se encontra ou ao início das linhas seleccionadas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>D</keycap
></keycombo
></shortcut
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Descomentar</guimenuitem
></menuchoice
></term>
<listitem
><para
>Isto remove um espaço (se existir) ao início da linha onde o cursor se encontra ou ao início das linhas seleccionadas.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings">
<title
>O Menu <guimenu
>Configuração</guimenu
></title>

<variablelist>
<varlistentry>
<term
><anchor id="show-toolbar"/><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar a Barra de Ferramentas</guimenuitem
> </menuchoice>
</term
>  
<listitem
>  
<para
>Se estiver assinalada, esta opção mostra uma barra amovível que contém os botões usados para desencadear os comandos mais usados. Quando estiver desligada, a barra de ferramentas estará escondida. </para
> 
</listitem
> 
</varlistentry>
  
<varlistentry
>  
<term
><anchor id="show-statusbar"/><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Mostrar a Barra de Estado</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Se estiver assinalada, esta opção mostra uma pequena barra no fundo do editor que contém a informação sobre o estado do documento actual. Quando estiver desligada, a barra de estado estará escondida.</para
>     
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="show-path"/><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Mostrar a Localização</guimenuitem
></menuchoice
></term>
<listitem
>  
<para
>Quando estiver seleccionada, esta opção mostra na barra de título a localização no sistema de ficheiros do documento actual. Se não estiver, a localização ficará escondida.</para>
</listitem
>  
</varlistentry
>  

<varlistentry
>  
<term
><anchor id="preferences"/><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o Editor...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Este menu abre uma janela onde as várias <link linkend="pref-dialog"
>opções</link
> poderão ser ajustadas. </para>
</listitem
> 
</varlistentry>
  
<varlistentry
>  
<term
><anchor id="configure-keybindings"/><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar os Atalhos...</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Este comando abre uma janela onde se poderão alterar as <link linkend="keybindings"
>associações de teclas</link
>. Uma área no topo da janela mostra a lista de comandos (acções) que poderão ter atalhos de teclado. Por baixo da área existem três opções exclusivas. O utilizador poderá optar entre Sem Tecla, Tecla Predefinida ou Tecla Personalizada. (A selecção da Tecla Predefinida assume que existe um atalho de teclado 'predefinido'). A selecção da opção Tecla Personalizada activa as três opções no fundo da janela. O utilizador poderá então seleccionar uma combinação de teclas para o comando em questão através das opções e da tecla. Por exemplo, com o comando Acerca do KDE seleccionado na área de visualização, o utilizador poderia seleccionar o &Ctrl; e o <keycap
>Alt</keycap
>, carregar no botão da tecla e depois no <keycap
>K</keycap
> do teclado. Isso significaria que, sempre que ele carregasse nas teclas &Ctrl; e <keycap
>Alt</keycap
>, seguidas da tecla <keycap
>K</keycap
> (enquanto usar o &kwrite;), seria chamada a janela do Acerca do KDE. </para
>   
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="configure-toolbars"/><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar as Barras de Ferramentas...</guimenuitem
></menuchoice
></term
>  
<listitem
><para
>Isto irá abrir a janela onde se poderá alterar a configuração da barra de ferramentas. O utilizador poderá escolher quais os botões de atalho que deverão aparecer nessa barra de ferramentas. A área à esquerda mostra os comandos disponíveis para serem colocados na barra de ferramentas. A lista à direita mostra os comandos que já estão na barra de ferramentas. Existe um conjunto de quatro botões com setas entre as duas listas para manipular as selecções. A seta para a direita coloca o comando seleccionado na lista à esquerda na lista direita, <abbrev
>i.e.</abbrev
>, adiciona-o à barra de ferramentas. A seta à esquerda faz o oposto, ou seja, remove a acção seleccionada à direita na barra de ferramentas. As setas para cima e para baixo mudam a posição de uma acção seleccionada do lado direito, o que irá mudar a posição do seu botão na barra de ferramentas.</para
> </listitem
>   
</varlistentry
>  
  

  
<!-- 
<varlistentry
>  
<term>
<menuchoice
><guimenu
>
>Settings</guimenu
><guimenuitem
>Configure
Highlighting</guimenuitem
></menuchoice
></term
>  
<listitem
><para
>Opens a dialog box allowing configuration of the syntax  
highlighting.  The dialog is described in <xref  
linkend="pref-highlighting"/>.</para
></listitem
>  
</varlistentry
>  -->
  
<!--<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"
><keycap
>F6</keycap
></keycombo>
</shortcut>
<guimenu
>Settings</guimenu>
<guimenuitem
>Show Icon Border</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Toggle the display of a border on the left of the editing window, where
bookmarks are displayed next to the line they apply to.
</para>
</listitem>
</varlistentry
>//-->

<!--<varlistentry>
<term id="vertical-selection">
<menuchoice>
<shortcut>
<keycombo action="simul"
><keycap
>F4</keycap
></keycombo>
</shortcut>
<guimenu
>Settings</guimenu>
<guimenuitem
>Vertical Selection</guimenuitem>
</menuchoice>
</term
>  
<listitem
>  
<para>
This is used to turn on or off the vertical selection feature.  Vertical  
selection allows text to be selected by column as well as by row.  In other  
words with this feature the user is able to select text contained in only  
particular contiguous columns and rows.  In affect the user can select a  
rectangular area of text anywhere in the document.
</para
>  
</listitem
>  
</varlistentry
>  //-->
  
<!--<varlistentry
>  
<term id="set-highlight">
<menuchoice
>  
<guimenu
>Settings</guimenu>
<guisubmenu
>Highlight Mode</guisubmenu>
</menuchoice>
</term>
<listitem
>  
<para>
This allows the user to choose the style of color highlighting which the
editor uses to display the text. The styles are selected by programming
language. The font/color information is not stored with the document.
</para>
</listitem
>  
</varlistentry
>  //-->
  
<!--<varlistentry
>  
<term
><anchor id="end-of-line"/>
<menuchoice
>  
<guimenu
>Settings</guimenu
><guisubmenu
>End of Line</guisubmenu
></menuchoice
></term
>  
<listitem
>  
<para
>This opens a sub-menu from which the user can select the type of <quote
>end of  
line</quote
> code for &kwrite; to use, <abbrev
>i.e.</abbrev
>, the accepted standard  
used by &UNIX;, &Mac; or MSDOS/&Windows; systems.</para>
</listitem
>  
</varlistentry
>  //-->
  
</variablelist
>  
</sect1
>  
  
<sect1 id="help"
>  
<title
>O Menu <guimenuitem
>Ajuda</guimenuitem
></title
> &help.menu.documentation; </sect1
>  
</chapter>
  
<chapter id="pref-dialog"
>  
<title
>Configurar o &kwrite;</title>

<para
>A selecção do <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o Editor</guimenuitem
></menuchoice
> a partir do menu provoca o aparecimento da janela <guilabel
>Configurar o Editor</guilabel
>. Esta janela pode ser usada para alterar algumas das várias opções existentes. As opções disponíveis para alteração podem variar de acordo com a categoria que o utilizador selecciona numa lista vertical do lado esquerdo da janela. Recorrendo a três botões na parte inferior da janela o utilizador poderá controlar o processo. </para>

<para
>O(a) utilizador(a) pode invocar o sistema de <guilabel
>Ajuda</guilabel
>, aceitar a configuração actual e fechar a janela, através do botão <guibutton
>OK</guibutton
> ou <guibutton
>Cancelar</guibutton
> o processo. As categorias <guilabel
>Cores</guilabel
>, <guilabel
>Tipos de Letra</guilabel
> <guilabel
>Indentação</guilabel
>, <guilabel
>Selecção</guilabel
>, <guilabel
>Edição</guilabel
>, <guilabel
>Verificação Ortográfica</guilabel
> e <guilabel
>Realce</guilabel
> são detalhadas em baixo. </para>

<sect1 id="prefcolors">
<title
>Cores</title>
  
<para
>Esta secção permite o acesso a <link linkend="pref-color-settings"
>duas opções diferentes de cores</link
>, e que são descritas em baixo. Cada uma dessas opções pode ser alterada ao carregar no seu botão correspondente. Estes são botões especialmente largos com a cor da configuração actual. Ao carregar num dos botões fará aparecer uma janela de cores especial que é usada para alterar a opção.</para
>  
  
<para
>A janela de cores oferece uma forma conveniente e gráfica de seleccionar uma cor. Na parte superior esquerda da janela existe uma visualização rectangular do espectro de cores. Logo à direita existe uma barra vertical que mostra um intervalo de intensidade do mais escuro em baixo até ao mais claro em cima. O utilizador poderá seleccionar e ajustar uma cor carregando nessas duas áreas. Se carregar  na área rectangular selecciona uma mistura em particular de vermelho, verde e azul, enquanto que na vertical selecciona um nível de intensidade (valor). Os vários atributos de cores são mostrados num formato numérico em pequenos campos de texto colocados logo por baixo do rectângulo com o espectro e o utilizador poderá vê-los a serem alterados à medida que a cor é ajustada. Esses atributos incluem a mistura das componentes básicas da cor (vermelho, verde e azul), assim como os níveis de matiz e saturação. Em alternativa, o utilizador poderá introduzir figuras directamente nesses campos. Existe também um quadrado em baixo que mostra a cor que está a ser considerada em qualquer altura. À direita desse quadrado, está também outro campo chamado <guilabel
>HTML:</guilabel
>. Este mostra ao utilizador o código de cor que deveria ser usado para especificar a cor mostrada em particular no código de <acronym
>HTML</acronym
> que é usado com frequência nas páginas Web.</para
>  
  
<para
>Para além do acima descrito, a janela de cores permite a captura de qualquer cor mostrada de momento no ecrã ou noutro programa. Se carregar no botão com o ícone do conta-gotas (localizado à direita na janela), muda a forma do cursor do rato para uma mira. Se carregar de novo irá obter os atributos de cor da cor que estiver sob a mira.</para
>  
  
<para
>Para além disso, o utilizador tem a opção de adicionar qualquer cor a uma paleta especial de <quote
>Cores Personalizadas</quote
> ao carregar no botão largo <guibutton
>Adicionar às Cores Personalizadas</guibutton
> (que se encontra exactamente por cima do quadrado de visualização). Isto adiciona a cor actual à paleta de cores personalizadas. Esta paleta, assim como todas as outras disponíveis, poderá ser mostrada usando a lista de selecção localizada imediatamente por cima da visualização da paleta no canto superior direito da janela. Para além das cores personalizadas, o utilizador pode aceder a uma quantidade de paletas predefinidas.</para>
  
<variablelist
>  
  
<varlistentry id="pref-color-settings"
>  
<term
><guilabel
>Fundo</guilabel
></term
>  
<listitem
><para
>Aqui o utilizador pode especificar uma cor para o fundo geral do &kwrite;.</para
></listitem
>   
</varlistentry
>  

<varlistentry
>  
<term
><guilabel
>Seleccionado</guilabel
></term
>  
<listitem
><para
>Isto permite ao utilizador seleccionar uma cor para ser usada para indicar a parte seleccionada (ou realçada) do documento.</para
></listitem
> </varlistentry
>  
</variablelist
>  
</sect1
>  

<sect1 id="pref-fonts">
<title
>Tipos de Letra</title>

<para
>Aqui, o utilizador poderá escolher o tipo de letra por omissão para o &kwrite;. Pode escolher qualquer tipo de letra disponível no seu sistema, assim como definir um tamanho por omissão e uma codificação. Um texto de exemplo aparecerá na parte inferior da janela, para que possa ver o efeito das suas opções. </para>

</sect1>
  
<sect1 id="pref-indent"
>  
<title
>Indentar</title
>  
<variablelist
>  
  
<varlistentry
>  
<term
><guilabel
>Auto Indentar</guilabel
></term
> <listitem
><para
>Isto faz com que as novas linhas comecem com o mesmo nível de indentação que a linha anterior.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Indentar com Espaços</guilabel
></term
> <listitem
><para
>Isto substitui as tabulações com o número de espaços seleccionado na janela do Tamanho da Tabulação na secção <link linkend="pref-edit"
>Edição</link
> da janela de preferências.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Indentação com a Tecla Backspace</guilabel
></term
>  
<listitem
><para
>Isto permite usar a tecla <keycombo action="simul"
><keycap
>Backspace</keycap
></keycombo
> para indentar.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Indentação com a Tecla Tab</guilabel
></term
> <listitem
><para
>Isto permite usar a tecla <keycombo action="simul"
><keycap
>Tab</keycap
></keycombo
> para indentar.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Manter Espaços Extra</guilabel
></term
>  
<listitem
><para
>As indentações com mais espaços do que os seleccionados não serão encolhidas.</para
></listitem
>  
</varlistentry
>  
  
</variablelist
>  
</sect1
>  
  
<sect1 id="pref-select"
>  
<title
>Seleccionar</title
>  
<variablelist
>  
  
<varlistentry
>  
<term
><guilabel
>Selecções Persistentes</guilabel
></term
>  
<listitem
><para
>Isto evita que a introdução de texto ou a movimentação do cursor através das teclas de cursores elimine a selecção do texto. </para
><note
><para
>(Nota: Se a opção Substituir Selecções estiver activa, então qualquer carácter escrito ou operação de colagem irá substituir o texto seleccionado).</para
></note
></listitem
> </varlistentry
>  
  
<varlistentry
> <term
><guilabel
>Substituir as Selecções</guilabel
></term
>  
<listitem
><para
>Todos os caracteres escrito ou operações de colagem irão substituir o texto seleccionado. </para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Auto-Cópia com o Rato</guilabel
></term
> <listitem
><para
>Todo o texto seleccionado com o rato será copiado automaticamente para a área de transferência.</para
></listitem
>  
</varlistentry
>  

<varlistentry
>  
<term
><guilabel
>Selecção Simples à X11</guilabel
></term
>  
<listitem
><para
>Ainda não implementado.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Selecções Verticais</guilabel
></term
> <listitem
><para
>Isto activa a opção das Selecções Verticais.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
>Comutar o Antigo</term
> <listitem
><para
>Ainda não implementado</para
></listitem
>  
</varlistentry
>  
  
</variablelist
>  
</sect1
>  
  
<sect1 id="pref-edit"
>  
<title
>Editar</title
>  
<variablelist
>  
<varlistentry
>  
<term id="pref-word-wrap"
><guilabel
>Mudança de Linha</guilabel
></term
>  
<listitem
><para
>A mudança de linha é uma funcionalidade que faz com que o editor inicie automaticamente uma linha de texto e mova (mude) o cursor para o início dessa nova linha. O &kwrite; irá iniciar automaticamente uma nova linha de texto sempre que a linha actual atingir o tamanho indicado pela opção <link linkend="pref-wrap-words-at"
>Mudar Palavras Em:</link
>.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="pref-wrap-words-at"
><guilabel
>Mudar Palavras Em:</guilabel
></term
><listitem
><para
>Se a opção <link linkend="pref-word-wrap"
>Mudança de Linha</link
> estiver seleccionada, este campo determina o tamanho (em caracteres) a partir do qual o editor irá iniciar automaticamente uma nova linha.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="pref-replace-tabs-by-spaces"
><guilabel
>Substituir Tabs por Espaços</guilabel
></term
> <listitem
><para
>O &kwrite; irá substituir os caracteres <keycap
>Tab</keycap
> introduzidos por um número conveniente de espaços, tal como definido na <link linkend="pref-tab-width"
>Tabulação</link
>.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="pref-tab-width"
>Tabulação</term
> <listitem
><para
>Se a opção <link linkend="pref-word-wrap"
><guilabel
>Substituir as Tabulações por Espaços</guilabel
></link
> estiver seleccionada, este campo determina o número de espaços pelo qual o editor irá substituir automaticamente as tabulações.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Remover os Espaços Finais</guilabel
></term
>  
<listitem
><para
>O &kwrite; irá eliminar automaticamente os espaços extra no fim das linhas de texto.</para
></listitem
> </varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Parêntesis Automáticos</guilabel
></term
> <listitem
><para
>Quando um utilizador escrever um parêntesis esquerdo ([, ( ou {), o &kwrite; introduz automaticamente o parêntesis direito (}, ) ou ]) à direita do cursor.</para
></listitem>
</varlistentry>

<varlistentry>
<term id="group-undos"
><guilabel
>Agrupar as Anulações</guilabel
></term>
<listitem
><para
>Os grupos de acções semelhantes são considerados um único passo no <link linkend="undo"
>Desfazer</link
> pelo &kwrite;. Por outras palavras, uma série de escrita regular de caracteres (palavras ou expressões) seria considerado como um passo e, como tal, seria removido através de uma única operação de anulação. Se a série de entradas de caracteres for interrompida por uma operação que não a introdução de um carácter (como um Backspace), a invocação da anulação só irá remover os registos feitos desde essa operação. A próxima anulação irá então reverter essa operação e assim por diante.</para>
<para
>Quando esta opção não estiver seleccionada, o &kwrite; considera cada sequência de teclas como sendo um único passo. Por isso, se o utilizador (com esta opção activa) escrever várias palavras ou mesmo frases inteiras sem fazer correcções, cópias ou colagens, assim como qualquer operação de com objectos sem serem caracteres, então a execução da operação Desfazer iria eliminar tudo o que tinha sido escrito desde a última operação sem envolver caracteres. Um segundo 'click' iria remover essa operação e um terceiro todas as operações ou sequências de itens que ocorreram antes da operação e assim por diante. Se não estiver seleccionada, os três 'clicks' do botão Desfazer iriam remover apenas as últimas três letras escritas ou as últimas três operações.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
> <term
><guilabel
>Mostrar Tabs</guilabel
></term
>  
<listitem
><para
>O editor mostrará um símbolo para indicar a presença de uma tabulação no texto.</para
></listitem
>  
</varlistentry
>  

<varlistentry>
<term
><guilabel
>Início Inteligente</guilabel
></term>
<listitem
><para
>Ainda não implementado</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>O Page Up/Down Move o Cursor</guilabel
></term>
<listitem
><para
>Esta opção altera o comportamento do cursor quando o utilizador carrega na teclas <keycap
>Page Up</keycap
> ou na <keycap
>Page Down</keycap
>. Se não estiver seleccionada, o cursor do texto irá manter a sua posição relativa no texto visível do &kwrite; à medida que o novo texto se torna visível como resultado da operação. Como tal, se o cursor estiver no meio do texto visível quando a operação ocorrer, irá permanecer nesse local (excepto quando atingir o início ou o fim). Com esta opção seleccionada, ao carregar na primeira tecla fará com que o cursor de mova tanto para o topo como para o fundo do texto visível à medida que é mostrada uma nova página de texto. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>Mudar o Cursor</term
> 
<listitem
><para
>Quando esta opção for seleccionada, a movimentação do cursor com as teclas dos cursores para além do fim da linha (à direita) faz com que o cursor mude para o início da próxima linha. Do mesmo modo, quando o cursor passar para trás do início de uma linha (à esquerda) salta para o fim da linha anterior. Quando esta linha não estiver seleccionada, a movimentação do cursor para lá do fim da linha simplesmente faz com que esta continue horizontalmente na mesma linha, assim como a movimentação para lá do início da linha não fará nada.</para>
<para
>Quando esta opção for escolhida, ao carregar com o rato para além do fim da linha de texto, colocará o cursor de inserção <emphasis
>no fim do texto</emphasis
> e não no sítio em que carregou. Isto evita a hipótese de adicionar um espaço em branco no meio do texto e é o comportamento por omissão na maioria dos editores. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Passos do <link linkend="undo"
>desfazer</link
>:</term
> <listitem
><para
>Aqui, o utilizador poderá indicar o número de passos que o &kwrite; irá reter em memória com o intuito de desfazer os registos e as acções. Isto significa que, quanto maior o número de passos, maior a quantidade de memória que o &kwrite; irá usar para isto. A atribuição do valor 10 a este campo significará que o utilizador poderá reverter as últimas dez operações, <abbrev
>i.e.</abbrev
>, carregar no botão <guibutton
>Desfazer</guibutton
> 10 vezes e obter resultados.</para
></listitem
> </varlistentry>

<varlistentry>
<term
>Codificação</term>
<listitem>
<para
>Isto altera a codificação de caracteres do seu ficheiro. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="prefspellchecker">
<title
>Ortografia</title
> <para
>Um verificador ortográfico é um programa desenhado para ajudar o utilizador a descobrir e a corrigir os erros ortográficos. Esta secção da janela de preferências permite que sejam ajustadas certas opções importantes com este objectivo.</para>
<variablelist>

<varlistentry>
<term
><guilabel
>Criar combinações raiz/afixo que não estão no dicionário</guilabel
></term
> <listitem
><para
>Ao seleccionar esta opção, permite ao verificador ortográfico registar como 'correctas' as combinações de radicais das palavras com os sufixos ou prefixos mesmo que essa combinação em particular não conste na base de dados de palavras do seu dicionário.</para
></listitem>

</varlistentry>

<varlistentry>
<term
><guilabel
>Considerar as palavras coladas como erros</guilabel
></term
> <listitem
><para
>Ao seleccionar isto fará com que o verificador ortográfico registe como 'erradas' duas ou mais palavras correctas que estejam 'coladas', <abbrev
>i.e.</abbrev
>, que não tenham espaços entre elas.</para
></listitem>

</varlistentry>

<varlistentry>
<term
><guilabel
>Dicionário:</guilabel
></term
> <listitem
><para
>Dependendo da instalação do utilizador, poderão estar um ou mais dicionários ortográficos para línguas diferentes. Esta lista permite ao utilizador escolher qual a língua que o verificador ortográfico deverá usar.</para
></listitem>
  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Codificação:</guilabel
></term
> <listitem
><para
>Existem diversos sistemas de codificação usados para associar os códigos específicos com os caracteres e símbolos adequados. Se o utilizador souber qual o código que está a usar, esta lista permite especificar este código para que o verificador ortográfico desempenhe a sua função correctamente. </para
></listitem
> </varlistentry>

<varlistentry>
<term
><guilabel
>Cliente:</guilabel
></term
> <listitem
><para
>Dado que o &kwrite; não contém o seu próprio verificador ortográfico, tem de ser usado um externo. Aqui é onde o utilizador poderá indicar qual o programa de verificação ortográfica a usar.</para
></listitem
> </varlistentry>

</variablelist>
</sect1>
</chapter>

<chapter id="pref-highlighting">
<title
>Realce</title>

<para
>A janela de <guilabel
>Configurar o Realce</guilabel
> consiste em duas páginas, a <guilabel
>Predefinições</guilabel
> e os <guilabel
>Modos de Realce</guilabel
>. O utilizador pode seleccionar qual a página que deseja ver, carregando na secção apropriada na parte superior da janela.</para>

<para
>Os itens disponíveis na página <guilabel
>Predefinições</guilabel
> são os seguintes:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Estilos de Itens por Omissão</guilabel
></term>
<listitem>
<para
>O utilizador pode configurar a aparência por omissão para os itens em particular. Isto permitirá a um programador identificar mais facilmente os diferentes itens (tipos de registos) no seu código. </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Item</guilabel
></term>
<listitem
><para
>Esta lista oferece uma quantidade de itens que o utilizador poderá querer realçar. Estes incluem o <guilabel
>Normal</guilabel
> para o texto que não se encaixe em nenhuma das outras categorias, o <guilabel
>Comentário</guilabel
>, o <guilabel
>Texto</guilabel
>, a <guilabel
>Palavra-Chave</guilabel
> entre muitos outros. Nem todos esses itens terão de ser configurados para cada língua e, como tal, poderão ser seleccionados de acordo com as necessidades. As restantes opções nesta secção aplicam-se ao item seleccionado nesta lista.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Normal</guilabel
></term>
<listitem
><para
>Isto permite ao utilizador escolher a cor normal (não seleccionada). Isto é obtido através de uma janela de selecção de cores; poder-se-á encontrar uma explicação posterior na secção <link linkend="prefcolors"
>Cores</link
> do <link linkend="pref-dialog"
>Configurar o KWrite</link
>.</para>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Negrito</guilabel
></term>
<listitem
><para
>Esta opção determina se o item deve ou não ser mostrado com o texto a negrito.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Itálico</guilabel
></term>
<listitem
><para
>Esta opção decide se o item deve ser desenhado com um tipo de letra itálico.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Seleccionado</guilabel
></term>
<listitem
><para
>Isto permite ao utilizador escolher a cor do item quando estiver seleccionado.  Isto é obtido através de uma janela de selecção de cores; poder-se-á encontrar uma explicação posterior na secção <link linkend="prefcolors"
>Cores</link
> do <link linkend="pref-dialog"
>Configurar o KWrite</link
>.</para>

</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist
>  
  
<para
>Os itens na página <guilabel
>Modos de Realce</guilabel
> permitem ao utilizador definir um realce mais específico, dependendo do estilo da linguagem.</para>
  
<para
>Uma pessoa não precisa de definir todas as opções disponíveis; nesse caso, os itens não configurados explicitamente irão usar a configuração por omissão especificada na página anterior (a <guilabel
>Predefinições</guilabel
>).</para
>  
  
<variablelist
>  
<varlistentry
>  
<term
><guilabel
>Configurar a Selecção</guilabel
></term
>  
<listitem
><para
>Este grupo de opções é usado para personalizar os estilos de realce para cada tipo de linguagem de programação. Todas as alterações que fizer nas outras áreas desta janela só se irão aplicar a este tipo.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Realce</guilabel
></term>
<listitem
><para
>Isto é usado para mudar o tipo de linguagem a configurar</para
></listitem
>  
</varlistentry>
<varlistentry
>  
<term
><guilabel
>Item</guilabel
></term
>  
<listitem
><para
>Aqui pode escolher o item de sintaxe a configurar. Lembre-se que isto só configura <emphasis
>este</emphasis
> item para <emphasis
>esta</emphasis
> linguagem.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Como exemplo, se o utilizador quiser configurar a aparência dos <quote
>comentários</quote
> ao programar em C++, poderá escolher o C++ na lista de <guilabel
>Realce</guilabel
>, escolhendo de seguida o Comentário na lista do <guilabel
>Item</guilabel
>. Para que os <quote
>comentários</quote
> fiquem todos iguais em todas as linguagens, o utilizador deveria configurar este item na página <guilabel
>Predefinições</guilabel
> desta janela, deixando os <quote
>comentários</quote
> por configurar na página de <guilabel
>Modos de Realce</guilabel
>.</para
> </listitem
> </varlistentry>

<varlistentry>
<term
><guilabel
>Estilo do Item</guilabel
></term>
<listitem
><para
>Aqui o utilizador poderá configurar a aparência visual do item seleccionado em cima. Ao assinalar a opção <guilabel
>Por Omissão</guilabel
> faz com que se atribua o estilo por omissão, tal como definido na página anterior; caso contrário, a aparência poderá ser configurada directamente. As opções disponíveis são as mesmas da página <guilabel
>Predefinições</guilabel
>: <guilabel
>Normal</guilabel
>, <guilabel
>Seleccionado</guilabel
>, <guilabel
>Negrito</guilabel
> e <guilabel
>Itálico</guilabel
>.</para
></listitem
> </varlistentry>

<varlistentry>
<term
><guilabel
>Detecção do Realce</guilabel
></term
>  
<listitem
><para
>O &kwrite; pode aplicar automaticamente o realce de sintaxe, dependendo da extensão ou do tipo MIME do ficheiro aberto. As predefinições são suficientemente compreensíveis, mas os utilizadores que editam regularmente os ficheiros com extensões não normalizadas poderão adicioná-las aqui. São permitidos os caracteres especiais '*' e '?' no campo de texto <guilabel
>Extensões dos Ficheiros</guilabel
>. Por exemplo, o campo por omissão para a linguagem C++ é igual a <userinput
>*.cpp;*.cc;*.C;*.h</userinput
>. Se abrir um ficheiro chamado <filename
>ola.h</filename
>, também lhe será aplicado o estilo de C++. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Tipo de Letra do Item</guilabel
></term>
<listitem
><para
>Aqui o utilizador poderá escolher o tipo de letra para o item seleccionado.</para>
<para
>O estilo por omissão poderá ser aplicado ao assinalar a opção <guilabel
>Por Omissão</guilabel
>; o utilizador também poderá escolher uma <guilabel
>Família</guilabel
>, um <guilabel
>Tamanho</guilabel
> e uma <guilabel
>Codificação</guilabel
> específicos do tipo de letra. As opções disponíveis são as mesmas da página <guilabel
>Predefinições</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>
</chapter
>  
  
<chapter id="credits"
>  
<title
>Créditos e Licenças</title
>  
  
<para
>&kwrite;. Copyright 2001, 2002 equipa do &kate;.</para>

<para
>Baseado no &kwrite; original que tem o Copyright 2000 de Jochen Wilhemly <email
>digisnap@cs.tu-berlin.de</email
> </para>

<para
>Contribuições:</para
>  

<itemizedlist>
<listitem>
<para
>&Christoph.Cullmann; &Christoph.Cullmann.mail;</para>
</listitem>

<listitem>
<para
>Michael Bartl <email
>michael.bartl1@chello.at</email
></para>
</listitem>

<listitem>
<para
>Phlip <email
>phlip_cpp@my-deja.com</email
></para>
</listitem>

<listitem>
<para
>&Anders.Lund; &Anders.Lund.mail;</para>
</listitem>

<listitem>
<para
>Matt Newell <email
>newellm@proaxis.com</email
></para>
</listitem>

<listitem>
<para
>&Joseph.Wenninger; &Joseph.Wenninger.mail;</para>
</listitem>

<listitem>
<para
>Jochen Wilhely <email
>digisnap@cs.tu-berlin.de</email
></para>
</listitem>

<listitem>
<para
>&Michael.Koch; &Michael.Koch.mail;</para>
</listitem>

<listitem>
<para
>&Christian.Gebauer; &Christian.Gebauer.mail;</para>
</listitem>

<listitem>
<para
>&Simon.Hausmann; &Simon.Hausmann.mail;</para>
</listitem>

<listitem>
<para
>Glen Parker <email
>glenebob@nwlink.com</email
></para>
</listitem>

<listitem>
<para
>Scott Manson <email
>sdmanson@altel.net</email
></para>
</listitem>

<listitem>
<para
>&John.Firebaugh; &John.Firebaugh.mail;</para>
</listitem>
</itemizedlist>
     
<para
>Documentação original por &Thad.McGinnis; &Thad.McGinnis.mail; </para>

<para
>Esta versão do Manual do &kwrite; baseia-se no original de &Cristian.Tibirna; &Cristian.Tibirna.mail; </para>

<para
>Convertido para docbook/revisão ortográfica por &Lauri.Watts; &Lauri.Watts.mail; </para>

<para
>Tradução de José Nuno Pires <email
>jncp@netcabo.pt</email
></para
> 
&underFDL; &underGPL; </chapter
> 

&documentation.index;   
</book
>  
<!--  
Local Variables:  
mode: sgml  
sgml-namecase-general: t  
sgml-namecase-entity: nil  
sgml-general-insert-case: lower  
sgml-minimize-attributes: nil  
sgml-omittag: nil  
End:  
-->  

