# O Manual do &kwrite;

&Thad.McGinnis; &Thad.McGinnis.mail;
&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;
&Anders.Lund; &Anders.Lund.mail;
&Christoph.Cullmann; &Christoph.Cullmann.mail;
&Lauri.Watts; &Lauri.Watts.mail;
José
Pires

    jncp@netcabo.pt

Tradução
2000
2001
&Thad.McGinnis;
2005
&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;
&Anders.Lund; &Anders.Lund.mail;
&FDLNotice;
2005-12-27
4.5.0

&kwrite; is a text editor for &kde;

KDE
KWrite
texto
editor

## Introdução

&kwrite; is more than a text editor for the &kde; Desktop. It is meant to be a programmer's editor, and could be considered as at least a partial alternative to more powerful editors. It may be best used in conjunction with &konqueror; for source file browsing for different languages. &kwrite; also works very well as a simple text editor. One of &kwrite;'s main features is the colorized syntax, customized for many different programming languages such as: C/C++, &Java;, Python, Perl, Bash, Modula 2, &HTML;, and 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

&kwrite; uses the &kde; Drag and Drop protocol. Files may be dragged and dropped onto &kwrite; from the Desktop, &konqueror; or some remote &FTP; site opened in one of &konqueror;'s windows.

### Opções da Linha de Comandos

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

#### Indicar um Ficheiro

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

    % kwrite
    /home/eu/documentos/ficheiro.txt

#### Specify a file on the internet

The above-mentioned method could even be used to open files on the internet (if the user has an active connection at the time.) An example of this might look like the following:

    % 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``

``kwrite` `--stdin``

  Faz com que o &kwrite; leia o conteúdo do documento a partir do STDIN. Isto é semelhante à opção comum `-`, que é usada em muitos programas da linha de comandos, permitindo-lhe encaminhar o resultado dos comandos para o &kwrite;.

``kwrite` `--encoding` `encoding` `&URL;``

  Faz com que o &kwrite; use a codificação indicada para o documento.

``kwrite` `--line` `linha` `&URL;``

  Vai para a linha indicada, após abrir o documento.

``kwrite` `--column` `coluna` `&URL;``

  Vai para a coluna indicada, após abrir o documento.

### Atalhos

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

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
&Alt;Page Up | Favorito Anterior
Page Down | Move o cursor uma página para baixo
&Alt;Page Down | Favorito Seguinte
Backspace | Apaga o carácter à esquerda do cursor
Home | Move o cursor para o início da linha
End | Move o cursor para o fim da linha
Delete | Apaga o carácter à direita do cursor (ou qualquer texto seleccionado)
&Shift;Esquerda | Marca o texto que está um carácter à esquerda
&Shift;Direita | Marca o texto que está um carácter à direita
F1 | Ajuda
&Shift;F1 | O que é isto?
F3 | Find again
&Shift;F3 | Procurar o Anterior
&Ctrl;A | Seleccionar Tudo
&Ctrl;&Shift;A | Deseleccionar
&Ctrl;&Shift;B | Modo de Selecção em Bloco
&Ctrl;B | Marca um Favorito
&Ctrl;C | Copia o texto seleccionado para a área de transferência.
&Ctrl;D | Comentar
&Ctrl;&Shift;D | Descomentar
&Ctrl;F | Procurar
&Ctrl;G | Vai para a linha...
&Ctrl;I | Indenta a selecção
&Ctrl;&Shift;I | Remove a indentação da selecção
&Ctrl;J | Juntar as Linhas
&Ctrl;N | Cria um Novo documento
&Ctrl;O | Abrir um documento
&Ctrl;P | Imprimir
&Ctrl;Q | Sair - fecha a cópia activa do editor
&Ctrl;R | Substituir
&Ctrl;S | Invoca o comando Gravar.
&Ctrl;U | Maiúsculas
&Ctrl;&Shift;U | Minúsculas
&Alt;&Ctrl;U | Capitalização
&Ctrl;V | Cola o texto da área de transferência no campo de edição.
&Ctrl;W | Fechar
&Ctrl;X | Apaga o texto seleccionado e copia-o para a área de transferência.
&Ctrl;Z | Desfazer
&Ctrl;&Shift;Z | Refazer
&Ctrl;- | Fechar um Nível Local
&Ctrl;&Shift;- | Fechar o Nível de Topo
&Ctrl;+ | Expandir um Nível Local
&Ctrl;&Shift;+ | Expandir o Nível de Topo
F5 | Actualizar
F6 | Mostrar/Esconder o Contorno dos Ícones
F7 | Mudar para a Linha de Comandos
F9 | Mostrar/Esconder as Marcas de Desdobramento
F10 | Dynamic Word Wrap
F11 | Mostrar/Esconder os Números de Linha

