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

<book lang="&language;">

<bookinfo>
<title
>Manuale di &ark;</title>

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

<othercredit role="translator"
><firstname
>Simone</firstname
><surname
>Zaccarin</surname
><affiliation
><address
><email
>simozack@yahoo.it</email
></address
></affiliation
><contrib
>Traduzione del documento</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
>2008-08-03</date>
<releaseinfo
>2.10.999</releaseinfo>

<abstract>
<para
>&ark; è il gestore degli archivi di &kde;.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>gzip</keyword>
<keyword
>gunzip</keyword>
<keyword
>tar</keyword>
<keyword
>archivio</keyword>
<keyword
>zip</keyword>
<keyword
>compressione</keyword>
<keyword
>lha</keyword>
<keyword
>kdeutils</keyword>
<keyword
>ark</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Introduzione</title>

<para
>&ark; è un programma per gestire vari formati di archivi all'interno dell'ambiente di &kde;. Gli archivi possono essere visti, estratti, creati e modificati all'interno di &ark;. Il programma può trattare vari formati come ad esempio <command
>tar</command
>, <command
>gzip</command
>, <command
>bzip2</command
>, <command
>zip</command
>, <command
>rar</command
> e <command
>lha</command
> (se i programmi a linea di comando appropriati sono installati). </para>
</chapter>

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

<sect1 id="ark-open">
<title
>Aprire gli archivi</title>

<para
>Per aprire un archivio con &ark;, scegli <guimenuitem
>Apri...</guimenuitem
> dal menu <guimenu
>File</guimenu
>. Puoi aprirli anche trascinandoli da &konqueror;. I file di archivio dovrebbero essere associati ad &ark;: se così fosse, puoi anche fare clic con il tasto <mousebutton
>destro</mousebutton
> su un file in &konqueror; o in &dolphin; e selezionare <guimenuitem
>Apri con &ark;</guimenuitem
> per aprirlo.</para>

</sect1>

<sect1 id="ark-work-files">
<title
>Lavorare con i file</title>

<para
>Una volta aperto un archivio, puoi eseguire varie operazioni sui file all'interno. Selezionando un file ed usando il menu <guimenu
>Azione</guimenu
> puoi scegliere che cosa intendi fare:</para>

<itemizedlist>
<listitem>
<para
><guimenuitem
>Aggiungi file...</guimenuitem
> aggiungerà i file dal disco all'archivio.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Aggiungi cartella...</guimenuitem
> aggiungerà cartelle dal tuo disco all'archivio.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Elimina</guimenuitem
> rimuoverà il/i file attualmente selezionato/i dall'archivio.</para>
</listitem
> 
<listitem>
<para
><guimenuitem
>Estrai...</guimenuitem
> estrae l'intero contenuto dell'archivio nella posizione specificata.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Anteprima</guimenuitem
> aprirà il file nel visualizzatore integrato</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="ark-extract">
<title
>Estrarre gli archivi</title>

<para
>Una volta che l'archivio è stato aperto con &ark; può essere estratto. Per estrarre i file dall'archivio, puoi sia selezionare <guimenuitem
>Estrai...</guimenuitem
> dal menu <guimenu
>Azione</guimenu
>. La finestra di dialogo <guilabel
>Estrai</guilabel
> ti permette di selezionare dove estrarre i file. Puoi anche selezionare quale file vuoi estrarre:</para>

<itemizedlist>
<listitem>
<para
><guimenuitem
>Solo file selezionati</guimenuitem
> estrae solo i file che hai selezionato.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Tutti i file</guimenuitem
> estrae l'intero contenuto dell'archivio.</para>
</listitem
> 
</itemizedlist>

<para
>Puoi specificare la cartella nella quale estrarre i file nella casella di testo <guilabel
>Cartella di destinazione:</guilabel
>. La destinazione predefinita è la cartella nella quale si trova l'archivio. Una volta completata l'estrazione nella cartella scelta, puoi anche scegliere di aprirla con &konqueror; o con &dolphin;.</para>

</sect1>

<sect1 id="ark-create">
<title
>Creazione di archivi e aggiungere file</title>

<para
>Per creare un nuovo archivio in &ark;, seleziona <guimenuitem
>Nuovo</guimenuitem
> dal menu <guimenu
>File</guimenu
>.</para>

