# Os Fundamentos

Se alguma vez utilizou um editor de texto, não terá problemas a usar o &kate;. Nas duas próximas secções, em Iniciar o &kate; e em Trabalhar com o &kate;, mostrar-lhe-emos tudo o que precisa para interagir com ele.

## Iniciar o &kate;

Poderá iniciar o &kate; no &kmenu; ou na linha de comandos.

### A Partir do Menu

Abra o menu de programas do &kde; carregando no ícone K grande na barra de ferramentas no canto inferior esquerdo do seu ecrã (normalmente). Isto fará aparecer um menu. Mova o seu cursor para o menu até ao item Aplicações Utilitários Editor de Texto Avançado &kate;.

A menos que tenha configurado o &kate; para não o fazer, ele irá abrir os últimos ficheiros que você editou. Veja em Configurar o &kate; para aprender como ligar e desligar esta opção.

### A Partir da Linha de Comandos

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.

    %kate ficheiro.txt

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.

    %kate ftp://ftp.kde.org/pub/kde/README

#### Opções da Linha de Comandos

O &kate; aceita as seguintes opções na linha de comandos:

``kate` `--help``

- Isto lista as opções mais básicas que estão disponíveis na linha de comandos.

``kate` `--help-qt``

- Isto lista as opções disponíveis para mudar a forma como o &kate; interage com o &Qt;.

``kate` `--help-kde``

- Isto lista as opções disponíveis para alterar a forma como o &kate; interage com o &kde;.

``kate` `-s` `--start` `nome``

- Inicia o 'kate' com a sessão `nome`. 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 `--use`, será também usada uma instância que esteja a correr esta sessão.

``kate` `-u` `--use` `URL``

- 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.

``kate` `-p` `--pid` `PID``

- Só utiliza de novo uma instância com o PID indicado (ID do Processo). É usado com a opção `--use`.

``kate` `-e` `--encoding` `codificação` `URL``

- Usa a codificação usada para o documento.

``kate` `-l` `--line` `linha` `URL``

- Vai para a linha indicada, após abrir o documento.

``kate` `-c` `--column` `coluna` `URL``

- Vai para a coluna indicada, após abrir o documento.

``kate` `-i` `--stdin``

- Lê o conteúdo do documento a partir do STDIN. Isto é semelhante à opção comum `-`, que é usada por muitos programas da linha de comandos e lhe permite encaminhar o resultado do comando para o &kate;.

``kate` `--startanon``

- Inicia o &kate; com uma nova sessão anónima; a mesma implica o `-n`.

``kate` `-n` `--new``

- Força o início de uma nova instância do &kate; (é ignorado se for usada a opção `start` e se já estiver outra instância do &kate; com a sessão indicada aberta); será forçada, caso não sejam indicados quaisquer parâmetros ou URL's.

``kate` `-b` `--block``

- Se estiver a usar uma instância do &kate;, bloqueia até que esta saia, caso não sejam indicados quaisquer URL's a abrir.

  Poderá usar o &kate; com esta opção para escrever as mensagens de envio dos sistemas de controlo de versões como o Git ou o Subversion. Estes sistemas contam com o bloqueio do editor até que tenha introduzido a sua mensagem, dado que eles abrem o ficheiro temporário nesse caso, o qual estaria vazio se o Kate voltasse imediatamente a quem o invocou.

  Esta opção também é necessária com o KIO (&kde; Input/Output), caso aceda a um ficheiro remoto (que foi transferido para um local temporário) e que deverá voltar a ser enviado, após a gravação do mesmo.

``kate` `--help``

- 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.

``kate` `--help-all``

- Isto lista todas as opções da linha de comandos.

``kate` `--author``

- Lista os autores do &kate; na janela do terminal.

``kate` `-v` `--version``

- Indica as informações de versões do &Qt;, &kde; e do &kate;.

``kate` `--license``

- Mostra informações sobre a licença.

### Arrastar e Largar

O &kate; utiliza o protocolo 'Drag and Drop' do &kde;. Os ficheiros podem ser arrastados e largados no &kate; a partir do ecrã, do &dolphin; ou de algum servidor de FTP remoto aberto numa das janelas do &dolphin;.

## Trabalhar com o &kate;

O Arranque Rápido mostrar-lhe-á como comutar quatro opções simples que lhe permitirão configurar algumas das funcionalidades mais poderosas do &kate; num instante. Os Comandos do Teclado fornece alguns atalhos de teclado para aqueles que não podem ou não querem usar um rato.

### Arranque Rápido

Esta secção irá descrever alguns dos itens no menu Ver, de modo que possa configurar o &kate; como for da sua vontade.

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.

A janela da esquerda é uma barra lateral acoplável. Combina as janelas de Documentos e o Navegador do Sistema de Ficheiros. Alterne entre as duas carregando nos selectores de secção no topo da janela.

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 do Navegador do Sistema de Ficheiros para os abrir.