## As Opções do Menu

### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

  This starts a new Document in the editor. If there is a current document with unsaved changes the user is given a chance to save it.

&Ctrl;O Ficheiro Abrir...

  Mostra uma janela normal do &kde; para Abrir um Ficheiro. Use a janela de ficheiros para seleccionar o ficheiro que deseja abrir, carregando depois em Abrir para aceder a ele. Poderá encontrar mais informações sobre a janela do &kde; para Abrir um Ficheiro no Guia de Utilizador do &kde;.

Ficheiro Abrir um Recente

  This is a shortcut to open recently saved documents. Clicking on this item opens a list to the side of the menu with several of the most recently saved files. Clicking on a specific file will open it in &kwrite; - if the file still resides at the same location.

&Ctrl;S Ficheiro Gravar

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

Ficheiro Gravar Como...

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

F5 Ficheiro Actualizar

  Reloads the active file from disk. This command is useful if another program or process has changed the file while you have it open in &kwrite;.

&Ctrl;P Ficheiro Imprimir...

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

File Export as HTML...

  Export your file in HTML format so your document can be viewed as a web page.

&Ctrl;W Ficheiro Fechar

  Close the active file with this command. If you have made unsaved changes, you will be prompted to save the file before &kwrite; closes it.

&Ctrl;Q Ficheiro Sair

  This will close the editor window, if you have more than one instance of &kwrite; running, through the New View or New Window menu items, those instances will not be closed.

### O Menu Editar

&Ctrl;Z Editar Desfazer

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

&Ctrl;&Shift;Z Editar Refazer

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

&Ctrl;X Editar Cortar

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

&Ctrl;C Editar Copiar

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

Edit Copy as HTML

  This copies the currently selected text to the clipboard as HTML.

&Ctrl;V Editar Colar

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

&Ctrl;A Editar Seleccionar Tudo

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

&Ctrl;&Shift;A Editar Deseleccionar

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

&Ctrl;&Shift;B Edit Bloc Selection Mode

  Toggles Selection Mode. When the Selection Mode is “BLOCK”, you can make vertical selections, ie select column 5 to 10 in lines 9 to 15. The status bar shows the current state of the Selection Mode, either “NORM” or “BLK”.

Insert Edit Overwrite Mode

  Toggles the Insert/Overwrite modes. When the mode is "INS", you insert characters where the cursor is. When the mode is "OVR", writing characters will replace the current characters if your cursor is positioned before any character. The status bar shows the current state of the Overwrite Mode, either “INS” or “OVR”.

&Ctrl;F Edit Find

  This opens the find dialog which is used to specify the Text to Find in the document. There is small text box for entering the search pattern which also doubles as a dropdown box. Clicking on the dropdown arrow at the side of the box makes available other recent search patterns. Other parameters are included to make the search more efficient. Selecting Case Sensitive will limit finds to entries that match the case (upper or lower) of each of the characters in the search pattern. Find Backwards directs the search to proceed in an upwardly direction. The Selected Text option keeps the search within currently selected text. Checking Whole Words Only prevents the search from stopping on words that contain the searched for pattern. The Search from Cursor option begins the search from the current position of the cursor within the document rather than from the beginning.

F3 Editar Procurar o Seguinte

  This repeats the last find operation, if any, without calling the find dialog box.

&Shift;F3 Editar Procurar Anterior

  This repeats the last find operation, if any, without calling the find dialog box, and searching backwards instead of forwards through the document.

&Ctrl;R Editar Substituir...

  This command opens the replace dialog box. The replace dialog is almost identical to the above-mentioned find dialog. In addition to the features in the find dialog it contains a Replace With: text entry/dropdown box. Using this dialog the user can specify both the text to be found and text with which to replace it. The additional Prompt On Replace option allows the user to have &kwrite; ask for confirmation before each replacement.

&Ctrl;G Edit Go to line

  This opens the goto line dialog box which is used to have the cursor jump to a particular line (specified by number) in the document. The line number may be entered directly into the text box or graphically by clicking on the up or down arrow spin controls at the side of the text box. The little up arrow will increase the line number and the down arrow decrease it. There is also a slide control to the right of the text box which allows the user to move the goto point in the document in an analog manner.

### O menu Ver

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

Ver Nova Janela

  Opens a new window with the same text.

