# Instruções de instalação

Estas são as instruções genéricas para o Ambiente de Trabalho K. Complemente a sua leitura com os `README`s e os `INSTALL`s que vêm com o pacote. Leia-os cuidadosamente e tente ajudar-se a si próprio se algo correr mal. Se necessitar de mais assistência, pense em juntar-se às listas do correio (veja as instruções do nosso 'site' Web para se juntar às listas de correio) ou grupos de notícias do &kde;.

Para possíveis convertidos

Então ouviu os rumores. Ou viu as imagens de exemplo, e está ansioso por possuir o &kde;, mas nao sabe nada acerca desta 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 corre no &Microsoft; &Windows; 95/98/NT ou OS/2 (ainda). Para correr o &kde;, precisa de ter um sistema &UNIX;. Baseie-se na platform para mais detalhes.

Decida a plataforma e configure-a para o seu sistema. Esta FAQ não o pode ajudar com iso, dado que o &kde; corre em muitas plataformas &UNIX;.

Finalmente, está pronto para iniciar a instalação do &kde;. Comece a ler a partir da próxima secção. Para obter o &kde;, veja where-to-get-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 isto 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

Pode encontrar vários tipos de pacotes binários e de código para as diferentes distribuições e sistemas operativos em &kde-ftp;. Os pacotes binários não são feitos pela equipa do &kde;, mas pelos próprios distribuidores ou por indivíduos dedicados. Veja na 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 tar.bz2 de código. Veja os `README`s e `INSTALL`s nas várias directorias de binários. Para uma lista dos pacotes disponíveis para uma dada versão, veja a página de informação relevante. Para a última versão esta é a Página de Informação do &kde; 3.2.

Pré-requisitos

Para o &kde; 3.2, necessita da biblioteca &Qt; versão 3.2 ou superior. Confirme que obteve o &Qt; correcto. Também necessita dos ficheiros de inclusão, se quiser compilar você mesmo o &kde;. Estão todos disponíveis sem encargos em http://www.trolltech.com/download. Para além disso, existem bibliotecas opcionais que podem melhorar o &kde; se estiverem instalados no seu sistema. Um dos exemplos é o OpenSSL que permitirá ao &konqueror; navegar seguramente nas páginas Web; a versão necessária deve ser >= 0.9.6. Esta deve ser fornecida pelo próprio distribuidor; se não for, peça uma actualização.

Descrição dos pacotes de base.

A distribuição de base consiste neste momento em onze 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 partilhadas que são necessárias por todas as aplicações do &kde;.

kdebase

- Necessário

  Este pacote contém as aplicações de base que formam o núcleo do Ambiente de Trabalho K, como o gestor de janelas, o emulador de terminal, o centro de controlo, o gestor de ficheiros 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

  Mais papéis de parede, temas, estilos, sons ...

kdebindings

- Opcional

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

kdegames

- Opcional

  Vários jogos como o &kmahjongg;, o &ksnake;, o &kasteroids; e o &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 um calculadora, um editor e outras coisas úteis.

kdemultimedia

- Opcional

  Aplicações multimédia como um leitor de &CD;s e uma mesa de mistura.

kdenetwork

- Opcional

  Aplicações de rede. De momento contém o cliente de email &kmail;, o leitor de notícias &knode;, entre muitos outros programas de rede.

kdepim

- Opcional

  Aplicações de rede. De momento contém o cliente de email &kmail;, o leitor de notícias &knode;, entre muitos outros programas de rede.

kdeadmin

- Opcional

  Programas de administração do sistema.

kdeedu

- Opcional

  Aplicações educativas e de entretenimento para os utilizadores do &kde; mais novos.

kdeaccessibility

- Opcional

  Os programas do KDE de acessibilidade, como a lupa do ecrã e a interface para o sintetizador de voz.

kdetoys

- Opcional

  Brinquedos!

kdevelop

- Opcional

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

kdeedu

- Opcional

  As aplicações de desenvolvimento Web. Contém algumas aplicações como o &quanta;, um ambiente de desenvolvimento Web integrado, bem como outras aplicações úteis de programação Web.

kdesdk

- Opcional

  O KDE Software Development Kit (Kit de Desenvolvimento de 'Software' do KDE). Contém uma colecção de aplicações e ferramentas usadas pelos Programadores do KDE.

O &arts; e o 'kdelibs' devem ser instalados antes de tudo; por último deve-se instalar o 'kdeaddons'. Os restantes pacotes podem ser instalados por qualquer ordem.

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

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

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

Instalação dos pacotes da Debian

- Os pacotes da Debian instalam-se de acordo com o FHS (File Hierarchy Standard).

  1. torne-se super-utilizador

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

Instalação dos pacotes RPM

