<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kedit "<application>kedit</application>">
]>
<book lang="pt">
<bookinfo>
<title>Manual do KEdit - Mini Editor</title>
<authorgroup>
<author>
<firstname>Bernd Johannes</firstname>
<surname>Wuebben</surname>
<affiliation><address><email><ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></email></address></affiliation>
</author>
</authorgroup>
<date>Versão 0.7.3, 09-03-2000</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Este Manual descreve a versão 0.7 do KEdit</para>
<para>O Manual do KEdit</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KEdit</keyword>
<keyword>editor de texto</keyword>
</keywordset>
</bookinfo>

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

<para>O KEdit é o editor de texto por omissão do ambiente de trabalho KDE. É um pequeno editor apropriado a ser usado
em conjunto com o kfm para ler ficheiros de texto. O KEdit serve também
para processar pequenos textos simples. Não foi feito para ser um editor
para programadores, e principalmente NÃO foi feito para substituir outros dos editores 
poderosos como XEmacs ou Emacs. As funcionalidades do KEdit são limitadas de propósito
para que possa ser rápido e obter bons resultados.</para>

<sect1 id="new">
<title>Novo</title>
<para><itemizedlist> 
<listitem> 
<para>O "word-wrap" agora funciona (espero ;-) )</para> 
</listitem> 
<listitem> 
<para>O "kill-ring", como no Emacs, foi implementado com as teclas Ctrl-k e Ctrl-y</para> 
</listitem> 
<listitem> 
<para>Formatação de Parágrafos com Ctrl-j. Usa isto em conjunto com a 
Auto-Indentação e esta característica ficará bastante poderosa.</para> 
</listitem> 
</itemizedlist> 
</para> 

<para>Espero que gostes deste editor,</para>

<para><literal remap="tt">Bernd Johannes Wuebben</literal></para>

<para><ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></para>
</sect1>
</chapter>

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

<sect1 id="howtoobtainkedit">
<title>Como obter o KEdit</title>

<para>O KEdit faz parte de um conjunto de aplicações do projecto KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>.
O KEdit 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 KEdit 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 KEdit, 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 KEdit no teu sistema, segue os seguintes passos do directório 
base em que se encontra o KEdit:
<screen>% ./configure
% make
% make install
</screen>
</para>

<para>Visto que o KEdit usa o <literal remap="tt">autoconf</literal> não deves ter nenhum problema a compilá-lo.
Se tiveres algum problema, por favor, reporta-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 KEdit é 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 KEdit. </para>

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

<para>O KEdit 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 KEdit 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>% kedit ftp://ftp.kde.org/pub/kde/Welcome.msg
</screen>
</para>
</sect1>

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

<para>O KEdit suporta a impressão de textos. Podes imprimir textos que estás a editar, ou
apenas um selecção, imprimindo directamente para a tua impressora de omissão. Opcionalmente podes
especificar um comando de impressão. Existe um grande número de 
utilitários no mundo Unix que são excelentes. Fazia
sentido tentar implementá-los. Deixa-me falar-te especialmente de 
dois utilitários de impressão.</para>

<para><variablelist>
<varlistentry>
<term>Enscript da GNU</term>
<listitem>
<para>Markku Rossi escreveu esta poderosa reencarnação 
do Adobe enscript - conversor de ascii para postscript. Eu uso-o assim: 
enscript -2rG texto.txt, mas o enscript da GNU vai muito para além disso. Certifica-te 
que tens a última versão. Obtem-no em: <ulink url="http://www.hut.fi/~mtr/genscript/">http://www.hut.fi/~mtr/genscript/</ulink>, ou noutro mirrror da GNU.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>a2ps</term>
<listitem>
<para>Akim Demaille e Miguel Santana escreveram este poderoso 
utilitário conversor 
de ascii para Postscript que imprime o documento de acordo
com a sua extensão. Os seu estilos por omissão são muito giros. Obtem-no 
em:
<ulink url="http://www-inf.enst.fr/~demaille/a2ps.html">http://www-inf.enst.fr/~demaille/a2ps.html</ulink></para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>Os dois utilitários acima descritos são absolutamente recomendados. Se não os tens,
obtêm-nos e aprende a lidar com eles. Aprender a usá-los já não é
nenhum problema graças ao visualizador html/texinfo/man 
<literal remap="tt">kdehelp</literal>. Estes utilitários são teus amigos no que respeita a impressão 
no mundo UNIX. Devido ao seu poder e às suas várias opções assim que aprenderes a lidar com eles, 
vais adorá-los e agradecer o facto de eles estarem disponíveis 
para ti, até no Windows.</para>

<para>Certifica-te que o teu sistema está preparado para impressão de documentos PostScript. Se não tiveres
uma impressora nativa de PostScript (quem tem?) obtem
a versão 4.03 ou superior do ghostscript/ghostview de
<ulink url="http://www.cs.wisc.edu/%7Eghost/">http://www.cs.wisc.edu/%7Eghost/</ulink>. Nota que agora há
fontes comerciais ps disponíveis que vêm com o pacote ghostview/ghostscript. 
Estas fontes são necessárias para qualquer qualidade na impressão de documentos Postscript 
numa impressora não-postscript. Se estiveres desapontado pelos resultados 
do ghostscript na tua impressora - obtem as novas fontes, elas
dão a possibilidade de melhores resultados. </para>
</sect1>

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

