# O Manual do &ark;

## Introdução

O &ark; é um programa para gerir vários formatos de pacotes dentro do ambiente do &kde;. Os pacotes poderão ser vistos, extraídos, criados e modificados dentro do ambiente do &kde;. O programa consegue lidar com vários formatos como o `tar`, o `gzip`, o `bzip2`, o `zip` e o `lha` (se estiverem instalados os programas da linha de comandos apropriados). O &ark; trabalha intimamente com o &konqueror; no ambiente do &kde; para lidar com os pacotes, se você instalar o 'plugin' de Integração com o &konqueror; que vem no pacote 'kdeaddons'.

## Usar o &ark;

### Abrir os Pacotes

Para abrir um pacote no &ark;, escolha Abrir no menu Ficheiro. Você também pode abrir os ficheiros dos pacotes se os arrastar e largar a partir do &konqueror;. Os ficheiros dos pacotes deverão estar associados com o &ark;, para que você também possa carregar com o botão direito num ficheiro do &konqueror; e seleccionar o &ark; para o abrir.

### Lidar com os Ficheiros

Logo que um pacote tenha sido aberto, você poderá efectuar várias operações sobre os ficheiros dentro do pacote. Ao carregar com o botão direito num ficheiro dentro do pacote, ou ao seleccionar um ficheiro e usando o menu Acção, você poderá escolher o que fazer:

- O Ver irá abrir o ficheiro no visualizador integrado ou no programa de visualização predefinido, no caso de o visualizador integrado não conseguir ver o ficheiro, ou se você o tiver desactivado na janela de Configuração.

- A Abrir Com... permite-lhe abrir o ficheiro com um programa à sua escolha.

- O Editar Com... irá abrir o ficheiro com um programa à sua escolha. A diferença entre isto e o Abrir Com... é que as alterações que você fizer irão ser gravadas no ficheiro dentro do pacote.

- A opção Remover irá apagar o ficheiro ou ficheiros seleccionados do pacote.

### Extrair os Pacotes

Logo que um pacote tenha sido aberto no &ark;, este poderá ser extraído. Para extrair os ficheiros de um pacote, você tanto pode optar por Extrair... no menu Acção ou por carregar com o botão direito em qualquer ficheiro. A janela de Extracção permite-lhe seleccionar para onde você quer extrair os ficheiros. Você também poderá seleccionar quais os ficheiros a extrair:

- A opção Actual extrai o ficheiro seleccionado mais recentemente. Se estiverem vários ficheiros seleccionados, só o seleccionado mais recentemente será extraído.

- O Todos extrai o conteúdo completo do pacote.

- A opção Ficheiros Seleccionados extrai todos os ficheiros que foram seleccionados.

- O Padrão permite-lhe indicar quais os ficheiros que deverão ser extraídos, de acordo com certos padrões, ⪚ `*.txt` ou `*.jpg`. Tenha em atenção que só pode usar um padrão de cada vez.

Você poderá indicar a pasta para onde extrair os ficheiros no campo de texto Extrair para:. Se quiser alterar a pasta por omissão, na janela principal do programa, seleccione as Pastas no menu Configuração. Na página Avançado, você poderá escolher algumas opções específicas, dependendo do formato do pacote.

### Criar os Pacotes e Adicionar os Ficheiros

Para criar um novo pacote no &ark;, escolha Novo no menu Ficheiro.

Você poderá então escrever o nome do pacote com a extensão apropriada (`tar.gz`, `zip`, `bz2` &etc;). Para adicionar ficheiros ao pacote, escolha Adicionar um Ficheiro... no menu Acção. Se quiser adicionar uma pasta inteira a um pacote, seleccione Adicionar uma Pasta... no menu Acção.

Uma forma alternativa de adicionar ficheiros ao pacote é arrastar um ficheiro do &konqueror; ou do ecrã para a janela principal do &ark;, para que seja adicionado ao pacote actual.

## Configurar o &ark;

### Configuração Geral

Utilizar o visualizador integrado

- Usa o visualizador integrado para ver o conteúdo dos ficheiros, se possível.

Activar a integração com Konqueror

- Activa o 'plugin' para extrair ou adicionar os ficheiros aos pacotes através dos menus de contexto do Konqueror.

  Esta opção só funciona se o 'plugin' de integração com o Konqueror do pacote 'kdeaddons' estiver instalado no seu sistema.

### Configuração da Adição de Ficheiros

Muitas destas opções só são configuráveis para formatos de pacotes específicos. Os outros formatos podem-se comportar de ambas as formas e não são configuráveis.

