# Instruções de instalação

Estas são instruções genéricas para o Ambiente de Trabalho K. Por favor, complemente a sua leitura com os `README`s e os `INSTALL`s que vêm com o pacote. Leia-os cuidadosamente e tente procurar ajuda se algo correr mal. Se necessitar de mais assistência, considere juntar-se às listas do correio (veja as instruções no nosso site web para juntar-se às listas de correio do &kde;) ou grupos de notícias do &kde;.

Para possíveis convertidos

Então ouviu os rumores. Ou viu as capturas de tela exemplos, e está ansioso para possuir o &kde;, mas não sabe nada sobre esta história de SO alternativo. Não se preocupe! Só precisa de fazer algumas (bem, talvez nem tantas) leituras e é tudo!

O &kde; não se executa sob nenhuma versão do &Microsoft; &Windows; ou OS/2 (ainda). Para executar o &kde;, você precisa ter um sistema &UNIX;. Por favor, pesquise as plataformas para mais detalhes.

Decida a plataforma e configure-a para o seu sistema. Esta FAQ não pode lhe ajudar com isso, uma vez que o &kde; é executado em muitas plataformas &UNIX;.

Finalmente, está pronto para iniciar a instalação do &kde;. Comece a ler a partir da próxima seção. Para obter o &kde;, veja onde obter o KDE. Por último, se encontrar alguns problemas ao instalar o &kde;, não hesite em usar as listas do correio e grupos de discussão do &kde;. Mas tenha uma coisa em mente: não existem perguntas descabidas, existem é respostas descabidas, principalmente se já foram respondidas na FAQ.

Boa sorte e divirta-se!

Formatos de pacotes disponíveis

Você pode encontrar vários tipos de pacotes binários e fonte para as diferentes distribuições e sistemas operacionais no &kde-ftp;. Os pacotes binários não são feitos pela Equipe do &kde;, mas pelos próprios distribuidores ou por alguns indivíduos dedicados. Por favor, veja a Política de Pacotes do &kde; Explicada para mais informações sobre a Política de Pacotes do &kde;. A única versão oficial são os pacotes fonte tar.bz2. Por favor, leia os `README`s e `INSTALL`s nas várias pastas de binários. Para uma lista dos pacotes disponíveis para uma determinada versão, veja a página de informações relevantes. Para a última versão esta é a Página de Informação do &kde; 3.3.2.

Pré-requisitos

Para o &kde; 3.3.2, você necessita da biblioteca &Qt; versão 3.3 ou superior. Por favor certifique-se de que você obteve o &Qt; correto. Você também precisará dos arquivos de cabeçalho, se quiser compilar você mesmo o &kde;. Todos estão disponíveis sem nenhum custo, em http://www.trolltech.com/download. Além disso, existem bibliotecas opcionais que podem melhorar o &kde; se estiverem instaladas no seu sistema. Um exemplo é o OpenSSL que permitirá ao &konqueror; navegar seguramente nas páginas web e é necessário numa versão >= 0.9.6. Esta deve ser fornecida pelo próprio distribuidor; caso contrário, solicite uma atualização.

Descrição dos pacotes básicos

A distribuição básica consiste atualmente de vinte pacotes. Alguns são obrigatórios, enquanto que outros não. Cada pacote está disponível em cada um dos formatos supracitados.

kdelibs

  Necessário

  Este pacote contém as bibliotecas compartilhadas que são necessárias para todos os aplicativos do &kde;.

kdebase

  Necessário

  Este pacote contém os aplicativos básicos que formam o núcleo do Ambiente de Trabalho K, como o gerenciador de janelas, o emulador de terminal, o centro de controle, o gerenciador de arquivos e o painel.

&arts;

  Necessário

  O servidor de som &arts;. Um servidor de som poderoso e transparente na rede.

kdeaddons

  Opcional

  Vários plugins para o &kate;, o &kicker;, o &knewsticker;, o &konqueror; e o &noatun;

kdeartwork

  Opcional

  Papéis de parede, temas, estilos, sons... adicionais

kdebindings

  Opcional

  Várias interfaces para outras linguagens, incluindo o &Java;, o Perl, o Python...

