<?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 % Brazilian-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
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus_gama@uol.com.br</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 que um editor de texto para o Ambiente de Trabalho &kde;. Ele pretende ser um editor de programadores, e pode ser considerado como pelo menos uma alternativa parcial para os editores mais poderosos. Ele pode ser melhor usado em conjunto com o &konqueror; para navegação de arquivos fontes de diferentes linguagens. O &kwrite; também trabalha muito bem como um simples editor de texto. Um dos principais recursos do &kwrite; é colorização de sintaxe, personalizada para muitas linguagens de programação diferentes como o 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. Qualquer um que tenha usado um editor de texto não deve ter problemas. </para>
  
<sect1 id="drag-and-drop"
>  
<title
>Arrastar e Soltar</title
>  
  
<para
>O &kwrite; usa o protocolo de Arrastar e Soltar do &kde;. Arquivos podem ser arrastados e soltos no &kwrite; a partir da área de trabalho, do &konqueror; ou de algum site &FTP; remoto aberto em uma das janelas do &konqueror;. </para>
</sect1>
  
<sect1 id="command-line-options"
>  
<title
>Opções de Linha de Comando</title
>  
  
<para
>Apesar do &kwrite; ser a maioria das vezes iniciado a partir do menu de programas do KDE, ou de um ícone na área de trabalho, ele pode também ser aberto a partir do prompt da linha de comando de uma janela de terminal. Existem algumas poucas opções úteis que estarão disponíveis quando fizer isto. </para>
  
<sect2 id="specify-a-file"
>  
<title
>Especificar um Arquivo</title
>  
  
<para
>Especificando o caminho e nome de um arquivo específico o usuário pode fazer com que o &kwrite; abra (ou crie) este arquivo imediatamente após iniciar. Esta opção pode parecer algo como o seguinte:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kwrite</command
> 
<option
><replaceable
>/home/minhacasa/docs/meuarquivo.txt</replaceable
></option
></userinput
>
</screen>
</informalexample>
</sect2>
<sect2 id="editing-files-on-the-internet">
<title
>Especificar um arquivo da internet</title>

<para
>O método acima mencionado pode também ser usado para abrir arquivos na internet (se o usuário tiver uma conexão ativa no momento.) Um exemplo disto pode parecer com 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 de Linha de Comando</title>

<para
>As seguintes opções de ajuda de linha de comando estão disponíveis</para>

<variablelist>
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--help</option
></userinput
></term
>  
<listitem
><para
>Isto lista as opções mais básicas disponíveis na linha de comando.</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 maneira 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 mudar a maneira com 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 de linha de comando.</para
></listitem
>  
</varlistentry
>  
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--author</option
></userinput
></term>
<listitem
><para
>Lista o autor do &kwrite; na janela do terminal</para
></listitem
>  
</varlistentry
>  
<varlistentry
>  
<term
><userinput
><command
>kwrite</command
> <option
>--version</option
></userinput
></term>
<listitem
><para
>Lista as informações de versão do &Qt;, &kde; e &kwrite;. Também disponível através de <userinput
><command
>kwrite</command
> <option
>-V</option
></userinput
> </para
></listitem>
</varlistentry
>  
</variablelist
>  
</sect2>
</sect1
>  
  
<sect1 id="keybindings"
>  
<title
>Atalhos de Teclado</title
>  
  
<para
>Muitos tipos de atalhos de teclado são configuráveis através do menu de <link linkend="settings"
>Configurações</link
>. Por padrão o &kwrite; permite os seguintes atalhos de teclado.</para
>  
  
<informaltable
>  
<tgroup cols="2"
>  
<tbody
>  
  
