# O Manual do &kwrite;

&Thad.McGinnis; &Thad.McGinnis.mail;
&Christoph.Cullmann; &Christoph.Cullmann.mail;
&Lauri.Watts; &Lauri.Watts.mail;
Marcus
Gama

    marcus_gama@uol.com.br

Tradução
2000
2001
&Thad.McGinnis;
&FDLNotice;
2001-06-13
2.00.00

O &kwrite; é um editor de texto para o &kde;

KDE
KWrite
texto
editor

## Introdução

O &kwrite; é mais que um editor de texto para o Ambiente de Trabalho &kde;. Ele pretende ser um editor de programadores, e pode ser considerado como pelo menos uma alternativa parcial para os editores mais poderosos. Ele pode ser melhor usado em conjunto com o &konqueror; para navegação de arquivos fontes de diferentes linguagens. O &kwrite; também trabalha muito bem como um simples editor de texto. Um dos principais recursos do &kwrite; é colorização de sintaxe, personalizada para muitas linguagens de programação diferentes como o C/C++, &Java;, Python, Perl, Bash, Modula 2, HTML, e Ada.

## Alguns Fundamentos

O &kwrite; é muito simples de usar. Qualquer um que tenha usado um editor de texto não deve ter problemas.

### Arrastar e Soltar

O &kwrite; usa o protocolo de Arrastar e Soltar do &kde;. Arquivos podem ser arrastados e soltos no &kwrite; a partir da área de trabalho, do &konqueror; ou de algum site &FTP; remoto aberto em uma das janelas do &konqueror;.

### Opções de Linha de Comando

Apesar do &kwrite; ser a maioria das vezes iniciado a partir do menu de programas do KDE, ou de um ícone na área de trabalho, ele pode também ser aberto a partir do prompt da linha de comando de uma janela de terminal. Existem algumas poucas opções úteis que estarão disponíveis quando fizer isto.

#### Especificar um Arquivo

Especificando o caminho e nome de um arquivo específico o usuário pode fazer com que o &kwrite; abra (ou crie) este arquivo imediatamente após iniciar. Esta opção pode parecer algo como o seguinte:

    % kwrite
    /home/minhacasa/docs/meuarquivo.txt

#### Especificar um arquivo da internet

O método acima mencionado pode também ser usado para abrir arquivos na internet (se o usuário tiver uma conexão ativa no momento.) Um exemplo disto pode parecer com o seguinte:

    % kwrite
    ftp://ftp.kde.org/pub/kde/Welcome.msg

#### Outras Opções de Linha de Comando

As seguintes opções de ajuda de linha de comando estão disponíveis

``kwrite` `--help``

  Isto lista as opções mais básicas disponíveis na linha de comando.

``kwrite` `--help-qt``

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

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

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

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

  Isto lista todas as opções de linha de comando.

``kwrite` `--author``

  Lista o autor do &kwrite; na janela do terminal

``kwrite` `--version``

  Lista as informações de versão do &Qt;, &kde; e &kwrite;. Também disponível através de ``kwrite` `-V``

### Atalhos de Teclado

Muitos tipos de atalhos de teclado são configuráveis através do menu de Configurações. Por padrão o &kwrite; permite os seguintes atalhos de teclado.

Insert | Alterna entre o modo Inserir e Sobrescrever. Quando no modo inserir o editor adicionará qualquer caracter digitado ao texto empurrando qualquer dado à direita do cursor do texto. O modo sobrescrever faz com que a entrada de cada caracter elimine o caracter imediatamente à direita do cursor de texto.
Seta Esqueda | Move o cursor um caracter para a esquerda
Seta Direita | Move o cursor um caracter para a direita
Seta Acima | Move o cursor uma linha acima
Seta Abaixo | Move o cursor uma linha abaixo
Page Up | Move o cursor uma página acima
Page Down | Move o cursor uma página abaixo
Backspace | Apaga o caracter à 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 caracter à direita do cursor (ou qualquer texto selecionado)
&Shift;Seta Esquerda | Marca o texto um caracter à esquerda
&Shift;Seta Direita | Marca o texto um caracter à direita
F1 | Ajuda
&Shift;F1 | O Que é Isso?
&Ctrl;F | Procurar
F3 | Procurar novamente
&Ctrl;C | Copia o texto marcado para a área de transferência.
&Ctrl;B | Configura um Favorito
&Ctrl;N | Novo documento
&Ctrl;P | Imprime
&Ctrl;Q | Sai - fecha a cópia ativa do editor
&Ctrl;R | Substitui
&Ctrl;S | Invoca o comando Salvar.
&Ctrl;V | Cola o texto da área de transferência na linha de edição.
&Ctrl;X | Apaga o texto marcado e copia-o para a área de transferência.
&Ctrl;Z | Desfazer
&Ctrl;&Shift;Z | Refazer

