# Instalação do Krusader

## Requisitos

Para conseguir usar com sucesso o &krusader; mais recente, irá necessitar das &kf5; >= 5.18

Versão do &kde; necessária:

- &krusader; v1.01: &kde; 2

- &krusader; v1.02 - 1.40: &kde; 3.0 - &kde; 3.2

- &krusader; 1.40: preferível a &kde; 3.2 (caso contrário nem todas as funcionalidades estarão disponíveis)

- &krusader; v1.50 - v1.51: &kde; 3.2 - &kde; 3.3 (estoiro do Konfigurador no &kde; 3.4)

- &krusader; v1.60.0 - v1.70.0: &kde; 3.3 - &kde; 3.5

- &krusader; 1.70.x: preferível &kde; >= 3.4 (caso contrário nem todas as funcionalidades estarão disponíveis)

- &krusader; 1.80.0: &kde; 3.4 - &kde; 3.5

- &krusader; 1.90.0: &kde; 3.2 - &kde; 3.5

- &krusader; v2.4.x: &kde; 4.x

- &krusader; v2.5.x: &kf5-full;

Plataformas:

- Todos os SO's POSIX (&Linux;/BSD/&UNIX;), &Solaris;

- Todas as Plataformas BSD (FreeBSD/NetBSD/OpenBSD/&MacOS;)

Para conseguir lidar com os pacotes, códigos de validação e outros utilitários, os mesmos deverão estar configurados na nossa ferramenta de configuração. Ao executar o &krusader; pela primeira vez, os utilitários disponíveis serão detectados automaticamente, sendo apresentado um relatório no assistente de primeira execução. Posteriormente, poderá adicionar/remover/alterar os utilitários adicionais.

Poderá encontrar um pacote com os utilitários de compressão, o próprio &krusader; e outros extra na página de transferências do &krusader;.

Para saber mais requisitos, veja em baixo. Dê uma vista de olhos também na FAQ.

## Obter o &krusader;

Poderá encontrar a última informação acerca do &krusader; na página Web do Krusader .

### Transferências do &krusader;

Recomenda-se que use o pacote do &krusader; que é fornecido pela sua distribuição. O Distrowatch.com é um óptimo recurso para verificar a disponibilidade. Se a sua distribuição não fornecer o &krusader;, contacte por favor os criadores da sua distribuição e peça a eles para fornecerem um pacote do &krusader;

A última versão, assim como as versões mais antigas, poderão ser encontradas na página de transferências do &krusader; e nas réplicas do Sourceforge. Contém os pacotes de código-fonte, os pacotes RPM e DEB das distribuições que a equipa do &krusader; estiver a usar e os pacotes do &krusader; compilados pelos utilizadores e por terceiros.

As distribuições que fornecem o &krusader;:

- &SuSE;

- O Fedora, através do `# dnf install krusader` irá resultar.

- Debian, na nossa página de transferências do &krusader;, poderá encontrar os pacotes DEB mais recentes. Nota: normalmente os pacotes Debian também poderá funcionar nas distribuições que são "baseadas na Debian", e mesmo algumas delas oferecem os seus próprios pacotes (incompatíveis). Ubuntu/Kubuntu, Knoppix 4.x DVD, Kanotix, &etc;

- Mageia através do repositório 'contrib', o `# urpmi krusader` irá resultar.

- Gentoo.

- Arch Linux, Frugalware Linux, PCLinuxOS, ALT Linux.

- FreeBSD, sendo a versão mantida pelo Heiner Eichmann.

- NetBSD, Lunar Linux ,Ark Linux, OpenLX.

- Poderá encontrar ainda mais distribuições com o Distrowatch.com.

Use as ferramentas de instalação incluídas na sua distribuição para instalar o pacote do &krusader;. Poderá necessitar de uma ligação à Internet, caso o &krusader; não venha incluído no &CD; ou no DVD. Existem provavelmente outras distribuições que incluem o &krusader;. Se conhecer algum, por favor indique-nos para que a possamos incluir na lista de distribuições.

Outros

- Os binários em 'tgz' do Slackware podem ser encontrados normalmente nos repositórios de pacotes do Slackware.

- Existe uma versão para o &MacOS;-X.

Motores de busca

- Também poderá encontrar pacotes nos arquivos de aplicações do &Linux;, como o freshmeat.net.

- Se não conseguir encontrar um pacote para a sua distribuição, recomendamos que procure por ela com o rpmfind, o rpmpbone ou o rpmseek.

Se gostar de usar o &krusader;, agradecemos que vá a um desses sítios e classifique a aplicação.

Se continuar sem encontrar nenhum pacote, siga o procedimento de compilação e i nstalado do &krusader; a partir do seu código. Este HowTo muito descritivo apresenta o processo com tanto detalhe que até mesmo os novos utilizadores não deverão ter muitos problemas.

### Esquema de Versões

Foi usado um novo esquema de versões desde o &krusader;-1.60.0

- Primeiro número - a versão principal

- Segundos algarismos - percentagem de funcionalidades completas para esta próxima versão principal

- Terceiros algarismos - correcções de erros.