<row
><entry
><para
><keycombo 
action="simul"
><keycap
>Insert</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Alterna entre o modo Inserir e Sobrescrever. Quando no modo inserir o editor adicionará qualquer caracter digitado ao texto empurrando qualquer dado à direita do cursor do texto. O modo sobrescrever faz com que a entrada de cada caracter elimine o caracter imediatamente à direita do cursor de texto.</para
></entry>
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Seta Esqueda</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor um caracter para a esquerda </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Seta Direita</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor um caracter para a direita </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Seta Acima</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor uma linha acima </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Seta Abaixo</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor uma linha abaixo </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Page Up</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor uma página acima </para
></entry
>  
</row>
<row
>  
<entry
><para
><keycombo action="simul"
><keycap
>Page Down</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Move o cursor uma página abaixo </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
><keycap
>Backspace</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Apaga o caracter à 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 caracter à direita do cursor (ou qualquer texto selecionado)</para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
>&Shift;<keycap
>Seta Esquerda</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Marca o texto um caracter à esquerda </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo action="simul"
>&Shift;<keycap
>Seta Direita</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Marca o texto um caracter à 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 é Isso?</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 novamente</link
></para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Copia o texto marcado para a área de transferência. </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Configura um Favorito</para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></para
></entry
>  
<entry
><para
><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"
>Imprime</link
> </para
></entry
>  
</row
>  
<row>
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></para
></entry>
<entry
><para
>Sai - fecha a cópia ativa do editor </para
></entry>
</row>
<row>
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
></para
></entry>
<entry
><para
><link linkend="replace"
>Substitui</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
>Salvar</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 na linha de edição. </para
></entry
>  
</row
>  
<row
>  
<entry
><para
><keycombo 
action="simul"
>&Ctrl;<keycap
>X</keycap
></keycombo
></para
></entry
>  
<entry
><para
>Apaga o texto marcado 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 Entradas de Menu</title
>  
  
<sect1 id="file"
>  
<title
>O Menu <guimenu
>Arquivo</guimenu
></title
>  
  
<variablelist
>  
  
<varlistentry
>  
<term id="new">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Novo</guimenuitem
></menuchoice
></term
>  
<listitem>
<para
>Isto inicia um novo Documento no editor. Se existir uma documento aberto com mudanças não salvas o usuário terá a chance de salvá-lo. </para
>  
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="open">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</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
>Exibe o diálogo padrão do &kde; <guilabel
>Abrir Arquivo</guilabel
>. Use o visualizador de arquivo para selecionar o arquivo que você deseja abrir, e clique em <guibutton
>Abrir</guibutton
> para abrí-lo. Você pode encontrar mais informações sobre o diálogo do &kde; <guilabel
>Abrir Arquivo</guilabel
> no Guia do Usuário do &kde;.</para>

</listitem>
</varlistentry
>  
  
<varlistentry
>  
<term id="open-recent">
<menuchoice
><guimenu
>Arquivo</guimenu
> <guisubmenu
>Abrir Recente</guisubmenu
> </menuchoice>
</term
> 
<listitem>
<para
>Este é um atalho para os documentos recentemente salvos. Clicar neste ítem abrirá uma lista ao lado do menu com vários dos arquivos mais recentemente salvos. Clicar em um arquivo específico irá abrí-lo no &kwrite; - se o arquivo ainda estiver na mesma localização. </para>
</listitem>
</varlistentry>
  
<varlistentry
>  
<term id="save">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Salvar</guimenuitem
> </menuchoice>
</term
>  
<listitem>
<para
>Isto salva o documento atual. Se o documento já tiver sido salvo então isto sobrescreverá o arquivo anteriormente salvo sem pedir pela permissão do usuário. Se esta é a primeira vez que salva um novo documento a diálogo salvar como (descrito abaixo) será invocado. </para>
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="save-as">
<menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Salvar Como...</guimenuitem
> </menuchoice>
</term
>  
<listitem>
<para
>Isto permite que um documento seja salvo com um novo nome de arquivo. Isto é feito com a caixa de diálogo de arquivo descrita acima na seção <link linkend="open"
>Abrir</link
> deste arquivo de ajuda. </para>
</listitem>
</varlistentry>
  