## As Entradas de Menu

### O Menu Arquivo

&Ctrl;N Arquivo Novo

  Isto inicia um novo Documento no editor. Se existir uma documento aberto com mudanças não salvas o usuário terá a chance de salvá-lo.

&Ctrl;O Arquivo Abrir...

  Este comando abre um arquivo. Ele faz isto através de uma caixa de diálogo que permite navegar pelo sistema de arquivos. O diálogo funciona como um pequeno gerenciador de arquivos. Clicar nas pastas exibidas na janela central direciona o diálogo a entrar nesta pasta - exibindo seu conteúdo. Existe uma caixa combinada que pode ser usada para digitar diretamente a localização e nome do arquivo ou clicar na seta ao lado para escolher a partir de uma lista suspensa de localizações recentemente usadas. Abaixo dela está um filtro que pode do mesmo modo ter dados inseridos diretamente ou escolher a partir de uma lista suspensa de filtros de tipos recentes. A facilidade de filtro faz com que somente arquivos que atendam suas especificações sejam exibidos na janela centra. Se o filtro contiver texto como `*.txt` então somente arquivos com a extensão `txt` serão visíveis na janela de seleção. Abaixo do filtro está a barra de estado fornecendo informações sobre o número de arquivos e subpastas dentro da pasta atual.

  A barra de ferramentas, que está localizada no topo do diálogo, possui botões de setas para esquerda e direita que permite mover para trás e para frente pelas pastas anteriormente selecionadas bem como o botão de seta para cima para mover acima na árvore de pastas. O botão com uma pequena casa leva o usuário a sua pasta pessoal e o com duas setas em curva atualiza a visão da pasta atual. O botão com uma bandeira permite o usuário configurar um novo favorito na pasta atual ou ir para um previamente configurado.

  Os últimos botões na barra de ferramentas permitem criar uma nova pasta, e mudar algumas configurações básicas para a caixa de diálogo, e finalmente existe uma caixa combinada com uma lista das pastas frequentemente acessadas.

Arquivo Abrir Recente

  Este é um atalho para os documentos recentemente salvos. Clicar neste ítem abrirá uma lista ao lado do menu com vários dos arquivos mais recentemente salvos. Clicar em um arquivo específico irá abrí-lo no &kwrite; - se o arquivo ainda estiver na mesma localização.

&Ctrl;S Arquivo Salvar

  Isto salva o documento atual. Se o documento já tiver sido salvo então isto sobrescreverá o arquivo anteriormente salvo sem pedir pela permissão do usuário. Se esta é a primeira vez que salva um novo documento a diálogo salvar como (descrito abaixo) será invocado.

Arquivo Salvar Como...

  Isto permite que um documento seja salvo com um novo nome de arquivo. Isto é feito com a caixa de diálogo de arquivo descrita acima na seção Abrir deste arquivo de ajuda.

&Ctrl;P Arquivo Imprimir...

  Abre um diálogo simples de impressão que permite o usuário especificar o que, onde e como imprimir

&Ctrl;Q Arquivo Sair

  Isto fechará a janela do editor. Se você tiver mais de uma instância do &kwrite; em execução, através dos ítens de menu Nova Visão ou Nova Janela, estas instâncias não serão fechadas.

### O Menu Editar

&Ctrl;Z Editar Desfazer

  Isto é usado para eliminar ou reverter a ação ou operação mais recente do usuário. O que constitui uma ação pode ser melhor entendido na parte Grupo de Desfazer deste arquivo de ajuda.

&Ctrl;&Shift;Z Editar Refazer

  Isto reverte a mudança mais recente (se houver) feita usando o Desfazer

