# KrViewer: o visualizador-editor interno do &krusader;

Se carregar em &Enter; num ficheiro seleccionado, abre o ficheiro com a aplicação associada. O editor-visualizador funciona por páginas; configure-o na página Geral do Konfigurador

## Visualizador

Para ver um ficheiro o mais rapidamente possível, de acordo com o seu tipo, é colocá-lo sob o cursor e carregar em F3. O visualizador interno do &krusader; faz parte de facto do &konqueror;, que consegue ver basicamente todos os tipos de ficheiros legíveis pelo &konqueror; (⪚ mostrar imagens, tocar música, mostrar o conteúdo de um pacote). Este é chamado de 'Visualizador genérico', para o qual poderá ter de configurar os tipos MIME.

O visualizador funciona da seguinte forma:

- Tenta ver o ficheiro com o 'Visualizador genérico'.

- Quando o tipo do ficheiro (tipo MIME) não puder ser determinado ou quando um ficheiro (⪚ um executável) não tiver uma acção associada, ele irá desactivar o 'visualizador genérico'. O ficheiro é tratado como ficheiro de texto, sendo aí usado o 'Visualizador de texto'.

- O utilizador poderá alterar, no menu KrViewer entre: 'Visualizador genérico' (se estiver disponível), 'Visualizador de texto' e 'Visualizador hexadecimal'.

Poderá configurar o modo de visualização por omissão na página Geral do Konfigurador .

O &Shift; F3 vê um &URL; a pedido, ⪚:

- O ``man:/`` vê as páginas do manual.

- O ``man:/` `krusader`` vê a página de manual do &krusader;.

- O ``info:/`` vê as páginas do 'info'.

- O ``http://` `krusader.sourceforce.net/`` vê uma página Web.

- O ``ftp://` `ftp.kde.org/pub/kde/`` vê um servidor de &FTP;.

- O ``sftp://` `sftp.xpto/`` vê um servidor de &FTP; seguro.

- O ``file:/` `área/josé`` vê a pasta pessoal do José.

- O ``file:/` `área/josé/pacote.tar.gz`` vê um ficheiro de pacote `tar.gz`.

O KrViewer poderá ter os seguintes menus: Ficheiro, Editar, Ver, Configuração e Krviewer, dependendo do tipo de ficheiro que está a ver. Estes serão discutidos na secção do Editor. O visualizador interno poderá seguir as ligações nas páginas &HTML;. Com o &Ctrl; E, o visualizador poderá iniciar o editor interno do &krusader; (o qual é basicamente a mesma aplicação).

O visualizador incorporado não é feito por nós; é fornecido através das &kf5; e pelos KIO Slaves. Não podemos nem queremos alterar isso, dado que a utilização destas bibliotecas reduz a quantidade de código escrito. Por isso, não é necessário reinventar a roda ;-)

## Editor

O editor interno do &krusader; tem praticamente tudo o que iria esperar de um editor. A edição é semelhante à visualização, se bem que usa a tecla F4. O editor por omissão é o editor interno do &krusader;. Poderá alterar o editor predefinido com a página Geral do Konfigurador, se preferir usar um editor externo.

Quando usar o editor interno do &krusader; pela primeira vez, recomenda-se que veja cada secção do menu de Configuração, definindo a configuração como preferir.

## Introdução ao menu

Existem diferentes menus e itens nos modos simples e avançado. O modo avançado é activado se assinalar a opção Activar o modo de utilizador experiente (modo do &kde; 3) na página Aparência da configuração do &kappname;.

### O Menu Ficheiro

&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 gravar um documento com um nome novo.

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.

### 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 que trabalha 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 que trabalha 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 que trabalha, 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

- 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

- Muda para um modo de edição semelhante ao do 'vi'. Este modo suporta os comandos e movimentos mais usados do modo visual e normal do Vim e tem também uma barra de estado opcional com o modo do 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 pode ser configurado na secção do Modo de Entrada do VI da página 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 botão com uma 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 botão com um ícone de 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, no fundo da janela, que é usada para ir 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

- 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 Mostrar a Consola de JavaScript

- Isto abre uma janela de ferramentas que lhe permite executar código em JavaScript de forma interactiva. Para mais informações, veja como Extender o &kate; com os Programas

Ver Esquema

- 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

- 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 Marcador Estático de Mudança de Linha

- 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 de Ícones

- Isto é um item de comutação. Se o ligar, irá activar o Contorno de Ícones do lado esquerdo do editor activo, e vice-versa. O Contorno dos Ícones indica as posições das linhas marcadas no editor.

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

- Se esta opção estiver assinalada, a janela actual irá mostrar algumas marcas na barra de posicionamento vertical. Estas marcas são equivalentes às marcas no Contorno do Ícone.

F9 Ver Mostrar as Marcas de Dobragem

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

Ver Dobragem de Código

- Estas opções pertencem à dobragem de código:

  F9 Mostrar as Marcas de Dobragem

- Activa/desactiva a visualização da área de marcadores de dobragem do lado esquerdo da janela.

Dobrar o Nó Actual

- Recolhe a região que contém o cursor.

Expandir o Nó Actual

- Expande a região que contém o cursor.

&Ctrl; &Shift;- Dobrar os Nós de Topo

- Fecha todas as regiões de topo no documento. Carregue no triângulo para a direita para expandir todas as regiões de topo.

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

&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 favoritos para esta janela, se foram previamente atribuídos.

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

- 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

- 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

- 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

- 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

- 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

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

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

- 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

- 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 do menu adicional Inserir um Ficheiro....