F7 Ver Mudar para a Linha de Comandos

  Displays the Katepart command line at the bottom of the window. In the command line, type "help" to get help and "help list" to get a list of commands.

View Schema

  Selecciona um esquema de tipos de letra.

F10 Ver Mudança de Linha Dinâmica

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

F10 View Dynamic Word Wrap Indicators

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

Ver Mostrar o Indicador de Mudança de Linha Estática

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

F6 Ver Mostrar o Contorno do Ícone

  This is a toggle item. Setting it on checked will make the side of the active editor, and vice versa.

F11 Ver Mostrar os Números de Linha

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

Ver Mostrar as Marcas da Barra de Posicionamento

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

F9 Hide Folding Markers

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

Code Folding
  Ctrl Shift- Collapse Toplevel

    Recolhe todas as regiões de topo do documento.

  Ctrl Shift+ Expand Toplevel

    Expande todas as regiões de topo do documento.

  Ctrl - Collapse One Local Level

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

  Ctrl + Expand One Local Level

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

### O Menu Favoritos

&Ctrl;B Favoritos Comutar o Favorito

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

Favoritos Limpar Todos os Favoritos

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

Alt Page Up Bookmarks Previous

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

Alt Page Down Bookmarks Next

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

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

### O Menu Ferramentas

Ferramentas Modo Apenas de Leitura

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

Tools Filletype

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

Tools Highlighting

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

Tools Indentation

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

Tools Encoding

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

Tools End of Line

  Choose your prefered end of line mode for your active document. This overwrites the global end of line mode set in Settings Configure Editor... for your current document only.

Ferramentas Ortografia...

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

  Palavra desconhecida:

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

  Substituir por:

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

  Suggested Words:

    The checker may list here a number of possible replacements for the word under consideration. Clicking on any one of the suggestions will cause that word to be entered in the Replacement: box, above.

  Língua:

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

  On the right side of the dialog box are 5 buttons that allow the user to control the spellcheck process. They are:

  Adicionar ao Dicionário

    Pressing this button adds the word in the Misspelled Word: box to the checker's dictionary. This means that in the future the checker will always consider this word to be correctly spelled.

  Substituir

    This button has the checker replace the word under consideration in the document with the word in the Replacement: box.

  Substituir Tudo

    This button causes the checker to replace not only the current Unknown word: but to automatically make the same substitution for any other occurrences of this Misspelled Word: in the document.

  Ignorar

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

  Ignorar Tudo

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

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

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

  Ajuda

    This invokes the &kde; help system starting at the &kwrite; help pages (this document).

  Terminado

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

  Cancelar

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

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

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

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

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

&Ctrl;I Ferramentas Indentar

  This increases the paragraph's indentation by one step. The size of the step depends on the indentation settings.

&Ctrl;&Shift;I Ferramentas Desindentar

  This reduces the paragraph's indentation by one step. The size of the step depends on the indentation settings.

Ferramentas Limpar a Indentação

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

Ferramentas Alinhamento

  Causes a realign of the current line or selected lines using the indentation mode and indentation settings in the doucment.

&Ctrl;D Ferramentas Comentar

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

&Ctrl;&Shift;D Ferramentas Descomentar

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

&Ctrl;U Ferramentas Maiúsculas

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

&Ctrl;&Shift;U Ferramentas Minúsculas

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

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

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

&Ctrl;J Ferramentas Juntar as Linhas

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

Ferramentas Repartir o Documento

  Apply static word wrapping on all the document. That means that a new line of text will automatically start when the current line exceeds the length specified by the Wrap words at: option in the Editing tab in Settings Configure Editor...

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

  When checked, this displays a small bar at the bottom of the editor containing information about the status of the current document. When unchecked the statusbar is hidden.

Configuração Mostrar a Localização

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

Configuração Configurar o Editor...

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

Settings Choose Editor...

  Choose the default text editing component that you wish to use in &kwrite;. You can choose System Default, Embedded Advanced Text Editor or &Qt; Designer Based Text Editor (note that the &Qt; Designer Based Text Editor is only available if you have KDevelop installed on your system). If you choose System Default, &kwrite; will honor your changes in &kcontrolcenter;. All other choices will override that setting.

