# The &kspread; Users Manual

Frank-Andreas
Schmidt
2000-01-30
0.01.00

&kspread; is complete a spreadsheet program. It is part of the &koffice; suite of utilities.

KDE
KSpread
KOffice
Spreadsheet

## Still to be done on this manual

This is a list of things which still need work in this manual:

- A template only. Has to be filled with contents

## Introduction

This chapter will show the main features of &kspread;

### The &koffice; environment

&kspread; is a full featured spreadsheet program.

It is part of the &koffice; productivity suite for the K Desktop Environment.

Other applications in &koffice; include

- &kword; (text processing and desktop publishing)
- &kpresenter; (presentation creator)
- &kontour; (a vector drawing program)
- &krayon; (a bitmap image editor)
- &kformula; (formula editor)
- &kchart; (for charts/graphs)

All &koffice; applications were designed from the beginning to take advantage from &kde; 2.0. Because of this, &kspread; (like all of &koffice;), supports drag and drop, themes, and many other advanced features.

&kspread; is a spreadsheet which can work as a traditional table-oriented sheet but also allows to put in complex formula of higher mathematics and statistics. There's also the possibility of putting the data to visibility by using graphics

With the use of Python scripting there will be the possibility of having automated processes within the spreadsheets such as pre-defined input masks and calculation on demand.

Other advantages are:

- This is only a template and has to be filled with information on the main program features.

### What parts of this guide should I read?

We have to distinguish between different types of users:

If you got this file without having installed the software, read the chapter that deals with installation first.

If you are an experienced user who has a special question you may try the reference section and/or the FAQ's

If you got this file while working with &kspread; (by pressing F1) it would be best to follow the chapter's link to the Step-by-Step Guide

## Fundamentals

This next section is designed to introduce you to:

1. How to start &kspread;

2. Rest deleted, will see to that later

### Starting &kspread;

&kspread; can be started one of three ways:

1. You can select &kspread; through the system menu by following the &kde; Application menu Applications Office KSpread

2. If you are in a terminal program (&konsole;, Xterm, &etc;), you can type: ``kspread &``

   Or

   ``kspread filename &``

