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

<refentry lang="&language;">
<refentryinfo>
<title
>Manual de usuario de &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
>Entorno de escritorio K</productname
> </refentryinfo>

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

<refnamediv>
<refname
><command
>ark</command
></refname>
<refpurpose
>Herramienta de compresión de &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
> sufijo</replaceable
></group
> <group choice="opt"
><option
>-p</option
></group
> <group choice="opt"
><option
>-t</option
> <replaceable
> archivo</replaceable
></group
> <group choice="opt"
><option
>-d</option
></group
> <group choice="opt"
><option
>-o</option
> <replaceable
> directorio</replaceable
></group
> <arg choice="opt"
>Opciones genéricas de &kde;</arg
> <arg choice="opt"
>Opciones genéricas de &Qt;</arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title
>Descripción</title>
<para
>&ark; es un programa de &kde; para manejar varios formatos de archivos comprimidos. Los archivos comprimidos se pueden visualizar, extraer, crear y modificar con &ark;. El programa puede manejar diversos formatos, como <application
>tar</application
>, <application
>gzip</application
>, <application
>bzip2</application
>, <application
>zip</application
>, y <application
>rar</application
> (siempre que estén instalados los programas o bibliotecas correspondientes).</para>
</refsect1>

<refsect1>
<title
>Modos de operación</title>
<para
>&ark; se puede usar como un programa gráfico independiente o como un programa de la línea de órdenes para realizar algunas tareas específicas.</para>
<para
>Si se llama sin las opciones -b (--batch) ni -c (-add), &ark; se inicia como un programa gráfico normal.</para>
<para
>Cuando se usa la opción -b (--batch), &ark; se puede utilizar para extraer el contenido de uno o más archivos directamente desde la línea de órdenes, sin lanzar su interfaz gráfica.</para>
<para
>Cuando se usa la opción -c (-add), &ark; solicita los archivos que se van a añadir a un archivo comprimido nuevo o ya existente.</para>
<para
></para>
<para
></para>
</refsect1>

<refsect1>
<title
>Opciones</title>

<variablelist>
<varlistentry>
<term
><option
>-d, --dialog</option
></term>
<listitem>
<para
>Muestra un diálogo para especificar las opciones de una operación por lotes o de añadir archivos.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>-o, --destination <replaceable
>directorio</replaceable
></option
></term>
<listitem
><para
>Especifica el <replaceable
>directorio</replaceable
> de extracción por omisión. Si no se indica se usará la ruta actual.</para>
</listitem>
</varlistentry>
</variablelist>

<refsect2>
<title
>Opciones para añadir archivos</title>
<variablelist>
<varlistentry>
<term
><option
>-c, --add</option
></term>
<listitem>
<para
>Solicita al usuario el un nombre de archivo comprimido al que añadir los archivos especificados. Sale cuando finaliza.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>-t, --add-to <replaceable
>archivo</replaceable
></option
></term>
<listitem>
<para
>Añade los archivos especificados al <replaceable
>archivo</replaceable
> indicado. Crea el archivo comprimido si no existe. Sale cuando finaliza.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>-p, --changetofirstpath</option
></term>
<listitem>
<para
>Cambia el directorio actual a la primera entrada y añade el resto de entradas relativas a ésta.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-f, --autofilename <replaceable
>sufijo</replaceable
></option
></term>
<listitem>
<para
>Escoge un nombre de archivo automáticamente usando el <replaceable
>sufijo</replaceable
> proporcionado (por ejemplo, rar, tar.gz, zip o cualquier tipo permitido).</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Opciones para la extracción por lotes</title>
<variablelist>
<varlistentry>
<term
><option
>b, --batch</option
></term>
<listitem>
<para
>Usar la interfaz por lotes en lugar del diálogo normal. Esta opción se da por supuesta si se especifica más de un URL.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e, --autodestination</option
></term>
<listitem>
<para
>El argumento de destino se fijará a la ruta del primer archivo suministrado.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-a, --autosubfolder</option
></term>
<listitem>
<para
>Se leerá el contenido del archivo comprimido y, si se detecta que no se trata de un archivo de una única carpeta, se creará una subcarpeta con el nombre del archivo comprimido.</para>
</listitem>
</varlistentry>

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

<refsect1>
<title
>Ejemplos</title>

<variablelist>
<varlistentry>
<term
><userinput
><command
>ark</command
> <option
>--batch</option
> <replaceable
>archivo.tar.bz2</replaceable
></userinput
></term>
<listitem>
<para
>Extraerá <replaceable
>archivo.tar.bz2</replaceable
> en el directorio actual sin mostrar ninguna interfaz gráfica. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>ark</command
> <option
>-b</option
> <option
>-d</option
> <replaceable
>archivo.tar.bz2</replaceable
> <replaceable
>archivo2.zip</replaceable
></userinput
></term>
<listitem>
<para
>Mostrará primero un diálogo con opciones de extracción y luego extraerá <replaceable
>archivo.tar.bz2</replaceable
> y <replaceable
>archivo2.zip</replaceable
> en el directorio escogido en el diálogo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>ark</command
> <option
>--add-to</option
> <replaceable
>mi-archivo.zip</replaceable
> <replaceable
>foto1.jpg</replaceable
> <replaceable
>texto.txt</replaceable
></userinput
></term>
<listitem>
<para
>Creará <replaceable
>mi-archivo.zip</replaceable
> si no existe y luego se le añadirán <replaceable
>foto1.jpg</replaceable
> y <replaceable
>texto.txt</replaceable
>. </para>
</listitem>
</varlistentry>

</variablelist>
</refsect1>

<refsect1>
<title
>Autores</title>
<para
>Los encargados actuales de &ark; son &Harald.Hvaal; &Harald.Hvaal.mail; y &Raphael.Kubo.da.Costa; &Raphael.Kubo.da.Costa.mail;.</para>
<para
>Esta página de manual fue escrita por &Lauri.Watts; &Lauri.Watts.mail; en 2005 para &kde; 3.4, y fue modificada posteriormente en 2009 por &Raphael.Kubo.da.Costa; &Raphael.Kubo.da.Costa.mail;.</para>
</refsect1>

</refentry>