<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&ark;">
  <!ENTITY package "kdeutils">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE"
> <!-- change language only here -->
]>

<book id="ark" lang="&language;">

<bookinfo>
<title
>O Manual do &ark;</title>

<authorgroup>
<author
>&Matt.Johnston; &Matt.Johnston.mail; </author>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2000</year>
<holder
>&Matt.Johnston;</holder>
</copyright>

<copyright>
<year
>2004</year>
<holder
>Henrique Pinto</holder>
</copyright>


<legalnotice
>&FDLNotice;</legalnotice>

<date
>2010-12-16</date>
<releaseinfo
>2.16 &kde; (4.6)</releaseinfo>

<abstract>
<para
>O &ark; é um gestor de pacotes para o &kde;.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>gzip</keyword>
<keyword
>gunzip</keyword>
<keyword
>tar</keyword>
<keyword
>pacote</keyword>
<keyword
>zip</keyword>
<keyword
>compressão</keyword>
<keyword
>7z</keyword>
<keyword
>kdeutils</keyword>
<keyword
>ark</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>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 <command
>tar</command
>, o <command
>gzip</command
>, o <command
>bzip2</command
>, o <command
>zip</command
>, o <command
>rar</command
> e o <command
>7z</command
> (se estiverem instalados os programas da linha de comandos apropriados).</para>

<screenshot>
<screeninfo
>Janela principal do &ark;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="ark-mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Janela principal do &ark;</phrase>
</textobject>
</mediaobject>
</screenshot>

</chapter>

<chapter id="using-ark">
<title
>Usar o &ark;</title>

<sect1 id="ark-open">
<title
>Abrir os Pacotes</title>

<para
>Para abrir um pacote no &ark;, escolha <guimenuitem
>Abrir...</guimenuitem
> (<keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
>) no menu <guimenu
>Ficheiro</guimenu
>. Você também pode abrir os ficheiros dos pacotes se os arrastar e largar a partir do &konqueror; ou &dolphin;. Os ficheiros dos pacotes deverão estar associados com o &ark;, para que você também possa carregar com o botão <mousebutton
>direito</mousebutton
> num ficheiro do &konqueror; e seleccionar o <guimenuitem
>&ark;</guimenuitem
> para o abrir.</para>

<para
>Se tiver activado o painel de informações no menu <guimenu
>Configuração</guimenu
>, será apresentada mais alguma informação adicional acerca das pastas ou ficheiros seleccionados no pacote.</para>
</sect1>

<sect1 id="ark-work-files">
<title
>Lidar com os Ficheiros</title>

<para
>Logo que um pacote tenha sido aberto, você poderá efectuar várias operações sobre os ficheiros dentro do pacote. Ao seleccionar um ficheiro e usando o menu <guimenu
>Acção</guimenu
>, você poderá escolher o que fazer:</para>

<itemizedlist>
<listitem>
<para
>A opção <guimenuitem
>Adicionar um Ficheiro...</guimenuitem
> irá adicionar um ficheiro do seu disco ao pacote.</para>
</listitem>
<listitem>
<para
>A opção <guimenuitem
>Adicionar uma Pasta...</guimenuitem
> irá adicionar pastas do seu disco ao pacote.</para>
</listitem>
<listitem>
<para
>A opção <guimenuitem
>Remover</guimenuitem
> (<keycap
>Del</keycap
>) irá apagar o ficheiro ou ficheiros seleccionados do pacote.</para>
</listitem>
<listitem>
<para
>O <guimenuitem
>Extrair...</guimenuitem
> (<keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
>) abre um submenu com as pastas acedidas anteriormente, as quais poderá seleccionar para extrair rapidamente para dentro de uma delas.</para>
</listitem>
<listitem>
<para
>A <guimenuitem
>Antevisão</guimenuitem
> irá abrir o ficheiro no visualizador associado a esse tipo de ficheiro.</para>
<!-- File Associations Embedding first item in Service Preference Order for a file type-->
</listitem>
</itemizedlist>

</sect1>
<sect1 id="ark-extract">
<title
>Extrair os Pacotes</title>

<para
>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 <guimenuitem
>Extrair...</guimenuitem
>, no menu <guimenu
>Acção</guimenu
>. Isto abre um submenu com as pastas acedidas anteriormente, onde poderá optar por extrair rapidamente para qualquer uma delas. Se assinalar a opção à direita do botão <guibutton
>Extrair</guibutton
>, irá efectuar a mesma acção. </para>
<para
>Para abrir a janela de <guilabel
>Extracção</guilabel
>, carregue no botão <guibutton
>Extrair</guibutton
> da barra de ferramentas ou use a combinação de teclas <keycombo action="simul"
>&Ctrl; <keycap
>E</keycap
></keycombo
>. Esta janela permite-lhe seleccionar para onde é que irá extrair os ficheiros. A localização por omissão é a pasta onde se encontra o pacote.</para>
<para
>Pode indicar uma sub-pasta para onde extrair os ficheiros. O nome desta sub-pasta é a primeira parte do nome do pacote, mas poderá escolher à sua vontade. Se quiser preservar as pastas na extracção, seleccione esta opção. Poderá também optar por ter a pasta para onde extraiu aberta no &konqueror; ou &dolphin;, logo que a extracção esteja completa.</para>

<para
>Se um ficheiro na lista de pacotes estiver seleccionado, poderá também escolher os ficheiros a extrair:</para>

<itemizedlist>
<listitem>
<para
>A opção <guimenuitem
>Apenas os ficheiros seleccionados</guimenuitem
> extrai todos os ficheiros que foram seleccionados.</para>
</listitem>
<listitem>
<para
>O <guimenuitem
>Todos os ficheiros</guimenuitem
> extrai o conteúdo completo do pacote.</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="ark-create">
<title
>Criar os Pacotes e Adicionar os Ficheiros</title>

