<chapter id="fundamentals">
<title
>Os Fundamentos</title>

<para
> Se alguma vez utilizaste um editor de texto não terás problemas a usar o &kate;. Nas duas próximas secções, em <link linkend="starting-kate"
>Iniciar o &kate; </link
> e em <link linkend="working-with-kate"
>Trabalhar com o &kate;</link
> mostrar-te-emos tudo o que precisas para interagires com ele. </para>

<sect1 id="starting-kate">
<title
>Iniciar o &kate;</title>

<para
> Podes iniciar o &kate; no <guimenu
>menu K</guimenu
> ou na linha de comandos. </para>

<sect2 id="starting-from-the-menu">
<title
>Do Menu</title>
<para
> Abre o menu de programas do &kde; carregando no <guiicon
>K grande</guiicon
> na barra de ferramentas no canto inferior esquerdo do teu ecrã (normalmente). Isto fará aparecer o <guimenu
>menu de programas</guimenu
>. Move o teu cursor para o menu até ao item <guimenu
>Editores</guimenu
>. Aparecerá uma lista com os editores disponíveis, na qual poderás escolher o <guimenuitem
>&kate;</guimenuitem
>. </para>

<para
> A menos que tenhas configurado o &kate; para não o fazer, ele irá abrir os últimos ficheiros que editaste. Vê em <link linkend="configure"
>Configurar o &kate;</link
> para aprenderes como ligares e desligares esta opção. </para>

</sect2>

<sect2 id="starting-from-the-command-line">
<title
>Da Linha de Comandos</title>

<para
> Podes iniciar o &kate; escrevendo o seu nome na linha de comandos. Se lhe deres um nome de ficheiro, como no exemplo abaixo, ele irá abrir ou criar esse ficheiro. </para>

<informalexample
> <screen>
<prompt
>%</prompt
><userinput
><command
>kate</command
> <option
><replaceable
>ficheiro.txt</replaceable
></option
></userinput>
</screen
> </informalexample>

<para
> Se tiveres uma ligação activa e permissões para tal, podes tirar partido da transparência de rede do &kde; para abrir ficheiros na Internet. </para>

<informalexample
> <screen>
<prompt
>%</prompt
><userinput
><command
>kate</command
> <option
><replaceable
>ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable
></option
></userinput>
</screen
> </informalexample>

<sect3 id="command-line-options">
<title
>Opções da Linha de Comandos</title>
<para
>O &kate; aceita as seguintes opções na linha de comandos:</para>

<variablelist
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--help</option
></userinput
></term
> <listitem
> <para
> Isto lista as opções mais básicas que estão disponíveis na linha de comandos. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--help-qt</option
></userinput
></term
> <listitem
> <para
> Isto lista as opções disponíveis para mudar a forma como o &kate; interage com o &Qt;. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--help-kde</option
></userinput
></term
> <listitem
> <para
> Isto lista as opções disponíveis para alterar a forma como o &kate; interage com o &kde;. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--help-all</option
></userinput
></term
> <listitem
> <para
> Isto lista todas as opções da linha de comandos. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--author</option
></userinput
></term
> <listitem
> <para
> Lista os autores do &kate; na janela do terminal. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--version</option
></userinput
></term
> <listitem
> <para
> Lista a informação de versão do &Qt;, do &kde; e do &kate;. Também está disponível como <userinput
><command
>kate</command
> <option
>-V</option
></userinput
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><userinput
><command
>kate</command
> <option
>--license</option
></userinput
></term
> <listitem
> <para
> Mostra informações sobre a licença. </para
> </listitem
> </varlistentry
> </variablelist>
</sect3>
</sect2>

<sect2 id="drag-and-drop">
<title
>Arrastar e Largar</title>
<para
> O &kate; utiliza o protocolo 'Drag and Drop' do &kde;. Os ficheiros podem ser arrastados e largados no &kate; a partir do ecrã, do &konqueror; ou de algum 'site' FTP remoto aberto numa das janelas do &konqueror;. </para>
</sect2>
</sect1>

<sect1 id="working-with-kate">
<title
>Trabalhar com o &kate;</title>
<para
> O <link linkend="quick-start"
>Arranque Rápido</link
> mostrar-te-á como alternares quatro opções simples que te permitirão configurar algumas das funcionalidades mais poderosas do &kate; num instante. Os <link linkend="keystroke-commands"
>Comandos do Teclado</link
> fornece alguns atalhos de teclado para aqueles que não podem ou não querem usar um rato. </para>