&Ctrl;X Editar Cortar

  Este comando exclui a seleção atual e coloca-a na área de transferência. A área de transferência é um recurso do KDE que trabalha de maneira invisível para fornecer um modo de transferir dados entre aplicativos.

&Ctrl;C Editar Copiar

  Isto copia o texto atualmente selecionado para a área de transferência de modo que ele possa ser colado em outro lugar. A área de transferência é um recurso do KDE que trabalha de maneira invisível para fornecer um modo de transferir dados entre aplicativos.

&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 é um recurso do KDE que trabalha de maneira invisível para fornecer um modo de transferir dados entre aplicativos.

&Ctrl;A Editar Selecionar Tudo

  Isto irá selecionar todo o documento. Isto pode ser muito útil para copiar um arquivo inteiro para outro aplicativo.

&Ctrl;G Editar Ir para linha

  Isto abre a caixa de diálogo ir para linha, que é usada para fazer com que o cursor pule para uma linha em particular (especificada pelo número) no documento. O número da linha pode ser inserido diretamente na caixa de texto ou graficamente clicando na seta para cima e para baixo do controle de contagem ao lado da caixa de texto. A pequena seta para cima aumentará o número da linha e a seta para baixo diminuirá. Existe também um índice deslizante à direita da caixa de texto que permite o usuário mover o ponto do ir para no documento de uma maneira semelhante.

&Ctrl;F Editar Procurar

  Isto abre o diálogo de procura que é usado para especificar o Texto a Procurar no documento. Existe uma pequena caixa de texto para inserir o termo a procurar que também é uma caixa combinada. Clica na seta para baixo ao lado da caixa torna disponíveis outros termos de busca recentes. Outros parâmetros são incluídos para tornar a busca mais eficiente. Selecionar Sensível à Caixa limitará a busca a entradas que correspondam a caixa (superior ou inferior) de cada caracter no termo de busca. Procurar para Trás direciona a busca para ser realizada na direção do início do arquivo. A opção Texto Selecionado mantém a busca dentro do texto selecionado. Habilitar Somente Palavras Completas evita que a busca pare em palavras que contenham o termo procurado. A opção Procurar a partir do Cursor inicia a busca a partir da posição atual do cursor dentro do documento ao invés de iniciá-la a partir do início.

F3 Editar Procurar Próximo

  Isto repete a última operação de busca, se houver, sem chamar a caixa de diálogo de procura.

&Shift;F3 Editar Procurar Anterior

  Isto repete a última operação de busca, se houver, sem chamar a caixa de diálogo de procura, e busca no documento para trás ao invés de para frente.

&Ctrl;R Editar Substituir

  Este comando abre a caixa de diálogo de substituição. O diálogo de substituição é bastante parecido com o diálogo de procura acima mencionado. Além dos recursos do diálogo de procura ele contém uma caixa combinada Substituir Com:. Usando este diálogo o usuário pode especificar tanto o texto a ser encontrado como o texto que deverá substituí-lo. A opção adicional Perguntar Ao Substituir permite ao usuário confirmar ao &kwrite; antes de cada substituição.

### O Menu Favoritos

&Ctrl;B Favoritos Alternar Favoritos

  A ser escrito

Favoritos Limpar Marcadores

  Este comando removerá todos os marcadores do documento bem como a lista de marcadores que é anexada na base deste ítem de menu.

Na base deste menu, uma lista de marcadores aparece se algum marcador está disponível para esta janela.

### O Menu Ferramentas

