# O Manual do &kwrite;

## Introdução

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

## Alguns Fundamentos

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

### Arrastar e Largar

O &kwrite; utiliza o protocolo 'Drag and Drop' do &kde;. Os ficheiros podem ser arrastados e largados no &kwrite; a partir do ecrã, do &konqueror; ou de algum 'site' &FTP; remoto aberto numa das janelas do &konqueror;.

### Opções da Linha de Comandos

Ainda que o &kwrite; possa ser geralmente iniciado a partir do menu de programas do &kde; ou de um ícone do ecrã, poderá ser aberto a partir da linha de comandos de uma janela de terminal. Existem algumas opções úteis que estão disponíveis ao fazer isto.

#### Especificar um Ficheiro

Ao indicar a localização e o nome de um ficheiro em particular, o utilizador poderá fazer com que o &kwrite; abra (ou crie) esse ficheiro imediatamente no seu arranque. Esta opção poderá traduzir-se em algo como o que se segue:

    %kwrite ficheiro.txt

#### Especficar um ficheiro na Internet

O método acima descrito poderia ser usado até para abrir os ficheiros na Internet (se o utilizador tiver uma ligação activa na altura). Um exemplo disso poderia ser o seguinte:

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

#### Outras Opções da Linha de Comandos

De momento, estão disponíveis as seguintes opções da linha de comandos:

``kwrite` `--help``

- Isto lista as opções mais básicas que estão disponíveis na linha de comandos.

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

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

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

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

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

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

``kwrite` `--author``

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

``kwrite` `--version``

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

### Associações de Teclas

Muitos dos comandos de teclado do &kwrite; (atalhos) são configuráveis através do menu Configuração. Por omissão o &kwrite; respeita a seguinte configuração de teclas.

Insert | Alterna entre o modo de Inserção e Sobreposição. Quando está no modo de inserção, o editor irá adicionar os caracteres introduzidos ao texto e empurrar os dados introduzidos anteriormente à direita do cursor do texto. O modo de sobreposição fará com que a introdução de cada carácter elimine o carácter imediatamente à direita do cursor.
Esquerda | Move o cursor um carácter para a esquerda
Direita | Move o cursor um carácter para a direita
Cima | Sobe o cursor uma linha
Baixo | Desce o cursor uma linha
Page Up | Move o cursor uma página para cima
Page Down | Move o cursor uma página para baixo
Backspace | Apaga o carácter à esquerda do cursor
Home | Move o cursor para o início da linha
End | Move o cursor para o fim da linha
Delete | Apaga o carácter à direita do cursor (ou qualquer texto seleccionado)
&Shift;Esquerda | Marca o texto que está um carácter à esquerda
&Shift;Direita | Marca o texto que está um carácter à direita
F1 | Ajuda
&Shift;F1 | O que é isto?
&Ctrl;F1 | Procurar
F3 | Procurar seguinte
&Ctrl;C | Copia o texto seleccionado para a área de transferência.
&Ctrl;M | Marca um Favorito
&Ctrl;N | Cria um Novo documento
&Ctrl;P | Imprimir
&Ctrl;Q | Sair - fecha a cópia activa do editor
&Ctrl;R | Substituir
&Ctrl;S | Invoca o comando Gravar.
&Ctrl;V | Cola o texto da área de transferência no campo de edição.
&Ctrl;X | Apaga o texto seleccionado e copia-o para a área de transferência.
&Ctrl;Z | Desfazer
&Ctrl;&Shift;Z | Refazer

## As Opções do Menu

### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

- Isto inicia um novo documento no editor. Se existir um documento na altura com alterações por gravar, é dada ao utilizador a oportunidade de o gravar.

&Ctrl;O Ficheiro Abrir...