kdegames

  Opcional

  Vários jogos como &kmahjongg;, &ksnake;, &kasteroids; e &kpatience;.

kdegraphics

  Opcional

  Vários programas gráficos como os visualizadores de &PostScript; e &DVI; e um programa de desenho.

kdeutils

  Opcional

  Várias ferramentas de trabalho como uma calculadora, um editor e outras coisas úteis.

kdemultimedia

  Opcional

  Aplicações multimídia como um leitor de &CD;s e um mixador.

kdenetwork

  Opcional

  Aplicativos de rede. Atualmente contém o cliente de mensagens instantâneas &kopete;, o gerenciador de transferências &kget;, e diversos outros programas de rede.

kdepim

  Opcional

  Ferramentas de gerenciamento de informações pessoais. Contém o cliente de mensagens eletrônicas &kmail;, o leitor de notícias &knode;, entre muitos outros programas relacionados.

kdeadmin

  Opcional

  Programas de administração do sistema.

kdeedu

  Opcional

  Aplicativos educativos e de entretenimento para os usuários do &kde; mais novos.

kdeaccessibility

  Opcional

  Programas de acessibilidade do KDE como um amplificador de tela e um interface para sintetizador de voz.

kdetoys

  Opcional

  Brinquedos!

kdevelop

  Opcional

  Um Ambiente de Desenvolvimento Integrado para o &kde; e para o Qt

kdewebdev

  Opcional

  Aplicativos para desenvolvimento para Web. Contém aplicativos como o &quanta;, um ambiente de desenvolvimento web integrado e outros aplicativos úteis para desenvolvimento web

kdesdk

  Opcional

  Kit de Desenvolvimento de Softwares do KDE. Contém uma coleção de aplicativos e ferramentas usadas pelos Desenvolvedores do KDE.

O &arts; e o kdelibs devem ser instalados antes de tudo, e o kdeaddons por último. Os pacotes restantes podem ser instalados em qualquer ordem.

A maioria das ferramentas de gerenciamento de pacotes irão deixá-lo colocar estes pacotes numa pasta e instalá-los de uma vez, descobrindo elas próprias as suas dependências.

Instruções de instalação para os diferentes formatos de pacotes

Não se esqueça de ler os arquivos `README` e `INSTALL` se estiverem disponíveis.

Instalação dos pacotes da Debian

  Os pacotes da Debian instalam-se de acordo com o FHS (do inglês, Padrão de Hierarquia de Arquivos).

  - torne-se super-usuário

  - Execute `dpkg `-i nomepacote.deb`` para todos os pacotes que deseja instalar.

Instalação dos pacotes RPM

  Para instalar os RPMs com binários

  - torne-se super-usuário

  - execute `rpm `-ivh nomepacote.rpm``

Instalação dos arquivos `.tar.bz2` com código

  Uma vez que existem sempre mudanças e atualizações na forma como o &kde; é compilado, por favor, veja em Baixar e Instalar a partir do Código para as instruções de instalação dos pacotes com código-fonte mais atualizadas.

  A seguinte abordagem deve, contudo, funcionar na maioria dos casos.

  O pacote `.tar.bz2` de código instala-se em `/usr/local/kde` por padrão. Você pode alterar esta configuração usando a opção `--prefix` do programa `configure`.

  - descompacte os pacotes com o comando `tar `jxvf nomepacote.tar.bz2``

  - mude a pasta para a pasta do pacote: `cd nomepacote`

  - configure o pacote: `./configure`

    Alguns pacotes (notavelmente o kdebase) têm opções especiais de configuração que podem ser apropriadas para a sua instalação. Digite `./configure `--help`` para ver as opções disponíveis.

  - construa o pacote: `make`

  - instale o pacote: `su `-c "make install"`` (se não for o root). Se já estiver como root, basta digitar `make `install``.

Procedimentos pós-instalação

