<title>Menus</title>

<title>Menus</title>

<para>

<para>

particular to &chalk;. The <guimenu>File</guimenu> menu contains commands for

particular to &chalk;. The <guimenu>File</guimenu> menu contains commands for

manipluating files. In the <guimenu>Edit</guimenu> menu, you can find commands

manipluating files. In the <guimenu>Edit</guimenu> menu, you can find commands

that do things with the current selection.  With the commands from the

that do things with the current selection.  With the commands from the

<guimenuitem>Open...</guimenuitem>

<guimenuitem>Open...</guimenuitem>

</menuchoice></term>

</menuchoice></term>

<listitem><para><action>Opens an existing document.</action>

<listitem><para><action>Opens an existing document.</action>

dialog to let you select a file, you can open files via various protocols

dialog to let you select a file, you can open files via various protocols

(ftp, fish, etcetera).

(ftp, fish, etcetera).

</para></listitem>

</para></listitem>

<guimenuitem>Save As...</guimenuitem>

<guimenuitem>Save As...</guimenuitem>

</menuchoice></term>

</menuchoice></term>

<listitem><para><action>Saves the document under a different name.</action>

<listitem><para><action>Saves the document under a different name.</action>

or ssh (fish) is perfectly possible.</para> </listitem>

or ssh (fish) is perfectly possible.</para> </listitem>

</varlistentry>

</varlistentry>

<guimenu>File</guimenu>

<guimenu>File</guimenu>

<guimenuitem>Mail...</guimenuitem>

<guimenuitem>Mail...</guimenuitem>

</menuchoice></term>

</menuchoice></term>

mail compose window will be used.</para></listitem>

mail compose window will be used.</para></listitem>

</varlistentry>

</varlistentry>

<guimenuitem>Print...</guimenuitem>

<guimenuitem>Print...</guimenuitem>

</menuchoice></term>

</menuchoice></term>

<listitem><para><action>Prints the document.</action> You will see the usual

<listitem><para><action>Prints the document.</action> You will see the usual

</varlistentry>

</varlistentry>

<varlistentry>

<varlistentry>

<guimenuitem>Cut</guimenuitem>

<guimenuitem>Cut</guimenuitem>

</menuchoice></term>

</menuchoice></term>

<listitem><para><action>Cuts the selection to the

<listitem><para><action>Cuts the selection to the

clipboard, and the selection is cleared.</para></listitem>

clipboard, and the selection is cleared.</para></listitem>

</varlistentry>

</varlistentry>

<guimenuitem>Configure Shortcuts...</guimenuitem>

<guimenuitem>Configure Shortcuts...</guimenuitem>

</menuchoice></term>

</menuchoice></term>

<listitem><para><action>Opens the <guilabel>Configure Shortcuts

<listitem><para><action>Opens the <guilabel>Configure Shortcuts

and allows you to configure shortcuts for all actions &chalk; has to

and allows you to configure shortcuts for all actions &chalk; has to

offer.</para></listitem>

offer.</para></listitem>

</varlistentry>

</varlistentry>

<guimenuitem>Configure Toolbars...</guimenuitem>

<guimenuitem>Configure Toolbars...</guimenuitem>

</menuchoice></term>

</menuchoice></term>

<listitem><para><action>Opens the <guilabel>Configure Toolbars</guilabel>

<listitem><para><action>Opens the <guilabel>Configure Toolbars</guilabel>

and allows you to configure &chalk;'s toolbars.</para></listitem>

and allows you to configure &chalk;'s toolbars.</para></listitem>

</varlistentry>

</varlistentry>

</para><para>

</para><para>

A word on compatibility: &chalk; is still in development. From &chalk; 1.5 to

A word on compatibility: &chalk; is still in development. From &chalk; 1.5 to

1.6 not many API changes are expected, but there may be some. From &chalk; 1.6

1.6 not many API changes are expected, but there may be some. From &chalk; 1.6

<command>automake</command> to <command>cmake</command>: many changes are to

<command>automake</command> to <command>cmake</command>: many changes are to

be expected. If you develop a plugin for &chalk; and choose to do so in

be expected. If you develop a plugin for &chalk; and choose to do so in

&chalk;’s subversion repository, chances are excellent that we’ll help you

&chalk;’s subversion repository, chances are excellent that we’ll help you

<title>Creating plugins</title>

<title>Creating plugins</title>

<para>

<para>

developer API. Only viewplugins should use the &koffice; API. Don’t worry:

developer API. Only viewplugins should use the &koffice; API. Don’t worry:

&chalk;’s API’s are quite clear and rather extensively documented (for free

&chalk;’s API’s are quite clear and rather extensively documented (for free

software) and coding your first filter is really easy.

software) and coding your first filter is really easy.

is a different thing altogether, though, and you cannot currently write tools,

is a different thing altogether, though, and you cannot currently write tools,

colorspaces, paintops or import/export filters as scripts.

colorspaces, paintops or import/export filters as scripts.

</para><para>

</para><para>

documentation at <ulink url="http://developer.kde.org" /> is relevant here, too.

documentation at <ulink url="http://developer.kde.org" /> is relevant here, too.

</para><para>

</para><para>

Your distribution should have either installed the relevant header files with

Your distribution should have either installed the relevant header files with

<title>Automake (and CMake)</title>

<title>Automake (and CMake)</title>

<para>

<para>

describes the <command>automake</command> way of creating plugins. 

describes the <command>automake</command> way of creating plugins. 

<!-- If I have not updated this manual when we release KOffice 2.0, please

<!-- If I have not updated this manual when we release KOffice 2.0, please

remind me to do so. -->

remind me to do so. -->

</para><para>

</para><para>

<filename>Makefile.am</filename>. Filters, tools, paintops, colorspaces and

<filename>Makefile.am</filename>. Filters, tools, paintops, colorspaces and

import/export filters need <literal role="extension">.desktop</literal> files;

