# O Manual do &kwrite;

## Introdução

O &kwrite; é mais do que um editor de texto para o ambiente de trabalho do &kde;. Pretende-se que seja um editor para o programador, e poderia ser considerado pelo menos como uma alternativa parcial para a maioria dos editores poderosos. Poderá ser melhor usado, em conjunto com o &konqueror; ou o &dolphin;, para a navegação por ficheiros de código das diferentes linguagens. O &kwrite; também funciona muito bem como um editor de texto simples. Uma das funcionalidades principais do &kwrite; é a sintaxe colorida personalizada para muitas das diferentes linguagens de programação como por exemplo: C/C++, &Java;, Python, Perl, Bash, Modula 2, &HTML; e Ada.

O &kwrite; tem uma interface de documentos únicos (SDI) que lhe permite editar apenas um ficheiro por janela de cada vez.

O &kwrite; oferece dois modos diferentes, um modo simples com uma interface intuitiva e um modo avançado com mais funcionalidades e itens de menu mais extensos. O modo avançado é activado se assinalar a opção Activar o Modo de Utilizador Experiente (modo do &kde; 3) na página de Aparência da configuração do &kappname;.

## 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 do &kwrite; (atalhos) 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
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?
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 | Comentar
&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

## As Opções do Menu

Existem menus e itens de menu diferentes no modo simples e no avançado. O modo avançado é activado ao assinalar a opção Activar o Modo de Utilizador Experiente (modo do &kde; 3) da página Aparência da configuração do &kappname;.

### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

- Isto inicia um documento novo numa janela de edição nova e independente.

&Ctrl;O Ficheiro Abrir...

- Mostra a janela normal do &kde; para Abrir um Ficheiro. Use a lista de ficheiros para seleccionar o que deseja abrir, carregando depois em Abrir para o abrir.

Ficheiro Abrir um Recente

- Este é um atalho para aceder aos documentos gravados mais recentemente. Se carregar neste item, irá abrir uma lista ao lado do menu, com alguns dos ficheiros gravados mais recentemente. Se carregar num desses ficheiros em particular, abri-lo-á no &kappname; - isto se o ficheiro ainda existir na mesma localização.

&Ctrl;S Ficheiro Gravar

- Isto grava o documento actual. Se já existir uma gravação do documento, esta irá sobrepor o ficheiro já gravado, sem pedir o consentimento ao utilizador. Se for a primeira gravação de um documento, aparecerá então a janela 'Gravar Como' (descrita em baixo).

Ficheiro Gravar Como...

- Isto permite a um documento ser gravado com outro nome. Isto é conseguido através da janela de ficheiros descrita na secção Abrir deste ficheiro de ajuda.

F5 Ficheiro Actualizar

- Carrega de novo o ficheiro activo do disco. Este comando é útil, se outro programa ou processo tiver alterado o ficheiro enquanto o tem aberto no &kappname;.

&Ctrl;P Ficheiro Imprimir...

- Abre uma única janela de impressão que permite ao utilizador indicar o quê, onde e como imprimir.

Ficheiro Exportar como HTML

- Exporta o seu ficheiro para o formato &HTML;, para que o documento possa ser visto como uma página Web. Este item só fica visível quando o 'plugin' de Exportação estiver carregado.

&Ctrl;W Ficheiro Fechar

- Fecha o ficheiro activo com este comando. Se tiver feito alterações por gravar, será avisado para gravar o ficheiro antes de o &kappname; o fechar.

&Ctrl;Q Ficheiro Sair

- Isto irá fechar a janela do editor; se tiver mais do que uma instância do &kappname; a correr, através dos itens de menu Nova ou Nova Janela, essas instâncias não serão fechadas.

### O Menu Editar

&Ctrl;Z Editar Desfazer

- Isto é usado para eliminar ou anular a acção ou operação mais recente por parte do utilizador.

&Ctrl;&Shift;Z Editar Refazer

- Isto irá repor a última alteração (se houver alguma) que foi anulada pelo Desfazer

&Ctrl;X Editar Cortar

- Este comando apaga a selecção actual e coloca-a na área de transferência. A área de transferência é uma funcionalidade do &kde; que funciona de forma invisível para oferecer uma forma de transferir os dados entre as aplicações.

&Ctrl;C Editar Copiar

- Isto copia o texto seleccionado no momento para a área de transferência, de modo a poder ser colado noutro local. A área de transferência é uma funcionalidade do &kde; que funciona de forma invisível para oferecer uma forma de transferir os dados entre as aplicações.

&Ctrl;V Editar Colar

- Isto irá inserir o conteúdo da área de transferência na posição do cursor. A área de transferência é uma funcionalidade do &kde; que funciona, de forma invisível, para oferecer uma forma de transferir os dados entre as aplicações.

Editar Copiar como HTML

- Copia o texto seleccionado para a área de transferência como &HTML;. Esta opção só aparece quando o 'plugin' de Exportação estiver carregado.

&Ctrl;A Editar Seleccionar Tudo

- Isto irá seleccionar o documento por inteiro. Tal poderá ser muito útil para copiar o ficheiro inteiro para outra aplicação.

&Ctrl;&Shift;A Editar Deseleccionar

- Retira a selecção de texto no editor, se existir.

&Ctrl;&Shift;B Editar Modo de Selecção em Bloco (Modo de utilizador experiente)

- Activa ou desactiva o Modo de Selecção. Quando o Modo de Selecção for BLOCO, poderá fazer selecções verticais, ⪚ seleccionar as colunas 5 a 10 nas linhas 9 a 15. A barra de estado mostra a informação sobre o Modo de Selecção, como LINHA ou BLOCO.

Meta&Ctrl;V Editar Modo de Entrada VI (Modo de utilizador experiente)

- Muda para um modo, semelhante ao VI, de edição modal. Este modo os comandos e sequências mais usadas nos modos normal e visual do 'vim', tendo uma barra de estado opcional do modo VI. Esta barra de estado mostra os comandos, à medida que vão sendo introduzidos, o resultado dos comandos e o modo actual. O comportamento deste modo poderá ser configurado na secção Modo de Entrada VI da página de Edição, na janela de configuração do &kappname;.

Ins Editar Modo de Sobreposição

- Activa ou desactiva os modos de Inserção/Sobreposição. Quando o modo for o INS, poderá inserir caracteres no local onde se encontra o cursor. Quando o modo for o SOB, os caracteres introduzidos irão substituir os caracteres actuais, se o seu cursor tiver texto a seguir a ele. A barra de estado mostra a informação sobre o Modo de Sobreposição como INS ou SOB.

