# 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 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, caso exista uma. Este é agora o comportamento por omissão, mas esta opção mantém-se por razões de compatibilidade.

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

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

- A Lista de Documentos

- O Navegador no Sistema de Ficheiros

- O Emulador de Terminal Incorporado

E, possivelmente, mais outras janelas, as quais podem ser disponibilizadas pelos 'plugins'.

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.

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

### A Lista de Documentos

A lista de documentos mostra uma lista de todos os documentos abertos no &kate;. Os ficheiros modificados irão ter um pequeno ícone de disquete à sua esquerda para indicar esse estado.

Por omissão, a lista de Documentos aparece no Modo da Árvore, que mostra a estrutura em pastas que rodeia todos os documentos abertos. Também está disponível o Modo da Lista, que mostra uma lista simples com todos os documentos abertos. Pode mudar de modos com o botão direito do rato na lista e seleccionando a opção Modo de Visualização.

Se estiverem abertos dois ou mais ficheiros com o mesmo nome (localizados em pastas diferentes) no Modo de Lista, o nome do segundo terá adicionado no fim (2) e assim por diante. A dica para o ficheiro irá mostrar o seu nome completo, incluindo a sua pasta, o que lhe permite escolher o documento desejado.

Para mostrar um documento na janela activa de momento, carregue no nome do documento na lista.

Poderá ordenar a lista de diferentes formas, se carregar com o botão direito na lista e seleccionar uma opção no menu Ordenar Por. As opções são:

Ordem de Abertura

- Lista os documentos pela ordem de abertura.

Nome do Documento

- Lista os documentos alfabeticamente pelo seu nome.

Localização do Documento

- Lista os documentos alfabeticamente pela sua localização.

A lista de documentos irá, por omissão, visualizar o seu histórico, desvanescendo os itens para os documentos mais recentes com uma cor de fundo. Se o documento foi editado, é misturada uma cor extra. O documento mais recente tem a cor mais forte, por isso será mais fácil para si ver os documentos em que está a trabalhar. Esta funcionalidade poderá ser desactivada na página de Documentos da janela de configuração.

A localização por omissão da lista de documentos na janela do &kate; está à esquerda da área de edição.

### O Emulador de Terminal Embutido

O Emulador de Terminal incorporado é uma cópia da aplicação de terminal do &kde;, o &konsole;, para a sua conveniência. Está disponível na opção do menu Ver Áreas de Ferramentas Mostrar o Terminal, para que este fique em primeiro plano logo que visível. Adicionalmente, se a opção Sincronizar automaticamente o terminal com o documento actual quando possível estiver activa, este irá entrar na pasta do documento actual, ao ficar visível, ou quando o documento actual mudar.

A localização por omissão na janela do &kate; fica na parte inferior, por baixo da área de edição.

Poderá configurar o &konsole; com o seu menu de &RMB;; para mais informações, veja o manual do &konsole;.

O terminal incorporado é fornecido pelo 'plugin' da ferramenta do terminal, que está activo por omissã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.

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