3. Using &konqueror;, you can click on your data file (&kspread; documents normally end in `.ksp` but it's not required). This will automatically start &kspread; showing the last edited table of the sheet.

## Step by Step Tutorial

Hopefully this tutorial has introduced you to the basics of &kspread;.

## The &kspread; Screen

### Overview

&kspread;, like most GUI based programes, divides the screen up into several areas. Each are used to perform a group of similar features. When you start the &kspread; screen, it is initially divided into 4 major areas:

1. The &kde; Frame (which remains at the top of all programs run under &kde;).

2. Rest deleted.

#### The &kde; frame

The &kde; Frame (which is not labled in the diagram above, surrounds all applications run under &kde;. For more information on &kde; Frames, please see the &kde; User Guide.

## Detailed Guides: Document Storage and Printing

This section of the documentation will cover everything you need to know about starting a new spreadsheet, saving a spreadsheet to a file, retrieving a saved and printing a document.

### Beginning a new file

Go on writing...

### Saving a spreadsheet to a file

Once you have entered data, formula and whatsoever into a spreadsheet, you will usually want to save this to a file on your hard drive.

### Retrieving a saved file

The Open command can be invoked 4 ways:

### Printing A Document

Go on writing

## The Menu Items/Tool Bars

## Detailed Guides: Editing your spreadsheet

## Detailed Guides: Data representation issues

## Detailed Guides: Python scripts

## &kspread; Options

In this section we may describe how to use filters to im-and export data

### Import/Export Filters

#### CSV Filter

#### HTML Filter

#### &Microsoft; Excel 97 Filter

## Questions and Answers

### FAQ

Where can I get updates?

How do themes affect &kspread;?

How does Drag and Drop work with &kspread;?

## Credits and License

&kspread;

Program copyright 1998-1999 The &koffice; Team bongo@kongo.org

Documentation copyright 2000 Frank-Andreas Schmidt

&underFDL; &underGPL;

## Glossary

ASCII

  Stands for ... &kspread; can read and write documents in ASCII format.

Binary code

  Binary code is the actual instructions for the computer.

## Key Bindings Summary

### Key Bindings for &kspread;

Command | Key Combination
--- | ---
Start New Document | &Ctrl;N
Open Document | &Ctrl;O
Save Document | &Ctrl;S
Print Document | &Ctrl;P
Close Document | &Ctrl;W
Quit KSpread | &Ctrl;Q
Forgot | &Alt;Backspace
Copy | &Ctrl;C
Cut | &Ctrl;X
Paste | &Ctrl;V
Find and Replace | &Ctrl;F
Select All | &Ctrl;A
Insert Picture | F2
Insert Clipart | F3
Insert Special Character | &Alt;C
Insert Hard Frame Break | &Ctrl;Enter

## Installation

### System Requirements

In order to install and use &kspread; you must have:

- A functioning &UNIX; system with the &X-Windows; system configured.

- The K Desktop Environment 2.2 (&kde; 2.2). &kspread; will probably not function with older versions of &kde;. Information on obtaining and installing &kde; 2.2 can be found at: http://www.kde.org.

- Permission to install software on your computer. If you are on a stand alone system, this will not be a problem. If, however, you are using a networked computer, check with your administrator.

If you plan on compiling &koffice; from source code you will also need:

- `automake` 1.4 or newer. This can be downloaded from: ftp://ftp.gnu.org/pub/gnu/automake/

- `autoconf` 2.13 or later. This can be downloaded from: ftp://ftp.gnu.org/pub/gnu/autoconf/

- A C++ compiler which supports exceptions (preferably `gcc` 2.95.x). This can be downloaded from http://egcs.cygnus.com/

- Troll Tech's &Qt; 2.3 development packages. These can be downloaded from ftp://ftp.troll.no/

Once your system meets these requirements, you than need to decide whether you want to install from the source code, or premade compiled packages.

If you want to obtain the most current binary version of &koffice;, you can find more information at Getting Binary Packages.

If pre-compiled binaries are not available for your system, you can download the source code and compile it yourself. Instructions on where to obtain the current source code and what to do with the source code once you have it, can be found under Getting the source code.

### Getting Binary Packages

You can download the most current binaries from http://koffice.kde.org/

or from one of many mirror sites. The current list of mirror sites can be found at http://www.kde.org/mirrors.html

It is important that you find a binary package that is compatable with your system. If you are unable to find it here, you may be able to obtain a pre-compiled binary from the website of your distribution.

### From Binary Packages

To install &kspread; from precompiled binaries, you should:

1. Ensure your computer has all the required software (excluding &koffice; of course), is installed. You can find the system requirements under System Requirements.

2. Download the &koffice; binary (***Insert filenames (rpm and deb and tar) here***) into a temporary directory.

3. If the file is a `.rpm` (&RedHat; Package Management Package), &koffice; can be installed with: ``rpm` `-U` filename`

   If the file is a `.deb` (Debian Package file), &koffice; can be installed with: ``dpkg` `-i` filename`

   If the file is a tarball (ends in `.tar.gz` or `.tgz`), &koffice; can be installed with ``tar` `-xzvf` filename`

4. You are now installed!

You can now start &kspread; or you can go through a Step by Step which will help take you through a sample document.

### Getting Source Code

You can download the current source code from http://koffice.kde.org/ or from one of many mirror sites. The current list of mirror sites can be found at http://www.kde.org/mirrors.html

### From Source Code

If you want to build &kspread; from source code, you should

1. Ensure your computer has all the required software (excluding &koffice; of course), is installed. You can find the system requirements under System Requirements.

2. Download the &koffice; source file (Insert filenames (srpm and tar) here***) into a temporary directory.

STUFF

### Problems with Compilation

Problems STUFF

&documentation.index;