&Ctrl;F Editar Procurar...

- Isto abre a barra de pesquisa incremental no fundo da janela do editor. Do lado esquerdo da barra, existe um ícone para fechar a barra, seguido de um pequeno campo de texto para introduzir o padrão a pesquisar.

  Quando começar a introduzir caracteres no seu padrão de pesquisa, esta começa imediatamente. Se existir uma ocorrência no texto, esta fica realçada e a cor de fundo do campo muda para verde-claro. Se o padrão de pesquisa não corresponder a nenhum texto, isto é indicado por uma cor de fundo vermelha-clara no campo e com uma mensagem Não encontrado do lado direito da barra.

  Use o botão Seguinte ou Anterior para saltar para a ocorrência anterior ou seguinte no documento.

  Poderá escolher aqui se a pesquisa faz a distinção entre minúsculas e maiúsculas ou não. Se seleccionar a opção Corresponder à Capitalização, irá limitar as pesquisas para os itens que correspondam à capitalização (maiúsculas ou minúsculas) de cada um dos caracteres do padrão de pesquisa.

  Carregue no ícone da seta verde, à direita da barra de pesquisa incremental, para mudar para a barra mais poderosa de pesquisa e substituição.

F3 Editar Procurar o Seguinte

- Isto repete a última operação de procura, se ocorreu alguma, sem chamar a janela de procura incremental.

&Shift;F3 Editar Procurar Anterior

- Isto repete a última operação de procura, se ocorreu alguma, sem chamar a janela de procura incremental, efectuando a procura para trás em vez de o fazer para a frente no documento.

&Ctrl;R Editar Substituir...

- Este comando abre a barra avançada de pesquisa e substituição. No lado superior esquerdo da barra, existe um ícone para fechar a barra, seguido de um pequeno campo de texto para introduzir o padrão a pesquisar.

  Pode controlar o modo de pesquisa ao seleccionar as opções Texto simples, Palavras completas, Sequências de escape ou Expressão regular na lista.

  Se as Sequências de escape ou a Expressão regular estiverem seleccionadas, o item Adicionar..., no fundo do menu de contexto das áreas de texto, irá ficar activo, permitindo assim que adicione sequências de escape ou itens de expressões regulares ao padrão de pesquisa e substituição, a partir de listas predefinidas.

  Use o botão Seguinte ou Anterior para saltar para a ocorrência anterior ou seguinte no documento.

  Indique o texto de substituição no campo de texto Substituir e carregue no botão Substituir, para substituir apenas o texto realçado, ou o botão Substituir Tudo para substituir o texto de pesquisa no documento inteiro.

  Poderá modificar o comportamento da pesquisa e da substituição ao seleccionar as diferentes opções no lado direito da barra. Se seleccionar a opção Distinguir a capitalização irá limitar as pesquisas apenas aos itens com capitalização correspondente (maiúsculas ou minúsculas) para cada um dos caracteres no padrão de pesquisa. A opção Procurar Tudo realça todas as ocorrências no documento. A opção Apenas a selecção irá procurar e substituir apenas dentro do texto seleccionado de momento.

  Carregue no ícone da seta verde, à direita da barra avançada de pesquisa e substituição, para mudar para a barra de pesquisa incremental.

&Ctrl;H Editar Procurar a Selecção

- Procura a ocorrência seguinte do texto seleccionado.

&Ctrl;&Shift;H Editar Procurar a Selecção para Trás

- Procura a ocorrência anterior do texto seleccionado.

&Ctrl;G Editar Ir para a Linha...

- Isto abre a janela de salto para uma linha em particular (indicada por um número) no documento. O número da linha poderá ser indicado directamente no campo de texto ou de forma gráfica, carregando nos botões com as setas para cima e para baixo ao lado do campo de texto. A pequena seta para cima irá aumentar o número de linha, enquanto que a outra decrementa o mesmo número de linha. Existe também uma barra deslizante à direita do campo de texto que permite ao utilizador mover-se de uma forma análoga no documento.

### O menu Ver

O menu Ver permite-lhe gerir a configuração específica do editor activo, bem como a gestão das sub-janelas.

Ver Nova Janela

- Cria outra janela que contém o documento actual. Todas as alterações ao documento de uma janela serão reflectidos na outra janela e vice-versa.

F7 Ver Mudar para a Linha de Comandos (Modo de utilizador experiente)

- Mostra a linha de comandos da componente do Kate no fundo da janela. Na linha de comandos, escreva `help` para obter ajuda e `help list` para obter uma lista de comandos.

Ver Esquema (Modo de utilizador experiente)

- Selecciona um esquema de tipos de letra.

F10 Ver Mudança de Linha Dinâmica

- As linhas de texto serão repartidas ao atingir o limite da janela.

Ver Indicadores de Mudança de Linha Dinâmica (Modo de utilizador experiente)

- Escolhe se e quando deverão ser mostrados os indicadores de mudança de linha. Isto só fica disponível se a opção Mudança de Linha Dinâmica estiver assinalada.

Ver Mostrar o Indicador de Mudança de Linha Estática (Modo de utilizador experiente)

- Se esta opção estiver assinalada, será desenhada uma linha vertical na coluna de mudança de linha, como está definido na opção Configuração Configurar o Editor... na página de Edição. Lembre-se que o marcador de mudança de linha só é desenhado se usar um tipo de letra monoespaçado.

F6 Ver Mostrar o Contorno do Ícone (Modo de utilizador experiente)

- Isto é um item de comutação. Se o ligar, irá activar o Contorno de Ícones do lado esquerdo do editor activo, e vice-versa.

F11 Ver Mostrar os Números de Linha

- Isto é um item de comutação. Se o ligar, irá aparecer uma área que mostra os números de linha do documento visível à esquerda e vice-versa.

Ver Mostrar as Marcas da Barra de Posicionamento (Modo de utilizador experiente)

- Se esta opção estiver assinalada, a janela irá mostrar algumas marcas na barra de posicionamento vertical.

F9 Mostrar as Marcações de Dobragem (Modo de utilizador experiente)

- Se esta opção estiver assinalada, as marcas de desdobramento do código ficarão escondidas.

Dobragem de Código (Modo de utilizador experiente)

- &Ctrl; &Shift;- Fechar o Nível de Topo

- Recolhe todas as regiões de topo do documento.

&Ctrl; &Shift;+ Expandir o Nível de Topo

- Expande todas as regiões de topo do documento.

&Ctrl; - Fechar um Nível Local

- Recolhe a região mais próxima do cursor.

&Ctrl; + Expandir um Nível Local

- Expande a região mais próxima do cursor.

