# 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 não sabe nada acerca desta história de sistema operativo 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 para mais detalhes.

Decida a plataforma e configure-a para o seu sistema. Esta FAQ não o pode ajudar com isso, 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 . 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!

Que tipo de 'hardware' é que necessito para correr o &kde; ?

Para executar o &kde;, recomenda-se que tenha pelo menos um processador Pentium II, 64MB de memória e 500MB de espaço livre em disco para uma instalação básica. Embora o &kde; possa correr em configurações mais lentas que isto, a performance poderá ser bastante penalizada. De um modo geral, se o seu computador já conseguir correr um &X-Server; com outros ambientes de trabalho gráficos ou gestor de janelas, será rápido o suficiente para correr o &kde;.

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.4.1.

Pré-requisitos

Para o &kde; 3.4.1, necessita da biblioteca &Qt; versão 3.3 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 e-mail &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 e-mail &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 nome_pacote.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 nome_pacote.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. descomprima os pacotes com o comando `tar `jxvf nome_pacote.tar.bz2``

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

  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; (&eg; `/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; na minha 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=/home/eu`; make; make install` para instalar dentro de `/home/eu`.

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 /home/eu
       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=/home/eu
       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=/home/eu pacote.rpm`` irá instalar o pacote em `/home/eu`.

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 .

&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

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 e-mail 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``.