# Os Fundamentos

Se você já usou um editor de texto, não terá problema em usar o &kate;. Nas próximas duas seções, chamadas Iniciando o &kate; e Trabalhando com o &kate;, mostraremos a você tudo que precisa para abri-lo e rodá-lo rapidamente.

## Iniciando o &kate;

Você pode iniciar o &kate; do &kmenu; ou da linha de comando.

### Do Menu

Abra o menu de programas do &kde; clicando no grande ícone K na barra de ferramentas no canto inferior esquerdo da sua tela (normalmente). Isto exibirá um menu. Mova o seu cursor para o menu até o item Aplicativos Utilitários Editor de Texto Avançado &kate;.

### A partir da linha de comando

Você pode iniciar o &kate; digitando seu nome na linha de comando. Se você fornecer um nome de arquivo, como no exemplo abaixo, ele abrirá ou criará aquele arquivo.

    %kate meuarquivo.txt

Se você possui uma conexão ativa e permissões, pode usar a característica de transparência de rede do &kde; para abrir arquivos da Internet.

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

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

O &kate; aceita as seguintes opções da linha de comando:

``kate` `--help``

- Isto lista as opções mais básicas disponíveis na linha de comando.

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

- Lista as opções disponíveis para modificar o modo como o &kate; interage com a &Qt;.

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

- Lista as opções disponíveis para modificar o modo como o &kate; interage com o &kde;.

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

- Inicia o 'kate' com a sessão `nome`. A sessão é criada se ela não existir. Se existir uma instância do &kate; que esteja rodando a sessão indicada, os arquivos indicados são carregados nessa instância. Quando for usado com a opção `--use`, será também usada uma instância que esteja rodando esta sessão.

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

- Faz com que o &kate; use uma instância existente se existir alguma. Isto agora é o comportamento padrão, mas esta opção permanece para compatibilidade.

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

- Só utiliza novamente 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 especificada 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 comando e lhe permite encaminhar o resultado do comando para o &kate;.

``kate` `--startanon``

- Iniciar o &kate; com uma nova sessão anônima; implica o uso do `-n`.

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

- Forçar o início de uma nova instância do &kate; (é ignorado se for usado o `start` e já existir outra instância do &kate; com a sessão indicada aberta); é forçado no caso de não terem sido indicados quaisquer URLs ou parâmetros.

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

- Se uma instância do &kate; já estiver rodando, bloqueia até ela terminar, se forem fornecidas URLs a serem abertas.

  Você pode usar o &kate; com esta opção como editor para digitar mensagens de envio para sistemas de controle de versões como o Git ou o Subversion. Estes sistemas bloqueiam o editor até que você tenha inserido sua mensagem pois eles então abrirão o arquivo temporário que estaria vazio se o kate retornasse imediatamente para o chamador.

  Esta opção também é necessária com o KIO (sistema de Entrada/Saída do &kde;), se você abrir um arquivo remoto (que foi baixado para um temporário) que deve ser re-enviado, após salvá-lo.

``kate` `--tempfile``

- Desde o &kate; 2.5.1 que esta opção padrão do &kde; é usada. Quando for usada, os arquivos indicados são tratados como arquivos temporários e removidos após (se forem arquivos locais e se tiver permissões suficientes) serem fechados, a menos que tenham sido modificados desde a sua abertura.

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

- Lista todas as opções da linha de comando.

``kate` `--author``

- Lista o autor do &kate; na janela de terminal.

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

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

``kate` `--license``

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

### Arrastar e Soltar

O &kate; usa o protocolo de Arrastar e Soltar do &kde;. Os arquivos podem ser arrastados e soltados do &kate; da Área de Trabalho, do gerenciador de arquivos &dolphin;, ou de algum site ftp remoto aberto em uma das janelas do &dolphin;.

## Trabalhando com o &kate;