- ## Para instalar os RPMs com binários

  1. torne-se super-utilizador

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

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

- Dado que existem sempre alterações e actualizações na forma como o &kde; é compilado, veja em Transferir e Instalar o Código para as instruções de instalação dos pacotes com código-fonte mais actualizadas.

  A seguinte aproximação deve, contudo, funcionar na maioria dos casos.

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

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

  2. mude a pasta actual para a do pacote: `cd `nomepacote``

  3. configure o pacote: `./configure`

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

  4. construa o pacote: `make`

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

Procedimentos pós-instalação

Primeiro que tudo, certifique-se 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 nalguns sistemas, p. ex. é chamada de `SHLIB_PATH` no &IRIX;. Depois defina a variável `KDEDIR` a apontar para a base da sua árvore do &kde; p.ex. `/usr/local/kde`.

Tenha em conta que é pouco inteligente definir a variável `LD_LIBRARY_PATH` sem ter cuidado. Na maioria dos casos é desnecessária e pode causar problemas em vez de ajudar. Existe uma página Web escrita por Dave Barr a explicar 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 das aplicações do &kde; bastando para isso chamá-las, só pode beneficiar completamente das funcionalidades avançadas do &kde; se usar o gestor de janelas do &kde; e os seus programas auxiliares.

De modo a ser fácil para o utilizador, existe um programa simples chamado `startkde` que é instalado na directoria `$`KDEDIR`/bin` e que, por isso, está no seu PATH.

Edite o ficheiro `.xinitrc` na sua pasta pessoal (faça uma cópia de segurança primeiro!), remova tudo o que pareça chamadas ao gestor de janelas e introduza `startkde` em alternativa. Reinicie o &X-Server;. Se usar o &kdm;/xdm, terá de editar o ficheiro `.xsession` em vez do `.xinitrc`. Se não existir nenhum dos ficheiros `.xinitrc` ou `.xsession` na sua pasta pessoal, basta criar um deles, contendo apenas uma linha que diz `startkde`.

Alguns sistemas (nomeadamente o &RedHat; &Linux;) utilizam o `.Xclients` em alternativa.

Isto deve-lhe apresentar um novo ambiente de trabalho do &kde;. Pode começar a explorar o mundo maravilhoso do &kde;. No caso de querer ler alguma documentação em primeiro lugar, existe um Guia de Iniciação Rápida altamente recomendado disponível. Para além disso, cada aplicação 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 da Debian devem resolver todas as dependências.

Se você compilar por si próprio o código-fonte, deverá ter mais atenção. As instruções para executar duas versões diferentes do &kde; no mesmo sistema são dadas em http://developer.kde.org/build/kde2-and-kde3.html. Todavia, lembre-se que a execução de duas versões diferentes do &kde; a partir do código poderá conduzir a problemas se você não tiver cuidado.

Como é que inicio o &kde;?