import/export filters need <literal role="extension">.desktop</literal> files;

viewplugins need a <application>KXMLGui</application>

viewplugins need a <application>KXMLGui</application>

<para>

<para>

Let's look at the skeleton for a plugin module. First, the

Let's look at the skeleton for a plugin module. First, the

makefile that builds your plugin:

makefile that builds your plugin:

<programlisting>

<programlisting>

If your plugin is a viewplugin, you will likely also install a <literal

If your plugin is a viewplugin, you will likely also install a <literal

role="extension">.rc</literal> file with entries for menubars and toolbars.

role="extension">.rc</literal> file with entries for menubars and toolbars.

Likewise, you may need to install cursors and icons. That is all done through

Likewise, you may need to install cursors and icons. That is all done through

<programlisting>

<programlisting>

chalkrcdir = $(kde_datadir)/chalk/chalkplugins

chalkrcdir = $(kde_datadir)/chalk/chalkplugins

<title>Boilerplate</title>

<title>Boilerplate</title>

<para>

<para>

framework to instantiate the plugin — a header file and an implementation file.

framework to instantiate the plugin — a header file and an implementation file.

</para><para>

</para><para>

A header file:

A header file:

<sect1 id="introduction-manual">

<sect1 id="introduction-manual">

<title>About this manual</title>

<title>About this manual</title>

<para>

<para>

operating system. The first chapter will give you a quick tour of &chalk;'s

operating system. The first chapter will give you a quick tour of &chalk;'s

cool features; the other chapters will expand on that information.

cool features; the other chapters will expand on that information.

</para>

</para>

<para>

<para>

So, let's show you all the niceties. You can start &chalk; either on its own

So, let's show you all the niceties. You can start &chalk; either on its own

either under Graphics or under Office — it depends a bit on who packaged

either under Graphics or under Office — it depends a bit on who packaged

&koffice; for you. Or do what I do: press

&koffice; for you. Or do what I do: press