A Inicialização Rápida lhe mostrará como comutar quatro opções simples que lhe permitirão configurar algumas das funcionalidades mais poderosas do &kate; em um instante. Os Atalhos de Teclado fornecem alguns atalhos de teclado para aqueles que não podem ou não querem usar um mouse.

### Início Rápido

Esta seção descreverá alguns itens do menu Exibir pois assim, você pode configurar rapidamente o &kate; para trabalhar da maneira que você deseja.

Quando iniciar o &kate; pela primeira vez, você verá duas janelas com o fundo branco. Acima das duas janelas existe uma barra de ferramentas com os ícones padrão. Acima dela, está a barra do menu.

A janela da esquerda é uma barra lateral acoplável. Ela combina as janelas de Documentos e Navegador do Sistema de Arquivos. Alterne entre as duas clicando nos seletores de seção no topo da janela.

Se você iniciou o &kate; com um arquivo, a janela da direita irá mostrar o arquivo que está editando e a lista de Documentos na barra lateral irá mostrar o nome do arquivo. Use a janela do Navegador do Sistema de Arquivos para abri-los.

Você poderá ativar ou desativar as janelas de Documentos e Navegador do Sistema de Arquivos com a opção Exibir Visões da ferramenta. Este menu oferece em uma rápida olhada o poder e flexibilidade do &kate;. Nesta seção, serão vistos três itens:

Mostrar Documentos

- Liga e desliga a lista de Documentos. Se a janela da lista e seleção de arquivos 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 acima dos seletores de seção, clicando nelas com o &LMB; do mouse e mantendo o botão pressionado. Arraste a janela para a área de edição do &kate; e solte o botão esquerdo, quando tiver posicionado a janela no local desejado.

  Se você arrastou as duas linhas paralelas com sucesso, seu ponteiro do mouse ficará com a forma de duas flechas cruzadas, como você soltou.

Mostrar o Navegador do Sistema de Arquivos

- Liga e desliga a janela de seleção de arquivos. Este item do menu é o mesmo que o Mostrar Documentos mas com uma diferença. Ao ativá-la, aparece a janela com o seletor de arquivos selecionado.

Mostrar Terminal

- Ativa e desativa um emulador de console na parte inferior da janela do &kate;. Em outras palavras, fornece-lhe uma linha de comando dentro do aplicativo.

### Atalhos

Muitos dos comandos de tecla (atalhos) do &kate; são configurados pelo menu Preferências. Por padrão, o &kate; honra os seguintes atalhos de teclado.

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 caracter elimine o caracter imediatamente à direita do cursor.
Seta a esquerda | Move o cursor um caractere para a esquerda
Seta a direita | Move o cursor um caractere para a direita
Seta para cima | Move o cursor uma linha acima
Seta para baixo | Move o cursor uma linha abaixo
Page Up | Move o cursor uma página acima
Page Down | Move o cursor uma página abaixo
&Backspace; | Remove o caractere à esquerda do cursor
Home | Move o cursor para o início da linha
End | Move o cursor para o fim da linha
Delete | Remove o caractere da direita do cursor (ou o texto selecionado)
&Shift;&Enter; | Insere uma nova linha incluindo os caracteres iniciais da linha atual que não são letras ou números. Isto é útil por ⪚ para escrever comentários no código. No final de uma linha // algum texto pressione este atalho e a próxima linha já inicia com o // . Assim, você não terá que inserir os caracteres de comentário no início de cada nova linha com comentários.
&Shift;Seta à esquerda | Marca o texto um caractere à esquerda
&Shift;Seta à direita | Marca o texto um caractere à direita
F1 | Ajuda
&Shift;F1 | O Que é Isso?
&Ctrl;F | Procurar
F3 | Procurar novamente
&Ctrl;B | Configurar um favorito
&Ctrl;C | Copia o texto marcado para a área de transferência.
&Ctrl;N | Novo documento
&Ctrl;P | Imprimir
&Ctrl;Q | Finaliza - fecha a cópia ativa do editor
&Ctrl;R | Substituir
&Ctrl;S | Salva seu arquivo.
&Ctrl;V | Colar
&Ctrl;X | Remove o texto marcado e copia-o para a área de transferência.
&Ctrl;Z | Desfazer
&Ctrl;&Shift;Z | Refazer