<para
>Para criar um novo pacote no &ark;, escolha <guimenuitem
>Novo</guimenuitem
> no menu <guimenu
>Ficheiro</guimenu
>.</para>

<para
>Você poderá então escrever o nome do pacote com a extensão apropriada (<literal role="extension"
>tar.gz</literal
>, <literal role="extension"
>zip</literal
>, <literal role="extension"
>bz2</literal
> &etc;) ou seleccionar um formato suportado na lista <guilabel
>Filtro</guilabel
> e assinalar a opção <guilabel
>Seleccionar automaticamente a extensão do ficheiro</guilabel
>. Para adicionar ficheiros ao pacote, escolha <guimenuitem
>Adicionar um Ficheiro...</guimenuitem
> no menu <guimenu
>Acção</guimenu
>. Se quiser adicionar uma pasta inteira a um pacote, seleccione <guimenuitem
>Adicionar uma Pasta...</guimenuitem
> no menu <guimenu
>Acção</guimenu
>.</para>

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

</sect1>
</chapter>

<chapter id="ark-in_filemanager">
<title
>Usar o &ark; no Gestor de Ficheiros</title>

<para
>Se carregar com o &RMB; sobre um pacote, num gestor de ficheiros como o &dolphin; ou o &konqueror;, irá mostrar um menu de contexto com um item <guimenuitem
>Abrir com o Ark</guimenuitem
>. O menu tem estes itens adicionais para extrair um pacote com o &ark;: </para>

<itemizedlist>
<listitem>
<para
>O <guimenuitem
>Extrair Aqui, Auto-Detectar a Sub-Pasta</guimenuitem
> cria uma sub-pasta da actual com o pacote e extrai as pastas e ficheiros para dentro desta.</para>
</listitem>
<listitem>
<para
>O <guimenuitem
>Extrair o Pacote Para...</guimenuitem
> funciona como no &ark;.</para>
</listitem>
<listitem>
<para
>O <guimenuitem
>Extrair o Pacote Aqui</guimenuitem
> extrai o conteúdo do pacote para a mesma pasta.</para>
</listitem>
</itemizedlist>

<para
>O menu de contexto do &dolphin; ou do &konqueror; mostra estas acções no submenu <guimenu
>Comprimir</guimenu
>: </para>

<itemizedlist>
<listitem>
<para
>O <guimenuitem
>Aqui</guimenuitem
> cria um pacote TAR (comprimido com o 'gzip') na pasta actual com a extensão <filename class="extension"
>.tar.gz</filename
>.</para>
</listitem>
<listitem>
<para
>As opções <guimenuitem
>Como Pacote Zip</guimenuitem
>, <guimenuitem
>Como Pacote Rar</guimenuitem
> ou <guimenuitem
>Como Pacote ZIP/TAR</guimenuitem
> cria estes tipos de pacotes na pasta actual.</para>
</listitem>
<listitem>
<para
>O <guimenuitem
>Comprimir Para...</guimenuitem
> abre uma janela onde poderá seleccionar a pasta, o nome e o tipo de pacote.</para>
</listitem>
</itemizedlist>

</chapter>

<chapter id="batchmode">
<title
>Modo Avançado em Lote</title>
<para
>O &ark; tem um modo avançado em lote para gerir os pacotes sem invocar uma interface &GUI;. Este modo permite-lhe extrair ou criar os pacotes, ou ainda adicionar os ficheiros aos mesmos.</para>

<para
>O modo em lote está documentado na <ulink url="man:/ark"
>página de manual do &ark;</ulink
>. </para>
</chapter>

<chapter id="credits">

<title
>Créditos e Licença</title>

<para
>O &ark; tem o Copyright &copy; 1997-2008, Os Vários Programadores do &ark;</para>

<itemizedlist>
<title
>Autores:</title>
<listitem
><para
>Raphael Kubo da Costa <email
>rakuco@FreeBSD.org</email
></para
></listitem>
<listitem
><para
>Harald Hvaal <email
>haraldhv@stud.ntnu.no</email
></para
></listitem>
<listitem
><para
>Helio Chissini de Castro <email
>helio@conectiva.com.br</email
></para
></listitem>
<listitem
><para
>Georg Robbers <email
>Georg.Robbers@urz.uni-hd.de</email
></para
></listitem>
<listitem
><para
>Henrique Pinto <email
>henrique.pinto@kdemail.net</email
></para
></listitem>
<listitem
><para
>Roberto Selbach Teixeira <email
>maragato@kde.org</email
></para
></listitem>
<listitem
><para
>Robert Palmbos <email
>palm9744@kettering.edu</email
></para
></listitem>
<listitem
><para
>Francois-Xavier Duranceau <email
>duranceau@kde.org</email
></para
></listitem>
<listitem
><para
>Corel Corporation (autor: Emily Ezust) <email
>emilye@corel.com</email
></para
></listitem>
<listitem
><para
>Corel Corporation (autor: Michael Jarrett) <email
>michaelj@corel.com</email
></para
></listitem>
</itemizedlist>

<para
>Documentação com 'copyright' &copy; 2000 de &Matt.Johnston; &Matt.Johnston.mail;</para>

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

<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-ark">
<title
>Como obter o &ark;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Requisitos</title>

<para
>Para poder usar com sucesso o &ark;, você precisa do &kde; 4. O comando  <command
>Tar</command
> da &GNU; e um <command
>gzip</command
> 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 <command
>zip</command
>, <command
>unzip</command
>, <command
>ar</command
>, <command
>rar</command
> e <command
>7z</command
>. </para>

</sect1>

<sect1 id="compilation">
<title
>Compilação e Instalação</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->

