<para>Se alguma vez utilizou um editor de texto, não terá 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-lhe-emos tudo o que precisa para interagir com ele. </para>
<para>Abra o menu de programas do &kde; carregando no <guiicon>K grande</guiicon> na barra de ferramentas no canto inferior esquerdo do seu ecrã (normalmente). Isto fará aparecer o <guimenu>menu de programas</guimenu>. Mova o seu cursor para o menu até ao item <menuchoice><guimenu>Utilitários</guimenu> <guimenuitem>Editores</guimenuitem></menuchoice>. Aparecerá uma lista com os editores disponíveis, na qual poderá escolher o <guimenuitem>&kate;</guimenuitem>. </para>
<para>A menos que tenha configurado o &kate; para não o fazer, ele irá abrir os últimos ficheiros que você editou. Veja em <link linkend="configure">Configurar o &kate;</link> para aprender como ligar e desligar esta opção. </para>
<para>Poderá iniciar o &kate;, escrevendo o seu nome na linha de comandos. Se lhe der um nome de ficheiro, como no exemplo abaixo, ele irá abrir ou criar esse ficheiro. </para>
<para>Se tiver uma ligação activa e permissões para tal, poderá tirar partido da transparência de rede do &kde; para abrir ficheiros na Internet. </para>
<para>Inicia o 'kate' com a sessão <parameter>nome</parameter>. A sessão é criada se não existir já. Se existir uma instância do &kate; que esteja a correr a sessão indicada, os ficheiros indicados são carregados nessa instância. Quando for usado com a opção <option>--use</option>, será também usada uma instância que esteja a correr esta sessão. </para>
<para>Faz com que o &kate; use uma instância existente, se já existir alguma. Se quiser que todos os documentos abram numa instância do Kate, poderá adicionar esta opção no comando predefinido, na configuração da sua aplicação do KDE, assim como criar um comando alternativo no seu interpretador de comandos, se suportar isso. </para>
<listitem><para>Lê o conteúdo do documento a partir do STDIN. Isto é semelhante à opção comum <option>-</option>, que é usada por muitos programas da linha de comandos e lhe permite encaminhar o resultado do comando para o &kate;.</para></listitem>
<listitem><para>Desde o &kate; 2.5.1 que esta opção normal do &kde; é usada. Quando for usada, os ficheiros indicados são tratados como ficheiros temporários e removidos a seguir (se forem ficheiros locais e se tiver permissões suficientes) a ser fechados, a menos que tenham sido modificados desde a sua abertura.</para></listitem>
<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 servidor de FTP remoto aberto numa das janelas do &konqueror;. </para>
<para>O <link linkend="quick-start">Arranque Rápido</link> mostrar-lhe-á como comutar quatro opções simples que lhe 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>
<para>Esta secção irá descrever alguns dos itens no menu <guimenu>Configuração</guimenu>, de modo que possa configurar o &kate; como for da sua vontade. </para>
<para>Quando arrancar o &kate; pela primeira vez, verá 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. Alterne entre as duas carregando nos selectores de secção no topo da janela. </para>
<para>Se invocou o &kate; com um ficheiro, a janela da direita irá mostrar o ficheiro que está a editar e a lista de Documentos na barra lateral irá mostrar o nome do ficheiro. Use a janela de Navegação no Sistema de Ficheiros para os abrir. </para>
<para>Poderá activar ou desactivar as janelas de Documentos e Navegador do Sistema de Ficheiros com a opção <menuchoice><guimenu>Janela</guimenu><guimenu>Vistas de Ferramentas</guimenu></menuchoice>. Este menu oferece-lhe a sua primeira vista de olhos nas potencialidades e flexibilidade do &kate;. Nesta secção, serão vistos três itens: </para>
<para>Liga e desliga a lista de Documentos. 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 acoplar a janela, agarre nas duas linhas finas paralelas por cima dos selectores de secção, carregando nelas com o &LMB; do rato e mantendo o botão carregado. Arraste a janela para a área de edição do &kate; e largue o botão esquerdo, quando tiver posicionado a janela no seu local preferido. </para>
<para>Liga e desliga a janela de selecção de ficheiros. Este item do menu é o mesmo que o <guimenuitem>Mostrar os Documentos</guimenuitem> mas com uma diferença. Ao activá-la, aparece a janela com o selector de ficheiros seleccionado. </para>
<para>Activa e desactiva um emulador de consola na parte inferior da janela do &kate;. Por outras palavras, fornece-lhe uma linha de comandos dentro da aplicação. </para>
<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>
<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>
<para>As sessões são a forma como o &kate; lhe deixa manter uma lista de mais que um ficheiro e a configuração da interface. Poderá ter tantas sessões com nome quantas quiser e poderá usar sessões sem nome ou anónimas para os ficheiros que só queira usar uma vez. De momento, o &kate; pode gravar a lista de ficheiros abertos e a configuração geral da janela na sessão, enquanto as próximas versões do &kate; possam adicionar mais funcionalidades que possam ser gravadas em sessões. Com a introdução das sessões, o &kate; também lhe permite abrir um número qualquer de instâncias da aplicação, em vez de apenas uma, como costumava ser o comportamento por omissão.</para>
<para>As sessões são suportadas em três áreas: <itemizedlist>
<listitem><para><link linkend="command-line-options"><emphasis>Opções da linha de comandos</emphasis></link>, que lhe permite seleccionar e iniciar as sessões, ao lançar o Kate a partir da linha de comandos.</para>
<listitem><para><link linkend="sessions-menu"><emphasis>O menu de Sessões</emphasis></link>, que lhe permite mudar, gravar, iniciar e gerir as suas sessões</para></listitem>
<listitem><para><link linkend="config-dialog-sessions"><emphasis>Opções de configuração</emphasis></link>, que lhe permite decidir como as sessões se devem comportar normalmente.</para></listitem>
<para>Ao iniciar uma sessão nova, a configuração da GUI da <guilabel>Sessão Predefinida</guilabel> é carregada. Para gravar a configuração da janela na sessão predefinida, terá de activar a gravação da configuração de janelas na página de configuração da sessão e depois carregar a sessão predefinida, configurar a janela como desejar e gravar a sessão de novo.</para>
<para>Quando uma sessão com nome for carregada, o &kate; irá mostrar o nome da sessão no início do título da janela, que poderá ter então o formato "<replaceable>Nome da Sessão</replaceable>: <replaceable>Nome ou &URL; do documento</replaceable> - &kate;"</para>
<para>Ao abrir ficheiros na linha de comandos com a opção <option>--start <replaceable>nome</replaceable></option> ou, se uma sessão for seleccionada com o selector de sessões, a sessão indicada é carregada antes dos ficheiros indicados na linha de comandos. Para abrir os ficheiros da linha de comandos numa sessão nova sem nome, configure o 'kate' para iniciar uma sessão nova por omissão na página de sessões da janela de configuração ou use o <option>--start</option> com um texto vazio: <replaceable>''</replaceable>.</para>
<para>Desde o &kate; 2.5.1, o <acronym>PID</acronym> da instância actual é exportado na variável de ambiente <envar>KATE_PID</envar>. Ao abrir os ficheiros do terminar incorporado no Kate, irá seleccionar automaticamente a instância actual, se não for indicado mais nada na linha de comandos.</para>
<title>Repor o comportamento antigo do &kate;</title>
<para>Quando estiver habituado a usar as sessões, espera-se que você veja que estas oferecem uma ferramenta muito simples e eficiente para lidar com várias áreas diferentes. Contudo, se preferir o comportamento antigo do &kate; (uma instância que abre todos os ficheiros), poderá obter facilmente isso, se seguir esta estratégia simples: <itemizedlist>
<listitem><para>Faça com que o 'kate' arranque sempre com o parâmetro <option>--use</option>, adicionando isso ao comando nas preferências da aplicação e, se possível, usando um comando alternativo ou 'alias'.</para></listitem>
<listitem><para>Configure o &kate; para carregar a última sessão usada no arranque.</para>
<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>Carregue em <keycap>F1</keycap> ou use o tópico do menu <menuchoice><guimenu>Ajuda</guimenu></menuchoice> <guisubmenu>Conteúdo</guisubmenu> para ver este manual.</para></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 você usar a ajuda O Que É Isto?, carregue em <keycombo>&Shift;<keycap>F1</keycap></keycombo>, ou use a opção do menu <menuchoice><guimenu>Ajuda</guimenu><guimenuitem>O Que É Isto?</guimenuitem></menuchoice>, para activar o modo de ajuda rápida. O cursor irá mudar para uma seta com um ponto de interrogação, para que possa então carregar em qualquer elemento da janela, de modo a ler a sua ajuda respectiva, se estiver disponível.</para>
<para>Algumas janelas têm um botão de <guibutton>Ajuda</guibutton>. Se carregar nele, irá iniciar o &khelpcenter; e abrir a documentação relevante.</para>
<para>O &kate; não possibilita (ainda!) nenhum meio para ler a documentação relacionada com o documento. Dependendo do ficheiro que estiver a editar, poderá achar o <link linkend="kate-mdi-tools-konsole">&konsole; Incorporado</link> útil para ver a documentação das páginas 'man' e 'info' ou mesmo usar o &konqueror;.</para>