- Este comando abre um ficheiro. Efectua esta operação através de uma janela que permite ao utilizador navegar pelo sistema de ficheiros. A janela funciona como um pequeno gestor de ficheiros. Se carregar nas directorias mostradas na janela central direcciona a janela para entrar dentro dessa directoria, mostrando o seu conteúdo. Existe uma lista que pode ser usada para indicar directamente a localização e o nome do ficheiro ou carregando na seta ao lado para escolher uma das localizações mais recentes. Por baixo desta, existem um filtro que, de forma semelhante, poderá ter dados introduzidos directamente ou escolhidos a partir de uma lista de tipos de filtros recentes. A funcionalidade dos filotro permite apenas aos ficheiros que obedeçam a essa especificação serem visualizados na janela central. Se o filtro contivesse texto do tipo `*.txt`, então apenas os ficheiros com a extensão `txt` seriam visíveis na janela de selecção. Por baixo do filtro, existe uma barra de estado que indica informações sobre o número de ficheiros e sub-directorias na directoria actual.

  A barra de ferramentas, a qual se encontra no topo da janela, tem uns botões com setas para a esquerda e para a direita que permitem ao utilizador andar para trás e para a frente nas directorias seleccionadas previamente, assim como uma seta para cima para subir na estrutura de directorias. O botão com a pequena casa leva o utilizador para a sua directoria pessoal, correspondendo finalmente o botão com as setas curvas à actualização da vista sobre a directoria actual. O botão da bandeira permite ao utilizador atribuir um novo favorito à directoria actual ou saltar para um favorito previamente definido.

  O último botão na barra de ferramentas permite-lhe criar uma nova directoria e mesmo alterar algumas opções básicas da janela; finalmente existe uma lista com as directorias mais frequentadas.

Ficheiro Abrir Recente

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

&Ctrl;S Ficheiro Gravar

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

Ficheiro Gravar Como...

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

&Ctrl;P Ficheiro Imprimir...

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

Ficheiro Nova Vista

- Isto cria uma nova vista sobre o documento actual, &ie;, uma nova instância do &kwrite; (tal como descrito no item anterior) que contém o mesmo documento.

&Ctrl;Q Ficheiro Sair

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

### O Menu Editar

&Ctrl;Z Editar Desfazer

- Isto é usado para eliminar ou reverter a última acção ou operação feita pelo utilizador. O que corresponde uma destas acção poderá ser melhor compreendido na secção de Agrupar o Desfazer deste ficheiro de ajuda.

&Ctrl;&Shift;Z Editar Refazer

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

Editar Histórico do Desfazer/Refazer

- Isto irá abrir uma lista com as acções mais recentes à direita, assim como outra lista das acções que foram 'desfeitas' ou anuladas à direita. Existem também três botões à direita da janela chamados Desfazer, Refazer e Fechar. Se carregar no botão Desfazer, fará com que a acção no topo da lista Desfazer seja anulada, o que colocará essa acção em particular no topo da lista Refazer. De igual forma, se carregar no botão Refazer fará com que se repita a acção anulada e que seja resposta à lista Desfazer. Se carregar num item por baixo do item de topo de qualquer uma das listas, fará com que todos os itens desde o topo até essa acção em particular fiquem seleccionados. A selecçãod o botão respectivo fará com que todas as acções seleccionadas sejam anuladas ou repetidas. Isto seria particularmente útil quando o utilizador soubesse precisamente o ponto a partir do qual deseja prosseguir - deixando de ser necessário percorrer uma série de acções de anulação ou repetição singulares.

&Ctrl;X Editar Cortar

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

&Ctrl;C Editar Copiar

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

&Ctrl;V Editar Colar

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

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

Editar Inverter a Selecção

- Isto selecciona todo o texto não seleccionado, enquanto que deselecciona o texto previamente seleccionado - de facto, inverte o estado actual da selecção.

&Ctrl;G Editar Ir para a linha

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

&Ctrl;F Editar Procurar