Primeiramente, por favor certifique-se de que já adicionou a pasta de instalação dos binários do &kde; (⪚ `/usr/local/kde/bin`) ao seu `PATH` e a pasta de instalação das bibliotecas do &kde; ao seu `LD_LIBRARY_PATH` (só é necessário nos sistemas que não suportam o rpath; no &ELF; do &Linux;, deve funcionar sem isto). Esta variável de ambiente pode ser chamada de forma diferente em alguns sistemas, ⪚ é chamada de `SHLIB_PATH` no &IRIX;. Depois defina a variável de ambiente `KDEDIR` apontando para a base da sua árvore do &kde; ⪚ `/usr/local/kde`.

Tenha em conta que é pouco inteligente definir a variável `LD_LIBRARY_PATH` sem ter cuidado. Na maioria dos casos é desnecessário e pode causar problemas em vez de ajudar. Existe uma página Web escrita por Dave Barr explicando os problemas da variável `LD_LIBRARY_PATH` e pode ser encontrada em http://www.cis.ohio-state.edu/~barr/ldpath.html.

Ainda que possa usar a maioria dos aplicativos do &kde; bastando para isso chamá-los, você só pode beneficiar-se completamente das funcionalidades avançadas do &kde; se usar o gerenciador de janelas do &kde; e os seus programas auxiliares.

Para facilitar as coisas para você, existe um programa simples chamado `startkde` que é instalado no diretório `$`KDEDIR`/bin` e que, por isso, está no seu PATH.

Edite o arquivo `.xinitrc` no seu diretório pessoal (faça uma cópia de segurança primeiro!), remova tudo que pareça chamada ao gerenciador de janelas e introduza `startkde` no lugar. Reinicie o &X-Server;. Se você usar o &kdm;/xdm, terá de editar o arquivo `.xsession` em vez do `.xinitrc` . Se não existir nenhum dos arquivos `.xinitrc` ou `.xsession` no seu diretório pessoal, basta criar um deles, contendo apenas uma linha com o comando `startkde`.

Alguns sistemas (notavelmente o &RedHat; &Linux;) utilizam o `.Xclients` como alternativa.

Isto deve-lhe apresentar um novo ambiente de trabalho do &kde;. Você pode agora começar a explorar o mundo maravilhoso do &kde;. No caso de desejar ler alguma documentação primeiro, existe um Guia de Iniciação Rápida altamente recomendado e disponível. Além disso, cada aplicativo tem uma ajuda online que está disponível através do menu de Ajuda.

Devo remover a versão antiga xyz antes de instalar uma nova?

Em princípio, isso não é necessário. Os pacotes RPM e Debian devem resolver todas as dependências.

Se você mesmo compilar o código fonte, você deve tomar mais cuidados. Instruções para executar duas diferentes versões do &kde; no mesmo sistema são fornecidas em http://developer.kde.org/build/kde2-and-kde3.html. No entanto, por favor observe que executar duas versões diferentes do &kde; a partir da fonte pode causar problemas se você não for cuidadoso.

Como é que inicio o &kde;?

O método mais confortável de iniciar o &kde; é usar o script `startkde`. Basta pôr a linha `startkde` no fim do seu arquivo `.xsession` (ou um dos arquivos `.xinitrc` ou `.Xclients`, se você não estiver usando o &kdm; ou o xdm). Por favor, remova também as linhas que iniciam o seu gerenciador de janelas anterior. Se não existir um arquivo `.xsession`, `.xinitrc` ou `.Xclients` na sua pasta pessoal, basta criar um novo que contenha apenas uma linha: `startkde`.

É possível instalar o &kde; numa pasta de usuário?

Sim, você pode instalar o &kde; em qualquer pasta que desejar. O que tem a fazer depende do tipo de pacotes que quer instalar:

Pacotes de código

- Configure e instale o pacote usando `configure `--prefix=/usuarios/minhacasa/kde`; make; make install` para instalar dentro de `/usuarios/minhacasa/kde`.

