<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kwrite "<application>kwrite</application>">
]>
<book lang="pt">
<bookinfo>
<title>Manual do KWrite - Editor Avançado</title>
<authorgroup>
<author>
<firstname>Cristian</firstname>
<surname>Tibirna</surname>
<affiliation><address><email><ulink url="mailto:tibirna@kde.org">tibirna@kde.org</ulink></email></address></affiliation>
</author>
</authorgroup>
<date>Versão 0.1, 03-03-2000</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Este Manual descreve a versão 0.98 do KWrite</para>
<para>O Manual do KWrite</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>texto</keyword>
<keyword>editor</keyword>
</keywordset>
</bookinfo>

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

<para>O KWrite é um editor de texto incorporado no ambiente de trabalho KDE. Pode ser usado como um 
editor de programador em conjunto com o kfm para ver e editar 
ficheiros de código fonte de diversas linguagens. O KWrite também serve para 
compôr pequenos textos simples. O seu objectivo é ser um editor 
de programadores, e pode ser considerado como uma alternativa 
parcial dos editores mais poderosos como XEmacs ou Emacs. As linguagens 
suportadas pelo KWrite são: C/C++, Java, Python, Perl, Bash, Modula 2,
HTML, Ada.</para>

<sect1 id="whatsnew">
<title>Novo</title>

<para><itemizedlist>
<listitem>
<para>Suporte para Python e Perl</para>
</listitem>
<listitem>
<para> muitas, muitas mais coisas</para>
</listitem>
</itemizedlist>
</para>

<para>Espero que este editor te agrade,</para>

<para><literal remap="tt">Jochen Wilhelmy</literal></para>

<para><ulink url="mailto:digisnap@cs.tu-berlin.de">digisnap@cs.tu-berlin.de</ulink></para>
</sect1>
</chapter>

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

<sect1 id="howtoobtainkwrite">
<title>Como obter o KWrite</title>

<para>O KWrite faz parte de um conjunto de aplicações do projecto KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>. 
O KWrite pode ser encontrado em <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, que é o site ftp 
do projecto KDE.</para>
</sect1>

<sect1 id="requirements">
<title>Requisitos</title>

<para>Para que o KWrite seja compilado com sucesso, vais necessitar das últimas versões de <literal remap="tt"> libkdecore</literal> 
e <literal remap="tt"> libkfm</literal>. Todas as bibliotecas necessárias, tal como o KWrite, podem ser encontradas 
em <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>. </para>
</sect1>

<sect1 id="compilationandinstallation">
<title>Compilação e Instalação</title>

<para>Para compilar e instalar o KWrite no teu sistema, segue os seguintes passos no directório 
base em que se encontra o KWrite:
<screen>% ./configure
% make
% make install
</screen>
</para>

<para>Visto que o KWrite usa o <literal remap="tt">autoconf</literal> não deves ter nenhum problema a compilá-lo. 
Mas, se tiveres, por favor relata-o para a mailing list do <emphasis remap="sf">KDE</emphasis>.</para>
</sect1>
</chapter>

<chapter id="onscreenfundamentals">
<title>Noções Genéricas</title>

<para>O KWrite é muito fácil de usar. Tenho a certeza que se já usaste um editor de texto 
não terás nenhum problema a usar o KWrite.</para>

<sect1 id="draganddrop">
<title>Arraster e Largar</title>

<para> KWrite usa o protocolo de Arrastar e Largar do KDE. Isto significa que podes arrastar 
e largar um ficheiro do Ambiente de Trabalho ou do kfm (dos teus directórios e até ficheiros de sites) 
para o KWrite e ele será aberto automaticamente.</para>
</sect1>

<sect1 id="editingfilesontheinternet">
<title>Editando Ficheiros na Internet</title>

<para>Podes abrir e gravar ficheiros da Internet. Tenta o seguinte comando 
num terminal para veres um exemplo disto:</para>

<para><screen>% kwrite ftp://ftp.kde.org/pub/kde/Welcome.msg
</screen>
</para>
</sect1>

<sect1 id="printing">
<title>Imprimindo</title>