<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> (which opens the

<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> (which opens the

<abstract>

<abstract>

<para>

<para>

</para>

</para>

</abstract>

</abstract>

</bookinfo>

</bookinfo>

<chapter id="introduction"> <title>Introduction</title> <para>

<chapter id="introduction"> <title>Introduction</title> <para>

this computer.</para> <para>If you need help, please check <ulink

this computer.</para> <para>If you need help, please check <ulink

submitting your question to <ulink url="mailto:kde@kde.org">The

submitting your question to <ulink url="mailto:kde@kde.org">The

Team</emphasis></para>

Team</emphasis></para>

&underFDL;

&underFDL;

    <para>

    <para>

      Database objects (tables, queries, etc.) listed in the <guilabel>Project

      Database objects (tables, queries, etc.) listed in the <guilabel>Project

      Navigator</guilabel> can opened by clicking (or

      Navigator</guilabel> can opened by clicking (or

    </para>

    </para>

<sect2 id="main-application-elements">

<sect2 id="main-application-elements">

<!-- TODO: Screenshot of IDEAl mode -->

<!-- TODO: Screenshot of IDEAl mode -->

      <para>

      <para>

	IDEAl mode is the default MDI mode, and may be familiar from

	IDEAl mode is the default MDI mode, and may be familiar from

	is shown maximized within the &kexi; main window at once.

	is shown maximized within the &kexi; main window at once.

	A tab bar, containing one tab for each child window, allows

	A tab bar, containing one tab for each child window, allows

	other child windows to be viewed by simply clicking on the

	other child windows to be viewed by simply clicking on the

<sect1 id="opening">

<sect1 id="opening">

<title>Opening a Document</title>

<title>Opening a Document</title>

<para>Recently used documents are listed under <menuchoice><guimenu>File</guimenu><guisubmenu>Open Recent</guisubmenu></menuchoice>.</para>

<para>Recently used documents are listed under <menuchoice><guimenu>File</guimenu><guisubmenu>Open Recent</guisubmenu></menuchoice>.</para>

</sect1>

</sect1>

<sect1 id="printing">

<sect1 id="printing">

<title>Printing</title>

<title>Printing</title>

</sect1>

</sect1>

<sect1 id="import-export">

<sect1 id="import-export">

<sect1 id="page-export">

<sect1 id="page-export">

<title>Exporting a Page</title>

<title>Exporting a Page</title>

<para>The following formats are supported:</para>

<para>The following formats are supported:</para>

<itemizedlist>

<itemizedlist>

<abstract>

<abstract>

<para>

<para>

&koffice; is an integrated office suite for the K Desktop Environment

&koffice; is an integrated office suite for the K Desktop Environment

</para>

</para>

</abstract>

</abstract>

<para>

<para>

&koffice; is an integrated office suite for the K Desktop Environment

&koffice; is an integrated office suite for the K Desktop Environment

</para>

</para>

<itemizedlist>

<itemizedlist>

<para>

<para>

Despite offering so many components, &koffice; is very lightweight, fast and

Despite offering so many components, &koffice; is very lightweight, fast and

has a rather low memory footprint. This is also achieved because &koffice; builds

has a rather low memory footprint. This is also achieved because &koffice; builds

</para>

</para>

<para>

<para>

A goal of &koffice; is also to not overload the user interface with features

A goal of &koffice; is also to not overload the user interface with features

<sect2 id="featurekde">

<sect2 id="featurekde">

<title>KDE Features</title>

<title>KDE Features</title>

<para>

<para>

Desktop Integration, Configurability and so on. All this makes the look and

Desktop Integration, Configurability and so on. All this makes the look and

feel of &koffice; very familiar and really integrates &koffice; into the

feel of &koffice; very familiar and really integrates &koffice; into the

desktop environment, thus allowing seamless workflows.

desktop environment, thus allowing seamless workflows.

functionality than saving, loading, printing, &etc;

functionality than saving, loading, printing, &etc;

</para>

</para>

you can freely customize &koffice; menubars and tool

you can freely customize &koffice; menubars and tool

bars. Unfortunately, at the moment, there are no easy-to-use dialogs

bars. Unfortunately, at the moment, there are no easy-to-use dialogs

to do this. &koffice; stores its &GUI; configuration in &XML; files

to do this. &koffice; stores its &GUI; configuration in &XML; files

<para>

<para>

The following links should be useful if you're looking for more information

The following links should be useful if you're looking for more information

</para>

</para>

<itemizedlist>

<itemizedlist>

<para>

<para>

<ulink url="http://www.kde.org">The KDE Homepage</ulink>. KDE is the most advanced and 

<ulink url="http://www.kde.org">The KDE Homepage</ulink>. KDE is the most advanced and 

absolutely free desktop environment for unix-like operating systems. 

absolutely free desktop environment for unix-like operating systems. 

</para></listitem>

</para></listitem>

<listitem>

<listitem>

<para><ulink url="http://www.trolltech.com">Trolltech</ulink>. The creators

<para><ulink url="http://www.trolltech.com">Trolltech</ulink>. The creators

</para></listitem>

</para></listitem>

</itemizedlist>

</itemizedlist>

<itemizedlist>

<itemizedlist>

<listitem><para> At <ulink

<listitem><para> At <ulink

url="http://developer.kde.org">http://developer.kde.org</ulink> you'll

url="http://developer.kde.org">http://developer.kde.org</ulink> you'll

</para></listitem> 

</para></listitem> 

<listitem><para>

<listitem><para>

In the &koffice; sources you'll find an example application in the

In the &koffice; sources you'll find an example application in the

<para>

<para>

This manual is copyright by Jost Schenck. It can be distributed

This manual is copyright by Jost Schenck. It can be distributed

freely, as long as this copyright notice is included. You may change

freely, as long as this copyright notice is included. You may change

<acronym>CVS</acronym>.  I'll not be liable for anything resulting

<acronym>CVS</acronym>.  I'll not be liable for anything resulting

from the use of this manual.

from the use of this manual.

</para>

</para>

for more information.

for more information.

</para></listitem>

</para></listitem>

<listitem><para>

<listitem><para>

</para></listitem>

</para></listitem>

<listitem><para>

<listitem><para>

Permission to install software on your computer. If you are on a

Permission to install software on your computer. If you are on a

</itemizedlist>

</itemizedlist>

<para>

<para>

on your system, you can still use &koffice; in a different desktop

on your system, you can still use &koffice; in a different desktop

environment (for example, XFCE or GNOME).

environment (for example, XFCE or GNOME).

</para>

</para>

<chapter id="technology">

<chapter id="technology">

<title>Under The Hood</title>

<title>Under The Hood</title>

notably KParts and &DCOP;.</para>

notably KParts and &DCOP;.</para>

<para>The &GUI; integration of the components is done by plugins

<para>The &GUI; integration of the components is done by plugins

<abstract>

<abstract>

<para>

<para>

</para>

</para>

</abstract>

</abstract>

<title>For Users with Disabilities</title>

<title>For Users with Disabilities</title>

<para>This section of the documentation discusses accessibility features in &kpresenter;

<para>This section of the documentation discusses accessibility features in &kpresenter;

<ulink url="help:kcontrol">&kcontrolcenter;</ulink>.  Some apply to all &koffice; applications,

<ulink url="help:kcontrol">&kcontrolcenter;</ulink>.  Some apply to all &koffice; applications,

and some are specific to &kpresenter;.</para>

and some are specific to &kpresenter;.</para>

<para>

<para>

Most of the features described in this chapter are enabled by installing the

Most of the features described in this chapter are enabled by installing the

<command>tdeaccessibility</command> module.  

<command>tdeaccessibility</command> module.  

<ulink url="http://www.kde.org">http://www.kde.org</ulink>.  The <command>tdeaccessibility</command> 

<ulink url="http://www.kde.org">http://www.kde.org</ulink>.  The <command>tdeaccessibility</command> 

package can be obtained from &kde-ftp;, the

package can be obtained from &kde-ftp;, the

</para>

</para>

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>.

visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>.

</para>

</para>

</sect1>

</sect1>

<indexterm><primary>Visual Impairments</primary></indexterm>

<indexterm><primary>Visual Impairments</primary></indexterm>

<note><para>&kpresenter; is not usable by totally blind users.  It is hoped that

<note><para>&kpresenter; is not usable by totally blind users.  It is hoped that

</para></note>

</para></note>

<sect2 id="a11y-theming">

<sect2 id="a11y-theming">

<!--    

<!--    

<?xml version="1.0" ?>

<?xml version="1.0" ?>

To edit or validate this document separately, uncomment this prolog

To edit or validate this document separately, uncomment this prolog

Be sure to comment it out again when you are done -->

Be sure to comment it out again when you are done -->

<!-- <?xml version="1.0" ?>

<!-- <?xml version="1.0" ?>

"dtd/kdex.dtd">

"dtd/kdex.dtd">

To edit or validate this document separately, uncomment this prolog

To edit or validate this document separately, uncomment this prolog

</menuchoice></term>

</menuchoice></term>

<listitem>

<listitem>

<para>

<para>

open dialog will appear, allowing you to choose a file to open.

open dialog will appear, allowing you to choose a file to open.

</para>

</para>

</listitem>

</listitem>

</menuchoice>

</menuchoice>

</term>

</term>

<listitem>

<listitem>

open dialog will appear, allowing you to choose a <guilabel>&kpresenter; Document</guilabel> (.kpr) or a 

open dialog will appear, allowing you to choose a <guilabel>&kpresenter; Document</guilabel> (.kpr) or a 

<guilabel>OASIS OpenDocument Presentation</guilabel> (.odp), which will be inserted after the last slide in your current presentation.</para>

<guilabel>OASIS OpenDocument Presentation</guilabel> (.odp), which will be inserted after the last slide in your current presentation.</para>

</listitem>

</listitem>

<!-- <?xml version="1.0" ?>

<!-- <?xml version="1.0" ?>

To edit or validate this document separately, uncomment this prolog

To edit or validate this document separately, uncomment this prolog

Be sure to comment it out again when you are done -->

Be sure to comment it out again when you are done -->

<para>

<para>

This brings up a file selection dialog. To learn about this or other

This brings up a file selection dialog. To learn about this or other

documentation. You can browse by clicking on <guiicon>folder</guiicon>

documentation. You can browse by clicking on <guiicon>folder</guiicon>

icons or by using the <guiicon>browser</guiicon> style buttons on the

icons or by using the <guiicon>browser</guiicon> style buttons on the

toolbar (highlighted in red.) Clicking the <guiicon>up arrow</guiicon>

toolbar (highlighted in red.) Clicking the <guiicon>up arrow</guiicon>

<title>For Users with Disabilities</title>

<title>For Users with Disabilities</title>

<para>This section of the documentation discusses accessibility features in &kspread;

<para>This section of the documentation discusses accessibility features in &kspread;

<ulink url="help:kcontrol">&kcontrolcenter;</ulink>.  Some apply to all &koffice; applications,

<ulink url="help:kcontrol">&kcontrolcenter;</ulink>.  Some apply to all &koffice; applications,

and some are specific to &kspread;.</para>

and some are specific to &kspread;.</para>

<para>

<para>

Most of the features described in this chapter are enabled by installing the

Most of the features described in this chapter are enabled by installing the

<command>tdeaccessibility</command> module.  

<command>tdeaccessibility</command> module.  

<ulink url="http://www.kde.org">http://www.kde.org</ulink>.  The <command>tdeaccessibility</command> 

<ulink url="http://www.kde.org">http://www.kde.org</ulink>.  The <command>tdeaccessibility</command> 

package can be obtained from &kde-ftp;, the

package can be obtained from &kde-ftp;, the

</para>

</para>

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>.

visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>.

</para>

</para>

</sect1>

</sect1>

<indexterm><primary>Visual Impairments</primary></indexterm>

<indexterm><primary>Visual Impairments</primary></indexterm>

<note><para>&kspread; is not usable by totally blind users.  It is hoped that

<note><para>&kspread; is not usable by totally blind users.  It is hoped that

</para></note>

</para></note>

<sect2 id="a11y-theming">

<sect2 id="a11y-theming">

</chapterinfo> 

</chapterinfo> 

<title>&kspread; Basics</title>

<title>&kspread; Basics</title>

cause problems for readers trying to compare the text in a document such as

cause problems for readers trying to compare the text in a document such as

this with what they see on the version of &kspread; running on their desktop.

this with what they see on the version of &kspread; running on their desktop.

To cut down on some of the possibilities for confusion, it it suggested that

To cut down on some of the possibilities for confusion, it it suggested that

<para>At first glance, &kspread;'s <guimenuitem>Cut</guimenuitem>, 

<para>At first glance, &kspread;'s <guimenuitem>Cut</guimenuitem>, 

<guimenuitem>Copy</guimenuitem> and <guimenuitem>Paste</guimenuitem> appear 

<guimenuitem>Copy</guimenuitem> and <guimenuitem>Paste</guimenuitem> appear 

a cell or cells, you can choose <guimenuitem>Copy</guimenuitem> or 

a cell or cells, you can choose <guimenuitem>Copy</guimenuitem> or 

<guimenuitem>Cut</guimenuitem> from the <guimenu>Edit</guimenu> menu or from

<guimenuitem>Cut</guimenuitem> from the <guimenu>Edit</guimenu> menu or from

the drop down menu you get by holding the <mousebutton>right</mousebutton> 

the drop down menu you get by holding the <mousebutton>right</mousebutton> 

worksheet, as a single document file.</para>

worksheet, as a single document file.</para>

<para>If you have created a new document, or want to save an existing one 

<para>If you have created a new document, or want to save an existing one 

under a different name, use <menuchoice><guimenu>File</guimenu><guimenuitem>

under a different name, use <menuchoice><guimenu>File</guimenu><guimenuitem>

<guilabel>Save Document As</guilabel> dialog box. 

<guilabel>Save Document As</guilabel> dialog box. 

Choose the folder where you want to save the document and enter a 

Choose the folder where you want to save the document and enter a 

suitable file name into the <guilabel>Location:</guilabel> text box. &kspread; 

suitable file name into the <guilabel>Location:</guilabel> text box. &kspread; 

<title>Printing a Spreadsheet</title>

<title>Printing a Spreadsheet</title>

<para>Printing a spreadsheet is basically done by selecting <menuchoice>

<para>Printing a spreadsheet is basically done by selecting <menuchoice>

<guimenu>File</guimenu><guimenuitem>Print...</guimenuitem></menuchoice> which

<guimenu>File</guimenu><guimenuitem>Print...</guimenuitem></menuchoice> which

choose, among other options, the printer to be used, the number of copies and

choose, among other options, the printer to be used, the number of copies and

whether all or only selected pages are to be printed.</para>

whether all or only selected pages are to be printed.</para>

<para>By default &kspread; will print all items in the current worksheet, but

<para>By default &kspread; will print all items in the current worksheet, but

<guimenu>Insert</guimenu>

<guimenu>Insert</guimenu>

<guimenuitem>Picture</guimenuitem>

<guimenuitem>Picture</guimenuitem>

</menuchoice></term>

</menuchoice></term>

to insert a picture.

to insert a picture.

</para></listitem>

</para></listitem>

</varlistentry>

</varlistentry>

<varlistentry>

<varlistentry>

<term><guilabel>Skip all uppercase words</guilabel></term>

<term><guilabel>Skip all uppercase words</guilabel></term>

<listitem><para>Check this box if you want the spellchecker to ignore 

<listitem><para>Check this box if you want the spellchecker to ignore 

</para></listitem>

</para></listitem>

</varlistentry>

</varlistentry>

url="http://www.bricklin.com/visicalc.htm">Visicalc.</ulink></para>

url="http://www.bricklin.com/visicalc.htm">Visicalc.</ulink></para>

<para>

<para>

&kspread; is a full featured spreadsheet program. It is part of the &koffice;

&kspread; is a full featured spreadsheet program. It is part of the &koffice;

<para>Other &koffice; applications include &kword;, (word processing),

<para>Other &koffice; applications include &kword;, (word processing),

&kpresenter; (slide presentation creator) and &kchart; (for producing charts

&kpresenter; (slide presentation creator) and &kchart; (for producing charts

and graphs) among others.</para>

and graphs) among others.</para>

<para>You might care to visit <ulink url="http://www.kde.org">

<para>You might care to visit <ulink url="http://www.kde.org">

&koffice; web site at <ulink url="http://www.koffice.org">

&koffice; web site at <ulink url="http://www.koffice.org">

http://www.koffice.org</ulink></para>

http://www.koffice.org</ulink></para>

<appendix id="installation">

<appendix id="installation">

<title>Installation</title>

<title>Installation</title>

&kspread; please visit

&kspread; please visit

<ulink url="http://www.kde.org">http://www.kde.org</ulink> and

<ulink url="http://www.kde.org">http://www.kde.org</ulink> and

<ulink url="http://www.koffice.org">http://www.koffice.org</ulink>.</para>

<ulink url="http://www.koffice.org">http://www.koffice.org</ulink>.</para>

<!-- To validate this document separately, uncomment this prolog

<!-- To validate this document separately, uncomment this prolog

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

<sect1 id="kugardata-dtd">

<sect1 id="kugardata-dtd">

<!-- if you want to validate this file separately, uncomment this prolog:

<!-- if you want to validate this file separately, uncomment this prolog:

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

this prolog

this prolog

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

<chapter id="designer-manual">

<chapter id="designer-manual">

<chapter id="introduction">

<chapter id="introduction">

<title>Introduction</title>

<title>Introduction</title>

a &GUI; report template designer, a report engine, a &konqueror; part

a &GUI; report template designer, a report engine, a &konqueror; part

for easy report preview and a set of examples.</para>

for easy report preview and a set of examples.</para>

this prolog

this prolog

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

</listitem>

</listitem>

</itemizedlist>

</itemizedlist>

but &kugar; is designed to be a report generator, independent from a

but &kugar; is designed to be a report generator, independent from a

programming language and/or <acronym>IDE</acronym>. It uses &XML;

programming language and/or <acronym>IDE</acronym>. It uses &XML;

format for describing report templates and data files. So any program

format for describing report templates and data files. So any program

The &kugar; library includes two widgets for use.

The &kugar; library includes two widgets for use.

</para>

</para>

<para>

<para>

via <function>i18n()</function> calls.

via <function>i18n()</function> calls.

</para>

</para>

<para>

<para>

</para>

</para>

<para>

<para>

Include files are <filename>kugarqt.h</filename> and <filename>kugar.h</filename>

Include files are <filename>kugarqt.h</filename> and <filename>kugar.h</filename>

</para>

</para>

<para>For a detailed example of how &kugar; classes can be used, look in the <filename class="directory">/shell</filename>

<para>For a detailed example of how &kugar; classes can be used, look in the <filename class="directory">/shell</filename>

folder in the &kugar; sources.

folder in the &kugar; sources.

<para>

<para>

This is the example code of how a designer plugin is created. The code below creates a plugin for

This is the example code of how a designer plugin is created. The code below creates a plugin for

</para>

</para>

<para>

<para>

this prolog

this prolog

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

<chapter id="starting">

<chapter id="starting">

<!-- If you want to edit or validate this document separately, uncomment -->

<!-- If you want to edit or validate this document separately, uncomment -->

<!-- this prolog

<!-- this prolog

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

<sect1 id="template-elements">

<sect1 id="template-elements">

<sect1info>

<sect1info>

<!-- If you want to edit or validate this document separately, uncomment

<!-- If you want to edit or validate this document separately, uncomment

this prolog

this prolog

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

<sect1 id="kugartemplate">

<sect1 id="kugartemplate">

<sect1info>

<sect1info>

this prolog

this prolog

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

this prolog

this prolog

<?xml version="1.0" ?>

<?xml version="1.0" ?>

-->

-->

<chapter id="tutorial">

<chapter id="tutorial">

<title>For Users with Disabilities</title>

<title>For Users with Disabilities</title>

<para>This section of the documentation discusses accessibility features in &kword;

<para>This section of the documentation discusses accessibility features in &kword;

<ulink url="help:kcontrol">&kcontrolcenter;</ulink>.  Some apply to all &koffice; applications,

<ulink url="help:kcontrol">&kcontrolcenter;</ulink>.  Some apply to all &koffice; applications,

and some are specific to &kword;.</para>

and some are specific to &kword;.</para>

<para>

<para>

Most of the features described in this chapter are enabled by installing the

Most of the features described in this chapter are enabled by installing the

<command>tdeaccessibility</command> module.  

<command>tdeaccessibility</command> module.  

<ulink url="http://www.kde.org">http://www.kde.org</ulink>.  The <command>tdeaccessibility</command> 

<ulink url="http://www.kde.org">http://www.kde.org</ulink>.  The <command>tdeaccessibility</command> 

package can be obtained from &kde-ftp;, the

package can be obtained from &kde-ftp;, the

</para>

</para>

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>.

visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>.

</para>

</para>

</sect1>

</sect1>

<indexterm><primary>Visual Impairments</primary></indexterm>

<indexterm><primary>Visual Impairments</primary></indexterm>

<note><para>&kword; is not usable by totally blind users.  It is hoped that

<note><para>&kword; is not usable by totally blind users.  It is hoped that

</para></note>

</para></note>

<sect2 id="a11y-theming">

<sect2 id="a11y-theming">

window, it is divided into 5 major areas:</para>

window, it is divided into 5 major areas:</para>

<orderedlist numeration="arabic">

<orderedlist numeration="arabic">

(which remains at the top of all programs run under

(which remains at the top of all programs run under

<listitem><para><link linkend="mb">The Menubar</link>.</para></listitem>

<listitem><para><link linkend="mb">The Menubar</link>.</para></listitem>

<variablelist>

<variablelist>

<varlistentry>

<varlistentry>

</listitem>

</listitem>

</varlistentry>

</varlistentry>

<varlistentry>

<varlistentry>

<listitem><para><emphasis>Scrollbars</emphasis> - The scrollbars are used to move through a &kword; document

<listitem><para><emphasis>Scrollbars</emphasis> - The scrollbars are used to move through a &kword; document

quickly.  The &kword; scrollbars functions similar to all scrollbars in

quickly.  The &kword; scrollbars functions similar to all scrollbars in

<para>The scrollbars can be toggled on and off.

<para>The scrollbars can be toggled on and off.

See the section on <link linkend="opt-ui">Configure &kword; User Interface</link>.</para>

See the section on <link linkend="opt-ui">Configure &kword; User Interface</link>.</para>

</listitem>

</listitem>

<varlistentry>

<varlistentry>

<term><guilabel>Locale date format</guilabel></term>

<term><guilabel>Locale date format</guilabel></term>

<listitem><para>This inserts the date in the format specified in the

<listitem><para>This inserts the date in the format specified in the

<para>To select this option, simply make sure the upper combo box says

<para>To select this option, simply make sure the upper combo box says

<guilabel>Locale date format</guilabel>.  A preview of the date format will appear above the

<guilabel>Locale date format</guilabel>.  A preview of the date format will appear above the

<guibutton>OK</guibutton> button.  If satisfied click <guibutton>OK</guibutton>.

<guibutton>OK</guibutton> button.  If satisfied click <guibutton>OK</guibutton>.

<varlistentry>

<varlistentry>

<term><guilabel>Locale format</guilabel></term>

<term><guilabel>Locale format</guilabel></term>

<listitem><para>This inserts the time in the format specified in the

<listitem><para>This inserts the time in the format specified in the

<para>To select this option, simply make sure the upper combo box says

<para>To select this option, simply make sure the upper combo box says

<guilabel>Locale format</guilabel>.  A preview of the current time

<guilabel>Locale format</guilabel>.  A preview of the current time

string is visible above the <guibutton>OK</guibutton> button.  If satisfied click <guibutton>OK</guibutton>.

string is visible above the <guibutton>OK</guibutton> button.  If satisfied click <guibutton>OK</guibutton>.

<tbody>

<tbody>

<row><entry>Author Name</entry><entry>Joseph User</entry><entry>The name of the author as specified in the <link linkend="documentinfo">Document information</link> box.</entry></row>

<row><entry>Author Name</entry><entry>Joseph User</entry><entry>The name of the author as specified in the <link linkend="documentinfo">Document information</link> box.</entry></row>

<row><entry>City</entry><entry>Philadelphia</entry><entry>The city specified in the <link linkend="documentinfo">Document information</link> box.</entry></row>

<row><entry>City</entry><entry>Philadelphia</entry><entry>The city specified in the <link linkend="documentinfo">Document information</link> box.</entry></row>

<row><entry>Country</entry><entry>United States</entry><entry>The country name specified in the <link linkend="documentinfo">Document information</link> box.</entry></row>

<row><entry>Country</entry><entry>United States</entry><entry>The country name specified in the <link linkend="documentinfo">Document information</link> box.</entry></row>

<row><entry>Directory Name</entry><entry>/home/juser/kword</entry><entry>This is the folder name for the document. The filename is not included in the folder name variable.</entry></row>

<row><entry>Directory Name</entry><entry>/home/juser/kword</entry><entry>This is the folder name for the document. The filename is not included in the folder name variable.</entry></row>

<row><entry>Directory &amp; Filename</entry><entry>/home/juser/kword/Resume.kwd</entry><entry>The folder and filename of the current file.</entry></row>

<row><entry>Directory &amp; Filename</entry><entry>/home/juser/kword/Resume.kwd</entry><entry>The folder and filename of the current file.</entry></row>

<note><para>In order for this string example to work, a mark must be placed in the check box labeled 

<note><para>In order for this string example to work, a mark must be placed in the check box labeled 

<guilabel>Regular expression</guilabel></para>

<guilabel>Regular expression</guilabel></para>

<para>Regular expressions are available by placing a mark in this checkbox. The use of regular expressions is beyond the 

<para>Regular expressions are available by placing a mark in this checkbox. The use of regular expressions is beyond the 

<para>Now in the <guilabel>Replace With</guilabel> section of the replace dialog, you place a mark in the check box labeled

<para>Now in the <guilabel>Replace With</guilabel> section of the replace dialog, you place a mark in the check box labeled

<guilabel>Use placeholders</guilabel>.  Click the <guibutton>Insert Placeholder</guibutton> button and select

<guilabel>Use placeholders</guilabel>.  Click the <guibutton>Insert Placeholder</guibutton> button and select

<guilabel>Complete Match</guilabel>.  &kword; will insert a <emphasis>\0</emphasis> in the 

<guilabel>Complete Match</guilabel>.  &kword; will insert a <emphasis>\0</emphasis> in the 

<para>

<para>

All &koffice; applications were designed from the beginning to take

All &koffice; applications were designed from the beginning to take

all of &koffice;), supports many advanced features you expect from todays desktop environment.

all of &koffice;), supports many advanced features you expect from todays desktop environment.

</para>

</para>

<para>The second tab is labeled <guilabel>Author</guilabel> and has blanks to enter the authors name, <guilabel>Initials</guilabel>, <guilabel>Title</guilabel>, <guilabel>Position</guilabel>, <guilabel>Company</guilabel> and contact information (email address, telephone numbers and physical address).</para>

<para>The second tab is labeled <guilabel>Author</guilabel> and has blanks to enter the authors name, <guilabel>Initials</guilabel>, <guilabel>Title</guilabel>, <guilabel>Position</guilabel>, <guilabel>Company</guilabel> and contact information (email address, telephone numbers and physical address).</para>

<tip><para>Every value entered in this dialog can be inserted as a

<tip><para>Every value entered in this dialog can be inserted as a

<link linkend="variables">document variables</link>.</para></tip>

<link linkend="variables">document variables</link>.</para></tip>

<para>&kword; will now insert the entered information when the <guibutton>Load From Address Book</guibutton> button is clicked.</para></note>

<para>&kword; will now insert the entered information when the <guibutton>Load From Address Book</guibutton> button is clicked.</para></note>

<para>The second button <guibutton>Delete Personal Data</guibutton> allows you to remove all data of the entries on this page.</para>

<para>The second button <guibutton>Delete Personal Data</guibutton> allows you to remove all data of the entries on this page.</para>

<para>When finished entering the information, click <guibutton>OK</guibutton> to apply the changes.

<para>When finished entering the information, click <guibutton>OK</guibutton> to apply the changes.

<listitem><para>Click <guibutton>OK</guibutton>.</para></listitem>

<listitem><para>Click <guibutton>OK</guibutton>.</para></listitem>

</orderedlist>

</orderedlist>

<para>Your PDF file will be created and saved at the location specified in <guilabel>Output file</guilabel>.</para>

<para>Your PDF file will be created and saved at the location specified in <guilabel>Output file</guilabel>.</para>

</sect1>

</sect1>

<para>How do themes affect &kword;?</para>

<para>How do themes affect &kword;?</para>

</question>

</question>

<answer>

<answer>

</answer>

</answer>

</qandaentry>

</qandaentry>

<sect1 id="getting-kword">

<sect1 id="getting-kword">

<title>How to obtain &kword;</title>

<title>How to obtain &kword;</title>

url="http://www.kde.org">http://www.kde.org</ulink>.  &kword; is located

url="http://www.kde.org">http://www.kde.org</ulink>.  &kword; is located

in the &koffice; package which can be obtained from &kde-ftp;, the

in the &koffice; package which can be obtained from &kde-ftp;, the

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

</listitem>

</listitem>

<listitem>

<listitem>

(tdebase).  These can be obtained from the <ulink

(tdebase).  These can be obtained from the <ulink

<para>It is also recommended that you install the arts package 1.3.2 from the

<para>It is also recommended that you install the arts package 1.3.2 from the

</listitem>

</listitem>

<listitem>

<listitem>

<para><emphasis>Show &kword; version</emphasis></para>

<para><emphasis>Show &kword; version</emphasis></para>

<screen width="40">

<screen width="40">

<prompt>$</prompt> <userinput><command>kword -v</command></userinput>

<prompt>$</prompt> <userinput><command>kword -v</command></userinput>

</glossentry>

</glossentry>

<glossentry id="defkde2">

<glossentry id="defkde2">

<glossdef>

<glossdef>

required for &kword; to operate.  The K Desktop Environment is a user

required for &kword; to operate.  The K Desktop Environment is a user

interface which allows users to manipulate files and operate programs

interface which allows users to manipulate files and operate programs

graphically.  For more information, please visit <ulink

graphically.  For more information, please visit <ulink

<itemizedlist>

<itemizedlist>

<listitem><para>If you want to use an outside SQL database, click <link linkend="mail-merge-sql">here</link> for instructions.</para></listitem>

<listitem><para>If you want to use an outside SQL database, click <link linkend="mail-merge-sql">here</link> for instructions.</para></listitem>

<listitem><para>If you want to use a &kspread; file for your data, click <link linkend="mail-merge-kspread">here</link>.</para></listitem>

<listitem><para>If you want to use a &kspread; file for your data, click <link linkend="mail-merge-kspread">here</link>.</para></listitem>

<listitem><para>If you want to use the internal database of &kword;, click <link linkend="mail-merge-internal">here</link>.</para></listitem>

<listitem><para>If you want to use the internal database of &kword;, click <link linkend="mail-merge-internal">here</link>.</para></listitem>

</itemizedlist>

</itemizedlist>

</sect2>

</sect2>

<sect2 id="mail-merge-ab">

<sect2 id="mail-merge-ab">

<para>&kword; can use data in your address book for personalizing documents.</para>

<para>&kword; can use data in your address book for personalizing documents.</para>

</mediaobject>

</mediaobject>

</screenshot>

</screenshot>

<guibutton>OK</guibutton>.  A new dialog box will appear.</para>

<guibutton>OK</guibutton>.  A new dialog box will appear.</para>

<screenshot>

<screenshot>

<para>To remove an entry, select the entry in the right listbox by clicking with the &LMB;.  Then click <guibutton>Remove</guibutton>.</para>

<para>To remove an entry, select the entry in the right listbox by clicking with the &LMB;.  Then click <guibutton>Remove</guibutton>.</para>

<tip><para>You can locate entries quickly by entering the first 2-3 letters of an entries name in the textbox labeled <guilabel>Filter on:</guilabel></para></tip>

<tip><para>You can locate entries quickly by entering the first 2-3 letters of an entries name in the textbox labeled <guilabel>Filter on:</guilabel></para></tip>

<note><para>You can load the full address book application by clicking the <guibutton>Address Book...</guibutton> button.</para>

<note><para>You can load the full address book application by clicking the <guibutton>Address Book...</guibutton> button.</para>

<para>When you have selected all the entries and distribution lists you want, click <guibutton>OK</guibutton>.  &kword; will ask you if you want to replace the current data source.  Click <guibutton>Yes</guibutton> to continue.</para>

<para>When you have selected all the entries and distribution lists you want, click <guibutton>OK</guibutton>.  &kword; will ask you if you want to replace the current data source.  Click <guibutton>Yes</guibutton> to continue.</para>

<!-- <?xml version="1.0" ?>

<!-- <?xml version="1.0" ?>

To work on this document standalone, uncomment the prolog.

To work on this document standalone, uncomment the prolog.

Comment it out again when you are done -->

Comment it out again when you are done -->

<itemizedlist>

<itemizedlist>

<listitem>

<listitem>

<para>You can <link linkend="starting-kword">start &kword; from the

<para>You can <link linkend="starting-kword">start &kword; from the

</listitem>

</listitem>

<listitem>

<listitem>

</listitem>

</listitem>

</itemizedlist>

</itemizedlist>

appear.</para>

appear.</para>

<screenshot>

<screenshot>

<para>The line labled <guilabel>Comment</guilabel> describes how

<para>The line labled <guilabel>Comment</guilabel> describes how

print web site at <ulink url="http://printing.kde.org">http://printing.kde.org</ulink>.</para>

print web site at <ulink url="http://printing.kde.org">http://printing.kde.org</ulink>.</para>

<para>If you want to print all pages of your document and only one copy, you can click 

<para>If you want to print all pages of your document and only one copy, you can click 

<guibutton>Print</guibutton>.  If you want to change the number of copies or only print selected

<guibutton>Print</guibutton>.  If you want to change the number of copies or only print selected

pages, click the <guibutton>Options &gt;&gt;</guibutton> button.</para>

pages, click the <guibutton>Options &gt;&gt;</guibutton> button.</para>

<note><para>Depending on which printing system your computer uses, you may find that you have 

<note><para>Depending on which printing system your computer uses, you may find that you have 

more printing options then those described below.  What is described here, is available on 

more printing options then those described below.  What is described here, is available on 

box, or use the arrows to adjust the number. &kword; can print a maximum

box, or use the arrows to adjust the number. &kword; can print a maximum

of 999 copies at once.</para>

of 999 copies at once.</para>

all of the pages for copy 1, then print all the pages for copy 2, &etc;

all of the pages for copy 1, then print all the pages for copy 2, &etc;

then all of the copies of the second page, &etc;</para>

then all of the copies of the second page, &etc;</para>

<para>You can also determine if the document is printed in forward order

<para>You can also determine if the document is printed in forward order

<para>For more specific information on &kword; file storage or other

<para>For more specific information on &kword; file storage or other

internal information, please see <ulink

internal information, please see <ulink

url="http://www.koffice.org/developer">The KOffice API</ulink> and the

url="http://www.koffice.org/developer">The KOffice API</ulink> and the

pages</ulink>.</para>

pages</ulink>.</para>

</sect2>

</sect2>

<term><filename>mimetype</filename></term>

<term><filename>mimetype</filename></term>

<listitem>

<listitem>

<para>This file contains the mimetype for &kword; files.  This information

<para>This file contains the mimetype for &kword; files.  This information

<para>This file always contains:

<para>This file always contains:

<emphasis>application/x-kword</emphasis></para>

<emphasis>application/x-kword</emphasis></para>

</listitem>

</listitem>

<para>For more specific information on &kword; file storage or other

<para>For more specific information on &kword; file storage or other

internal information, please see <ulink

internal information, please see <ulink

url="http://www.koffice.org/developer">The KOffice API</ulink> and the

url="http://www.koffice.org/developer">The KOffice API</ulink> and the

pages</ulink>.</para>

pages</ulink>.</para>

</sect2>

</sect2>

<term><filename>mimetype</filename></term>

<term><filename>mimetype</filename></term>

<listitem>

<listitem>

<para>This file contains the mimetype for &kword; files.  This information

<para>This file contains the mimetype for &kword; files.  This information

<para>This file always contains:

<para>This file always contains:

<emphasis>application/x-kword</emphasis></para>

<emphasis>application/x-kword</emphasis></para>

</listitem>

</listitem>

<para>For more specific information on &kword; file storage or other

<para>For more specific information on &kword; file storage or other

internal information, please see <ulink

internal information, please see <ulink

url="http://www.koffice.org/developer">The KOffice API</ulink> and the

url="http://www.koffice.org/developer">The KOffice API</ulink> and the

pages</ulink>.</para>

pages</ulink>.</para>

</sect2>

</sect2>

<para>When the pointer is located over toolbars, scrollbars, menu buttons or other areas

<para>When the pointer is located over toolbars, scrollbars, menu buttons or other areas

<emphasis>outside the document</emphasis>, the pointer is an arrow. You should already be

<emphasis>outside the document</emphasis>, the pointer is an arrow. You should already be

<para>When <emphasis>inside the document</emphasis>, there are two separate pointers which alternate automatically

<para>When <emphasis>inside the document</emphasis>, there are two separate pointers which alternate automatically

based on how close to a frame edge the pointer is currently located.</para>

based on how close to a frame edge the pointer is currently located.</para>

<para>When the mouse pointer is near the edge of a frame, the pointer will change into two intersecting lines

<para>When the mouse pointer is near the edge of a frame, the pointer will change into two intersecting lines

</itemizedlist>

</itemizedlist>

<para>On the other hand, a few words have been added (function words like <quote>if</quote>

<para>On the other hand, a few words have been added (function words like <quote>if</quote>

<para>Please do <emphasis>not</emphasis> report bugs in the thesaurus

<para>Please do <emphasis>not</emphasis> report bugs in the thesaurus

</chapter>

</chapter>