<para
>Successivamente, puoi digitare il nome dell'archivio, con l'estensione appropriata (<literal role="extension"
>tar.gz</literal
>, <literal role="extension"
>zip</literal
>, <literal role="extension"
>bz2</literal
> &etc;). Per aggiungere i file all'archivio, seleziona <guimenuitem
>Aggiungi file...</guimenuitem
> dal menu <guimenu
>Azione</guimenu
>. Se vuoi aggiungere un'intera cartella, scegli <guimenuitem
>Aggiungi cartella...</guimenuitem
> dal menu <guimenu
>Azioni</guimenu
>.</para>

<para
>Un modo alternativo per aggiungere i file all'archivio è quello di trascinare un file da &konqueror;, da &dolphin; o dal desktop all'interno della finestra principale di &ark;: in questo modo verrà aggiunto all'archivio corrente.</para>

</sect1>

</chapter>
<!-- no configuration in 4.2
<chapter id="configuration">
<title
>Configuring &ark;</title>

<sect1 id="generalsettings">
<title
>General Settings</title>

<variablelist>

<varlistentry>
<term
><guilabel
>Use integrated viewer</guilabel
></term>
<listitem>
<para
>Use the integrated viewer to view files, if possible.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Enable &konqueror; integration</guilabel
></term>
<listitem>
<para
>Enable the plugin for extracting or adding files to archives through &konqueror; context menus.</para>
<para
>This option only works if the &konqueror; integration plugin from kdeaddons is installed on your system.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="addition">
<title
>File Addition Settings</title>

<para
>Many of these options are only configurable for specific archive
formats.  Other formats may behave either way and are not
configurable.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Replace old files only with newer
files</guilabel
></term>
<listitem>
<para
>If you add filenames that already exist in an archive, only
replace them if the added files are newer than the ones already
present in the archive.</para>
</listitem>
</varlistentry>
-->
<!-- TODO: Entry seems to have disappearead, confirm that it's not just 
hidden because I don't have lha installed
<varlistentry>
<term
><guilabel
>Keep entries generic (Lha)</guilabel
></term>
<listitem>
<para
> FIXME: Find out what this is</para>
<para
>Affects only Lha archives</para>
</listitem>
</varlistentry>
 -->
<!--
<varlistentry>
<term
><guilabel
>Force MS-DOS short filenames (Zip)</guilabel
></term>
<listitem>
<para
>Force names to the DOS 8.3 format.</para>
<para
>Affects only zip files</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Translate LF to DOS CRLF (Zip)</guilabel
></term>
<listitem>
<para
>Convert the line endings in text files to DOS format from &UNIX; 
format.</para>
<para
>Affects only zip files</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Store symlinks as links (Zip, Rar)</guilabel
></term>
<listitem>
<para
>Save links inside the archive, instead of following them and
including the files being linked to.</para>
<para
>Affects zip and rar archives.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Recursively add subfolders (Zip,
Rar)</guilabel
></term>
<listitem>
<para
>If you add a folder to an archive, also add any
subfolders inside.  Affects zip and rar archives</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="extraction">
<title
>Extraction Settings</title>

<para
>Many of these options are only configurable for specific archive
formats.  Other formats may behave either way and are not
configurable.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Overwrite files (Zip, Tar, Zoo, Rar)</guilabel
></term>
<listitem>
<para
>Overwrite any files that have matching names on disk with the
one from the archive.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Preserve permissions (Tar)</guilabel
></term>
<listitem>
<para
>Save the user, group, and permission settings on files.  Use
with care, as this may result in files being extracted that do not
belong to any valid user on your computer.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ignore folder names (Zip)</guilabel
></term>
<listitem>
<para
>Extract all the files into the extraction folder, ignoring
any folder structure in the archive.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Convert filenames to lowercase (Zip, Rar)</guilabel
></term>
<term
><guilabel
>Convert filenames to uppercase (Rar)</guilabel
></term>
<listitem>
<para
>Extract all files with all lowercase (or uppercase) names.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="folders">
<title
>Folders</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Folders</guilabel
></term>
<listitem>
<para
>This shows the <guilabel
>Folders</guilabel
> dialog box, so you
	can <action
>choose the default folders</action
>. You can configure a <guilabel
>Common folder</guilabel
> that will be used for all options, use the last used folder, or a custom folder.</para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

</chapter>
-->
<chapter id="commands">
<title
>Guida di riferimento ai comandi</title>

<sect1 id="filemenu">
<title
>Il menu <guimenu
>File</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Nuovo</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Crea un nuovo archivio</action
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Apri...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Apre un archivio</action
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>File</guimenu
> <guisubmenu
>Apri Recenti</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Mostra una lista degli archivi recenti da cui scegliere</action
>.</para>
</listitem>
</varlistentry>