Ferramentas Ortografia...

  Isto inicia o programa de verificação ortográfica - um programa desenvolvido para auxiliar o usuário a detectar e corrigir qualquer erro ortográfico. Clicar nesta entrada iniciará o verificador e levantará a caixa de diálogo de ortografia a partir da qual o usuário pode controlar o processo. Existem quatro caixas alinhadas verticalmente no centro do diálogo com seus rótulos correspondentes à esquerda. Iniciando do topo elas são:

  Palavra desconhecida:

    Aqui, o verificador ortográfico indica a palavra atualmente em consideração. Isto acontece quando o verificador encontra uma palavra que não está em seu dicionário - um arquivo contendo uma lista de palavras ortograficamente corretas contra a qual ele compara cada palavra no editor.

  Substituir com:

    Se o verificador possuir alguma palavra semeplhante no seu dicionário a primeira será listada aqui. O usuário pode aceitar a sugestão, digitar nesta caixa sua correção, ou escolher uma sugestão diferente a partir da próxima caixa.

  Palavras Sugeridas:

    O verificador pode listar aqui um número de possíveis substituições para a palavra em consideração. Clicar em qualquer uma das sugestões fará com que a palavra seja inserida na caixa Substituição acima.

  Idioma:

    Se você tiver múltiplos dicionários instalados, aqui você pode selecionar qual dicionário/idioma deve ser usado.

  No lado direito da caixa de diálogo existem 5 botões que permitem controlar o processo de verificação ortográfica. Eles são:

  Adicionar ao Dicionário

    Pressionar este botão adiciona a palavra na caixa Palavra Desconhecida: ao dicionário do verificador. Isto significa que no futuro o verificador sempre considerará esta palavra como ortograficamente correta.

  Substituir

    Este botão faz o verificador substituir a palavra em consideração no documento com a palavra na caixa Substituição:.

  Substituir Todas

    Este botão faz com que o verificador substitua não somente a Palavra desconhecida: atual, mas automaticamente faça a mesma substituição para qualquer outra ocorrência detsa Palavra Desconhecida: no documento.

  Ignorar

    Ativar este botão fará com que o verificador avance sem realizar nenhuma mudança.

  Ignorar Todas

    Este botão faz com que o verificador não faça nada com a Palavra desconhecida: atual e em nenhuma das outras ocorrências da mesma palavra.

    Isto somente se aplica a verificação ortográfica atual em execução. Se o verificador for executado novamente mais tarde ele irá parar nesta mesma palavra.

  Três outros botões estão localizados horizontalmente ao longo da base do diálogo de verificação ortográfica. Eles são:

  Ajuda

    Isto invoca o sistema de ajuda do KDE iniciando a página de ajuda do &kwrite; (este documento).

  Terminado

    Este botão termina o processo de verificação ortográfica, e retorna ao documento.

  Cancelar

    Este botão cancela o processo de verificação ortográfica, todas as modificações são revertidas, e você retornará ao seu documento.

  &Ctrl;I Ferramentas Indentar

    Isto aumenta a indentação do parágrafo em um passo. O tamanho do passo depende das configurações de indentação.

  &Ctrl;&Shift;I Ferramentas Desindentar

    Isto reduz a indentação do parágrafo em um passo. O tamanho do passo depende das configurações de indentação.

  Ferramentas Limpar Indentação

    Não implementado ainda

  &Ctrl;D Ferramentas Comentar

    Isto adiciona um espaço ao início da linha onde o cursor de texto está localizado ou ao início de quaisquer linhas selecionadas.

  &Ctrl;&Shift;D Ferramentas Descomentar

    Isto remove um espaço (se existir) do início da linha onde o cursor de texto está localizado ou do início de quaisquer linhas selecionadas.

### O Menu Configurações

Configurações Mostrar Barra de Ferramentas

  Quando habilitado, isto exibe uma barra de ferramentas móvel que contém botões usados para iniciar os comandos mais frequentemente usados. Quando desabilitado a barra de ferramentas é oculta.

Configurações Mostrar Barra de Estado

  Quando habilitado, isto exibe uma pequena barra na base do editor contendo informações sobre o estado do documento atual. Quando desabilitado a barra de estado é oculta.

Configurações Mostrar Caminho

  Quando selecionado, isto exibe na barra de título o caminho (a localização no sistema de arquivos) do documento atual. Quando desabilitado o caminho é oculto.

Configurações Configurar Editor...

  Este ítem de menu abre um diálogo de onde diversas configurações diferentes podem ser ajustadas.