Em resumo, ao lançar a versão &krusader;-1.60.0 significa que o &krusader; estará supostamente 60% completo, com todas as funcionalidades agendadas para a série 1.x.x. As séries até à 2.4.x são versões para o &kde; 4. As séries 2.5.x serão para as versões em &kf5-full;. Esperemos que seja fácil de compreender.

### Versão Estável

`krusader-x.xx.tar.gz`

O &krusader; é lançado segundo a Licença Pública Geral da &GNU; (GPL). Isto significa que O PROGRAMA É FORNECIDO "TAL-E-QUAL", SEM QUALQUER GARANTIA DE NHUM TIPO, mesmo quando está marcado como uma versão estável.

### Versão em Desenvolvimento (versão 'beta')

`krusader-x.xx-betax.tar.gz`

Antes de cada versão estável, é lançada pelo menos uma versão de desenvolvimento, de modo a descobrir os erros.

Estas são versões 'beta', que provavelmente irão conter alguns erros.

Se estiver a usar uma versão de desenvolvimento ou do Git, é possível que as últimas funcionalidades novas não estejam ainda no "Manual do Krusader". Leia por favor o ficheiro Changelog 'online' ou no código-fonte do &krusader;, de modo a descobrir mais sobre as funcionalidades novas. Para uma breve descrição, leia por favor o ficheiro SVNNEWS 'online' ou no código do &krusader;. As reacções dos utilizadores e os Relatórios de erros são sempre bem-vindos!

A versão 'beta' tem 3 objectivos:

- Aplicar um 'congelamento' das funcionalidades até que a versão estável seja lançada, sendo durante esse período apenas feita a correcção de erros. As funcionalidades novas terão de aguentar até que a versão estável seja lançada.

- Obter as reacções dos utilizadores do &krusader;, de modo que os erros encontrados possam ser corrigidos.

- Dar tempo aos tradutores para actualizar as traduções para a próxima versão estável.

### Git

O Git é usado no nosso repositório de código-fonte. Também é possível Navegar no Repositório do Git.

Para obter o último &krusader; 2.x, em desenvolvimento para o &kf5-full;, a partir do Git:

    $ git clone git://anongit.kde.org/krusader

### Versões Anteriores

Se estiver à procura das versões anteriores, recomendamos as réplicas do Sourceforge, disponíveis na nossa página do projecto.

## Instruções de instalação do Krusader

Leia por favor o ficheiro `INSTALL` do código-fonte do Krusader, dado que contém todas as últimas instruções de instalação.

A partir da versão &krusader;-2.5.0 e posteriores, só é permitido o &kf5-full;.

O `krusader_`versão`.tar.gz` é o suposto nome para o pacote do 'krusader' (se bem que poderá ser um diferente ;)

Poderá obter o último &krusader;-2.x disponível a partir do Git.

### Dependências do Krusader

São necessários os seguintes pacotes para correr o executável do Krusader.

- bibliotecas de C

- bibliotecas 'plasma-framework' (bibliotecas e binários das Plataformas do &kde; para as aplicações do &kf5-full;)

- libqt5dbus5 (módulo de D-Bus do &Qt; 5)

- libqt5xml5 (módulo de &XML; do &Qt; 5)

- libqt5core5 (módulo de base do &Qt; 5)

- libqt5gui5 (módulo de &GUI; do &Qt; 5)

- libqt5printsupport5 (módulo de suporte para impressão do &Qt; 5)

### Pacotes sugeridos

Estes pacotes são opcionais, mas tornarão o &krusader; muito mais poderoso e útil.

Os seguintes pacotes têm o nome que a Debian/Ubuntu usa; noutras distribuições de Linux, provavelmente serão usados nomes semelhantes.

- arj: criador de pacotes .arj

- ark: ferramenta gráfica de arquivo para o KDE

- bzip2: compressão de ficheiros por ordenação de blocos de alta-qualidade - utilitários

- cpio: cpio da GNU -- um programa para gerir pacotes de ficheiros

- kdiff3: compara e reúne 2 ou 3 ficheiros/pastas

- OU o kompare: uma interface gráfica em KDE para ver as diferenças entre ficheiros

- OU o xxdiff: uma ferramenta de comparação e junção gráfica de ficheiros e pastas

- kmail: Cliente de e-mail do KDE

- okteta: editor hexadecimal do KDE

- konsole: Emulador de terminal X do KDE

- krename: Utilitário de mudança de nomes de ficheiros em lote do KDE

- lha: criador de pacotes 'lzh'

- md5deep: criação e verificação de códigos de validação de ficheiros versátil

- cfv: criação e verificação de códigos de validação de ficheiros versátil

- p7zip: criador de ficheiros '7zr' com uma taxa de compressão elevada

- rpm: gestor de pacotes da Red Hat

- unace: extracção, teste e visualização de pacotes '.ace'

- unrar: Extracção de ficheiros de pacotes .rar (versão não-livre)

- OU o unrar-free: Extracção de ficheiros de pacotes .rar

- OU o rar: Criação/extracção de pacotes .rar

- unzip: Extracção de ficheiros em pacotes .zip