<!-- varlistentry>
<term
><menuchoice>
<guimenu
>File</guimenu>
<guimenuitem
>New Window</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Opens a new &ark; window</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<shortcut
><keycap
>F5</keycap
></shortcut>
<guimenu
>File</guimenu>
<guimenuitem
>Reload</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Loads the current archive again from disk. This will
refresh &ark;'s view if another program has made changes to the
archive.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<guimenu
>File</guimenu>
<guimenuitem
>Save As</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Allows you to save the current archive under a new file
name</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<shortcut>
<keycombo action="simul"
>&Ctrl;<keycap
>W</keycap>
</keycombo>
</shortcut>
<guimenu
>File</guimenu>
<guimenuitem
>Close</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Closes the current archive</action
></para>
</listitem>
</varlistentry-->

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Esci</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Chiude &ark;</action
>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<!-- no edit in 4.2 
<sect1 id="editmenu">
<title
>The <guimenu
>Edit</guimenu
> Menu</title>

<variablelist>

<varlistentry>
<term
><menuchoice>
<guimenu
>Edit</guimenu>
<guimenuitem
>Select...</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Lets you select files according to their
filename</action
>. For example, you could use <literal
role="extension"
>*.txt</literal
> to select all text files. Note that you
can't use more than one filter at a time.</para>
</listitem
> 
</varlistentry>

<varlistentry>
<term
><menuchoice>
<shortcut
><keycombo action="simul"
>&Ctrl;
<keycap
>A</keycap
></keycombo
></shortcut>
<guimenu
>Edit</guimenu>
<guimenuitem
>Select All</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Selects all the files in the archive</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<guimenu
>Edit</guimenu>
<guimenuitem
>Deselect All</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Unselects all the files in the archive</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<guimenu
>Edit</guimenu>
<guimenuitem
>Invert Selection</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Reverses which files are selected. Selected files become
unselected, and unselected files are selected.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<guimenu
>Edit</guimenu>
<guimenuitem
>View Shell Output</guimenuitem>
</menuchoice
></term>
<listitem>
<para
>Displays the <guilabel
>Shell Output</guilabel
> box, which
<action
>shows you the output of the most recent command(s)</action
> run
by &ark;. This is sometimes useful if you are having problems and want
to troubleshoot.</para>
</listitem
> 
</varlistentry>

</variablelist>

</sect1>
-->
<sect1 id="actionmenu">
<title
>Il menu <guimenu
>Azione</guimenu
></title>

<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Azione</guimenu
> <guimenuitem
>Aggiungi file...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Mostra la finestra di dialogo <guilabel
>Aggiungi file</guilabel
>, dove puoi selezionare i file. Tieni premuto &Ctrl; e fai clic per selezionare più file.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Azione</guimenu
> <guimenuitem
>Aggiungi cartella...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Mostra la finestra di dialogo <guilabel
>Aggiungi cartella</guilabel
>. Devi solo selezionare una cartella e fare clic su <guibutton
>OK</guibutton
>.</para>
</listitem
> 
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Azione</guimenu
> <guimenuitem
>Elimina</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Rimuove dall'archivio i file attualmente selezionati.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Azione</guimenu
> <guimenuitem
>Estrai...</guimenuitem
> </menuchoice
></term>
<listitem>
<!--this has changed in 4.2-->
<para
>Mostra la finestra di dialogo <guilabel
>Estrai</guilabel
>, che permette di <action
>selezionare dove vuoi estrarre i file</action
>. Puoi anche selezionare quali sono i file da estrarre:</para>

<itemizedlist>
<listitem>
<para
><guimenuitem
>Solo file selezionati</guimenuitem
> estrae solo i file che hai selezionato.</para>
</listitem>
<listitem>
<para
><guimenuitem
>Tutti i file</guimenuitem
> estrae l'intero contenuto dell'archivio.</para>
</listitem
> 
</itemizedlist>

<para
>Puoi specificare la cartella nella quale estrarre i file nella casella di testo <guilabel
>Cartella di destinazione:</guilabel
>. La destinazione predefinita è la cartella nella quale si trova l'archivio. Una volta completata l'estrazione nella cartella scelta, puoi anche scegliere di aprirla con &konqueror; o con &dolphin;.</para>
</listitem
> 
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Azione</guimenu
> <guimenuitem
>Anteprima</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Apre i file attualmente selezionati con il programma di visualizzazione associato.</action
></para>
</listitem
> 
</varlistentry>