<para>A característica de impressão ainda não foi implementada no KWrite.</para>
</sect1>

<sect1 id="keybindings">
<title>Atalhos do Teclado</title>

<para>O KWrite tem o orgulho de apresentar os seguintes atalhos pelo teclado:</para>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">Insert</literal> Troca entre o modo Inserir (INS) e o Substituir (OVR) </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Cursor da Esquerda</literal> Move o cursor um caracter para a esquerda </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Cursor da Direita</literal> Move o cursor um caracter para a direita </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Cursor de Cima</literal> Move o cursor para a linha de cima </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Cursor de Baixo</literal> Move o cursor para a linha de baixo </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Page Up</literal> Move o cursor uma página para cima </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Page Down</literal> Move o cursor uma página para baixo </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Backspace</literal> Apaga o caracter à esquerda do cursor </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Home</literal> Move o cursor para o início da linha </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">End</literal> Move o cursor para o fim da linha </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Delete</literal> Apaga o caracter à direita do cursor </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Shift-Cursor da Esquerda</literal> Marca o texto um caracter para a esquerda </para> 
</listitem> 
<listitem> 
<para><literal remap="tt">Shift-Cursor da Direita</literal> Marca o texto um caracter para a direita </para>
</listitem>
<listitem>
<para><literal remap="tt">Alt-S</literal> Configura favoritos</para>
</listitem>
<listitem>
<para><literal remap="tt">Alt-C</literal> Apaga favorito</para>
</listitem>
<listitem>
<para><literal remap="tt">F1</literal> Ajuda</para>
</listitem>
<listitem>
<para><literal remap="tt">F3</literal> Procura novamente</para>
</listitem>
<listitem>
<para><literal remap="tt">F5</literal> Selecção vertical</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-F</literal> Procura</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-C</literal> Copia o texto marcado para a área de transferência</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-F</literal> Procura</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-G</literal> Salta para determinada linha</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-I</literal> Indenta</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-K</literal> Apaga a linha</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-N</literal> Novo documento (o que estiver a ser editado será gravado) </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-R</literal> Substitui</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-U</literal> Des-Indenta</para>
</listitem>
<listitem>
<para><literal remap="tt">Control-V</literal> Cola o texto da área de transferência para a linha que está a ser editada </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-X</literal> Corta o texto marcado e copia-o para a área de transferência </para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="themenuentries">
<title>As Entradas dos Menus</title>

<sect1 id="file">
<title>Ficheiro</title>

<sect2 id="new">
<title>Novo</title>

<para>Cria um novo documento no editor</para>
</sect2>

<sect2 id="open">
<title>Abrir</title>

<para>Permite ao utilizador abrir um documento</para>
</sect2>

<sect2 id="insert">
<title>Inserir</title>

<para>Permite ao utilizador inserir um novo documento no documento editado</para>
</sect2>

<sect2 id="openrecent">
<title>Abrir Recente</title>

<para>Uma lista dos documentos abertos anteriormente</para>
</sect2>

<sect2 id="save">
<title>Gravar</title>

<para>Grava o documento actual</para>
</sect2>

<sect2 id="saveas">
<title>Gravar como</title>

<para>Permite ao utilizador gravar o documento num novo ficheiro</para>
</sect2>

<sect2 id="close">
<title>Fechar</title>

<para>Fecha a janela do editor. Se a janela fechada for a única aberta, 
o KWrite sairá</para>
</sect2>

<sect2 id="newwindow">
<title>Nova Janela</title>

<para>Cria uma nova janela</para>
</sect2>

<sect2 id="newview">
<title>Nova Vista</title>

<para>Cria uma nova vista do mesmo documento</para>
</sect2>
</sect1>

<sect1 id="edit">
<title>Editar</title>

<sect2 id="copy">
<title>Copiar</title>

<para>Copia a selecção actual para a área de transferência</para>
</sect2>

<sect2 id="cut">
<title>Cortar</title>

<para>Apaga a selecção actual e coloca-a na área de transferência</para>
</sect2>

