O Manual do Kate

Mostrar/Esconder os Documentos

Liga e desliga a lista de Documentos. Se a janela da lista e selecção de ficheiros não estiver aberta, o Kate lança a barra lateral como uma janela separada e não acoplada. Para acoplar a janela, agarre nas duas linhas finas paralelas por cima dos selectores de secção, carregando nelas com o botão esquerdo do rato do rato e mantendo o botão carregado. Arraste a janela para a área de edição do Kate e largue o botão esquerdo, quando tiver posicionado a janela no seu local preferido.

Dica

Se seleccionou efectivamente as duas linhas paralelas, o seu cursor do rato irá mudar para duas setas cruzadas à medida que arrasta.

Mostrar/Esconder o Navegador do Sistema de Ficheiros

Liga e desliga a janela de selecção de ficheiros. Este item do menu é o mesmo que o Mostrar os Documentos mas com uma diferença. Ao activá-la, aparece a janela com o selector de ficheiros seleccionado.

Mostrar/Esconder o Terminal

Activa e desactiva um emulador de consola na parte inferior da janela do Kate. Por outras palavras, fornece-lhe uma linha de comandos dentro da aplicação.

Este manual

Oferece uma documentação detalhada sobre todos os comandos do menu, opções de configuração, ferramentas, janelas, 'plugins' etc., bem como descrições da janela do Kate, do editor e vários conceitos usados na aplicação.

Carregue em F1 ou use o tópico do menu Ajuda Conteúdo para ver este manual.

A ajuda O que é Isto?

A ajuda O Que É Isto? oferece uma ajuda imediata com os elementos simples das janelas, como os botões ou as outras áreas da janela.

Nós tentamos providenciar ajudas O Que É Isto? para todos os elementos nos quais faça sentido. Está disponível por toda a janela de configuração, bem como em muitas outras janelas.

Para você usar a ajuda O Que É Isto?, carregue em Shift-F1, ou use a opção do menu Ajuda->O Que É Isto?, para activar o modo de ajuda rápida. O cursor irá mudar para uma seta com um ponto de interrogação, para que possa então carregar em qualquer elemento da janela, de modo a ler a sua ajuda respectiva, se estiver disponível.

Botões de Ajuda nas Janelas

Algumas janelas têm um botão de Ajuda. Se carregar nele, irá iniciar o KHelpCenter e abrir a documentação relevante.

Texto a Procurar

Aqui é onde se indica o texto a procurar. A interpretação do texto depende de algumas das opções descritas em baixo.

Expressão Regular

Se estiver assinalada, o texto a procurar é interpretado como uma expressão regular. Estará activo um botão para criar ou editar a expressão.

Veja as Expressões Regulares para mais informações sobre elas.

Não Distinguir Capitalização

Se estiver activo, a pesquisa não fará distinção entre maiúsculas e minúsculas.

Apenas Palavras Inteiras

Se estiver seleccionado, a pesquisa só fará a correspondência se existir um limite de palavra em ambos os extremos da ocorrência, ou seja, um carácter não alfanumérico, outro carácter visível qualquer ou um fim de linha.

A partir do cursor

Se estiver seleccionada, a pesquisa irá começar a partir da posição do cursor, caso contrário irá ter início na primeira linha do documento.

Procurar para Trás

Se estiver seleccionada, a pesquisa irá procurar a primeira correspondência para cima do ponto inicial, seja este a posição actual do cursor ou do início do documento, se a opção Do Início estiver activa.

Substituir Por

Aqui é onde irá introduzir o texto de substituição.

Texto Seleccionado

Esta opção está desactivada se não estiver nenhum texto seleccionado ou se a opção Perguntar ao Substituir estiver activa. Se estiver, todas as correspondências do texto de pesquisa dentro do texto seleccionado serão substituídas pelo texto de substituição.

Perguntar ao Substituir

Se estiver seleccionada, aparecerá uma pequena janela a perguntar-lhe o que fazer de cada vez que é encontrada uma ocorrência. Oferece as seguintes opções:

Sim

Active isto para substituir a ocorrência actual (a que está seleccionada no editor).

Não

Active para ignorar a ocorrência actual e tentar encontrar outra.

Tudo