<!--varlistentry>
<term
><menuchoice>
<guimenu
>Action</guimenu>
<guimenuitem
>Open With...</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Opens the currently selected file in a program you
choose.</action
> The <guilabel
>Open With...</guilabel
> dialog box lets
you choose which program to use. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<guimenu
>Action</guimenu>
<guimenuitem
>Edit With...</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Opens the currently selected file in a program you
choose.</action
> Any changes you make in the editor program will be
reflected in the archive, as it will be updated. </para>
</listitem
> 
</varlistentry-->

</variablelist>

</sect1>

<sect1 id="settingsmenu">
<title
>Il menu <guimenu
>Impostazioni</guimenu
></title>

<variablelist>

<!--varlistentry>
<term
><menuchoice>
<guimenu
>Settings</guimenu>
<guimenuitem
>Show Toolbar</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Toggles whether the toolbar is displayed. </action
></para>
</listitem>
</varlistentry-->

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra la barra di stato</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Gestisce la visualizzazione della barra di stato. </action
></para>
</listitem>
</varlistentry>

<!--varlistentry>
<term
><menuchoice>
<guimenu
>Settings</guimenu>
<guimenuitem
>Show/Hide Search Bar</guimenuitem>
</menuchoice
></term>
<listitem>
<para
><action
>Toggles whether the search bar is
displayed. </action
></para>
</listitem>
</varlistentry-->

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura le scorciatoie...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Visualizza la finestra di dialogo <guilabel
>Configura scorciatoie</guilabel
>. Ciò ti <action
>permette di scegliere i tasti di scorciatoia per le varie voci di menu.</action
> Per cambiare una scorciatoia, seleziona un'azione dalla lista, e poi scegli la combinazione di tasti che intendi usare. Facendo clic con il <interface
>tasto</interface
> a forma di mano in basso a destra ti permette di scegliere quali sono i tasti specifici da utilizzare. Devi solo premere il tasto nuovo. </para>
</listitem
> 
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura le barre degli strumenti...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Visualizza una finestra di dialogo standard di &kde; dove puoi configurare le icone della barra degli strumenti.</para>
</listitem>
</varlistentry>

<!--varlistentry>
<term
><menuchoice>
<guimenu
>Settings</guimenu>
<guimenuitem
>Configure Ark...</guimenuitem>
</menuchoice
></term>
<listitem>
<para>
This opens the &ark; configuration dialog.  The dialog contains four
modules (General, Addition, Extraction and Folders).  Configuring &ark; is covered in the section <link
linkend="configuration"
>Configuration</link
></para>
</listitem>
</varlistentry-->
</variablelist>

</sect1>

<sect1 id="help-menu">
<title
>Il menu <guimenu
>Aiuto</guimenu
></title>
&help.menu.documentation; </sect1>

</chapter>

<chapter id="credits">

<title
>Ricononoscimenti e licenza</title>

<para
>&ark;, Copyright &copy; 1997-2008, i vari sviluppatori di &ark;</para>

<itemizedlist>
<title
>Autori:</title>
<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 (autore: Emily Ezust) <email
>emilye@corel.com</email
></para
></listitem>
</itemizedlist>

<para
>Documentazione Copyright &copy; 2000 &Matt.Johnston; &Matt.Johnston.mail;</para>

<para
>La documentazione è stata aggiornata a &kde; 3.3 da Henrique Pinto <email
>henrique.pinto@kdemail.net</email
>.</para>

<para
>Traduzione italiana di Simone Zaccarin <email
>simozack@yahoo.it</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installazione</title>

<sect1 id="getting-ark">
<title
>Come ottenere &ark;</title>
&install.intro.documentation; </sect1>

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

<para
>Per poter utilizzare con successo &ark;, hai bisogno di &kde; 4.1. Hai bisogno anche di &GNU; <command
>Tar</command
> ed un recente <command
>gzip</command
> se vuoi che &ark; gestisca gli archivi tar. Per manipolare altri formati di file, hai bisogno degli appropriati programmi a linea di comando, come <command
>zip</command
>, <command
>unzip</command
>, <command
>ar</command
>, <command
>rar</command
> e <command
>lha</command
>. </para>

</sect1>

<sect1 id="compilation">
<title
>Compilazione ed installazione</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index; 
</book>

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