<varlistentry
>  
<term id="print">
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Imprimir...</guimenuitem
> </menuchoice>
</term
>  
<listitem
>  
<para
>Abre um diálogo simples de impressão que permite o usuário especificar o que, 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
>Arquivo</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Isto fechará a janela do editor. Se você tiver mais de uma instância do &kwrite; em execução, através dos ítens de menu <guimenuitem
>Nova Visão</guimenuitem
> ou <guimenuitem
>Nova Janela</guimenuitem
>, estas 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 ação ou operação mais recente do usuário. </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 reverte a mudança mais recente (se houver) feita usando o 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 exclui a seleção atual e coloca-a na área de transferência. A área de transferência é um recurso do KDE que trabalha de maneira invisível para fornecer um modo de transferir dados entre aplicativos.</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 atualmente selecionado para a área de transferência de modo que ele possa ser colado em outro lugar. A área de transferência é um recurso do KDE que trabalha de maneira invisível para fornecer um modo de transferir dados entre aplicativos.</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 é um recurso do KDE que trabalha de maneira invisível para fornecer um modo de transferir dados entre aplicativos.</para
>  
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="select-all"/><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
><guimenuitem
>Selecionar Tudo</guimenuitem
></menuchoice
></term>
<listitem
>  
<para
>Isto irá selecionar todo o documento. Isto pode ser muito útil para copiar um arquivo inteiro para outro aplicativo.</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 linha</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Isto abre a caixa de diálogo ir para linha, que é usada para fazer com que o cursor pule para uma linha em particular (especificada pelo número) no documento. O número da linha pode ser inserido diretamente na caixa de texto ou graficamente clicando na seta para cima e para baixo do controle de contagem ao lado da caixa de texto. A pequena seta para cima aumentará o número da linha e a seta para baixo diminuirá. Existe também um índice deslizante à direita da caixa de texto que permite o usuário mover o ponto do ir para no documento de uma maneira semelhante. </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 o diálogo de procura que é usado para especificar o <guilabel
>Texto a Procurar</guilabel
> no documento. Existe uma pequena caixa de texto para inserir o termo a procurar que também é uma caixa combinada. Clica na seta para baixo ao lado da caixa torna disponíveis outros termos de busca recentes. Outros parâmetros são incluídos para tornar a busca mais eficiente. Selecionar <guilabel
>Sensível à Caixa</guilabel
> limitará a busca a entradas que correspondam a caixa (superior ou inferior) de cada caracter no termo de busca. <guilabel
>Procurar para Trás</guilabel
> direciona a busca para ser realizada na direção do início do arquivo. A opção <guilabel
>Texto Selecionado</guilabel
> mantém a busca dentro do texto selecionado. Habilitar <guilabel
>Somente Palavras Completas</guilabel
> evita que a busca pare em palavras que contenham o termo procurado. A opção <guilabel
>Procurar a partir do Cursor</guilabel
> inicia a busca a partir da posição atual do cursor dentro do documento ao invés de iniciá-la 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 Próximo</guimenuitem
></menuchoice
></term
>  


<listitem
>  
<para
>Isto repete a última operação de busca, se houver, sem chamar a caixa de diálogo 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 busca, se houver, sem chamar a caixa de diálogo de procura, e busca no documento para trás ao invés de para frente. </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 caixa de diálogo de substituição. O diálogo de substituição é bastante parecido com o diálogo de procura acima mencionado. Além dos recursos do diálogo de procura ele contém uma caixa combinada <guilabel
>Substituir Com:</guilabel
>. Usando este diálogo o usuário pode especificar tanto o texto a ser encontrado como o texto que deverá substituí-lo. A opção adicional <guilabel
>Perguntar Ao Substituir</guilabel
> permite ao usuário confirmar ao &kwrite; 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 Favoritos</guimenuitem
> </menuchoice>
</term
>  
<listitem
>  
<para
>Este comando removerá todos os marcadores do documento bem como a lista de marcadores que é anexada na base deste ítem de menu. </para
> 
</listitem
> 
</varlistentry
> 
</variablelist>
  
<para
>Na base deste menu, uma lista de marcadores aparece se algum marcador está disponível para esta janela. </para>

</sect1
>  
  
<sect1 id="tools"
>  
<title
>O Menu <guimenu
>Ferramentas</guimenu
></title
>  
  
<variablelist>
<varlistentry>
<term
><anchor id="Spelling..."/><menuchoice
><guimenu
>Ferramentas</guimenu
><guimenuitem
>Ortografia...</guimenuitem
></menuchoice
></term>