- zip: Criação de pacotes .zip

### Requisitos de compilação

São necessários os seguintes pacotes para compilar o Krusader; se só executar um binário do Krusader, estes pacotes não serão necessários.

- gcc (O compilador de C da GNU)

- g++ (O compilador de C++ da GNU)

- cmake (Um sistema de compilações multi-plataforma e de código aberto)

- zlib1g-dev: (biblioteca para implementar o método de compressão 'deflate', existente no gzip e no PKZIP)

- gettext (contém o 'msgfmt')

- plasma-framework-dev (instala muitas bibliotecas de desenvolvimento para o &kf5;)

- kio-dev

- libkf5archive-dev

- libkf5parts-dev

- libkf5wallet-dev

- libkf5xmlgui-dev

- kdoctools-dev

## Instalar nas plataformas &Linux; e &BSD;

Leia por favor o ficheiro `INSTALL` do código-fonte do Krusader, dado que contém todas as últimas instruções de instalação.

`-DQT_INCLUDES=/usr/share/qt5/include` é a localização dos ficheiros de inclusão do &Qt; 5

O `-DCMAKE_INSTALL_PREFIX=/usr/` é a localização onde o Krusader será instalado com o comando 'make'.

Outro exemplo é o `-DCMAKE_INSTALL_PREFIX=/opt/krusader`, para instalar o Krusader compilado noutra pasta, para não sobrepor a versão do Krusader que é instalada pelo seu gestor de pacotes.

Use por favor o `sudo` em vez do `su -c` se estiver a usar sistemas baseados no Ubuntu.

    $ tar -xzvf krusader-2.5.0.tar.gz
          $ cd krusader
          $ mkdir build
          $ cd build
          $ cmake -DCMAKE_INSTALL_PREFIX=/usr/ -DQT_INCLUDES=/usr/share/qt5/include ..
          $ make
          $ su -c "make install"

Desinstalar

    $ su -c "make uninstall"

## Instalar na plataforma &MacOS;-X

Leia por favor o ficheiro `INSTALL` do código-fonte do Krusader, dado que contém todas as últimas instruções de instalação.

Com o &kde;-4, o Krusader corre nativamente no &MacOS;-X, usando a sua interface de utilizador Aqua (Sem necessitar mais do X11!).

Com a ajuda do macports.org, o &krusader; foi migrado também para o &MacOS;-X, sendo esta versão mantida por Jonas Bähr. Existe um portfile disponível.

    $ sudo port install krusader

## Iniciar o &krusader;

Escreva ``krusader`` (em minúsculas) numa linha de comandos. Poderá criar um atalho no seu ambiente de trabalho ou criar um item no menu. Veja a página anterior e a FAQ se o &krusader; não funcionar.

Quando o &krusader; é iniciado a partir da linha de comandos, poderá indicar várias opções para modificar o seu comportamento.

    $ krusader

Não se preocupe com as mensagens que irá obter na &konsole;. Estas mensagens servem como registo para ajudar na depuração do &krusader;.

Poderá também usar o &Alt; F2 para abrir a janela para Executar um Comando, escrevendo nela ``krusader`` (em minúsculas) e carregando em &Enter; ou no botão Executar.

Se o &krusader; for instalado por um pacote RPM ou DEB, então normalmente o &krusader; poderá ser iniciado a partir do &kmenu;. Carregue no botão do lançador de aplicações e escolha a opção Aplicações Utilitários &krusader; .

## Opções da linha de comandos:

`--left` `<localização>`

- inicia o painel da esquerda na <localização>

`--right` `<localização>`

- inicia o painel da direita na <localização>

`--left` `<local-1>,<local-2>,<local-3>`

- inicia o painel da esquerda em <local-1>,<local-2>,<local-3>, com páginas.

`--profile` `<perfil-painel>`

- carrega um perfil do painel no arranque (isto substitui o perfil de arranque predefinido).

Exemplos:

    $ krusader --left=<path> --right=<localização>

    $ krusader --left=/mnt/cdrom --right=ftp://transferencias@servidor.net

    $ krusader --left=<local-1>,<local-2> --right=<local-1>,<local-2>,<local-3>

    $ krusader--profile <perfil-painel>

    $ krusader --profile gestão-ftp

Estão disponíveis as opções da linha de comandos normais do &Qt; e do &kf5-full;.

## Outras opções da linha de comandos:

`--author`

- Mostra os nomes dos autores

`--license`

- Mostra informações sobre a licença

## Configurar o &krusader;

Quando executar o &krusader; pela primeira vez, o módulo de configuração do &krusader; - Konfigurador -, irá aparecer e permitir-lhe-á configurar o &krusader;, assim como detectar os utilitários e ferramentas instalados. Poderá sempre executar o Konfigurador de novo a partir do menu de Configuração.

## Tornar o &krusader; o gestor de ficheiros por omissão

Para tornar o &krusader; o gestor de ficheiros por omissão no Gnome, carregue aqui para obter mais informações.

Para tornar o &krusader; o gestor de ficheiros por omissão no &plasma;, carregue aqui para obter mais informações.