## Usando as Sessões

As sessões são a forma como o &kate; lhe deixa manter uma lista de arquivos abertos e a configuração da interface. Você poderá ter quantas sessões com nome quiser e poderá usar sessões sem nome ou anônimas para os arquivos que só queira usar uma vez. Atualmente, o &kate; pode salvar a lista de arquivos abertos e a configuração geral da janela na sessão; as próximas versões do &kate; poderão adicionar mais funcionalidades que possam ser salvas em sessões. Com a introdução das sessões, o &kate; também lhe permite abrir um número qualquer de instâncias do aplicativo, em vez de apenas uma, como costumava ser o comportamento padrão.

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

- Opções da linha de comando, que lhe permite selecionar e iniciar as sessões, ao iniciar o Kate a partir da linha de comando.

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

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

Ao iniciar uma nova sessão, a configuração da GUI da Sessão Pré-definida é carregada. Para salvar a configuração da janela na sessão pré-definida, você terá de ativar o salvamento da configuração de janelas na página de configuração da sessão e depois carregar a sessão pré-definida, configurar a janela como desejar e salvar a sessão novamente.

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 arquivos na linha de comando com a opção `--start `nome`` ou, se uma sessão for selecionada com o seletor de sessões, a sessão indicada é carregada antes dos arquivos indicados na linha de comando. Para abrir os arquivos da linha de comandos numa sessão nova sem nome, configure o 'kate' para iniciar uma sessão nova por padrã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 atual é exportado na variável de ambiente `KATE_PID`. Ao abrir os arquivos do terminal embutido no Kate, você irá selecionar automaticamente a instância atual, se não for indicado mais nada na linha de comando.

### Restaurando o comportamento antigo do &kate;

Quando você estiver habituado a usar as sessões, perceberá que elas 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 arquivos), poderá obter facilmente isso, se seguir esta estratégia simples:

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

- Configure o &kate; para carregar a última sessão usada na inicialização.

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

- Carregue a sessão padrão uma vez

## Obtendo a Ajuda

### Com o &kate;

Este manual

- Oferece documentação detalhada sobre todos os comandos de menu, opções de configuração, ferramentas, diálogos, plug-ins, &etc;, bem como descrições da janela do &kate;, o editor e vários conceitos usados no aplicativo.

  Pressione F1 ou use o tópico de menuAjuda Manual do &kate; para visualizar este manual.

Ajuda - O Que é Isso

- A Ajuda 'O Que é Isso' oferece ajuda imediata para elementos únicos das janelas gráficas, tais como botões ou outras áreas da janela.

  Houve um esforço em fornecer a ajuda O Que é Isso para qualquer elemento que faça sentido. Está disponível também o diálogo de configuração, e também muitos outros diálogos.

  Para usar a ajuda O Que é Isso, pressione &Shift;F1 ou use o item de menu Ajuda O Que é Isto para habilitar o modo O Que é Isto. O cursor se transformará em uma flecha, com um ponto de interrogação, e você pode clicar agora sobre qualquer elemento da janela, para ler a ajuda para aquele elemento, se estiver disponível.

Botões de Ajuda dos Diálogos

- Alguns diálogos possuem o botão de Ajuda. Pressioná-lo iniciará o &khelpcenter; e abrirá a documentação relevante.

### Com seus Arquivos de Texto

O &kate; não fornece (ainda) qualquer documentação relacionado a leitura do documento. Dependendo do arquivo que você estiver editando, você pode encontrar a ajuda Integrada ao Emulador de Terminal para visualizar as páginas de manual ou documentação info do &UNIX;, ou você pode usar o &konqueror;.

### Artigos no &kate;

A página do &kate; fornece alguns Artigos e Howtos com mais informações além do escopo deste manual.