- Isto abre a janela de procura, a qual é usada para especificar o Texto a Procurar no documento. Existe um pequeno campo de texto onde se deve indicar o padrão de procura, o qual é também uma lista. Se carregar na seta da lista poderá usar os padrões de pesquisa mais recentes. Os outros parâmetros são incluídos para tornar a pesquisa mais eficiente. A selecção do Distinguir Maiúsculas irá limitar as pesquisas aos registos que correspondam à capitalização (maiúsculas ou minúsculas) de cada um dos caracteres no padrão de procura. O Procurar para Trás direcciona a pesquisa para percorrer no sentido superior. A opção Texto Seleccionado mantém a procura apenas no texto seleccionado no momento. A opção Apenas Palavras Completas evita que a procura pare nas palavras que contêm o padrão a procurar. A opção A Partir do Cursor inicia a procura a partir da posição actual do cursor dentro do documento em vez de ser a partir do início.

F3 Editar Procurar Seguinte

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

&Shift;F3 Editar Procurar Anterior

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

&Ctrl;R Editar Substituir

- Este comando abre a janela de substituição. Esta é praticamente idêntica à janela de procura descrita acima. Para além das funcionalidades da janela de procura, contém um campo de texto/lista Substituir Por:. Com esta janela, o utilizador pode especificar tanto o texto a ser encontrado como o texto com o qual o substituir. A opção adicional Perguntar ao Substituir permite ao utilizador confirmar sempre que o &kwrite; pedir essa confirmação antes de cada substituição.

&Ctrl;M Editar Comando de Edição

### O Menu Favoritos

&Ctrl;B Favoritos Comutar o Favorito

Favoritos Limpar os Favoritos

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

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

### O Menu Ferramentas

Ferramentas Verificação Ortográfica...

- 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 três campos de texto alinhados verticalmente no centro da janela com as suas legendas correspondentes à sua esquerda. A começar por cima estas são:

  Palavra Errada:

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

Substituição:

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

Sugestões:

- 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 Substituição em cima.

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

Substituir

- Este botão faz com que o corrector substitua a palavra em consideração no documento com a palavra no campo Substituição:.

Substituir Tudo

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

Ignorar

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

Ignorar Tudo

- Este botão diz ao corrector ortográfico para não fazer nada com a Palavra Errada: 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 ele irá parar na mesma palavra.

Adicionar

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

Parar

- Este botão interrompe o processo de verificação ortográfica.

Localizada horizontalmente na parte inferior da janela de verificação ortográfica existe uma barra de progresso. À medidade que o processo de verificação ortográfica decorre a barra vai sendo preenchida para dar uma representação gráfica do percurso no documento. Para além disso, o progresso é mostrado numericamente no centro da barra de progresso.

Também é apresentada numericamente a evolução do processo de verificação ortográfica na barra de estado do editor. A barra de estado é a tira horizontal no fundo do editor por baixo do campo de texto.

Existem mais dois botões por baixo da barra de progresso. Estes são:

Ajuda

- Este invoca o sistema de ajuda tendo como base as páginas de ajuda do &kwrite; (este documento).

Cancelar

- Este botão cancela o processo de verificação ortográfica.

Ferramentas Indentar

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

Ferramentas Desindentar

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

Ferramentas Limpar a Indentação

- Ainda não implementado

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.

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;I Ferramentas Indentar

&Ctrl;U Ferramentas Desindentar

Ferramentas Limpar a Indentação

&Ctrl;# Ferramentas Comentar

&Ctrl;&Shift;I Ferramentas Descomentar

### O Menu Configuração

Configuração Mostrar a Barra de Ferramentas

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

Configuração Mostrar a Barra de Estado

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

Configuração Mostrar a Localização

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

Configuração Configurar Teclas