<sect2 id="quick-start">
<title
>Arranque Rápido</title>

<para
> Esta secção irá descrever alguns dos itens no menu <guimenu
>Configuração</guimenu
> de modo a que possas configurar o &kate; como for da tua vontade. </para>

<para
> Quando arrancas o &kate; pela primeira vez verás duas janelas com o fundo branco. Por cima das duas janelas existe uma barra de ferramentas com os ícones normais. Por cima desta, está a barra do menu. </para>

<para
> A janela da esquerda é uma barra lateral acoplável. Combina as janelas de lista e selecção dos ficheiros. Alterna entre as duas carregando nos selectores de secção no topo da janela. </para>

<para
> Se invocaste o &kate; com um ficheiro, a janela da direita irá mostrar o ficheiro que estás a editar e a lista na barra lateral irá mostrar o nome do ficheiro. Usa a janela de selecção dos ficheiros para os abrir. </para>

<para
> Podes ligar e desligar a janela da lista e de selecção de ficheiro no menu <guimenu
>Configuração</guimenu
>. Este menu dá-te uma ideia inicial do poder e flexibilidade do &kate;. Nesta secção iremos ver quatro itens: </para>

<variablelist
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Mostrar a Barra de Ferramentas</guimenuitem
></menuchoice
></term
> <listitem
> <para
> Liga e desliga a barra de ferramentas. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenuitem
>Mostrar Lista de Ficheiros</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Liga e desliga a lista de ficheiros. Se a janela da lista e selecção de ficheiros não estiver aberta, o &kate; lança a barra lateral como uma janela separada e não acoplada. Para acoplares a janela agarra nas duas linhas finas paralelas por cima dos selectores de secção carregando nelas com o botão esquerdo do rato e mantendo o botão carregado. Arrasta a janela para a área de edição do &kate; e larga o botão esquerdo quando tiveres posicionado a janela no teu local preferido. </para
> <tip
> <para
> Se seleccionaste efectivamente as duas linhas paralelas o teu cursor do rato irá mudar para duas setas cruzadas à medida que arrastas. </para
> </tip
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Mostrar Selector de Ficheiros</guimenuitem
></menuchoice
></term
> <listitem
> <para
> Liga e desliga a janela de selecção de ficheiros. Este item do menu é o mesmo que o <guimenuitem
>Mostrar Lista dos Ficheiros</guimenuitem
> mas com uma diferença. Ao activá-la, aparece a janela com o selector de ficheiros seleccionado. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenuitem
>Mostrar a Consola</guimenuitem
></menuchoice
></term
> <listitem
> <para
> Activa e desactiva um emulador de consola na parte inferior da janela do &kate;. Por outras palavras, fornece-te uma linha de comandos dentro da aplicação. </para
> </listitem
> </varlistentry
> </variablelist>
</sect2>

<sect2 id="keystroke-commands">
<title
>Comandos do Teclado</title>

<para
> Muitos dos comandos de teclado do &kate; (atalhos) são configuráveis através do menu <link linkend="settings"
>Configuração</link
>. Por omissão o &kate; respeita a seguinte configuração de teclas. </para>

