<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
<!ENTITY kappname "&ark;">
<!ENTITY % Portuguese "INCLUDE">
]>

<refentry lang="&language;">
<refentryinfo>
<title
>Manual do Utilizador do &kde;</title>
<author
>&Lauri.Watts;&Lauri.Watts.mail;</author>

<author
>&Raphael.Kubo.da.Costa; &Raphael.Kubo.da.Costa.mail;</author>

<date
>2009-09-10</date>
<releaseinfo
>2.13 (&kde; 4.3.1)</releaseinfo>
<productname
>Ambiente de Trabalho K</productname>
</refentryinfo>

<refmeta>
<refentrytitle
><command
>ark</command
></refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>

<refnamediv>
<refname
><command
>ark</command
></refname>
<refpurpose
>Ferramenta de arquivo do &kde;</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis
><command
>ark</command
> <group choice="opt"
><option
>-b</option
></group
> <group choice="opt"
><option
>-a</option
></group
> <group choice="opt"
><option
>-e</option
></group
> <group choice="opt"
><option
>-c</option
></group
> <group choice="opt"
><option
>-f</option
> <replaceable
> sufixo</replaceable
></group
> <group choice="opt"
><option
>-p</option
></group
> <group choice="opt"
><option
>-t</option
> <replaceable
> ficheiro</replaceable
></group
> <group choice="opt"
><option
>-d</option
></group
> <group choice="opt"
><option
>-o</option
> <replaceable
> pasta</replaceable
></group
> <arg choice="opt"
>Opções Genéricas do &kde;</arg
> <arg choice="opt"
>Opções Genéricas do &Qt;</arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>
<para
>O &kappname; é um programa para gerir vários formatos de pacotes no ambiente do &kde;. Os pacotes podem ser vistos, extraídos, criados e modificados dentro do &kappname;. O programa poderá lidar com vários formatos como o <application
>tar</application
>, o <application
>gzip</application
>, o <application
>bzip2</application
>, o <application
>zip</application
>, o <application
>rar</application
> e o <application
>lha</application
> (se estiverem instalados os programas da linha de comandos apropriados).</para>
</refsect1>

<refsect1>
<title
>Modos de operação</title>
<para
>O &ark; tanto pode ser usado como uma &GUI; independente ou como um programa da linha de comandos para efectuar algumas tarefas específicas.</para>
<para
>Se for invocado sem as opções -b (--batch) ou -c (--add), o &ark; é iniciado como um programa &GUI; normal.</para>
<para
>Quando for usada a opção -b (--batch), o &ark; pode ser usado para extrair directamente o conteúdo de um ou mais ficheiros a partir da linha de comandos, sem invocar a sua &GUI;.</para>
<para
>Quando é usada a opção -c (--add), o &ark; pede os ficheiros que deverão ser adicionados a um novo pacote ou a um pacote existente.</para>
<para
></para>
<para
></para>
</refsect1>

<refsect1>
<title
>Opções</title>

<variablelist>
<varlistentry>
<term
><option
>-d, --dialog</option
></term>
<listitem>
<para
>Mostrar uma janela para indicar as opções numa operação em lote ou de adição.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>-o, --destination <replaceable
>pasta</replaceable
></option
></term>
<listitem
><para
>Por omissão, usar a pasta de extracção <replaceable
>pasta</replaceable
>. Se não for indicada, é usada a pasta actual.</para>
</listitem>
</varlistentry>
</variablelist>

<refsect2>
<title
>Opções para adicionar ficheiros</title>
<variablelist>
<varlistentry>
<term
><option
>-c, --add</option
></term>
<listitem>
<para
>Pedir ao utilizador um nome de pacote e adicionar ficheiros a ele. Sair quando terminar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>-t, --add-to <replaceable
>ficheiro</replaceable
></option
></term>
<listitem>
<para
>Adicionar os ficheiros indicados ao <replaceable
>ficheiro</replaceable
>. Criar o pacote se não existir. Sair quando terminar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>-p, --changetofirstpath</option
></term>
<listitem>
<para
>Muda a pasta actual para o primeiro item e adiciona todos os outros itens em relação a esta.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-f, --autofilename <replaceable
>sufixo</replaceable
></option
></term>
<listitem>
<para
>Escolhe adicionalmente um nome de ficheiro, usando o <replaceable
>sufixo</replaceable
> seleccionado (por exemplo rar, tar.gz, zip ou outro tipo suportado qualquer).</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Opções para a extracção em lote</title>
<variablelist>
<varlistentry>
<term
><option
>b, --batch</option
></term>
<listitem>
<para
>Usar a interface em lote, em vez da janela normal. Esta opção está implícita se indicar mais de um URL.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e, --autodestination</option
></term>
<listitem>
<para
>O argumento de destino será configurado com o local do primeiro ficheiro indicado.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-a, --autosubfolder</option
></term>
<listitem>
<para
>O conteúdo do pacote será lido e, se se detectar que não é um pacote com apenas uma pasta, será criada uma sub-pasta com o nome do pacote.</para>
</listitem>
</varlistentry>

</variablelist>
</refsect2>
</refsect1>

<refsect1>
<title
>Exemplos</title>

<variablelist>
<varlistentry>
<term
><userinput
><command
>ark</command
> <option
>--batch</option
> <replaceable
>pacote.tar.bz2</replaceable
></userinput
></term>
<listitem>
<para
>Irá extrair o <replaceable
>pacote.tar.bz2</replaceable
> para a pasta actual sem mostrar qualquer &GUI;. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>ark</command
> <option
>-b</option
> <option
>-d</option
> <replaceable
>pacote.tar.bz2</replaceable
> <replaceable
>pacote2.zip</replaceable
></userinput
></term>
<listitem>
<para
>Irá mostrar em primeiro lugar uma janela de opções de extracção e irá então extrair tanto o <replaceable
>pacote.tar.bz2</replaceable
> como o <replaceable
>pacote2.zip</replaceable
> para a pasta escolhida na janela.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>ark</command
> <option
>--add-to</option
> <replaceable
>o-meu-pacote.zip</replaceable
> <replaceable
>fotografia1.jpg</replaceable
> <replaceable
>texto.txt</replaceable
></userinput
></term>
<listitem>
<para
>Irá criar o ficheiro <replaceable
>o-meu-pacote.zip</replaceable
>, se não existir, e irá adicionar depois o <replaceable
>fotografia1.jpg</replaceable
> e <replaceable
>texto.txt</replaceable
> a ele. </para>
</listitem>
</varlistentry>

</variablelist>
</refsect1>

<refsect1>
<title
>Autores</title>
<para
>O &ark; mantido de momento por &Harald.Hvaal; &Harald.Hvaal.mail; e &Raphael.Kubo.da.Costa; &Raphael.Kubo.da.Costa.mail;.</para>
<para
>Esta página do manual foi escrita primeiro por &Lauri.Watts; &Lauri.Watts.mail; em 2005 para o &kde; 3.4, sendo depois actualizada em 2009 por &Raphael.Kubo.da.Costa; &Raphael.Kubo.da.Costa.mail;.</para>
</refsect1>

</refentry>