### O Menu Configuração

Configuração Configurar o Editor...

- Este item do menu abre uma janela onde poderá ajustar diversas opções de configuração diferentes.

### O Menu KrViewer

&Ctrl;&Shift; G KrViewer Visualizador genérico

- O visualizador interno do &krusader; faz de facto parte do &konqueror;, que poderá ver basicamente todos os tipos de ficheiros que o &konqueror; consegue ver (⪚ mostrar as imagens, tocar a música, mostrar o conteúdo de um pacote).

&Ctrl;&Shift; T KrViewer Visualizador de texto

- Ver o ficheiro no modo de texto.

&Ctrl;&Shift; H KrViewer Visualizador hexadecimal

- Vê o ficheiro no modo hexadecimal.

&Ctrl;&Shift; L KrViewer Lista

- Um visualizador de texto/hexadecimal rápido para ficheiros de tamanho enorme, feito pela Lista do Krusader.

&Ctrl;&Shift; E KrViewer Editor do texto

- Edita o ficheiro no modo de texto.

&Ctrl;&Shift; D KrViewer Desanexar a Página

- Destaca a página de navegação para uma janela nova.

&Ctrl; Q KrViewer Sair

- Fecha a janela do visualizador/editor do &krusader;.

## A Configuração do Componente de Edição

Este grupo contém todas as páginas relacionadas com o componente de edição do &kappname;. A maioria das opções aqui são valores predefinidos que poderão ser substituídos ao definir um tipo de ficheiro, com as Variáveis do Documento ou alterando os valores por cada documento, durante uma sessão de edição.

### Aparência

#### Geral

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)

- Escolhe quando deverão ser mostrados os indicadores de mudança de linha, sendo as opções Desligado, Seguir os Número de Linha ou Sempre ligado.

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.

Realce dos Espaços

- Realçar as tabulações

- O editor irá mostrar um símbolo » para indicar a presença de uma tabulação no texto.

Realçar os espaços finais

- O editor irá mostrar pontos para indicar a presença de espaços em branco extra no fim das linhas.

Avançado

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

#### Contornos

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

- Por criação

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

Por posição

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

### 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 &plasma;.

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 esquema. Pode escolher qualquer tipo de letra disponível no seu sistema, assim como definir um tamanho por omissã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

Mudança de Linha Estática

- A mudança de linha é uma funcionalidade que faz com que o editor inicie automaticamente uma linha nova de texto e mova o cursor para o início dessa linha nova. O &kappname; irá iniciar automaticamente uma nova linha de texto quando a linha actual atingir o tamanho indicado na opção Mudar de Linha 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 item define o tamanho (em caracteres) a partir do qual o editor irá iniciar automaticamente uma linha nova.

Diversos

- Remover os espaços finais ao editar

- O &kappname; irá eliminar automaticamente 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;.

Indentação com

- Tabulações

- Quando esta opção for activada, o editor irá introduzir caracteres de tabulação quando carregar na tecla ou usar a indentação automática.

Espaços

- Quando isto estiver activo, o editor irá introduzir um número predefinido de espaços de acordo com a posição no texto e com a opção `tab-width`, quando carregar na tecla ou usar a indentação automática.

Tabulações e Espaços

- Quando a opção estiver activa, o editor irá inserir espaços, como descrito acima, quando indentar ou carregar em no início de uma linha, mas irá inserir tabulações quando carregar na tecla a meio ou no fim de uma linha.

Largura da tabulação:

- Isto configura o número de espaços que são apresentados no lugar de uma tabulação.

Largura de indentação:

- A largura de indentação é o número de espaços usado para indentar uma linha. Se estiver configurado para indentar com tabulações, será inserido um carácter de tabulação se a indentação for divisível pela largura da tabulação.

Propriedades de Indentaçã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

- Activar a completação automática

- 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 do VI

Geral

- Usar o modo de introdução de dados do 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 descritas 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 na secção de variáveis do documento.

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.

Desactivar a sincronização do ficheiro temporário

- O &kappname; é capaz de recuperar (a maioria de) o que foi escrito desde a última gravação, em caso de um estoiro ou falha de energia. É criado um ficheiro temporário (.swp.<nome-ficheiro>) após a primeira acção de edição de um documento. Se o utilizador não gravar as alterações e o &kappname; estoirar, o ficheiro temporário permanece no disco. Ao abrir um ficheiro, o &kappname; verifica se existe um ficheiro temporário para o documento e, caso exista, pergunta ao utilizador se deseja recuperar os dados perdidos ou não. O utilizador terá a hipótese de ver as diferenças entre o original e o recuperado, de igual forma. O ficheiro temporário é apagado após cada gravação e ao sair normalmente.

  O &kappname; sincroniza os ficheiros temporários com o disco a cada 15 segundos, mas só se tiverem sido alterados desde a última sincronização. O utilizador poderá desactivar a sincronização dos ficheiros temporário se quiser, assinalando a opção Desactivar a sincronização do ficheiro temporário, mas isso poderá conduzir a mais perdas de dados.

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

Apagar

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

  Carregue em Editar para ver uma lista com todas as variáveis disponíveis e as suas descrições. Assinale a opção à esquerda para activar uma variável em particular e depois definir o valor da variável à direita. Algumas variáveis oferecem uma lista para poder escolher os valores possíveis enquanto outras lhe pedem para introduzir manualmente um valor válido.

  Para uma informação completa sobre estas variáveis, veja Configurar com as Variáveis do Documento.

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 &kappname;.

### 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 &kappname; 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. 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 &plasma;: 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 das &kf5;, 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.