<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kchart;"><!-- replace kapp here, do *not* replace kappname-->
  <!ENTITY package "koffice"><!-- kdebase, kdeadmin, etc -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE"><!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title>The &kchart; Handbook</title>

<authorgroup>
<author>
<firstname>Jonathan</firstname>
<othername></othername>
<surname>Drews</surname>
<affiliation>
<address><email>j.e.drews@att.net</email></address>
</affiliation>
</author>
</authorgroup>

<!-- TRANS:ROLES_OF_TRANSLATORS -->

<othercredit role="developer">
<firstname>Matthias</firstname>
<othername>Kalle</othername>
<surname>Dalheimer</surname>
<affiliation>
<address><email>kalle@kde.org</email></address>
</affiliation>
<contrib>Developer</contrib>
</othercredit>


<!-- Translators: put here the copyright notice of the translation -->

<legalnotice>&FDLNotice;</legalnotice>

<date>2002-07-20</date>
<releaseinfo>1.01.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para>
&kchart; is an application for drawing bar graphs, pie charts and line
plots. It is intended to be used with &kspread;. &kchart; is still
under development so some features do not work.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kdeutils</keyword>
<keyword>Kchart</keyword>
<keyword>chart</keyword>
<keyword>graph</keyword>
<keyword>plot</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">

<title>Introduction</title>

<para>
&kchart; is intended primarily for use with &kspread;. It is currently
undergoing revision and should  be considered beta software.
</para>

<sect1 id="main_window">
<title>Plotting with &kchart;</title>
<para>To plot with &kchart;, when it is embedded in &kspread;, do the following:</para>

<screenshot>
<screeninfo>Picture of toolbars dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kchart-kspread.png" format="PNG"/>
	  </imageobject>
	</mediaobject>
</screenshot>

<itemizedlist>
<listitem><para>
Highlight the second row of numbers.
</para></listitem>

<listitem><para>
Next click on the <guilabel>Chart</guilabel> button 
<inlinemediaobject><imageobject><imagedata fileref="frame_chart.png"
format="PNG"/></imageobject></inlinemediaobject> to create the chart.
</para></listitem>

<listitem><para>Select the options you want from the chart Wizard. The
chart Wizard will pop up after you insert the chart.</para></listitem>

</itemizedlist>

<para>To make a bar chart for individual items, put the numbers in a
column, as shown below.</para>

<screenshot>
<screeninfo>Picture of toolbars dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kchart-kspread-bar.png" format="PNG"/>
	  </imageobject>
	</mediaobject>
</screenshot>

<para>The orientation of the numbers detremines how the plot will be
made. </para>

<itemizedlist>
<listitem><para>
A row of numbers defines the ordinates for a single plot.
</para></listitem>

<listitem><para>
A column of numbers defines the heights for each bar, in a bar
graph. It also determines the size of the slices in a pie chart.
</para></listitem>
</itemizedlist>

</sect1>
</chapter>

<chapter id="commands">
<title>Command Reference</title>

<sect1 id="kchart-menus">
<title>The main &kchart; window</title>

<sect2>
<title>The <guimenu>File</guimenu> Menu</title>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>New</guimenuitem>
</menuchoice></term>
<listitem><para><action>Creates a new document</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Open...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a document</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Open Recent</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a recently saved document</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Save</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the document</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Save As</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the document with the specified format</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Print</guimenuitem>
</menuchoice></term>
<listitem><para><action>Prints the document</action></para>
<important><para>Make sure the proper print system is selected in the
<quote>Print system currently used:</quote> section. This option can
be seen after clicking on the <guimenu>Expand</guimenu> button.</para></important></listitem>

</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Print preview</guimenuitem>
</menuchoice></term>
<listitem><para><action>Displays a picture of what the printed
document will look like.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Document Information...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a dialog box</action> where you can enter
information about your chart.</para>
<note><para>This document information will be
displayed in the &konqueror; file browser as a tool tip. The tool tips
are pop-ups that show the contents of a file when you move your mouse over
the file icon.</para></note></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Send File...</guimenuitem>
</menuchoice></term>
<listitem><para><action></action></para>
<warning><para>This feature does not work
properly. Do not use it.</para></warning>
</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 chart.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quits</action> &kchart;</para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title>The <guimenu>Edit</guimenu> Menu</title>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Customize with Wizard...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Allows you to specify the chart
type.</action>You can also insert titles and change the fonts, with
the Wizard.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Edit Data...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Table for entering the data.</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Configure...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Dialogs for configuring the
chart.</action></para>
</listitem>
</varlistentry>
</variablelist>
</para>
<sect3>
<title>The Configure Tabs</title>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Colors</guimenu>
</menuchoice></term>
<listitem><para><action>Select graph colors</action>, grid colors and
title colors here.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Font</guimenu>
</menuchoice></term>
<listitem><para><action>Select font style and size</action> here. The
series colors can be selected here also. The series refer to the
individual graphs. Each graphed set of data is a series</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Background</guimenu>
</menuchoice></term>
<listitem><para><action>Select the background color</action> for your
graph.</para>
<note><para>The picture backgrounds do not work at this time</para></note>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Legend</guimenu>
</menuchoice></term>
<listitem><para><action>Change the location of the legend</action> box. The
color of the legend box can be changed also. The legend box contains
the color key to the graph series.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Axes</guimenu>
</menuchoice></term>
<listitem><para><action>The axes can be turned on</action> or off
here.</para>
<note><para>Not all the features work here.</para></note>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>3D Parameters</guimenu>
</menuchoice></term>
<listitem><para><action>The perspective for the 3d bar graphs can be
set here. </action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Chart Subtype</guimenu>
</menuchoice></term>
<listitem><para><action>Changes the arrangement of bar graphs.</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Header/Footer</guimenu>
</menuchoice></term>
<listitem><para><action>Enter the titles you want for your graph</action>here.</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