O método mais confortável de iniciar o &kde; é usar o ficheiro `startkde`. Basta pôr a linha `startkde` no fim do seu ficheiro `.xsession` (ou um dos ficheiros `.xinitrc` ou `.Xclients`, se não estiver a usar o &kdm; ou o xdm). Remova também as linhas que iniciam o seu gestor de janelas anterior. Se não existir um ficheiro `.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 utilizador?

Sim, 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

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

2. Adicione o seguinte aos seus ficheiros do init. Repare que isto não é necessário definir o valor de `LD_LIBRARY_PATH`, por isso é melhor deixá-lo.

   Para o csh ou o tcsh:

       setenv KDEDIR /users/myhome/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

   Na bash:

       KDEDIR=/users/myhome/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

1. O `rpm` permite-lhe usar a opção `--prefix` para seleccionar a pasta em que deseja instalar. Por exemplo, a execução de `rpm `-i --prefix=`/users/myhome/kde pacote.rpm``` irá instalar o pacote em `/users/myhome/kde`.

Embora o &kde; vá correr a partir de uma directoria de utilizador, existem alguns problemas com os programas que necessitem de 'suid root', p.ex. os programas do pacote 'kdeadmin'. Mas como à partida não são para ser executados pelos utilizadores, não há motivo de preocupação.

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

O `startkde` falha com can not connect to X server. O que se passa?

Provavelmente 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 activar o gestor de janelas e os programas de servidor necessários para o &kde;. Veja também startkde.

&kde; no &AIX;?

A IBM suporta agora oficialmente o &kde; no &AIX;. Você poderá encontrar mais detalhes em http://www.ibm.com/servers/aix/products/aixos/linux/index.html. Existe também alguma informação mais antiga em http://space.twc.de/~stefan/kde/aix.html.

&kde; num portátil?

Se conseguir executar o &X-Window; no seu portátil, não deve ter nenhum problema a executar o &kde;. Para 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 'chipset' Neomagic no meu portátil. Existe algo de especial que eu deva fazer para correr o &kde;?

Em alguns dos portáteis que usam o 'chipset' 2160 (MagicGraph 128XD), são necessárias as seguintes opções no ficheiro `XF86Config` para evitar um bloqueio do motor gráfico:

    Option "XaaNoScanlineImageWriteRect"
               Option "XaaNoScanlineCPUToScreenColorExpandFill"

Se tiver alguns problemas de bloqueio do ecrã ao usar o &kde;, tente por favor esta opção.

Não gosto da pasta por omissão do &kde; depois da instalação. Como é que a mudo sem danificar nada?

Assumindo que a directoria por omissão é a `/opt/kde` e quer movê-la para a `/usr/local/kde`, aqui está o que deve ser feito:

1. mudar para super-utilizador se não estiver já como tal

2. `mv /opt/kde /usr/local/kde`

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

Isto irá pôr todos os ficheiros do &kde; na directoria `/usr/local/kde`, embora continue tudo a estar acessível em `/opt/kde`.

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

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

Irei perder a minha configuração actual quando actualizar 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 algumas aplicações (como o &kmail; ou o &knode;) mas a maior parte das outras configurações serão seguras.

Ocorreram relatórios misturados de resultados entre algumas versões anteriores do &kde;. Para ter a certeza, poderá querer salvaguardar a sua configuração inteira do &kde;.

A configuração é mantida na subpasta `.kde` ou `.kde2` da sua área local. Copie a sua pasta antiga `.kde`/`.kde2` para uma localização de segurança, instale o &kde; 3.0 e copie de volta todas as configurações de email e notícias necessárias. Dito isto, a maioria das pessoas conseguirão fazer uma actualização directa sem remover a pasta `.kde` antiga, sem impacto de espécie alguma.

Você poderá substituir a utilização do `$`HOME`/.kde` ao definir a variável $`KDEHOME`.

Actualizei o &kde; e parece estar tudo bem, mas quando o inicio, obtenho um ecrã cinzento vazio e não acontece nada. Existem erros na consola sobre o DCOPserver. O que é que se passa?

O &kde; usa vários ficheiros temporários durante a sua operação. Estes costumam estar nas seguintes localizações:

- `~/.DCOPserver-*` (costumam existir dois destes; um é uma ligação simbólica do outro)

- `~/.kde/socket-`nome_maquina``

- O `~/.kde/tmp-`hostname``, que é normalmente uma ligação simbólica do seguinte ficheiro:

- `/tmp/tmp-kde-`UTILIZADOR``

- O `~/.kde/socket-`nome_maquina``, o qual é normalmente uma ligação simbólica para:

- `/tmp/ksocket-`UTILIZADOR``

Se as ligações simbólicas deixarem de funcionar, normalmente acontece porque um 'script' do `cron` ou de finalização está a limpar a pasta `/tmp`, o que origina algumas coisas estranhas. Estes ficheiros, bem como as suas ligações simbólicas, são criados no início do &kde;, por isso poderá removê-las sem problemas quando o &kde; não estiver a correr.

Se só estiver a obter um ecrã cinzento quando inicia o &kde;, ou se obtém uma mensagem de erro a indicar-lhe para Verificar a sua instalação, então desligue o X e apague todos os ficheiros indicados em baixo, reiniciando de seguida o X.

Normalmente (&ie; quando não está a actualizar as versões do &kde;) é bastante seguro deixar estes ficheiros intactos, e pode poupar alguns segundos no arranque do &kde; se o fizer.

A compilação do kdebase dá-me um erro bin/sh: msgfmt: command not found!

Necessita do pacote da GNU msgfmt, o qual faz parte do pacote de i18n da GNU gettext. Deve poder transferi-lo a partir de qualquer 'mirror' ou réplica da GNU.

Como é que desinstalo as aplicações do &kde; compiladas a partir do código?

Pode desinstalar os seus programas escrevendo `make uninstall` na pasta onde fez `make install`. Se já tiver mandado fora essa pasta, então só existe uma forma, e esta não é boa: vá à directoria `$`KDEDIR`/bin` e comece a apagar os ficheiros um a um.

Sê você espera encontrar-se nesta situação, você poderia pensar em considerar um programa como o stow da &GNU;, que se encontra em http://www.gnu.org/software/stow/stow.html.

O que se passa com o suporte de &GIF;s?

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

Como é que instalo os temas do &kde;?

O suporte de temas no &kde; foi descontinuado com esta versão. Contudo, existem ainda muitas oportunidades de personalizar e adicionar detalhes visuais ao &kde; Veja, por exemplo, a Aparência e Temas no &kcontrol;.