<listitem
><para
><action
>Isto inicia o programa de verificação ortográfica - um programa desenvolvido para auxiliar o usuário a detectar e corrigir qualquer erro ortográfico.</action
> Clicar nesta entrada iniciará o verificador e levantará a caixa de diálogo de ortografia a partir da qual o usuário pode controlar o processo. Existem quatro caixas alinhadas verticalmente no centro do diálogo com seus rótulos correspondentes à esquerda. Iniciando do topo elas são:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Palavra desconhecida:</guilabel
></term>
<listitem
><para
>Aqui, o verificador ortográfico indica a palavra atualmente em consideração. Isto acontece quando o verificador encontra uma palavra que não está em seu dicionário - um arquivo contendo uma lista de palavras ortograficamente corretas contra a qual ele compara cada palavra no editor.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Substituir com:</guilabel
></term>
<listitem
><para
>Se o verificador possuir alguma palavra semeplhante no seu dicionário a primeira será listada aqui. O usuário pode aceitar a sugestão, digitar nesta caixa sua correção, ou escolher uma sugestão diferente a partir da próxima caixa.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Palavras Sugeridas:</guilabel
></term>
<listitem
><para
>O verificador pode listar aqui um número de possíveis substituições para a palavra em consideração. Clicar em qualquer uma das sugestões fará com que a palavra seja inserida na caixa <guilabel
>Substituição</guilabel
> acima.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Idioma:</guilabel
></term>
<listitem
><para
>Se você tiver múltiplos dicionários instalados, aqui você pode selecionar qual dicionário/idioma deve ser usado.</para
></listitem>
</varlistentry>
</variablelist>

<para
>No lado direito da caixa de diálogo existem 5 botões que permitem controlar o processo de verificação ortográfica. Eles são:</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Adicionar ao Dicionário</guibutton
></term>
<listitem
><para
>Pressionar este botão adiciona a palavra na caixa <guilabel
>Palavra Desconhecida:</guilabel
> ao dicionário do verificador. Isto significa que no futuro o verificador sempre considerará esta palavra como ortograficamente correta.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Substituir</guibutton
></term>
<listitem
><para
>Este botão faz o verificador substituir a palavra em consideração no documento com a palavra na caixa <guilabel
>Substituição:</guilabel
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Substituir Todas</guibutton
></term>
<listitem
><para
>Este botão faz com que o verificador substitua não somente a <guilabel
>Palavra desconhecida:</guilabel
> atual, mas automaticamente faça a mesma substituição para qualquer outra ocorrência detsa <guilabel
>Palavra Desconhecida:</guilabel
> no documento.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Ignorar</guibutton
></term>
<listitem
><para
>Ativar este botão fará com que o verificador avance sem realizar nenhuma mudança.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Ignorar Todas</guibutton
></term>
<listitem
><para
>Este botão faz com que o verificador não faça nada com a <guilabel
>Palavra desconhecida:</guilabel
> atual e em nenhuma das outras ocorrências da mesma palavra.</para
> <note
><para
>Isto somente se aplica a verificação ortográfica atual em execução. Se o verificador for executado novamente mais tarde ele irá parar nesta 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
>Três outros botões estão localizados horizontalmente ao longo da base do diálogo de verificação ortográfica. Eles são:</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Ajuda</guibutton
></term>
<listitem
><para
>Isto invoca o sistema de ajuda do KDE iniciando a página de ajuda do &kwrite; (este documento).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Terminado</guibutton
></term>
<listitem
><para
>Este botão termina o processo de verificação ortográfica, e retorna ao 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 revertidas, e você retornará 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 em um passo. O tamanho do passo depende das <link linkend="pref-indent"
>configurações de 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 em um passo. O tamanho do passo depende das <link linkend="pref-indent"
>configurações de indentação</link
>.</para
>  
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="cleanindent"/><menuchoice
><guimenu
>Ferramentas</guimenu
><guimenuitem
>Limpar Indentação</guimenuitem
></menuchoice
></term
>  <listitem
>  
<para
>Não implementado ainda</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 um espaço ao início da linha onde o cursor de texto está localizado ou ao início de quaisquer linhas selecionadas.</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) do início da linha onde o cursor de texto está localizado ou do início de quaisquer linhas selecionadas.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings">
<title
>O Menu <guimenu
>Configurações</guimenu
></title>