Configurações Configurar Atalhos...

  Este comando abre uma caixa de diálogo de onde os atalhos de teclado podem ser mudados. Um quadro mostrado no topo da caixa de diálogo mostra a lista de comandos (ações) que pode ter atalhos de teclado. Abaixo do quadro estão três botões de opção. O usuário pode escolher entre Nenhuma Tecla, Tecla Padrão e Tecla Personalizada. (Observe que um conjunto de botões de opção somente permite a seleção de um dos ítens oferecidos - da mesma maneira que os botões de um rádio de um automóvel somente oferecem a seleção de uma estação pré-configurada. Observe também que a seleção Tecla Padrão está somente disponível para aqueles comandos que atualmente possuem um atalho 'padrão'.) Selecionar a opção de Tecla Personalizada ativa as três caixas de verificação e o botão tecla na base do diálogo. O usuário pode então selecionar uma combinação de teclas para o comando em questão usando as caixas de verificação e o botão tecla. Por exemplo, com o comando Sobre o KDE selecionado no quadro, o usuário pode selecionar &Ctrl; e Alt, clicar no botão tecla, e então pressionar a tecla K no teclado. Isto fará que sempre que alguém manter pressionado os botões &Ctrl; e Alt e pressionar o K (enquanto estiver usando o &kwrite;) a caixa Sobre o KDE será chamada.

Configurar Configurar Barra de Ferramentas...

  Isto abrirá o diálogo de onde a configuração da barra de ferramentas pode ser mudada. O usuário pode escolher que botões de atalho devem aparecer na barra de ferramentas. Um quadro à esquerda lista os comandos disponíveis para serem colocados na barra de ferramentas. O quadro à direita lista os comandos que já estão na barra de ferramentas. Um conjunto de quatro botões de seta entre os dois quadros manipulam as seleções. A seta apontando para direita coloca qualquer comando selecionado no painel esquerdo para o painel direito, isto é, ele adiciona-o à barra de ferramentas. A seta esquerda faz simplesmente o oposto, removendo qualquer ação selecionada no quadro direito da barra de ferramentas. As setas apontando para cima e para baixo mudam a posição da ação selecionada no quadro direito mudando a posição deste botão na barra de ferramentas.

### O Menu Ajuda

&help.menu.documentation;

## Configurar o &kwrite;

Selecionar Configurações Configurar Editor no menu levantará a caixa de diálogo Configurar Editor. Este diálogo pode ser usado para alterar diversas configurações diferentes. As configurações disponíveis para mudança variam de acordo com a categoria que o usuário escolhe a partir de uma lista vertical no lado esquerdo do diálogo. Por meio dos três botões ao longo da base da caixa o usuário pode controlar o processo.

Ele pode invocar o sistema de Ajuda, aceitar as configurações atuais e fechar o diálogo através do botão OK ou Cancelar. As categorias Cores, Fontes, Indentação, Seleção, Editar, Ortografia e Destaque são detalhadas abaixo.

### Cores

Esta seção fornece acesso à duas configurações diferentes de cores, descritas abaixo. Cada uma destas configurações pode ser mudada clicando em seu botão correspondente. Existem botões largos especias que são as cores da configuração atual. Clicar em um destes botões chama uma caixa de diálogo especial usada para mudar a configuração.

A caixa de diálogo de cores fornece uma maneira gráfica e conveniente de selecionar uma cor. Na parte superior esquerda da caixa existe uma caixa retangular que exibe um espectro de cores. Imediatamente à direita dela, existe uma barra vertical exibindo um intervalo de intensidade do mais escuro na base ao mais claro no topo. O usuário pode selecionar e ajustar uma cor clicando nestas duas caixas. Clicar no mostrador retangular seleciona uma mistura particular das cores vermelho, verde e azul e na barra vertical seleciona o nível de intensidade (valor). Os vários atributos da cor são exibidos na forma numérica nas pequenas caixa de texto localizadas imediatamente abaixo do retângulo de espectro e o usuário pode vê-los mudar conforme a cor é ajustada. Estes atributos incluem a mistura dos componentes básicos da cor (vermelho, verde e azul) bem como os níveis de brilho e contraste. Alternativamente, o usuário pode inserir valores diretamente nestas caixas. Existe também um quadro no centro da base da caixa de diálogo que sempre exibe a cor que está em consideração. À direita deste mostrador está outra caixa de texto rotulada HTML:. Esta caixa mostra ao usuário o código de cor que deve ser usado para especificar a cor exibida em particular no código HTML que é usado por páginas da Web.

Além do mencionado acima, o diálogo de cores permite capturar qualquer cor exibida atualmente na área de trabalho ou em outro programa. Clicar no botão com o ícone de conta-gotas (localizado à direita da caixa de diálogo) muda a forma do cursor do mouse para uma cruz. Clicar novamente obterá os atributos de cor de qualquer cor exibida sob a cruz.

