1
<chapter id="configuring-kate">
5
>&Anders.Lund; &Anders.Lund.mail;</author>
6
<othercredit role="translator"
14
>zepires@gmail.com</email
24
>Configurar o &kate;</title>
26
<sect1 id="configuring-overview">
34
>configurações</secondary>
36
>preferências</tertiary
38
<anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> O &kate; oferece várias formas de equipar a aplicação para que se comporte como desejado. As mais importantes são: </para>
43
>A Janela de Configuração</term>
46
>A ferramenta de configuração principal, que permite ao utilizador configurar a aplicação &kate;, o componente do editor e a utilização de 'plugins'.</para
52
>Configuração</guimenu
56
>permite-lhe alterar as opções mais usadas e lançar as janelas de configuração.</para
66
>Permite-lhe repartir a janela actual, assim como mostrar a barra de ícones e de números de linha para o documento actual.</para
72
>O terminal incorporado usa a configuração definida no &systemsettings;, e pode ser configurado se carregar com o botão <mousebutton
74
> do rato para mostrar um menu de contexto.</para>
78
<sect1 id="configuring-kate-configdialog">
80
>A Janela Principal de Configuração</title>
84
<imagedata format="PNG" fileref="configdialog01.png"/>
89
>A janela de configuração do &kate; mostra uma árvore com os tópicos à esquerda, bem como uma página de configuração correspondente ao tópico seleccionado à direita. A árvore agrupa as páginas da janela em grupos lógicos.</para>
92
>A configuração está dividida em dois grupos, nomeadamente <itemizedlist>
95
><link linkend="config-dialog"
96
>Configuração da aplicação</link>
101
><link linkend="config-dialog-editor"
102
>Configuração do componente de edição</link
112
<sect1 id="config-dialog">
114
>A Configuração da Aplicação &kate;</title>
116
>Este grupo contém páginas para configurar a aplicação principal do &kate;</para>
118
<sect2 id="config-dialog-general">
122
>Esta secção contém algumas opções globais para o &kate;</para>
128
><anchor id="config-general-behavior"/>
130
>Comportamento</guilabel
137
><anchor id="config-dialog-general-warn-mod"/>
139
>Avisar acerca de ficheiros modificados por outros processos</guilabel
143
>Quando esta opção estiver activa, o &kate; notificá-lo-á dos ficheiros modificados fora da aplicação, sempre que a janela principal for colocada em primeiro plano. Será então capaz de lidar com vários ficheiros modificados de uma vez, os quais poderá voltar a carregar, gravar ou esquecer os ficheiros alterados nos grupos.</para>
145
>Se não estiver activada, o &kate; perguntar-lhe-á a acção a fazer, quando um ficheiro modificado externamente ficar em primeiro plano, dentro da aplicação.</para>
152
><!-- /behavior group -->
156
><anchor id="config-general-meta-data"/>
158
>Meta-Informação</guilabel
165
><anchor id="config-general-keep-meta-information"/>
167
>Manter a meta-informação das sessões anteriores</guilabel
171
>Quando estiver activa, o &kate; irá guardar alguns meta-dados, como a configuração dos favoritos e da sessão, mesmo quando fechar os seus documentos. Os dados serão usados, se o documento não estiver alterado, quando for aberto de novo.</para
177
><anchor id="config-general-delete-meta-information-after"/>
179
>Remover a meta-informação não usada após</guilabel
183
>Indica o número máximo de dias durante os quais mantém a meta-informação dos ficheiros por abrir. Isto mantém a base de dados de meta-informação com um tamanho razoável.</para
191
><!-- /meta data group -->
195
><anchor id="config-general-default-text-editing-component"/>
197
>Componente de edição de texto por omissão</guilabel
201
>Seleccione o componente de edição de texto que é usado pelo &kate;. Por omissão, está configurado para usar o componente de edição predefinido do sistema, de acordo com o configurado no &systemsettings;.</para
208
<sect2 id="config-dialog-sessions">
213
>Esta secção contém opções relacionadas com a <link linkend="fundamentals-using-sessions"
214
>utilização das sessões</link
221
><anchor id="config-dialog-sessions-elements"/>
223
>Elementos das Sessões</guilabel
230
>Incluir a configuração da janela</guilabel
234
>Se estiver activada esta opção, o &kate; irá gravar a configuração da janela com cada sessão.</para
240
><!-- /elements of sessions -->
244
><anchor id="config-dialog-sessions-startup-behavior"/>
246
>Comportamento no Arranque da Aplicação</guilabel
250
>Seleccione a forma como deseja que o &kate; se comporte no arranque. Esta opção poderá ser substituída se definir o que fazer na <link linkend="command-line-options"
251
>linha de comandos</link
257
>Iniciar uma sessão nova</guilabel
261
>Com esta opção, o &kate; irá iniciar uma sessão nova sem nome, quando a iniciar.</para
267
>Carregar a última sessão usada</guilabel
271
>O &kate; irá usar a sessão mais recente no arranque. Isto é bom se quiser usar a mesma sessão sempre ou deseja mudar raramente.</para
277
>Escolher manualmente uma sessão</guilabel
281
>O &kate; irá mostrar uma pequena janela que lhe permite escolher a sua sessão preferida ou carregar a sessão predefinida, caso não tenha sido gravada nenhuma. Este é o comportamento por omissão. Isso é bom se usar bastantes sessões diferentes com frequência.</para
287
><!-- /startup behavior -->
291
>As alterações nos dados da sessão (ficheiros abertos e, se estiver activa, a configuração das janelas) serão sempre guardadas.</para>
295
<sect2 id="config-dialog-treeview">
297
>Vista em Árvore</title
298
> <!-- Tree View was renamed to Documents - http://commit-digest.org/issues/2011-08-28/ -->
299
<!-- Tree View plugin http://kate-editor.org/2010/09/10/tree-view-plugin-introduction/ -->
304
>Sombra do Fundo</guilabel
308
>Esta página permite-lhe activar ou desactivar a visualização sombreada do fundo da sua actividade recente e escolher as cores a usar, se estiver activada. Veja a secção sobre a <link linkend="kate-mdi-tools-file-list"
309
>Lista de Documentos</link
310
> para mais dados sobre esta funcionalidade.</para
316
>Ordenar Por</guilabel
320
>Indique como deseja ordenar a lista de documentos. Isto também poderá ser feito, com o menu do &RMB;, na lista de documentos.</para
324
View Mode - Tree View / List View missing
329
>Mostrar a Localização Completa</guilabel
333
>Quando estiver activo, no modo em árvore, a pastas de topo irão aparecer com a localização completa, em vez de ser apenas o nome da última pasta.</para
341
<sect2 id="config-dialog-plugins">
346
>Esta página oferece uma lista de 'plugins' instalados para a aplicação &kate;. Cada 'plugin' é representado pelo seu nome e uma breve descrição. Poderá assinalar a opção com um item para activar o 'plugin' que representa. </para>
349
>Se um 'plugin' tiver opções de configuração, irá aparecer uma secção para aceder a estas, como filha desta página.</para>
353
<sect2 id="config-dialog-general-sync-konsole">
358
>Esta página só aparece na ferramenta do Terminal, que se encontra activa por omissão.</para>
364
>Sincronizar automaticamente o terminal com o documento actual se possível</guilabel
368
>Isto fará com que o terminal incorporado faça <command
370
> para a pasta do documento activo quando for lançado e de cada vez que um novo documento passar para primeiro plano. Se não estiver activo, tem de efectuar a sua navegação no &konsole; por si próprio. </para
377
>Mudar a variável de ambiente EDITOR para 'kate -b'</guilabel
381
>Isto muda a variável de ambiente <envar
383
>, para que os programas que se executem no terminal incorporado abram automaticamente um ficheiro no &kate; em vez de usar o editor predefinido da sua consola. Não poderá continuar a usar o terminal até que tenha fechado o ficheiro no &kate;, para que o programa invocado saiba que acabou de editar o ficheiro.</para
390
&configuring-part-sections; <sect1 id="config-variables">
392
>Configurar com Variáveis do Documento</title>
395
>As variáveis do &kappname; são a implementação do 'katepart' para as variáveis do documento, de forma semelhante ao que acontece com as linhas de modo do ' emacs' e 'vi'. No 'katepart', as linhas têm o seguinte formato: <userinput
396
>kate: NOME-VARIÁVEL VALOR; [ NOME-VARIÁVEL VALOR; ... ]</userinput
397
> As linhas poderão estar obviamente num comentário, caso o ficheiro esteja num formato com comentários. Os nomes das variáveis são palavras únicas (sem espaços em branco) e tudo o que exista até ao ponto-e-vírgula seguinte é o valor. O ponto-e-vírgula é obrigatório.</para>
400
>Aqui está uma linha de variáveis de exemplo, forçando a configuração da indentação para um ficheiro em C++, Java ou JavaScript: <programlisting
401
>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting>
406
>Só são pesquisadas por linhas de variáveis as 10 primeiras e últimas linhas de cada ficheiro.</para
410
>Adicionalmente, as variáveis do documento são colocadas num ficheiro chamado <filename
411
>.kateconfig</filename
412
> em qualquer pasta, sendo aplicada a configuração definida como se as linhas de modo fossem introduzidas em todos os ficheiros da pasta e das suas sub-pastas, até ao limite da <link linkend="pref-open-save-advanced"
413
>profundidade de pesquisa configurada</link
414
>. As variáveis do documento no <filename
415
>.kateconfig</filename
416
> usam a mesma sintaxe das linhas de modo.</para>
419
>Existem variáveis para suportar quase todas as configurações da 'katepart' e também os 'plugins' poderão usar as variáveis; nesse caso, isso deverá estar referido na documentação do 'plugin'.</para>
421
<sect2 id="config-variables-howto">
423
>Como é que o &kappname; usa as Variáveis</title>
426
>Ao ler a configuração, o 'katepart' procura nos seguintes locais (por essa ordem): <itemizedlist
429
>A configuração global.</para
433
>Os dados opcionais da sessão.</para
437
>A configuração do "Tipo de Ficheiro".</para
441
>As variáveis do documento no <filename
442
>.kateconfig</filename
447
>As variáveis do documento no próprio documento.</para
451
>A configuração efectuada pelo menu ou pela linha de comandos</para
454
>. Como pode ver, as variáveis do documento só são substituídas pelas alterações feitas durante a execução. Sempre que é gravado um documento, as variáveis do mesmo são lidas de novo e irão substituir as alterações feitas com os itens do menu ou a linha de comandos.</para>
457
>Qualquer variável que não conste em baixo é guardada no documento e poderá ser consultada por outros objectos, como os 'plugins', que as poderão usar para os seus fins. Por exemplo, o modo de indentação variável usa as variáveis do documento para esse fim.</para>
460
>As variáveis aqui apresentadas referem-se ao &kappname; na versão 3.7. Poder-se-ão adicionar mais variáveis no futuro. Existem 3 tipos de valores possíveis para as variáveis, com as seguintes expressões válidas: <itemizedlist>
463
>BOOLEANO - on|off|true|false|1|0</para
467
>INTEIRO - qualquer número inteiro</para
471
>TEXTO - tudo o resto</para
478
<sect2 id="config-variables-list">
480
>Variáveis Disponíveis</title>
484
<varlistentry id="variable-auto-brackets">
488
>auto-brackets</command
495
>Activa ou desactiva a introdução automática de parêntesis.</para
499
<varlistentry id="variable-auto-center-lines">
503
>auto-center-lines</command
510
>Define o número de linhas de alinhamento automático ao centro.</para
514
<varlistentry id="variable-auto-insert-doxygen">
518
>auto-insert-doxygen</command
525
>Activa ou desactiva a introdução do asterisco inicial nos comentários do 'doxygen'. Isto não fará efeito a menos que use a indentação automática do C. </para
529
<varlistentry id="variable-background-color">
533
>background-color</command
540
>Define a cor de fundo do documento. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo <userinput
546
<varlistentry id="variable-backspace-indents">
550
>backspace-indents</command
557
>Activa ou desactiva a remoção da indentação quando carregar no &Backspace;.</para
561
<varlistentry id="variable-block-selection">
565
>block-selection</command
572
>Activa ou desactiva a <link linkend="kate-part-selection-block"
573
>selecção em bloco</link
578
<varlistentry id="variable-byte-order-marker">
582
>bom | byte-order-marker</command
589
>Activa/desactiva o marcador da ordem de 'bytes' ao gravar os ficheiros no formato Unicode (utf8, utf16, utf32).</para>
591
>Desde: Kate 3.4 (KDE 4.4)</para
595
<varlistentry id="variable-bracket-highlight-color">
599
>bracket-highlight-color</command
606
>Define a cor do realce de parêntesis. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo <userinput
612
<varlistentry id="variable-current-line-color">
616
>current-line-color</command
623
>Define a cor da linha actual. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo <userinput
629
<varlistentry id="variable-default-dictionary">
633
>default-dictionary</command
640
>Define o dicionário predefinido que é usado na verificação ortográfica.</para>
642
>Desde: Kate 3.4 (KDE 4.4)</para
646
<varlistentry id="variable-dynamic-word-wrap">
650
>dynamic-word-wrap</command
657
>Activa ou desactiva a <link linkend="kate-part-auto-wrap"
658
>mudança de linha dinâmica</link
663
<varlistentry id="variable-end-of-line">
667
>eol | end-of-line</command
674
>Define o modo do fim-de-linha. Os valores válidos são o <userinput
684
<varlistentry id="variable-folding-markers">
688
>folding-markers</command
695
>Activa ou desactiva a visibilidade dos <ulink url="help:/kate/advanced-editing-tools-code-folding.html"
696
>marcadores de dobragem</ulink
701
<varlistentry id="variable-font-size">
712
>Define o tamanho de letra do documento em pontos.</para
716
<varlistentry id="variable-font">
727
>Define o tipo de letra do documento. O valor deverá ser o nome de um tipo de letra válido, por exemplo <userinput
733
<varlistentry id="variable-syntax">
737
>hl | syntax</command
744
>Define o realce de sintaxe. Os valores válidos são todos os nomes disponíveis nos menus. Por exemplo, para o C++, basta escrever <userinput
750
<varlistentry id="variable-icon-bar-color">
754
>icon-bar-color</command
761
>Define a cor da barra de ícones. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo <userinput
767
<varlistentry id="variable-icon-border">
771
>icon-border</command
778
>Activa ou desactiva a visualização do contorno de ícones.</para
782
<varlistentry id="variable-indent-mode">
786
>indent-mode</command
793
>Define o modo de indentação automática. As opções <userinput
811
> são reconhecidos. Veja mais detalhes em <xref linkend="kate-part-autoindent"/>.</para
815
<varlistentry id="variable-indent-width">
819
>indent-width</command
826
>Define a largura da indentação.</para
830
<varlistentry id="variable-keep-extra-spaces">
834
>keep-extra-spaces</command
841
>Indica se deve manter os espaços extra ao calcular a largura de indentação.</para
845
<varlistentry id="variable-line-numbers">
849
>line-numbers</command
856
>Activa ou desactiva a visualização dos números de linha.</para
860
<varlistentry id="variable-mixed-indent">
864
>mixed-indent</command
871
>Activa ou desactiva a indentação mista, como no Emacs.</para>
873
>Nota: Descontinuado desde o Kate 3 no KDE4. Esta variável é ignorada; configure sim o <command
874
>replace-tabs on;</command
875
> como alternativa de futuro.</para
879
<varlistentry id="variable-overwrite-mode">
883
>overwrite-mode</command
890
>Activa ou desactiva o modo de sobreposição.</para
894
<varlistentry id="variable-persistent-selection">
898
>persistent-selection</command
905
>Activa ou desactiva a <link linkend="kate-part-selection-persistent"
906
>selecção persistente</link
911
<varlistentry id="variable-remove-trailing-space">
915
>remove-trailing-space</command
922
>Activa ou desactiva a limpeza dinâmica dos fins-de-linha.</para
926
<varlistentry id="variable-replace-tabs-save">
930
>replace-tabs-save</command
937
>Activa ou desactiva a conversão de tabulações para espaços ao gravar.</para
941
<varlistentry id="variable-replace-tabs">
945
>replace-tabs</command
952
>Activa ou desactiva a conversão dinâmica de tabulações para espaços ao gravar.</para
956
<varlistentry id="variable-replace-trailing-space-save">
960
>replace-trailing-space-save</command
967
>Activa ou desactiva a limpeza dos fins-de-linha ao gravar.</para
971
<varlistentry id="variable-scheme">
982
>Define o esquema de cores. O texto deverá ser o nome de um esquema de cores que existe na sua configuração para fazer qualquer efeito.</para
986
<varlistentry id="variable-selection-color">
990
>selection-color</command
997
>Define a cor da selecção. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo <userinput
1003
<varlistentry id="variable-show-tabs">
1014
>Activa ou desactiva o carácter visual de tabulação.</para
1018
<varlistentry id="variable-smart-home">
1022
>smart-home</command
1029
>Activa ou desactiva a <link linkend="pref-edit-cursor-selection"
1030
>navegação do início inteligente</link
1035
<varlistentry id="variable-space-indent">
1039
>space-indent</command
1046
>Activa ou desactiva a indentação com espaços.</para>
1048
>Nota: Descontinuado desde o Kate 3 no KDE4. A indentação mista é o comportamento por omissão. Configure o <command
1049
>replace-tabs on;</command
1050
> para obter a indentação apenas com espaços.</para
1054
<varlistentry id="variable-tab-indents">
1058
>tab-indents</command
1065
>Activa ou desactiva a indentação com a tecla 	.</para
1069
<varlistentry id="variable-tab-width">
1080
>Define a largura visível dos caracteres de espaços.</para
1084
<varlistentry id="variable-undo-steps">
1088
>undo-steps</command
1095
>Define o número de passos anulados que deverão ser recordados.</para>
1097
>Nota: Descontinuado desde o Kate 3 no KDE4. Esta variável é ignorada. O número máximo de passos de anulação é ilimitado.</para
1101
<varlistentry id="variable-word-wrap-column">
1105
>word-wrap-column</command
1112
>Define a largura da <link linkend="kate-part-auto-wrap"
1113
>mudança de linha estática</link
1118
<varlistentry id="variable-word-wrap-marker-color">
1122
>word-wrap-marker-color</command
1129
>Define a cor do marcador da mudança de linha. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo <userinput
1135
<varlistentry id="variable-word-wrap">
1146
>Activa ou desactiva a mudança de linha estática.</para
1150
<varlistentry id="variable-wrap-cursor">
1154
>wrap-cursor</command
1161
>Activa ou desactiva a mudança de linha do cursor.</para