<variablelist>
<varlistentry>
<term
><anchor id="show-toolbar"/><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Mostrar Barra de Ferramentas</guimenuitem
> </menuchoice>
</term
>  
<listitem
>  
<para
>Quando habilitado, isto exibe uma barra de ferramentas móvel que contém botões usados para iniciar os comandos mais frequentemente usados. Quando desabilitado a barra de ferramentas é oculta. </para
> 
</listitem
> 
</varlistentry>
  
<varlistentry
>  
<term
><anchor id="show-statusbar"/><menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Mostrar Barra de Estado</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Quando habilitado, isto exibe uma pequena barra na base do editor contendo informações sobre o estado do documento atual. Quando desabilitado a barra de estado é oculta.</para
>     
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="show-path"/><menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Mostrar Caminho</guimenuitem
></menuchoice
></term>
<listitem
>  
<para
>Quando selecionado, isto exibe na barra de título o caminho (a localização no sistema de arquivos) do documento atual. Quando desabilitado o caminho é oculto.</para>
</listitem
>  
</varlistentry
>  

<varlistentry
>  
<term
><anchor id="preferences"/><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar Editor...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Este ítem de menu abre um diálogo de onde diversas <link linkend="pref-dialog"
>configurações</link
> diferentes podem ser ajustadas. </para>
</listitem
> 
</varlistentry>
  
<varlistentry
>  
<term
><anchor id="configure-keybindings"/><menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Configurar Atalhos...</guimenuitem
></menuchoice
></term
>  
<listitem
>  
<para
>Este comando abre uma caixa de diálogo de onde os <link linkend="keybindings"
>atalhos de teclado</link
> podem ser mudados. Um quadro mostrado no topo da caixa de diálogo mostra a lista de comandos (ações) que pode ter atalhos de teclado. Abaixo do quadro estão três botões de opção. O usuário pode escolher entre Nenhuma Tecla, Tecla Padrão e Tecla Personalizada. (Observe que um conjunto de botões de opção somente permite a seleção de um dos ítens oferecidos - da mesma maneira que os botões de um rádio de um automóvel somente oferecem a seleção de uma estação pré-configurada. Observe também que a seleção Tecla Padrão está somente disponível para aqueles comandos que atualmente possuem um atalho 'padrão'.) Selecionar a opção de Tecla Personalizada ativa as três caixas de verificação e o botão tecla na base do diálogo. O usuário pode então selecionar uma combinação de teclas para o comando em questão usando as caixas de verificação e o botão tecla. Por exemplo, com o comando Sobre o KDE selecionado no quadro, o usuário pode selecionar &Ctrl; e <keycap
>Alt</keycap
>, clicar no botão tecla, e então pressionar a tecla <keycap
>K</keycap
> no teclado. Isto fará que sempre que alguém manter pressionado os botões &Ctrl; e <keycap
>Alt</keycap
> e pressionar o <keycap
>K</keycap
> (enquanto estiver usando o &kwrite;) a caixa Sobre o KDE será chamada. </para
>   
</listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><anchor id="configure-toolbars"/><menuchoice
><guimenu
>Configurar</guimenu
><guimenuitem
>Configurar Barra de Ferramentas...</guimenuitem
></menuchoice
></term
>  
<listitem
><para
>Isto abrirá o diálogo de onde a configuração da barra de ferramentas pode ser mudada. O usuário pode escolher que botões de atalho devem aparecer na barra de ferramentas. Um quadro à esquerda lista os comandos disponíveis para serem colocados na barra de ferramentas. O quadro à direita lista os comandos que já estão na barra de ferramentas. Um conjunto de quatro botões de seta entre os dois quadros manipulam as seleções. A seta apontando para direita coloca qualquer comando selecionado no painel esquerdo para o painel direito, <abbrev
>isto é</abbrev
>, ele adiciona-o à barra de ferramentas. A seta esquerda faz simplesmente o oposto, removendo qualquer ação selecionada no quadro direito da barra de ferramentas. As setas apontando para cima e para baixo mudam a posição da ação selecionada no quadro direito mudando a posição deste 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
>Selecionar <menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Configurar Editor</guimenuitem
></menuchoice
> no menu levantará a caixa de diálogo <guilabel
>Configurar Editor</guilabel
>. Este diálogo pode ser usado para alterar diversas configurações diferentes. As configurações disponíveis para mudança variam de acordo com a categoria que o usuário escolhe a partir de uma lista vertical no lado esquerdo do diálogo. Por meio dos três botões ao longo da base da caixa o usuário pode controlar o processo. </para>