<sect2>
<title>The <guimenu>Settings</guimenu> Menu</title>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Load Config</guimenuitem>
</menuchoice></term>
<listitem><para><action>Loads a previously saved configuration.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Save Config</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the configuration you set up in
Edit Configure.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Default Config</guimenuitem>
</menuchoice></term>
<listitem><para><action>Loads the default configuration.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show File Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Displays the file toolbar for fast access.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Chart Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Displays the toolbar for the different
charting styles (Pie Chart, Bar Chart, Area Chart and so on).</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect2>

<sect2>
<title>Configuring Shortcuts</title>

<para>The <menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice>
allows you to specify key bindings</para>


<para>Below is an example of how to configure a short cut for opening
the chart wizard.</para>

<screenshot>
<screeninfo>Picture of shortcut dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="shortcut.png" format="PNG"/>
	  </imageobject>
	</mediaobject>
</screenshot>

<itemizedlist>
<listitem><para>
Click on the <guilabel>Custom</guilabel> button.
</para></listitem>

<listitem><para>
Next click on the <guilabel>Primary</guilabel> button.
</para></listitem>

<listitem><para>
Do <userinput><keycombo
action="seq">&Alt;&Ctrl;<keycap>W</keycap></keycombo></userinput>
and the dialog should disappear. The key binding is now entered. 
</para></listitem>
</itemizedlist>

<para>Pressing the keys <userinput><keycombo
action="seq">&Alt;&Ctrl;<keycap>W</keycap></keycombo></userinput>
now opens the Wizard.</para>
</sect2>


<sect2>
<title>Configuring Toolbars</title>
<para>The <menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure Toolbars...</guimenuitem></menuchoice>
Is used to add additional buttons to the toolbars.</para>

<screenshot>
<screeninfo>Picture of toolbars dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="toolbars.png" format="PNG"/>
	  </imageobject>
	</mediaobject>
</screenshot>

<itemizedlist>

<listitem>
<para>To add a button to the File toolbar, 
</para>

<screenshot>
<screeninfo>Picture of toolbars dialog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="file-toolbar.png" format="PNG"/>
	  </imageobject>
	</mediaobject>
</screenshot>

<para>  make sure <guilabel>File
  &lt;KOfficeShell&gt;</guilabel> is displayed in the top combo box.
</para></listitem>

<listitem><para>
Click on one of the items in the left hand pane. This item will now have a
blue background showing that it has been selected.
</para></listitem>

<listitem><para>
Next click on the <keysym>Right arrow</keysym> button to place it in
the right pane.
</para></listitem>

<listitem><para>
Click on <userinput><guilabel>Apply</guilabel></userinput> and then
click on <userinput><guilabel>OK</guilabel></userinput>
</para></listitem>
</itemizedlist>


<para>The new Item should be in the toolbar. <inlinemediaobject><imageobject>
	    <imagedata fileref="file-toolbar2.png" format="PNG"/>
	  </imageobject></inlinemediaobject></para>


</sect2>


<sect2>
<title>The <guimenu>Help</guimenu> Menu</title>

&help.menu.documentation;

</sect2>

</sect1>
</chapter>



<chapter id="faq">
<title>Questions and Answers</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para>Can &kchart; accept text files of data, such as columns of
numbers, for plotting?</para>
</question>
<answer>
<para>No. At this time &kchart; can only make graphs from inside
&kspread;.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>Why do some of the commands from the <guimenu>Edit</guimenu>
<guimenuitem>Configure...</guimenuitem> menu not function?</para>
</question>
<answer>
<para>&kchart; is still under development and some features do not work.</para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">
<title>Credits and License</title>

<para>
&kchart;
</para>
<para>
Program copyright 1998-2002 Matthias Kalle Dalheimer <email>kalle@kde.org</email>
</para>
<para>
Contributors:
<itemizedlist>
<listitem><para>Laurent Montel <email>lmontel@mandrakesoft.com</email></para>
</listitem>
<listitem><para>Karl-Heinz Zimmer <email>khz@kde.org</email></para>
</listitem>
</itemizedlist>
</para>

<para>
Documentation copyright 2002 Jonathan Drews <email>j.e.drews@att.net</email>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;               <!-- FDL: do not remove -->
&underGPL;        	 <!-- GPL License -->


</chapter>

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

<sect1 id="getting-kchart">
<title>How to obtain &kchart;</title>

&install.intro.documentation;

</sect1>

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

<para>
In order to successfully use &kchart;, you need &koffice; 1.2 and Qt-3.0.5. 
</para>

<para>
All required libraries as well as &kchart; itself can be found
on <ulink url="http://www.koffice.org">The &koffice; home page</ulink>.
</para>

<!-- For a list of updates, you may refer to the application web site
or the ChangeLog file, or ... -->
<para>
You can find a list of changes at <ulink
url="http://www.koffice.org/kchart/">http://www.koffice.org/kchart/</ulink>.
</para>
</sect1>

<sect1 id="compilation">
<title>Compilation and Installation</title>

&install.compile.documentation;

</sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

-->