Active para cancelar a pergunta e substituir todas as ocorrências.

Fechar

Active isto para ignorar a ocorrência actual e terminar a pesquisa.

Funções Globais

debug( texto) [função]

parâmetros

• texto a mensagem a mostrar

Envia o texto para o STDERR com o kdDebug(). É usada uma área de resultado dedicada para o texto, o qual será antecedido de Kate (KJS Scripts):

A API do document

document.attribute( linha , coluna ); [função]

Parâmetros

• uint linha A linha da posição onde encontrar o atributo.

• uint coluna A coluna da posição onde encontrar o atributo.

Devolve o ID numérico do atributo para a posição do documento [linha,coluna]. O atributo representa a aparência ou estilo visual do texto, e é usado também para calcular o realce de sintaxe para uma parte específica do texto, em formatos mistos como o HTML ou o PHP.

document.canBreakAt( Char c, uint atributo ); [função]

Parâmetros

• c O carácter a testar

• atributo O atributo na posição do c.

Devolve se é permitido quebrar a linha num carácter 'c' com o atributo 'atributo'. O resultado é decidido através da pesquisa do realce que contém o atributo, para o qual os caracteres permitem a quebra de linha.

document.canComment( uint atributo_inicio, uint atributo_fim ); [função]

Parâmetros

• atributo_inicio O atributo no início do intervalo para converter num comentário.

• atributo_fim O atributo no fim do intervalo para converter num comentário.

Devolve se o atributo_inicio e o atributo_fim pertencem ao mesmo sistema de realce de sintaxe. Se sim, é seguro.

Exemplo 6.5. Usar o canComment

if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) {
    // o 1,0 e o 5,0 pertencem ao mesmo sistema de realce de sintaxe
}

document.clear(); [função]

Limpa o documento.

document.commentStart( uint atributo ); [função]

Parâmetros

• atributo O atributo do texto para qual deseja obter o texto do 'commentStart'.

Devolve o texto necessário para iniciar um comentário para várias linhas com um texto e um atributo, ou um texto vazio se não forem suportados comentários em várias linhas para esse texto.

document.commentMarker( uint atributo ); [função]

Parâmetros

• atributo O atributo do texto para o qual deseja obter o texto do 'commentMarker'

Devolve o texto necessário para marcar o resto da linha como um comentário com um texto e um atributo, ou um texto vazio se não forem suportados comentários numa única linha para esse texto.

document.commentEnd( uint atributo ); [função]

Parâmetros

• atributo O atributo do texto para o qual deseja obter o texto do 'commentEnd'

Devolve o texto necessário para terminar um comentário para várias linhas com um texto e um atributo, ou um texto vazio se não forem suportados comentários em várias linhas para esse texto.

document.editBegin(); [função]

Inicia um grupo de edição. Todas as acções feitas até à chamada do editEnd() serão agrupadas como uma acção anulável.

document.editEnd(); [função]

Termina um grupo de edição.

document.highlightMode; [propriedade:apenas leitura]

O nome do modo de realce do documento, como por exemplo JavaScript ou C++. Se não estiver definido qualquer modo de realce de sintaxe, o valor é igual a None. Lembre-se que terá de usar o nome em Inglês, no caso de ser diferente da versão traduzida.

document.indentMode; [propriedade:apenas leitura]

O nome do modo de indentação do documento, como por exemplo normal ou cstyle. Lembre-se que, se não estiver definido qualquer modo de indentação, o valor é igual a none.

document.indentWidth; [propriedade:apenas leitura]

Configura a largura da indentação do documento. Isto é usado se você indentar com espaços.

document.insertLine( uint linha, string texto ); [função]

Parâmetros

• linha número de linha do documento

• texto o texto a inserir

Insere uma linha nova com o texto texto na linha linha.

document.insertText( uint linha, uint coluna, string texto ); [função]

Parâmetros

• linha o número de linha

• coluna o número da coluna

• texto o texto a inserir

Insere o texto texto na linha linha e coluna coluna.

document.length(); [função]

Devolve o tamanho do documento em 'bytes'.

document.lines(); [função]

Devolve o número de linhas do documento.

document.mixedIndent; [propriedade:apenas leitura]