<para>O KEdit 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 uma linha para cima </para>
</listitem>
<listitem>
<para><literal remap="tt">Cursor de Baixo</literal> Move o cursor uma linha para 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">Control-A</literal> Move o cursor para o início da linha </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-B</literal> Move o cursor um caracter para a esquerda </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-D</literal> Apaga o caracter à direita do cursor </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-E</literal> Move o cursor para o fim da linha </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-F</literal> Move o cursor um caracter para a direita </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-H</literal> Apaga o caracter à esquerda do cursor </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-J</literal> Formata o Parágrafo </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-K</literal> Apaga até ao fim da linha e coloca o conteúdo no kill-buffer </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-N</literal> Move o cursor para a linha de baixo </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-P</literal> Move o cursor para a linha de cima </para>
</listitem>
<listitem>
<para><literal remap="tt">Control-V</literal> Cola o texto da área de transferência na linha do cursor </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>
<listitem>
<para><literal remap="tt">Control-Y</literal> Despeja o conteúdo do kill-buffer no documento na posição
do cursor.</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

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

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

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

<para>Abre um novo documento no editor.</para>
</sect2>

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

<para>Permite que o utilizador abra um documento.</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 actual num novo ficheiro.</para>
</sect2>

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

<para>Fecha a janela do editor. Se esta for a única janela do editor aberta,
o KEdit vai terminar.</para>
</sect2>

<sect2 id="openurl">
<title>Abrir URL</title>

<para>Permite ao utilizador abrir um ficheiro na internet.</para>
</sect2>

<sect2 id="savetourl">
<title>Gravar para URL</title>

<para>Permite ao utilizador gravar para um ficheiro na internet.</para>
</sect2>

<sect2 id="print">
<title>Imprimir</title>

<para>Abre o diálogo de impressão e deixa o utilizador imprimir todo o documento ou só uma parte seleccionada.</para>
</sect2>

<sect2 id="mail">
<title>Correio</title>

<para>Abre o diálogo de mandar documentos por correio electrónico. Preenche-o e, se necessário, modifica o
comando de mail no menu 'Opções' na parte 'Opções do Editor'.</para>
</sect2>

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

<para>Abrir um nova janela do editor</para>

</sect2>

<sect2 id="exit">
<title>Sair</title>

<para>Sair do KEdit.</para>

</sect2>
</sect1>

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

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

<para>Copia o texto marcado para a área de transferência.</para>
</sect2>

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

<para>Apaga o texto marcado e põem-no na área de transferência.</para>
</sect2>

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

<para>Insere o texto da área de transferência na posição do cursor.</para>
</sect2>

<sect2 id="insertfile">
<title>Inserir Ficheiro</title>

<para>Permite ao utilizador inserir um ficheiro na posição do cursor.</para>
</sect2>

<sect2 id="insertdate">
<title>Inserir Data</title>

<para>Insere a data actual na posição do cursor.</para>
</sect2>

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

<para>Abre o diálogo de procurar palavras.</para>
</sect2>

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

<para>Repete a última operação de procurar, se alguma operação já tiver sido iniciada.</para>
</sect2>

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

<para>Abre o diálogo de substituição de palavras.</para>
</sect2>

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

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

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

<sect2 id="font">
<title>Fonte</title>

<para>Permite ao utilizador escolher a fonte que o editor vai utilizar para mostrar o texto.
A informação sobre a fonte não é gravada no documento, não podes escolher diferentes 
fontes para diferentes documentos. </para>
</sect2>

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

<para>Permite ao utilizador escolher a cor de fundo e o texto mostrado pelo KEdit.</para>
</sect2>

<sect2 id="miscoptions">
<title>Opções do Editor</title>

<para>Permite ao utilizador escolher o número da coluna onde as linhas vão ser quebradas e configurar o comando de mandar
correios electrónicos a partir do KEdit.</para>
</sect2>

<sect2 id="autoindent">
<title>Auto-Indentação</title>

<para>Permite ao utilizador activar ou não o modo de auto-indentação. Na auto-indentação o 
cursor é colocado automaticamente ao encontrar RETURN ou ENTER 
na linha seguinte.</para>
</sect2>

<sect2 id="hideshowtool-bar">
<title>Mostrar/Esconder a Barra de Ferramentas</title>

<para>Permite ao utilizador ter a barra de ferramentas visível ou escondida.</para>
</sect2>

<sect2 id="hideshowstatus-bar">
<title>Esconder/Mostrar a Barra de Estado</title>

<para>Permite ao utilizador ter a barra de estado visível ou escondida.</para>
</sect2>
</sect1>

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

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

<para>Invoca o KDE help na página de ajuda do KEdit, agora disponível em Português.</para>
</sect2>

<sect2 id="about">
<title>Acerca do kedit...</title>

<para>Mostra a informação essencial sobre o KEdit.</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: --> 
