<chapter id="tinkering-under-the-hood">
<!-- Uncomment the <*info
> below and add your name to be -->
<!-- credited for writing this section. -->

<!--
<chapterinfo>
<authorgroup>
<author>
<firstname
>Your First Name here</firstname>
<surname
>Your Surname here </surname>
</author>
</authorgroup>
</chapterinfo>
-->

<title
>Trabalhar nos Bastidores do &kde;</title>

<sect1 id="hand-editing-config-files">

<sect1info>
<author
><personname
> <firstname
>Nicolas</firstname
> <surname
>Goutte</surname
> </personname
> <email
>goutte@kde.org</email
> </author>
</sect1info>

<title
>Editar à Mão os Ficheiros de Configuração</title>

<sect2 id="hand-editing-intro">
<title
>Introdução</title>
<para
>No &kde;, os ficheiros de configuração são fáceis de alterar com um editor de texto simples como o &kate;, dado que os ficheiros de configuração são ficheiros de texto.</para>

<para
>Um exemplo de um ficheiro de texto:</para>

<programlisting
>[Geral]
AutoGravar=1
UltimoFicheiro=/var/tmp/teste.txt</programlisting>

<para
>Os ficheiros de configuração de um utilizador estão em <filename class="directory"
>.kde/share/config</filename
> (substitua o <filename
>.kde</filename
> pela sua variável de ambiente $<envar
>KDEHOME</envar
>) e os globais estão na subpasta <filename class="directory"
>share/config</filename
> do local onde o KDE foi instalado. (Poderá encontrar esta localização se executar o comando <command
>kde-config --prefix</command
>.) Os seus nomes terminam normalmente em 'rc' (sem um ponto inicial), como por exemplo <filename
>kopeterc</filename
>.</para>

<warning
><para
>Contudo, os ficheiros de configuração editados manualmente, podem comprometer a estabilidade do seu &kde;. A maioria das aplicações não verificam o que lêem dos seus ficheiros de configuração e poderão ser prejudicadas pelo que obtêm da sua configuração, fazendo com que a aplicação inclusive estoire.</para
></warning>

</sect2>

<sect2 id="hand-editing-backups">
<title
>Cópias de Segurança</title>

<para
>Por isso, a primeira regra é fazer uma cópia de segurança do seu ficheiro antes de o modificar. A cópia de segurança deverá ser guardada fora de qualquer subpasta da <filename class="directory"
>.kde</filename
> (ou da pasta correspondente a $<envar
>KDEHOME</envar
>). As cópias de segurança são sempre uma boa ideia no caso de uma falha geral do &kde; que destrua os ficheiros de configuração importantes (como por exemplo as suas opções do &kmail;, que se encontram no ficheiro <filename
>kmailrc</filename
>). (Uma falha grande dessas não deveria acontecer, mas pode à mesma ocorrer.)</para>
</sect2>

<sect2 id="hand-editing">
<title
>Edição</title>

<para
>Assim, para quê mexer nos ficheiros de configuração? Bem, primeiro, é necessário se quiser obrigar o uso do modo KIOSK. Talvez um programador lhe tenha pedido para adicionar um item que o ajude a depurar um erro. Talvez queira recuperar de um problema sem ter de remover toda a pasta <filename class="directory"
>.kde</filename
>. Talvez queira aprender mais sobre os detalhes do &kde;.</para>

<para
>De qualquer forma, seja qual for a razão, poderá desejar modificar à mão um ficheiro de configuração.</para>

<para
>Ao planear editar um ficheiro desses, certifique-se que a aplicação que o usa não está a correr. Se for um dos ficheiros de configuração, pense em editar o ficheiro enquanto o &kde; não está a correr de todo.</para>

<para
>Está pronto? Faça então uma cópia de segurança (já foi dito alguma vez?), inicie o seu editor favorito (assumindo neste caso o &kate;), abra o ficheiro (tenha o cuidado de o carregar como UTF-8, dado que o &kate; o mostra <quote
>utf8</quote
>).</para>

<para
>Agora terá um ficheiro do tipo:</para>

<programlisting
>[Grupo]
Chave1=Valor1
Chave2=Valor2
Chave3=Valor3</programlisting>

<para
>Poderá agora modificá-lo (com cuidado!) e depois gravá-lo (garantido outra vez que é <acronym
>UTF-8</acronym
>).</para>

<para
>Agora, poderá testar a aplicação e, se esta não executar mais correctamente, feche-a e reponha a cópia de segurança.</para>

<itemizedlist>
<title
>Informação Relacionada</title>


<listitem
><para
><xref linkend="kde-for-administrators"/> tem mais informações sobre a estrutura de pastas do &kde;, de modo a ajudá-lo a encontrar o ficheiro que precisa de editar.</para>
</listitem>

</itemizedlist>

</sect2>

</sect1>

<sect1 id="scripting-the-desktop">
<title
>Programar o Ambiente de Trabalho</title>
<para
>Uma breve introdução à programação em DCOP. O 'kdcop'.</para>
</sect1>