Posteriormente o usuário tem a opção de adicionar qualquer cor a sua paleta pessoal de Cores Personalizadas clicando no botão largo rotulado Adicionar às Cores Personalizadas (que está localizado diretamente abaixo do quadro mostrador.) Isto adiciona a cor atual à paleta de cores personalizadas. Esta paleta e qualquer outra paleta disponível pode ser exibida usando a caixa combinada de seleção localizada imediatamente abaixo do mostrador de paleta do canto direito superior da caixa de diálogo. Através das cores personalizadas, o usuário pode acessar um número de paletas pré-preparadas.

Fundo

  Aqui o usuário pode especificar uma cor para o fundo em geral do &kwrite;.

Selecionado

  Isto permite ao usuário selecionar uma cor para ser usada para indicar porções selecionadas (ou destacadas) do documento.

### Fontes

Aqui você pode escolher a fonte padrão para o &kwrite;. Você pode escolher a partir de qualquer fonte disponível no seu sistema, e configurar um tamanho padrão e codificação. Um texto exemplo é exibido na base do diálogo, de modo que você possa ver o efeito da sua escolha.

### Indentação

Auto Indentar

  Isto faz com que novas linhas iniciem com o mesmo nível de indentação da linha anterior.

Indentar Com Espaços

  Isto substitui tabulações com o número de espaços selecionado na janela Largura da Tabulação na seção Editar do diálogo de configurações.

Tecla Backspace Indenta

  Isto permite que a tecla backspace seja usada para indentar.

Tecla Tab Indenta

  Isto permite que a tecla tab seja usada para indentar.

Manter Espaços Extra

  Indentação com mais que o número selecionado de espaços não serão encurtadas.

### Seleção

Seleções Persistentes

  Isto evita que uma entrada do teclado ou movimento do cursor através das teclas de seta provoque a eliminação do texto selecionado.

  (Observe: Se a opção Sobrescrever Seleções estiver ativada então qualquer caracter digitadou operação de colagem substituirá o texto selecionado.)

Sobrescrever Seleções

  Qualquer tecla de caracter digitada ou operação de colagem substituirá o texto selecionado.

Auto-copiar do Mouse

  Qualquer texto selecionado como mouse será automaticamente copiado para a área de transferência.

Seleção Estilo X11 Simples

  Não implementada ainda.

Seleções Verticais

  Isto ativa a opção de Seleção Vertical.

Alternar Antigo

  Não implementado ainda

### Editar

Quebra de Linha

  A quebra de palavra é um recurso que faz com que o editor automaticamente inicie uma nova linha de texto e mova (quebre) o cursor para o início da nova linha. O &kwrite; automaticamente iniciará uma nova linha de texto quando a linha atual atingir o comprimento especificado pela opção Quebrar Linhas Em:.

Quebrar Linhas Em:

  Se a opção Quebra de Linha estiver selecionada esta entrada determina o comprimento (em caracteres) no qual o editor automaticamente iniciará uma nova linha.

Substituir Tabulações Por Espaços

  O &kwrite; substituirá qualquer tabulação com o número de espaços indicados na entrada Largura da Tabulação:.

Largura da Tabulação

  Se a opção Substituir Tabulações Por Espaços estiver selecionada esta entrada determinará o número de espaços que o editor usará para substituir automaticamente as tabulações.

Remover Espaços Excedentes

  O &kwrite; automaticamente eliminará espaços extras no final das linhas de texto.

Auto Colchetes

  Quando o usuário digitar um colchete esquerdo ([, ( ou {) o &kwrite; irá inserir automaticamente o colchete direito (}, ) ou ]) à direita do cursor.

Agrupar Desfazer

  Agrupa ações similares que são consideradas como um passo único de Desfazer pelo &kwrite;. Em outras palavras, uma série de caracteres digitados (palavras ou expressões) pode ser considerado um passo e logo ser removido por uma única operação de desfazer. Se a série de entradas de caracter for interrompida por uma operação de entrada de um não-caracter (como um backspace), invocar o desfazer somente removerá as entradas feitas a partir desta operação. O próximo desfazer deverá então reverter aquela operação e assim por diante.

  Quando esta opção não está seleciona o &kwrite; considera cada digitação um passo único. Logo se o usuário (com esta opção ativa) for digitando diversas palavras ou sentenças sem realizar correções, cortar, colar ou alguma operação de entrada de um não-caracter e então clicar no botão desfazer isto eliminará tudo que foi digitado desde a última operação de entrada de um não-caracter. Um segundo clique eliminará esta operação e um terceiro qualquer operação ou série de entradas ocorridos antes da operação e assim por diante. Caso contrário, ao selecionar três cliques no botão desfazer removerá somente os três últimos caracteres digitados, ou as últimas três operações.

