# Alguns Fundamentos

O &kwrite;, bem como outras utilizações do &katepart;, é muito simples de usar. Toda a gente que já usou um editor de texto não deverá ter problemas.

## Arrastar e Largar

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

## Opções da Linha de Comandos

Embora o &kwrite; possa ser geralmente iniciado a partir do menu de programas do &kde; ou de um ícone do ecrã, poderá ser aberto a partir da linha de comandos de uma janela de terminal. Existem algumas opções úteis que estão disponíveis ao fazer isto.

Muitas outras aplicações que usam o &katepart; oferecem opções da linha de comandos semelhantes.

### Indicar um Ficheiro

Ao indicar a localização e o nome de um ficheiro em particular, o utilizador poderá fazer com que o &kwrite; abra (ou crie) esse ficheiro imediatamente no seu arranque. Esta opção poder-se-á traduzir em algo como o que se segue:

    % kwrite
    /home/eu/documentos/ficheiro.txt

### Indicar um ficheiro na Internet

O método acima descrito poderia ser usado até para abrir os ficheiros na Internet (se o utilizador tiver uma ligação activa na altura). Um exemplo disso poderia ser o seguinte:

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

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

De momento, estão disponíveis as seguintes opções da linha de comandos:

``kwrite` `--help``

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

``kwrite` `--author``

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

``kwrite` `-v`, `--version``

- Apresenta a informação da versão da aplicação.

``&kwrite;` `--license``

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

``kwrite` `--desktopfile` `ficheiro``

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

``kwrite` `-e`, `--encoding` `codificação` `&URL;``

- Faz com que o &kwrite; use a codificação indicada para o documento.

``kwrite` `-l`, `--line` `linha` `&URL;``

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

``kwrite` `-c`, `--column` `coluna` `&URL;``

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

``kwrite` `-i`, `--stdin``

- Faz com que o &kwrite; leia o conteúdo do documento a partir do STDIN. Isto é semelhante à opção comum `-`, que é usada em muitos programas da linha de comandos, permitindo-lhe encaminhar o resultado dos comandos para o &kwrite;.

## Atalhos

Muitos dos comandos de teclado são configuráveis através do menu Configuração. Por omissão, o &katepart; respeita as seguintes combinações de teclas:

Ins | 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
&Alt;Page Up | Favorito Anterior
Page Down | Move o cursor uma página para baixo
&Alt;Page Down | Favorito Seguinte
&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
Apagar | 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?
F3 | Procurar o Seguinte
&Shift;F3 | Procurar o Anterior
&Ctrl;H | Procurar o Seleccionado
&Ctrl;&Shift;H | Procurar o Seleccionado para Trás
&Ctrl;A | Seleccionar Tudo
&Ctrl;&Shift;A | Deseleccionar
&Ctrl;&Shift;B | Modo de Selecção em Bloco
&Ctrl;B | Marca um Favorito
&Ctrl;C | Copia o texto seleccionado para a área de transferência.
&Ctrl;D | Comentário
&Ctrl;&Shift;D | Descomentar
&Ctrl;F | Procurar
&Ctrl;G | Vai para a linha...
&Ctrl;I | Indenta a selecção
&Ctrl;&Shift;I | Remove a indentação da selecção
&Ctrl;J | Juntar as Linhas
&Ctrl;N | Novo documento
&Ctrl;O | Abrir um documento
&Ctrl;P | Imprimir
&Ctrl;Q | Sair - fecha a cópia activa do editor
&Ctrl;R | Substituir
&Ctrl;S | Invoca o comando Gravar.
&Ctrl;U | Maiúsculas
&Ctrl;&Shift;U | Minúsculas
&Ctrl;&Alt;U | Capitalização
&Ctrl;V | Cola o texto da área de transferência no campo de edição.
&Ctrl;W | Fechar
&Ctrl;X | Apaga o texto seleccionado e copia-o para a área de transferência.
&Ctrl;Z | Desfazer
&Ctrl;&Shift;Z | Refazer
&Ctrl;- | Fechar um Nível Local
&Ctrl;&Shift;- | Fechar o Nível de Topo
&Ctrl;+ | Expandir um Nível Local
&Ctrl;&Shift;+ | Expandir o Nível de Topo
Meta&Ctrl;V | Modo de entrada do VI
&Ctrl;Espaço | Invocar a Completação de Código
F5 | Actualizar
F6 | Mostrar/Esconder o Contorno dos Ícones
F7 | Mudar para a Linha de Comandos
F9 | Mostrar/Esconder as Marcas de Desdobramento
F10 | Mudança de Linha Dinâmica
F11 | Mostrar/Esconder os Números de Linha