Poderá activar ou desactivar as janelas de Documentos e Navegador do Sistema de Ficheiros com a opção Ver Áreas de Ferramentas. 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:

Mostrar os Documentos

- 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.

  Se seleccionou efectivamente as duas linhas paralelas, o seu cursor do rato irá mudar para duas setas cruzadas à medida que arrasta.

Mostrar o Navegador do Sistema de Ficheiros

- Liga e desliga a janela de selecção de ficheiros. Este item do menu é o mesmo que o Mostrar os Documentos mas com uma diferença. Ao activá-la, aparece a janela com o selector de ficheiros seleccionado.

Mostrar o Terminal

- 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.

### Atalhos

Muitos dos comandos de teclado do &kate; (atalhos) são configuráveis através do menu Configuração. Por omissão, o &kate; respeita a seguinte configuração de teclas.

Insert | 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.
Esquerda | Move o cursor um carácter para a esquerda
Direita | Move o cursor um carácter para a direita
Cima | Sobe o cursor uma linha
Baixo | Desce o cursor uma linha
Page Up | Move o cursor uma página para cima
Page Down | Move o cursor uma página para baixo
&Backspace; | Apaga o carácter à esquerda do cursor
Home | Move o cursor para o início da linha
End | Move o cursor para o fim da linha
Delete | Apaga o carácter à direita do cursor (ou qualquer texto seleccionado)
&Shift;&Enter; | Introduz uma mudança de linha, incluindo os caracteres iniciais da linha actual que não sejam letras ou números. É útil, ⪚, para escrever comentários no código: No fim da linha // algum texto, carregue neste atalho para que a linha seguinte comece já com o // , para que não tenha de introduzir os caracteres de comentários no início de cada nova linha de comentários.
&Shift;Esquerda | Marca o texto que está um carácter à esquerda
&Shift;Direita | Marca o texto que está um carácter à direita
F1 | Ajuda
&Shift;F1 | O que é isto?
&Ctrl;F | Procurar
F3 | Procurar o próximo
&Ctrl;B | Marca um Favorito
&Ctrl;C | Copia o texto seleccionado para a área de transferência.
&Ctrl;N | Cria um Novo documento
&Ctrl;P | Imprimir
&Ctrl;Q | Sair - fecha a cópia activa do editor
&Ctrl;R | Substituir
&Ctrl;S | Grava o seu ficheiro.
&Ctrl;V | Colar.
&Ctrl;X | Apaga o texto seleccionado e copia-o para a área de transferência.
&Ctrl;Z | Desfazer
&Ctrl;&Shift;Z | Refazer

## Usar as Sessões

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.

As sessões são suportadas em três áreas:

- Opções da linha de comandos, que lhe permite seleccionar e iniciar as sessões, ao lançar o Kate a partir da linha de comandos.

- O menu de Sessões, que lhe permite mudar, gravar, iniciar e gerir as suas sessões

- Opções de configuração, que lhe permite decidir como as sessões se devem comportar normalmente.

Ao iniciar uma sessão nova, a configuração da GUI da Sessão Predefinida é 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.

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 "`Nome da Sessão`: `Nome ou &URL; do documento` - &kate;"

Ao abrir ficheiros na linha de comandos com a opção `--start `nome`` 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 `--start` com um texto vazio: `''`.

Desde o &kate; 2.5.1, o PID da instância actual é exportado na variável de ambiente `KATE_PID`. 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.

### Repor o comportamento antigo do &kate;

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:

- Faça com que o 'kate' arranque sempre com o parâmetro `--use`, adicionando isso ao comando nas preferências da aplicação e, se possível, usando um comando alternativo ou 'alias'.

- Configure o &kate; para carregar a última sessão usada no arranque.

- Configure o &kate; para gravar a lista de ficheiros ao fechar uma sessão.

- Carregar a sessão por omissão uma vez

## Obter Ajuda

### Com o &kate;

Este manual

- 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.

  Carregue em F1 ou use o tópico do menu Ajuda Manual do &kate; para ver este manual.

A ajuda O que é Isto?

- 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.

  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 você usar a ajuda O Que É Isto?, carregue em &Shift;F1, ou use a opção do menu Ajuda O Que É Isto?, 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.

Botões de Ajuda nas Janelas

- Algumas janelas têm um botão de Ajuda. Se carregar nele, irá iniciar o &khelpcenter; e abrir a documentação relevante.

### Com os Seus Ficheiros de Texto

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 Terminal Incorporado útil para ver a documentação das páginas 'man' e 'info' do &UNIX; ou mesmo usar o &konqueror;.

### Artigos sobre o &kate;

A página Web do &kate; mostra alguns Artigos e 'Howtos' com mais informações além do âmbito deste manual.