<para>O &kwrite; é mais do que um editor de texto para o ambiente de trabalho do &kde;. Ele foi desenhado para ser um editor para o programador, e pode ser considerado pelo menos como uma alternativa parcial para a maioria dos editores mais poderosos. Ele pode ser melhor usado, em conjunto com o &konqueror;, para a navegação por arquivos de código das diferentes linguagens. O &kwrite; também funciona muito bem como um simples editor de texto. Uma das principais funcionalidades 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; usa o protocolo de Arrastar e Soltar do &kde;. Arquivos podem ser arrastados e soltos no &kwrite; a partir da área de trabalho, do &konqueror; ou de algum site &FTP; remoto aberto em uma das janelas do &konqueror;. </para>
<para>Embora o &kwrite; possa ser geralmente iniciado a partir do menu de programas do &kde; ou de um ícone da área de trabalho, ele poderá ser aberto a partir da linha de comando de uma janela de terminal. Existem algumas opções úteis que estão disponíveis ao fazer isto. </para>
<para>Especificando o caminho e nome de um arquivo específico o usuário pode fazer com que o &kwrite; abra (ou crie) este arquivo imediatamente após iniciar. Esta opção pode parecer algo como o seguinte:</para>
<para>O método acima mencionado pode também ser usado para abrir arquivos na internet (se o usuário tiver uma conexão ativa no momento.) Um exemplo disto pode parecer com o seguinte:</para>
<listitem><para>Lista as informações 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 de linha de comando, 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ções</link>. Por padrão, o &kwrite; respeita os seguintes atalhos de teclado:</para>
<entry><para>Alterna entre o modo Inserir e Sobrescrever. Quando no modo inserir o editor adicionará qualquer caracter digitado ao texto empurrando qualquer dado à direita do cursor do texto. O modo sobrescrever faz com que a entrada de cada caracter elimine o caracter imediatamente à direita do cursor de texto.</para></entry>
<para>Exibe o diálogo padrão do &kde; <guilabel>Abrir Arquivo</guilabel>. Use o visualizador de arquivo para selecionar o arquivo que você deseja abrir, e clique em <guibutton>Abrir</guibutton> para abrí-lo. Você pode encontrar mais informações sobre o diálogo do &kde; <guilabel>Abrir Arquivo</guilabel> no Guia do Usuário do &kde;.</para>
<para>Este é um atalho para os documentos recentemente salvos. Clicar neste ítem abrirá uma lista ao lado do menu com vários dos arquivos mais recentemente salvos. Clicar em um arquivo específico irá abrí-lo no &kwrite; - se o arquivo ainda estiver na mesma localização. </para>
<para>Isto salva o documento atual. Se o documento já tiver sido salvo então isto sobrescreverá o arquivo anteriormente salvo sem pedir pela permissão do usuário. Se esta é a primeira vez que salva um novo documento a diálogo salvar como (descrito abaixo) será invocado. </para>
<para>Isto permite que um documento seja salvo com um novo nome de arquivo. Isto é feito com a caixa de diálogo de arquivo descrita acima na seção <link linkend="open">Abrir</link> deste arquivo de ajuda. </para>
<para>Recarrega o arquivo ativo do disco. Este comando é útil, se outro programa ou processo tiver alterado o arquivo enquanto você o tem aberto no &kwrite;. </para>
<para>Fecha o arquivo ativo com este comando. Se você tiver feito alterações não salvas, será questionado se deseja salvar o arquivo antes do &kwrite; fechá-lo. </para>
<para>Isto fechará a janela do editor. Se você tiver mais de uma instância do &kwrite; em execução, através dos ítens de menu <guimenuitem>Nova Visão</guimenuitem> ou <guimenuitem>Nova Janela</guimenuitem>, estas instâncias não serão fechadas. </para>
<para>Este comando apaga a seleção atual 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 atualmente selecionado para a área de transferência, de modo a poder ser colado em outro 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 Seleção em Bloco</guimenuitem></menuchoice></term>
<para>Ativa ou desativa o Modo de Seleção. Quando o Modo de Seleção for "BLOCO", você poderá fazer seleções verticais, isto é, selecionar as colunas de 5 a 10 nas linhas 9 a 15. A barra de estado mostra a informação sobre o Modo de Seleção, como "NORM" ou "BLC".</para>
<para>Ativa ou desativa os modos de Inserção/Sobrescrita. Quando o modo for o "INS", você poderá inserir caracteres no local onde se encontra o cursor. Quando o modo for o "SOB", os caracteres inseridos irão substituir os caracteres atuais, se o seu cursor tiver texto após ele. A barra de estado mostra a informação sobre o Modo de Sobreposição como "INS" ou "SOB".</para>
<para>Isto abre o diálogo de procura que é usado para especificar o <guilabel>Texto a Procurar</guilabel> no documento. Existe uma pequena caixa de texto para inserir o termo a procurar que também é uma caixa combinada. Clica na seta para baixo ao lado da caixa torna disponíveis outros termos de busca recentes. Outros parâmetros são incluídos para tornar a busca mais eficiente. Selecionar <guilabel>Sensível à Caixa</guilabel> limitará a busca a entradas que correspondam a caixa (superior ou inferior) de cada caracter no termo de busca. <guilabel>Procurar para Trás</guilabel> direciona a busca para ser realizada na direção do início do arquivo. A opção <guilabel>Texto Selecionado</guilabel> mantém a busca dentro do texto selecionado. Habilitar <guilabel>Somente Palavras Completas</guilabel> evita que a busca pare em palavras que contenham o termo procurado. A opção <guilabel>Procurar a partir do Cursor</guilabel> inicia a busca a partir da posição atual do cursor dentro do documento ao invés de iniciá-la a partir do início.</para>
<para>Isto repete a última operação de busca, se houver, sem chamar a caixa de diálogo de procura, e busca no documento para trás ao invés de para frente. </para>
<para>Este comando abre a caixa de diálogo de substituição. O diálogo de substituição é bastante parecido com o diálogo de procura acima mencionado. Além dos recursos do diálogo de procura ele contém uma caixa combinada <guilabel>Substituir Com:</guilabel>. Usando este diálogo o usuário pode especificar tanto o texto a ser encontrado como o texto que deverá substituí-lo. A opção adicional <guilabel>Perguntar Ao Substituir</guilabel> permite ao usuário confirmar ao &kwrite; antes de cada substituição. </para>
<para>Isto abre a caixa de diálogo ir para linha, que é usada para fazer com que o cursor pule para uma linha em particular (especificada pelo número) no documento. O número da linha pode ser inserido diretamente na caixa de texto ou graficamente clicando na seta para cima e para baixo do controle de contagem ao lado da caixa de texto. A pequena seta para cima aumentará o número da linha e a seta para baixo diminuirá. Existe também um índice deslizante à direita da caixa de texto que permite o usuário mover o ponto do ir para no documento de uma maneira semelhante. </para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F7</keycap></keycombo></shortcut> <guimenu>Ver</guimenu> <guimenuitem>Alternar para a Linha de Comando</guimenuitem> </menuchoice>
<para>Mostra a linha de comando da componente do Kate no fundo da janela. Na linha de comando, digite "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>Quebra de Linha Dinâmica</guimenuitem> </menuchoice>
<menuchoice><shortcut><keycombo action="simul"><keycap>F3</keycap></keycombo></shortcut> <guimenu>Ver</guimenu><guimenuitem>Indicadores de Quebra de Linha Dinâmica</guimenuitem> </menuchoice>
<para>Escolhe se e quando deverão ser mostrados os indicadores de quebra de linha. Isto só fica disponível se a opção <guilabel>Quebra de Linha Dinâmica</guilabel> estiver assinalada.</para>
<para>Se esta opção estiver assinalada, será desenhada uma linha vertical na coluna de quebra de linha, como está definido na opção <menuchoice> <guimenu>Configurações</guimenu> <guimenuitem>Configurar Editor...</guimenuitem></menuchoice> na página de Edição. Lembre-se que o marcador de mudança de linha só é desenhado se usar uma fonte monoespaçada.</para>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>Shift</keycap><keycap>-</keycap></keycombo></shortcut> <guimenuitem>Recolher para Nível mais Alto</guimenuitem></menuchoice>
<listitem><para>Recolhe tudo para região de nível mais alta do documento.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>Shift</keycap><keycap>+</keycap></keycombo></shortcut> <guimenuitem>Expandir do Nível mais Alto</guimenuitem></menuchoice>
<listitem><para>Expande todos os níveis 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 arquivos que preferir para o documento ativo. Isto substitui o modo de tipo de arquivos global definido na opção <menuchoice> <guimenu>Configurações</guimenu> <guimenuitem>Configurar Editor...</guimenuitem></menuchoice> na página de Tipos de Arquivos, somente para o seu documento atual.</para>
<para>Escolhe o esquema de realce de sintaxe que preferir para o documento ativo. Isto substitui o modo de realce global definido na opção <menuchoice> <guimenu>Configurações</guimenu> <guimenuitem>Configurar Editor...</guimenuitem></menuchoice>, somente para o seu documento atual.</para>
<para>Escolhe o estilo de indentação que preferir para o documento ativo. Isto substitui o modo de indentação global definido na opção <menuchoice> <guimenu>Configurações</guimenu> <guimenuitem>Configurar Editor...</guimenuitem></menuchoice>, somente para o seu documento atual.</para>
<para>Você poderá sobrepor a codificação predefinida na opção <menuchoice> <guimenu>Configurações</guimenu> <guimenuitem>Configurar Editor...</guimenuitem></menuchoice>, na página <guilabel>Abrir/Salvar</guilabel>, para definir uma codificação diferente para o seu documento atual. A codificação que definir aqui será válida apenas para o seu documento atual.</para>
<para>Escolhe o modo de fim de linha que preferir para o documento ativo. Isto substitui o modo de fim de linha global definido na opção <menuchoice> <guimenu>Configurações</guimenu> <guimenuitem>Configurar Editor...</guimenuitem></menuchoice>, somente para o seu documento atual.</para>
<listitem><para><action>Isto inicia o programa de verificação ortográfica - um programa que é desenhado para ajudar o usuário a descobrir e a corrigir os erros ortográficos.</action> Clicar 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. Começando 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 arquivo que contém uma lista com as palavras corretas com as quais compara cada palavra no editor.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Substituir com:</guilabel></term>
<listitem><para>Se o verificador possuir alguma palavra semeplhante no seu dicionário a primeira será listada aqui. O usuário pode aceitar a sugestão, digitar nesta caixa sua correção, ou escolher uma sugestão diferente a partir da próxima caixa.</para></listitem>
<listitem><para>O verificador pode listar aqui um número de possíveis substituições para a palavra em consideração. Clicar em qualquer uma das sugestões fará com que a palavra seja inserida na caixa <guilabel>Substituição</guilabel> acima.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Idioma:</guilabel></term>
<listitem><para>Se você tiver múltiplos dicionários instalados, aqui você pode selecionar qual dicionário/idioma deve ser usado.</para></listitem>
<term><guibutton>Adicionar ao Dicionário</guibutton></term>
<listitem><para>Pressionar este botão adiciona a palavra na caixa <guilabel>Palavra Desconhecida:</guilabel> ao dicionário do verificador. Isto significa que no futuro o verificador sempre considerará esta palavra como ortograficamente correta.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Substituir</guibutton></term>
<listitem><para>Este botão faz o verificador substituir a palavra em consideração no documento com a palavra na caixa <guilabel>Substituição:</guilabel>.</para></listitem>
<listitem><para>Este botão faz com que o verificador substitua não somente a <guilabel>Palavra desconhecida:</guilabel> atual, mas automaticamente faça a mesma substituição para qualquer outra ocorrência detsa <guilabel>Palavra Desconhecida:</guilabel> no documento.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Ignorar</guibutton></term>
<listitem><para>Ativar este botão fará com que o verificador avance sem realizar nenhuma mudança.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Ignorar Todas</guibutton></term>
<listitem><para>Este botão faz com que o verificador não faça nada com a <guilabel>Palavra desconhecida:</guilabel> atual e em nenhuma das outras ocorrências da mesma palavra.</para> <note><para>Isto só se aplica a esta rodada de verificação ortográfica. Se o verificador for executado de novo, mais tarde, ele 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 Seleção...</guimenuitem></menuchoice></term>
<para>Isto aumenta a indentação do parágrafo em um passo. O tamanho do passo depende das <link linkend="pref-indent">configurações de indentação</link>.</para>
<para>Isto reduz a indentação do parágrafo em um passo. O tamanho do passo depende das <link linkend="pref-indent">configurações de indentação</link>.</para>
<para>Isto limpa a indentação da seleção atual ou da linha onde o cursor se encontra. Limpar a indentação, garante que todo o seu texto selecionado segue o modo de indentação que escolher.</para>
<para>Faz um novo alinhamento da linha atual ou das linhas selecionadas, usando o modo de indentação e a configuração de indentação no documento.</para>
<listitem><para>Isto adiciona um espaço ao início da linha onde o cursor de texto está localizado ou ao início de quaisquer linhas selecionadas.</para>
<listitem><para>Isto remove um espaço (se existir) do início da linha onde o cursor de texto está localizado ou do início de quaisquer linhas selecionadas.</para></listitem>
<listitem><para>Capitaliza (coloca a primeira letra em maiúsculas e as restantes em minúsculas) o texto selecionado ou a palavra atual.</para></listitem>
<listitem><para>Junta as linhas selecionadas, ou a linha atual 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>Quebra de Linha do Documento</guimenuitem> </menuchoice></term>
<listitem><para>Aplica uma quebra de linha estática em todo o documento. Isto significa que uma linha nova de texto irá iniciar automaticamente, quando a linha atual exceder o tamanho definido na opção 'Quebrar Linha em:' da página de Edição em <menuchoice> <guimenu>Configurações</guimenu><guimenuitem>Configurar Editor...</guimenuitem></menuchoice></para></listitem>
<para>Quando habilitado, isto exibe uma barra de ferramentas móvel que contém botões usados para iniciar os comando mais frequentemente usados. Quando desabilitado a barra de ferramentas é oculta. </para>
<para>Quando habilitado, isto exibe uma pequena barra na base do editor contendo informações sobre o estado do documento atual. Quando desabilitado a barra de estado é oculta.</para>
<para>Quando estiver selecionada, esta opção mostra na barra de título a localização no sistema de arquivos do documento atual. Se não estiver, a localização ficará oculta.</para>
<para>Escolha o componente de edição de texto padrão que deseja usar no &kwrite;. Você poderá escolher o <guilabel>Padrão 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>Padrão do Sistema</guilabel>, o &kwrite; irá respeitar as suas modificações no &kcontrolcenter;. Todas as outras opções irão substituir esta. </para>
<para>Este comando abre uma janela onde poderão ser alterados os <link linkend="keybindings">atalhos de teclado</link>. Uma área no topo da janela mostra a lista de comando (ações) que poderão possuir atalhos de teclado. Abaixo da área existem três opções exclusivas. O usuário poderá optar entre Sem Tecla, Tecla Padrão ou Tecla Personalizada. (A seleção da Tecla Padrão assume que existe um atalho de teclado 'padrão'). A seleção da opção Tecla Personalizada ativa as três opções no fundo da janela. O usuário poderá então selecionar uma combinação de teclas para o comando em questão através das opções e da tecla. Por exemplo, com o comando Sobre o &kde; selecionado na área de visualização, o usuário poderia selecionar o &Ctrl; e o <keycap>Alt</keycap>, clicar no botão da tecla e depois no <keycap>K</keycap> do teclado. Isso significaria que, sempre que ele pressionasse as teclas &Ctrl; e <keycap>Alt</keycap>, seguidas da tecla <keycap>K</keycap> (enquanto usar o &kwrite;), seria chamada a janela do Sobre o &kde;. </para>
<term><anchor id="configure-toolbars"/><menuchoice><guimenu>Configurar</guimenu><guimenuitem>Configurar Barra de Ferramentas...</guimenuitem></menuchoice></term>
<listitem><para>Isto abrirá o diálogo de onde a configuração da barra de ferramentas pode ser mudada. O usuário pode escolher que botões de atalho devem aparecer na barra de ferramentas. Um quadro à esquerda lista os comando disponíveis para serem colocados na barra de ferramentas. O quadro à direita lista os comando que já estão na barra de ferramentas. Um conjunto de quatro botões de seta entre os dois quadros manipulam as seleções. A seta apontando para direita coloca qualquer comando selecionado no painel esquerdo para o painel direito, <abbrev>isto é</abbrev>, ele adiciona-o à barra de ferramentas. A seta esquerda faz simplesmente o oposto, removendo qualquer ação selecionada no quadro direito da barra de ferramentas. As setas apontando para cima e para baixo mudam a posição da ação selecionada no quadro direito mudando a posição deste botão na barra de ferramentas.</para> </listitem>
<para>A seleção do <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar Editor...</guimenuitem></menuchoice>, a partir do menu, provoca o aparecimento da janela para <guilabel>Configurar 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 usuário seleciona, numa lista vertical do lado esquerdo da janela. Recorrendo aos três botões na parte inferior da janela, o usuário poderá controlar o processo. </para>
<para>Ele pode invocar o sistema de <guilabel>Ajuda</guilabel>, aceitar as configurações atuais e fechar o diálogo através do botão <guibutton>OK</guibutton> ou <guibutton>Cancelar</guibutton>. As categorias <guilabel>Cores</guilabel>, <guilabel>Fontes</guilabel>, <guilabel>Indentação</guilabel>, <guilabel>Seleção</guilabel>, <guilabel>Editar</guilabel>, <guilabel>Ortografia</guilabel> e <guilabel>Destaque</guilabel> são detalhadas abaixo. </para>
<term><guilabel>Quebra de linha dinâmica</guilabel></term>
<listitem><para>Se esta opção estiver assinalada, as linhas de texto serão repartidas na borda da janela na tela.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Indicadores de quebra de linha dinâmica</guilabel></term>
<listitem><para>Escolha se deseja mostrar os indicadores de quebra de linha dinâmica. </para></listitem></varlistentry>
<varlistentry>
<term><guilabel>Alinhar verticalmente as quebras de linhas dinâmicas à profundidade de indentação: </guilabel></term>
<listitem><para>Ativa o início das linhas repartidas com quebras 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>Além disso, isto permite-lhe definir uma largura máxima da tela, 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 da tela 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 atual irá mostrar marcações para dobrar ou desdobrar o código, se este estiver disponível.</para></listitem>
<term><guilabel>Mostrar a borda dos ícones </guilabel></term>
<listitem><para>Se esta opção estiver assinalada, você irá ver uma borda para os ícones do lado esquerdo. A borda dos ícones mostra os sinais de favoritos, por exemplo.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Mostrar números de linha </guilabel></term>
<listitem><para>Se esta opção estiver assinalada, você irá ver os números das linhas do lado esquerdo.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Mostrar as marcas na barra de rolagem </guilabel></term>
<listitem><para>Se esta opção estiver assinalada, a janela atual 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 seção da janela permite-lhe configurar todos os tipos de fonte e cores de qualquer esquema de cores que tiver, assim como criar esquemas novos ou remover os existentes. Cada esquema possui a configuração das cores, fontes e estilos do texto normal e selecionado. </para>
<para>O &kwrite; irá selecionar previamente o esquema atualmente ativo para você; se quiser trabalhar num esquema diferente, comece selecionando-o na lista <guilabel>Esquema</guilabel>.</para>
<listitem><para>Este é o fundo do texto selecionado. O valor por padrão é a cor global de seleção, como está definida nas preferências de cores do &kde;. </para></listitem>
<listitem><para>Define a cor da linha atual. Se configurar esta cor um pouco diferente do fundo do Texto Normal, isto o ajudará a concentrar-se na linha atual. </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 atual tenha um fundo que seja uma mistura de mais cores. As cores das marcações são também usadas se ativar a visualização das marcas na barra de rolagem.</para></listitem>
<term><guilabel>Fundo da Borda Esquerda</guilabel></term>
<listitem><para>Esta cor é usada para as marcas, números de linhas e bordas 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ênteses correspondentes. </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Marcações de Quebra de Linha</guilabel></term>
<listitem><para>Esta cor é usada para desenhar um padrão à esquerda das linhas repartidas com quebra de linha, quando estiverem alinhadas na vertical, assim como para as marcações de quebras 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 ativos. </para></listitem>
<para>Aqui, o usuário poderá escolher a fonte padrão para o &kwrite;. Você pode escolher qualquer fonte disponível no seu sistema, assim como definir um tamanho padrão e uma codificação. Um texto de exemplo aparecerá na parte inferior da janela, para que possa ver o resultado 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á usando o estilo configurado para o item, oferecendo-lhe uma previsão imediata ao configurar um estilo. </para>
<para>Cada estilo permite-lhe selecionar atributos comuns, assim como as cores do texto e do fundo. Para retirar uma cor de fundo, clique com o botão direito para usar o menu de contexto.</para>
<para>Aqui você poderá editar os estilos de texto usados por uma definição de realce específica. O editor seleciona previamente o realce usado pelo seu documento atual. Para funcionar com um realce diferente, selecione um na lista <guilabel>Realce</guilabel>, acima da lista de estilos. </para>
<para>O nome na lista de estilos está usando o estilo configurado para o item, oferecendo-lhe uma previsão imediata ao configurar um estilo. </para>
<para>Cada estilo permite-lhe selecionar os atributos comuns, assim como as cores de fundo e do texto. Para retirar uma cor de fundo, clique com o botão direito para usar o menu de contexto. Além disso, você poderá verificar se um estilo é igual ao padrão que for usado para o item, e configurá-lo como tal, se não estiver.</para>
<para>Você irá notar 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á afetar os estilos se forem usados no formato de realce editado. </para>
<para>Quando estiver selecionado, pressionar a 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 ativada 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 selecionada, a movimentação do cursor com as teclas dos cursores 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 selecionada, a movimentação do cursor além do fim da linha simplesmente faz com que ele continue horizontalmente na mesma linha, assim como a movimentação além do início da linha não fará nada.</para>
<para>Esta opção muda o comportamento do cursor quando o usuário pressiona as teclas <keycap>Page Up</keycap> ou <keycap>Page Down</keycap>. Se desselecionado o cursor do texto se manterá na sua posição relativa dentro do texto visível no &kwrite; conforme novo texto se torna visível como resultado da operação. Logo se o cursor estiver no meio do texto visível quando a operação ocorre ele permanecerá lá (exceto quando é atingido o início ou fim do texto.) Com esta opção selecionada, o primeiro pressionamento de tecla faz com que o cursor se mova para cima ou para baixo do texto visível conforme uma nova pasta de texto é exibida.</para>
<para>Quando isto estiver ativo, 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 pressionar a tecla <keycap>TAB</keycap>.</para>
<para>Quando esta opção estiver ativa, o &kwrite; irá mostrar um pequeno ponto como representação visual das tabulações.</para>
<note><para>Isto faz também com que 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">Largura da Tabulação</term> <listitem><para>Se a opção <link linkend="pref-word-wrap"><guilabel>Substituir Tabulações Por Espaços</guilabel></link> estiver selecionada esta entrada determinará o número de espaços que o editor usará para substituir automaticamente as tabulações.</para></listitem>
<term id="pref-word-wrap"><guilabel>Quebra de Linha Estática</guilabel></term>
<listitem><para>A quebra de palavra é um recurso que faz com que o editor automaticamente inicie uma nova linha de texto e mova (quebre) o cursor para o início da nova linha. O &kwrite; automaticamente iniciará uma nova linha de texto quando a linha atual atingir o comprimento especificado pela opção <link linkend="pref-wrap-words-at">Quebrar Linhas Em:</link>.</para>
<para>Se esta opção estiver assinalada, será desenhada uma linha vertical na coluna de quebra de linha, como está definido na opção <menuchoice> <guimenu>Configurações</guimenu> <guimenuitem>Configurar Editor...</guimenuitem></menuchoice> na página de Edição. Lembre-se que o marcador de mudança de linha só é desenhado se usar uma fonte monoespaçada.</para>
<para>Se a opção <link linkend="pref-word-wrap">Quebra de Linha</link> estiver selecionada esta entrada determina o comprimento (em caracteres) no qual o editor automaticamente iniciará uma nova linha.</para>
<listitem><para>O &kwrite; automaticamente eliminará espaços extras no final das linhas de texto.</para></listitem> </varlistentry>
<varlistentry>
<term><guilabel>Auto Colchetes</guilabel></term> <listitem><para>Quando o usuário digitar um colchete esquerdo ([, ( ou {) o &kwrite; irá inserir automaticamente o colchete direito (}, ) ou ]) à direita do cursor.</para></listitem>
</varlistentry>
<varlistentry> <term>Passos do <link linkend="undo">desfazer</link>:</term>
<listitem><para>Aqui o usuário pode especificar o número de passos que o &kwrite; manterá na memória para fim de desfazer entradas e ações. Isto significa que quanto maior o número de passos configurados mais memória o &kwrite; usará para isto. Configurar esta entrada para 10 significa que o usuário será capaz de reverter as últimas dez operações, <abbrev>por exemplo</abbrev> clicar o botão <guibutton>desfazer</guibutton> 10 vezes e obter resultados.</para></listitem> </varlistentry>
<varlistentry> <term>Origem do texto para procura inteligente:</term>
<listitem><para>Isto determina de onde o &kwrite; irá obter o texto da procura (que será inserido automaticamente na janela para Procurar Texto): <itemizedlist> <listitem><para><emphasis role="bold">Nenhum Lugar:</emphasis> Não irá adivinhar o texto de procura.</para></listitem> <listitem><para><emphasis role="bold">Somente Seleção:</emphasis> Usar a seleção do texto atual, se disponível. </para></listitem> <listitem><para><emphasis role="bold">Seleção, então Palavra Atual:</emphasis> Usar a seleção atual, se disponível, caso contrário usa a palavra atual. </para></listitem> <listitem><para><emphasis role="bold">Somente Palavra Atual:</emphasis> Usa a palavra sob o cursor, se disponível.</para></listitem> <listitem><para><emphasis role="bold">Palavra Atual, então Seleção:</emphasis> Usa a palavra atual, se disponível, caso contrário usa a seleção atual. </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>Selecione o modo de indentação automático que desejar usar por padrão. Recomenda-se que use o <userinput>Nenhum</userinput> ou o <userinput>Normal</userinput> aqui e use as configurações do tipo de arquivo 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á ativa quando for aplicável.</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 ativa, o editor não irá remover mais a indentação das linhas de uma seleção, quando a linha com menor indentação ficar completamente sem indentação. Se você 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 todo o arquivo.</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 arquivo for maior que isto, os outros blocos são transferidos para o disco e carregados de forma transparente, conforme necessário.</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 arquivo de configuração do &kwrite; e carregar a linha de configuração respectiva.</para>
<term><guilabel>Cópia de Segurança ao Salvar</guilabel></term>
<listitem><para>Criar uma cópia de segurança ao salvar, fará com que o &kwrite; copie o arquivo do disco para <prefixo><nome-arquivo><sufixo>' antes de gravar as alterações. O sufixo é, por padrão <emphasis role="bold">~</emphasis> e o prefixo está em branco, por padrã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 arquivos:</guilabel></term>
<listitem><para>Esta é a lista de extensões de arquivos, usadas para determinar os arquivos a realçar, com o modo de realce de sintaxe atual.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Tipos MIME:</guilabel></term>
<listitem><para>Clicar no botão do assistente, irá mostrar uma janela com todos os tipos MIME disponíveis para escolher.</para><para>O item das <emphasis role="bold">Extensões de Arquivos</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 padrão dos documentos dos tipos MIME indicados. Quando o editor carregar um documento, ele irá tentar ver se corresponde às máscaras de arquivos ou tipos MIME para cada um dos tipos definidos e, se houver correspondência, aplica as variáveis definidas. Se corresponderem mais tipo de arquivos, será usado o que tiver maior prioridade. </para>
<term><guilabel>Tipo de arquivo:</guilabel></term>
<listitem><para>O tipo de arquivo com a maior prioridade é o que será apresentado na primeira lista. Se forem encontrados mais tipos de arquivos, eles serão também listados.</para>
<listitem><para>Isto é usado para criar um novo tipo de arquivo. Depois de clicar neste botão, os campos abaixo ficam em branco, para que você possa preencher as propriedades que deseja para o novo tipo de arquivo.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Remover</guilabel></term>
<listitem><para>Para remover um tipo de arquivo existente, selecione-o na lista e clique no botão Remover.</para></listitem>
<term><guilabel>Propriedades do tipo de arquivo atual</guilabel></term>
<listitem><para>O tipo de arquivo com a maior prioridade é o que será apresentado na primeira lista. Se forem encontrados mais tipos de arquivos, eles serão também listados.</para>
<listitem><para>O nome do tipo de arquivo será o texto do item de menu correspondente. Este nome é mostrado no item <menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Tipos de Arquivos</guimenuitem> </menuchoice></para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Seção:</guilabel></term>
<listitem><para>O nome da seção é usado para organizar os tipos de arquivos em menus. Ele também é usado no menu <menuchoice><guimenu>Ferramentas</guimenu><guimenuitem>Tipos de Arquivos</guimenuitem> </menuchoice>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Variáveis:</guilabel></term>
<listitem><para>Este texto permite-lhe configurar o &kwrite; para os arquivos selecionados por este tipo MIME, usando as variáveis do &kwrite;. Você 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 arquivos:</guilabel></term>
<listitem><para>As máscaras com caracteres especiais permitem-lhe selecionar arquivos pelo nome. Uma máscara típica usa um asterisco e a extensão do arquivo, 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 arquivo. Se mais de um tipo de arquivo corresponder com um arquivo, será utilizado o com a prioridade mais elevada.</para></listitem>
<para>Você poderá alterar aqui a configuração dos atalhos. Selecione uma ação e clique em <guilabel>Personalizado</guilabel> se quiser um atalho diferente para esta ação.</para>
<para>A linha de procura permite-lhe procurar por uma determinada ação e ver o seu atalho associado.</para>
<para>Esta página lista todos os plugins disponíveis e você poderá assinalar os que deseja usar. Assim que um plugin seja assinalado, o botão <guibutton>Configurar</guibutton> fica ativo e você poderá clicar nele para configurar o plugin selecionado.</para>