Substituir os ficheiros antigos apenas por outros mais recentes

- Se você quiser adicionar nomes de ficheiros que já existam num pacote, só os substitui se os ficheiros adicionados forem mais recentes que os que já existem no pacote.

Manter as entradas genéricas (Lha)

- Só afecta os pacotes LHA

Forçar nomes de ficheiro curtos de MS-DOS (Zip)

- Obriga a que os nomes dos ficheiros tenha o formato 8.3 do DOS.

  Só afecta os ficheiros ZIP

Traduzir os LF's em CRLF's do DOS (Zip)

- Converte os fins de linha nos ficheiros de texto para o formato do DOS a partir do formato do Unix.

  Só afecta os ficheiros ZIP

Manter as ligações simbólicas como tal (Zip, Rar)

- Grava as ligações dentro do pacote, em vez de as seguir e de incluir os ficheiros apontados por essas ligações.

  Afecta os pacotes ZIP e RAR.

Adicionar recursivamente as subpastas (Zip, Rar)

- Se você adicionar uma pasta a um pacote, adiciona também todas as subpastas dentro dela. Afecta os pacotes ZIP e RAR

### Configuração da Extracção

Muitas destas opções só são configuráveis para formatos de pacotes específicos. Os outros formatos podem-se comportar de ambas as formas e não são configuráveis.

Sobrepor os ficheiros (Zip, Tar, Zoo, Rar)

- Sobrepõe os ficheiros que tenham nomes correspondentes no disco com os que existem no pacote.

Preservar as permissões (Tar)

- Grava as configurações de utilizadores, grupos e permissões nos ficheiros. Utilize com cuidado, dado que isto poderá resultar em que os ficheiros extraídos não pertençam a nenhum utilizador válido no seu computador.

Ignorar os nomes das pastas (Zip)

- Extrai todos os ficheiros para a pasta de extracção, ignorando qualquer estrutura de pastas no pacote.

Converter nomes dos ficheiros para minúsculas (Zip, Rar)

Converter nomes dos ficheiros para maiúsculas (Rar)

- Extrai todos os ficheiros com os nomes todos em minúsculas (ou em maiúsculas).

### Pastas

Pastas

- Isto mostra a janela das Pastas, onde você poderá escolher as pastas por omissão. A Pasta comum é a última pasta que você usou para essa opção em particular.

## Referência de Comandos

### O Menu Ficheiro

&Ctrl;N Ficheiro Novo

- Cria um novo arquivo

&Ctrl;O Ficheiro Abrir

- Abre um arquivo

Ficheiro Abrir um Recente

- Mostra uma lista com os pacotes abertos recentemente para os poder escolher

Ficheiro Nova Janela

- Abre uma nova janela do &ark;

Ficheiro Recarregar

- Carrega o pacote actual de novo a partir do disco. Isto irá actualizar a janela do &ark; se existir outro programa que tenha alterado o pacote.

Ficheiro Gravar Como

- Permite-lhe gravar o pacote actual com um nome novo

Ficheiro Fechar

- Fecha o pacote actual

&Ctrl; Q Ficheiro Sair

- Fecha o &ark;

### O Menu Editar

Editar Seleccionar...

- Permite-lhe seleccionar os ficheiros de acordo com o seu nome. Por exemplo, você poderia definir o `*.txt` para seleccionar todos os ficheiros de texto. Repare que você não poderá usar mais do que um filtro de cada vez.

&Ctrl; A Editar Seleccionar Tudo

- Selecciona todos os ficheiros no pacote

Editar Deseleccionar Tudo

- Deselecciona todos os ficheiros do pacote

Editar Inverter a Selecção

- Troca os ficheiros seleccionados. Os ficheiros seleccionados deixam de o estar e os ficheiros não seleccionados passam a estar.

Editar Ver o Resultado da Linha de Comandos

- Mostra a janela do Resultado da Linha de Comandos, o qual lhe mostra o resultado do comando ou comandos executados mais recentemente pelo &ark;. Isto poderá ser útil algumas das vezes se você estiver a ter problemas e os queira tentar resolver.

### O Menu Acção

Acção Adicionar um Ficheiro...

- Mostra a janela de Seleccionar os Ficheiros a Adicionar, onde você poderá então escolher os ficheiros. Mantenha carregado o &Ctrl; e carregue para seleccionar os vários ficheiros. Para subir uma pasta, carregue com o botão direito na lista de pastas para poder escolher Subir (isto será provavelmente melhorado em breve). A página Avançado tem algumas opções que são específicas para o tipo ou pacote com o qual está a lidar.

