<?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
>2004-08-27</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
>Embora 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
>Indicar 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 o próximo</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>
<!--
This is description of a standard dialog and so should go in the UG,
with a pointer to it. In fact, I'll probably nick this very stuff for
the UG
- Phil
<para>
This command opens a file.  It does this by means of a dialog box which
allows the user to navigate the file system.  The dialog operates like a
small file manager. Clicking on folders displayed in the central
window directs the dialog to enter that folder - displaying its
contents.  There is an entry/dropdown box which can be used to type in
directly the location and name of the file or by clicking the arrow at
the side choose from a dropdown list of recently used locations. Below
this is a filter which similarly may have data entered directly or
chosen from a dropdown list of recent filter types.  The filter facility
lets only files that meet its specifications be displayed in the central
window. If the filter contained text such as <literal
role="extension"
>*.txt</literal
> then only files with the <literal
role="extension"
>txt</literal
> extension would be visible in the
selection window. Below the filter is a status bar giving information
about the number of files and subfolders within the current
folder.
</para>

<para>
The toolbar, which is located at the top of the dialog, has left and
right arrow buttons that let the user move back and forth through
previously selected folders as well as an up arrow button for moving
up the folder tree. The button with the little house takes the user
to his or her home folder and the one with the two arrows curved in
on each other updates the view of the current folder. The flag button
lets the user set a new bookmark at the current folder or go to one
that was previously set. 
</para>

<para>
The last button on the toolbar allows you to create a new folder, and
even change some basic settings for the dialog box, and finally there is
dropdown box with a list of some commonly frequented folders.
</para>
-->
<para
>Mostra uma janela normal do &kde; para <guilabel
>Abrir um Ficheiro</guilabel
>. Use a janela de ficheiros para seleccionar o ficheiro que deseja abrir, carregando depois em <guibutton
>Abrir</guibutton
> para aceder a ele. Poderá encontrar mais informações sobre a janela do &kde; para <guilabel
>Abrir um Ficheiro</guilabel
> no Guia de Utilizador do &kde;.</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 indicar 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 anular a acção ou operação mais recente por parte do utilizador. </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 definir 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
>Bookmarks</guimenu>
<guimenuitem
>Toggle Bookmark</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
To be written
</para>
</listitem>
</varlistentry>
-->
<varlistentry>
<term id="clear-bookmarks">
<menuchoice
><guimenu
>Favoritos</guimenu
> <guimenuitem
>Limpar Todos 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 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 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 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 indicar uma cor para o fundo geral do &kwrite;.</para
></listitem
>   
</varlistentry
>  

<varlistentry
>  
<term
><guilabel
>Seleccionado</guilabel
></term
>  
<listitem
><para
>Isto permite ao utilizador seleccionar a cor a usar 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 que os seleccionados não serão encolhidas.</para
></listitem
>  
</varlistentry
>  
  
</variablelist
>  
</sect1
>  

<!-- 
2004-08-27
Out of date - getting it out of the translators' way
- Phil
<sect1 id="pref-select"
>  
<title
>Select</title
>  
<variablelist
>  
  
<varlistentry
>  
<term
><guilabel
>Persistent Selections</guilabel
></term
>  
<listitem
><para
>This prevents key input or cursor movement by way of the  
arrow keys from causing the elimination of text  
selection. </para
><note
><para
>(Note: If the Overwrite Selections option is  
activated then any typed character input or paste operation will replace  
the selected text.)</para
></note
></listitem
> </varlistentry
>  
  
<varlistentry
> <term
><guilabel
>Overwrite Selections</guilabel
></term
>  
<listitem
><para
>Any keyed character input or paste operation will replace  
the selected text.  </para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Mouse Autocopy</guilabel
></term
> <listitem
><para
>Any text  
selected with the mouse will be automatically copied to the  
clipboard.</para
></listitem
>  
</varlistentry
>  

<varlistentry
>  
<term
><guilabel
>X11-like Single Selection</guilabel
></term
>  
<listitem
><para
>Not implemented yet.</para
></listitem
>  
</varlistentry
>  

  
<varlistentry
>  
<term
>Toggle Old</term
> <listitem
><para
>Not yet implemented</para
></listitem
>  
</varlistentry
>  
  
</variablelist
>  
</sect1
>  
  -->
<sect1 id="pref-edit"
>  
<title
>Editar</title
>  
<variablelist
>  
<varlistentry
>  
<term id="pref-word-wrap"
><guilabel
>Mudança de Linha Estática</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>

<!-- Outdated
<varlistentry>
<term id="group-undos"
><guilabel
>Group Undos</guilabel
></term>
<listitem
><para
>Groups of similar actions are to be considered a single
<link linkend="undo"
>Undo</link
> step by &kwrite;. In other words, a series
of regular character keystrokes (words or expressions) would be considered
one step and therefore be removed by a single undo operation.  If the
series of character entries were interrupted by a non-character entry
operation (such as a backspace), invoking undo would only remove the
entries made since that operation. The next undo would then reverse that
operation and so on.</para>
<para
> When this option is not selected &kwrite; considers
each keystroke to be a single step.  So if the user (with this option
active) were to type several words or even sentences without having to make
corrections or cut or paste or some other non-character entry operation
then a click of the undo button would eliminate all that had been typed
since the last non-entry operation.  A second click would eliminate that
operation and a third any operation or series of entries that occurred
before the operation and so on.  When not selected three clicks of the undo
button would only remove the last three letters typed, or the last three
operations.</para
></listitem
>  
</varlistentry
>  
-->  
<varlistentry
> <term
><guilabel
>Mostrar Tabulações</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
>Smart Home</guilabel
></term>
<listitem
><para
>Not yet implemented</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>

