# The ark Handbook

Robert
Palmbos

    robertp@macatawa.org

25/10/1997
0.05.00

This Handbook describes ark Version 0.5

ark
zip
compression
lha

## Introduction

Ark is a program for managing and quickly extracting archives. It works closely with KFM and various other parts of the KDE environment. Current features include, a quick list of archives in a user defined directory, quick extraction of archives to any directory, and adding files via drag and drop from kfm.

`Robert Palmbos`

robertp@macatawa.org

## Installation

### How to obtain Ark

Ark can be found in the kdeutils package of the K Desktop Environment http://www.kde.org. ftp://ftp.kde.org/pub/kde/ is the main ftp site of the KDE project.

### Requirements

- The latest version of KDE. KDE is in beta so not everything will work perfectly. It can be found on ftp://ftp.kde.org/.

- GNU Tar v1.12 and a recent gzip.

- KFM is needed to get full functionality from Ark.

- Qt v1.31. Information regarding Qt can found on http://www.troll.no/.

- The appropriate programs for other archive formats are needed as well. These include lha, zip, unzip, and ar.

## Onscreen Fundamentals

### Setting the Archive Directory

Ark will automatically remember your archive dir. You must first set it via "Set Archive Directory" from the options menu. Enter the full path, such as, "/home/rob/dloads". To quickly go to this directory when ark is running, click on the home icon on the toolbar. A listing of all files in the archive directory will then be shown. Click on an archive to open it.

### Opening and Viewing Archives

There are a few different ways to open an archive. The first is done by clicking on either the open button on the toolbar or by choosing open from the file menu. The second is done by clicking an archive in your archive directory.

### Working with Files

An archive must be opened before any work can be done with it. To view a file in an archive click on it or select view from the edit menu after selecting a file. A dialog will come up asking for the program you wish to view it with. Type in kless, kview, or whatever is appropriate for that file. Select "Edit...Extract" in the menus to extract the selected file to a directory of your choice. Select "Edit...Delete" to remove the selected file from the archive.

### Extracting Archives

Once you have opened an archive it can be quickly extracted to any directory. To do this either click on the extract button on the toolbar or choose "Extract To" from the file menu. A dialog will come up asking you for the destination directory. Type in the full path, such as, "/home/rob/new&lowbar;kde&lowbar;stuff". A progress indicator will popup showing just that, and disappear when finished.

### Creating and Adding Files to Archives

To create a new archive choose new from the file menu. Files can be added to an open archive by dragging them in from KFM. Whole directories and multiple files can dropped on Ark at once.

## The Menu Entries

### File

#### New Window

Creates a another Ark window.

#### New

Create a new archive. The type of archive created is determined from the extension you give the new file.

#### Open

Opens an archive. Whatever is open now will be closed.

#### Close

Closes the current Ark window. If no windows remain the program will exit.

#### Exit

Exits Ark.

### Edit

#### Extract

This will extract what ever is currently selected in the listing.

#### View

This pops up a dialog asking what program you wish to use to view the selected file.

#### Delete

This will delete the currently select file. It may not work with all archive formats.

### Options

#### Set archive directory...

This will popup a dialog asking which directory you normally keep your archives in. After setting this, clicking the home button on the toolbar will show a listing of the archives present in that directory.

#### File adding options...

This pops up a dialog with two checboxes. If you want files added to archives to be stored from there full path, for instance /bin/sh, check this. Otherwise they will be stored from the directory they are dragged out of in KFM.

The next checkbox should be checked if you wish to only add files to an archive that are new than those present in the archive. This may not work with all archive formats.

### Help

#### Help

Invokes the KDE help system with the Ark help pages displayed.

#### About

Displays essential information about Ark.