# Alguns Fundamentos

O &kwrite; é muito simples de usar. Toda a gente que já usou um editor de texto não deverá ter problemas.

## Arrastar e Largar

O &kwrite; 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.

### 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` `--help-qt``

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

``kwrite` `--help-kde``

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

``kwrite` `--help-all``

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

``kwrite` `--author``

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

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

  Lista a informação de versão do &Qt;, do &kde; e do &kwrite;. Também está disponível como ``kwrite` `-v``

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

  Mostra informações sobre a licença.

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

``kwrite` `--encoding` `encoding` `&URL;``

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

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

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

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

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

## Atalhos

Muitos dos comandos de teclado são configuráveis através do menu Configuração. Por omissão, o &kwrite; respeita a seguinte configuração 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, &eg;, 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 | Cria um 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