Aumentar o Tipo de Letra

- Isto aumenta o tamanho da letra usado.

Diminuir o Tipo de Letra

- Isto diminui o tamanho da letra usado.

### O Menu Favoritos

Este menu só aparece se assinalar a opção Activar o Modo de Utilizador Experiente (modo do &kde; 3) na página de Aparência da configuração do &kappname;.

&Ctrl;B Favoritos Comutar o Favorito

- Activa ou remove um favorito na linha actual do documento activo (Se já existir, é removido, caso contrário é colocado).

Favoritos Limpar Todos os Favoritos

- Este comando irá remover todas as marcações do documento, assim como a lista de marcações que está no fim deste item do menu.

&Alt; Page Up Favoritos Anterior

- Isto irá mover o cursor para o início da linha imediatamente acima que contiver um favorito. O texto do item do menu irá incluir o número da linha e o primeiro pedaço de texto da linha. Este item só está disponível quando houver um favorito numa linha acima do cursor.

&Alt; Page Down Favoritos Seguinte

- Isto irá mover o cursor para o início da linha imediatamente abaixo que contiver um favorito. O texto do item do menu irá incluir o número da linha e o primeiro pedaço de texto da linha. Este item só está disponível quando houver um favorito numa linha acima do cursor.

No fundo deste menu, tal como se disse, existe uma lista de marcações para esta janela, se foram previamente atribuídas.

### O Menu Ferramentas

Ferramentas Modo Apenas de Leitura

- Configura o documento actual no modo Apenas para Leitura. Isto evita que seja adicionado qualquer texto ou formatação do documento.

Ferramentas Modo (Modo de utilizador experiente)

- Escolhe o esquema de tipo de ficheiros que preferir para o documento activo. Isto substitui o modo de tipo de ficheiros global definido na opção Configuração Configurar o Editor... na página de Tipos de Ficheiros, somente para o seu documento.

Ferramentas Realce (Modo de utilizador experiente)

- Escolhe o esquema de realce de sintaxe que preferir para o documento activo. Isto substitui o modo de realce global definido na opção Configuração Configurar o Editor..., somente para o seu documento.

Ferramentas Indentação (Modo de utilizador experiente)

- Escolhe o estilo de indentação que preferir para o documento activo. Isto substitui o modo de indentação global definido na opção Configuração Configurar o Editor..., somente para o seu documento.

Ferramentas Codificação

- Poderá sobrepor a codificação predefinida na opção Configuração Configurar o Editor..., na página Abrir/Gravar, para definir uma codificação diferente para o seu documento actual. A codificação que definir aqui será válida apenas para o seu documento actual.

Ferramentas Fim de Linha (Modo de utilizador experiente)

- Escolhe o modo de fim de linha que preferir para o documento activo. Isto substitui o modo de fim de linha global definido na opção Configuração Configurar o Editor..., somente para o seu documento.

Ferramentas Adicionar o Marcador da Ordem de 'Bytes' (MOB)

- Se assinalar esta opção, poderá adicionar explicitamente um marcador de ordem dos 'bytes' para os documentos codificados em Unicode. O marcador da ordem de 'bytes' é um carácter em Unicode que é usado para assinalar a ordem dos 'bytes' ('endianness') de um ficheiro ou sequência de texto. Para mais informações, veja o Marcador da Ordem de 'Bytes'.

&Ctrl;Espaço Ferramentas Invocar a Completação de Código (Modo de utilizador experiente)

- Invoca manualmente a completação de comandos, normalmente através de um atalho de teclado associado a esta acção.

Ferramentas Completação de Palavras (Modo de utilizador experiente)

- As opções Reutilizar a Palavra Abaixo (&Ctrl; 9) e Reutilizar a Palavra Acima (&Ctrl; 8) terminam o texto escrito de momento, procurando por palavras semelhantes antes ou depois da posição actual do cursor. A Completação por Linha de Comandos mostra uma janela com os itens correspondentes.

&Ctrl;&Shift;O Ferramentas Verificação Ortográfica Automática

- Quando a Verificação Ortográfica Automática estiver activa, o texto errado será sublinhado no texto imediatamente.

Ferramentas Ortografia...

- Isto inicia o programa de verificação ortográfica - um programa que é desenhado para ajudar o utilizador a descobrir e a corrigir os erros ortográficos. Ao carregar nesta opção, irá iniciar o verificador ortográfico e trazer a janela com o suporte ortográfico. Existem quatro campos alinhados verticalmente no centro da janela com as suas legendas correspondentes à sua esquerda. A começar por cima, estas são:

  Palavra desconhecida:

- Aqui, o verificador ortográfico indica a palavra sob consideração neste momento. Isto acontece quando o verificador ortográfico encontra uma palavra que não se encontra no seu dicionário - um ficheiro que contém uma lista com as palavras correctas com as quais compara cada palavra no editor.

Substituir por:

- Se o verificador ortográfico encontrar alguma palavra semelhante no seu dicionário, é listada aqui a primeira. O utilizador poderá aceitar a sugestão, escrever a sua própria correcção ou escolher uma sugestão diferente na próxima lista.

Língua:

- Se tiver instalado vários dicionários, aqui poderá seleccionar qual o dicionário/língua que deverá ser usado.

Do lado direito da janela, existem 6 botões que permitem ao utilizador controlar o processo de verificação ortográfica. São estes:

Adicionar ao Dicionário

- Se carregar neste botão, irá adicionar a palavra no campo Palavra desconhecida ao dicionário do corrector. Isto significa que, no futuro, o verificador ortográfico irá considerar sempre esta palavra como correcta.

Sugerir

- O verificador poderá enumerar aqui uma quantidade de substituições possíveis para a palavra em consideração. Se carregar em alguma das sugestões, fará com que a mesma seja introduzida no campo Substituir por em cima.

Substituir

- Este botão faz com que o corrector substitua a palavra em consideração no documento pela palavra no campo Substituir por.

Substituir Tudo

- Este botão faz com que o corrector não só substitua a Palavra desconhecida: actual, mas também faça a mesma substituição para todas as outras ocorrências desta Palavra desconhecida no documento.

Ignorar

- Ao activar este botão, fará com que o verificador ortográfico siga em frente, sem efectuar quaisquer alterações.

Ignorar Tudo

- Este botão diz ao corrector ortográfico para não fazer nada com a Palavra desconhecida: actual e para seguir em frente com todas as instâncias da mesma palavra.

  Isto só se aplica a esta ronda de verificação ortográfica. Se o verificador for executado de novo, mais tarde, irá parar na mesma palavra.