<sect2 id="paste">
<title>Colar</title>

<para>Insere o conteúdo da área de transferência para a posição actual do cursor</para>
</sect2>

<sect2 id="find">
<title>Procurar</title>

<para>Abre o diálogo de procura</para>
</sect2>

<sect2 id="replace">
<title>Substituir</title>

<para>Abre o diálogo de substituir</para>
</sect2>

<sect2 id="findagain">
<title>Procurar Novamente</title>

<para>Repete a última operação de procura, se alguma tiver sido efectuada</para>
</sect2>

<sect2 id="gotoline">
<title>Ir para Linha</title>

<para>Abre o diálogo de ir para uma linha</para>
</sect2>

<sect2 id="undo">
<title>Desfazer</title>

<para>Anula a última operação</para>
</sect2>

<sect2 id="redo">
<title>Refazer</title>

<para>Refaz a última operação desfeita</para>
</sect2>

<sect2 id="indent">
<title>Indentar</title>

<para>Aumenta a indentação do parágrafo</para>
</sect2>

<sect2 id="unindent">
<title>Des-Indentar</title>

<para>Reduz a indentação do parágrafo</para>
</sect2>

<sect2 id="selectall">
<title>Seleccionar Tudo</title>

<para>Selecciona todo o buffer</para>
</sect2>

<sect2 id="unselectall">
<title>Des-Selecionar Tudo</title>

<para>Anula a selecção</para>
</sect2>

<sect2 id="inverttheselection">
<title>Inverter a Selecção</title>

<para>Selecciona o texto não marcado e anula a selecção anterior</para>
</sect2>
</sect1>

<sect1 id="bookmarks">
<title>Favoritos</title>

<para></para>

</sect1>

<sect1 id="options">
<title>Opções</title>

<sect2 id="sethighlight">
<title>Pôr Coloração</title>

<para>Permite ao utilizador escolher o tipo de cor que o editor vai usar para mostrar diferentes tipos de texto de acordo com a linguagem de programação. 
A informação da fonte/cor não é armazenada com o documento </para>
</sect2>

<sect2 id="defaults">
<title>Valores por Omissão</title>

<para>Permite ao utilizador configurar e gravar um grupo de configurações por omissão: fonte, cor de frente/fundo, para cada tipo de definição de coloração</para>
</sect2>

<sect2 id="highlight">
<title>Coloração</title>

<para>Permite ao utilizador configurar em detalhe a maneira como a coloração trabalha (juntamente com os tipos mime, para cada definição de coloração)</para>
</sect2>

<sect2 id="colors">
<title>Cores</title>

<para>Permite ao utilizador seleccionar a cor do fundo e do texto da janela do KWrite</para>
</sect2>

<sect2 id="verticalselection">
<title>Selecção Vertical</title>

<para>Liga/desliga a característica de selecção vertical</para>
</sect2>

<sect2 id="showtoolbar">
<title>Mostrar barra de ferramentas</title>

<para></para>

</sect2>

<sect2 id="showstatusbar">
<title>Mostrar barra de estado</title>

<para></para>

</sect2>

<sect2 id="saveconfig">
<title>Gravar Configuração</title>

<para>Grava as configurações modificadas</para>
</sect2>
</sect1>

<sect1 id="help">
<title>Ajuda</title>

<sect2 id="contents">
<title>Conteúdo</title>

<para>Invoca a ajuda do KWrite</para>
</sect2>

<sect2 id="aboutkwrite">
<title>Acerca do kwrite...</title>

<para>Mostra informação essencial sobre o KWrite.</para>
</sect2>

<sect2 id="aboutkde">
<title>Acerca do KDE...</title>

<para>Mostra informação essencial sobre o KDE</para>
</sect2>
</sect1>
</chapter>

<chapter id="questionsandanswers">
<title>Perguntas e Respostas</title>

<para>Ainda não houve perguntas ;-)</para>

<para>
Tradução da documentação por Ricardo Cruz <email>rick2@ricjoa.fe.up.pt</email>
</para>

</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
<!-- actualizado para a versão CVS :1.1: --> 