Configuração Configurar os Atalhos...

  This command opens a dialog box whereby the shortcuts may be changed. A display window at the top of the dialog box shows the list of commands (actions) that can have keyboard shortcuts. Below the display are three radio buttons. The user may choose between No Key, Default Key, and Custom Key. (Note that a set of radio buttons only allows the selection of one of the offered items - in the way that buttons on a car radio only offer the selection of one preset station. Also, the Default Key selection is only available for those commands that actually have a 'default' shortcut.) Selecting the Custom Key option activates the three check boxes and key button at the bottom of the dialog. The user may then select a key combination for the command in question by means of the check boxes and key button. For example, with the About &kde; command selected in the display window, the user could select &Ctrl; and Alt, click on the key button, and then press the K key on the keyboard. This would mean that anytime he or she held down the &Ctrl; and Alt buttons and pressed K (while using &kwrite;) the About &kde; display box would be called.

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

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

### O Menu Ajuda

&help.menu.documentation;

## Configure &kwrite;

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

She or he may invoke the Help system, accept the current settings and close the dialog by means of the OK button, or Cancel the process. The categories Colors, Fonts Indent, Select, Edit, Spelling and Highlighting are detailed below.

### Aparência

Mudança de Linha
  Dynamic word wrap

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

  Dynamic word wrap indicators

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

  Vertically align dynamically wrapped lines to indentation depth:

    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.

Code Folding
  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 marcações na barra de posicionamento

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

Ordenar o Menu de Favoritos

  Por posição

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

  Por criação

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

Show identation lines

  If this is checked, the editor wil display vertical lines to help identifying indent lines.

### Tipos de Letra & Cores

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

&kwrite; will preselect the currently active scheme for you, if you want to work on a different scheme start by selecting that from the Schema combobox.

#### Cores

Fundo da Área de Texto
  Texto normal

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

  Selected Text

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

  Current Line

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

  Favorito

    This combo lets you set overlay colors for various mark types. The color is mixed into the background color of a marked line, so that a line with more marks or a marked line that is current has a background that is a mix of more colors. The mark colors are also used if you enable display of scrollbar marks.

Other Elements
  Left Border Background

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

  Line Numbers

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

  Bracket Highlight

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

  Word Wrap Markers

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

  Tab Markers

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

#### Tipos de Letra

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

#### Estilos de Texto Normal

The normal text styles are inherited by the highlight text styles, allowing the editor to present text in a very consistent way, for example comment text is using the same style in allmost all of the text formats that kate can highlight.

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

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

#### Estilos de Texto Realçado

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

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

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

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

### Cursor & Selecção

Movimento do Cursor de Texto
  Smart home

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

  Mudar o cursor de linha

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

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

  Page Up/Page Down moves cursor

    This option changes the behavior of the cursor when the user presses the Page Up or Page Down key. If unselected the text cursor will maintain its relative position within the visible text in &kwrite; as new text becomes visible as a result of the operation. So if the cursor is in the middle of the visible text when the operation occurs it will remain there (except when one reaches the beginning or end.) With this option selected, the first key press will cause the cursor to move to either the top or bottom of the visible text as a new page of text is displayed.

  Auto-centrar o cursor (linhas):

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

Selection Mode
  Normal

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

  Persistente

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

### Edição

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

    When this is enabled the editor will insert a calculated number of spaces according to the position in the text and the `tab-width` setting when you press the TAB key.

  Show tabulators

    When this is enabled &kwrite; will display a small dot as a visual representation of tabulator characters.

    This also causes dots to be drawn to indicate trailing white space. This will be fixed in a future version of &kwrite;

  Tab Width

    If the Replace Tabs By Spaces option is selected this entry determines the number of spaces with which the editor will automatically replace tabs.

Mudança de Linha Estática

  Word wrap is a feature that causes the editor to automatically start a new line of text and move (wrap) the cursor to the beginning of that new line. &kwrite; will automatically start a new line of text when the current line reaches the length specified by the Wrap Words At: option.

  Activar a mudança de linha estática

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

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

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

  Mudar de linha em:

    If the Word Wrap option is selected this entry determines the length (in characters) at which the editor will automatically start a new line.

Remove Trailing Spaces

  &kwrite; will automatically eliminate extra spaces at the ends of lines of text.

Auto Brackets

  When the user types a left bracket ([, (, or {) &kwrite; automatically enters the right bracket (}, ), or ]) to the right of the cursor.

Maximum undo steps:

  Here the user may specify the number of steps &kwrite; will retain in memory for purposes of undoing entries and actions. This means that the higher the number of steps set the more memory &kwrite; will use for this. Setting this entry to 10 would mean that the user would be be able reverse the last ten operations, i.e. click the undo button 10 times and obtain results.