Acção Adicionar uma Pasta...

- Mostra a janela de Adicionar uma Pasta..., onde você poderá escolher uma pasta para adicionar. Basta escolher uma pasta e seleccionar Abrir.

Acção Remover

- Remove os ficheiros seleccionados no momento do pacote.

Acção Extrair

- Mostra a janela de Extrair, a qual lhe permite seleccionar para onde irá extrair os ficheiros. Você também poderá seleccionar quais os ficheiros a extrair:

  - O Actual extrai o ficheiro seleccionado mais recentemente. Se estiverem vários ficheiros seleccionados, só o seleccionado mais recentemente será extraído.

  - O Todos extrai o conteúdo completo do pacote.

  - A opção Ficheiros Seleccionados extrai todos os ficheiros que foram seleccionados.

  - O Padrão permite-lhe indicar quais os ficheiros que deverão ser extraídos, de acordo com certos padrões, ⪚ `*.txt` ou `*.jpg`. Tenha em atenção que só pode usar um padrão de cada vez.

  Você poderá indicar a pasta para onde extrair os ficheiros no campo de texto Extrair para:. Se quiser alterar a pasta por omissão, na janela principal do programa, seleccione as Pastas no menu Configuração. Na página Avançado, você poderá escolher algumas opções específicas, dependendo do formato do pacote.

Acção Ver

- Abre o ficheiro seleccionado de momento no programa de visualização associado.

Acção Abrir Com...

- Abre o ficheiro seleccionado no momento com um programa à sua escolha. A janela Abrir Com... permite-lhe escolher qual o programa a usar.

Acção Editar Com...

- Abre o ficheiro seleccionado no momento com um programa à sua escolha. Todas as alterações que você fizer no programa do editor serão reflectidas no pacote, dado que será actualizado.

### O Menu Configuração

Configuração Mostrar/Esconder a Barra de Ferramentas

- Comuta (activa ou desactiva) a visibilidade da barra de ferramentas.

Configuração Mostrar/Esconder a Barra de Estado

- Comuta (activa ou desactiva) a visibilidade da barra de estado.

Configuração Mostrar/Esconder a Barra de Procura

- Comuta (activa ou desactiva) a visibilidade da barra de procura.

Configuração Configurar os Atalhos...

- Mostra a janela de Configurar os Atalhos. Esta permite-lhe escolher as teclas de atalho para os vários itens do menu. Para alterar um atalho, seleccione uma acção da lista, escolhendo então qual a sequência de teclas a usar. Se carregar no botão em baixo à direita Tecla, poderá escolher qual a tecla específica a usar. Basta carregar na nova tecla.

Configuração Configurar as Barras de Ferramentas...

- Mostra uma janela-padrão do &kde; na qual poderá configurar os ícones da barra de ferramentas.

Configuração Configurar o Ark...

- Isto abre a janela de configuração do &ark;. A janela contém quatro módulos (o Geral, o Adição, o Extracção e o Pastas). A configuração do &ark; é discutida na secção de Configuração

### O Menu Ajuda

&help.menu.documentation;

## Créditos e Licença

O &ark; tem o Copyright © 1997-2004, Os Vários Programadores do &ark;

## Autores:

- Helio Chissini de Castro helio@conectiva.com.br

- Georg Robbers Georg.Robbers@urz.uni-hd.de

- Henrique Pinto henrique.pinto@kdemail.net

- Roberto Selbach Teixeira maragato@kde.org

- Robert Palmbos palm9744@kettering.edu

- Francois-Xavier Duranceau duranceau@kde.org

- Corel Corporation (autor: Emily Ezust) emilye@corel.com

Documentação Copyright © 2000 Matt Johnston mattj@flashmail.com

Documentação actualizada para o &kde; 3.3 por Henrique Pinto henrique.pinto@kdemail.net.

&underFDL; &underGPL;

## Instalação

### Como obter o &ark;

&install.intro.documentation;

### Requisitos

Para poder usar com sucesso o &ark;, você precisa do &kde; 3.3 ou superior. O `Tar` v1.12 da GNU e um `gzip` recente são também necessários para usar o &ark;. Para lidar com os outros formatos dos ficheiros, você irá necessitar dos seguintes programas da linha de comandos, como o `zip`, `unzip`, `ar` e `lha`.

### Compilação e Instalação

&install.compile.documentation;
&documentation.index;