<informaltable>
<tgroup cols="2">
<tbody
> <row
><entry
><para
><keycap
>Insert</keycap
></para
></entry
> <entry
><para
> Alterna entre o modo de Inserção e Sobreposição. Quando está no modo de inserção, o editor irá adicionar os caracteres introduzidos ao texto e empurrar os dados introduzidos anteriormente à direita do cursor do texto. O modo de sobreposição fará com que a introdução de cada carácter elimine o carácter imediatamente à direita do cursor.</para
></entry
> </row
> <row
> <entry
><para
><keycombo
><keycap
>Esquerda</keycap
></keycombo
></para
></entry
> <entry
><para
>Move o cursor um carácter para a esquerda </para
></entry
> </row
> <row
> <entry
><para
><keycombo
><keycap
>Direita</keycap
></keycombo
></para
></entry
> <entry
><para
> Move o cursor um carácter para a direita </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Cima</keycap
></keycombo
></para
></entry
> <entry
><para
> Sobe o cursor uma linha </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Baixo</keycap
></keycombo
></para
></entry
> <entry
><para
> Desce o cursor uma linha </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Page Up</keycap
></keycombo
></para
></entry
> <entry
><para
> Move o cursor uma página para cima </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Page Down</keycap
></keycombo
></para
></entry
> <entry
><para
>Move o cursor uma página para baixo </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Backspace</keycap
></keycombo
></para
></entry
> <entry
><para
> Apaga o carácter à esquerda do cursor </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Home</keycap
></keycombo
></para
></entry
> <entry
><para
> Move o cursor para o início da linha </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>End</keycap
></keycombo
></para
></entry
> <entry
><para
> Move o cursor para o fim da linha </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>Delete</keycap
></keycombo
></para
></entry
> <entry
><para
>Apaga o carácter à direita do cursor (ou qualquer texto seleccionado)</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Shift;<keycap
>Esquerda</keycap
></keycombo
></para
></entry
> <entry
><para
> Marca o texto que está um carácter à esquerda </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Shift;<keycap
>Direita</keycap
></keycombo
></para
></entry
> <entry
><para
> Marca o texto que está um carácter à direita </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>F1</keycap
></keycombo
></para
></entry
> <entry
><para
> Ajuda</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="whats-this"
>O que é isto?</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>F1</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="find"
> Procurar</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
><keycap
>F3</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="find-again"
> Procurar seguinte</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
></para
></entry
> <entry
><para
>Marca um Favorito</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
></para
></entry
> <entry
><para
> Copia o texto seleccionado para a área de transferência. </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></para
></entry
> <entry
><para
> Cria um <link linkend="new"
>Novo</link
> documento</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="print"
>Imprimir</link
> </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></para
></entry
> <entry
><para
>Sair - fecha a cópia activa do editor </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="replace"
> Substituir</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
></para
></entry
> <entry
><para
>Grava o teu ficheiro.</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>V</keycap
></keycombo
></para
></entry
> <entry
><para
> Colar.</para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>X</keycap
></keycombo
></para
></entry
> <entry
><para
>Apaga o texto seleccionado e copia-o para a área de transferência. </para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="undo"
>Desfazer</link
></para
></entry
> </row
> <row
> <entry
><para
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></para
></entry
> <entry
><para
><link linkend="redo"
>Refazer</link
></para
></entry
> </row
> </tbody>
</tgroup>
</informaltable>
</sect2>

</sect1>

<sect1 id="fundamentals-getting-help">

<title
>Obter Ajuda</title>

<sect2>

<title
>Com o &kate;</title>
<variablelist
> <varlistentry
> <term
>Este manual</term
> <listitem
> <para
>Oferece uma documentação detalhada sobre todos os comandos do menu, opções de configuração, ferramentas, janelas, 'plugins' &etc;, bem como descrições da janela do &kate;, do editor e vários conceitos usados na aplicação.</para
> <para
>Carrega em <keycap
>F1</keycap
> ou usa o tópico do menu <menuchoice
><guimenu
>Ajuda</guimenu
></menuchoice
> <guisubmenu
>Conteúdo</guisubmenu
> para veres este manual.</para
></listitem
> </varlistentry
> <varlistentry id="whats-this"
> <term
>A ajuda O que é Isto?</term
> <listitem
> <para
>A ajuda O Que É Isto? oferece uma ajuda imediata com os elementos simples das janelas, como os botões ou as outras áreas da janela.</para
> <para
>Nós tentamos providenciar ajudas O Que É Isto? para todos os elementos nos quais faça sentido. Está disponível por toda a janela de configuração, bem como em muitas outras janelas.</para
> <para
>Para usares a ajuda O Que É Isto?, carrega em <keycombo
>&Shift;<keycap
>F1</keycap
></keycombo
> ou usa a opção do menu <menuchoice
><guimenu
>Ajuda</guimenu
><guimenuitem
>O Que É Isto?</guimenuitem
></menuchoice
> para activares o modo de ajuda rápida. O cursor irá mudar para uma seta com um ponto de interrogação, para que possas carregar em qualquer elemento da janela para leres a sua ajuda respectiva, se estiver disponível.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Botões de Ajuda nas Janelas</term
> <listitem
> <para
>Algumas janelas têm um botão de <guibutton
>Ajuda</guibutton
>. Se carregares nele irás iniciar o &khelpcenter; e abrir a documentação relevante.</para
> </listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2>
<title
>Com os Teus Ficheiros de Texto</title>

<para
>O &kate; não possibilita (ainda!) nenhum meio para ler a documentação relacionada com o documento. Dependendo do ficheiro que estás a editar, podes achar o <link linkend="kate-mdi-tools-konsole"
>&konsole; Embutido</link
> útil para veres a documentação das páginas 'man' e 'info' ou podes mesmo usar o &konqueror;.</para>

</sect2>

</sect1>

</chapter>