Um booleano que lhe diz se a opção 'mixed-indent' está activa para o documento. Se sim, a indentação é optimizada para conter uma mistura de tabulações e espaços, como acontece no editor Emacs.

document.removeLine( uint linha ); [função]

Parâmetros

• linha o número de linha

Remove a linha actual do documento.

document.removeText( uint linhaInicial, colunaInicial, uint linhaFinal, uint colunaFinal ); [função]

Parâmetros

• linhaInicial corresponde à linha inicial

• colunaInicial corresponde à coluna inicial

• linhaFinal corresponde à linha final

• colunaFinal corresponde à coluna final

Remove o intervalo de texto da linha linhaInicial e coluna colunaInicial até à linha linhaFinal e coluna colunaFinal.

document.setText( string texto ); [função]

Parâmetros

• texto o texto do documento

Configura o conteúdo inteiro do documento como texto.

document.spaceIndent; [propriedade:apenas leitura]

Um booleano que indica se o 'space-indent' está activo para o documento. Se for o caso, o documento é indentado com larguraIndentacao espaços por nível, caso contrário, a indentação corresponde a uma tabulação por nível.

document.textFull(); [função]

Devolve o conteúdo completo do documento. Se o texto se espalhar por várias linhas, o carácter de mudança de linha é o \n.

document.textLine( uint linha ); [função]

Parâmetros

• linha a linha

Devolve o texto da linha linha.

document.textRange( uint linhaInicial, uint colunaInicial, uint linhaFinal, uint colunaFinal ); [função]

Parâmetros

• linhaInicial corresponde à linha inicial

• colunaInicial corresponde à coluna inicial

• linhaFinal corresponde à linha final

• colunaFinal corresponde à coluna final

Devolve o intervalo de texto indicado. Se o intervalo se espalhar por várias linhas, o carácter de mudança de linha é o \n.

A API do view

view.clearSelection(); [função]

Remove a selecção de todo o texto.

view.cursorColumn(); [função]

Devolve a coluna actual do cursor (os caracteres TAB são expandidos).

view.cursorColumnReal(); [função]

Devolve a coluna real do cursor (os caracteres TAB contam como um).

view.cursorLine(); [função]

Devolve a linha actual do cursor.

view.hasSelection(); [função]

Devolve true (verdadeiro) se a janela contiver algum texto seleccionado, caso contrário devolve false.

view.removeSelectedText(); [função]

Remove o texto seleccionado, se a janela tiver alguma selecção.

view.selectAll(); [função]

Selecciona todo o texto.

view.selection(); [função]

Devolve o texto seleccionado. Se a selecção se espalhar por várias linhas, o carácter de mudança de linha é o \n.

view.selectionEndColumn; [propriedade:apenas leitura]

Devolve a coluna final da selecção.

view.selectionEndLine; [propriedade:apenas leitura]

Devolve a linha final da selecção.

view.selectionStartColumn; [propriedade:apenas leitura]

Devolve a coluna inicial da selecção.

view.selectionStartLine; [propriedade:apenas leitura]

Devolve a linha inicial da selecção.

view.setCursorPosition( uint linha, uint coluna ); [função]

Parâmetros

• linha Indica a linha para o cursor.

• coluna Indica a coluna para o cursor.

Configura a posição actual do cursor na janela como sendo [linha, col]. A posição do cursor é a nível visual, isto é, um carácter TAB conta como tab-width espaços, dependendo da posição dentro da linha. A posição do cursor é tornada visível. Tanto a linha como a coluna começam em zero.

view.setCursorPositionReal( uint linha, uint coluna ); [função]

Parâmetros

• linha Indica a linha para o cursor.

• coluna Indica a coluna para o cursor.

Configura a posição actual do cursor na janela como sendo [linha, col]. A posição do cursor é a nível do texto, isto é, um carácter TAB conta como 1. A posição do cursor é tornada visível. Tanto a linha como a coluna começam em zero.

view.setSelection( uint linhaInicial, uint colunaInicial, uint linhaFinal, uint colunaFinal ); [função]

Parâmetros

• linhaInicial corresponde à linha inicial

• colunaInicial corresponde à coluna inicial

• linhaFinal corresponde à linha final