- Este comando abre uma janela onde se poderão alterar as associações de teclas. Uma área no topo da janela mostra a lista de comandos (acções) que poderão ter atalhos de teclado. Por baixo da área existem três opções exclusivas. O utilizador poderá optar entre Sem Tecla, Tecla Predefinida ou Tecla Personalizada. (A selecção da Tecla Predefinida assume que existe um atalho de teclado 'predefinido'). A selecção da opção Tecla Personalizada activa as três opções no fundo da janela. O utilizador poderá então seleccionar uma combinação de teclas para o comando em questão através das opções e da tecla. Por exemplo, com o comando Acerca do KDE seleccionado na área de visualização, o utilizador poderia seleccionar o &Ctrl; e o Alt, carregar no botão da tecla e depois no K do teclado. Isso significaria que, sempre que ele carregasse nas teclas &Ctrl; e Alt, seguidas da tecla K (enquanto usar o &kwrite;), seria chamada a janela do Acerca do KDE.

Configuração Configurar as Barras de Ferramentas

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

Configuração Configurar o Editor

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

F6 Configuração Mostrar o Contorno do Ícone

- Activa a visualização de um contorno à esquerda da janela de edição, onde serão mostrados os favoritos ao lado da linha em que se aplicam.

F4 Configuração Selecção Vertical

- Isto é usado para ligar ou desligar a funcionalidade da selecção vertical. Esta permite ao texto ser seleccionado por coluna assim como por linha. Por outras palavras, graças a esta funcionalidade o utilizador é capaz de seleccionar o texto que está contido em apenas algumas colunas e linhas contíguas em particular. De facto, o utilizador conseguirá escolher uma área rectangular de texto em qualquer local do documento.

Configuração Modo de Realce

- Isto permite ao utilizador escolher o estilo do realce de sintaxe que o editor usa para mostrar o texto. Os estilos são seleccionados pela linguagem de programação. A informação do tipo de letra/cor não é armazenada com o documento.

Configuração Fim de Linha

- Isto abre um sub-menu a partir do qual o utilizador poderá seleccionar o tipo de código de fim de linha para o &kwrite; usar, i.e., a norma aceite e que é usada pelo &UNIX;, pelo &Mac; ou pelo MSDOS/&Windows;.

### O Menu Ajuda

&help.menu.documentation;

## Configurar o &kwrite;

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

O(a) utilizador(a) pode invocar o sistema de Ajuda, aceitar a configuração actual e fechar a janela, através do botão OK ou Cancelar o processo. As categorias Cores, Tipos de Letra Indentação, Selecção, Edição, Verificação Ortográfica e Realce são detalhadas em baixo.

### Cores

Esta secção permite o acesso a duas opções diferentes de cores, e que são descritas em baixo. Cada uma dessas opções pode ser alterada ao carregar no seu botão correspondente. Estes são botões especialmente largos com a cor da configuração actual. Ao carregar num dos botões fará aparecer uma janela de cores especial que é usada para alterar a opção.

A janela de cores oferece uma forma conveniente e gráfica de seleccionar uma cor. Na parte superior esquerda da janela existe uma visualização rectangular do espectro de cores. Logo à direita existe uma barra vertical que mostra um intervalo de intensidade do mais escuro em baixo até ao mais claro em cima. O utilizador poderá seleccionar e ajustar uma cor carregando nessas duas áreas. Se carregar na área rectangular selecciona uma mistura em particular de vermelho, verde e azul, enquanto que na vertical sselecciona um nível de intensidade (valor). Os várois atributos de cores são mostrados num formato numérico em pequenos campos de texto colocados logo por baixo do rectângulo com o espectro e o utilizador poderá vê-los a serem alterados à medida que a cor é ajustada. Esses atributos incluem a mistura das componentes básicas da cor (vermelho, verde e azul), assim como os níveis de matiz e saturação. Em alternativa, o utilizador poderá introduzir figuras directamente nesses campos. Existe também um quadrado em baixo que mostra a cor que está a ser considerada em qualquer altura. À direita desse quadrado, está também outro campo chamado HTML:. Este mostra ao utilizador o código de cor que deveria ser usado para especificar a cor mostrada em particular no código de HTML que é usado com frequência nas páginas Web.

