diff options
Diffstat (limited to 'doc/kpresenter')
96 files changed, 4998 insertions, 0 deletions
diff --git a/doc/kpresenter/Makefile.am b/doc/kpresenter/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kpresenter/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kpresenter/a11y.docbook b/doc/kpresenter/a11y.docbook new file mode 100644 index 00000000..66f687e2 --- /dev/null +++ b/doc/kpresenter/a11y.docbook @@ -0,0 +1,321 @@ +<chapter id="a11y"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Gary</firstname> +<surname>Cramblitt</surname> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> + +<title>For Users with Disabilities</title> +<para>This section of the documentation discusses accessibility features in &kpresenter; +for users with disabilities. Some of these features apply to &kde; as a whole and are controlled from +<ulink url="help:kcontrol">&kcontrolcenter;</ulink>. Some apply to all &koffice; applications, +and some are specific to &kpresenter;.</para> + +<sect1 id="a11y-install"> +<title>Installing the <command>kdeaccessibility</command> Module</title> +<indexterm><primary>kdeaccessibility</primary></indexterm> +<para> +Most of the features described in this chapter are enabled by installing the +<command>kdeaccessibility</command> module. +The <command>kdeaccessibility</command> module is part of the &kde; project +<ulink url="http://www.kde.org">http://www.kde.org</ulink>. The <command>kdeaccessibility</command> +package can be obtained from &kde-ftp;, the +main ftp site of the &kde; project. +</para> + +<para>Many distributions offer precompiled binaries on their ftp sites. Please check your distribution's web sites for more information.</para> + +<para>More information about &kde; accessibility can be obtained by +visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>. +</para> +</sect1> + +<sect1 id="a11y-sight"> +<title>Visual Impairments</title> +<indexterm><primary>Visual Impairments</primary></indexterm> + +<note><para>&kpresenter; is not usable by totally blind users. It is hoped that +a general screen reader for the blind will be available in future versions of &kde;. +</para></note> + +<sect2 id="a11y-theming"> +<title>Theming</title> +<indexterm><primary>Theming</primary></indexterm> +<para>For low-sighted or light alergic users, several features are available from +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem></menuchoice>. +Under <menuchoice><guimenu>Appearance & Themes</guimenu><guimenuitem>Theme Manager</guimenuitem> +</menuchoice>, you may select from several themes. If you are light alergic, the +<guilabel>HighContrastDark</guilabel> or <guilabel>HighContrastLight</guilabel> themes +may be helpful. If you have difficulty reading small fonts or seeing small icons, the +<guilabel>HighContrastDark-Big</guilabel> or <guilabel>HighContrastLight-Big</guilabel> +themes will increase the size of text, buttons, and icons. You may also customize +background, colors, fonts, and icons from the same screen. A set of monochrome icons +is available. +</para> + +<tip><para>If you choose one of the <guilabel>Big</guilabel> themes, you may discover that +some screens are too large to fit your monitor. Purchasing a larger monitor will be helpful. +You can drag the portions of the screen not visible into the visable area by +holding down the &Alt; key and dragging with the mouse anywhere +within the screen. If you have trouble operating a mouse, you can also move screens by pressing +<keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo>. In +the dropdown Windows Operations Menu, choose +<menuchoice><guimenuitem>Move</guimenuitem></menuchoice>. +Move the screen with the arrow keys and press <keycap>&Esc;</keycap>. +</para></tip> + +</sect2> + +<sect2 id="a11y-kmagnifier"> +<title>KMagnifier</title> +<indexterm><primary>magnifier</primary></indexterm> +<para>The <command>kdeaccessibility</command> module includes a screen magnifier +application called <ulink url="help:kmag">KMagnifier</ulink>. +If it is installed, you may run it from +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>Utilities</guimenuitem> +<guimenuitem>Accessibility</guimenuitem><guimenuitem>Screen Magnifier</guimenuitem></menuchoice>. +</para> +</sect2> + +<sect2 id="a11y-tts"> +<title>Text-to-Speech</title> +<indexterm><primary>Text-to-Speech</primary></indexterm> +<indexterm><primary>TTS</primary></indexterm> +<para>The <command>kdeaccessibility</command> module includes a Text-to-Speech +component called KTTS. If KTTS is installed, you can configure &kpresenter; to +speak the text that is under the mouse pointer or speak the text of each +screen widget as it receives focus. Before using this feature, first configure +KTTS. See <ulink url="help:kttsd">The KTTS Handbook</ulink> for details. +To turn on the TTS feature in &kpresenter;, +select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +&kpresenter;...</guimenuitem></menuchoice> from the menubar. +This will display a dialog box. +Clicking <guibutton>TTS</guibutton> will allow you to change +the following.</para> + +<screenshot> +<mediaobject> +<imageobject><imagedata fileref="tts.png" format="PNG"/></imageobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Speak widget under mouse pointer</guilabel></term> +<listitem><para>When checked, &kpresenter; will speak the text of each widget +as the mouse pointer moves over the widget.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Speak widget with focus</guilabel></term> +<listitem><para>When checked, &kpresenter; will speak the text of each widget +as it receives focus.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Speak tool tips</guilabel></term> +<listitem><para>When checked, &kpresenter; will speak the popup tool tip +for each widget in addition to the text of the widget.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Speak Whats This</guilabel></term> +<listitem><para>When checked, &kpresenter; will speak the Whats This help +for each widget in addition to the text of the widget.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Say whether disabled</guilabel></term> +<listitem><para>When checked, &kpresenter; will speak the word "disabled" +if the widget is currently disabled (grayed).</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Speak accelerators</guilabel></term> +<listitem><para>When checked, &kpresenter; will speak the accelerator +of the widget in addition to the text of the widget. +Accelerators are the underlined letters you see in the text of the +widget. For example, in the main menu, the +<menuchoice><guimenuitem>Quit</guimenuitem></menuchoice> menu item +has the "Q" underlined. You can choose it by pressing <keycap>Q</keycap>. +To speak the accelerator, check this option and enter the +word you want to speak before the accelerator in the +<guilabel>Prefaced by the word</guilabel> box. In this +example shown above, &kpresenter; will speak "Accelerator Q".</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Polling interval</guilabel></term> +<listitem><para>This option determines how often &kpresenter; will +check for a change in the widget under the mouse pointer or +a new focused widget. You should leave this option on the +default setting.</para> +</listitem> +</varlistentry> +</variablelist> + +<note><para> +If the <guibutton>TTS</guibutton> option does not appear +on this screen, you do not have the KTTS component installed +in your system. +</para></note> + +<note><para>Not all widgets are spoken. For example, +the items on the main menubar are not spoken. +</para></note> + +</sect2> + +</sect1> + +<sect1 id="a11y-motor"> +<title>Motor Impairments and Mouseless Operation</title> +<indexterm><primary>Motor Impairments</primary></indexterm> +<indexterm><primary>Mouseless Operation</primary></indexterm> + +<sect2 id="a11y-kmousetool"> +<title>KMouseTool</title> +<para>If you can operate a mouse, but have trouble clicking, the +<ulink url="help:kmousetool">KMouseTool</ulink> application may help. Run it from +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>Utilities</guimenuitem> +<guimenuitem>KMouseTool (Automatik Mouse Click)</guimenuitem></menuchoice>. +</para> +</sect2> + +<sect2 id="a11y-kbd-xaccess"> +<title>XAccess Features</title> +<indexterm><primary>XAccess</primary></indexterm> +<indexterm><primary>Sticky Keys</primary></indexterm> +<indexterm><primary>Slow Keys</primary></indexterm> +<indexterm><primary>Bounce Keys</primary></indexterm> + +<para>The &kcontrolcenter; offers several keyboard features collectively called XAccess. +They include:</para> +<variablelist> +<varlistentry> +<term>Sticky Keys</term> +<listitem><para>This feature permits operation of meta keys, such as +&Alt;, &Ctrl;, and &Shift; without having to hold the keys down. It is useful +when you can only use one finger or one hand to operate the keyboard. +With Sticky Keys on, press and release a &Alt;, &Ctrl;, or &Shift; key, then +press another key. The result is as if you pressed both keys at once. +Press the &Alt;, &Ctrl;, or &Shift; key again to turn off the sticky key. +Activate this feature in +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem> +<guimenuitem>Regional & Accessibility</guimenuitem><guimenuitem>Modifier Keys</guimenuitem></menuchoice>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term>Slow Keys</term> +<listitem><para>This feature is useful if you have hand tremors or difficulty +accurately pressing keys. It prevents +inadvertent key presses by requiring that a key be held down for a minimum +time before it is accepted. Activate this feature in +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem> +<guimenuitem>Regional & Accessibility</guimenuitem><guimenuitem>Keyboard Filters </guimenuitem></menuchoice>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term>Bounce Keys</term> +<listitem><para>This feature is also useful if you have hand tremors. It prevents +inadvertent repeated key presses by preventing another keystroke for +a certain amount of time. Activate this feature in +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem> +<guimenuitem>Regional & Accessibility</guimenuitem><guimenuitem>Keyboard Filters</guimenuitem></menuchoice>.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="a11y-mouse-emulation"> +<title>Mouse Emulation</title> +<indexterm><primary>Mouse Emulation</primary></indexterm> +<para>Mouse Emulation permits you to move and click the mouse using the keyboard. +Press <keycombo>&Alt;<keycap>F12</keycap></keycombo> to activate it. Use the arrow keys +to move the mouse pointer to the desired location, and press <keycap>spacebar</keycap> +to "click" the mouse. Unfortunately, you cannot use Mouse Emulation to perform +&RMB; clicks or dragging. +</para> +</sect2> + +<sect2 id="a11y-mouse-navigation"> +<title>Mouse Navigation</title> +<indexterm><primary>Mouse Navigation</primary></indexterm> +<para>This feature permits you to emulate the mouse using the numeric keypad +of your keyboard. To activate it, go to +<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem> +<guimenuitem>Peripherals</guimenuitem><guimenuitem>Mouse</guimenuitem> +<guimenuitem>Mouse Navigation</guimenuitem></menuchoice>. +Check the <guilabel>Move pointer with keyboard (using the num pad)</guilabel> box. When you do this, the other settings will become enabled, and you can customize the keyboard pointer behavior further, if required. + The various keys on the number pad move in the direction you would expect. Note that you can move diagonally as well as up, down, left and right. The <keycap>5</keycap> key emulates a click to a pointer button, typically &LMB;. You change which button is emulated by using the <keycap>/</keycap> key (which makes it &LMB;), +<keycap>*</keycap> key (which makes it middle mouse button) and <keycap>-</keycap> (which makes it &RMB;). + Using the <keycap>+</keycap> emulates a doubleclick to the selected pointer button. You can use the +<keycap>0</keycap> key to emulate holding down the selected pointer button (for easy dragging), +and then use the <keycap>.</keycap> to emulate releasing the selected pointer button. +</para> + +<screenshot> +<mediaobject> +<imageobject><imagedata fileref="mousenav.png" format="PNG"/></imageobject> +</mediaobject> +</screenshot> + +</sect2> + +<sect2 id="a11y-motor-shortcuts"> +<title>Keyboard shortcuts</title> + +<para>Use the <keycap>Menu</keycap> key to pop up the context +menu. On most keyboards, the <keycap>Menu</keycap> key is on the righthand +side of the keyboard between the <keycap>&Windows;</keycap> and &Ctrl; +keys. It has a menu icon on it. +</para> + +</sect2> + +<sect2 id="a11y-motor-panel-sizing"> +<title>Resizing panels</title> + +<para>You can move the sizing bar between the outline panel and the +slide panel, and between the slide panel and the notes panel +by pressing <keycap>F8</keycap>. A sizing icon appears +overtop the sizing bar. Pressing <keycap>F8</keycap> again moves from one +sizing bar to the next. After the last sizing bar, pressing <keycap>F8</keycap> +hides the sizing icon. Use the arrow keys to move the bar up or down, or left or right. +Press &Esc; when finished sizing. +</para> + +</sect2> + +<sect2 id="a11y-motor-moving-focus"> +<title>Setting focus to widgets</title> + +<para>Normally, one can use the 	 and <keycombo action="simul">&Shift;	</keycombo> +to move focus from one widget to the next in any application. However, when focus is +in the slide panel of &kpresenter;, pressing 	 does not move the focus. +You can set focus to any widget that can receive focus by +pressing <keycombo action="simul">&Alt;<keycap>F8</keycap></keycombo>. A small lettered box appears +overtop each widget on the screen that can receive focus. +</para> + +<screenshot> +<mediaobject> +<imageobject><imagedata fileref="kbd-focus-ext.png" format="PNG"/></imageobject> +</mediaobject> +</screenshot> + +<para>Press the letter to move focus to the corresponding widget. Press +<keycombo action="simul">&Alt;<keycap>F8</keycap></keycombo> again or &Esc; +to abandon moving the focus. +</para> + +</sect2> + +</sect1> + +</chapter> diff --git a/doc/kpresenter/autocorrection1.png b/doc/kpresenter/autocorrection1.png Binary files differnew file mode 100644 index 00000000..8de3dcf9 --- /dev/null +++ b/doc/kpresenter/autocorrection1.png diff --git a/doc/kpresenter/autocorrection2.png b/doc/kpresenter/autocorrection2.png Binary files differnew file mode 100644 index 00000000..d8227294 --- /dev/null +++ b/doc/kpresenter/autocorrection2.png diff --git a/doc/kpresenter/autocorrection3.png b/doc/kpresenter/autocorrection3.png Binary files differnew file mode 100644 index 00000000..6ea8c51d --- /dev/null +++ b/doc/kpresenter/autocorrection3.png diff --git a/doc/kpresenter/autocorrection4.png b/doc/kpresenter/autocorrection4.png Binary files differnew file mode 100644 index 00000000..a9e07fc5 --- /dev/null +++ b/doc/kpresenter/autocorrection4.png diff --git a/doc/kpresenter/barstyle1.png b/doc/kpresenter/barstyle1.png Binary files differnew file mode 100644 index 00000000..47747f59 --- /dev/null +++ b/doc/kpresenter/barstyle1.png diff --git a/doc/kpresenter/barstyle3.png b/doc/kpresenter/barstyle3.png Binary files differnew file mode 100644 index 00000000..19db5238 --- /dev/null +++ b/doc/kpresenter/barstyle3.png diff --git a/doc/kpresenter/barstyle4.png b/doc/kpresenter/barstyle4.png Binary files differnew file mode 100644 index 00000000..53dfacdf --- /dev/null +++ b/doc/kpresenter/barstyle4.png diff --git a/doc/kpresenter/barstyle5.png b/doc/kpresenter/barstyle5.png Binary files differnew file mode 100644 index 00000000..d27f23fa --- /dev/null +++ b/doc/kpresenter/barstyle5.png diff --git a/doc/kpresenter/barstyle6.png b/doc/kpresenter/barstyle6.png Binary files differnew file mode 100644 index 00000000..11145c3c --- /dev/null +++ b/doc/kpresenter/barstyle6.png diff --git a/doc/kpresenter/barstyle7.png b/doc/kpresenter/barstyle7.png Binary files differnew file mode 100644 index 00000000..0f4a9593 --- /dev/null +++ b/doc/kpresenter/barstyle7.png diff --git a/doc/kpresenter/break.png b/doc/kpresenter/break.png Binary files differnew file mode 100644 index 00000000..02d88898 --- /dev/null +++ b/doc/kpresenter/break.png diff --git a/doc/kpresenter/changeformat.png b/doc/kpresenter/changeformat.png Binary files differnew file mode 100644 index 00000000..074f95e9 --- /dev/null +++ b/doc/kpresenter/changeformat.png diff --git a/doc/kpresenter/completion.png b/doc/kpresenter/completion.png Binary files differnew file mode 100644 index 00000000..6d9b7bf3 --- /dev/null +++ b/doc/kpresenter/completion.png diff --git a/doc/kpresenter/configure1.png b/doc/kpresenter/configure1.png Binary files differnew file mode 100644 index 00000000..50097708 --- /dev/null +++ b/doc/kpresenter/configure1.png diff --git a/doc/kpresenter/configure2.png b/doc/kpresenter/configure2.png Binary files differnew file mode 100644 index 00000000..520282c0 --- /dev/null +++ b/doc/kpresenter/configure2.png diff --git a/doc/kpresenter/configure3.png b/doc/kpresenter/configure3.png Binary files differnew file mode 100644 index 00000000..53e74781 --- /dev/null +++ b/doc/kpresenter/configure3.png diff --git a/doc/kpresenter/configure4.png b/doc/kpresenter/configure4.png Binary files differnew file mode 100644 index 00000000..21e07ac2 --- /dev/null +++ b/doc/kpresenter/configure4.png diff --git a/doc/kpresenter/configure4a.png b/doc/kpresenter/configure4a.png Binary files differnew file mode 100644 index 00000000..01e85f55 --- /dev/null +++ b/doc/kpresenter/configure4a.png diff --git a/doc/kpresenter/configure4a1.png b/doc/kpresenter/configure4a1.png Binary files differnew file mode 100644 index 00000000..8c09e4b2 --- /dev/null +++ b/doc/kpresenter/configure4a1.png diff --git a/doc/kpresenter/configure4b.png b/doc/kpresenter/configure4b.png Binary files differnew file mode 100644 index 00000000..72bbecc4 --- /dev/null +++ b/doc/kpresenter/configure4b.png diff --git a/doc/kpresenter/configure4c.png b/doc/kpresenter/configure4c.png Binary files differnew file mode 100644 index 00000000..eb76fdef --- /dev/null +++ b/doc/kpresenter/configure4c.png diff --git a/doc/kpresenter/configure5.png b/doc/kpresenter/configure5.png Binary files differnew file mode 100644 index 00000000..dcc4d93f --- /dev/null +++ b/doc/kpresenter/configure5.png diff --git a/doc/kpresenter/configure6.png b/doc/kpresenter/configure6.png Binary files differnew file mode 100644 index 00000000..ccf339f2 --- /dev/null +++ b/doc/kpresenter/configure6.png diff --git a/doc/kpresenter/configure6b.png b/doc/kpresenter/configure6b.png Binary files differnew file mode 100644 index 00000000..8d584386 --- /dev/null +++ b/doc/kpresenter/configure6b.png diff --git a/doc/kpresenter/configure6c.png b/doc/kpresenter/configure6c.png Binary files differnew file mode 100644 index 00000000..af374508 --- /dev/null +++ b/doc/kpresenter/configure6c.png diff --git a/doc/kpresenter/configure6d.png b/doc/kpresenter/configure6d.png Binary files differnew file mode 100644 index 00000000..b843ee13 --- /dev/null +++ b/doc/kpresenter/configure6d.png diff --git a/doc/kpresenter/configure6e.png b/doc/kpresenter/configure6e.png Binary files differnew file mode 100644 index 00000000..cf306af8 --- /dev/null +++ b/doc/kpresenter/configure6e.png diff --git a/doc/kpresenter/configure7.png b/doc/kpresenter/configure7.png Binary files differnew file mode 100644 index 00000000..178d9ca0 --- /dev/null +++ b/doc/kpresenter/configure7.png diff --git a/doc/kpresenter/faq.docbook b/doc/kpresenter/faq.docbook new file mode 100644 index 00000000..29ab9b05 --- /dev/null +++ b/doc/kpresenter/faq.docbook @@ -0,0 +1,53 @@ +<chapter id="q-and-a"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Neil</firstname> +<surname>Lucock</surname> +<affiliation> +<address><email>neil@nlucock.freeserve.co.uk</email></address> +</affiliation> +</author> +<author> +<firstname>Krishna</firstname> +<surname>Tateneni</surname> +<affiliation> +<address><email>tateneni@pluto.njcc.com</email></address> +</affiliation> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> +<title>Questions and Answers</title> +<subtitle>&kpresenter; 1.6</subtitle> + +<para>Things you might like but &kpresenter; does not yet do (and what +to do about it)</para> + +<!-- + FIXME: Does video embedding via kmplayer or kaboodle work? + +<para>Movies or video. You cannot run video within &kpresenter;. If +you really need to show a movie, make a link to it on your desktop, +move &kpresenter; out of the way, click the link to the movie file and +use <application>mplayer</application> (or similar) to view it.</para> + --> + +<para><application>Powerpoint</application> Files. &kpresenter; does +attempt to import &Microsoft; <application>Powerpoint</application> +files but it does not always work perfectly. It depends on the +<application>Powerpoint</application> file version and what is in the +file. You can always import pictures for the background image and +re-type any text. It's not the ideal solution, re-doing the entire +presentation. However, just bear in mind that +<application>Powerpoint</application> does not even attempt to read +&kpresenter; files.</para> + +<para>Taking notes or minutes. One piece of software allows you to +make notes during the meeting and puts them into a word +processor. If you are speaking, someone else should be taking notes. If +you really must do this sort of thing, take a note pad and pencil. + +</para> + +</chapter> diff --git a/doc/kpresenter/great-presentations.docbook b/doc/kpresenter/great-presentations.docbook new file mode 100644 index 00000000..82d4bcdc --- /dev/null +++ b/doc/kpresenter/great-presentations.docbook @@ -0,0 +1,145 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +To edit or validate this document separately, uncomment this prolog +Be sure to comment it out again when you are done --> + +<chapter id="hints-and-tips"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Neil</firstname> +<surname>Lucock</surname> +<affiliation> +<address><email>neil@nlucock.freeserve.co.uk</email></address> +</affiliation> +</author> +<author> +<firstname>Krishna</firstname> +<surname>Tateneni</surname> +<affiliation> +<address><email>tateneni@pluto.njcc.com</email></address> +</affiliation> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> +<title>General Hints and Tips for Great Presentations</title> + +<para>Okay, you've decided to use &kpresenter; for your +presentation. Before you start making transparencies or animated slide +shows, go and find a piece of paper and sit down at a desk away from +the computer. It doesn't matter whether you are doing a teaching +session or trying to convince the boss that your plan, policy or idea +should be adopted, you need to figure out what you are trying to +say. Write down all the subjects you need to cover, try to get them in +the order you think will make sense. Don't put any details in yet, +just decide on headings and the structure of your talk.</para> + +<para>Under each heading make a note of what facts you need to +cover. You are trying to build a convincing argument. Consider +grouping your facts into things must be included, things that should +be included and things that it would be nice to cover if you had +plenty of time.</para> + +<para>Once you have written down all the things you need to say, +consider the time available to do it in. Ten minutes seems ages when +you start, but it is very difficult to actually get much across in so +short a time. Get your sheet of paper and a clock with a second +hand. Practise your presentation over and over again. This has many +benefits. Firstly, you get the timing right. If someone says you have +ten minutes, never go over the allowed time. Secondly, when you +actually do it in front of a live audience, it will not be the first +time you have done that presentation. Third, you get the words right +in your own head. You will find ways of saying things about the +subject. If you've heard yourself do this presentation several times, +you will know what you are going to say next and how you are going to +say it. </para> + +<para>&kpresenter; does not produce Speaker's Notes at the time of +writing, but I am happy to just use ordinary slides. Produce some +slides for yourself, printed on plain paper, and some for use with the +Overhead Projector. Make the text on your slides nice and big, you +need to be able to read it at a distance. I use 14 or 16 point text, +experiment to find a size that you can read easily. I never write out +a script.</para> + +<para>If you are using an Overhead projector, learn how to use it +beforehand. Make sure that the bulb works, that the spare bulb is +still okay. Clean the lens and display plates. If you are not used to +working with projectors, practice. Ensure that the projection screen +itself is clean. It's probably best, when timing yourself, to allow +for five seconds (count <quote>one thousand and one, one thousand and +two....</quote>) to change each slide. That way you know you don't +have to rush. If you need to point at something on a slide, you can +use a pointer and point at the display screen, find a laser pointer or +put a pencil on the transparency itself. Be warned, these tend to roll +out of place when you nudge the table.</para> + +<para>Consider where you are going to stand. You cannot stand in +front of your display, so off to one side is probably your best option +if you want your audience to be able to see. I often project a picture +onto a wipeboard and draw over the top of it. If you are using a PC +with a digital projector you can draw over the top of your slides with +&kpresenter;'s pen tool. Remember, drawing freehand with a mouse is a +skill that needs practice. If you are using an Overhead projector, you +can use transparent overlay slides and a pen over the top of your +computer generated ones.</para> + +<para>When you are doing the presentation do not accidently look into +the light, it's easy to do. If you are not going to use the machine +for a few minutes, turn it off. Practise to get where you are going +to stand sorted out. Check the room you intend to use for electrical +sockets and learn how the blinds work and where the light switches +are. Good preparation not only makes you less likely to make mistakes +(inanimate things can be a nightmare in front of an audience) but also +gives you confidence. Always have a <quote>Plan B</quote> ready if +something refuses to work. Have a paper copy of your slides with +you. You can photocopy and distribute these to your audience if the +equipment fails.</para> + +<para>I have not said much about the content yet. At present all you +have is a piece of paper with everything you want to say on it. Before +you make anything, ask youself if their understanding of what you are +saying is going to improved by showing them a picture. Bad +presentations consist of a series of slides full of text. The +presenter then reads the slide to the audience (who have already read +it as they can read faster than someone can say it aloud). Try to +avoid writing anything on the slide, except a title and a number. Draw +a picture of what you need to say, then explain the picture to +them. That way they do not get ahead of you (they can read faster than +you can speak, remember?) and you look like you know it. You do not +know it, you are using the picture as a series of prompts. A slide +should support what you are saying, not duplicate it. A slide should +be the focus of the audience's attention, not a distraction.</para> + +<para>An example. I teach Railway staff how to respond to accidents. I +wanted to use a slide to discuss how you can move dangerous loads from +a derailed or damaged rail vehicle to a road vehicle after an +accident. The slide I made had a simple drawing of tank wagon, the +kind used for carrying gases or oils. On the side I wrote +<quote>Lethal Chemical Company</quote> so that I do not have to +explain it. I wanted to make several important points. First, you must +get any overhead electric wires turned off before you do anything if +they are within a certain distance. I drew one of the supporting +structures and drew an arrow with the safety distance on it. Then I +wanted to say that you must not transfer the wagon's contents in +darkness or thunderstorms. I drew a moon and a lightning bolt above +the vehicle. You must get specialist advice, so I drew a sheet of +paper and wrote the word <quote>Plan</quote> near the vehicle. You +also have to ensure that the vehicle does not move when the weight +inside is removed. I drew little red wedges by the wheels. Everything +I need to talk about is on this drawing. All I have to do is look at +the drawing and it tells me what I need to cover. When I have covered +all the things in the drawing, I have finished on that +subject. </para> + +<para>In general, only use a slide or picture if it shows something +that adds to what you are saying. Finally, relax and try not to rush +through it all. Talk to them, not at them and remember that a +presentation is about whatever message you are trying to get +across. &kpresenter; is a useful tool. It can help you to get that +message over, but it cannot do the job for you.</para> + +</chapter> diff --git a/doc/kpresenter/guides.docbook b/doc/kpresenter/guides.docbook new file mode 100644 index 00000000..9055bb43 --- /dev/null +++ b/doc/kpresenter/guides.docbook @@ -0,0 +1,556 @@ +<chapter id="guides"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Neil</firstname> +<surname>Lucock</surname> +<affiliation> +<address><email>neil@nlucock.freeserve.co.uk</email></address> +</affiliation> +</author> +<author> +<firstname>Krishna</firstname> +<surname>Tateneni</surname> +<affiliation> +<address><email>tateneni@pluto.njcc.com</email></address> +</affiliation> +</author> +<author> +<firstname>Brad</firstname> +<surname>Hards</surname> +<affiliation> +<address><email>bradh@frogmouth.net</email></address> +</affiliation> +</author> +<author> +<firstname>Danny</firstname> +<surname>Allen</surname> +<affiliation> +<address><email>danny@dannyallen.co.uk</email></address> +</affiliation> +</author> +<author> +<firstname>Anne-Marie</firstname> +<surname>Mahfouf</surname> +<affiliation> +<address><email>annemarie.mahfouf@free.fr</email></address> +</affiliation> +</author> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> +<title>Detailed Guides</title> + +<para>This chapter describes how to perform some common tasks in +&kpresenter;.</para> + +<sect1 id="html-wizard"> +<title>Create a <acronym>HTML</acronym> Slideshow</title> + +<para>Turn an existing presentation into standard <acronym>HTML</acronym> +pages with accompanying navigation aids.</para> + +<procedure> +<step> +<para>First, either make a new presentation, or open an existing one. Then, +click on <guimenu>File</guimenu><guimenuitem>Create HTML +Slideshow...</guimenuitem></para> + +<screenshot> +<screeninfo>File menu option to <guimenuitem>Create HTML +Slideshow...</guimenuitem></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow1.png" format="PNG"/> +</imageobject> +<textobject><phrase>File menu option to <guimenuitem>Create HTML +Slideshow...</guimenuitem></phrase></textobject> +</mediaobject> +</screenshot> +</step> + +<step> +<para>A dialog box asks if you want to use a previously saved +configuration:</para> + +<screenshot> +<screeninfo>Previous configuration dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow2.png" format="PNG"/> +</imageobject> +<textobject><phrase>Previous configuration dialog</phrase></textobject> +</mediaobject> +</screenshot> + +<para>Click <guibutton>No</guibutton> if this is the first time that you have +used this feature, or if you want to alter specific options. The +<guibutton>Yes</guibutton> option allows you to use details that you have +previously entered for your <acronym>HTML</acronym> slideshow, so that you can +quickly create the slideshow without needing to adjust the options.</para> +</step> + +<step> +<para>You will then get a dialog box asking for a few details:</para> + +<screenshot> +<screeninfo>Fill in the details for your <acronym>HTML</acronym> +slideshow</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow3.png" format="PNG"/> +</imageobject> +<textobject><phrase>Fill in the details for your <acronym>HTML</acronym> +slideshow</phrase></textobject> +</mediaobject> +</screenshot> + +<para>Fill in each field (the dialog takes the informations from &kcontrol; if they exist) and ensure that the path details are correct, as this +is where &kpresenter; will save your new <acronym>HTML</acronym> files +and pictures. Click on the <guibutton>Next</guibutton> when you are +done.</para> + +<para>If the path you select at this stage does not exist, &kpresenter; will +ask if you would like to create it.</para></step> + +<step> +<para>Now you can configure the specific <acronym>HTML</acronym> options:</para> + +<screenshot> +<screeninfo>Fill in additional details for your <acronym>HTML</acronym> +slideshow</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow4.png" format="PNG"/> +</imageobject> +<textobject><phrase>Fill in additional details for your <acronym>HTML</acronym> +slideshow</phrase></textobject> +</mediaobject> +</screenshot> + +<para>Here, the encoding and format details can be changed, along with +the zoom level of the slides. For example, if you originally designed your +slides to display full screen on a 1280 x 1024 resolution screen, you could +scale the slides to 50% to enable them to be easily viewed in a much smaller web +browser window.</para> + +<para>In most cases, the defaults will be fine, and you can safely press the +<guibutton>Next</guibutton> to continue to the next page.</para> +</step> + +<step> +<para>Now you can customize the colors of the web pages:</para> + +<screenshot> +<screeninfo>Setting up the display style for your <acronym>HTML</acronym> +slideshow</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow5.png" format="PNG"/> +</imageobject> +<textobject><phrase>Setting up the display style for your +<acronym>HTML</acronym> +slideshow</phrase></textobject> +</mediaobject> +</screenshot> + +<para>When &kpresenter; creates the web pages for you, the text colors +for the navigation aids will follow whatever you set here. To change any of +these colors, click the colored bar next to the corresponding text label. The +colors used in your actual slides will be unchanged.</para> + +<tip><para>Choose colors that are complementary to the contents of your +presentation.</para></tip> +</step> + +<step><para>The <guibutton>Next</guibutton> button presents a dialog box +that allows you to change the name used on the <acronym>HTML</acronym> page for +each slide:</para> + +<screenshot> +<screeninfo>Setting the slide names</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow6.png" format="PNG"/> +</imageobject> +<textobject><phrase>Setting the slide names</phrase> +</textobject> +</mediaobject> +</screenshot> +</step> + +<step> +<para>If your presentation was intended to be displayed in an unattended manner +(&ie; automatic advance to next slide, &etc;), you can also make your +<acronym>HTML</acronym> +presentation counterpart exhibit the same behavior:</para> + +<screenshot> +<screeninfo>Unattended presentations</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow7.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>Unattended presentations</phrase></textobject> +</mediaobject> +</screenshot> + +<para>Here, you can force the slide to advance to the next after a specified +amount of time, and also make the presentation return to the start once it +reaches the end.</para> +</step> + +<step> +<para>Now it is time to actually produce your <acronym>HTML</acronym> +presentation, the progress of +which is shown in this dialog box:</para> + +<screenshot> +<screeninfo>Saving your configuration</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow8.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>Saving your configuration</phrase></textobject> +</mediaobject> +</screenshot> + +<para>Finally, you can save the configuration you have just used before you +close the dialog box by pressing the <guibutton>Save +Configuration...</guibutton> button. +</para> +</step> + +<step><para>What we now have are the newly-produced <filename>html/</filename> +and <filename>pics/</filename> folders, +created where we earlier set the path:</para> + +<screenshot> +<screeninfo>The newly created <acronym>HTML</acronym> slideshow +folders</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="htmlshow9.png" format="PNG"/> +</imageobject> +<textobject><phrase>The newly created <acronym>HTML</acronym> slideshow +folders</phrase></textobject> +</mediaobject> +</screenshot> +</step> +</procedure> + +<para>There is also an <filename>index.html</filename> file to launch +your web slideshow.</para> + +<para>You can see how it works by using your file manager or web +browser to open the <filename>index.html</filename> file. Click where prompted, +and the first slide of your presentation is displayed. It will now behave as a +&kpresenter; slideshow.</para> + +<para>Each click on the arrow icons take you to the next or previous slide. +To get back to the start of the slideshow click on the slide icon.</para> + +<tip><para>To share your presentation with the world, transfer the +newly-produced files to a network-accessible location (&ie; webspace), +remembering to keep the directory structure intact.</para></tip> +</sect1> + +<sect1 id="ms-export"> +<title>Exporting &kpresenter; presentations to a <trademark>Memory +Stick</trademark></title> +<para> +Some Sony projectors have the ability to run a presentation directly +from a <trademark>Memory Stick</trademark>, without needing to connect a +computer up to the projector. &kpresenter; can export presentations to the +format required by these projectors, and this tutorial will show you how to +export your presentation. +</para> + +<para> +Each exported slideshow consists of a series of image files (one for +each slide in the original presentation, plus two title slides) and an +index file. They are created in a fairly complex directory structure +that allows more than one presentation to be stored on a single memory +stick. A simple example is shown below, consisting of two +presentations. +</para> + +<mediaobject id="ms-export-directory-structure"> +<imageobject> +<imagedata format="PNG" fileref="msexport4.png"/> +</imageobject> +<textobject><phrase><trademark>Memory Stick</trademark> directory +structure</phrase></textobject> +</mediaobject> + +<procedure> + + +<step> +<para> +If the presentation that you want to export is not already open, go to +<guimenu>File</guimenu><guimenuitem>Open...</guimenuitem> and select the +presentation that you want to export. +</para> +</step> + +<step> +<para> +Now, select the <guimenu>File</guimenu> menu and choose <guimenuitem>Create +Memory Stick Slideshow...</guimenuitem>. +</para> + +<screenshot> +<screeninfo>The &kpresenter; <guimenuitem>Create Memory Stick +Slideshow...</guimenuitem> menu selection.</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="msexport1.png"/> +</imageobject> +<textobject><phrase>The &kpresenter; <guimenuitem>Create Memory Stick +Slideshow...</guimenuitem> menu selection.</phrase></textobject> +</mediaobject> +</screenshot> +</step> + +<step> +<para> +This will bring up the <guilabel>Create Memory Stick +Slideshow</guilabel> dialog.</para> + +<screenshot> +<screeninfo>The &kpresenter; <guilabel>Create Memory Stick +Slideshow</guilabel> dialog.</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="msexport2.png"/> +</imageobject> +<textobject><phrase>The &kpresenter; <guilabel>Create Memory Stick +Slideshow</guilabel> dialog.</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +The <guilabel>Path</guilabel> is the directory in which your presentation will +be exported to as directories (<filename>DCIM</filename> and +<filename>MSSONY</filename>, see the <link +linkend="ms-export-directory-structure">directory structure +diagram</link> above) will be created. If you are able to, you may wish to export +directly +to the <trademark>Memory Stick</trademark>, in which case you would enter the +location of the medium here. +</para> + +<para> +The <guilabel>Title</guilabel> is used for both the name of the index +file, and as a text label on the title slide. Note that this title +does not affect the titles on any of the normal presentation slides - +the title slide is visible using the Sony projector setup prior to +starting the actual presentation display. +</para> + +<para>Select the <guibutton>Set Colors</guibutton> option to expand the +dialog:</para> + +<screenshot> +<screeninfo>The &kpresenter; <guilabel>Create Memory Stick +Slideshow</guilabel> dialog (extended).</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="msexport2b.png"/> +</imageobject> +<textobject><phrase>The &kpresenter; <guilabel>Create Memory Stick +Slideshow</guilabel> dialog (extended).</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +These two color selectors are only used for the title slide. It +can be useful to change the title slides to make the presentations +easier to identify when working on the projector, though it is perfectly safe to +leave them as default. +</para> + +<para> +You can then press the <guibutton>OK</guibutton> button to proceed with the +actual export process. +</para> +</step> + +<step> + +<para> +Your presentation will now be exported into the correct format, with the +following dialog informing you of the progress of this process: +</para> + +<screenshot> +<screeninfo>The &kpresenter; <guilabel>Create Memory Stick +Slideshow</guilabel> progress dialog.</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="msexport3.png"/> +</imageobject> +<textobject><phrase>The &kpresenter; <guilabel>Create Memory Stick +Slideshow</guilabel> progress dialog.</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +When the export is complete, you can select the +<guibutton>Done</guibutton> button, and the dialog will close. +</para> +</step> + +<step> +<para> +If you did not export the slideshow directly onto a <trademark>Memory +Stick</trademark>, you will need to copy the correct files onto the +<trademark>Memory +Stick</trademark> before you can utilise the projector. As noted above, +you need to copy over the correct directories and files starting at +<filename>DCIM</filename> and <filename>MSSONY</filename> into the +"root", or <filename>/</filename> of the <trademark>Memory Stick</trademark>. It +is +critical that the directory structure is maintained, and you may +find it easier to copy the whole of <filename>DCIM</filename> and +<filename>MSSONY</filename> directories. +</para> + +<para> +If necessary, you can safely rename the index file (which is +<filename>Slideshow.SPP</filename> by default), however you cannot +rename the slide images, nor can you change the name of these directories, +as these are encoded into the index file. +</para> +</step> + +</procedure> + +</sect1> + +<sect1 id="creating-templates"> +<title>Creating &kpresenter; Templates</title> + +<para>It is very easy to add new templates to &kpresenter;'s library.</para> + +<para>If you have made a presentation in a style that you would like to use +again, you can save it as a template.</para> + +<para>This tutorial will show how we can make a new template and save +it.</para> + +<procedure> +<step> +<para>Open &kpresenter; and create a new document.</para> +</step> + +<step> +<para>To add a little sparkle to the blank slide, we can change the slide +background - do this by either going to <guimenu>Format</guimenu> > +<guimenuitem>Slide Background...</guimenuitem>, or by selecting the same item +from the &RMB; menu:</para> + +<screenshot> +<screeninfo>The &kpresenter; <guilabel>Slide Background</guilabel> +dialog.</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="template02.png"/> +</imageobject> +<textobject><phrase>The &kpresenter; <guilabel>Slide Background</guilabel> +dialog.</phrase></textobject> +</mediaobject> +</screenshot> + +<para>We want the background to look attractive, so let's add a background +gradient by using the drop-down menu, and then selecting the gradient colors by +clicking the colored boxes. Of course, you may choose to use an image as a +background by clicking the <guilabel>Picture</guilabel> tab: feel free to +experiment, but keep it beautiful!</para> + +<screenshot> +<screeninfo>Choosing a slide background</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="template03.png"/> +</imageobject> +<textobject><phrase>Choosing a slide background</phrase></textobject> +</mediaobject> +</screenshot> +</step> + +<step> +<para>The page should now have the background you desire. Create a text box, and +type a heading for your slide:</para> + +<screenshot> +<screeninfo>Adding a Heading to the new template</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="template04.png" format="PNG"/> +</imageobject> +<textobject><phrase>Adding a Heading to the new template</phrase></textobject> +</mediaobject> +</screenshot> + +<para>When you are happy with your template, go to <menuchoice><guimenu>File</guimenu> +<guimenuitem>Template Manager</guimenuitem></menuchoice>:</para> + +<screenshot> +<screeninfo><guimenu>File</guimenu><guimenuitem>Template +Manager</guimenuitem></screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="template05.png" format="PNG"/> +</imageobject> +<textobject><phrase><guimenu>File</guimenu><guimenuitem>Template +Manager</guimenuitem></phrase></textobject> +</mediaobject> +</screenshot> + +<para>This dialog box allows you to select where you would like your template to +be saved:</para> + +<screenshot> +<screeninfo>Saving the new template</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="template06.png" format="PNG"/> +</imageobject> +<textobject><phrase>Saving the new template</phrase></textobject> +</mediaobject> +</screenshot> + +<para>I highly recommend that you save the template in the <guilabel>Screen +Presentations</guilabel> group. You may call it whatever you wish, in this case, +my template is named <userinput>Tutorial_Template</userinput>. Once you are +happy with the settings, press <guibutton>OK</guibutton> to add your custom +template to the template collection.</para> +</step> + +<step> +<para>You can now close the document you have been working on (there is no need +to save it). The next time you are presented with the startup +dialog, your very own template will be available to select!</para> + +<screenshot> +<screeninfo>Your new template in the &kpresenter; startup +dialog.</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="template07.png" format="PNG"/> +</imageobject> +<textobject><phrase>Your new template in the &kpresenter; +startup dialog.</phrase></textobject> +</mediaobject> +</screenshot> +</step> +</procedure> + +</sect1> + +</chapter> diff --git a/doc/kpresenter/htmlshow1.png b/doc/kpresenter/htmlshow1.png Binary files differnew file mode 100644 index 00000000..a9f8a4e8 --- /dev/null +++ b/doc/kpresenter/htmlshow1.png diff --git a/doc/kpresenter/htmlshow2.png b/doc/kpresenter/htmlshow2.png Binary files differnew file mode 100644 index 00000000..ba52b6ad --- /dev/null +++ b/doc/kpresenter/htmlshow2.png diff --git a/doc/kpresenter/htmlshow3.png b/doc/kpresenter/htmlshow3.png Binary files differnew file mode 100644 index 00000000..c4876d15 --- /dev/null +++ b/doc/kpresenter/htmlshow3.png diff --git a/doc/kpresenter/htmlshow4.png b/doc/kpresenter/htmlshow4.png Binary files differnew file mode 100644 index 00000000..49da99b6 --- /dev/null +++ b/doc/kpresenter/htmlshow4.png diff --git a/doc/kpresenter/htmlshow5.png b/doc/kpresenter/htmlshow5.png Binary files differnew file mode 100644 index 00000000..c69ec431 --- /dev/null +++ b/doc/kpresenter/htmlshow5.png diff --git a/doc/kpresenter/htmlshow6.png b/doc/kpresenter/htmlshow6.png Binary files differnew file mode 100644 index 00000000..9db24bc7 --- /dev/null +++ b/doc/kpresenter/htmlshow6.png diff --git a/doc/kpresenter/htmlshow7.png b/doc/kpresenter/htmlshow7.png Binary files differnew file mode 100644 index 00000000..d7011cfe --- /dev/null +++ b/doc/kpresenter/htmlshow7.png diff --git a/doc/kpresenter/htmlshow8.png b/doc/kpresenter/htmlshow8.png Binary files differnew file mode 100644 index 00000000..6fb56df5 --- /dev/null +++ b/doc/kpresenter/htmlshow8.png diff --git a/doc/kpresenter/htmlshow9.png b/doc/kpresenter/htmlshow9.png Binary files differnew file mode 100644 index 00000000..39e9270c --- /dev/null +++ b/doc/kpresenter/htmlshow9.png diff --git a/doc/kpresenter/index.docbook b/doc/kpresenter/index.docbook new file mode 100644 index 00000000..79ac6913 --- /dev/null +++ b/doc/kpresenter/index.docbook @@ -0,0 +1,267 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY package "koffice"> + <!ENTITY kappname "&kpresenter;"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY tutorial SYSTEM "tutorial.docbook"> + <!ENTITY screen SYSTEM "screen.docbook"> + <!ENTITY guides SYSTEM "guides.docbook"> + <!ENTITY great SYSTEM "great-presentations.docbook"> + <!ENTITY menus SYSTEM "menus.docbook"> + <!ENTITY options SYSTEM "options.docbook"> + <!ENTITY a11y SYSTEM "a11y.docbook"> + <!ENTITY faq SYSTEM "faq.docbook"> + <!ENTITY % English "INCLUDE" > <!-- change language only here --> +]> + +<book lang="&language;"> +<bookinfo> +<title>The &kpresenter; Handbook</title> + +<authorgroup> +<author> +<firstname>Neil</firstname> +<surname>Lucock</surname> +<affiliation> +<address><email>neil@nlucock.freeserve.co.uk</email></address> +</affiliation> +</author> + +<author> +<firstname>Krishna</firstname> +<surname>Tateneni</surname> +<affiliation> +<address><email>tateneni@pluto.njcc.com</email></address> +</affiliation> +</author> + +<author> +<firstname>Anne-Marie</firstname> +<surname>Mahfouf</surname> +<affiliation> +<address><email>annemarie.mahfouf@free.fr</email></address> +</affiliation> +</author> + +<author> +<firstname>Gary</firstname> +<surname>Cramblitt</surname> +<affiliation> +<address><email>garycramblitt@comcast.net</email></address> +</affiliation> +</author> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<date>2006-11-22</date> +<releaseinfo>1.6</releaseinfo> + +<copyright> +<year>1999</year><year>2000</year> +<holder>Krishna Tateneni</holder> +</copyright> + +<copyright> +<year>2001</year><year>2002</year> +<holder>Neil Lucock</holder> +</copyright> + +<copyright> +<year>2005</year> +<holder>Anne-Marie Mahfouf</holder> +</copyright> + +<copyright> +<year>2006</year> +<holder>Gary Cramblitt</holder> +</copyright> + +<legalnotice>&FDLNotice;</legalnotice> + +<abstract> +<para> +&kpresenter; is the presentations program in the &koffice; suite of +productivity applications. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>KPresenter</keyword> +<keyword>KOffice</keyword> +<keyword>Graphics</keyword> +<keyword>Presentations</keyword> +</keywordset> + +</bookinfo> + +<chapter id="introduction"> +<title>Introduction</title> + +<important> <para>Please check <ulink +url="http://docs.kde.org/en/HEAD/koffice/kpresenter/">http://docs.kde.org</ulink> +for updated versions of this document.</para></important> + +<para> +&kpresenter; is the presentations program in the &koffice; productivity +suite. Using &kpresenter;, you can prepare a set of slides for use in an +on-screen slideshow or for printing. Your slides can include text and +graphics in a variety of formats, and of course, you can embed all sorts +of objects using KParts. +</para> + +<para> +The &koffice; productivity suite consists of a number of applications +which are designed to work together. Overview documentation for +&koffice; is available, as well as manuals for each component of the +suite. The components of &koffice; are: +</para> + +<itemizedlist> +<listitem> +<para> +&kword; - a frames based wordprocessor. +</para> +</listitem> + +<listitem><para> +&kspread; - a spreadsheet application. +</para> +</listitem> + +<listitem> +<para> +&kpresenter; - a presentations application. +</para> +</listitem> + + +<listitem> +<para> +&kformula; - an editor for mathematical formulae. +</para> +</listitem> + +<listitem> +<para> +&kchart; - an application to draw charts and diagrams. +</para> +</listitem> + + +</itemizedlist> + +<para> +&koffice; is a free (or open-source) software project which is +released under the terms of the &GNU; General Public +License. +</para> + +</chapter> + +&tutorial; + +&screen; + +&guides; + +&great; + +&menus; + +&options; + +&a11y; + +&faq; + +<chapter id="credits"> +<title>Credits and License</title> + +<para> +&kpresenter; +</para> + +<para> +Program copyright 1998-2000 by Reginald Stadlbauer +<email>reggie@kde.org</email> +</para> + +<para> +Current maintainer is Laurent Montel <email>montel@kde.org</email>. +</para> + + +<itemizedlist> +<title>Contributors</title> + +<listitem> +<para> +Werner Trobin <email>trobin@kde.org</email>. +</para> +</listitem> + +<listitem> +<para> +David Faure <email>dfaure@kde.org</email> +</para> +</listitem> + +<listitem> +<para> +Toshitaka Fujioka <email>fujioka@kde.org</email> +</para> +</listitem> + +<listitem> +<para> +Lukáš Tinkl <email>lukas@kde.org</email> +</para> +</listitem> + +<listitem> +<para> +Thorsten Zachmann <email>t.zachmann@zagge.de</email> +</para> +</listitem> + +<listitem> +<para> +Ariya Hidayat <email>ariya@kde.org</email> +</para> +</listitem> + +<listitem> +<para> +Percy Leonhardt <email>percy@eris23.de</email> +</para> +</listitem> +</itemizedlist> + +<para> +Documentation based on the work copyright 1999-2000 by Krishna +Tateneni. Portions are copyright 2000-2002 Neil Lucock +<email>neil@nlucock.freeserve.co.uk</email> +and 2005 Anne-Marie Mahfouf <email>annemarie.mahfouf@free.fr</email> +</para> + +<!-- TRANS:CREDIT_FOR_TRANSLATORS --> +&underFDL; +&underGPL; + +</chapter> + +<appendix id="installation"> +<title>Installation</title> + +&install.intro.documentation; + +&install.compile.documentation; + +</appendix> + +&documentation.index; + +</book> + diff --git a/doc/kpresenter/kbd-focus-ext.png b/doc/kpresenter/kbd-focus-ext.png Binary files differnew file mode 100644 index 00000000..1135bb70 --- /dev/null +++ b/doc/kpresenter/kbd-focus-ext.png diff --git a/doc/kpresenter/link.png b/doc/kpresenter/link.png Binary files differnew file mode 100644 index 00000000..9c12b06e --- /dev/null +++ b/doc/kpresenter/link.png diff --git a/doc/kpresenter/menus.docbook b/doc/kpresenter/menus.docbook new file mode 100644 index 00000000..52d29d6e --- /dev/null +++ b/doc/kpresenter/menus.docbook @@ -0,0 +1,2066 @@ +<!-- <?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" +"dtd/kdex.dtd"> + +To edit or validate this document separately, uncomment this prolog +Be sure to comment it out again when you are done --> + +<chapter id="menu-items"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Neil</firstname> +<surname>Lucock</surname> +<affiliation> +<address><email>neil@nlucock.freeserve.co.uk</email></address> +</affiliation> +</author> +<author> +<firstname>Krishna</firstname> +<surname>Tateneni</surname> +<affiliation> +<address><email>tateneni@pluto.njcc.com</email></address> +</affiliation> +</author> +<author> +<firstname>Anne-Marie</firstname> +<surname>Mahfouf</surname> +<affiliation> +<address><email>annemarie.mahfouf@free.fr</email></address> +</affiliation> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> +<title>The Menu and Toolbar Items</title> + +<para>&kpresenter; presents different types of interfaces for you to interact +with the program. Perhaps the most familiar type of interface is the +menu which appears on the top of the &kpresenter; window.</para> + +<para>Clicking on the menu items gives you a list of commands from which you +can choose the one you want. Many of the commands can also be accessed +directly by holding down &Ctrl; or &Alt; and pressing another key on +your keyboard. In the next section, each of the menu commands is +described in brief.</para> + +<sect1 id="toolbars"> +<title>The Toolbars</title> + +<sect2 id="manipulating-toolbars"> +<title>Manipulating the Toolbars</title> + +<para>In addition to the menus, &kpresenter; also has a set of toolbars. Each +toolbar consists of a collection of icons. A toolbar icon often presents +a convenient shortcut to a command that is found in one of the menus.</para> + +<screenshot> +<screeninfo>The toolbars</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="barstyle1.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>The toolbars</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para>You can move the toolbar around by dragging the handle, shown here in red. Toolbars can +be <quote>docked</quote> or attached to any side of the &kpresenter; +window. If you like, you can also have the toolbar <quote>float</quote> in +its own window, separated from the main &kpresenter; window as shown in the +screenshot below:</para> + +<screenshot> +<screeninfo>Floating toolbar</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="barstyle3.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>Floating toolbar</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para> If you don't like dragging toolbars around, +<mousebutton>right</mousebutton> click on the handle and a menu pops up as shown +in the screenshot below: </para> + +<screenshot> +<screeninfo>Toolbar context menu</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="barstyle4.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>Toolbar context menu</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para> +The first few items in the popup menu have to do with the placement of +the toolbar. You can choose any of the four sides of the &kpresenter; +window, or have the toolbar <quote>float</quote> in a separate +window. Choosing <guimenuitem>Flat</guimenuitem> hides the toolbar. +To unflat a hidden toolbar, &LMB; click on its handle. + + +</para> + +<para> +Choosing the next item in the menu, <guisubmenu>Text Position</guisubmenu>, leads +to an additional menu which lets you control the appearance of the items +in toolbar. This additional cascading menu is shown in the screenshot +below: +</para> + +<screenshot> +<screeninfo>The toolbar modes menu</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="barstyle5.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>The toolbar modes menu</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para> +The default view of the toolbar is icons only. In this view, if you +don't know what a particular icon means, you can hold the mouse over the +icon, and after a second or so, a little hint pops up in a highlighted +text box as shown in the screenshot below: +</para> + +<screenshot> +<screeninfo>Tooltips</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="barstyle6.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>Tooltips</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para> +You can choose to display the toolbar items as text instead of icons, or +even to combine both icons and text. If you want both text and icons, +the cascading menu allows you to select whether the text appears beside +the icons or below them. All four styles of displaying toolbar items are +shown in the screenshot below: +</para> + +<screenshot> +<screeninfo>The toolbar styles</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="barstyle7.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>The toolbar styles</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para> +The &kpresenter; menus are discussed in the following sections. +</para> + +</sect2> +</sect1> + +<sect1 id="file-menu"> +<title><guimenu>File</guimenu> Menu</title> + +<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>Begins a new presentation.</action> The +startup dialog will open, allowing you to choose a +template for your presentation. +</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 an existing presentation.</action> A standard &kde; file +open dialog will appear, allowing you to choose a file to open. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guisubmenu>Open Recent</guisubmenu> +</menuchoice> +</term> +<listitem> +<para> +<action>Displays a list of recently opened files for you to choose +from.</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 currently open presentation.</action> If you have not +previously saved it, you will be asked to name the file. If you have +previously saved the presentation, it will be resaved with the same name. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Save As...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para> +<action>Saves the currently open presentation with a new name.</action> +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Reload</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Reload the currently active file. +<!-- FIXME: What's a situation when you might want to do this? --> +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Import...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Import a presentation that was previously created in +one of several common formats.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Export...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Export the currently open presentation to one of several common +formats for use in another application, or for exchange with someone +who does not have access to &kpresenter;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Mail...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Open</action> a new email message in your selected email client with the current &kpresenter; document attached. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Create HTML Slideshow...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para> +<action>Starts the HTML wizard</action>, which is described in the +section <xref linkend="html-wizard"/>. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Create Memory Stick Slideshow...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para> +<action>Starts the Memory Stick dialog</action>, which is described in the +section <xref linkend="ms-export"/>. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Template Manager</guimenu> +</menuchoice> +</term> +<listitem> +<para><action>Allows you to save the current slide as a +template.</action> In future the template will be available for you to +use to build slides with. Creating a template is further discussed in +section <xref linkend="creating-templates"/>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Use Current Slide as Default Template</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Sets the current slide as your default template</action>. +Especially useful if you have created a template of your own to fit into +corporate style guidelines, or if you just use a particular layout very +often.</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 presentation</action>. More precisely, it opens the +print settings dialog, where you can adjust the settings before printing +your presentation.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Print Preview...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Displays the presentation</action> with a &PostScript; viewer, +exactly as it would look if printed.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>File</guimenu> +<guimenuitem>Document Information</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Allows you to enter information about the document.</action> +This includes information about the author, and an abstract on the +documents contents.</para> +</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>Close the current presentation.</action> You will be given an +opportunity to save any changes first.</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>Close</action> &kpresenter;. You will be given an opportunity +to save all changes in all open presentations first.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="edit-menu"> +<title><guimenu>Edit</guimenu> Menu</title> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Undo: <replaceable>Last task</replaceable></guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Undo the last action you performed.</action></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Redo: <replaceable>Last undone +task</replaceable></guimenuitem> +</menuchoice></term> +<listitem> +<para><action>Redo the last action you undid.</action> If you have not undone +any actions, or the last undo action is not reversible, this menu item +is disabled.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycombo +action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Cut</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Copy the selected item to the clipboard, and remove it from the +document.</action></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Copy</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Copy the selected item to the clipboard, while leaving it intact +in your presentation.</action></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Paste</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Insert the contents of the clipboard into your +presentation.</action></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>Delete</keycap></keycombo></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Delete</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Remove the currently selected item from your +presentation.</action></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Select All</guimenuitem> +</menuchoice></term> +<listitem> +<para> +<action>Select all the objects and text on the current slide.</action> +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Deselect</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Deselect any currently selected objects.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut> +<guimenu>Edit</guimenu> +<guimenuitem>Find...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para> +<action>Search for text within the presentation.</action> +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycap>F3</keycap> +</shortcut> +<guimenu>Edit</guimenu><guimenuitem>Find Next</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Find the next occurrence of a piece of text within a presentation.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu><guimenuitem>Find Previous</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Find the previous occurrence of a piece of text within a +presentation.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> +</shortcut> +<guimenu>Edit</guimenu><guimenuitem>Replace...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Replace one or more occurrences of a piece of text in +your presentation with a different piece of text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Copy Slide</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Copy the current slide to the clipboard.</action></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Duplicate Slide</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Insert an exact copy of the current slide.</action></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Delete Slide</guimenuitem> +</menuchoice></term> +<listitem> +<para><action>Delete the current page from the presentation.</action> You +will be asked to confirm this action.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Edit</guimenu> +<guimenuitem>Duplicate Object...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Create a duplicate of the currently selected object. A dialog will +display allowing you to set some options for the duplicate, ⪚ if it +should be rotated, or scaled, or offset to a new position on the +slide.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="view-menu"> +<title><guimenu>View</guimenu> Menu</title> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>New View</guimenuitem> +</menuchoice></term> +<listitem> +<para><action>Opens another window with the same presentation loaded</action> +so you can work on more than one slide at a time.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;&Shift;<keycap>W</keycap></keycombo></shortcut> +<guimenu>View</guimenu> +<guimenuitem>Close All Views</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Close all views on the presentation.</action> You will be given +a chance to save any changes, or to cancel closing.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Split View</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Splits the window into two (or more) views on the same +presentation.</action> The default split is horizontal.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Remove View</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Close only the currently active view</action>. The +presentation, and any other views you have open, remain open, and any +changes you have made remain unsaved.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guisubmenu>Splitter Orientation</guisubmenu> +</menuchoice> +</term> +<listitem> +<para><action>Toggle the split view</action> between +<guimenuitem>Horizontal</guimenuitem> (the default) and +<guimenuitem>Vertical</guimenuitem>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Show Sidebar</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Toggle the display of the sidebar</action> where you can +see an overview of all the slides in your presentation.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Show Notebar</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Toggle the display of the notebar</action> where you can +see an overview of all the notes in your presentation.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Slide Master</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Toggle the display of the slide master</action> where you can put objects that you want to appear on each slide in your presentation.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Formatting Characters</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Show a visual representation of <quote>non-printing +characters</quote>, such as tabs and paragraph markers. This can be +a useful aid to precisely positioning text.</para> + +<para>This item can be toggled. If enabled, formatting characters are +visible; if disabled, they are not.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Guide Lines</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>When working in &kpresenter; you can drag a <quote>guide +line</quote> from either the horizontal or vertical ruler onto your +document. This guide-line will not print or display in the finished +presentation, it is simply to help you align objects on screen. If +this item is enabled, these guide lines will be visible. If this is +disabled, they will not be visible.</para> + +<para>Guide lines work across slides, allowing you to align objects the +same way across multiple slides.</para> + +<para>Disabling (hiding) guide lines does not delete them. If you have +created guide lines, and then disabled this item, enabling it again +will retain the guide lines you created.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Add Guide Line...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para> +Opens a dialog to select the <guilabel>Orientation</guilabel> +(<guilabel>Horizontal</guilabel> or <guilabel>Vertical</guilabel>) +and choose a <guilabel>Position:</guilabel> +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guimenuitem>Show/Hide Grid</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>If enabled, &kpresenter; will display a grid of dots +representing the intersections of imaginary horizontal and vertical +lines. You can use these dots to precisely position objects on the +slide.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><menuchoice><guimenu>View</guimenu><guimenuitem> +Snap to Grid</guimenuitem></menuchoice> +</term> +<listitem><para>If this is enabled, when dropping or moving objects on the +slide the top left corner of the object will <quote>snap</quote> or +move, to the nearest grid point.</para> +<para>This does reduce your freedom to freely position objects on the +slide, however it also helps to line up objects precisely. It is +easily disabled or enabled with this menu entry, allowing you the best +of both worlds.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>View</guimenu> +<guisubmenu>Zoom</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>This submenu allows you to zoom in or out of the +slide. Several predefined zoom levels are available, including +<guimenuitem>Whole Slide</guimenuitem> to scale the entire slide so as +to be visible in the size window you have open, and +<guimenuitem>Width</guimenuitem> to scale the slide so it fills the +entire width of the window, although you may now have to scroll +vertically. There are also several other scaling choices, from +<guimenuitem>33%</guimenuitem> up to +<guimenuitem>500%</guimenuitem>.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="insert-menu"> +<title><guimenu>Insert</guimenu> Menu</title> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Alt;&Shift;<keycap>C</keycap></keycombo> +</shortcut> +<guimenu>Insert</guimenu> +<guimenuitem>Special Character...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Insert a special character. This might be a character +you don't have a key for on your keyboard layout, for instance ü +on a US Keyboard.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu> +<guisubmenu>Variable</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>Here you can insert a variable that is filled in with a +value that may be updated as you update the document.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu> +<guimenuitem>Link...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Insert a hyperlink to a file, a website, or an email +address. This enables these locations to be linked to directly from within active presentations, with resources being handled as appropriately by other applications installed on your system.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu> +<guimenuitem>Comment...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Enter a small note that does not display during the +real presentation. You might use this to comment on a colleague's +text, or to leave a note for yourself about something to do +later.</para> +<!-- FIXME: How do you display these again? --> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycap>F2</keycap></shortcut> +<guimenu>Insert</guimenu> +<guimenuitem>Slide...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para> +<action>Add a new page to your presentation.</action> A dialog will open +allowing you to choose a template, and whether to insert the new page +before or after the currently selected page. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu><guimenuitem>File...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Insert an already existing presentation.</action> A standard &kde; file +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> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycap>F10</keycap></shortcut> +<guimenu>Insert</guimenu><guimenuitem>Text</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Add a new text object. Click and drag to create a frame where +you wish the text to appear.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu> +<guimenuitem>Chart</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Insert a chart. Click and drag to define the size of the +chart. Some default data will be displayed. Double click to edit the +data and choose the type of chart to display, using the embedded +&kchart; editor.</para> + +<!--<para>FIXME: KChart has it's own help file, but a brief overview of +charting in this doc wouldn't go astray either.</para>--> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycap>F5</keycap></shortcut> +<guimenu>Insert</guimenu><guimenuitem>Table</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Insert a table. Click and drag to define the size of +the table.</para> + +<para>A &kspread; open dialog will display. You may import a +spreadsheet that you have saved in one of many formats, including +plain text files. You may also choose to create a new and empty +table.</para> + +<para>Double clicking on the table will allow you to edit the +contents.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu> +<guisubmenu>Object</guisubmenu> +</menuchoice> +</term> +<listitem> +<!--<para>FIXME: This needs a section of it's own</para>--> + +<para>An object is an embeddable file, in one of many formats.</para> + +<para>A common use of this action is to insert scaleable clipart in +vector format.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Shift;<keycap>F5</keycap></keycombo> +</shortcut> +<guimenu>Insert</guimenu> +<guimenuitem>Picture...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Insert a raster image.</action> These are not as easily +scaleable as vector images or <quote>clipart</quote>. &kpresenter; +currently understands many formats, including <literal +role="extension">.tiff</literal>, <literal +role="extension">.jpg</literal>, <literal +role="extension">.png</literal> and many more.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu> +<guisubmenu>Line</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>You can insert several types of lines. Line drawing is described +further in the drawing tools<!-- FIXME: Make a drawing tools section --> section.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu> +<guisubmenu>Shape</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>You can insert several prepared shapes, in vector format. These are +editable just like lines you have drawn yourself. Using the drawing +tools is described in detail in the drawing tools +section.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Insert</guimenu> +<guimenuitem>Scan Image...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Scan an image with a scanner.</action> This requires you have a +scanner installed. It opens the <guilabel>Acquire Image</guilabel> dialog to allow the use of the scanner.<!--FIXME: Document how to set up a scanner that &kpresenter; can +use.--></para> +</listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="format-menu"> +<title><guimenu>Format</guimenu> Menu</title> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Select</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>If you have been using a tool such as the line drawing tool which does +not allow you to select other objects, you can use this menu item to +return to the normal selection cursor.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Rotate</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Changes the cursor to a double headed curved arrow. Click with the &LMB; onto an object +and keep the button pressed.Drag with the cursor to rotate the object on the slide around its center. When you are +happy with the position of the object, release the mousebutton to stop +rotating.</para> + +<para>If you change your mind and wish to cancel the rotation, use +<menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem> +</menuchoice> to later undo it.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Zoom</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Allow you to zoom in or out in the current slide. You can see the zoom factor in the <guilabel>Edit</guilabel> toolbar, in the zoom indicator.</para> +<screenshot> +<screeninfo>The <guilabel>zoom factor</guilabel> indicator</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="zoomfactor.png"/> +</imageobject> +<textobject> +<phrase>The <guilabel>zoom factor</guilabel> indicator</phrase> +</textobject> +</mediaobject> +</screenshot> +<para>Left clicking on the slide will <guimenuitem>Zoom In</guimenuitem>. Right clicking on the current slide will present you a menu to allow you to <guimenuitem>Zoom In</guimenuitem>, to <guimenuitem>Zoom Out</guimenuitem>, to <guimenuitem>Zoom Entire Slide</guimenuitem>, to <guimenuitem>Zoom Slide Width</guimenuitem> or <guimenuitem>Zoom Slide Height</guimenuitem>, to <guimenuitem>Zoom Selected Objects</guimenuitem> or <guimenuitem>Zoom All Objects</guimenuitem> which put back all objects in your view. +</para> +<para>This action has the same effect as <menuchoice><guimenu>View</guimenu><guimenuitem>Zoom</guimenuitem> +</menuchoice> on another form.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Properties</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Open</action> the <guilabel>Properties</guilabel> dialog for the currently selected object on your slide.</para> +<screenshot> +<screeninfo>The <guilabel>Properties</guilabel> dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="properties.png"/> +</imageobject> +<textobject> +<phrase>The <guilabel>Properties</guilabel>dialog</phrase> +</textobject> +</mediaobject> +</screenshot> +<para>The <guilabel>Properties</guilabel> dialog for an object allows you to manipulate it in a +very detailed manner. You can change several properties for the selected object, like the text color if the object is text or the depth if the object is a picture.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guisubmenu>Arrange Objects</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>This is where you can manipulate the stacking order of +objects on the slide.</para> + +<para>An object that is on top will cover, either partially or fully +depending on its size, all other objects beneath it. Meanwhile an +object on the bottom of the stack may not be visible at all, as it is +covered up by other objects. An object in the middle may be partially +covered by other objects, while partially covering yet more objects +itself.</para> + +<para>You can send the selected object down or up a layer, or directly +to the top or bottom of the stack.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guisubmenu>Align Objects</guisubmenu> +</menuchoice> +</term> +<listitem> + +<para>In the submenu you can quickly align all the currently +selected objects with a side of the slide, or center them either +vertically or horizontally.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo> +</shortcut> +<guimenu>Format</guimenu> +<guimenuitem>Group Objects</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>If you are drawing, you might want to make something out of +several objects. Arrange the individual parts where you +want them, select one, then hold down the &Ctrl; key +as you click in the others you want to group together. Click +<guimenuitem>Group Objects</guimenuitem> and from then on they act as +if they are just one thing. It glues things together.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;&Shift;<keycap>G</keycap></keycombo> +</shortcut> +<guimenu>Format</guimenu> +<guimenuitem>Ungroup Objects</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>If you decide that you want to alter an object that is made out +of several pieces, you can unglue it with this tool. Click somewhere +away from the object to deselect it, then click to select one of its +parts.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Shadow Objects...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>This puts a colored copy of either text or a drawn object behind +it. You can make nice <quote>dropped shadows</quote> for logos with +this tool. To enable this item, ensure that you have object(s) +selected (you will see the six small black boxes around the +outline.) You choose the color, select which way the shadow is going to +fall and select a distance. For text it looks nice if you set the +distance to two or three. Click <guibutton>Apply</guibutton> +to see the result of your settings for all selected objects on the slide +without leaving the dialog.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Page Layout...</guimenuitem> +</menuchoice></term> +<listitem> +<para>Allows you to set the page details. You can specify the margins, +the orientation, either portrait (higher than wide) or Landscape +(wider than high) formats. There are many templates, such as screen, +A4, US legal.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Enable/Disable Document Header</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Toggle the display of the header field</action> on the current slide. Header content can only be added in the master slide but you can choose to display the header only on some slides with this action.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Enable/Disable Document Footer</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><action>Toggle the display of the footer field</action> on the current slide. Footer content can only be added in the master slide but you can choose to display the footer only on some slides with this action.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Format</guimenu> +<guimenuitem>Slide Background...</guimenuitem> +</menuchoice> +</term> +<listitem> + +<para>Allows you to alter the background to your presentation +slides. Your options are <guilabel>Color/Gradient</guilabel>, (which lets you +set either a plain color or one of many gradients) +or <guilabel>Picture</guilabel>, which gives a dialog box to find the picture +you want. Set the <guilabel>View mode:</guilabel> for this picture +to <guilabel>Scaled</guilabel>, <guilabel>Centered</guilabel>, +or <guilabel>Tiled</guilabel>.</para> + +<para> If you want a plain color, click in the box to select +it. Gradients only work when you have chosen two colors. The picture +option allows you to center the picture, zoom it to cover the entire +slide (if it is smaller than the screen, this is very useful) or tile +it. This is used when you want a small pattern to repeat across the +page. It's probably best used with patterns rather than pictures of +logos.</para> + +<para>You can get rid of a picture by selecting another one or +choosing a color/gradient.</para> + +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="text-menu"> +<title><guimenu>Text</guimenu> Menu</title> + +<para>This menu modifies selected text and provides a few tools familiar from +word processing applications for your convienience for when you are making +presentations with large amounts +of text in them. The <guimenu>Text</guimenu> menu will only effect selected or +highlighted text.</para> + +<variablelist> +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Default Format</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Restores selected text to the system default font size, style and +formatting.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Font...</guimenuitem> +</menuchoice> +</term> +<listitem> + +<para>The <guilabel>Select Font</guilabel> dialog contains options for selected +segments of text:</para> + +<screenshot> +<screeninfo>The <guilabel>Select Font</guilabel> dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="textmenu1.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>The <guilabel>Select Font</guilabel> dialog</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para>With this dialog, you can <action>change the font, style and size of +selected text</action>. The <interface>preview box</interface> at the bottom +allows you to <action>approximate changes before you make them</action>. </para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul"> +&Ctrl;&Alt;<keycap>P</keycap> +</keycombo> +</shortcut> +<guimenu>Text</guimenu> +<guimenuitem>Paragraph...</guimenuitem> +</menuchoice> +</term> +<listitem> + +<para>The <guilabel>Paragraph Settings</guilabel> dialog contains settings for +larger blocks of text, such as paragraphs. Using this dialog, you can set +indenting, line spacing, bullet/numbered list and border settings.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Color...</guimenuitem> +</menuchoice> +</term> +<listitem> + +<para>Use the <guilabel>Select Color</guilabel> dialog to have precise control +over the color of selected text:</para> + +<screenshot> +<screeninfo>The <guilabel>Select Color</guilabel> dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="textmenu2.png"/> +</imageobject> +<textobject> +<phrase>The <guilabel>Select Color</guilabel> dialog</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para>Using the <interface>color spectrum box</interface> on the left, +<action>colors can be precisely defined</action> for use in your document. The +color tone can then be adjusted using the <interface>scale</interface> to the +right of the spectrum box. The <interface>input boxes</interface> below the +color spectrum allow <action>color values to be entered</action>, so that exact +colors can be specified.</para> + +<tip> +<para>Use the color picker to select colors from elsewhere in your document +(⪚ images).</para> +</tip> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;&Alt;<keycap>S</keycap></keycombo> +</shortcut> +<guimenu>Text</guimenu> +<guimenuitem>Style Manager</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>The <guilabel>Style Manager</guilabel> allows you to create an entire set of +attributes that will be applied to selected text all at once. See Working With Styles</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Import Styles...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Here you can import styles that you have defined in another &kpresenter; +document.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guisubmenu>Style</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>Using this submenu, you can apply a style that you have previously defined +to the currently selected text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Create Style From Selection</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Copy the properties of the currently selected text and +save them as a style that you may apply to other text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guisubmenu>Align</guisubmenu> +</menuchoice> +</term> +<listitem> +<para><guisubmenu>Align</guisubmenu> has a submenu with several options: +<guimenuitem>Align Left</guimenuitem> (<keycombo action="simul">&Alt;<keycap>L</keycap></keycombo>), +<guimenuitem>Align Center</guimenuitem> (<keycombo action="simul">&Alt;<keycap>C</keycap></keycombo>), +<guimenuitem>Align Right</guimenuitem> (<keycombo action="simul">&Alt;<keycap>R</keycap></keycombo>), and +<guimenuitem>Align Block</guimenuitem> (<keycombo action="simul">&Alt;<keycap>J</keycap></keycombo>) +which is also commonly known as <quote>Justify</quote>.</para> + +<para>Text is by default left-aligned.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guisubmenu>Type</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>Using this submenu, you can format the currently selected text as a list, +either of the numbered or bulleted type. If you choose numbered, you can then +select a numbering style, and likewise if you choose bulleted, you can +choose the style of bullets to use.</para> + +<para>To change a list back to plain text, select +<guimenuitem>None</guimenuitem> as the style.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo> +</shortcut> +<guimenu>Text</guimenu> +<guimenuitem>Increase Depth</guimenuitem> +</menuchoice> +</term> + +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo> +</shortcut> +<guimenu>Text</guimenu> +<guimenuitem>Decrease Depth</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><guimenuitem>Increase Depth</guimenuitem> and <guimenuitem>Decrease +Depth</guimenuitem> move paragraphs in a list either to the right +(<guimenuitem>Increase Depth</guimenuitem>) or back to the left +(<guimenuitem>Decrease Depth</guimenuitem>).</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Extend Contents to Object Height</guimenuitem> +</menuchoice></term> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Extend Object to Fit Contents</guimenuitem> +</menuchoice> +</term> +<listitem> +<para><guimenuitem>Extend Contents to Object Height</guimenuitem> and +<guimenuitem>Extend Object to Fit Contents</guimenuitem> help to +resize text within the text box or make the text box fit the text you have typed +or pasted into it.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Insert Slide Number</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Insert a dynamically-updated slide number. This page number will +automatically update when slides are added or removed from your presentation to +reflect the correct slide value.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guimenuitem>Change Case...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Presents a dialog that provides a variety of different case/capitalization +options for the currently selected text.</para> + +<para>You may choose between several styles of capitalization, +including all lower or uppercase, book style capitalization where each +word except conjunctions has an initial capital letter, and sentence +style capitalization where the first word in a sentence is capitalized. You can +also toggle the case, so that uppercase becomes lowercase, and vice +versa.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guisubmenu>Spellcheck</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>Use this submenu to utilize the spellcheck options. If you enable +<guimenuitem>Autospellcheck</guimenuitem>, &kpresenter; will automatically check +text that you enter for spelling errors.</para> + +<para>If you prefer to check spelling explicitly, rather than automatically, you +can also force a <guimenuitem>Spelling...</guimenuitem> check here.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Text</guimenu> +<guisubmenu>Autocorrection</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>Use this submenu to utilize autocorrection options. If you +<guimenuitem>Enable Autocorrection</guimenuitem>, common spelling errors will be +corrected as you type. For example, if you entered <userinput>Teh</userinput>, +it would be autocorrected to <userinput>The</userinput>.</para> + +<para>If the autocorrection feature is not active, you can also +<guimenuitem>Apply Autocorrection</guimenuitem> check here.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="slide-show-menu"> +<title><guimenu>Slide Show</guimenu> Menu</title> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Slide Show</guimenu> +<guimenuitem>Configure Slide Show...</guimenuitem> +</menuchoice> +</term> +<listitem> +<!--<para> +FIXME: Write a working with slideshows section +</para>--> +<para>You can set up the properties for the entire slide show here, +including whether to show the duration on screen, which of the slides +in a presentation to include, and several other global settings.</para> + +<!--<para>This is discussed in detail in the FIXME: link to presentation +section.</para>--> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Slide Show</guimenu> +<guimenuitem>Edit Object Effect...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Choose what effect you want to apply for the highlighted object. This is where +you can set the order of appearance, how the object will appear, if you want a sound while the object appears and if you want some disappearance effects too.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Slide Show</guimenu> +<guimenuitem>Edit Slide Transition...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Apply transition effects to the currently open slide. This is where +you can choose how the transition from one slide to the next +will be handled.</para> + +<para>The transition effects you select here are applied on the +transition <emphasis>from</emphasis> this slide +<emphasis>to</emphasis> the next.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycap>F12</keycap></shortcut> +<guimenu>Slide Show</guimenu> +<guimenuitem>Start</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Begin the slideshow from the current slide.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Slide Show</guimenu> +<guimenuitem>Start From First Slide</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Begin the slideshow from the first slide.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Slide Show</guimenu> +<guimenuitem>Custom Slide Show...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Opens a dialog to <guibutton>Add...</guibutton>, <guibutton>Modify...</guibutton>, +<guibutton>Remove</guibutton> and <guibutton>Copy</guibutton> slides and +<guibutton>Test</guibutton> the slide show in full screen mode.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycap>Home</keycap></shortcut> +<guimenu>Slide Show</guimenu> +<guimenuitem>Go to Start</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Go directly to the first slide in the slide show.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycap>PageUp</keycap></shortcut> +<guimenu>Slide Show</guimenu> +<guimenuitem>Previous Slide</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Go back to the previous slide in the slide show.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycap>PageDown</keycap></shortcut> +<guimenu>Slide Show</guimenu> +<guimenuitem>Next Slide</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Go to the next slide in the slide show.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<shortcut><keycap>End</keycap></shortcut> +<guimenu>Slide Show</guimenu> +<guimenuitem>Go to End</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Go immediately to the final slide in the slide show.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="settingsmenu"> +<title><guimenu>Settings</guimenu> Menu</title> + +<para>The <guimenu>Settings</guimenu> menu allows you to customize +&kpresenter;.</para> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Settings</guimenu> +<guisubmenu>Toolbars</guisubmenu> +</menuchoice> +</term> +<listitem> +<para>The items in this submenu can be toggled, that is, you can both enable and +disable the display of specific toolbars here.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure Autocorrection...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Autocorrection is &kpresenter;'s ability to correct +common typing errors or expand abbreviations independently of the spell +checking function. There are several common typing errors entered for +you by default such as replacing <userinput>teh</userinput> with +<userinput>the</userinput> and you can add as many more as you +like.</para> + +<para>The ability to expand abbreviations can save you a lot of typing +time, if you often repeat text whether in the same presentation or in +multiple presentations.</para> + +<para>For instance, if you work for <quote>Company with a really really +long name Inc.</quote> then you might define an autocorrection entry so +that whenever you type <userinput>myJob</userinput> or some other piece +of unique text, it will be replaced with <quote>Company with a really +really long name Inc.</quote>.</para> + +<para>Autocorrection can be applied automatically as you type, or only +on demand when you choose it from the <guimenu>Text</guimenu> +menu.</para> + +<para>Please see the <link +linkend="configure-autocorrection">Configure Autocorrection</link> section for a complete explanation.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure Completion...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Autocompletion allows you to type the first few letters of a commonly used word (often technical or job specific), and tells &kpresenter; to finish typing the word for you.</para> + +<para>Please see the <link +linkend="configure-completion">Configure Completion</link> section for a complete explanation.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term> +<menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure Shortcuts...</guimenuitem> +</menuchoice> +</term> +<listitem> + +<para><guimenuitem>Configure Shortcuts</guimenuitem> allows you to +assign a keyboard shortcut to actions that &kpresenter; menus or icons +contain.</para> + +<screenshot> +<screeninfo>Customize Shortcuts</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="settings03.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>Customizing the shortcuts</phrase> +</textobject> +</mediaobject> +</screenshot> + +<para>If you try to assign a shortcut that is already used, it will +give you a warning message. Highlight what you want to do (in the +picture, I have chosen to make a keyboard shortcut to <guilabel>About +KDE</guilabel>).</para> + +<para>Click the radio button to the <guilabel>Custom</guilabel> key setting and type the +key you want to use. I assigned <keycap>Control</keycap> key and +<keycap>Y</keycap> to bring up the <quote>About KDE</quote> dialog +box.</para> + +<para>The button shows what has been assigned. Click +<guibutton>OK</guibutton> to make the changes, click +<guibutton>Default</guibutton> to restore whatever was assigned as +default, click <guibutton>Cancel</guibutton> to do nothing and leave +the dialog.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure Toolbars...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>Configure Toolbars allows you to add or delete icons on each of +the toolbars.</para> + +<screenshot> +<screeninfo>Configuring &kpresenter; toolbars</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="settings04.png" format="PNG"/> +</imageobject> +<textobject> +<phrase>Configuring &kpresenter; toolbars</phrase> +</textobject> +</mediaobject> +</screenshot> + + + +<para>At the top is a drop down box to enable you to choose which +toolbar you want to modify. In the picture the <guilabel>Format</guilabel> toolbar is +selected. If I want to add the <guiicon>Spelling</guiicon> icon to +that toolbar, I click the entry in the left window. The arrow pointing +right becomes available, if I click the arrow the <guiicon>Spelling</guiicon> +entry is added to the selected toolbar. The left arrow +is available when you click in the right side window. It allows you to +remove an icon from a toolbar. The up and down arrows become active +when an item on the wright side is selected. You can also move the highlight in +the right side window up and down with the keyboard arrow keys. By +clicking on the arrows with the mouse you can change the order of the entries +in the menu. +<!--The <guimenuitem>Configure +&kpresenter;...</guimenuitem> menu entry gives two menu boxes. --> +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice> +<guimenu>Settings</guimenu> +<guimenuitem>Configure &kpresenter;...</guimenuitem> +</menuchoice> +</term> +<listitem> +<para>See the <link +linkend="configure-dialog">configure &kpresenter;</link> section for a complete explanation of all &kpresenter; settings.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 id="helpmenu"> +<title><guimenu>Help</guimenu> Menu</title> + +&help.menu.documentation; + +</sect1> + +</chapter>
\ No newline at end of file diff --git a/doc/kpresenter/mousenav.png b/doc/kpresenter/mousenav.png Binary files differnew file mode 100644 index 00000000..462c6051 --- /dev/null +++ b/doc/kpresenter/mousenav.png diff --git a/doc/kpresenter/msexport1.png b/doc/kpresenter/msexport1.png Binary files differnew file mode 100644 index 00000000..fa3de1e4 --- /dev/null +++ b/doc/kpresenter/msexport1.png diff --git a/doc/kpresenter/msexport2.png b/doc/kpresenter/msexport2.png Binary files differnew file mode 100644 index 00000000..27bb44f2 --- /dev/null +++ b/doc/kpresenter/msexport2.png diff --git a/doc/kpresenter/msexport2b.png b/doc/kpresenter/msexport2b.png Binary files differnew file mode 100644 index 00000000..a141a903 --- /dev/null +++ b/doc/kpresenter/msexport2b.png diff --git a/doc/kpresenter/msexport3.png b/doc/kpresenter/msexport3.png Binary files differnew file mode 100644 index 00000000..55b03e60 --- /dev/null +++ b/doc/kpresenter/msexport3.png diff --git a/doc/kpresenter/msexport4.png b/doc/kpresenter/msexport4.png Binary files differnew file mode 100644 index 00000000..63424610 --- /dev/null +++ b/doc/kpresenter/msexport4.png diff --git a/doc/kpresenter/options.docbook b/doc/kpresenter/options.docbook new file mode 100644 index 00000000..39f13e13 --- /dev/null +++ b/doc/kpresenter/options.docbook @@ -0,0 +1,1032 @@ +<chapter id="options"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Neil</firstname> +<surname>Lucock</surname> +<affiliation> +<address><email>neil@nlucock.freeserve.co.uk</email></address> +</affiliation> +</author> +<author> +<firstname>Krishna</firstname> +<surname>Tateneni</surname> +<affiliation> +<address><email>tateneni@pluto.njcc.com</email></address> +</affiliation> +</author> +<author> +<firstname>Anne-Marie</firstname> +<surname>Mahfouf</surname> +<affiliation> +<address><email>annemarie.mahfouf@free.fr</email></address> +</affiliation> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> +<title>Configuring &kpresenter;</title> + +<sect1 id="configure-autocorrection"> +<title>The <guilabel>Configure Autocorrection...</guilabel> Dialog</title> +<para>Auto correction is a system for correcting common typing errors, converting abbreviations to their full spelling and adjusting capitalization. As you could guess from its name, this all occurs automatically, while you are editing your document.</para> + +<sect2 id="enabling-autocorrection"> +<title>Enabling/Disabling Autocorrection</title> + +<para>To toggle autocorrection on, select <menuchoice><guimenu>Text</guimenu><guisubmenu>Autocorrection</guisubmenu><guimenuitem>Enable Autocorrection</guimenuitem></menuchoice> from the menubar. When enabled, autocorrection makes changes to your document <emphasis>as you type</emphasis>. You can determine which changes to make by configuring autocorrection, as explained below. +</para> + +<para>To toggle autocorrection off, select <menuchoice><guimenu>Text</guimenu><guisubmenu>Autocorrection</guisubmenu><guimenuitem>Disable Autocorrection</guimenuitem></menuchoice> from the menubar. When disabled, autocorrection changes are not made. You can, however, <link linkend="manually">apply autocorrection manually</link>, using the <menuchoice><guimenu>Text</guimenu><guisubmenu>Autocorrection</guisubmenu><guimenuitem>Apply Autocorrection</guimenuitem></menuchoice> menu. +</para> + +<para>To adjust the options for autocorrection, select <menuchoice><guimenu>Settings</guimenu> +<guimenuitem>Configure Autocorrection...</guimenuitem></menuchoice> from the menubar.</para> + +<para>A dialog window appears to help you set your options, with four tabs: <link linkend="simple-autocorrection">Simple Autocorrection</link>, <link linkend="custom-quotes">Custom Quotes</link>, <link linkend="advanced-autocorrestion">Advanced Autocorrection</link> and <link linkend="exceptions">Exceptions</link>.</para> +</sect2> + +<sect2 id="simple-autocorrection"> +<title><guilabel>Simple Autocorrection</guilabel></title> + +<screenshot> +<screeninfo>Simple Autocorrection</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="autocorrection1.png" format="PNG"/> +</imageobject> +<textobject><phrase>Simple Autocorrection</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Convert first letter of a sentence automatically to uppercase</guilabel></term> +<listitem><para>When selected, &kpresenter; will automatically capitalize the first letter after a period. You can tell &kpresenter; when not to alter capitalization in certain instances (ie “Sr.” or “Jr.”). For more details, see the section entitled <link linkend="exceptions">Autocorrection Exceptions</link>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Convert two uppercase characters to one uppercase and one lowercase character</guilabel></term> +<listitem><para>When selected, &kpresenter; will automatically convert a double capital letter (a common typographical error), into a single capital letter. You can tell &kpresenter; when not to alter capitalization in certain instances. For more details, see the section entitled <link linkend="exceptions">Autocorrection Exceptions</link>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Autoformat URLs</guilabel></term> +<listitem><para>When selected, &kpresenter; will scan text for patterns which suggest a certain section of text is a URL and automatically creates a link.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Suppress double spaces</guilabel></term> +<listitem><para>When checked, &kpresenter; will ignore the second space typed. This prevents users from adding double spaces between words or sentences</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Remove spaces at the beginning and end of paragraphs</guilabel></term> +<listitem><para>When selected, &kpresenter; will automatically remove spaces at the beginning and/or the end of a line of text.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Automatically do bold and underline formatting</guilabel></term> +<listitem><para>When selected, &kpresenter; will look for words surrounded by asterisks ( * ). It will remove the asterisks and change the font of all words in between the two asterisks to bold face.</para> +<para>&kpresenter; will also look for words surrounded by underscores ( _ ). It will remove the underscores and underline all words in between the two underscores.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Replace 1/2... with ½...</guilabel></term> +<listitem><para>When selected, &kpresenter; will automatically change 1/2, 1/3 and 3/4 to their single character equivalents.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Use autonumbering for numbered paragraphs</guilabel></term> +<listitem><para>If you start a paragraph with a number and a symbol ( <emphasis>1)</emphasis> for example), &kpresenter; will automatically convert that paragraph to a numbered paragraph. All future paragraphs will be consecutively numbered.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Replace 1st with 1^st...</guilabel></term> +<listitem><para>When selected, &kpresenter; will automatically change 1st to 1<superscript>st</superscript>.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Capitalize name of days</guilabel></term> +<listitem><para>Automatically capitalize the days of the week (Sunday, Monday, Tuesday, etc...).</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Use list-formatting for bulleted paragraphs</guilabel></term> +<listitem><para>When selected, &kpresenter; will look for lines that begin with <emphasis>- </emphasis>, and automatically convert the paragraph style to a bulleted list. The bullet is selected with the left button below this option.</para></listitem> +</varlistentry> + +</variablelist> + +</sect2> +<sect2 id="custom-quotes"> +<title><guilabel>Custom Quotes</guilabel></title> + +<para>Select the tab labeled <guilabel>Custom Quotes</guilabel></para> + +<screenshot> +<screeninfo>Custom Quotes</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="autocorrection2.png" format="PNG"/> +</imageobject> +<textobject><phrase>Custom Quotes</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Replace double quotes with typographical quotes</guilabel></term> +<listitem> +<para>When selected, this option will replace the standard keyboard double +quotes, with typographical quotation marks. If you want to change the +quotation character, click on one of the buttons. Clicking on +<guibutton>Default</guibutton>, restores the default paragraph marks.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Replace single quotes with typographical quotes</guilabel></term> +<listitem> +<para>When selected, this option will replace the standard keyboard single +quotes, with typographical quotation marks. If you want to change the +quotation character, click on one of the buttons. Clicking on +<guibutton>Default</guibutton>, restores the default paragraph marks.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> +<sect2 id="advanced-autocorrestion"> +<title><guilabel>Advanced Autocorrection</guilabel></title> + +<para>To switch to the Advanced Autocorrection, click on the tab labeled +<guilabel>Advanced Autocorrection</guilabel>.</para> + +<screenshot> +<screeninfo>Advanced Autocorrection</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="autocorrection3.png" format="PNG"/> +</imageobject> +<textobject><phrase>Advanced Autocorrection</phrase></textobject> +</mediaobject> +</screenshot> + +<para>This allows you to automatically have &kpresenter; replace one string +of text with another. This can be useful for special symbols, commonly +used abbreviations that you want spelled out, or common typing errors.</para> + +<para>&kpresenter; uses different autocorrection strings depending on the language. +Set the correct language using the combo box labeled +<guilabel>Replacement and exceptions for language:</guilabel>.</para> + +<para>The check box labeled <guilabel>Enable word replacement</guilabel> is used to +toggle on and off the autoreplacement features of &kpresenter;. If there is no mark in the check box, +then &kpresenter; will not perform any autoreplacements from the list in this dialog.</para> + +<para>If there is a mark in the check box labeled <guilabel>Replace text with format</guilabel> +&kpresenter; will not only change the text when it finds a match, but it will change the formatting of the new text. +If there is no mark in this check box, then +&kpresenter; uses the same formatting options for the replaced text as it found in the search text. For more information +on setting the format options for replacement text, see the section on +<link linkend="autocorrection-format-options">Changing the format of the autocorrection string</link>.</para> + +<sect3> +<title>Adding an autocorrection string</title> + +<para>To add an autocorrection string, simply type the text you want &kpresenter; to +check for in the text box labeled +<guilabel>Find:</guilabel>, then enter the text you want &kpresenter; +to substitute in the text box labeled <guilabel>Replace:</guilabel>.</para> + + +<note><para>If you want to insert symbols or special characters not available on your +keyboard, you can click the +buttons with three periods on them and select a special character from the table provided.</para></note> + +<para>When these are entered, click <guibutton>Add...</guibutton>. Your text +strings are now added to the table.</para> +</sect3> + +<sect3> +<title>Editing an autocorrection string</title> +<para><emphasis>Changing the text you want to find.</emphasis></para> +<para>&kpresenter; does not allow you to change the text to search for. +This is to prevent disastrous mistakes.</para> +<para>Instead, you must delete the current autocorrection rule and +add a new text string with the corrected text to find.</para> + +<para><emphasis>Changing the text you want to replace.</emphasis></para> +<para>Begin by clicking once on the string you want to edit. It will be +highlighted and the find and replace text will be listed in the text boxes +above. You can alter the replacement text. When you +are done, simply click on the <guibutton>Modify</guibutton> button.</para> + +</sect3> + +<sect3> +<title>Deleting an autocorrection string</title> + +<para>Simply click on the string you want to delete. Now click the +<guibutton>Remove</guibutton> button. The string is removed.</para> + +<warning> +<para>Be aware that &kpresenter; does not give you a chance to back out once +you have deleted a string. Be sure you have selected the correct string +<emphasis>before</emphasis> you click the <guibutton>Remove</guibutton> +button.</para> +</warning> +</sect3> + +<sect3 id="autocorrection-format-options"> +<title>Changing the format of the autocorrection string</title> +<note><para>Currently, you must create the autocorrection string <emphasis>before</emphasis> you can format it.</para></note> +<para>Once the autocorrection string has been created, simply click on it once with the &LMB;.</para> +<para>Now click on the <guibutton>Change Format...</guibutton> button. A small dialog will appear:</para> + +<screenshot> +<mediaobject> +<imageobject> +<imagedata fileref="changeformat.png" format="PNG"/></imageobject> +</mediaobject> +</screenshot> +<para>You can use this dialog to select the format of the replaced text.</para> +<para>The left column consists of 13 check boxes. If there is a mark in the check box, then &kpresenter; will change +any replaced text to match the property selected. +If no mark is in the check box, &kpresenter; does not consider that property when replacing text.</para> + +<variablelist> + +<varlistentry> +<term><guilabel>Family:</guilabel></term> +<listitem> +<para>Use this combo box to select the font family you want your replacement text to use.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Size:</guilabel></term> +<listitem> +<para>Use this spin box to set the font size you want &kpresenter; to use for your replaced text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Color:</guilabel> and <guilabel>Background color:</guilabel></term> +<listitem> +<para>Clicking on either of these two buttons allows you to select the font color and/or background color respectively, +you want &kpresenter; to use. <!--For more information on selecting a color, see the +section on <link linkend="select-colors">Selecting Colors from the Color Dialog</link>.--></para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Bold:</guilabel> and <guilabel>Italic:</guilabel></term> +<listitem> +<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio buttons to determine whether you want &kpresenter; +to change the fonts to boldface or italicized fonts.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Strikeout:</guilabel></term> +<listitem> +<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel> +or <guilabel>Simple Bold</guilabel> to use for the replacement text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Underline:</guilabel></term> +<listitem> +<para>You can select <guilabel>None</guilabel>, <guilabel>Single</guilabel>, <guilabel>Double</guilabel>, +<guilabel>Simple Bold</guilabel> or <guilabel>Wave</guilabel> to use for the replacement text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Vertical alignment:</guilabel></term> +<listitem> +<para>You can select <guilabel>Normal</guilabel>, <guilabel>Superscript</guilabel> or +<guilabel>Subscript</guilabel> to determine what font alignment you want &kpresenter; to use.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Shadow:</guilabel> and <guilabel>Word by word:</guilabel></term> +<listitem> +<para>Use these <guilabel>Yes</guilabel>/<guilabel>No</guilabel> radio buttons to determine whether you want &kpresenter; +to use shadow text and/or word by word underlining and strikethrough in the replacement text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Capitalization:</guilabel></term> +<listitem> +<para>You can select <guilabel>Normal</guilabel>, <guilabel>Uppercase</guilabel>, <guilabel>Lowercase</guilabel>, or +<guilabel>Small Caps</guilabel> to determine what capitalization to use for the replacement text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Language:</guilabel></term> +<listitem> +<para>You can select the language of the text you will use to replace the found text.</para> +</listitem> +</varlistentry> +</variablelist> + +<para>Once you have selected your options, click <guibutton>OK</guibutton> to accept your text options.</para> +<para>Click <guibutton>Cancel</guibutton> to ignore all changes.</para> +<para>Click <guibutton>Reset</guibutton> to restore the options dialog box to the initial values prior to making any changes.</para> +<para>Click <guibutton>Clear</guibutton> to remove all marks from the checked options.</para> +</sect3> + +</sect2> +<sect2 id="exceptions"> +<title><guilabel>Exceptions</guilabel></title> + +<para>There are instances where &kpresenter; will make autocorrection changes +that are inappropriate. You can use the fourth tab of this dialog to define +<emphasis>exceptions</emphasis> to the rules previously discussed.</para> +<para>The dialog for exceptions is shown below:</para> + +<screenshot> +<screeninfo>Exceptions</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="autocorrection4.png" format="PNG"/> +</imageobject> +<textobject><phrase>Exceptions</phrase></textobject> +</mediaobject> +</screenshot> + +<para>To prevent &kpresenter; from deciding an abbreviation or other text is +the end of a sentence, simply enter the text fragment in the text box below +<guilabel>Do not treat as the end of a sentence:</guilabel>. Then click +<guibutton>Add</guibutton>.</para> +<para>As an example: Adding <quote>Jr.</quote> to this dialog prevents</para> +<para><quote>Robert Jones Jr. is a friend of the family.</quote></para> +<para>from being changed to:</para> +<para><quote>Robert Jones Jr. Is a friend of the family.</quote></para> +<para>To remove an erroneous entry, simply click once on the wrong entry with the &LMB; +and click on the <guibutton>Remove</guibutton> button.</para> +<para>The second set of boxes performs a similar function to the first except text entered in these boxes will allow two capital letters in a word if it +is entered in this text box.</para> +<para>Simply enter the word in the text box below +<guilabel>Accept two uppercase letters in:</guilabel>. Then click +<guibutton>Add</guibutton>.</para> +<para>As an example: Adding <quote>CD</quote> to this dialog prevents</para> +<para><quote>CD</quote></para> +<para>from being changed to:</para> +<para><quote>Cd</quote></para> +<para>To remove an erroneous entry, simply click once on the wrong entry with the &LMB; +and click on the <guibutton>Remove</guibutton> button.</para> + +</sect2> +<sect2 id="manually"> +<title>Manually applying autocorrection</title> + +<para>If autocorrection is turned off in your document, you can manually enable autocorrection.</para> +<para>To manually apply autocorrection, first configure your options by using the +<link linkend="configure-autocorrection">autocorrection dialogs</link>.</para> +<para>Then select <menuchoice> +<guimenu>Text</guimenu><guisubmenu>Autocorrection</guisubmenu><guimenuitem>Apply Autocorrection</guimenuitem></menuchoice> +from the menubar.</para> +<para>&kpresenter; will start at the beginning of the document and apply all selected autocorrection options to the entire document.</para> +<para>When &kpresenter; is finished, it will return you to your document for further editing.</para> +<para>For more information on enabling and disabling autocorrection, +see <link linkend="enabling-autocorrection">Enabling/Disabling Autocorrection</link>.</para> + +</sect2> +</sect1> + +<sect1 id="configure-completion"> +<title>The <guilabel>Configure Completion</guilabel> Dialog</title> + +<para>Autocompletion allows you to type the first few letters of a commonly +used word (often technical or job specific), and tells &kpresenter; to +finish typing the word for you. This is often very useful when you have lengthy technical words.</para> + +<sect2 id="autocomplete-using"> +<title>Using autocompletion</title> +<para>Using autocompletion could not be easier. Simply type the first few +letters of the word you want &kpresenter; to finish, and press +<keycombo>&Ctrl;<keycap>E</keycap></keycombo>. &kpresenter; will look +through the list of autocompletion words and if it finds a word which begins +with those letters, it will finish entering the remainder of the word.</para> +<sect3 id="autocomplete-using-add"> +<title>Adding words to autocompletion</title> +<para>&kpresenter; maintains a list of words for each user that will be used for autocompletion.</para> +<para>You can add words to this list one of two ways:</para> +<itemizedlist> +<listitem><para>&kpresenter; can automatically add new words to the completion list for later approval. +This is selected using <link linkend="autocomplete-dialog">the dialog</link>.</para></listitem> +<listitem><para>Individual words can be added to the list by using +<link linkend="autocomplete-dialog">the dialog</link>.</para></listitem> +</itemizedlist> +</sect3> +</sect2> + +<sect2 id="autocomplete-dialog"> +<title>Configuring autocomplete</title> +<para>To configure autocompletion, select <menuchoice> +<guimenu>Settings</guimenu><guimenuitem>Configure Completion...</guimenuitem></menuchoice> +from the menubar. This will bring up a dialog.</para> + +<screenshot> +<screeninfo><guilabel>Completion</guilabel> Dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="completion.png" format="PNG"/> +</imageobject> +<textobject><phrase><guilabel>Completion</guilabel> Dialog</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Enable word completion</guilabel></term> +<listitem><para>It is used to toggle autocompletion on and off.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Add</guilabel></term> +<listitem> +<para>By clicking this button you can manually add +an individual word to the completion list.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Remove</guilabel></term> +<listitem> +<para>To remove words from the completion list, select the word with the &LMB; +from the list, then click this button.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Automatically add new words to suggestion list</guilabel></term> +<listitem> +<para>This option will add any word equal to or longer than +the <guilabel>Characters needed:</guilabel> to the list of proposed +autocompletion words.</para> +<para>The large listbox in the center of the dialog contains the current +proposed list of autocompletion words.</para> +<note><para>Not all words listed in the list box will be immediatly affected by +autocompletion when entered into this dialog.</para></note> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Show words in tooltip</guilabel></term> +<listitem> +<para>If this option is enabled, a tool tip box will appear when you type the +beginning of a word that exists in the completion list. To complete the word, +press the key you set to accept suggestions in the <guilabel>Key to accept +suggestion:</guilabel> drop-down list.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term><guilabel>Characters needed:</guilabel></term> +<listitem> +<para>Use this spinbox/slider combination to prevent &kpresenter; +from automatically adding short words to the completion list. You can select +any value from 5-100 and the words will need to be at least the number of +characters set here to be added in the list.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Suggest words:</guilabel></term> +<listitem> +<para>This spinbox/slider combination can be adjusted to allow more or less +words into the autocompletion list. This option is most important when +<guilabel>Automatically add new words to suggestion list</guilabel> is enabled. +This option keeps the list from becoming too cumbersome. You can select any +value from 1 to 500.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Append space</guilabel></term> +<listitem> +<para>If checked, it adds a single space to the end of a word after +autocompletion, this means it is not necessary to add the space manually for the +next word.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Key to accept suggestion:</guilabel></term> +<listitem> +<para>Set the key you want to use when an autocompleted word is suggested to you +and you want to accept it. You can choose +<keycap>Enter</keycap>, <keycap>Tab</keycap>, <keycap>Space</keycap>, +<keycap>End</keycap> or <keycap>Right</keycap>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Make Default</guilabel></term> +<listitem> +<para>A word is not part of autocompletion until the list is +<emphasis>saved</emphasis> to disk. At that moment, &kpresenter; +will use that saved list for all autocompletion, until the list is replaced with +another saved list.</para> +<para>Some of the words in the autocompletion list may not have been saved +yet.</para><para>To save the current list to disk and have &kpresenter; begin +using this new list for autocompletion, click this button.</para> +</listitem> +</varlistentry> +</variablelist> + +<para>Click <guibutton>OK</guibutton> to save your options. Click +<guibutton>Cancel</guibutton> to abort all changes. Click +<guibutton>Reset</guibutton> to reset to the state after you clicked on the +<guibutton>Make Default</guibutton> button.</para> + +</sect2> + +</sect1> + +<sect1 id="configure-dialog"> +<title>The <guilabel>Configure &kpresenter;</guilabel> Dialog</title> + +<sect2 id="configure-interface"> +<title><guilabel>Interface</guilabel></title> + +<screenshot> +<screeninfo>Configure Interface</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure1.png" format="PNG"/> +</imageobject> +<textobject><phrase>Configure Interface</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Show rulers</guilabel></term> +<listitem><para>This is checked by default and both a vertical and horizontal +ruler are shown on &kpresenter;slides. When unchecked, the rulers are not shown +anymore on any slide.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Show status bar</guilabel></term> +<listitem><para>Toggle the statusbar which is shown by default.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Number of recent files:</guilabel></term> +<listitem><para>Set the number of recent files which will be opened using the +<menuchoice><guimenu>File</guimenu><guisubmenu>Open +Recent</guisubmenu></menuchoice> menu. Default is to remember 10 filenames. The +maximum you can set is 20 and the minimum is 1.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Text indentation depth:</guilabel></term> +<listitem><para>This setting is used in the <guimenu>Text</guimenu> menu by <guimenuitem>Increase Depth</guimenuitem> and <guimenuitem>Decrease Depth</guimenuitem> menu items to change the indentation depth. Default is 1 centimeter.</para></listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="configure-color"> +<title><guilabel>Color</guilabel></title> + +<screenshot> +<screeninfo>Color</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure2.png" format="PNG"/> +</imageobject> +<textobject><phrase>Color</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Background object color:</guilabel></term> +<listitem><para>It changes the background color of the text box. The Text boxes background is white by default. If you had a dark +background color and you wanted to put some white text over it, you +could color the text box so that you could see what you were +typing. When you have finished, the area around the text would revert +to whatever the background color was. The +<guibutton>Defaults</guibutton> button restores the original +settings.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Grid color:</guilabel></term> +<listitem><para>You can change here the grid color which is black as default.</para></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +<sect2 id="configure-spelling"> +<title><guilabel>Spelling</guilabel></title> + +<para>This tab defines the spellchecker behavior.</para> + +<screenshot> +<screeninfo>Spelling</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure3.png" format="PNG"/> +</imageobject> +<textobject><phrase>Spelling</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Default language:</guilabel></term> +<listitem><para>You can choose here the language for the spellchecker. The languages listed come from aspell so if you want more spelling support languages, you should install the corresponding aspell-ISO packages.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Enable background spellchecking</guilabel> </term> +<listitem><para>If it is checked, it will highlight in red mispelled words according to the dictionary selected above and it will spellcheck words as you type them. This is enabled by default. This option has the same effect as <menuchoice><guimenu>Text</guimenu><guimenuitem>Spellcheck</guimenuitem><guimenuitem>Autospellcheck</guimenuitem></menuchoice> and both are checked/unchecked at the same time.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Skip all uppercase words</guilabel></term> +<listitem><para>If this option is checked, the all uppercase words will not be checked for spelling. This option is also used when you choose the <menuchoice><guimenu>Text</guimenu><guisubmenu>Spellcheck</guisubmenu><guimenuitem>Spelling...</guimenuitem></menuchoice> menu option.</para> +<tip><para>This is useful if the document you are working on uses a large number of acronyms. If this box is left unchecked, most of those acronyms will be incorrectly marked. By placing a mark in this checkbox, &kpresenter; will not mark the acronyms as misspelled.</para></tip> +</listitem></varlistentry> + +<varlistentry> +<term><guilabel>Skip run-together words</guilabel></term> +<listitem><para>If checked, then concatenated words made of existing words are not spellchecked. This is useful in some languages. This option is also used when you choose the <menuchoice><guimenu>Text</guimenu><guisubmenu>Spellcheck</guisubmenu><guimenuitem>Spelling...</guimenuitem></menuchoice> menu option.</para> +<para>Examples of such words are <emphasis>shutout</emphasis>, +<emphasis>cannot</emphasis> and <emphasis>blackout</emphasis>.</para> +<tip> +<para>Checking this box will help prevent &kpresenter; from +flagging website and email addresses for spelling errors. These +addresses often contain words run together.</para> +</tip> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Ignore These Words</guilabel></term> +<listitem><para>You can have here a list of words you want to ignore in all spellchecking.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Add</guilabel></term> +<listitem><para>Write a word in the field then click on the <guilabel>Add</guilabel> button to add it in the list. Once the word is added in the list, even if you click the <guibutton>Cancel</guibutton> button of the configuration dialog, it will stay in the list.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Remove</guilabel></term> +<listitem><para>Highlight a word in the list then click on this button to remove it.</para></listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="configure-misc"> +<title><guilabel>Misc</guilabel></title> + +<screenshot> +<screeninfo>Misc</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure4.png" format="PNG"/> +</imageobject> +<textobject><phrase>Misc</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<title><guilabel>Misc</guilabel></title> +<varlistentry> +<term><guilabel>Undo/Redo limit:</guilabel></term> +<listitem><para>Set the number of actions you can undo and redo (how many actions &kpresenter; keeps in its Undo buffer). Default is 30. Maximum is 60 and minimum is 10. Any action that exceeds the number set will be forgotten.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Display links</guilabel></term> +<listitem><para>When you want to include a link in your slide, you will use the <menuchoice><guimenu>Insert</guimenu><guimenuitem>Link...</guimenuitem></menuchoice> menu which allows you to insert URL, mail or file links. If the option <guilabel>Display links</guilabel> is checked, all links will be displayed in a different color. This makes document links visible. This is the default behavior. If the option is unchecked, the link will be the same color as the text color. The links are visible (or not) both in the edited slides and in the slide show. A displayed link: <inlinemediaobject><imageobject> +<imagedata fileref="configure4a.png" format="PNG"/></imageobject></inlinemediaobject> A non displayed link: <inlinemediaobject><imageobject> +<imagedata fileref="configure4a1.png" format="PNG"/></imageobject></inlinemediaobject></para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Underline all links</guilabel></term> +<listitem><para>If this is checked, all links will be underlined. The option is checked per default. If it is not checked, the link will not be underlined. A displayed and underlined link: <inlinemediaobject><imageobject> +<imagedata fileref="configure4b.png" format="PNG"/></imageobject></inlinemediaobject></para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Display comments</guilabel></term> +<listitem><para>Comments are inserted in the text at the cursor using the <menuchoice><guimenu>Insert</guimenu><guimenuitem>Comment...</guimenuitem></menuchoice> menu. Comments can only be viewed in editing mode and not in the slide show. If this option is checked (default) then each comment will be shown as a small yellow rectangle. You can then right click on it to edit it, remove it or copy its text. A displayed comment: <inlinemediaobject><imageobject> +<imagedata fileref="configure4c.png" format="PNG"/> +</imageobject></inlinemediaobject></para></listitem> +</varlistentry> + + +<varlistentry> +<term><guilabel>Display field code</guilabel></term> +<listitem><para>In editor mode (not in slide show) this option will display all the variable codes. This is very useful to see what variable is displayed. Variables are inserted using the <menuchoice><guimenu>Insert</guimenu><guisubmenu>Variable</guisubmenu></menuchoice> menu.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Print slide notes</guilabel></term> +<listitem><para>If checked, all notes will be printed on paper. The notes will all be printed on a separate last page, from slide one to the last slide and finishing with the Master Page Note. You can see the notes for each slide using the <menuchoice><guimenu>View</guimenu><guimenuitem>Show Notebar</guimenuitem></menuchoice> menu.</para></listitem> +</varlistentry> +</variablelist> + +<variablelist> +<title><guilabel>Grid</guilabel></title> +<varlistentry> +<term><guilabel>Horizontal grid size:</guilabel></term> +<listitem><para>Set the space in centimeters between two points on an horizontal line on the grid. Default is 0.5 centimeter.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Vertical grid size:</guilabel></term> +<listitem><para>Set the space in centimeters between two points on a vertical line on the grid. Default is 0.5 centimeter.</para></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="configure-document"> +<title><guilabel>Document</guilabel></title> + +<screenshot> +<screeninfo>Document</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure5.png" format="PNG"/> +</imageobject> +<textobject><phrase>Document</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<title><guilabel>Document Defaults</guilabel></title> +<varlistentry> +<term><guilabel>Default font:</guilabel></term> +<listitem><para>Click on the <guibutton>Choose...</guibutton> button, and a new dialog will appear. Use this dialog to choose the default font. This setting determines the default font used by &kpresenter; until further formatting is done. You can revert any text to this default by selecting <menuchoice><guimenu>Text</guimenu><guimenuitem>Default Format</guimenuitem></menuchoice> from the menubar.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Global language:</guilabel></term> +<listitem><para>Use this drop down box to determine the default language for the document. This setting is used by the hyphenation and spelling tools.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Automatic hyphenation</guilabel></term> +<listitem><para>Check this box if you want &kpresenter; to automatically hyphenate long words when it determines the word wrap in text frames. This is not set as default.</para></listitem> +</varlistentry> + +</variablelist> + +<variablelist> +<title><guilabel>Document Settings</guilabel></title> +<varlistentry> +<term><guilabel>Create backup file</guilabel></term> +<listitem><para>If checked, this will create a <filename>.<name>.odp.autosave.odp</filename> in the dir where your file is. This backup file can then be used in case of a problem. The backup file is updated everytime you save your document or everytime there is an autosave.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Autosave (min):</guilabel></term> +<listitem><para>You can use this to adjust how often &kpresenter; saves a temporary file. If you set this value to <guilabel>No autosave</guilabel>, &kpresenter; will not autosave. You can adjust the autosave from 1 minute to 60 minutes.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Starting page number:</guilabel></term> +<listitem><para>You can change here the number for the first page. It is set to 1 per default. </para> +<tip><para>This is helpful if you have split a single document into multiple files.</para></tip></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Tab stop:</guilabel></term> +<listitem><para>Each &kpresenter; document has a default set of tab stops. If you add tab stops to your document, the newly added tab stops override the default tabstops. You can use this text box to define the spacing between default tab stops. +As an example, if you enter 1.5 in this text box, and the unit of measure is in centimeters, then the first default tab stop will be located 1.5 cm to the right of the left margin of the frame. The second default tab stop will be located at 3 cm from the left margin, etc.</para></listitem> +</varlistentry> +</variablelist> + +<variablelist> +<title><guilabel>Cursor</guilabel></title> +<varlistentry> +<term><guilabel>Cursor in protected area</guilabel></term> +<listitem><para>When this box is checked and you click in a protected frame of your document, a cursor appears. When the mark is removed from this check box, and you click in a protected frame, there is no cursor visible.</para></listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Direct insert cursor</guilabel></term> +<!-- FIXME: Is this the same as the type anywhere cursor? if so, why +two names? --> +<listitem><para>When this box is checked then you can select a section of text using your mouse. Move the mouse to a new place in your document and click once with the middle mouse button and a copy of the selected text is copied and pasted to the new location in the document.</para> +<para>When there is no mark in this checkbox, in order to copy text from one section to another, you must select the text, manually copy the text in to the clipboard, then manually paste the text in the new location. +</para></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="configure-tools"> +<title><guilabel>Tools</guilabel></title> + +<para>This dialog sets the default tools settings. There are 5 tabs in this dialog.</para> + +<sect3 id="outline"> +<title><guilabel>Outline</guilabel></title> + +<screenshot> +<screeninfo>The <guilabel>Outline</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure6.png" format="PNG"/> +</imageobject> +<textobject><phrase>The <guilabel>Outline</guilabel> tab</phrase></textobject> +</mediaobject> +</screenshot> + +<para>This is used in the <menuchoice><guimenu>Insert</guimenu><guisubmenu>Line</guisubmenu></menuchoice> menu.</para> + +<variablelist> +<varlistentry> +<term><guilabel>Color:</guilabel></term> +<listitem><para>Set the color of the line. Clicking on the color will bring the standard KDE <guilabel>Select Color</guilabel> dialog.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Style:</guilabel></term> +<listitem><para>Choose the line style from <guilabel>No Outline</guilabel> which will not draw any line to dotted lines and plain line.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Width:</guilabel></term> +<listitem><para>Set the width of the line.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Arrow Style</guilabel></term> +<listitem><para>Set the styles of the beginning and the end of your line for example you can choose an arrow at the end and a square dot at the beginning.</para></listitem> +</varlistentry> +</variablelist> +<para>The last field displays a preview of your settings.</para> +</sect3> + +<sect3 id="fill"> +<title><guilabel>Fill</guilabel></title> + +<screenshot> +<screeninfo>The <guilabel>Fill</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure6b.png" format="PNG"/> +</imageobject> +<textobject><phrase>The <guilabel>Fill</guilabel> tab</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Type:</guilabel></term> +<listitem><para>You can choose between <guilabel>Single Color</guilabel>, <guilabel>Gradient</guilabel> or <guilabel>Transparent</guilabel> as the type.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Style:</guilabel></term> +<listitem><para>Choose the style or the pattern.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Color:</guilabel></term> +<listitem><para>Choose the color. White is the default one. Clicking on the color will bring you the standard KDE <guilabel>Select Color</guilabel> dialog.</para></listitem> +</varlistentry> +</variablelist> +<para>The last field displays a preview of your settings, provided the color is not white!</para> +</sect3> + +<sect3 id="rectangle"> +<title><guilabel>Rectangle</guilabel></title> + +<para>This is used in the <menuchoice><guimenu>Insert</guimenu><guisubmenu>Shape</guisubmenu><guimenuitem>Rectangle</guimenuitem></menuchoice> menu.</para> + +<screenshot> +<screeninfo>The <guilabel>Rectangle</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure6c.png" format="PNG"/> +</imageobject> +<textobject><phrase>The <guilabel>Rectangle</guilabel> tab</phrase></textobject> +</mediaobject> +</screenshot> + +<para>You can choose to keep the same ratio for the two settings below by having the <inlinemediaobject><imageobject> +<imagedata fileref="link.png" format="PNG"/></imageobject></inlinemediaobject> icon or to separate the two settings by using the <inlinemediaobject><imageobject> +<imagedata fileref="break.png" format="PNG"/></imageobject></inlinemediaobject> icon.</para> +<variablelist> +<varlistentry> +<term><guilabel>Vertical declination:</guilabel></term> +<listitem><para>Set the vertical declination.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Horizontal declination:</guilabel></term> +<listitem><para>Set the horizontal declination.</para></listitem> +</varlistentry> +</variablelist> +<para>The last field displays a preview of your settings.</para> +</sect3> + +<sect3 id="polygon"> +<title><guilabel>Polygon</guilabel></title> + +<para>This is used in the <menuchoice><guimenu>Insert</guimenu><guisubmenu>Shape</guisubmenu><guimenuitem>Convex/Concave Polygon</guimenuitem></menuchoice> menu.</para> + +<screenshot> +<screeninfo>The <guilabel>Polygon</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure6d.png" format="PNG"/> +</imageobject> +<textobject><phrase>The <guilabel>Polygon</guilabel> tab</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Type:</guilabel></term> +<listitem><para>You can choose <guilabel>Polygon</guilabel> or <guilabel>Convex/Concave</guilabel>.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Corners:</guilabel></term> +<listitem><para>Set here the number of corners of the polygon.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Sharpness:</guilabel></term> +<listitem><para>Increase or decrease the sharpness of the polygon.</para></listitem> +</varlistentry> +</variablelist> +<para>The last field displays a preview of your settings.</para> +</sect3> + +<sect3 id="pie"> +<title><guilabel>Pie</guilabel></title> + +<para>This is used in the <menuchoice><guimenu>Insert</guimenu><guisubmenu>Shape</guisubmenu><guimenuitem>Pie/Arc/Chord</guimenuitem></menuchoice> menu.</para> + +<screenshot> +<screeninfo>The <guilabel>Pie</guilabel> tab</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure6e.png" format="PNG"/> +</imageobject> +<textobject><phrase>The <guilabel>Pie</guilabel> tab</phrase></textobject> +</mediaobject> +</screenshot> + +<variablelist> +<varlistentry> +<term><guilabel>Type:</guilabel></term> +<listitem><para>You can choose among three options in the dropdown box: <guilabel>Pie</guilabel>, <guilabel>Arc</guilabel> or <guilabel>Chord</guilabel>.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Start position:</guilabel></term> +<listitem><para>Set here the start position.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Length:</guilabel></term> +<listitem><para>Set the length of your pie.</para></listitem> +</varlistentry> +</variablelist> +<para>The last field displays a preview of your settings.</para> +</sect3> + +</sect2> + +<sect2 id="configure-paths"> +<title><guilabel>Paths</guilabel></title> + +<screenshot> +<screeninfo>Paths</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="configure7.png" format="PNG"/> +</imageobject> +<textobject><phrase>Paths</phrase></textobject> +</mediaobject> +</screenshot> +<para>There are two paths that are set here, the <guilabel>Backup Path</guilabel> and the <guilabel>Picture Path</guilabel>. The <guilabel>Backup Path</guilabel> is the directory where your backup files are saved and the <guilabel>Picture Path</guilabel> is the directory where your pictures are saved. Highlight a path in order to modify it and click on <guilabel>Modify Path...</guilabel>. A small dialog appears and if you uncheck <guilabel>Default path</guilabel>, you will be able either to enter a path yourself or to choose one with the standard KDE file dialog.</para> + +</sect2> + +<sect2 id="opt-tts"><title>TTS</title> + +<para>See the <link linkend="a11y-tts">Text-to-Speech</link> section +in the accessibility chapter for further details.</para> +</sect2> + + +</sect1> + +</chapter> diff --git a/doc/kpresenter/properties.png b/doc/kpresenter/properties.png Binary files differnew file mode 100644 index 00000000..a1b38c30 --- /dev/null +++ b/doc/kpresenter/properties.png diff --git a/doc/kpresenter/screen.docbook b/doc/kpresenter/screen.docbook new file mode 100644 index 00000000..f35d1116 --- /dev/null +++ b/doc/kpresenter/screen.docbook @@ -0,0 +1,44 @@ +<chapter id="screen-description"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Neil</firstname> +<surname>Lucock</surname> +<affiliation> +<address><email>neil@nlucock.freeserve.co.uk</email></address> +</affiliation> +</author> +<author> +<firstname>Krishna</firstname> +<surname>Tateneni</surname> +<affiliation> +<address><email>tateneni@pluto.njcc.com</email></address> +</affiliation> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> +<title>The &kpresenter; Screen</title> + +<para>Here is the default &kpresenter; Screen Layout.</para> + +<para>At the top there is the menubar. All &kpresenter; functions are +available from the menus, which are described in detail in <xref +linkend="menu-items" />.</para> + +<para>Below the menubar are the toolbars. There are several +toolbars. You may hide and show toolbars as you prefer. The toolbars +are described in detail in <xref linkend="toolbars" />. +</para> + +<para>The <guilabel>Outline</guilabel> and +<guilabel>Preview</guilabel> panes give an overview of your entire +presentation. The <guilabel>Preview</guilabel> pane provides +thumbnails of each slide, and allows you to drag and drop to change +the order. The <guilabel>Outline</guilabel> pane provides a +hierarchal tree of each slide, and also the objects inside the slides. +As well as overview, this allows you to easily select objects which +may be covered by others, or are otherwise difficult to grab directly on +the slide.</para> + +</chapter> diff --git a/doc/kpresenter/settings01.png b/doc/kpresenter/settings01.png Binary files differnew file mode 100644 index 00000000..db91f31c --- /dev/null +++ b/doc/kpresenter/settings01.png diff --git a/doc/kpresenter/settings03.png b/doc/kpresenter/settings03.png Binary files differnew file mode 100644 index 00000000..85d370e6 --- /dev/null +++ b/doc/kpresenter/settings03.png diff --git a/doc/kpresenter/settings04.png b/doc/kpresenter/settings04.png Binary files differnew file mode 100644 index 00000000..6f2883bd --- /dev/null +++ b/doc/kpresenter/settings04.png diff --git a/doc/kpresenter/template02.png b/doc/kpresenter/template02.png Binary files differnew file mode 100644 index 00000000..8d1ef976 --- /dev/null +++ b/doc/kpresenter/template02.png diff --git a/doc/kpresenter/template03.png b/doc/kpresenter/template03.png Binary files differnew file mode 100644 index 00000000..53efdad5 --- /dev/null +++ b/doc/kpresenter/template03.png diff --git a/doc/kpresenter/template04.png b/doc/kpresenter/template04.png Binary files differnew file mode 100644 index 00000000..f0e69a16 --- /dev/null +++ b/doc/kpresenter/template04.png diff --git a/doc/kpresenter/template05.png b/doc/kpresenter/template05.png Binary files differnew file mode 100644 index 00000000..4faa5eb2 --- /dev/null +++ b/doc/kpresenter/template05.png diff --git a/doc/kpresenter/template06.png b/doc/kpresenter/template06.png Binary files differnew file mode 100644 index 00000000..e92f9f73 --- /dev/null +++ b/doc/kpresenter/template06.png diff --git a/doc/kpresenter/template07.png b/doc/kpresenter/template07.png Binary files differnew file mode 100644 index 00000000..4e8b694f --- /dev/null +++ b/doc/kpresenter/template07.png diff --git a/doc/kpresenter/textmenu1.png b/doc/kpresenter/textmenu1.png Binary files differnew file mode 100644 index 00000000..0ed57be7 --- /dev/null +++ b/doc/kpresenter/textmenu1.png diff --git a/doc/kpresenter/textmenu2.png b/doc/kpresenter/textmenu2.png Binary files differnew file mode 100644 index 00000000..7ce121e6 --- /dev/null +++ b/doc/kpresenter/textmenu2.png diff --git a/doc/kpresenter/toolsmenu01.png b/doc/kpresenter/toolsmenu01.png Binary files differnew file mode 100644 index 00000000..f1ad7692 --- /dev/null +++ b/doc/kpresenter/toolsmenu01.png diff --git a/doc/kpresenter/tts.png b/doc/kpresenter/tts.png Binary files differnew file mode 100644 index 00000000..916f04ca --- /dev/null +++ b/doc/kpresenter/tts.png diff --git a/doc/kpresenter/tut01.png b/doc/kpresenter/tut01.png Binary files differnew file mode 100644 index 00000000..fc61e1db --- /dev/null +++ b/doc/kpresenter/tut01.png diff --git a/doc/kpresenter/tut02.png b/doc/kpresenter/tut02.png Binary files differnew file mode 100644 index 00000000..edc1f1c1 --- /dev/null +++ b/doc/kpresenter/tut02.png diff --git a/doc/kpresenter/tut03.png b/doc/kpresenter/tut03.png Binary files differnew file mode 100644 index 00000000..6f7f419c --- /dev/null +++ b/doc/kpresenter/tut03.png diff --git a/doc/kpresenter/tut04.png b/doc/kpresenter/tut04.png Binary files differnew file mode 100644 index 00000000..e609be60 --- /dev/null +++ b/doc/kpresenter/tut04.png diff --git a/doc/kpresenter/tut05.png b/doc/kpresenter/tut05.png Binary files differnew file mode 100644 index 00000000..962fcf1f --- /dev/null +++ b/doc/kpresenter/tut05.png diff --git a/doc/kpresenter/tut06.png b/doc/kpresenter/tut06.png Binary files differnew file mode 100644 index 00000000..2fd81c15 --- /dev/null +++ b/doc/kpresenter/tut06.png diff --git a/doc/kpresenter/tut07.png b/doc/kpresenter/tut07.png Binary files differnew file mode 100644 index 00000000..0320f122 --- /dev/null +++ b/doc/kpresenter/tut07.png diff --git a/doc/kpresenter/tut08.png b/doc/kpresenter/tut08.png Binary files differnew file mode 100644 index 00000000..4e479869 --- /dev/null +++ b/doc/kpresenter/tut08.png diff --git a/doc/kpresenter/tut09.png b/doc/kpresenter/tut09.png Binary files differnew file mode 100644 index 00000000..f46e7edf --- /dev/null +++ b/doc/kpresenter/tut09.png diff --git a/doc/kpresenter/tut10.png b/doc/kpresenter/tut10.png Binary files differnew file mode 100644 index 00000000..345db52a --- /dev/null +++ b/doc/kpresenter/tut10.png diff --git a/doc/kpresenter/tut11.png b/doc/kpresenter/tut11.png Binary files differnew file mode 100644 index 00000000..bc7df396 --- /dev/null +++ b/doc/kpresenter/tut11.png diff --git a/doc/kpresenter/tut12.png b/doc/kpresenter/tut12.png Binary files differnew file mode 100644 index 00000000..440e49d5 --- /dev/null +++ b/doc/kpresenter/tut12.png diff --git a/doc/kpresenter/tut13.png b/doc/kpresenter/tut13.png Binary files differnew file mode 100644 index 00000000..991f7493 --- /dev/null +++ b/doc/kpresenter/tut13.png diff --git a/doc/kpresenter/tut14.png b/doc/kpresenter/tut14.png Binary files differnew file mode 100644 index 00000000..54ee8257 --- /dev/null +++ b/doc/kpresenter/tut14.png diff --git a/doc/kpresenter/tut15.png b/doc/kpresenter/tut15.png Binary files differnew file mode 100644 index 00000000..1954661f --- /dev/null +++ b/doc/kpresenter/tut15.png diff --git a/doc/kpresenter/tut16.png b/doc/kpresenter/tut16.png Binary files differnew file mode 100644 index 00000000..1f289c11 --- /dev/null +++ b/doc/kpresenter/tut16.png diff --git a/doc/kpresenter/tut17.png b/doc/kpresenter/tut17.png Binary files differnew file mode 100644 index 00000000..c36b2af8 --- /dev/null +++ b/doc/kpresenter/tut17.png diff --git a/doc/kpresenter/tut18.png b/doc/kpresenter/tut18.png Binary files differnew file mode 100644 index 00000000..87a7fda6 --- /dev/null +++ b/doc/kpresenter/tut18.png diff --git a/doc/kpresenter/tut19.png b/doc/kpresenter/tut19.png Binary files differnew file mode 100644 index 00000000..4d469987 --- /dev/null +++ b/doc/kpresenter/tut19.png diff --git a/doc/kpresenter/tut20.png b/doc/kpresenter/tut20.png Binary files differnew file mode 100644 index 00000000..0a9c8c01 --- /dev/null +++ b/doc/kpresenter/tut20.png diff --git a/doc/kpresenter/tut21.png b/doc/kpresenter/tut21.png Binary files differnew file mode 100644 index 00000000..c1d736f2 --- /dev/null +++ b/doc/kpresenter/tut21.png diff --git a/doc/kpresenter/tut22.png b/doc/kpresenter/tut22.png Binary files differnew file mode 100644 index 00000000..b96c2f57 --- /dev/null +++ b/doc/kpresenter/tut22.png diff --git a/doc/kpresenter/tut23.png b/doc/kpresenter/tut23.png Binary files differnew file mode 100644 index 00000000..9da71f83 --- /dev/null +++ b/doc/kpresenter/tut23.png diff --git a/doc/kpresenter/tut24.png b/doc/kpresenter/tut24.png Binary files differnew file mode 100644 index 00000000..d7d20eab --- /dev/null +++ b/doc/kpresenter/tut24.png diff --git a/doc/kpresenter/tut25.png b/doc/kpresenter/tut25.png Binary files differnew file mode 100644 index 00000000..4454bcfe --- /dev/null +++ b/doc/kpresenter/tut25.png diff --git a/doc/kpresenter/tut26.png b/doc/kpresenter/tut26.png Binary files differnew file mode 100644 index 00000000..302216b5 --- /dev/null +++ b/doc/kpresenter/tut26.png diff --git a/doc/kpresenter/tutorial.docbook b/doc/kpresenter/tutorial.docbook new file mode 100644 index 00000000..a0aa1be2 --- /dev/null +++ b/doc/kpresenter/tutorial.docbook @@ -0,0 +1,510 @@ +<!-- <?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd"> + +To edit or validate this document separately, uncomment this prolog +Be sure to comment it out again when you are done --> + +<chapter id="tutorial"> +<chapterinfo> +<authorgroup> +<author> +<firstname>Neil</firstname> +<surname>Lucock</surname> +<affiliation> +<address><email>neil@nlucock.freeserve.co.uk</email></address> +</affiliation> +</author> +<author> +<firstname>Krishna</firstname> +<surname>Tateneni</surname> +<affiliation> +<address><email>tateneni@pluto.njcc.com</email></address> +</affiliation> +</author> +<author> +<firstname>Anne-Marie</firstname> +<surname>Mahfouf</surname> +<affiliation> +<address><email>annemarie.mahfouf@free.fr</email></address> +</affiliation> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> +</chapterinfo> +<title>A Step-By-Step Tutorial</title> + +<para> +In this chapter, &kpresenter; is introduced using a simple tutorial. We +shall walk through the most basic steps that are involved in creating a +presentation, and adding some basic effects. +</para> + +<sect1 id="start-new"> +<title>Start a new document</title> + +<para> +When you start &kpresenter;, the usual &koffice; startup dialog appears. +</para> + +<screenshot> +<screeninfo>The <guilabel>&koffice;</guilabel> +startup dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="tut01.png" format="PNG"/></imageobject> +<textobject><phrase>The &koffice; startup dialog</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Select <guilabel>Screen</guilabel> on the left then select the template labeled +<guilabel>Title</guilabel> (highlighted in blue in the screenshot above) by +clicking on it. You can check <guilabel>Always use this template</guilabel> to +make it the default template. +</para> + +<para> +Now click <guibutton>Use This Template</guibutton>. This brings up the slide +editor window, where you can view and edit the slides (and objects contained in +them) in your document. At the moment, we just have one slide, with one +object on it, which is a text box. +</para> + +<screenshot> +<screeninfo>The slide editor</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut02.png" format="PNG"/></imageobject> +<textobject><phrase>The slide editor</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Double-click the text box. The cursor changes to a vertical bar to show +that you can now type some text and the background of the edited area +becomes grey. +</para> + +<screenshot> +<screeninfo>The text insertion cursor</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut03.png" format="PNG"/> +</imageobject> +<textobject><phrase>The text insertion cursor</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Go ahead, type some text! +</para> + +<screenshot> +<screeninfo>Adding text</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="tut04.png" format="PNG"/></imageobject> +<textobject><phrase>Adding text</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Click away from the text to de-select the text box when you are done +typing. +</para> + +</sect1> + +<sect1 id="insert-page"> +<title>Add a new page</title> + +<para> +Let's now add a new slide to our document. To do so, click the +<guimenu>Insert</guimenu> menu, and then click on +<guimenuitem>Slide...</guimenuitem>. +</para> + +<screenshot> +<screeninfo>Inserting a slide from the menu</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="tut05.png" format="PNG"/></imageobject> +<textobject><phrase>Inserting a slide from the menu</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +This brings up the <guilabel>Insert Slide</guilabel> dialog. +</para> + +<screenshot> +<screeninfo>The <guilabel>Insert Slide</guilabel> dialog</screeninfo> +<mediaobject> +<imageobject> +<imagedata fileref="tut06.png" format="PNG"/></imageobject> +<textobject><phrase>The <guilabel>Insert Slide</guilabel> +dialog</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Select <guilabel>Use different template</guilabel> and click <guibutton>OK</guibutton> to add a +new page after page 1. +</para> + +<para> +The <guilabel>Create Document</guilabel> dialog comes up so that we can decide +what the new slide should look like. This time, select <guilabel>Screen</guilabel> on the left and double click on the +<guilabel>One Column</guilabel> template (highlighted in blue.) +</para> + +<screenshot> +<screeninfo>Choosing a template for the new page</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut07.png" format="PNG"/></imageobject> +<textobject><phrase>Choosing a template for the new +page</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +The new slide now appears in the editing window. To change between pages +of your presentation, you can select slides in the pane to the left +(highlighted in blue for this screenshot). +</para> + +<screenshot> +<screeninfo>The slides list</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut08.png" format="PNG"/></imageobject> +<textobject><phrase>The slides list</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +The newly inserted slide has two text boxes. There is one for a title, +and another to contain a bulleted list of items. +</para> + +<screenshot> +<screeninfo>The new slide</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut09.png" format="PNG"/></imageobject> +<textobject><phrase>The new slide</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Double-click and type a title. Then double-click on the second text +box with the bullet. Type some text and end the paragraph by pressing the +<keycap>Enter</keycap> or <keycap>Return</keycap> key. As you type new +paragraphs, bullets automatically appear in front of them. +</para> + +<screenshot> +<screeninfo>Adding text to the second slide</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut10.png" format="PNG"/></imageobject> +<textobject><phrase>Adding text to the second slide</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +You can de-select the text box by clicking away from it. +</para> + +</sect1> + +<sect1 id="insert-pic"> +<title>Insert a picture</title> + +<para> +Let's go back to the first slide now. Use the list of slides on the left +of your screen. +</para> + +<para> +In this section, we'll liven our presentation up a bit by adding a nice +logo to the title page. To do so, the first step is to click on the +<guimenu>Insert</guimenu> menu item, and then on +<guimenuitem>Picture...</guimenuitem>. +</para> + +<screenshot> +<screeninfo>Using the menu to add an image</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut11.png" format="PNG"/></imageobject> +<textobject><phrase>Using the menu to add an image</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +This brings up a file selection dialog. To learn about this or other +standard &kde; dialog boxes in detail, please consult the &kde; +documentation. You can browse by clicking on <guiicon>folder</guiicon> +icons or by using the <guiicon>browser</guiicon> style buttons on the +toolbar (highlighted in red.) Clicking the <guiicon>up arrow</guiicon> +takes you up one folder level. +</para> + +<para> +Find the file named <filename>koffice-logo.png</filename>, which may be +in a different folder than the one shown in the screenshot below. You +can also choose any other graphic file if you like! Select the file, and +click <guibutton>OK</guibutton>. +</para> + +<screenshot> +<screeninfo>Choosing a picture to add</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut12.png" format="PNG"/></imageobject> +<textobject><phrase>Choosing a picture to add</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Click with the &LMB; where you want to place the loge in it's original size or +draw a rectangle with the left mouse cursor to specify the position and size for the logo. +There are selection handles (little squares) visible around the border of the graphic. +</para> + +<screenshot> +<screeninfo>The newly added image</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut13.png" format="PNG"/></imageobject> +<textobject><phrase>The newly added image</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Place the mouse cursor anywhere in the middle of the logo, and drag it +to the middle of the title page. Then use the selection handles to resize +it correctly. +</para> + +<screenshot> +<screeninfo>Dragging and resizing the image</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut14.png" format="PNG"/></imageobject> +<textobject><phrase>Dragging and resizing the image</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +That's it. Now you have a picture on the title page! +</para> + +</sect1> + +<sect1 id="insert-object"> +<title>Insert a &koffice; object</title> +<para>Let's insert another &koffice; object under the picture, for example +a chart.</para> + +<para> +Every &koffice; supported document can be embedded in a &kpresenter; slide. +Let's choose a chart from &kchart;. To do so, the first step is to click on the +<guimenu>Insert</guimenu> menu item, and then +on <guisubmenu>Object</guisubmenu>. +</para> + +<screenshot> +<screeninfo>The Insert Object menu</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut24.png" format="PNG"/></imageobject> +<textobject><phrase>The Insert Object menu</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +A list of the &koffice; available components appears as submenu. +Select <guilabel>Chart</guilabel> and then outline with your mouse the area you +want to put your chart in on the &kpresenter; slide. +</para> + +<screenshot> +<screeninfo>Select the area where to put the chart</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut25.png" format="PNG"/></imageobject> +<textobject><phrase>Select the area where to put the chart</phrase></textobject> +</mediaobject> +</screenshot> + +<!--TODO check if the Open Document dialog should appear when the chart is +created and not a blank chart--> + +<para> +Once you release the mouse button, a blank chart is added on the slide. Whenever +you work in the chart, the toolbars and menubar in &kpresenter; main window are +replaced by those from &kchart;. +</para> + +<screenshot> +<screeninfo>&kchart; menus and toolbars embedded</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut26.png" format="PNG"/></imageobject> +<textobject><phrase>&kchart; menus and toolbars embedded</phrase></textobject> +</mediaobject> +</screenshot> + +<para>While you are in the chart, clicking with the &RMB; will bring the +&kchart; settings menu which allows you to modify the parameters of the chart. +Please see the &kchart; user manual to get more information on how to use +&kchart;.</para> + +<para>Click anywhere with the &LMB; outside the chart to go back to +&kpresenter; slide.</para> + +<para>A single click on the chart will allow you to drag it to change its +location and also to drag the borders to make it bigger as with any other +&kpresenter; object. Double click on the chart to get into &kchart; mode and +modify any of the chart property.</para> + +</sect1> + +<sect1 id="addshadow"> +<title>Add a shadow to the title text</title> + +<para> +Let's continue enhancing our title page by adding a shadow +behind the title. <mousebutton>Right</mousebutton> click anywhere on the +title text. This achieves two things: the text box containing the title +is selected, and a menu pops up. +</para> + +<para> +Select the <guimenuitem>Shadow Objects...</guimenuitem> option in the popup menu. +</para> + +<screenshot> +<screeninfo>The context menu</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut15.png" format="PNG"/></imageobject> +<textobject><phrase>The context menu</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +The <guilabel>Shadow</guilabel> dialog pops up. The distance between the +shadow and the text is currently 0 so the shadow cannot be seen (this +part of the dialog box is highlighted in red.) +</para> + +<screenshot> +<screeninfo>The <guilabel>Shadow</guilabel> dialog</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut16.png" format="PNG"/></imageobject> +<textobject><phrase>The <guilabel>Shadow</guilabel> +dialog</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Increase the distance value to 3. The effect of changing the distance +can be seen in the preview window. Now click <guibutton>OK</guibutton>. +</para> + +<screenshot> +<screeninfo>Adding a shadow to the title</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut17.png" format="PNG"/></imageobject> +<textobject><phrase>Adding a shadow to the title</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Now the title has a shadow! +</para> + +<screenshot> +<screeninfo>The new shadowed title</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut18.png" format="PNG"/></imageobject> +<textobject><phrase>The new shadowed title</phrase></textobject> +</mediaobject> +</screenshot> + +</sect1> + +<sect1 id="textcolor"> +<title>Change the color of the title text</title> + +<para> +Let's finish by changing the color of the title text from black to +blue. To do so, select the title text by double-clicking the text box and select the text. +</para> + +<para> +Open the <guilabel>Select Color</guilabel> dialog by clicking on the <guiicon>dark blue A</guiicon> +icon on the right side of the <guilabel>Text</guilabel> toolbar (this icon has +a Color... tooltip) or choose the <guimenu>Text</guimenu> menu and then click on +<guimenuitem>Color...</guimenuitem> and change the color to blue.</para> + +<screenshot> +<screeninfo>The color palette</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut19.png" format="PNG"/></imageobject> +<textobject><phrase>The color palette</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Click <guilabel>OK</guilabel> in the <guilabel>Select Color</guilabel> dialog. Changing the color of +the selected text to blue changes its appearance. The exact color that +highlighted text turns depends on your system color scheme. +</para> + +<screenshot> +<screeninfo>Highlighted text</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut20.png" format="PNG"/></imageobject> +<textobject><phrase>Highlighted text</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Now click away from the text to de-select it. +</para> + +<screenshot> +<screeninfo>The finished title</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut21.png" format="PNG"/></imageobject> +<textobject><phrase>The finished title</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +Now that there are two slides, why not try a slide show! To start the +slide show, press the <guiicon>play</guiicon> button (the blue double arrow) on +the <guilabel>Slide Show</guilabel> toolbar. The first slide should appear on your screen. +</para> + +<screenshot> +<screeninfo>The first slide</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut22.png" format="PNG"/></imageobject> +<textobject><phrase>The first slide</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +To advance from the first slide to the next, just click anywhere on the +screen, or use the <keycap>Page Down</keycap> key. +</para> + +<screenshot> +<screeninfo>The second slide</screeninfo> +<mediaobject> +<imageobject><imagedata fileref="tut23.png" format="PNG"/></imageobject> +<textobject><phrase>The second slide</phrase></textobject> +</mediaobject> +</screenshot> + +<para> +To exit the slide show, <mousebutton>right</mousebutton> click, and then +select the <guimenuitem>End</guimenuitem> option from the +popup menu. +</para> + +</sect1> + +</chapter> diff --git a/doc/kpresenter/zoomfactor.png b/doc/kpresenter/zoomfactor.png Binary files differnew file mode 100644 index 00000000..49973890 --- /dev/null +++ b/doc/kpresenter/zoomfactor.png |