Existem mais três botões por baixo da janela de verificação ortográfica. Estes são:

Ajuda

- Este invoca o sistema de ajuda do &kde;, tendo como base a página de ajuda desta janela.

Terminado

- Este botão cancela o processo de verificação ortográfica e volta para o documento.

Cancelar

- Este botão cancela o processo de verificação ortográfica; todas as modificações são anuladas e você irá voltar ao seu documento.

Ferramentas Verificação Ortográfica (do cursor)...

- Isto inicia o programa de verificação ortográfica, mas inicia a partir do cursor, em vez de começar no início do documento.

Ferramentas Verificação Ortográfica da Selecção...

- Faz uma verificação ortográfica da selecção actual.

Ferramentas Mudar o Dicionário

- Mostra uma lista com todos os dicionários disponíveis para verificação ortográfica no fundo da janela de edição. Isto permite a mudança rápida do dicionário de verificação ortográfica, ⪚ para a verificação automática do texto em várias línguas.

&Ctrl;I Ferramentas Indentar

- Isto aumenta a indentação do parágrafo em um passo. O tamanho do passo depende da configuração da indentação.

&Ctrl;&Shift;I Ferramentas Desindentar

- Isto reduz a indentação do parágrafo em um passo. O tamanho do passo depende da configuração da indentação.

Ferramentas Limpar a Indentação

- Isto limpa a indentação da selecção actual ou da linha onde o cursor se encontra. Se limpar a indentação, garante que todo o seu texto seleccionado segue o modo de indentação que escolher.

Ferramentas Alinhamento

- Faz um novo alinhamento da linha actual ou das linhas seleccionadas, usando o modo de indentação e a configuração de indentação no documento.

&Ctrl;D Ferramentas Comentar(Modo de utilizador experiente)

- Isto adiciona mais um espaço ao início da linha onde o cursor de texto se encontra ou ao início das linhas seleccionadas.

&Ctrl;&Shift;D Ferramentas Descomentar (Modo de utilizador experiente)

- Isto remove um espaço (se existir) ao início da linha onde o cursor se encontra ou ao início das linhas seleccionadas.

&Ctrl;U Ferramentas Maiúsculas

- Coloca o texto seleccionado ou a letra a seguir ao cursor em maiúsculas.

&Ctrl;&Shift;U Ferramentas Minúsculas

- Coloca o texto seleccionado ou a letra a seguir ao cursor em minúsculas.

&Ctrl;&Alt;U Ferramentas Capitalização

- Capitaliza (coloca a primeira letra em maiúsculas e as restantes em minúsculas) o texto seleccionado ou a palavra actual.

&Ctrl;J Ferramentas Juntar as Linhas

- Junta as linhas seleccionadas, ou a linha actual e a seguinte, separando-as apenas com um espaço. Os espaços finais/iniciais das linhas reunidas são removidas dos extremos colados.

Ferramentas Aplicar a Mudança de Linha

- Aplica uma mudança de linha estática em todo o documento. Isto significa que uma linha nova de texto irá iniciar automaticamente, quando a linha actual exceder o tamanho definido na opção Mudar de Linha em da página de Edição em Configuração Configurar o Editor...

Se o 'plugin' para Inserir um Ficheiro estiver activo, irá encontrar aqui um item de menu adicional Inserir um Ficheiro....

### O Menu Configuração

Configuração Mostrar a Barra de Estado

- Se estiver assinalada, esta opção mostra uma pequena barra no fundo do editor que contém a informação sobre o estado do documento actual. Quando estiver desligada, a barra de estado estará escondida.

Configuração Mostrar a Barra de Ferramentas

- Se estiver assinalada, esta opção mostra uma barra amovível que contém os botões usados para desencadear os comandos mais usados. Quando estiver desligada, a barra de ferramentas estará escondida.

Configuração Mostrar a Localização

- Quando estiver seleccionada, esta opção mostra na barra de título a localização no sistema de ficheiros do documento actual. Se não estiver, a localização ficará escondida.

Configuração Configurar o Editor...

- Este menu abre uma janela onde as várias opções poderão ser ajustadas.

Configuração Configurar os Atalhos...