Para além do acima descrito, a janela de cores permite a captura de qualquer cor mostrada de momento no ecrã ou noutro programa. Se carregar no botão com o ícone do conta-gotas (localizado à direita na janela), muda a forma do cursor do rato para uma mira. Se carregar de novo irá obter os atributos de cor da cor que estiver sob a mira.

Para além disso, o utilizador tem a opção de adicionar qualquer cor a uma paleta especial de Cores Personalizadas ao carregar no botão largo Adicionar às Cores Personalizadas (que se encontra exactamente por cima do quadrado de visualização). Isto adiciona a cor actual à paleta de cores personalizadas. Esta paleta, assim como todas as outras disponíveis, poderá ser mostrada usando a lista de selecção localizada imediatamente por cima da visualização da paleta no canto superior direito da janela. Para além das cores personalizadas, o utilizador pode aceder a uma quantidade de paletas predefinidas.

Fundo

- Aqui o utilizador pode especificar uma cor para o fundo geral do &kwrite;.

Seleccionado

- Isto permite ao utilizador seleccionar uma cor para ser usada para indicar a parte seleccionada (ou realçada) do documento.

### Tipos de Letra

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

### Indentar

Auto Indentar

- Isto faz com que as novas linhas comecem com o mesmo nível de indentação que a linha anterior.

Indentar com Espaços

- Isto substitui as tabulações com o número de espaços seleccionado na janela do Tamanho da Tabulação na secção Edição da janela de preferências.

Indentação com a Tecla Backspace

- Isto permite usar a tecla Backspace para indentar.

Indentação com a Tecla Tab

- Isto permite usar a tecla Tab para indentar.

Manter Espaços Extra

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

### Seleccionar

Selecções Persistentes

- Isto evita que a introdução de texto ou a moviemtação do cursor através das teclas de cursores elimine a selecção do texto.

  (Nota: Se a opção Substituir Selecções estiver activa, então qualquer carácter escrito ou operação de colagem irá substituir o texto seleccionado).

Substituir as Selecções

- Todos os caracteres escrito ou operações de colagem irão substituir o texto seleccionado.

Auto-Cópia com o Rato

- Todo o texto seleccionado com o rato será copiado automaticamente para a área de transferência.

Selecção Simples à X11

- Ainda não implementado.

Selecções Verticais

- Isto activa a opção Selecções Verticais.

Comutar o Antigo

- Ainda não implementado

### Editar

Mudança de Linha

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

Mudar Palavras Em:

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

Substituir Tabs por Espaços

- O &kwrite; irá substituir os caracteres Tab introduzidos por um número conveniente de espaços, tal como definido na Tabulação.

Tabulação

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

Remover os Espaços Finais

- O &kwrite; 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 &kwrite; introduz automaticamente o parêntesis direito (}, ) ou ]) à direita do cursor.

Agrupar as Anulações

- Os grupos de acções semelhantes são considerados um único passo no Desfazer pelo &kwrite;. Por outras palavras, uma série de escrita regular de caracteres (palavras ou expressões) seria considerado como um passo e, como tal, seria removido através de uma única operação de anulação. Se a série de entradas de caracteres for interrompida por uma operação que não a introdução de um carácter (como um Backspace), a invocação da anulação só irá remover os registos feitos desde essa operação. A próxima anulação irá então reverter essa operação e assim por diante.

  Quando esta opção não estiver seleccionada, o &kwrite; considera cada sequência de teclas como sendo um único passo. Por isso, se o utilizador (com esta opção activa) escrever várias palavras ou mesmo frases inteiras sem fazer correcções, cópias ou colagens, assim como qualquer operação de com objectos sem serem caracteres, então a execução da operação DEsfazer iria eliminar tudo o que tinha sido escrito desde a última operação sem envolver caracteres. Um segundo 'click' irira remover essa operação e um terceiro todas as operações ou sequências de itens que ocorreram antes da operação e assim por diante. Se não estiver seleccionada, os três 'clicks' do botão Desfazer iriam remover apenas as últimas três letras escritas ou as últimas três operações.

