]>

# The KSpread Users Manual

Frank-Andreas
Schmidt
KDE
KSpread
KOffice
Spreadsheet
30/01/2000
0.1.0
0.1.0
30/01/2000
FSch
First try to put a structure to doc based on MPMīs outline

KSpread is complete a spreadsheet program. It is part of the KOffice suite of utilities.

## 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 KDesktop Environment.

Other applications in KOffice include

- KWord (text processing and desktop publishing)
- KPresenter (presentation creator)
- KIllustrator (a vector drawing program)
- KImageShop (a bitmap image editor)
- Katabase (database)
- KFormula (formula editor)
- KChart (for charts/graphs)
- and KImage (an image viewer).

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

## Installation

### System Requirements

In order to install and use KSpread you must have:

- A functioning Linux system with the X windowing system configured.

- The K Desktop Environment 2.0 (KDE 2.0). KSpread will NOT function with older versions of KDE. Information on obtaining and installing KDE 2.0 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 egcs 1.1.x). This can be downloaded from http://egcs.cygnus.com/

- Troll Tech's QT 2.1 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 (Red Hat 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.

3. If the file is a .rpm (Red Hat Package Management Package), KOffice can be installed with:

       $ rpm -U 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!

STUFF

### Problems with Compilation

Problems STUFF

## 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 menue -> Applications -> Koffice -> Kpread

2. If you are in a terminal program (KVT, Xterm, etc), you can type:

       $ KSpread &amp

   Or

       $ KSpread filename &amp

3. Using Konquerer, you can click on your data file (KSpread documents end in .ksp). This will automatically start KSpread show 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(TM) Excel97 Filter

## Questions and Answers

### FAQ

Frequently asked questions

### Where can I get updates

### How do themes affect KSpread

### Drag and Drop with KSpread

## Appendix

### Glossary

ASCII

  Stands for STUFF. KSpread can read and write documents in ASCII format.

Binary code

  Binary code is the actual instructioins 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

## Credits and License

KSpread

Program copyright 1998-1999 The KOffice Team bongo@kongo.org

Contributors:

Documentation copyright 2000 Frank-Andreas Schmidt frank-andreas.schmidt@t-online.de

Translations done by:

This program is licensed under the terms of the GNU GPL.