<!-- Outdated
<varlistentry>
<term
>Encoding</term>
<listitem>
<para>
This sets the character encoding for your file.
</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 indicar 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>

<!--
2004-08-27 
Whole chapter is out of date, moving out of translators' way
-Phil
<chapter id="pref-highlighting">
<title
>Highlighting</title>

<para
>The <guilabel
>Configure Highlighting</guilabel
> dialog consists of two
pages, <guilabel
>Defaults</guilabel
> and <guilabel
>Highlighting
Modes</guilabel
>.  The user can select which page to view by clicking on the
appropriate tab at the top of the dialog</para>

<para
>Items available on the <guilabel
>Defaults</guilabel
> page are as
follows:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Default Item Styles</guilabel
></term>
<listitem>
<para>
The user can configure the default appearance for particular items.
This would allow a programmer to more easily identify different items
(types of entries) in his or her code.
</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Item</guilabel
></term>
<listitem
><para
>This drop down list offers a variety of items that the user
might want to highlight.  They include <guilabel
>Normal</guilabel
> for
text does not fit in any of the other categories, <guilabel
>Comment</guilabel
>,
<guilabel
>String</guilabel
>, <guilabel
>Keyword</guilabel
> and many more.  Not
all of these entries will need to be configured for every language and so may be
selected as needed.  The options in the rest of this section apply
to the entry selected in this box.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Normal</guilabel
></term>
<listitem
><para
>This allows the user to choose the item's normal
(unselected) color.  This is done by means of a color selection
dialog box, a further explanation of which may be found in the <link
linkend="prefcolors"
>Colors</link
> section of <link
linkend="pref-dialog"
>Configure KWrite</link
>.</para>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Bold</guilabel
></term>
<listitem
><para
>This option determines whether or not the item should be displayed in
bold text.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Italic</guilabel
></term>
<listitem
><para
>This option determines whether or not the item should be displayed in italic
text.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Selected</guilabel
></term>
<listitem
><para
>This allows the user to choose the item's color
when selected.  This is done by means of a color selection
dialog box, a further explanation of which may be found in the <link
linkend="prefcolors"
>Colors</link
> section of <link
linkend="pref-dialog"
>Configure KWrite</link
>.</para>

</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist
>  
  
<para
>Items on the <guilabel
>Highlight Modes</guilabel
> tab allow the user to define
more specific highlighting depending on the language style.</para>
  
<para
>One need not set every available option, items not configured
specifically will use the default configuration specified on the previous  
(<guilabel
>Defaults</guilabel
> tab.</para
>  
  
<variablelist
>  
<varlistentry
>  
<term
><guilabel
>Config Select</guilabel
></term
>  
<listitem
><para
>This group of options is used to customize the highlighting styles
for each programming language type.  Any changes you made in
other areas of this dialog apply only to this type.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Highlight</guilabel
></term>
<listitem
><para
>This is used to choose the language type to
configure</para
></listitem
>  
</varlistentry>
<varlistentry
>  
<term
><guilabel
>Item</guilabel
></term
>  
<listitem
><para
>This is to choose the syntax item to configure.  Remember
this  only configures <emphasis
>this</emphasis
> item for <emphasis
>this</emphasis>
language.</para
></listitem>
</varlistentry>
</variablelist>

<para
>As an example, if the user wished to configure the appearance of
<quote
>comments</quote
> while writing C++, she or he could choose C++ in the
<guilabel
>Highlight</guilabel
> drop down list, and then choose Comment in the
<guilabel
>Item</guilabel
> drop down list. To have <quote
>comments</quote
> look
the same across all languages, the user would need to configure this in the
<guilabel
>Defaults</guilabel
> page of this dialog box while leaving
<quote
>comments</quote
> unconfigured within the more specific
<guilabel
>Highlight Modes</guilabel
> page.</para
> </listitem
> </varlistentry>

<varlistentry>
<term
><guilabel
>Item Style</guilabel
></term>
<listitem
><para
>Here the user can configure the general appearance of the above
selected item.  Checking the <guilabel
>Default</guilabel
> checkbox causes the default
style as configured on the previous tab to be set, or the
appearance can be configured directly.  The available options are the same as on the
<guilabel
>Defaults</guilabel
> tab: <guilabel
>Normal</guilabel
>,
<guilabel
>Selected</guilabel
>, <guilabel
>Bold</guilabel
> and
<guilabel
>Italic</guilabel
>.</para
></listitem
> </varlistentry>

<varlistentry>
<term
><guilabel
>Highlight Auto Select</guilabel
></term
>  
<listitem
><para
>&kwrite; can apply syntax highlighting automatically, depending  
on the file extension or mime-type of the opened file.  The defaults are fairly
comprehensive, but users that regularly edit files with non-standard extensions
can add them here.  Wildcards are allowed in the <guilabel
>File
Extensions</guilabel
> text box.  For example, the default entry for the C++
language is <userinput
>*.cpp;*.cc;*.C;*.h</userinput
>.  Opening a file called
<filename
>foo.h</filename
> would automatically apply the C++ style to it.
</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Item Font</guilabel
></term>
<listitem
><para
>Here the user can choose the font for the selected item.</para>
<para
>The default style can be applied by checking the
<guilabel
>Default</guilabel
> checkbox or the user can choose a specific font
<guilabel
>Family</guilabel
>, <guilabel
>Size</guilabel
> and
<guilabel
>Charset</guilabel
>.  The available options are the same as those on
the <guilabel
>Defaults</guilabel
> tab.</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:  
-->  