• colunaFinal corresponde à coluna final

Configura a selecção desde a linha linhaInicial e coluna colunaInicial até à linha linhaFinal e coluna colunaFinal.

Mostrar a Localização Completa no Título

Quando estiver activa, o Kate irá mostrar o URL completo do seu documento actual na janela do título, em vez de usar apenas o nome do ficheiro.

Comportamento

Sincronizar o Konsole com o Documento Actual

Isto fará com que o Konsole incorporado faça cd para a pasta do documento activo quando for lançado e de cada vez que um novo documento passar para primeiro plano. Se não estiver activo, tem de efectuar a sua navegação no Konsole por si próprio.

Avisar acerca de ficheiros modificados por outros processos

Quando esta opção estiver activa, o Kate notificá-lo-á dos ficheiros modificados fora da aplicação, sempre que a janela principal for colocada em primeiro plano. Será então capaz de lidar com vários ficheiros modificados de uma vez, os quais poderá voltar a carregar, gravar ou esquecer os ficheiros alterados nos grupos.

Se não estiver activada, o Kate perguntar-lhe-á a acção a fazer, quando um ficheiro modificado externamente ficar em primeiro plano, dentro da aplicação.

Meta-Dados

Manter a meta-informação das sessões anteriores

Quando estiver activa, o Kate irá guardar alguns meta-dados, como a configuração dos favoritos e da sessão, mesmo quando fechar os seus documentos. Os dados serão usados, se o documento não estiver alterado, quando for aberto de novo.

Remover a meta-informação não usada após

Indica o número máximo de dias durante os quais mantém a meta-informação dos ficheiros por abrir. Isto mantém a base de dados de meta-informação com um tamanho razoável.

Elementos das Sessões

Incluir a configuração da janela

Se estiver activada esta opção, o Kate irá gravar a configuração da janela com cada sessão.

Comportamento no Arranque da Aplicação

Seleccione a forma como deseja que o Kate se comporte no arranque. Esta opção poderá ser substituída se definir o que fazer na linha de comandos.

Iniciar uma sessão nova

Com esta opção, o Kate irá iniciar uma sessão nova sem nome, quando a iniciar.

Carregar a última sessão usada

O Kate irá usar a sessão mais recente no arranque. Isto é bom se quiser usar a mesma sessão sempre ou deseja mudar raramente.

Escolher manualmente uma sessão

O Kate irá mostrar uma pequena janela que lhe permite escolher a sua sessão preferida. Este é o comportamento por omissão. Isso é bom se usar bastantes sessões diferentes com frequência.

Comportamento à Saída da Aplicação ou na Mudança de Sessão

Não gravar a sessão

As modificações aos dados da sessão (ficheiros abertos e, se assinalado, a configuração da janela) não serão gravadas. Será avisado, claro, se tiver ficheiros por gravar. Com esta opção, poderá configurar as suas sessões uma vez; não se preocupe em fechar os ficheiros extra que tiver aberto e não quiser ver da próxima vez que usar a sessão.

Gravar a Sessão

O Kate irá gravar os dados da sessão, excepto se a sessão não tiver nome. Com esta opção, as suas sessões são sempre repostas, tal como as deixou. Este é o comportamento por omissão.

Perguntar ao utilizador

Ser-lhe-á perguntado se deseja gravar a sessão sempre que uma sessão com nome for fechada.

Barra de Ferramentas

Configure os botões no navegador do sistema de ficheiros, movendo os que deseja activar para a lista de Acções Seleccionadas e ordenando-os com as setas ao lado da lista.

Auto-Sincronização

Poderá fazer com que o navegador do sistema de ficheiros navegue automaticamente para a pasta que contém o documento actual no caso de certos eventos:

• Quando um documento novo ficar activo.

• Quando o navegador do sistema de ficheiros ficar activo.

Mesmo que opte por não usar esta funcionalidade, poderá sincronizar manualmente o navegador com o documento actual, se carregar no botão da barra de ferramentas Sincronizar.

Recordar as localizações

Seleccione o tamanho que deseja manter para o histórico de navegação. O navegador só se recorda das localizações individuais, sendo que os duplicados são removidos.

Recordar os filtros