Mostrar Tabulações

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

Home Inteligente

  Não implementado ainda

Page Up/Down Move o Cursor

  Esta opção muda o comportamento do cursor quando o usuário pressiona as teclas Page Up ou Page Down. Se desselecionado o cursor do texto se manterá na sua posição relativa dentro do texto visível no &kwrite; conforme novo texto se torna visível como resultado da operação. Logo se o cursor estiver no meio do texto visível quando a operação ocorre ele permanecerá lá (exceto quando é atingido o início ou fim do texto.) Com esta opção selecionada, o primeiro pressionamento de tecla faz com que o cursor se mova para cima ou para baixo do texto visível conforme uma nova pasta de texto é exibida.

Quebrar Cursor

  Quando esta opção está selecionada, mover o cursor com as teclas de seta para o final de uma linha (à direita) faz com que ele salte para baixo no início da próxima linha. Por outro lado quando o cursor é movido para além do início da linha (à esquerda) ele salta para o final da linha anterior. Quando esta opção não está habilitada, mover o cursor para além do final da linha faz com que ele simplesmente continue horizontalmente na mesma linha e tentar movê-lo para esquerda após o início da linha não faz nada.

  Quando esta opção está selecionada, clicar com o mouse além do final da linha de texto colocará o cursor de inserção no final do texto, e não no local que você clicou. Isto evita a adição acidental de espaços vazios no meio do texto, e é o comportamento padrão da maioria dos editores.

Passos de desfazer:

  Aqui o usuário pode especificar o número de passos que o &kwrite; manterá na memória para fim de desfazer entradas e ações. Isto significa que quanto maior o número de passos configurados mais memória o &kwrite; usará para isto. Configurar esta entrada para 10 significa que o usuário será capaz de reverter as últimas dez operações, por exemplo clicar o botão desfazer 10 vezes e obter resultados.

Codificação

  Isto configura a codificação de caracteres para seu arquivo.

### Ortografia

Um verificador ortográfico é um programa desenvolvido para auxiliar o usuário a encontrar e corrigir erros de ortografia. Esta seção do diálogo de configurações permite algumas configurações importantes serem levadas em consideração.

Criar combinações de raiz/afixo não existentes no dicionário

  Selecionar esta opção permite que o verificador ortográfico registre como 'correto' combinações de palavras razi com sufixos ou prefixos sempre que uma combinação em particular não estiver listada na base de dados de palavras do seu dicionário.

Considerar palavras justapostas como erros ortográficos

  Selecionar isto faz com que o verificador ortográfico registre como 'desconhecido' duas ou mais palavras corretas ortograficamente que estão 'justapostas', isto é, que não possuam espaço separando-as.

Dicionário:

  Dependendo da instalação do usuário um ou mais dicionários de diferentes idiomas podem estar disponíveis. Esta caixa combinada permite ao usuário escolher que idioma o verificador ortográfico deve usar.

Codificação:

  Existem dos sistemas de codificação diferentes usados para associa códicos específicos à caracteres específicos e símbolos. Se o usuário conhece qual código ele está usando esta caixa combinada permite que este código seja especificado de modo que o verificador ortográfico possa fazer seu trabalho corretamente.

Cliente:

  Uma vez que o &kwrite; não contém seu próprio verificador ortográfico, um externo deve ser escolhido. Aqui é onde o usuário pode especificar qual programa de verificação ortográfica usar.

## Destaque

O diálogo de Configurar Destaque consiste de duas páginas: Padrões e Modos de Destaque. O usuário pode selecionar qual página visualizar clicando na aba apropriada no topo do diálogo.

Os ítens disponíveis na página Padrões são os seguintes:

