<?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 % Brazilian-Portuguese "INCLUDE"
> <!-- change language only here -->
]>

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

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

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

<othercredit role="translator"
><firstname
>Henrique</firstname
><surname
>Pinto</surname
><affiliation
><address
><email
>henrique.pinto@kdemail.net</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> <othercredit role="translator"
><firstname
>André Marcelo</firstname
><surname
>Alvarenga</surname
><affiliation
><address
><email
>alvarenga@kde.org</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
>21/06/2013</date>
<releaseinfo
>2.19 &kde; (4.11)</releaseinfo>

<abstract>
<para
>&ark; é um gerenciador de arquivos compactados para o &kde;.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>gzip</keyword>
<keyword
>gunzip</keyword>
<keyword
>tar</keyword>
<keyword
>arquivo</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
>&ark; é um programa para exibição, extração, criação e modificação de arquivos compactados. O programa pode trabalhar com vários formatos, tais como: <command
>tar</command
>, <command
>gzip</command
>, <command
>bzip2</command
>, <command
>zip</command
>, <command
>rar</command
>, <command
>7zip</command
>, <command
>xz</command
>, <command
>rpm</command
>, <command
>cab</command
> e <command
>deb</command
> (o suporte a certos formatos de arquivos compactados dependem da instalação de programas de linha de comando 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
>Usando o &ark;</title>

<sect1 id="ark-open">
<title
>Abrindo arquivos</title>

<para
>Para abrir um arquivo no &ark;, escolha o item <guimenuitem
>Abrir...</guimenuitem
> (<keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
>) do menu <guimenu
>Arquivo</guimenu
>. Você também pode abrir arquivos arrastando-os de uma janela do &konqueror; ou do &dolphin; e soltando-os no &ark;. Os arquivos devem estar associados ao &ark; para que seja possível clicar sobre um arquivo com o botão <mousebutton
>direito</mousebutton
> do mouse e abri-lo no &konqueror; ou &dolphin;, usando a opção <guimenuitem
>Abrir com &ark;</guimenuitem
>. Com isso, também será possível selecionar uma ação de extração para este arquivo.Os arquivos devem estar associados ao &ark;, para que você também possa abri-los clicando com o botão <mousebutton
>direito</mousebutton
> do mouse em um arquivo no &konqueror; ou no &dolphin; e selecionar a opção <guimenuitem
>Abrir com &ark;</guimenuitem
> para abri-lo ou então selecionar uma ação de extração para este arquivo.</para>

<para
>Se você ativou o painel de informações no menu <guimenu
>Configurações</guimenu
>, serão apresentadas informações adicionais sobre as pastas ou arquivos selecionados no arquivo compactado.</para>
</sect1>

<sect1 id="ark-work-files">
<title
>Trabalhando com arquivos</title>

<para
>Assim que o arquivo compactado estiver aberto, você pode realizar várias operações nos arquivos nele contidos. Selecionando um arquivo e usando o menu <guimenu
>Ação</guimenu
>, você pode escolher o que deseja fazer:</para>

<itemizedlist>
<listitem>
<para
><guimenuitem
>Adicionar arquivo...</guimenuitem
> irá adicionar arquivos do seu disco para o arquivo compactado.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Adicionar pasta...</guimenuitem
> irá adicionar pastas do seu disco para o arquivo compactado.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Excluir</guimenuitem
> (<keycap
>Del</keycap
>) irá excluir o(s) arquivo(s) selecionado(s) do arquivo compactado.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Extrair...</guimenuitem
> (<keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
>) abre um submenu com as pastas acessadas anteriormente, de onde você poderá optar por extrair rapidamente para uma delas.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Visualizar</guimenuitem
> irá abrir o arquivo no visualizador associado a esse tipo de arquivo.</para>
<!-- File Associations Embedding first item in Service Preference Order for a file type-->
</listitem>
</itemizedlist>

</sect1>
<sect1 id="ark-extract">
<title
>Extração de arquivos compactados e adição de arquivos</title>

<para
>Uma vez aberto no &ark;, o conteúdo do arquivo compactado poderá ser extraído. Para extrair rapidamente os arquivos, você pode selecionar <guisubmenu
>Extrair</guisubmenu
>, no menu <guimenu
>Ação</guimenu
>. Isto abre um submenu com as pastas acessadas anteriormente, de onde você poderá optar por extrair rapidamente para qualquer uma delas. Assinalar a opção à direita do botão <guibutton
>Extrair</guibutton
>, irá efetuar a mesma ação. </para>
<para
>Para abrir a janela de <guilabel
>Extração</guilabel
>, clique no botão <guibutton
>Extrair</guibutton
> da barra de ferramentas ou use o atalho <keycombo action="simul"
>&Ctrl; <keycap
>E</keycap
></keycombo
>. Esta janela permite-lhe selecionar o local para onde os arquivos serão extraídos. A localização padrão é a pasta onde se encontra o arquivo compactado.</para>
<para
>Você pode indicar uma subpasta para onde extrair os arquivos. O nome padrão desta subpasta é a primeira parte do nome do arquivo, mas você poderá editá-lo como desejar. Se você quiser preservar as pastas na extração, selecione esta opção. Você também pode optar por ter a pasta para onde extraiu aberta no &konqueror; ou &dolphin;, ou então fechar &ark; assim que a extração for concluída.</para>

<para
>Se um arquivo da lista estiver selecionado, você também poderá escolher quais arquivos extrair:</para>

<itemizedlist>
<listitem>
<para
><guimenuitem
>Somente os arquivos selecionados</guimenuitem
> extrai apenas os arquivos que foram selecionados.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Todos os arquivos</guimenuitem
> extrai todo o conteúdo do arquivo compactado.</para>
</listitem>
</itemizedlist>
<para
>Para extrair um único arquivo de um arquivo compactado, clique no nome do arquivo e arraste-o para a pasta de destino </para>
<!--FIXME extract several files by drag + drop? - only in basyskom branch-->
<para
>A extração de arquivos de um arquivo compactado não altera o seu conteúdo. Use a opção <menuchoice
><guimenu
>Ação</guimenu
><guimenuitem
>Excluir</guimenuitem
></menuchoice
> (<keysym
>Del</keysym
>) para essa tarefa. </para>

</sect1>

<sect1 id="ark-create">
<title
>Criando arquivos compactados e adicionando arquivos</title>

<para
>Para criar um arquivo compactado no &ark;, escolha a opção <guimenuitem
>Novo</guimenuitem
> no menu <guimenu
>Arquivo</guimenu
>.</para>

<para
>Você poderá então digitar o nome do arquivo compactado com a extensão apropriada (<literal role="extension"
>tar.gz</literal
>, <literal role="extension"
>zip</literal
>, <literal role="extension"
>bz2</literal
>, &etc;) ou selecionar um formato suportado no campo <guilabel
>Filtro</guilabel
> e assinalar a opção <guilabel
>Selecionar automaticamente a extensão do nome do arquivo</guilabel
>. Para adicionar arquivos ao arquivo compactado, selecione <guimenuitem
>Adicionar arquivo...</guimenuitem
> no menu <guimenu
>Ação</guimenu
>. Se quiser adicionar uma pasta inteira a um arquivo compactado, selecione <guimenuitem
>Adicionar pasta...</guimenuitem
> no menu <guimenu
>Ação</guimenu
>.</para>

<para
>Uma maneira alternativa de adicionar arquivos ao arquivo compactado é arrastar um ou mais arquivos do &konqueror;, &dolphin; ou da área de trabalho e soltá-lo em uma janela do &ark;, onde será automaticamente adicionado ao arquivo atual.</para>

</sect1>
</chapter>

<chapter id="ark-in_filemanager">
<title
>Usando o &ark; no Gerenciador de Arquivos</title>

<para
>Clicar com o &RMB; sobre um arquivo compactado, em um gerenciador de arquivos como o &dolphin; ou o &konqueror;, irá mostrar um menu de contexto com um item <guimenuitem
>Abrir com Ark</guimenuitem
>. O menu possui estes itens adicionais para extrair um arquivo com o &ark;: </para>

<itemizedlist>
<listitem>
<para
><guimenuitem
>Extrair aqui detectando subpasta</guimenuitem
> cria uma subpasta da atual com o pacote e extrai as pastas e arquivos para dentro desta.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Extrair arquivo para...</guimenuitem
> funciona como no &ark;.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Extrair arquivo aqui</guimenuitem
> extrai o conteúdo do arquivo para a mesma pasta.</para>
</listitem>
</itemizedlist>

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

<itemizedlist>
<listitem>
<para
>A opção <guimenuitem
>Aqui</guimenuitem
> cria um arquivo TAR (compactado com o gzip) na pasta atual com a extensão <filename class="extension"
>.tar.gz</filename
>.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Como arquivo ZIP</guimenuitem
>, <guimenuitem
>Como arquivo RAR</guimenuitem
> ou <guimenuitem
>Como arquivo ZIP/TAR</guimenuitem
> cria esses tipos de arquivos na pasta atual.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Compactar para...</guimenuitem
> abre uma caixa de diálogo onde poderá ser selecionada a pasta, o nome e o tipo de arquivo.</para>
</listitem>
</itemizedlist>

</chapter>

<chapter id="batchmode">
<title
>Modo avançado em lote</title>
<para
>O &ark; possui um modo avançado para gerenciar os arquivos em lote sem carregar uma interface de usuário. Este modo permite-lhe extrair ou criar arquivos, ou ainda adicionar os arquivos aos mesmos.</para>

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

<chapter id="credits">

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

<para
>O &ark; tem direitos autorais &copy; 1997-2008, dos vários desenvolvedores 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
>Direitos autorais da documentação &copy; 2000 de &Matt.Johnston; &Matt.Johnston.mail;</para>

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

<para
>Tradução de Henrique Pinto <email
>henrique.pinto@kdemail.net</email
> e André Marcelo Alvarenga <email
>alvarenga@kde.org</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 o &ark; com sucesso, você precisa do &kde; 4. O &GNU; <command
>tar</command
> e uma versão recente do <command
>gzip</command
> também são necessários se você deseja que o &ark; trabalhe com arquivos TAR. Para que o &ark; seja capaz de trabalhar outros tipos de arquivo, você precisa dos programas em linha de comando apropriados, como: <command
>bzip2</command
>, <command
>zip</command
>, <command
>unzip</command
>, <command
>rar</command
>, <command
>7zip</command
>, <command
>xz</command
>, <command
>rpm</command
>, <command
>cab</command
> e <command
>deb</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:
-->