<para
>Ele pode invocar o sistema de <guilabel
>Ajuda</guilabel
>, aceitar as configurações atuais e fechar o diálogo através do botão <guibutton
>OK</guibutton
> ou <guibutton
>Cancelar</guibutton
>. As categorias <guilabel
>Cores</guilabel
>, <guilabel
>Fontes</guilabel
>, <guilabel
>Indentação</guilabel
>, <guilabel
>Seleção</guilabel
>, <guilabel
>Editar</guilabel
>, <guilabel
>Ortografia</guilabel
> e <guilabel
>Destaque</guilabel
> são detalhadas abaixo. </para>

<sect1 id="prefcolors">
<title
>Cores</title>
  
<para
>Esta seção fornece acesso à <link linkend="pref-color-settings"
>duas configurações diferentes de cores</link
>, descritas abaixo. Cada uma destas configurações pode ser mudada clicando em seu botão correspondente. Existem botões largos especias que são as cores da configuração atual. Clicar em um destes botões chama uma caixa de diálogo especial usada para mudar a configuração.</para
>  
  
<para
>A caixa de diálogo de cores fornece uma maneira gráfica e conveniente de selecionar uma cor. Na parte superior esquerda da caixa existe uma caixa retangular que exibe um espectro de cores. Imediatamente à direita dela, existe uma barra vertical exibindo um intervalo de intensidade do mais escuro na base ao mais claro no topo. O usuário pode selecionar e ajustar uma cor clicando nestas duas caixas. Clicar no mostrador retangular seleciona uma mistura particular das cores vermelho, verde e azul e na barra vertical seleciona o nível de intensidade (valor). Os vários atributos da cor são exibidos na forma numérica nas pequenas caixa de texto localizadas imediatamente abaixo do retângulo de espectro e o usuário pode vê-los mudar conforme a cor é ajustada. Estes atributos incluem a mistura dos componentes básicos da cor (vermelho, verde e azul) bem como os níveis de brilho e contraste. Alternativamente, o usuário pode inserir valores diretamente nestas caixas. Existe também um quadro no centro da base da caixa de diálogo que sempre exibe a cor que está em consideração. À direita deste mostrador está outra caixa de texto rotulada <guilabel
>HTML:</guilabel
>. Esta caixa mostra ao usuário o código de cor que deve ser usado para especificar a cor exibida em particular no código <acronym
>HTML</acronym
> que é usado por páginas da Web.</para
>  
  
<para
>Além do mencionado acima, o diálogo de cores permite capturar qualquer cor exibida atualmente na área de trabalho ou em outro programa. Clicar no botão com o ícone de conta-gotas (localizado à direita da caixa de diálogo) muda a forma do cursor do mouse para uma cruz. Clicar novamente obterá os atributos de cor de qualquer cor exibida sob a cruz.</para
>  
  
<para
>Posteriormente o usuário tem a opção de adicionar qualquer cor a sua paleta pessoal de <quote
>Cores Personalizadas</quote
> clicando no botão largo rotulado <guibutton
>Adicionar às Cores Personalizadas</guibutton
> (que está localizado diretamente abaixo do quadro mostrador.) Isto adiciona a cor atual à paleta de cores personalizadas. Esta paleta e qualquer outra paleta disponível pode ser exibida usando a caixa combinada de seleção localizada imediatamente abaixo do mostrador de paleta do canto direito superior da caixa de diálogo. Através das cores personalizadas, o usuário pode acessar um número de paletas pré-preparadas.</para>
  
<variablelist
>  
  
<varlistentry id="pref-color-settings"
>  
<term
><guilabel
>Fundo</guilabel
></term
>  
<listitem
><para
>Aqui o usuário pode especificar uma cor para o fundo em geral do &kwrite;.</para
></listitem
>   
</varlistentry
>  