Seleccione quantos filtros deseja recordar. Só os filtros distintos individualmente é que serão recordados, sendo que os duplicados serão removidos.

Sessão

Configure se o navegador do sistema de ficheiros deverá recordar a sua localização e filtros para as outras sessões.

Fundo Sombreado

Esta página permite-lhe activar ou desactivar a visualização sombreada do fundo da sua actividade recente e escolher as cores a usar, se estiver activada. Veja a secção sobre a Lista de Documentos para mais dados sobre esta funcionalidade.

Ordenar Por

Indique como deseja ordenar a lista de documentos. Isto também poderá ser feito, com o menu do botão direito do rato, na lista de documentos.

Propriedades das Ferramentas Externas

Legenda

Uma legenda amigável para o menu de Ferramentas Externas.

Programa

O programa a executar quando a ferramenta estiver activada. Antes de passar o programa à linha de comandos, são substituídas as seguintes macros:

%URL

O URL completo do documento actual ou um texto vazio, se o documento não for gravado.

%URLS

Uma lista, separada por espaços, dos URLs de todos os documentos abertos (excepto os não-gravados).

%directory

A parte de directoria do URL do documento actual ou um texto vazio se o documento actual não estiver gravado.

%filename

O nome do ficheiro do documento actual, sem a parte da pasta, ou um texto vazio se o documento actual não estiver gravado.

%line

O número de linha onde o cursor de inserção se encontra no documento actual.

%column

O número da coluna onde o cursor de inserção se encontra no documento actual.

%selection

O texto seleccionado no documento actual ou um texto vazio se não estiver qualquer texto seleccionado

%text

O texto completo do documento actual. Tenha em atenção que este poderá exceder potencialmente o comprimento máximo do comando no seu sistema. Use-o com cuidado.

Executável

O executável principal no programa. Isto é obrigatório e é usado para testar se o comando poderá ser executado de todo. É permitida uma localização absoluta, no caso de o executável não se encontrar acessível através da sua variável PATH.

Tipos MIME

Uma lista, separada por pontos-e-vírgulas, dos tipos MIME que estão activos para este comando. Isto normalmente não é usado.

Gravar

O utilizador poderá, opcionalmente, optar por gravar o documento actual ou todos os documentos, antes de executar o programa. Isto é útil se o seu programa ler o ficheiro do disco.

Nome da Linha de Comandos

Se você preencher isto, a ferramenta estará disponível na linha de comandos dos editores como exttool-Nome da Linha de Comandos (o texto que indicar aqui é antecedido por “exttool-”).

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

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

Alinhar verticalmente as mudanças de linhas 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.

Dobragem do Código

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.

Contornos

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 marcas 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 posição

Os favoritos irão ser ordenados pelos números de linhas onde estão colocados.

Por criação

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

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.

Movimento do Cursor de Texto

Início inteligente

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

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/Down Move o Cursor

Esta opção altera o comportamento do cursor quando o utilizador carregar nas teclas Page Up ou Page Down. Se não estiver seleccionada, o cursor do texto irá manter a sua posição relativa, dentro do texto visível no Kate, à medida que vai ficando texto novo visível em resultado da operação. Como tal, se o cursor estiver a meio do texto visível, quando ocorrer a operação, irá permanecer nesse estado (excepto se atingir o início ou o fim.) Com esta opção seleccionada, a primeira tecla fará com que o cursor se mova para o topo ou o fundo do texto visível, à medida que for apresentada uma página nova 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

Normal

As selecções serão sobrepostas pelo texto escrito e serão perdidas 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.

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

Mostrar as tabulações

Quando esta opção estiver activa, o Kate irá mostrar um pequeno ponto como representação visual dos caracteres de tabulação.

Nota

Isto fará também com que sejam desenhados pontos a representar os espaços em branco. Isto será corrigido numa versão futura do Kate

Tabulação

Se a opção Substituir Tabulações por Espaços estiver seleccionada, este item define o número de espaços com os quais 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 nova e mova (reparta) o cursor para o início dessa linha nova. O Kate irá iniciar automaticamente uma linha de texto nova, 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 as palavras em:

Se a opção de Mudança de Linha estiver seleccionada, este item define o tamanho (em caracteres) com que o editor irá iniciar uma linha nova automaticamente.

