<para>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 poderosos. 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. </para>
<para>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 servidor de &FTP; remoto aberto numa das janelas do &konqueror;. </para>
<para>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. </para>
<para>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:</para>
<para>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:</para>
<listitem><para>Lista a informação de versão do &Qt;, do &kde; e do &kwrite;. Também está disponível como <userinput><command>kwrite</command> <option>-v</option></userinput> </para></listitem>
<listitem><para>Faz com que o &kwrite; leia o conteúdo do documento a partir do STDIN. Isto é semelhante à opção comum <option>-</option>, que é usada em muitos programas da linha de comandos, permitindo-lhe encaminhar o resultado dos comandos para o &kwrite;.</para></listitem>
<para>Muitos dos comandos de teclado do &kwrite; (atalhos) são configuráveis através do menu <link linkend="settings">Configuração</link>. Por omissão, o &kwrite; respeita a seguinte configuração de teclas:</para>
<entry><para>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.</para></entry>
<para>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. </para>
<para>Mostra uma janela normal do &kde; para <guilabel>Abrir um Ficheiro</guilabel>. Use a janela de ficheiros para seleccionar o ficheiro que deseja abrir, carregando depois em <guibutton>Abrir</guibutton> para aceder a ele. Poderá encontrar mais informações sobre a janela do &kde; para <guilabel>Abrir um Ficheiro</guilabel> no Guia de Utilizador do &kde;.</para>
<para>Este é um atalho para aceder aos documentos gravados mais recentemente. Se carregar neste item, irá abrir 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. </para>
<para>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). </para>
<para>Isto permite a um documento ser gravado com outro nome. Isto é conseguido através da janela de ficheiros descrita na secção <link linkend="open">Abrir</link> deste ficheiro de ajuda. </para>
<para>Carrega de novo o ficheiro activo do disco. Este comando é útil, se outro programa ou processo tiver alterado o ficheiro enquanto o tem aberto no &kwrite;. </para>
<para>Fecha o ficheiro activo com este comando. Se tiver feito alterações por gravar, será avisado para gravar o ficheiro antes de o &kwrite; o fechar. </para>
<para>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 <guimenuitem>Nova Vista</guimenuitem> ou <guimenuitem>Nova Janela</guimenuitem>, essas instâncias não serão fechadas. </para>
<para>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.</para>
<para>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.</para>
<para>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.</para>
<term><anchor id="block-selection-mode"/><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo> </shortcut> <guimenu>Editar</guimenu><guimenuitem>Modo de Selecção em Bloco</guimenuitem></menuchoice></term>
<para>Activa ou desactiva o Modo de Selecção. Quando o Modo de Selecção for "BLOCO", poderá fazer selecções verticais, isto é, seleccionar as colunas 5 a 10 nas linhas 9 a 15. A barra de estado mostra a informação sobre o Modo de Selecção, como "NORM" ou "BLC".</para>
<para>Activa ou desactiva os modos de Inserção/Sobreposição. Quando o modo for o "INS", poderá inserir caracteres no local onde se encontra o cursor. Quando o modo for o "SOB", os caracteres introduzidos irão substituir os caracteres actuais, se o seu cursor tiver texto a seguir a ele. A barra de estado mostra a informação sobre o Modo de Sobreposição como "INS" ou "SOB".</para>
<para>Isto abre a janela de procura, a qual é usada para definir o <guilabel>Texto a Procurar</guilabel> 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 <guilabel>Distinguir Maiúsculas</guilabel> 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 <guilabel>Procurar para Trás</guilabel> direcciona a pesquisa para percorrer no sentido superior. A opção <guilabel>Texto Seleccionado</guilabel> mantém a procura apenas no texto seleccionado no momento. A opção <guilabel>Apenas Palavras Completas</guilabel> evita que a procura pare nas palavras que contêm o padrão a procurar. A opção <guilabel>A Partir do Cursor</guilabel> inicia a procura a partir da posição actual do cursor dentro do documento, em vez de ser a partir do início.</para>
<para>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. </para>
<para>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 <guilabel>Substituir Por:</guilabel>. 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 <guilabel>Perguntar ao Substituir</guilabel> permite ao utilizador confirmar sempre que o &kwrite; pedir essa confirmação antes de cada substituição. </para>
<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></shortcut> <guimenu>Editar</guimenu> <guimenuitem>Ir para a linha</guimenuitem></menuchoice></term>
<para>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. </para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F7</keycap></keycombo></shortcut> <guimenu>Ver</guimenu> <guimenuitem>Mudar para a Linha de Comandos</guimenuitem> </menuchoice>
<para>Mostra a linha de comandos da componente do Kate no fundo da janela. Na linha de comandos, escreva "help" para obter ajuda e "help list" para obter uma lista de comandos.</para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F10</keycap></keycombo></shortcut> <guimenu>Ver</guimenu> <guimenuitem>Mudança de Linha Dinâmica</guimenuitem> </menuchoice>
<menuchoice><shortcut><keycombo action="simul"><keycap>F3</keycap></keycombo></shortcut> <guimenu>Ver</guimenu><guimenuitem>Indicadores de Mudança de Linha Dinâmica</guimenuitem> </menuchoice>
<para>Escolhe se e quando deverão ser mostrados os indicadores de mudança de linha. Isto só fica disponível se a opção <guilabel>Mudança de Linha Dinâmica</guilabel> estiver assinalada.</para>
<para>Se esta opção estiver assinalada, será desenhada uma linha vertical na coluna de mudança de linha, como está definido na opção <menuchoice> <guimenu>Configuração</guimenu> <guimenuitem>Configurar o Editor...</guimenuitem></menuchoice> 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.</para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F6</keycap></keycombo></shortcut> <guimenu>Ver</guimenu> <guimenuitem>Mostrar o Contorno do Ícone</guimenuitem> </menuchoice>
<menuchoice><shortcut><keycombo action="simul"><keycap>F11</keycap></keycombo></shortcut> <guimenu>Ver</guimenu> <guimenuitem>Mostrar os Números de Linha</guimenuitem> </menuchoice>
<para>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.</para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F9</keycap></keycombo></shortcut> <guimenuitem>Esconder as Marcações de Dobragem</guimenuitem> </menuchoice>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>Shift</keycap><keycap>-</keycap></keycombo></shortcut> <guimenuitem>Recolher o Nível de Topo</guimenuitem></menuchoice>
<listitem><para>Recolhe todas as regiões de topo do documento.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>Shift</keycap><keycap>+</keycap></keycombo></shortcut> <guimenuitem>Expandir o Nível de Topo</guimenuitem></menuchoice>
<listitem><para>Expande todas as regiões de topo do documento.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>-</keycap></keycombo></shortcut> <guimenuitem>Recolher um Nível Local</guimenuitem></menuchoice>
<listitem><para>Recolhe a região mais próxima do cursor.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>+</keycap></keycombo></shortcut> <guimenuitem>Expandir um Nível Local</guimenuitem></menuchoice>
<listitem><para>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.</para></listitem>
<listitem><para>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.</para></listitem>
<para>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 <menuchoice> <guimenu>Configuração</guimenu> <guimenuitem>Configurar o Editor...</guimenuitem></menuchoice> na página de Tipos de Ficheiros, somente para o seu documento.</para>
<para>Escolhe o esquema de realce de sintaxe que preferir para o documento activo. Isto substitui o modo de realce global definido na opção <menuchoice> <guimenu>Configuração</guimenu> <guimenuitem>Configurar o Editor...</guimenuitem></menuchoice>, somente para o seu documento.</para>
<para>Escolhe o estilo de indentação que preferir para o documento activo. Isto substitui o modo de indentação global definido na opção <menuchoice> <guimenu>Configuração</guimenu> <guimenuitem>Configurar o Editor...</guimenuitem></menuchoice>, somente para o seu documento.</para>
<para>Poderá sobrepor a codificação predefinida na opção <menuchoice> <guimenu>Configuração</guimenu> <guimenuitem>Configurar o Editor...</guimenuitem></menuchoice>, na página <guilabel>Abrir/Gravar</guilabel>, 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.</para>
<para>Escolhe o modo de fim de linha que preferir para o documento activo. Isto substitui o modo de fim de linha global definido na opção <menuchoice> <guimenu>Configuração</guimenu> <guimenuitem>Configurar o Editor...</guimenuitem></menuchoice>, somente para o seu documento.</para>
<listitem><para><action>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.</action> 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:</para>
<listitem><para>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.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Substituir por:</guilabel></term>
<listitem><para>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.</para></listitem>
<listitem><para>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 <guilabel>Substituição:</guilabel> em cima.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Língua:</guilabel></term>
<listitem><para>Se tiver instalado vários dicionários, aqui poderá seleccionar qual o dicionário/língua que deverá ser usado.</para></listitem>
<term><guibutton>Adicionar ao Dicionário</guibutton></term>
<listitem><para>Se carregar neste botão, irá adicionar a palavra no campo <guilabel>Palavra Errada:</guilabel> ao dicionário do corrector. Isto significa que, no futuro, o verificador ortográfico irá considerar sempre esta palavra como correcta.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Substituir</guibutton></term>
<listitem><para>Este botão faz com que o corrector substitua a palavra em consideração no documento pela palavra no campo <guilabel>Substituição:</guilabel>.</para></listitem>
<listitem><para>Este botão faz com que o corrector não só substitua a <guilabel>Palavra desconhecida:</guilabel> actual, mas também faça a mesma substituição para todas as outras ocorrências desta <guilabel>Palavra Errada:</guilabel> no documento.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Ignorar</guibutton></term>
<listitem><para>Ao activar este botão, fará com que o verificador ortográfico siga em frente, sem efectuar quaisquer alterações.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Ignorar Tudo</guibutton></term>
<listitem><para>Este botão diz ao corrector ortográfico para não fazer nada com a <guilabel>Palavra desconhecida:</guilabel> actual e para seguir em frente com todas as instâncias da mesma palavra.</para> <note><para>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.</para></note></listitem>
<listitem><para>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.</para></listitem>
<term><anchor id="tools-spelling-from-cursor"/><menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Verificação Ortográfica (do cursor)...</guimenuitem></menuchoice></term>
<term><anchor id="tools-spellcheck-selection"/><menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Verificação Ortográfica da Selecção...</guimenuitem></menuchoice></term>
<para>Isto aumenta a indentação do parágrafo em um passo. O tamanho do passo depende da <link linkend="pref-indent">configuração da indentação</link>.</para>
<para>Isto reduz a indentação do parágrafo em um passo. O tamanho do passo depende da <link linkend="pref-indent">configuração da indentação</link>.</para>
<term><anchor id="cleanindent"/><menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Limpar a Indentação</guimenuitem></menuchoice></term> <listitem>
<para>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.</para>
<para>Faz um novo alinhamento da linha actual ou das linhas seleccionadas, usando o modo de indentação e a configuração de indentação no documento.</para>
<listitem><para>Isto remove um espaço (se existir) ao início da linha onde o cursor se encontra ou ao início das linhas seleccionadas.</para></listitem>
<listitem><para>Capitaliza (coloca a primeira letra em maiúsculas e as restantes em minúsculas) o texto seleccionado ou a palavra actual.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo> </shortcut> <guimenu>Ferramentas</guimenu> <guimenuitem>Juntar as Linhas</guimenuitem> </menuchoice></term>
<listitem><para>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.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Ferramentas</guimenu> <guimenuitem>Mudança de Linha do Documento</guimenuitem> </menuchoice></term>
<listitem><para>Aplica uma mudança de linha estática em todo o documento. Isto significa que uma linha nova de texto irá iniciar automaticamente, quando a linha actual exceder o tamanho definido na opção 'Mudar de Linha em:' da página de Edição em <menuchoice> <guimenu>Configuração</guimenu><guimenuitem>Configurar o Editor...</guimenuitem></menuchoice></para></listitem>
<para>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. </para>
<para>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.</para>
<para>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.</para>
<para>Escolha o componente de edição de texto por omissão que deseja usar no &kwrite;. Poderá escolher o <guilabel>Predefinido do Sistema</guilabel>, <guilabel>Componente de Edição de Texto Avançado</guilabel> ou o <guilabel>Editor de Texto Baseado no &Qt; Designer</guilabel> (lembre-se que o Editor de Texto Baseado no &Qt; Designer só estará disponível se tiver o KDevelop instalado no seu sistema). Se escolher o <guilabel>Predefinido do Sistema</guilabel>, o &kwrite; irá respeitar as suas modificações no &kcontrolcenter;. Todas as outras opções irão substituir esta. </para>
<term><anchor id="configure-keybindings"/><menuchoice><guimenu>Configuração</guimenu><guimenuitem>Configurar os Atalhos...</guimenuitem></menuchoice></term>
<para>Este comando abre uma janela onde se poderão alterar as <link linkend="keybindings">associações de teclas</link>. 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 <keycap>Alt</keycap>, carregar no botão da tecla e depois no <keycap>K</keycap> do teclado. Isso significaria que, sempre que ele carregasse nas teclas &Ctrl; e <keycap>Alt</keycap>, seguidas da tecla <keycap>K</keycap> (enquanto usar o &kwrite;), seria chamada a janela do Acerca do &kde;. </para>
<term><anchor id="configure-toolbars"/><menuchoice><guimenu>Configuração</guimenu><guimenuitem>Configurar as Barras de Ferramentas...</guimenuitem></menuchoice></term>
<listitem><para>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, <abbrev>i.e.</abbrev>, 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.</para> </listitem>
<para>A selecção do <menuchoice><guimenu>Configuração</guimenu><guimenuitem>Configurar o Editor...</guimenuitem></menuchoice>, a partir do menu, provoca o aparecimento da janela para <guilabel>Configurar o Editor</guilabel>. 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. </para>
<para>O utilizador pode invocar o sistema de <guilabel>Ajuda</guilabel>, aceitar a configuração actual e fechar a janela, através do botão <guibutton>OK</guibutton> ou <guibutton>Cancelar</guibutton> o processo. As categorias <guilabel>Cores</guilabel>, <guilabel>Tipos de Letra</guilabel> <guilabel>Indentação</guilabel>, <guilabel>Selecção</guilabel>, <guilabel>Edição</guilabel>, <guilabel>Verificação Ortográfica</guilabel> e <guilabel>Realce</guilabel> são detalhadas em baixo. </para>
<term><guilabel>Mudança de linha dinâmica</guilabel></term>
<listitem><para>Se esta opção estiver assinalada, as linhas de texto serão repartidas no contorno da janela no ecrã.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Indicadores de mudança de linha dinâmica</guilabel></term>
<listitem><para>Escolha se deseja mostrar os indicadores de mudança de linha dinâmica. </para></listitem></varlistentry>
<varlistentry>
<term><guilabel>Alinhar verticalmente as mudanças de linhas dinâmicas à profundidade de indentação: </guilabel></term>
<listitem><para>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><para>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.</para></listitem>
<term><guilabel>Mostrar as marcações de dobragem (se disponíveis) </guilabel></term>
<listitem><para>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.</para></listitem>
<term><guilabel>Mostrar o contorno dos ícones </guilabel></term>
<listitem><para>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.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Mostrar os números de linha </guilabel></term>
<listitem><para>Se esta opção estiver assinalada, irá ver os números das linhas do lado esquerdo.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Mostrar as marcas na barra de posicionamento </guilabel></term>
<listitem><para>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.</para></listitem>
<term><guilabel>Mostrar as linhas de indentação </guilabel></term>
<listitem><para>Se esta opção estiver assinalada, o editor irá mostrar linhas verticais para ajudar a identificar as linhas de indentação.</para></listitem>
<para>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. </para>
<para>O &kwrite; irá seleccionar previamente o esquema activo de momento para si; se quiser trabalhar num esquema diferente, comece por seleccioná-lo na lista <guilabel>Esquema</guilabel>.</para>
<listitem><para>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;. </para></listitem>
<listitem><para>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. </para></listitem>
<listitem><para>Esta lista permite-lhe sobrepor as cores dos vários tipos de marcações. A cor é misturada com a cor de fundo de uma linha marcada, para que uma linha com mais marcas ou a linha actual tenha um fundo que seja uma mistura de mais cores. As cores das marcações são também usadas se activar a visualização das marcas na barra de posicionamento.</para></listitem>
<term><guilabel>Fundo do Contorno Esquerdo</guilabel></term>
<listitem><para>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. </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Números de Linha</guilabel></term>
<listitem><para>Esta cor é usada para desenhar os números de linha do lado esquerdo da janela, quando estiverem visíveis.</para></listitem>
<listitem><para>Esta cor é usada para desenhar o fundo dos parêntesis correspondentes. </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Marcações de Mudanças de Linha</guilabel></term>
<listitem><para>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.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Marcações de Tabulações</guilabel></term>
<listitem><para>Esta cor é usada para desenhar os indicadores de espaços em branco, quando estiverem activos. </para></listitem>
<para>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. </para>
<para>Os estilos de texto normal são herdados pelos estilos de texto realçados, permitindo ao editor apresentar o texto de forma bastante consistente; por exemplo, o texto do comentário usa o mesmo estilo em quase todos os formatos de texto que o Kate consegue realçar.</para>
<para>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. </para>
<para>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.</para>
<para>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 <guilabel>Realce</guilabel>, por cima da lista de estilos. </para>
<para>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. </para>
<para>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.</para>
<para>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. </para>
<para>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.</para>
<para>Quando estiver activada esta opção, se mover o cursor de inserção com as teclas <emphasis role="bold">Esquerda</emphasis> e <emphasis role="bold">Direita</emphasis>, irá para a linha anterior/seguinte no início/fim da linha, como acontece nos outros editores.</para><para>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.</para>
<para>Esta opção altera o comportamento do cursor quando o utilizador carrega na teclas <keycap>Page Up</keycap> ou na <keycap>Page Down</keycap>. 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.</para>
<para>Quando isto estiver activo, o editor irá inserir um número calculado de espaços, de acordo com a posição no texto e a configuração <option>tab-width</option>, quando carregar na tecla <keycap>TAB</keycap>.</para>
<para>Quando esta opção estiver activa, o &kwrite; irá mostrar um pequeno ponto como representação visual das tabulações.</para>
<note><para>Isto faz também com que os pontos sejam desenhados para indicar os espaços em branco finais. Isto será corrigido numa futura versão do &kwrite;</para></note>
<term id="pref-tab-width">Tabulação</term> <listitem><para>Se a opção <link linkend="pref-word-wrap"><guilabel>Substituir as Tabulações por Espaços</guilabel></link> estiver seleccionada, este campo determina o número de espaços pelo qual o editor irá substituir automaticamente as tabulações.</para></listitem>
<term id="pref-word-wrap"><guilabel>Mudança de Linha Estática</guilabel></term>
<listitem><para>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 <link linkend="pref-wrap-words-at">Mudar Palavras Em:</link>.</para>
<para>Se esta opção estiver assinalada, será desenhada uma linha vertical na coluna de mudança de linha, como está definido na opção <menuchoice> <guimenu>Configuração</guimenu> <guimenuitem>Configurar o Editor...</guimenuitem></menuchoice> 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.</para>
<para>Se a opção <link linkend="pref-word-wrap">Mudança de Linha</link> estiver seleccionada, este campo determina o tamanho (em caracteres) a partir do qual o editor irá iniciar automaticamente uma nova linha.</para>
<term><guilabel>Remover os Espaços Finais</guilabel></term>
<listitem><para>O &kwrite; irá eliminar automaticamente os espaços extra no fim das linhas de texto.</para></listitem> </varlistentry>
<varlistentry>
<term><guilabel>Parêntesis Automáticos</guilabel></term> <listitem><para>Quando um utilizador escrever um parêntesis esquerdo ([, ( ou {), o &kwrite; introduz automaticamente o parêntesis direito (}, ) ou ]) à direita do cursor.</para></listitem>
</varlistentry>
<varlistentry> <term>Passos do <link linkend="undo">desfazer</link>:</term>
<listitem><para>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, <abbrev>i.e.</abbrev>, carregar no botão <guibutton>Desfazer</guibutton> 10 vezes e obter resultados.</para></listitem> </varlistentry>
<varlistentry> <term>Texto de origem de procura inteligente:</term>
<listitem><para>Isto determina de onde o &kwrite; irá obter o texto da procura (será introduzido automaticamente na janela para Procurar Texto): <itemizedlist> <listitem><para><emphasis role="bold">Em Nenhum Lado:</emphasis> Não irá adivinhar o texto de procura.</para></listitem> <listitem><para><emphasis role="bold">Apenas a Selecção:</emphasis> Usar a selecção do texto actual, se disponível. </para></listitem> <listitem><para><emphasis role="bold">Selecção ou Palavra Actual:</emphasis> Usar a selecção actual, se disponível, caso contrário usa a palavra actual. </para></listitem> <listitem><para><emphasis role="bold">Apenas a Palavra Actual:</emphasis> Usa a palavra sob o cursor, se disponível.</para></listitem> <listitem><para><emphasis role="bold">Palavra Actual ou Selecção:</emphasis> Usa a palavra actual, se disponível, caso contrário usa a selecção actual. </para></listitem> </itemizedlist> Lembre-se que, nos modos acima, se não se conseguir determinar um texto de procura, então a janela para Procurar Texto irá usar o último texto de procura. </para></listitem>
<para>Seleccione o modo de indentação automático que desejar usar por omissão. Recomenda-se que use o <userinput>Nenhum</userinput> ou o <userinput>Normal</userinput> aqui e use as configurações do tipo de ficheiro para definir outros modos de indentação para os formatos de texto, como o código em C/C++ ou o &XML;.</para>
<para>Insere automaticamente um "*" inicial, enquanto escreve dentro de um comentário do tipo do Doxygen. Esta configuração só está activa quando tal se aplicar.</para>
<para>Defina o número de espaços que deseja usar na indentação, quando assinalar a opção <guilabel>Usar espaços em vez de tabulações para indentar</guilabel>.</para>
<term><guilabel>Manter o Perfil de Indentação</guilabel></term>
<listitem><para>Quando esta opção estiver activa, o editor não irá remover mais a indentação das linhas de uma selecção, quando a linha com menor indentação ficar completamente sem indentação. Se algumas vezes retirar blocos de indentação no código, isto poderá ser útil. </para></listitem>
<para>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.</para>
<para>O editor irá carregar o número de blocos indicado (com cerca de 2048 linhas) com texto para a memória; se o tamanho do ficheiro for maior que isto, os outros blocos são transferidos para o disco e carregados de forma transparente, à medida das necessidades.</para>
<para>Isto poderá provocar alguns pequenos atrasos ao navegar no documento; um número de blocos maior aumenta a velocidade de edição com uma sobrecarga na memória. </para><para>Para uma utilização normal, basta escolher o número de blocos maior que for possível: limite-o apenas se tiver problemas com a utilização de memória.</para>
<para>O editor irá procurar pelo número de níveis de pastas indicado para cima, no ficheiro de configuração do &kwrite; e carrega a linha de configuração respectiva.</para>
<term><guilabel>Salvaguardar ao Gravar</guilabel></term>
<listitem><para>Se criar uma cópia de segurança ao gravar, fará com que o &kwrite; copie o ficheiro do disco para <prefixo><nome-ficheiro><sufixo>' antes de gravar as alterações. O sufixo é, por omissão <emphasis role="bold">~</emphasis> e o prefixo está em branco, por omissão. </para>
<para>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.</para>
<term><guilabel>Extensões dos ficheiros:</guilabel></term>
<listitem><para>Esta é a lista de extensões de ficheiros, usadas para determinar os ficheiros a realçar, com o modo de realce de sintaxe actual.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Tipos MIME:</guilabel></term>
<listitem><para>Se carregar no botão do assistente, irá mostrar uma janela com todos os tipos MIME à escolha.</para><para>O item das <emphasis role="bold">Extensões de Ficheiros</emphasis> será automaticamente editado também.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Prioridade:</guilabel></term>
<listitem><para>Indica a prioridade da regra de realce.</para></listitem>
<para>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. </para>
<term><guilabel>Tipo de ficheiro:</guilabel></term>
<listitem><para>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.</para>
<listitem><para>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.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Remover</guilabel></term>
<listitem><para>Para remover um tipo de ficheiro existente, seleccione-o na lista e carregue no botão Apagar.</para></listitem>
<term><guilabel>Propriedades do tipo de ficheiro actual</guilabel></term>
<listitem><para>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.</para>
<listitem><para>O nome do tipo de ficheiro será o texto do item de menu correspondente. Este nome é mostrado no item <menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Tipos de Ficheiros</guimenuitem> </menuchoice></para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Secção:</guilabel></term>
<listitem><para>O nome da secção é usado para organizar os tipos de ficheiros em menus. Este também é usado no menu <menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Tipos de Ficheiros</guimenuitem> </menuchoice>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Variáveis:</guilabel></term>
<listitem><para>Este texto permite-lhe configurar o &kwrite; para os ficheiros seleccionados por este tipo MIME, usando as variáveis do &kwrite;. Poderá definir quase todas as opções de configuração, como o 'highlight', 'indent-mode', 'encoding', etc.</para><para>Para uma lista completa das variáveis conhecidas, veja o manual.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Extensões dos ficheiros:</guilabel></term>
<listitem><para>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 <filename>*.txt; *.text</filename>. O texto é uma lista, separada por pontos-e-vírgulas, de máscaras.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Tipos MIME:</guilabel></term>
<listitem><para>Inicia um assistente que o ajuda a escolher facilmente tipos MIME.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Prioridade:</guilabel></term>
<listitem><para>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.</para></listitem>
<para>Poderá alterar aqui a configuração dos atalhos. Seleccione uma acção e carregue em <guilabel>Personalizado</guilabel> se quiser um atalho diferente para esta acção.</para>
<para>A linha de procura permite-lhe procurar por uma determinada acção e ver o seu atalho associado.</para>
<para>Esta página lista todos os 'plugins' disponíveis e poderá assinalar os que deseja usar. Assim que um 'plugin' seja assinalado, o botão <guibutton>Configurar</guibutton> fica activo e você poderá carregar nele para configurar o 'plugin' seleccionado.</para>