<sect1 id="adding-extra-keys">
<title
>Adicionar Atalhos de Teclado Extra para o &kde;</title>

<para
>Muitos teclados modernos contêm teclas extra que não estão atribuídas por omissão a nenhuma acção.</para>

<para
>As teclas <quote
>Multimédia</quote
> geram normalmente um sinal e podem simplesmente ser escolhidas como uma combinação de teclas dentro de uma aplicação, como quem escolhe uma tecla qualquer. Algumas das teclas, todavia, não são detectadas e, se carregar nelas no <guilabel
>Configurar os Atalhos</guilabel
>, não fará efeito.</para>

<para
>Alguns portáteis da IBM, por exemplo, têm teclas extra em torno dos cursores esquerdo e direito, e que parecem um <guiicon
>Page Left</guiicon
> e um <guiicon
>Page Right</guiicon
>.</para>

<procedure>
<step
><para
>Use o <command
>xev</command
> para descobrir o código das teclas. Neste caso, este é o 233 e o 234, respectivamente </para
></step>
<step
><para
>Escolha os símbolos das teclas. Existe alguns intervalos que não são usados por omissão, por isso muitos estão livres. Poderá encontrar a lista em <filename
>/usr/X11R6/include/X11/keysymdef.h</filename
> (ou o equivalente no seu sistema).</para
></step>
<step
><para
>Crie um ficheiro na sua pasta pessoal chamado <filename
>.Xmodmap</filename
> e adicione o seguinte a ele:</para>
<screen
>keycode 233 = Next_Virtual_Screen
keycode 234 = Prev_Virtual_Screen</screen>
</step>
<step
><para
>Execute o comando <userinput
><command
>xmodmap</command
> <filename
>~/.Xmodmap</filename
></userinput
></para
></step>
</procedure>

<para
>Nesta altura, deverá ser capaz de executar o <command
>xev</command
> de novo e ver que as teclas geram agora o símbolo da tecla que atribuiu. Poderá aora atribuir esses símbolos a qualquer acção, como de costume.</para>

<itemizedlist>
<title
>Informação Relacionada</title>
<listitem
><para
>A página de manual do <command
>xev</command
>. Poderá ver isso se executar <userinput
>man:/xev</userinput
> numa janela do &konqueror; ou se executar <userinput
><command
>man</command
> xev</userinput
> num terminal.</para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="keys-for-scripts">
<title
>Adicionar Combinações de Teclas às Acções Novas</title>

<para
>A maioria das acções do ecrã ou das aplicações estão logo disponíveis para poder associar uma combinação de teclas. Se a acção a que deseja atribuir um atalho foi algo criado por si ou que ainda não esteja disponível, você poderá à mesma atribuir um atalho.</para>