Smart search text from:

  This determines where &kwrite; will get the search text from (this will be automatically entered into the Find Text dialog):

  - Nowhere: Don't guess the search text.

  - Selection Only: Use the current text selection, if available.

  - Selection, then Current Word: Use the current selection if available, otherwise use the current word.

  - Current Word Only: Use the word that the cursor is currently resting on, if available.

  - Current Word, then Selection: Use the current word if available, otherwise use the current selection.

  Note that, in all the above modes, if a search string has not been or cannot be determined, then the Find Text Dialog will fall back to the last search text.

### Indentação

Automatic indentation
  Indentation mode:

    Select the automatic indentation mode you want to use as default. It is strongly recommended to use `None` or `Normal`here, and use filetype configurations to set other indentation modes for text formats like C/C++ code or &XML;.

  Insert leading Doxygen "*" when typing

    Automatically insert a leading "*" while typing within a doxygen style comment. This setting is only enabled when applicable.

Indentation with Spaces
  Use spaces instead of tabs to indent

    This replaces tabs with the number of spaces set in Number of spaces: below.

  Emacs style mixed mode

    Use a mix of tabs and space characters for indentation.

  Number of spaces:

    Set the number of spaces you want to use for indentation when you check Use spaces instead of tabs to indent above.

Keep Indent Profile

  When this is enabled, the editor will not unindent lines in a selection further when the line with the least indentation becomes unindented. If you sometimes unindent blocks of indented code, this may be helpful.

Manter Espaços Extra

  Indentations of more than the selected number of spaces will not be shortened.

Keys to use
  Tab key indents

    This allows the tab key to be used to indent.

  Backspace key indent

    This allows the backspace key to be used to indent.

Tab Key Mode if Nothing Selected
  Insert indent characters

    This allows the Tab key insert indent characters.

  Insert tab character

    This allows the Tab key insert a tab.

  Indent current line

    This allows the Tab key indent the current line.

### Abrir & Gravar

Formato do Ficheiro
  Codificação:

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

  Fim da linha:

    Choose your prefered end of line mode for your active document. You have the choice between &UNIX;, DOS/&Windows; or 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.

Memory Usage
  Maximum loaded blocks per file:

    The editor will load given number of blocks (of around 2048 lines) of text into memory; if the filesize is bigger than this the other blocks are swapped to disk and loaded transparently as-needed.

    This can cause little delays while navigating in the document; a larger block count increases the editing speed at the cost of memory.

    For normal usage, just choose the highest possible block count: limit it only if you have problems with the memory usage.

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 da Pasta
  Profundidade da procura no ficheiro de configuração:

    The editor will search the given number of folder levels upwards for &kwrite; config file and load the settings line from it.

Salvaguardar ao Gravar

  Backing up on save will cause &kwrite; to copy the disk file to <prefix><filename><suffix>' before saving changes. The suffix defaults to ~ and prefix is empty by default.

  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.

### Highlighting

This group of options is used to customize the highlighting styles for each programming language type. Any changes you made in other areas of this dialog apply only to this type.

Highlight:

  This is used to choose the language type to configure.

Informations

  View the properties of the chosen language highlighting rules: author name and license.

Properties
  Extensões dos ficheiros:

    This is the list of file extensions used to determine which files to highlight using the current syntax highlight mode.

  Tipos MIME:

    Clicking the wizard button will display a dialog with a list of all available mime types to choose from.

    The File Extensions entry will automatically be edited as well.

  Prioridade:

    Set the priority of the highlight rule.

Download...

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

### Filetypes

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

Tipo de ficheiro:

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

  Novo

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

  Remover

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

Propriedades do tipo de ficheiro actual

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

  Nome:

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

  Secção:

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

  Variáveis:

    This string allows you to configure &kwrite;'s settings for the files selected by this mimetype using &kwrite; variables. You can set almost any configuration option, such as highlight, indent-mode, encoding, etc.

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

  Extensões dos ficheiros:

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

  Tipos MIME:

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

  Prioridade:

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

### Atalhos

You can change here the shortcut keys configuration. Select an action and click on Custom if you want a different shortcut for this action.

The search line alllows you to look for a specific action and see its associated shortcut.

### Plugins

This tab lists all available plugins and you can check those you want to use. Once a plugin is checked, the Configure button is enabled and you can click it in order to configure the highlighted plugin.

## Créditos e Licenças

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

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

Contribuições:

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

- Michael Bartl michael.bartl1@chello.at

- Phlip phlip_cpp@my-deja.com

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

- Matt Newell newellm@proaxis.com

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

- Jochen 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 por &Thad.McGinnis; &Thad.McGinnis.mail;

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

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

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

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

&underFDL; &underGPL;

&documentation.index;