<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.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
> <firstname
>Thad</firstname
><surname
>McGinnis</surname
> <affiliation
><address
><email
>ctmcginnis@compuserve.com</email
></address
> </affiliation
> </author>

<othercredit role="developer">
<firstname
>Christoph</firstname>
<surname
>Cullmann</surname>
<affiliation>
<address
><email
>cullmann@kde.org</email
></address>
</affiliation>
<contrib
>Programação e Manutenção</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname
>Lauri</firstname
><surname
>Watts</surname>
<contrib
>Revisão</contrib>
<affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
</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 proderosos. 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
>Especificar 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
>Especficar 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
>F1</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
>M</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 directorias mostradas na janela central direcciona a janela para entrar dentro dessa directoria, 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 filotro 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-directorias na directoria 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 directorias seleccionadas previamente, assim como uma seta para cima para subir na estrutura de directorias. O botão com a pequena casa leva o utilizador para a sua directoria pessoal, correspondendo finalmente o botão com as setas curvas à actualização da vista sobre a directoria actual. O botão da bandeira permite ao utilizador atribuir um novo favorito à directoria actual ou saltar para um favorito previamente definido. </para
> <para
> O último botão na barra de ferramentas permite-lhe criar uma nova directoria e mesmo alterar algumas opções básicas da janela; finalmente existe uma lista com as directorias mais frequentadas. </para
> </listitem
> </varlistentry
> <varlistentry
> <term id="open-recent"
> <menuchoice
> <guimenu
>Ficheiro</guimenu
> <guisubmenu
>Abrir Recente</guisubmenu
> </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
>Ficheiro</guimenu
> <guimenuitem
>Nova Vista</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Isto cria uma nova vista sobre o documento actual, &ie;, uma nova instância do &kwrite; (tal como descrito no item anterior) que contém o mesmo documento. </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
>Editar</guimenu
> <guimenuitem
>Histórico do Desfazer/Refazer</guimenuitem
></menuchoice
></term
> <listitem
> <para
>Isto irá abrir uma lista com as acções mais recentes à direita, assim como outra lista das acções que foram 'desfeitas' ou anuladas à direita. Existem também três botões à direita da janela chamados <guibutton
>Desfazer</guibutton
>, <guibutton
>Refazer</guibutton
> e <guibutton
>Fechar</guibutton
>. Se carregar no botão <guibutton
>Desfazer</guibutton
>, fará com que a acção no topo da lista Desfazer seja anulada, o que colocará essa acção em particular no topo da lista Refazer. De igual forma, se carregar no botão <guibutton
>Refazer</guibutton
> fará com que se repita a acção anulada e que seja resposta à lista Desfazer. Se carregar num item por baixo do item de topo de qualquer uma das listas, fará com que todos os itens desde o topo até essa acção em particular fiquem seleccionados. A selecçãod o botão respectivo fará com que todas as acções seleccionadas sejam anuladas ou repetidas. Isto seria particularmente útil quando o utilizador soubesse precisamente o ponto a partir do qual deseja prosseguir - deixando de ser necessário percorrer uma série de acções de anulação ou repetição singulares.</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
>Editar</guimenu
><guimenuitem
>Inverter a Selecção</guimenuitem
></menuchoice
></term
> <listitem
> <para
>Isto selecciona todo o texto não seleccionado, enquanto que deselecciona o texto previamente seleccionado - de facto, inverte o estado actual da selecção.</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 Seguinte</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
>Editar</guimenu
><guimenuitem
>Comando de Edição</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> </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
> </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 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 Errada:</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
>Substituição:</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
>Sugestões:</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
> </variablelist
> <para
>Do lado direito da janela existem 6 botões que permitem ao utilizador controlar o processo de verificação ortográfica. São estes:</para
> <variablelist
> <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 Errada:</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 Errada:</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
> <varlistentry
> <term
><guibutton
>Adicionar</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
>Parar</guibutton
></term
> <listitem
><para
> Este botão interrompe o processo de verificação ortográfica.</para
></listitem
> </varlistentry
> </variablelist
> <para
>Localizada horizontalmente na parte inferior da janela de verificação ortográfica existe uma barra de progresso. À medidade que o processo de verificação ortográfica decorre a barra vai sendo preenchida para dar uma representação gráfica do percurso no documento. Para além disso, o progresso é mostrado numericamente no centro da barra de progresso.</para
> <note
><para
>Também é apresentada numericamente a evolução do processo de verificação ortográfica na barra de estado do editor. A <link linkend="show-statusbar"
>barra de estado</link
> é a tira horizontal no fundo do editor por baixo do campo de texto.</para
></note
> <para
>Existem mais dois botões por baixo da barra de progresso. 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
>Cancelar</guibutton
></term
> <listitem
><para
> Este botão cancela o processo de verificação ortográfica.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><anchor id="indent"/><menuchoice
> <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
> <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
> <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
> <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
> <varlistentry
> <term
> <menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>I</keycap
></keycombo
></shortcut
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Indentar</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>U</keycap
></keycombo
> </shortcut
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Desindentar</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Limpar a Indentação</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>#</keycap
></keycombo
></shortcut
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Comentar</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>I</keycap
></keycombo
></shortcut
> <guimenu
>Ferramentas</guimenu
> <guimenuitem
>Descomentar</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> </para
> </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="configure-keybindings"/><menuchoice
> <guimenu
>Configuração</guimenu
><guimenuitem
>Configurar Teclas</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 atalaho 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
><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
> <menuchoice
> <shortcut
><keycombo action="simul"
><keycap
>F6</keycap
></keycombo
></shortcut
> <guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar o Contorno do Ícone</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Activa a visualização de um contorno à esquerda da janela de edição, onde serão mostrados os favoritos ao lado da linha em que se aplicam. </para
> </listitem
> </varlistentry
> <varlistentry
> <term id="vertical-selection"
> <menuchoice
> <shortcut
><keycombo action="simul"
><keycap
>F4</keycap
></keycombo
></shortcut
> <guimenu
>Configuração</guimenu
> <guimenuitem
>Selecção Vertical</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Isto é usado para ligar ou desligar a funcionalidade da selecção vertical. Esta permite ao texto ser seleccionado por coluna assim como por linha. Por outras palavras, graças a esta funcionalidade o utilizador é capaz de seleccionar o texto que está contido em apenas algumas colunas e linhas contíguas em particular. De facto, o utilizador conseguirá escolher uma área rectangular de texto em qualquer local do documento. </para
> </listitem
> </varlistentry
> <varlistentry
> <term id="set-highlight"
> <menuchoice
> <guimenu
>Configuração</guimenu
> <guisubmenu
>Modo de Realce</guisubmenu
> </menuchoice
> </term
> <listitem
> <para
> Isto permite ao utilizador escolher o estilo do realce de sintaxe que o editor usa para mostrar o texto. Os estilos são seleccionados pela linguagem de programação. A informação do tipo de letra/cor não é armazenada com o documento. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><anchor id="end-of-line"/> <menuchoice
> <guimenu
>Configuração</guimenu
><guisubmenu
>Fim de Linha</guisubmenu
></menuchoice
></term
> <listitem
> <para
>Isto abre um sub-menu a partir do qual o utilizador poderá seleccionar o tipo de código de <quote
>fim de linha</quote
> para o &kwrite; usar, <abbrev
>i.e.</abbrev
>, a norma aceite e que é usada pelo &UNIX;, pelo &Mac; ou pelo MSDOS/&Windows;.</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 sselecciona um nível de intensidade (valor). Os várois 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 moviemtaçã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 <link linkend="vertical-selection"
>Selecções Verticais</link
>.</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' irira 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 irá 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
>Correcção Ortográfica</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 estensõ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 <email
>cullmann@kde.org</email
></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 <email
>anders@alweb.dk</email
></para
> </listitem
> <listitem
> <para
>Matt Newell <email
>newellm@proaxis.com</email
></para
> </listitem
> <listitem
> <para
>Joseph Wenninger <email
>jowenn@bigfoot.com</email
></para
> </listitem
> <listitem
> <para
>Jochen Wilhely <email
>digisnap@cs.tu-berlin.de</email
></para
> </listitem
> <listitem
> <para
>Michael Koch <email
>koch@kde.org</email
></para
> </listitem
> <listitem
> <para
>Christian Gebauer <email
>gebauer@bigfoot.com</email
></para
> </listitem
> <listitem
> <para
>Simon Hausmann <email
>hausmann@kde.org</email
></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 <email
>jfire@uclink.berkeley.edu</email
></para
> </listitem
> </itemizedlist>
     
<para
> Documentação Original por Thad McGinnis <email
>ctmcginnis@compuserve.com</email
> </para>

<para
> Esta versão do Manual do &kwrite; baseia-se no original de Cristian Tibirna <email
>tibirna@kde.org</email
> </para>

<para
> Convertido para docbook/revisão ortográfica por Lauri Watts <email
>lauri@kde.org</email
> </para>

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

<appendix id="installation">
<title
>Instalação</title>

&install.intro.documentation;
&install.compile.documentation;

</appendix
>  
  
&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:  
-->  