Mostrar Tabs

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

Início Inteligente

- Ainda não implementado

O Page Up/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 &kwrite; à 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.

Mudar o Cursor

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

  Quando esta opção for escolhida, ao carregar com o rato para além do fim da linha de texto, colocará o cursor de inserção no fim do texto e não no sítio em que carregou. Isto evita a hipótese de adicionar um espaço em branco no meio do texto e é o comportamento por omissão na maioria dos editores.

Passos do desfazer:

- Aqui, o utilizador poderá indicar o número de passos que o &kwrite; irá reter em memória com o intuito de desfazer os registos e as acções. Isto significa que, quanto maior o número de passos, maior a quantidade de memória que o &kwrite; irá usar para isto. A atribuição do valor 10 a este campo significará que o utilizador poderá reverter as últimas dez operações, i.e., carregar no botão Desfazer 10 vezes e obter resultados.

Codificação

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

### Correcção Ortográfica

Um verificador ortográfico é um programa desenhado para ajudar o utilizador a descobrir e a corrigir os erros ortográficos. Esta secção da janela de preferências permite que sejam ajustadas certas opções importantes com este objectivo.

Criar combinações raiz/afixo que não estão no dicionário

- Ao seleccionar esta opção, permite ao verificador ortográfico registar como 'correctas' as combinações de radicais das palavras com os sufixos ou prefixos mesmo que essa combinação em particular não conste na base de dados de palavras do seu dicionário.

Considerar as palavras coladas como erros

- Ao seleccionar isto fará com que o verificador ortográfico registe como 'erradas' duas ou mais palavras correctas que estejam 'coladas', i.e., que não tenham espaços entre elas.

Dicionário:

- Dependendo da instalação do utilizador, poderão estar um ou mais dicionários ortográficos para línguas diferentes. Esta lista permite ao utilizador escolher qual a língua que o verificador ortográfico deverá usar.

Codificação:

- Existem diversos sistemas de codificação usados para associar os códigos específicos com os caracteres e símbolos adequados. Se o utilizador souber qual o código que está a usar, esta lista permite especificar este código para que o verificador ortográfico desempenhe a sua função correctamente.

Cliente:

- Dado que o &kwrite; não contém o seu próprio verificador ortográfico, tem de ser usado um externo. Aqui é onde o utilizador poderá indicar qual o programa de verificação ortográfica a usar.

## Realce

A janela de Configurar o Realce consiste em duas páginas, a Predefinições e os Modos de Realce. O utilizador pode seleccionar qual a página que deseja ver, carregando na secção apropriada na parte superior da janela.

Os itens disponíveis na página Predefinições são os seguintes:

Estilos de Itens por Omissão

- O utilizador pode configurar a aparência por omissão para os itens em particular. Isto permitirá a um programador identificar mais facilmente os diferentes itens (tipos de registos) no seu código.

  Item

- Esta lista oferece uma quantidade de itens que o utilizador poderá querer realçar. Estes incluem o Normal para o texto que não se encaixe em nenhuma das outras categorias, o Comentário, o Texto, a Palavra-Chave entre muitos outros. Nem todos esses itens terão de ser configurados para cada língua e, como tal, poderão ser seleccionados de acordo com as necessidades. As restantes opções nesta secção aplicam-se ao item seleccionado nesta lista.

Normal

- Isto permite ao utilizador escolher a cor normal (não seleccionada). Isto é obtido através de uma janela de selecção de cores; poder-se-á encontrar uma explicação posterior na secção Cores do Configurar o KWrite.

Negrito