- Adicione o código seguinte aos seus arquivos init. Repare que não é necessário definir o valor de `LD_LIBRARY_PATH`, por isso é melhor deixá-lo como está.

  Para o csh ou o tcsh:

      setenv KDEDIR /usuarios/minhacasa/kde

      if ( $?LD_LIBRARY_PATH ) then
         setenv LD_LIBRARY_PATH $KDEDIR/lib:$LD_LIBRARY_PATH
      else
         setenv LD_LIBRARY_PATH $KDEDIR/lib
      endif

      if ( ! $?LIBRARY_PATH ) then
         setenv LIBRARY_PATH $LD_LIBRARY_PATH
      endif

  No bash:

      KDEDIR=/usuarios/minhacasa/kde
      PATH=$KDEDIR/bin:$PATH
      LD_LIBRARY_PATH=$KDEDIR/lib:$LD_LIBRARY_PATH
      LIBRARY_PATH=$LD_LIBRARY_PATH
      export KDEDIR PATH LD_LIBRARY_PATH LIBRARY_PATH

Pacotes RPM

- O `rpm` permite usar a opção `--prefix` para selecionar a pasta em que deseja instalar. Por exemplo, executando `rpm `-i --prefix=/usuarios/minhacasa/kde pacote.rpm`` irá instalar o pacote em `/usuarios/minhacasa/kde`.

Embora o &kde; vá se executar a partir de uma pasta de usuário, existem alguns problemas com os programas que necessitem de suid root, ⪚ os programas do pacote kdeadmin. Mas uma vez que em princípio eles não serão executados por usuários, isto não é motivo de preocupação.

Contudo, nos sistemas com senhas ocultas, os protetores de tela têm de estar 'suid root' para permitir o acesso às senhas para desbloquear a tela, por isso esta opção não irá funcionar.

O `startkde` falha com 'can not connect to X server'. O que está errado?

Provavelmente você tentou iniciar o servidor X com o `startkde`. O servidor X é iniciado com o `startx`. O `startkde` é o programa que deve ser executado a partir do seu `.xinitrc`, `.xsession` ou `.Xclients` para ativar o gerenciador de janelas e os programas de servidor necessários para o &kde;. Consulte também como iniciar o KDE.

&kde; no &AIX;?

A IBM agora suporta oficialmente o &kde; no &AIX;. Você pode encontrar detalhes em http://www.ibm.com/servers/aix/products/aixos/linux/index.html. Existe também algumas informações antigas em http://space.twc.de/~stefan/kde/aix.html.

&kde; num portátil?

Se você consegue executar o &X-Window; em seu laptop, você não deverá ter nenhum problema para executar o &kde;. Além disso, poderá achar as seguintes referências úteis:

- http://www.linux-laptop.net/

- http://www.sanpei.org/Laptop-X/note-list.html

Eu tenho um novo chipset neomagic em meu laptop. Existe alguma coisa em especial que eu tenha que fazer para executar o &kde;?

Em alguns laptops que usam o chipset 2160 (MagicGraph 128XD) as seguintes opções no `XF86Config` são necessárias para permitir o funcionamento do motor gráfico:

    Option "XaaNoScanlineImageWriteRect"
    Option "XaaNoScanlineCPUToScreenColorExpandFill"

Se você observou desligamentos do seu desktop durante a utilização do &kde;, por favor tente esta opção.

Não gosto da pasta padrão do &kde; depois da instalação. Como posso movê-la sem danificar nada?

Assumindo que o diretório padrão é o `/opt/kde` e quer movê-lo para o `/usr/local/kde`, aqui está o que deve ser feito:

- mudar para super-usuário se não estiver já como tal

- `mv /opt/kde /usr/local/kde`

- `ln -s /usr/local/kde /opt/kde`

Isto irá pôr todos os arquivos do &kde; no diretório `/usr/local/kde`, embora continue tudo a estar acessível em `/opt/kde`.

Quais os arquivos que posso apagar da minha pasta de instalação do &kde;? Os arquivos `*.h`, `*.c` e `*.o` podem ser removidos em segurança?

Não deve existir a necessidade de manter os arquivos `.c` e `.o`, mas o usuário poderá querer manter os arquivos `.h`, uma vez que são incluídos se quiser compilar os seus próprios programas do &kde;. Mas se quiser aplicar correções aos programas de origem à medida que estes vão se tornando disponíveis (em vez de obter tudo de novo), então eles devem ser mantidos.