<para
>Para reunir as duas secções anteriores, talvez queira atribuir uma tecla não usada do seu teclado a um programa ou comando de DCOP. O exemplo aqui será então atribuir as duas teclas que foram adicionadas em <xref linkend="adding-extra-keys"/> para ir para o ecrã virtual anterior ou o seguinte, ou seja, duas funções para as quais irá necessitar do DCOP (tal como foi descrito em <xref linkend="scripting-the-desktop"/>.</para>

<para
>Isto pode ser conseguido facilmente com o seguinte método:</para>

<procedure>
<step>
<para
>Abra o &kcontrol; na secção <guilabel
>Regional &amp; Acessibilidade</guilabel
>, mais concretamente no <guilabel
>KHotKeys</guilabel
></para>
</step>
<step>
<para
>Escolha a <guibutton
>Nova Acção</guibutton
></para>
</step>
<step>
<para
>Dê um nome à acção nova, &eg; <userinput
>Próximo Ecrã Virtual</userinput
></para>
</step>
<step>
<para
>Seleccione o <guilabel
>Atalho de teclado -> Comando/URL (simples)</guilabel
> para o <guilabel
>Tipo de acção:</guilabel
></para>
</step>
<step>
<para
>Na página do <guilabel
>Atalho do Teclado</guilabel
>, carregue no botão que deseja usar para despoletar o comando. Para este exemplo, iria carregar na tecla com a imagem do <guiicon
>Próxima Página</guiicon
> nele. O <keysym
>Next_Virtual_Screen</keysym
> irá aparecer na imagem da tecla.</para>
</step>
<step>
<para
>Na página do <guilabel
>Configuração do Comando/URL</guilabel
>, indique o comando a executar no campo: <userinput
><command
>dcop kwin default nextDesktop</command
></userinput
></para>
</step>
</procedure>

<para
>Repita os passos anteriores com a tecla <keysym
>Prev_Virtual_Screen</keysym
> key e a acção <userinput
><command
>dcop kwin default previousDesktop</command
></userinput
>.</para>

<para
>Agora, se carregar nas teclas <keysym
>Prev_Virtual_Screen</keysym
> ou <keysym
>Next_Virtual_Screen</keysym
>, irá mudar para o ecrã virtual anterior ou o próximo, respectivamente.</para>

<para
>Obviamente, poderá atribuir qualquer tecla livre a qualquer acção.</para>

<itemizedlist>
<title
>Informação Relacionada</title
> 
<listitem
><para
>Veja a documentação do <application
>KHotKeys</application
> no &khelpcenter;, ou escreva <userinput
>help:/khotkeys</userinput
> numa janela do &konqueror;.</para
></listitem
> 
<listitem
><para
><xref linkend="adding-extra-keys"/></para
></listitem>
<listitem
><para
><xref linkend="scripting-the-desktop"/></para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="kdebugdialog">
<sect1info>
<authorgroup>
<author
><personname
> <firstname
>Adriaan</firstname
> <surname
>de Groot</surname
> </personname
> <email
>groot@kde.org</email
> </author>
</authorgroup>
</sect1info>

<title
>&kdebugdialog; - Controlar o Resultado da Depuração do &kde;</title>

<sect2 id="kdebugdialog-basic-usage">
<title
>Utilização Básica</title>

<para
>O &kdebugdialog; não está no &kmenu; por omissão. Terá de o executar na linha de comandos ou na mini-janela de execução de comandos com <userinput
><command
>kdebugdialog</command
></userinput
>. O &kdebugdialog; mostra uma janela com uma lista grande de áreas de depuração. Cada área tem uma opção que poderá ligar ou desligar para activar ou desactivar o resultado de depuração dessa parte do &kde;.</para>

<para
>A lista de áreas de depuração vem ordenada numericamente, não alfabeticamente, como tal o kio (127) vem antes do artskde (400). Os números vão até perto de 200 000, mas normalmente só existem 400 áreas. Não terá de percorrer a lista completa para encontrar a área que precisa. Existe um campo de texto no topo da janela, onde poderá indicar uma parte do nome da área que deseja. A lista de itens que é apresentada é filtrada de modo a incluir apenas as áreas de depuração que contêm o texto que introduziu, &eg; se introduzir <userinput
>k</userinput
> não irá filtrar muito mas, se indicar <userinput
>kont</userinput
>, deverá aparecer apenas as áreas de depuração do &kontact;. Como uma forma mais rápida de activar ou desactivar o resultado de depuração, existe também os botões para <guibutton
>seleccionar tudo</guibutton
> e <guibutton
>deseleccionar tudo</guibutton
>, que fará com que o &kde; produza bastantes dados de depuração, ou quase nenhuns.</para>
</sect2>

<sect2 id="kdebugdialog-fullmode">
<title
>O KDebugDialog no modo completo</title>

<!-- this text partly taken from the kdebugdialog handbook -->

<para
>No modo completo, que é o que você irá obter ao executar o KDebugDialog como <userinput
><command
>kdebugdialog</command
> <option
>--fullmode</option
></userinput
>, fica disponível a mesma lista de áreas de depuração, podendo seleccionar apenas uma de cada vez numa lista. Poderá então definir o resultado para os vários tipos de mensagens: Informação, Aviso, Erro e Erro Fatal. Para cada um destes tipos, poderá escolher para onde são enviadas as mensagens. As opções são:</para>

<para
>Ficheiro, onde terá de indicar o nome de um ficheiro. Este será escrita na sua pasta $<envar
>HOME</envar
>.</para>

<para
>Janela de Mensagem. Cada mensagem de depuração é mostrada numa janela de informação, pelo que terá de carregar em <guibutton
>OK</guibutton
> para continuar com a a aplicação.</para>

<para
>Linha de Comandos, o item por omissão. As mensagens são impressas no 'stderr' e irão aparecer tanto na janela da linha de comados em que a aplicação foi iniciada, como no <filename
>.xsession-errors</filename
>.</para>

<para
>Syslog. Este envia cada mensagem de depuração para a funcionalidade de registo do systema ('syslog'), o qual poderá efectuar um processamento prévio da mensagem.</para>

<para
>Nenhum. Isto elimina o resultado deste tipo de mensagem.</para>

<para
>Para as mensagens geradas pelos erros fatais, é normalmente uma má ideia escolher o Nenhum ou o Syslog, dado que em ambos os casos poderá não ver a mensagem e a aplicação que obtenha o erro fatal irá desaparecer ser deixar uma razão do seu desaparecimento. Se a aplicação desaparecerá ou não no caso de um erro fatal, poderá ser definido na opção <guilabel
>Abortar nos erros fatais</guilabel
>, que está assinalada por omissão &mdash; mas poderá contar à mesma que uma aplicação estoire (de forma confusa) se for encontrado um erro à mesma.</para>

<!-- Add links to "further reading" here -->
<itemizedlist>
<title
>Informação Relacionada</title>
<listitem
><para
></para>
</listitem>
</itemizedlist>



</sect2>
</sect1>
</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-omittag:nil
sgml-shorttag:nil
sgml-namecase-general:nil
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:true
sgml-parent-document:("index.docbook" "book" "chapter")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