<varlistentry
>  
<term
><guilabel
>Selecionado</guilabel
></term
>  
<listitem
><para
>Isto permite ao usuário selecionar uma cor para ser usada para indicar porções selecionadas (ou destacadas) do documento.</para
></listitem
> </varlistentry
>  
</variablelist
>  
</sect1
>  

<sect1 id="pref-fonts">
<title
>Fontes</title>

<para
>Aqui você pode escolher a fonte padrão para o &kwrite;. Você pode escolher a partir de qualquer fonte disponível no seu sistema, e configurar um tamanho padrão e codificação. Um texto exemplo é exibido na base do diálogo, de modo que você possa ver o efeito da sua escolha. </para>

</sect1>
  
<sect1 id="pref-indent"
>  
<title
>Indentação</title
>  
<variablelist
>  
  
<varlistentry
>  
<term
><guilabel
>Auto Indentar</guilabel
></term
> <listitem
><para
>Isto faz com que novas linhas iniciem com o mesmo nível de indentação da linha anterior.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Indentar Com Espaços</guilabel
></term
> <listitem
><para
>Isto substitui tabulações com o número de espaços selecionado na janela Largura da Tabulação na seção <link linkend="pref-edit"
>Editar</link
> do diálogo de configurações.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Tecla Backspace Indenta</guilabel
></term
>  
<listitem
><para
>Isto permite que a tecla <keycombo action="simul"
><keycap
>backspace</keycap
></keycombo
> seja usada para indentar.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Tecla Tab Indenta</guilabel
></term
> <listitem
><para
>Isto permite que a tecla <keycombo action="simul"
><keycap
>tab</keycap
></keycombo
> seja usada para indentar.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Manter Espaços Extra</guilabel
></term
>  
<listitem
><para
>Indentação com mais que o número selecionado de espaços não serão encurtadas.</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
>Quebra de Linha Estática</guilabel
></term
>  
<listitem
><para
>A quebra de palavra é um recurso que faz com que o editor automaticamente inicie uma nova linha de texto e mova (quebre) o cursor para o início da nova linha. O &kwrite; automaticamente iniciará uma nova linha de texto quando a linha atual atingir o comprimento especificado pela opção <link linkend="pref-wrap-words-at"
>Quebrar Linhas Em:</link
>.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="pref-wrap-words-at"
><guilabel
>Quebrar Linhas Em:</guilabel
></term
><listitem
><para
>Se a opção <link linkend="pref-word-wrap"
>Quebra de Linha</link
> estiver selecionada esta entrada determina o comprimento (em caracteres) no qual o editor automaticamente iniciará uma nova linha.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="pref-replace-tabs-by-spaces"
><guilabel
>Substituir Tabulações Por Espaços</guilabel
></term
> <listitem
><para
>O &kwrite; substituirá qualquer tabulação com o número de espaços indicados na entrada <link linkend="pref-tab-width"
>Largura da Tabulação:</link
>.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term id="pref-tab-width"
>Largura da Tabulação</term
> <listitem
><para
>Se a opção <link linkend="pref-word-wrap"
><guilabel
>Substituir Tabulações Por Espaços</guilabel
></link
> estiver selecionada esta entrada determinará o número de espaços que o editor usará para substituir automaticamente as tabulações.</para
></listitem
>  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Remover Espaços Excedentes</guilabel
></term
>  
<listitem
><para
>O &kwrite; automaticamente eliminará espaços extras no final das linhas de texto.</para
></listitem
> </varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Auto Colchetes</guilabel
></term
> <listitem
><para
>Quando o usuário digitar um colchete esquerdo ([, ( ou {) o &kwrite; irá inserir automaticamente o colchete 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
>Page Up/Down Move o Cursor</guilabel
></term>
<listitem
><para
>Esta opção muda o comportamento do cursor quando o usuário pressiona as teclas <keycap
>Page Up</keycap
> ou <keycap
>Page Down</keycap
>. Se desselecionado o cursor do texto se manterá na sua posição relativa dentro do texto visível no &kwrite; conforme novo texto se torna visível como resultado da operação. Logo se o cursor estiver no meio do texto visível quando a operação ocorre ele permanecerá lá (exceto quando é atingido o início ou fim do texto.) Com esta opção selecionada, o primeiro pressionamento de tecla faz com que o cursor se mova para cima ou para baixo do texto visível conforme uma nova pasta de texto é exibida. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>Quebrar Cursor</term
> 
<listitem
><para
>Quando esta opção está selecionada, mover o cursor com as teclas de seta para o final de uma linha (à direita) faz com que ele salte para baixo no início da próxima linha. Por outro lado quando o cursor é movido para além do início da linha (à esquerda) ele salta para o final da linha anterior. Quando esta opção não está habilitada, mover o cursor para além do final da linha faz com que ele simplesmente continue horizontalmente na mesma linha e tentar movê-lo para esquerda após o início da linha não faz nada.</para>
<para
>Quando esta opção está selecionada, clicar com o mouse além do final da linha de texto colocará o cursor de inserção <emphasis
>no final do texto</emphasis
>, e não no local que você clicou. Isto evita a adição acidental de espaços vazios no meio do texto, e é o comportamento padrão da maioria dos editores. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Passos de <link linkend="undo"
>desfazer</link
>:</term
> <listitem
><para
>Aqui o usuário pode especificar o número de passos que o &kwrite; manterá na memória para fim de desfazer entradas e ações. Isto significa que quanto maior o número de passos configurados mais memória o &kwrite; usará para isto. Configurar esta entrada para 10 significa que o usuário será capaz de reverter as últimas dez operações, <abbrev
>por exemplo</abbrev
> clicar o 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 desenvolvido para auxiliar o usuário a encontrar e corrigir erros de ortografia. Esta seção do diálogo de configurações permite algumas configurações importantes serem levadas em consideração.</para>
<variablelist>

<varlistentry>
<term
><guilabel
>Criar combinações de raiz/afixo não existentes no dicionário</guilabel
></term
> <listitem
><para
>Selecionar esta opção permite que o verificador ortográfico registre como 'correto' combinações de palavras razi com sufixos ou prefixos sempre que uma combinação em particular não estiver listada na base de dados de palavras do seu dicionário.</para
></listitem>

</varlistentry>

<varlistentry>
<term
><guilabel
>Considerar palavras justapostas como erros ortográficos</guilabel
></term
> <listitem
><para
>Selecionar isto faz com que o verificador ortográfico registre como 'desconhecido' duas ou mais palavras corretas ortograficamente que estão 'justapostas', <abbrev
>isto é</abbrev
>, que não possuam espaço separando-as.</para
></listitem>

</varlistentry>

<varlistentry>
<term
><guilabel
>Dicionário:</guilabel
></term
> <listitem
><para
>Dependendo da instalação do usuário um ou mais dicionários de diferentes idiomas podem estar disponíveis. Esta caixa combinada permite ao usuário escolher que idioma o verificador ortográfico deve usar.</para
></listitem>
  
</varlistentry
>  
  
<varlistentry
>  
<term
><guilabel
>Codificação:</guilabel
></term
> <listitem
><para
>Existem dos sistemas de codificação diferentes usados para associa códicos específicos à caracteres específicos e símbolos. Se o usuário conhece qual código ele está usando esta caixa combinada permite que este código seja especificado de modo que o verificador ortográfico possa fazer seu trabalho corretamente. </para
></listitem
> </varlistentry>

<varlistentry>
<term
><guilabel
>Cliente:</guilabel
></term
> <listitem
><para
>Uma vez que o &kwrite; não contém seu próprio verificador ortográfico, um externo deve ser escolhido. Aqui é onde o usuário pode especificar qual programa de verificação ortográfica 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
>Direitos Autorais do &kwrite; 2001 para a equipe do &kate;.</para>

<para
>Baseado no &kwrite; original, que possui Direitos Autorais 2000 para Jochen Wilhelmy <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 de &Thad.McGinnis; &Thad.McGinnis.mail; </para>

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

<para
>Convertido para docbook/proofreading por &Lauri.Watts; &Lauri.Watts.mail; </para>

<para
>Tradução de Marcus Gama<email
>marcus_gama@uol.com.br</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:  
-->  

