# 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 lançador de aplicações ou na linha de comandos.

### A Partir do Menu

Abra o menu de programas do &kde; carregando no ícone de lançamento de aplicações na barra de ferramentas no canto inferior esquerdo do seu ecrã. 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 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 disponíveis na linha de comandos.

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

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

- Só utiliza de novo uma instância com o PID indicado (ID do Processo).

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

- 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` `--desktopfile` `ficheiro``

- O nome de base do ficheiro do item '.desktop' para esta aplicação.

``kate` `--author``

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

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

- Indica as informações de versões 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 barras laterais com a opção Ver Áreas de Ferramentas ou usando a combinação &Ctrl;&Alt;&Shift;F. Este menu oferece-lhe a sua primeira vista de olhos nas potencialidades e flexibilidade do &kate;.

Nas Áreas de Ferramentas tem uma lista com todos os 'plugins' incorporados. Carregue na opção à frente de cada item ou carregue com o &LMB; nos botões das ferramentas na barra lateral para activar ou desactivar esta área de ferramentas.

### 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 Seguinte
&Ctrl;B | Marca um Favorito
&Ctrl;C | Copia o texto seleccionado para a área de transferência
&Ctrl;N | 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

## Trabalhar com o MDI do &kate;

### Introdução

Janela, Documento, Editor... O que são todos estes conceitos na terminologia do &kate;, e como é possível tirar o maior partido dele? Este capítulo irá explicar tudo sobre o assunto e ainda mais.

#### A Janela Principal

A Janela Principal do &kate; é uma janela de aplicação normal do &kde;, com a adição de sub-janelas acopláveis ou janelas de ferramentas. Tem uma barra de menu com todos os menus normais, para além de outros específicos, bem como uma barra de ferramentas que permite o acesso aos comandos mais usados.

A parte mais importante da janela é a área de edição, que mostra por omissão uma componente de edição de texto, no qual o utilizador poderá trabalhar nos seus documentos.

As capacidades de acoplagem da janela são usadas para as janelas de ferramentas de qualquer 'plugin' activo na janela de configuração.

As ferramentas podem ser posicionadas em qualquer barra lateral; para mover uma ferramenta, carregue com o botão direito no seu botão da barra lateral e seleccione no menu do &RMB;

Uma ferramenta pode ser marcada como persistente no menu do &RMB;, com o seu botão da barra lateral. A barra lateral pode conter mais ferramentas de cada vez para que, quando uma ferramenta for persistente, as outras ferramentas possam ser mostradas em simultâneo.

Se um 'plugin' tiver opções de configuração, poderá usar o primeiro item no menu de contexto para abrir a página correspondente na janela de configuração do &kate;.

### A área do Editor

O &kate; é capaz de ter mais que um documento aberto ao mesmo tempo, e também consegue repartir a área de edição em várias sub-janelas, de uma forma semelhante à que o &konqueror; ou o emacs praticam. Desta forma, poderá ver vários documentos ao mesmo tempo, ou mesmo várias instâncias do mesmo documento, o que é útil, por exemplo, se o seu documento contém definições no seu topo que deseje ver frequentemente como forma de referência. Poderá também ver um ficheiro de inclusão numa sub-janela, enquanto altera o ficheiro de implementação noutra.

Quando um documento está disponível em mais de um editor, as alterações feitas num editor serão reflectidas imediatamente nos outros. Isto inclui a alteração do texto, bem como a sua selecção. As operações de pesquisa ou de movimentação do cursor só se reflectem no editor actual.

Não é possível de momento ter mais que uma instância do mesmo documento aberta, na medida em que uma instância será editada enquanto a outra não.

Ao repartir um editor em duas áreas, estas ficam divididas, por igual tamanho, e a mostrarem ambas o documento actual desse editor. A nova janela será a inferior (no caso de dividir horizontalmente) ou a da direita (se a divisão for vertical). A nova janela fica em primeiro plano, o qual é visível através do cursor intermitente na janela em questão.

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

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