Irei perder a minha configuração atual quando atualizar o &kde;?

Não. O &kde; irá, na maioria dos casos, ser capaz de transportar a sua configuração intacta. Poderá ter de reintroduzir senhas em alguns aplicativos (como o &kmail; ou o &knode;) mas a maior parte das outras configurações serão mantidas.

Ocorreram relatórios conflitantes de resultados entre algumas versões anteriores do &kde;. Para ficar mais seguro, você realizar uma cópia de segurança de toda a sua configuração do &kde;.

A configuração é mantida na sub-pasta `$`HOME`/.kde` ou `$`HOME`/.kde2` da sua pasta de arquivos pessoais. Copie sua pasta antiga `.kde`/`.kde2` para uma localização segura, instale o &kde; 3.2, e copie de volta todas as configurações de email e notícias necessárias. Feito isto, a maioria das pessoas conseguirão fazer uma atualização direta sem remover o diretório `.kde` antigo, sem impacto de espécie alguma.

Você pode sobrepor o uso do `$`HOME`/.kde` configurando a variável $`KDEHOME`.

Eu atualizei o &kde; e tudo pareceu bem, mas quando eu inicializo, aparece uma tela cinza sem nenhum texto, e nada acontece. Existem erros no console sobre o servidor DCOP. O que está acontecendo?

O &kde; utiliza muito arquivos temporários durante sua operação. Eles são comumente encontrados nas seguintes localizações:

- `~/.DCOPserver-*` (existem comumente dois destes, um como link simbólico do outro)

- `~/.kde/socket-nomedamáquina`

- `~/.kde/tmp-nomedamáquina` que é normalmente um link simbólico para o próximo arquivo:

- `/tmp/tmp-kde-USUÁRIO`

- `~/.kde/socket-nomedamáquina` que é normalmente um link simbólico para:

- `/tmp/ksocket-USUÁRIO`

Se os links simbólicos forem quebrados, comumente por causa do `cron` ou de um script de desligamento que esteja limpando a pasta `/tmp`, então coisas estranhas podem acontecer. Estes arquivos, e seus links simbólicos, são criados automaticamente na inicialização do &kde; logo só você pode removê-los com segurança quando o &kde; não estiver sendo executado.

Se você está conseguindo apenas uma tela cinza quando inicia o &kde;, ou se você recebe uma mensagem lhe pedindo que Verifique sua instalação, então saia do X e apague todos os arquivos listados acima, e então tente reiniciar o X.

Normalmente (&ie; quando não se está atualizando entre versões do &kde;) é seguro deixar estes arquivos intactos, e você deve sair por alguns segundos do seu &kde; e reiniciá-lo.

A compilação do kdebase retorna um erro bin/sh: msgfmt: command not found!

Você necessita do pacote &GNU; msgfmt, que faz parte do pacote &GNU; i18n gettext . Você deve ser capaz de baixá-lo de qualquer espelho da &GNU;.

Como eu desinstalo os aplicativos do &kde; compilados a partir do código fonte?

Você pode desinstalar seus programas digitando `make uninstall` na pasta de onde executou o `make install`. Se já tiver excluído essa pasta, então só existe uma forma, e ela não é boa: vá para a pasta `$`KDEDIR`/bin` e comece a excluir os arquivos um a um.

Se você espera encontrar-se nesta situação, você deve procurar um programa como o &GNU; stow, encontrado em http://www.gnu.org/software/stow/stow.html.

O que houve com o suporte de &GIF;s?

Isto tem algo a ver com a patente do &LZW; da Unisys. O suporte ao &GIF; vem desligado por padrão desde o &Qt; 1.44 em diante. Quando quiser usar &GIF;s e tiver a licença correspondente, recompile o &Qt; com o suporte ao &GIF;. `./configure `-gif``.

Como é que instalo os temas do &kde;?

O suporte a temas no &kde; foi descontinuado com esta versão. No entanto, existem muitas possibilidades para personalizar e adicionar uma boa aparência ao &kde;. Veja, por exemplo, o Aparência & Temas no &kcontrol;.