- Esta opção determina se o item deve ou não ser mostrado com o texto a negrito.

Itálico

- Esta opção decide se o item deve ser desenhado com um tipo de letra itálico.

Seleccionado

- Isto permite ao utilizador escolher a cor do item quando estiver seleccionado. Isto é obtido através de uma janela de selecção de cores; poder-se-á encontrar uma explicação posterior na secção Cores do Configurar o KWrite.

Os itens na página Modos de Realce permitem ao utilizador definir um realce mais específico, dependendo do estilo da linguagem.

Uma pessoa não precisa de definir todas as opções disponíveis; nesse caso, os itens não configurados explicitamente irão usar a configuração por omissão especificada na página anterior (a Predefinições).

Configurar a Selecção

- Este grupo de opções é usado para personalizar os estilos de realce para cada tipo de linguagem de programação. Todas as alterações que fizer nas outras áreas desta janela só se irão aplicar a este tipo.

  Realce

- Isto é usado para mudar o tipo de linguagem a configurar

Item

- Aqui pode escolher o item de sintaxe a configurar. Lembre-se que isto só configura este item para esta linguagem.

Como exemplo, se o utilizador quiser configurar a aparência dos comentários ao programar em C++, poderá escolher o C++ na lista de Realce, escolhendo de seguida o Comentário na lista do Item. Para que os comentários fiquem todos iguais em todas as linguagens, o utilizador deveria configurar este item na página Predefinições desta janela, deixando os comentários por configurar na página de Modos de Realce.

Estilo do Item

- Aqui o utilizador poderá configurar a aparência visual do item seleccionado em cima. Ao assinalar a opção Por Omissão faz com que se atribua o estilo por omissão, tal como definido na página anterior; caso contrário, a aparência poderá ser configurada directamente. As opções disponíveis são as mesmas da página Predefinições: Normal, Seleccionado, Negrito e Itálico.

Detecção do Realce

- O &kwrite; pode aplicar automaticamente o realce de sintaxe, dependendo da extensão ou do tipo MIME do ficheiro aberto. As predefinições são suficientemente compreensíveis, mas os utilizadores que editam regularmente os ficheiros com estensões não normalizadas poderão adicioná-las aqui. São permitidos os caracteres especiais '*' e '?' no campo de texto Extensões dos Ficheiros. Por exemplo, o campo por omissão para a linguagem C++ é igual a `*.cpp;*.cc;*.C;*.h`. Se abrir um ficheiro chamado `ola.h`, também lhe será aplicado o estilo de C++.

Tipo de Letra do Item

- Aqui o utilizador poderá escolher o tipo de letra para o item seleccionado.

  O estilo por omissão poderá ser aplicado ao assinalar a opção Por Omissão; o utilizador também poderá escolher uma Família, um Tamanho e uma Codificação específicos do tipo de letra. As opções disponíveis são as mesmas da página Predefinições.

## Créditos e Licenças

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

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

Contribuições:

- Christoph Cullmann cullmann@kde.org

- Michael Bartl michael.bartl1@chello.at

- Phlip phlip_cpp@my-deja.com

- Anders Lund anders@alweb.dk

- Matt Newell newellm@proaxis.com

- Joseph Wenninger jowenn@bigfoot.com

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

- Michael Koch koch@kde.org

- Christian Gebauer gebauer@bigfoot.com

- Simon Hausmann hausmann@kde.org

- Glen Parker glenebob@nwlink.com

- Scott Manson sdmanson@altel.net

- John Firebaugh jfire@uclink.berkeley.edu

Documentação Original por Thad McGinnis ctmcginnis@compuserve.com

Esta versão do Manual do &kwrite; baseia-se no original de Cristian Tibirna tibirna@kde.org

Convertido para docbook/revisão ortográfica por Lauri Watts lauri@kde.org

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL; &underGPL;

## Instalação

&install.intro.documentation; &install.compile.documentation;
&documentation.index;