Estilo de Ítem Padrão

  O usuário pode configurar a aparência padrão para ítens em particular. Isto permitirá um programador identificar mais facilmente os diferentes ítens (tipos de entradas) em seu código.

  Ítem

    Esta lista de caixa combinada oferece uma variendade de ítens que o usuário pode desejar destacar. Eles incluem Normal para texto que não corresponde a nenhuma das outras categorias, Comentário, String, Palavra-chave e muito mais. Nem todas as entradas precisarão ser configuradas para cada linguagem e assim podem ser selecionadas conforme o necessário. As opções no resto desta seção se aplicam à entrada selecionada nesta caixa.

  Normal

    Isto permite ao usuário escolher a cor normal (desselecionado) do ítem. Isto é feito através de uma caixa de diálogo de seleção de cores, e uma explanação completa sobre esta caixa pode ser encontrada na seção Cores do Configurar o KWrite.

  Negrito

    Esta opção determina se o ítem deve ser exibido em negrito ou não.

  Itálico

    Esta opção determina se o ítem deve ser exibido em itálico ou não.

  Selecionado

    Isto permite ao usuário escolher a cor do ítem quando selecionado. Isto é feito através de uma caixa de diálogo de seleção de cores, e uma explanação completa sobre esta caixa pode ser encontrada na seção Cores do Configurar o KWrite.

O ítens na aba Modos de Destaque permitem ao usuário definir mais especificamente destaques de acordo com o estilo de linguagem.

Não é necessário configurar todas as opções disponíveis. Ítens não configurados especialmente usarão a configuração padrão especificada na aba anterior (Padrões).

Selecionar Configuração

  Este grupo de opções é usado para personalizar estilos de destaque para cada tipo de linguagem de programação. Qualquer mudança qe você fizer em outras áreas deste diálogo somente se aplicarão para este tipo.

  Destaque

    Isto é usado para escolher o tipo de linguagem a configurar

  Ítem

    Isto é para escolher o ítem de sintaxe a configurar. Lembre-se que isto somente configura este ítem para esta linguagem.

  Como um exemplo, se o usuário desejar configurar a aparência dos comentários em C++, ele pode escolher o C++ na lista combinada Destaque, e então escolher Comentário na lista combinada Ítem. Para que os comentários se pareçam em todas as linguagens, ele precisará configurar isto na página Padrões desta caixa de diálogo enquanto deixa os comentários desconfigurados na página Modos de Destaque mais específica.

Estilo do Ítem

  Aqui o usuário pode configurar a aprência geral do ítem selecionado acima. Habilitar a caixa de verificação Padrão faz com que o estilo padrão configurado na aba anterior seja usado, ou a aparência pode ser configurada diretamente. As opções disponíveis são as mesmas da aba Padrões: Normal, Selecionado, Negrito e Itálico.

Auto-Selecionar Destaque

  O &kwrite; pode aplicar o destaque de sintaxe automaticamente, dependendo da extensão do arquibo ou o tipo mime do arquivo aberto. Os padrões são razoavelmente aceitáveis, mas usuários que editam regularmente arquivo com extensões não padrão pode adicioná-las aqui. Coringas são permitidos na caixa de texto Extensões de Arquivo. Por exemplo, a entrada padrão para a linguagem C++ é `*.cpp;*.cc;*.C;*.h`. Abrir um arquivo chamado `foo.h` automaticamente aplicará o estilo C++ a ele.

Fonte do Ítem

  Aqui o usuário pode escolher a fonte para o ítem selecionado.

  O estilo padrão pode ser aplicado habilitado a caixa de verificação Padrão ou o usuário pode escolher uma Família, Tamanho e Conjunto de Caracteres de fonte específico. As opções disponíveis são as mesmas da aba Padrões.

## Créditos e Licenças

Direitos Autorais do &kwrite; 2001 para a equipe do &kate;.

Baseado no &kwrite; original, que possui Direitos Autorais 2000 para Jochen Wilhelmy 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 Wilhely 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 de &Thad.McGinnis; &Thad.McGinnis.mail;

Esta versão do Manual do &kwrite; é baseada no original de &Cristian.Tibirna; &Cristian.Tibirna.mail;

Convertido para docbook/proofreading por &Lauri.Watts; &Lauri.Watts.mail;

Tradução de Marcus Gamamarcus_gama@uol.com.br

&underFDL; &underGPL;

&documentation.index;