- Este comando abre uma janela onde poderá alterar os atalhos. Aparecerá uma janela com a lista dos comandos (acções) e as suas combinações de teclas associadas, as alternativas e as globais. O campo Procurar, por cima da lista, é usada para filtrar a lista de atalhos. Se seleccionar uma acção com o &LMB; (pelo seu nome ou pelo seu atalho de teclado predefinido ou alternativo, irão aparecer as opções Predefinição e Personalizado por baixo da acção seleccionada.

  Para atribuir ou alterar um atalho, carregue no botão Nenhum. O seu texto muda então para Entrada, onde poderá carregar na nova combinação de teclas da acção.

  Por exemplo, com a acção Acerca do &kde; seleccionada na janela, carregue nas teclas &Ctrl;, &Alt; e K do teclado. Isto significa que sempre que pressionar nas teclas &Ctrl; e &Alt;, seguidas da tecla K (ao usar o &kappname;), irá invocar a janela Acerca do &kde;.

  Use os botões no fundo da janela para voltar a colocar todos os atalhos com os seus valores predefinidos, para imprimir a lista de atalhos ou cancelar todas as alterações. Carregue no botão OK para fechar a janela e aceitar todas as alterações.

Configuração Configurar as Barras de Ferramentas...

- Isto irá abrir a janela onde se poderá alterar a configuração da barra de ferramentas. O utilizador poderá escolher quais os botões de atalho que deverão aparecer nessa barra de ferramentas. A área à esquerda mostra os comandos disponíveis para serem colocados na barra de ferramentas. A lista à direita mostra os comandos que já estão na barra de ferramentas. Existe um conjunto de quatro botões com setas entre as duas listas para manipular as selecções. A seta para a direita coloca o comando seleccionado na lista à esquerda na lista direita, i.e., adiciona-o à barra de ferramentas. A seta à esquerda faz o oposto, ou seja, remove a acção seleccionada à direita na barra de ferramentas. As setas para cima e para baixo mudam a posição de uma acção seleccionada do lado direito, o que irá mudar a posição do seu botão na barra de ferramentas.

### O Menu Ajuda

&help.menu.documentation;

## Configurar o &kappname;

A selecção do Configuração Configurar o Editor..., a partir do menu, provoca o aparecimento da janela para Configurar o Editor. Esta janela pode ser usada para alterar algumas das várias opções existentes. As opções disponíveis para alteração podem variar de acordo com a categoria que o utilizador selecciona, numa lista vertical do lado esquerdo da janela. Recorrendo a três botões na parte inferior da janela, o utilizador poderá controlar o processo.

O utilizador pode invocar o sistema de Ajuda, aceitar a configuração actual e fechar a janela, através do botão OK ou Cancelar o processo. As categorias Aparência, Tipos de Letra & Cores Edição, Abrir/Gravar, Atalhos e Extensões são detalhadas em baixo.

### Aparência

Mudança de Linha

- Mudança de Linha Dinâmica

- Se esta opção estiver assinalada, as linhas de texto serão repartidas no contorno da janela no ecrã.

Indicadores de mudança de linha dinâmica (se aplicável)

- Escolha se deseja mostrar os indicadores de mudança de linha dinâmica.

Alinhar as mudanças de linha dinâmicas à profundidade de indentação:

- Activa o início das linhas repartidas com mudanças de linha dinâmicas, de modo a ficarem alinhadas na vertical com o nível de indentação da primeira linha. Isto poderá ajudar a tornar o código e a formatação mais legíveis.

  Para além disso, isto permite-lhe definir uma largura máxima do ecrã, como percentagem, após a qual as linhas repartidas de forma dinâmica não serão mais alinhadas na vertical. Por exemplo, a 50%, as linhas cujos níveis de indentação sejam mais profundas que 50% da largura do ecrã não terão qualquer alinhamento vertical aplicado às linhas repartidas subsequentes.

Contornos

- Mostrar as marcações de dobragem (se disponíveis)

- Se esta opção estiver assinalada, a janela actual irá mostrar marcações para dobrar ou desdobrar o código, se este estiver disponível.

Mostrar o contorno dos ícones

- Se esta opção estiver assinalada, irá ver um contorno para os ícones do lado esquerdo. O contorno dos ícones mostra os sinais de favoritos, por exemplo.

Mostrar os números de linha

- Se esta opção estiver assinalada, irá ver os números das linhas do lado esquerdo.

Mostrar as marcações na barra de posicionamento

- Se esta opção estiver assinalada, a janela actual irá mostrar algumas marcas na barra de posicionamento vertical. Estas marcas, por exemplo, poderão mostrar os favoritos.

Ordenar o Menu de Favoritos

- Estas opções só aparecem se a opção Activar o Modo de Utilizador Experiente (modo do &kde; 3) estiver assinalado na secção seguinte.

  Por posição

- Os favoritos serão ordenados de acordo com os números de linha onde se encontram.

Por criação

- Cada novo favorito será adicionado no fim, independentemente de onde se encontra colocado no documento.

Avançado

- Activar o modo de utilizador experiente (modo do &kde; 3)

- Alterna entre o modo simples e o avançado. A alteração deste modo apenas afecta os documentos abertos de novo ou criados. No &kappname;, recomenda-se que o reinicie.

Mostrar as linhas de indentação

- Se esta opção estiver assinalada, o editor irá mostrar linhas verticais para ajudar a identificar as linhas de indentação.

Realçar o intervalo entre os parêntesis seleccionados

- Se esta opção estiver activa, o intervalo entre os parêntesis seleccionados será realçado.

### Tipos de Letra & Cores

Esta secção da janela permite-lhe configurar todos os tipos de letra e cores de qualquer esquema de cores que tiver, assim como criar esquemas novos ou remover os existentes. Cada esquema tem a configuração das cores, tipos de letra e estilos do texto normal e seleccionado.

O &kappname; irá seleccionar previamente o esquema activo de momento para si; se quiser trabalhar num esquema diferente, comece por seleccioná-lo na lista Esquema. Com os botões Novo e Apagar, poderá criar um esquema novo ou apagar os existentes.

No fundo da página, poderá seleccionar o Esquema por omissão para o &kappname;.

#### Cores

Fundo da Área de Texto

- Texto normal

- Este é o fundo por omissão para a área de edição, sendo a cor dominante da área do editor.

Texto seleccionado

- Este é o fundo do texto seleccionado. O valor por omissão é a cor global de selecção, como está definida nas preferências de cores do &kde;.

Linha actual

- Define a cor da linha actual. Se configurar esta como um pouco diferente do fundo do Texto Normal, ajudá-lo-á a concentrar-se na linha actual.

Favorito

- Esta lista permite-lhe sobrepor as cores dos vários tipos de marcações. A cor é misturada com a cor de fundo de uma linha marcada, para que uma linha com mais marcas ou a linha actual tenha um fundo que seja uma mistura de mais cores. As cores das marcações são também usadas se activar a visualização das marcas na barra de posicionamento.

Elementos Adicionais

- Fundo do contorno esquerdo

- Esta cor é usada para as marcas, números de linhas e contornos das marcações de desdobramento do lado esquerdo da janela de edição, quando forem apresentados.

Números de linha

- Esta cor é usada para desenhar os números de linha do lado esquerdo da janela, quando estiverem visíveis.

Parêntesis realçado

- Esta cor é usada para desenhar o fundo dos parêntesis correspondentes.

Marcações de mudanças de linha

- Esta cor é usada para desenhar um padrão à esquerda das linhas repartidas com mudança de linha, quando estiverem alinhadas na vertical, assim como para as marcações de mudanças de linha estáticas.

Marcações de tabulações e espaços

- Esta cor é usada para desenhar os indicadores de espaços em branco, quando estiverem activos.

Linha com erro ortográfico

- define a cor da linha que é usada para indicar erros ortográficos.

#### Tipos de Letra

Aqui, o utilizador poderá escolher o tipo de letra por omissão para o &kwrite;. Pode escolher qualquer tipo de letra disponível no seu sistema, assim como definir um tamanho por omissão e uma codificação. Um texto de exemplo aparecerá na parte inferior da janela, para que possa ver o efeito das suas opções.

#### Estilos de Texto Normal

Os estilos de texto normal são herdados pelos estilos de texto realçados, permitindo ao editor apresentar o texto de forma bastante consistente; por exemplo, o texto do comentário usa o mesmo estilo em quase todos os formatos de texto que o &kappname; consegue realçar.

O nome na lista de estilos está a usar o estilo configurado para o item, oferecendo-lhe uma antevisão imediata ao configurar um estilo.

Cada estilo permite-lhe seleccionar atributos comuns, assim como as cores do texto e do fundo. Para retirar uma cor de fundo, carregue com o botão direito para usar o menu de contexto.

#### Estilos de Texto Realçado

Aqui poderá editar os estilos de texto usados por uma definição de realce específica. O editor selecciona previamente o realce usado pelo seu documento actual. Para funcionar com um realce diferente, seleccione um na lista Realce, por cima da lista de estilos.

O nome na lista de estilos está a usar o estilo configurado para o item, oferecendo-lhe uma antevisão imediata ao configurar um estilo.

Cada estilo permite-lhe seleccionar os atributos comuns, assim como as cores de fundo e do texto. Para retirar uma cor de fundo, carregue com o botão direito para usar o menu de contexto. Para além disso, poderá verificar se um estilo é igual ao predefinido que for usado para o item, e configurá-lo como tal, se não estiver.

Irá reparar que vários realces contêm outros realces, representados por grupos na lista de estilos. Por exemplo, a maioria dos realces implementam o realce Alert (Alerta) e muitos formatos de código importam o realce do Doxygen. A edição das cores destes grupos só irá afectar os estilos se forem usados no formato de realce editado.

### Edição

#### Geral

Tabulações

- Inserir espaços em vez de tabulações

- Quando isto estiver activo, o editor irá inserir um número calculado de espaços, de acordo com a posição no texto e a configuração `tab-width`, quando carregar na tecla .

Realçar as tabulações

- Quando esta opção estiver activa, o &kappname; irá mostrar um pequeno ponto como representação visual das tabulações.

  Isto faz também com que os pontos sejam desenhados para indicar os espaços em branco finais. Isto será corrigido numa futura versão do &kappname;

Tabulação

- Se a opção Inserir espaços em vez de tabulações estiver seleccionada, este campo determina o número de espaços pelo qual o editor irá substituir automaticamente as tabulações.

Mudança de Linha Estática

- A mudança de linha é uma funcionalidade que faz com que o editor inicie automaticamente uma linha de texto e mova (mude) o cursor para o início dessa nova linha. O &kappname; irá iniciar automaticamente uma nova linha de texto sempre que a linha actual atingir o tamanho indicado pela opção Mudar Palavras Em:.

  Activar a mudança de linha estática

- Activa ou desactiva a mudança de linha estática.

Mostrar os marcadores de mudança de linha estática (se aplicável)

- Se esta opção estiver assinalada, será desenhada uma linha vertical na coluna de mudança de linha, como está definido na opção Configuração Configurar o Editor... na página de Edição. Lembre-se que o marcador de mudança de linha só é desenhado se usar um tipo de letra monoespaçado.

Mudar de linha em:

- Se a opção Activar a mudança de linha estática estiver seleccionada, este campo determina o tamanho (em caracteres) a partir do qual o editor irá iniciar automaticamente uma nova linha.

Diversos

- Remover os espaços finais

- O &kappname; irá eliminar automaticamente os espaços extra no fim das linhas de texto.

Realçar os espaços finais

- O &kappname; irá realçar os espaços extra no fim das linhas de texto.

Parêntesis automáticos

- Quando um utilizador escrever um parêntesis esquerdo ([, ( ou {), o &kappname; introduz automaticamente o parêntesis direito (}, ) ou ]) à direita do cursor.

Copiar/cortar a linha actual se não existir selecção

- Se esta opção estiver activa e se a selecção de texto estiver vazia, as acções de cópia e corte são efectuadas para a linha de texto na posição actual do cursor.

Permitir o deslocamento após o fim do documento

- Esta opção permite-lhe deslocar para lá do fim do documento. Isto poderá ser usado para centrar na vertical o fundo do documento, ou para o colocar no topo da janela actual.

#### Cursor & Selecção

Movimento do Cursor de Texto

- Início e fim inteligentes

- Quando estiver seleccionado, se carregar na tecla Home, fará com que o cursor salte os espaços em branco e vá para o início do texto de uma linha.

Mudar o cursor de linha

- Quando estiver activada esta opção, se mover o cursor de inserção com as teclas Esquerda e Direita, irá para a linha anterior/seguinte no início/fim da linha, como acontece nos outros editores.

  Quando esta opção for seleccionada, a movimentação do cursor com as teclas dos cursores para além do fim da linha (à direita) faz com que o cursor mude para o início da próxima linha. Do mesmo modo, quando o cursor passar para trás do início de uma linha (à esquerda) salta para o fim da linha anterior. Quando esta linha não estiver seleccionada, a movimentação do cursor para lá do fim da linha simplesmente faz com que esta continue horizontalmente na mesma linha, assim como a movimentação para lá do início da linha não fará nada.

O Page Up/Page Down move o cursor

- Esta opção altera o comportamento do cursor quando o utilizador carrega na teclas Page Up ou na Page Down. Se não estiver seleccionada, o cursor do texto irá manter a sua posição relativa no texto visível do &kappname; à medida que o novo texto se torna visível como resultado da operação. Como tal, se o cursor estiver no meio do texto visível quando a operação ocorrer, irá permanecer nesse local (excepto quando atingir o início ou o fim). Com esta opção seleccionada, ao carregar na primeira tecla fará com que o cursor de mova tanto para o topo como para o fundo do texto visível à medida que é mostrada uma nova página de texto.

Auto-centrar o cursor (linhas):

- Indica o número de linhas a manter visível acima e abaixo do cursor, sempre que possível.

Modo de Selecção do Texto

- Normal

- As selecções serão substituídas pelo texto escrito e perder-se-ão com o movimento do cursor.

Persistente

- As selecções manter-se-ão mesmo com a introdução de texto e a movimentação do cursor.

#### Indentação

Modo de indentação por omissão:

- Seleccione o modo de indentação automático que desejar usar por omissão. Recomenda-se que use o `Nenhum` ou o `Normal` aqui e use as configurações do tipo de ficheiro para definir outros modos de indentação para os formatos de texto, como o código em C/C++ ou o &XML;.

Propriedades de Indentação

- Largura de indentação:

- A largura de indentação é o número de espaços usado para indentar uma linha. Se a opção Inserir espaços em vez de tabulações, na página Geral em Edição, estiver desactivada, será inserido um carácter se a indentação for divisível pela largura da tabulação.

Manter Espaços Extra

- Se esta opção estiver desactivada, a alteração do nível de indentação alinha uma linha a um múltiplo da largura definida em Largura da indentação.

Ajustar a indentação do código colado da área de transferência

- Se esta opção for seleccionada, o código colado da área de transferência será indentado. A execução da acção Desfazer irá remover a indentação.

Acções de Indentação

- A tecla Backspace nos espaços iniciais remove a indentação

- Se esta opção for seleccionada, a tecla &Backspace; diminui o nível de indentação se o cursor estiver localizado no espaço em branco inicial de uma linha.

Acção da tecla Tab (se não existir selecção)

- Se quiser que o alinhe a linha actual no bloco de código actual, como acontece no Emacs, torne o um atalho para a acção Alinhar.

  Avançar sempre para a tabulação seguinte

- Se esta opção for seleccionada, a tecla introduz sempre espaços em branco até atingir a posição da tabulação seguinte. Se a opção Inserir espaços em vez de tabulações, na página Geral em Edição estiver activa, são inseridos espaços; caso contrário, é inserida uma única tabulação.

Aumentar sempre o nível de indentação

- Se esta opção for seleccionada, a tecla indenta sempre a linha actual de acordo com o número de posições de caracteres indicada na Largura da indentação.

Aumentar o nível de indentação se estiver num espaço em branco inicial

- Se esta opção estiver assinalada, a tecla indenta a linha actual ou avança para a próxima posição de tabulação. Se o ponto de inserção estiver sobre ou antes do primeiro carácter sem ser espaço da linha, ou se existir algo seleccionado, a linha actual é indentada pelo número de posições de caracteres indicada em Largura de indentação. Se o ponto de inserção estiver a seguir ao primeiro carácter não-espaço e não tiver nada seleccionado, são inseridos espaços em branco até atingir a próxima posição de tabulação: se a opção Inserir espaços em vez de tabulações da página Geral em Edição estiver activa, são inseridos espaços; caso contrário, é inserida uma única tabulação.

#### Completação Automática

Geral

- Completação automática activa

- Se estiver activo, aparece um campo de completação automática, a mostrar uma lista com os itens de texto para completar o texto actual sob o cursor.

Tamanho mínimo da palavra para completar

- Ao escrever o texto, a completação de palavras procura pelas mesmas no documento, a começar pelo texto já escrito. Esta opção configura a quantidade mínima de caracteres que são necessários para tornar a completação de palavras activa e para mostrar uma área de completação.

#### Modo de Entrada VI

Geral

- Usar o modo de introdução de dados como no VI

- Quando a opção estiver seleccionada, o modo de introdução de dados à 'vi' será activado, quando activar uma janela nova. Poderá à mesma activar/desactivar o modo de entrada VI, para uma dada janela, no menu Editar.

Permitir aos comandos do VI substituir os atalhos do Kate

- Quando a opção estiver seleccionada, os comandos do 'vi' irão substituir os comandos incorporados do &kate;. Por exemplo: o &Ctrl;R irá refazer, substituindo a acção-padrão (mostrar a janela de pesquisa e substituição).

Esconder a barra de estado do modo VI

- Por omissão, será usada uma barra de estado extra quando o modo de entrada do VI estiver activo. Esta barra de estado mostra os comandos, enquanto vão sendo escritos, e as mensagens/erros produzidos pelos comandos do VI.

  Se assinalar esta opção, irá esconder esta barra de estado extra.

Associação de Teclas

- A associação de teclas é usada para alterar o significado das teclas pressionadas. Isto permite-lhe mover os comandos para outras teclas ou criar sequências de teclas especiais para fazer uma dada série de comandos.

  Exemplo:

  F2 -> I-- &Esc;

  Isto irá anteceder o I-- com uma linha, ao carregar em F2.

#### Verificação Ortográfica

Estas opções de configuração estão descrita na documentação do módulo do &systemsettings; sobre Verificação Ortográfica.

### Abrir/Gravar

#### Geral

Formato do Ficheiro

- Codificação:

- Isto define a codificação normal a usar para abrir/gravar os ficheiros, caso não seja alterado na janela para abrir/gravar ou na opção da linha de comandos.

Detecção da Codificação

- Seleccione um item na lista, quer para desactivar a detecção automática como para usar a Universal, de modo a activar a detecção automática para todas as codificações. Contudo, como isto provavelmente só irá detectar o UTF-8/UTF-16, se seleccionar uma região irá usar heurísticas personalizadas para melhores resultados. Se nem a codificação escolhida acima, nem a codificação indicada na janela para abrir/gravar, nem a codificação indicada na linha de comandos corresponderem ao conteúdo do ficheiro, será executada esta detecção.

Codificação Alternativa

- Isto define a codificação alternativa para tentar abrir os ficheiros, caso a codificação escolhida acima, a codificação indicada na janela para abrir/gravar ou a codificação indicada na linha de comandos não correspondam ao conteúdo do ficheiro. Antes de tentar usar esta, será feita uma tentativa para determinar a codificação a usar, procurando um marcador de ordem de 'bytes' no início do ficheiro: se este for encontrado, será usada a codificação Unicode correcta; caso contrário, tentar-se-á a detecção da codificação; se ambos falharem, será tentada a codificação alternativa.

Fim da linha:

- Escolha o seu fim de linha preferido para o seu documento activo. Terá a opção entre o &UNIX;, DOS/&Windows; ou o Macintosh.

Detecção automática do fim da linha

- Assinale isto se quiser que o editor detecte automaticamente o tipo do fim da linha. O primeiro tipo encontrado será o usado para o ficheiro completo.

Activar o marcador da ordem de 'bytes'

- O marcador da ordem dos 'bytes' é uma sequência especial no início dos documentos codificados em Unicode. Ajuda os editores a abrir os documentos de texto com a codificação Unicode correcta. Para mais informações, veja o Marcador da Ordem de 'Bytes'.

Limpezas Automáticas ao Carregar/Gravar

- Remover os espaços finais

- O editor irá eliminar automaticamente os espaços extra, no fim das linhas de texto, enquanto carrega/grava o ficheiro.

#### Avançado

Ficheiro de Configuração da Pasta

- Profundidade da procura no ficheiro de configuração:

- O editor irá procurar pelo número de níveis de pastas indicado para cima, no ficheiro de configuração do &kappname; e carrega a linha de configuração respectiva. Poderá obter mais informações acerca destes ficheiros de configuração escondidos da pasta no artigo O Ficheiro .kateconfig.

Salvaguardar ao Gravar

- Se criar uma cópia de segurança ao gravar, fará com que o &kappname; copie o ficheiro do disco para <prefixo><nome-ficheiro><sufixo>' antes de gravar as alterações. O sufixo é, por omissão ~ e o prefixo está em branco, por omissão.

  Ficheiros locais

- Assinale isto se quiser cópias de segurança dos ficheiros locais ao gravar.

Ficheiros remotos

- Assinale isto se quiser cópias de segurança dos ficheiros remotos ao gravar.

Prefixo

- Indique o prefixo com que antecede os nomes das cópias de segurança.

Sufixo

- Indique o sufixo com que termina os nomes das cópias de segurança.

#### Modos & Tipos de Ficheiros

Esta página permite-lhe substituir a configuração por omissão dos documentos dos tipos MIME indicados. Quando o editor carregar um documento, irá tentar ver se corresponde às máscaras de ficheiros ou tipos MIME para cada um dos tipos definidos e, se tal se aplicar, aplica as variáveis definidas. Se corresponderem mais tipo de ficheiros, será usado o que tiver maior prioridade.

Tipo de ficheiro:

- O tipo de ficheiro com a maior prioridade é o que será apresentado na primeira lista. Se forem encontrados mais tipos de ficheiros, estes serão também listados.

  Novo

- Isto é usado para criar um novo tipo de ficheiro. Depois de carregar neste botão, os campos abaixo ficam em branco, para que possa preencher as propriedades que deseja para o novo tipo de ficheiro.

Remover

- Para remover um tipo de ficheiro existente, seleccione-o na lista e carregue no botão Apagar.

Propriedades do `tipo de ficheiro actual`

- O tipo de ficheiro com a maior prioridade é o que será apresentado na primeira lista. Se forem encontrados mais tipos de ficheiros, estes serão também listados.

  Nome:

- O nome do tipo de ficheiro será o texto do item de menu correspondente. Este nome é mostrado no item Ferramentas Tipos de Ficheiros

Secção:

- O nome da secção é usado para organizar os tipos de ficheiros em menus. Este também é usado no menu Ferramentas Tipos de Ficheiros .

Variáveis:

- Este texto permite-lhe configurar o &kappname; para os ficheiros seleccionados por este tipo MIME, usando as variáveis do &kappname;. Poderá definir quase todas as opções de configuração, como o 'highlight', 'indent-mode', etc.

  Para uma lista completa das variáveis conhecidas, veja o manual.

Realce:

- Se criar um novo tipo de ficheiro, esta lista permite-lhe seleccionar um tipo de ficheiro para o realce.

Modo de Indentação:

- A lista indica o modo de indentação para os documentos novos.

Extensões dos ficheiros:

- As máscaras com caracteres especiais permitem-lhe seleccionar ficheiros pelo nome. Uma máscara típica usa um asterisco e a extensão do ficheiro, como por exemplo `*.txt; *.text`. O texto é uma lista, separada por pontos-e-vírgulas, de máscaras.

Tipos MIME:

- Mostra um assistente que lhe permite escolher facilmente os tipos MIME.

Prioridade:

- Escolhe a prioridade deste tipo de ficheiro. Se mais que um tipo de ficheiro condizer com um ficheiro, será utilizado o com a prioridade mais elevada.

Obter Ficheiros de Realce...

- Carregue neste botão para transferir descrições de realce de sintaxe novas ou actualizadas na página Web do &kate;.

### Extensões

A página 'Plugins' lista todos os 'plugins' disponíveis e poderá assinalar os que deseja usar. Carregue no botão de Informação para abrir a janela Acerca deste 'plugin'.

Assim que um 'plugin' configurável esteja assinalado, o botão Configurar fica activo para que possa carregar nele, de modo a configurar o 'plugin' realçado.

### 'Plugins' do Componente de Edição

Parêntesis Automáticos

- O 'plugin' de parêntesis automáticos substitui a funcionalidade interna do &kate; para Parêntesis Automáticos. Introduz automaticamente um parêntesis de fecho } no início da próxima linha, depois de terminar uma dada linha com um parêntesis de abertura { e carregar na tecla &Enter;.

Ferramentas de Dados

- Activa as ferramentas de dados, como a verificação gramatical e ortográfica (se estiverem instalados). As ferramentas de dados só ficam disponíveis quando tem texto seleccionado, ou quando o botão direito do rato é carregado sobre uma palavra. Se não existirem ferramentas de dados disponíveis, mesmo quando selecciona algum texto, terá de as instalar. Algumas ferramentas de dados fazem parte do pacote &koffice;. Se este 'plugin' estiver activo e se as ferramentas de dados estiverem instalados, irão aparecer alguns itens adicionais no fim do menu do contexto.

Exportação

- Este comando permite-lhe exportar o documento actual com toda a informação de realce para um documento em HTML, usando a opção Ficheiro Exportar como HTML. Para além disso, poderá usar a opção Editar Copiar como HTML para copiar o texto seleccionado de momento como HTML para a área de transferência do sistema.

Inserção de Ícones

- O 'plugin' de inserção de ícones só é usada para os programadores do &kde;: Adiciona um item Inserir um Código de KIcon no menu de contexto do editor. Se estiver activado, o selector de ícones do &kde; irá abrir (mostrando os ícones das aplicações, das acções, &etc;..). Se carregar num, será inserido como texto o nome do ficheiro sem a extensão do mesmo. Só é útil para atribuir ícones, através da plataforma do &kde;, com a classe KIcon().

Codificação louca (não ZEN) de HTML (edição leve)

- Um 'plugin' que faz uma completação de selectores semelhante à codificação Zen. Para mais informações, veja a Codificação Zen.

Inserir um Ficheiro

- Este 'plugin' permite-lhe introduzir o conteúdo de qualquer ficheiro legível na posição do cursor. Se estiver activo, o menu Ferramentas tem uma opção adicional para Inserir um Ficheiro.

## Créditos e Licenças

&kwrite;. Copyright 2001, 2002 equipa do &kate;.

Baseado no &kwrite; original que tem o Copyright 2000 de Jochen Wilhemly digisnap@cs.tu-berlin.de

Contribuições:

- &Christoph.Cullmann; &Christoph.Cullmann.mail;

- Michael Bartl michael.bartl1@chello.at

- Phlip phlip_cpp@my-deja.com

- &Anders.Lund; &Anders.Lund.mail;

- Matt Newell newellm@proaxis.com

- &Joseph.Wenninger; &Joseph.Wenninger.mail;

- Jochen Wilhelmy digisnap@cs.tu-berlin.de

- &Michael.Koch; &Michael.Koch.mail;

- &Christian.Gebauer; &Christian.Gebauer.mail;

- &Simon.Hausmann; &Simon.Hausmann.mail;

- Glen Parker glenebob@nwlink.com

- Scott Manson sdmanson@altel.net

- &John.Firebaugh; &John.Firebaugh.mail;

Documentação original por &Thad.McGinnis; &Thad.McGinnis.mail;

Actualizado por &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; e &Anders.Lund; &Anders.Lund.mail;

Esta versão do Manual do &kwrite; baseia-se no original de &Cristian.Tibirna; &Cristian.Tibirna.mail;

Convertido para docbook/revisão ortográfica por &Lauri.Watts; &Lauri.Watts.mail;

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;
&documentation.index;