Remover os Espaços Finais

O Kate irá eliminar de forma automática os espaços extra no fim das linhas de texto.

Parêntesis Automáticos

Quando o utilizador escrever um parêntesis esquerdo ([, ( ou {), o Kate irá introduzir automaticamente o parêntesis direito (}, ) ou ]) à direita do cursor.

Passos do desfazer:

Aqui o utilizador poderá definir o número de passos que o Kate irá reter em memória, com o objectivo de anular os itens e acções. Isto significa que, quanto maior o número de passos, maior a quantidade de memória que o Kate irá usar para tal. Se configurar este valor como 10, significa que o utilizador seria capaz de anular as últimas dez operações, i.e., carregar no botão desfazer 10 vezes, obtendo os resultados respectivos.

Texto de origem de procura inteligente:

Isto determina de onde o Kate irá obter o texto da procura (será introduzido automaticamente na janela para Procurar Texto):

• Em Nenhum Lado: Não irá adivinhar o texto de procura.

• Apenas a Selecção: Usar a selecção do texto actual, se disponível.

• Selecção ou Palavra Actual: Usar a selecção actual, se disponível, caso contrário usa a palavra actual.

• Apenas a Palavra Actual: Usa a palavra sob o cursor, se disponível.

• Palavra Actual ou Selecção: Usa a palavra actual, se disponível, caso contrário usa a selecção actual.

Lembre-se que, nos modos acima, se não se conseguir determinar um texto de procura, então a janela para Procurar Texto irá usar o último texto de procura.

Indentação automática

Modo de indentaçã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.

Inserir um "*" inicial do Doxygen ao escrever

Insere automaticamente um "*" inicial, enquanto escreve dentro de um comentário do tipo do Doxygen. Esta configuração só está activa quando tal se aplicar.

Indentação com Espaços

Usar espaços em vez de tabulações para indentar

Isto substitui as tabulações pelo número de espaços definido no campo Número de espaços: em baixo.

Modo misto, estilo Emacs

Usa uma mistura de tabulações e espaços na indentação.

Número de espaços:

Defina o número de espaços que deseja usar na indentação, quando assinalar a opção Usar espaços em vez de tabulações para indentar.

Manter o Perfil de Indentação

Quando esta opção estiver activa, o editor não irá remover mais a indentação das linhas de uma selecção, quando a linha com menor indentação ficar completamente sem indentação. Se algumas vezes retirar blocos de indentação no código, isto poderá ser útil.

Manter Espaços Extra

As indentações com mais espaços que os seleccionados não serão encolhidas.

Teclas a usar

A tecla Tab indenta

Isto permite usar a tecla Tab para indentar.

Indentação com a Tecla Backspace

Isto permite usar a tecla Backspace para indentar.

Modo da Tecla Tab Se Nada Estiver Seleccionado

Inserir os caracteres de indentação

Isto permite usar a tecla Tab para indentar.

Inserir um carácter de tabulação

Isto permite usar a tecla Tab para indentar.

Indentar a linha actual

Isto permite usar a tecla Tab para indentar.

Formato do Ficheiro

Codificação:

Isto altera a codificação de caracteres do seu ficheiro.

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.

Utilização de Memória

Blocos máximos carregados por ficheiro:

O editor irá carregar o número de blocos indicado (com cerca de 2048 linhas) com texto para a memória; se o tamanho do ficheiro for maior que isto, os outros blocos são transferidos para o disco e carregados de forma transparente, à medida das necessidades.

Isto poderá provocar alguns pequenos atrasos ao navegar no documento; um número de blocos maior aumenta a velocidade de edição com uma sobrecarga na memória.

Para uma utilização normal, basta escolher o número de blocos maior que for possível: limite-o apenas se tiver problemas com a utilização de memória.

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.

Ficheiro de Configuração de Pasta

Profundidade da procura no ficheiro de configuração:

O editor irá procurar para cima, pelo número indicado de níveis da pasta, no ficheiro de configuração do Kate, e irá carregar a linha de configuração do mesmo.

Salvaguardar ao Gravar

Se salvaguardar ao gravar, fará com que o Kate copie o ficheiro do disco para <prefixo><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.