<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!-- Define an entity for your application if it is not part of KDE
       Git -->
  <!ENTITY gcompris "<application>GCompris</application>">
  <!ENTITY kappname "&gcompris;"><!-- replace kmyapplication here
                                            do *not* replace kappname-->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE"> <!-- ONLY If you are writing non-English
                                     original documentation, change
                                     the language here -->

  <!-- Do not define any other entities; instead, use the entities
       from entities/general.entities and en/user.entities. -->
]>
<book id="gcompris" lang="&language;">

<bookinfo>
<title>The &gcompris; Administration Handbook</title>

<authorgroup>
<author>
<personname>
<firstname>This documentation was converted from the 
<ulink url="https://gcompris.net/wiki/Manual">&gcompris; Manual</ulink> 
page.</firstname>
<surname></surname>
</personname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<legalnotice>&FDLNotice;</legalnotice>

<!-- Date of the documentation
Don't forget to include this last date.
Please respect the format of the date (YYYY-MM-DD),it is used by scripts.
-->
<date>2016-01-24</date>

<!--version information of the application and kde this documentation is valid for.
for example 'xx.yy.zz'
-->
<releaseinfo>0.52</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para>
&gcompris; is a multi-activity educational software.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>education</keyword>
<keyword>children</keyword>
<keyword>games</keyword>
</keywordset>

</bookinfo>

<chapter id="administration-handbook">
<title>Administration Handbook</title>

<sect1 id="introduction">
<title>Introduction</title>
<para>&gcompris; is a completely free educational software suite which contains a wide range of activities.</para>
<para>It offers various activities aimed at covering a variety of fields such as the functioning of the computer, 
using the mouse and keyboard, general learning, reading, writing, foreign languages, algebra, as well as various 
activities such as memory and logic games, scientific experiments &etc;.</para>
<para>In &gcompris; you will find many individual software packages which together make up the complete &gcompris; 
suite of activities. Unfortunately, it is difficult to follow and maintain them as each one offers different 
graphic interfaces which vary widely in quality.</para>
<para>The purpose of &gcompris; is to provide a development platform for educational activities.</para>
<para>&gcompris; is part of &kde; project and is placed under the <ulink url="https://www.gnu.org/licenses/gpl.html">GPL license</ulink>.</para>
</sect1>

<sect1 id="minimal-configuration">
<title>Minimal configuration</title>
<itemizedlist>
<listitem><para>Processor : 1.6GHz Atom CPU</para></listitem> 
<listitem><para>Memory (RAM) : 1 Giga Byte</para></listitem> 
<listitem><para>Disk : 300 Mega Bytes</para></listitem> 
<listitem><para>Operating system : &GNU;/&Linux;, &BSD;, MacOSX, &Windows;, Android, SailfishOS</para></listitem> 
<listitem><para>Video : A 3D card with support of <emphasis>OpenGL 2.1</emphasis> or higher is required. 32 bits color depth mandatory</para></listitem>
</itemizedlist>
</sect1>

<sect1 id="installation">
<title>Installation</title>
<para>The software is delivered under several forms. Follow the process according to your case. </para>
<itemizedlist>
<listitem><para>&GNU;/&Linux; : Use the packages delivered by your &GNU;/&Linux; distribution. You may have to install 
the package gcompris-sound-en to have the English voices. If &gcompris; is not packaged in your &Linux; distribution, 
please contact them to ask for the inclusion of &gcompris; in your &Linux; distribution.</para></listitem>
<listitem><para>&Windows; : Delivered under a classic installer for &Windows;. This version requires an activation code. </para></listitem>
<listitem><para>MacOSX : Delivered under a classic installer. This version requires an activation code.</para></listitem>
</itemizedlist>
</sect1>

<sect1 id="user-interface">
<title>The User Interface</title>
<para>The interface is designed for easy use by small children. &gcompris; is controlled with a mouse, 
it cannot be used without a mouse or a pointing system.</para>

<sect2 id="main-window">
<title>Main window</title>
<para>When you start the program, &gcompris; shows a graphic interface which presents the list of activities 
with a control bar at the bottom.</para>
<screenshot>
<screeninfo>Here's a screenshot of &gcompris; Main Window</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="gcompris-main-menu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>&gcompris; Main Window</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<para>Each icon represents an activity. Around each one, you can find small icons which give additional information 
about the activity. A simple click on the icon will lead you to an activity or a menu of activities. There are 8 sections 
(categories) of activities, which placed on the top or on the left (only if your orientation is portrait). For example, 
there is section "Board games", which includes board games, like chess, tic tac toe or align four</para>
<para>The stars indicates the age group for which each game is designed:</para> 
<itemizedlist>
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="difficulty1.svg" format="SVG"/></imageobject>
</inlinemediaobject>1, 2 or 3 yellow stars - for 2 to 6 years old.</para></listitem> 
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="difficulty4.svg" format="SVG"/></imageobject>
</inlinemediaobject>1, 2 or 3 red stars - greater than 6 years old.</para></listitem> 
</itemizedlist>

<para>At the bottom of the screen there is a control bar for &gcompris;. The following icons are described below from 
the right to the left (the icons are only displayed if they are available in the activity):</para>
<itemizedlist>
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="bar_home.svg" format="SVG"/></imageobject>
</inlinemediaobject> Home - Leaves the current activity, returns to the previous menu.</para></listitem> 
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="bar_ok.svg" format="SVG"/></imageobject>
</inlinemediaobject> "OK" - Validate, confirm your answer. Some activities do not detect automatically whether or 
not the child has completed the task. In this case, you have to click on this icon. You can also use the &Enter; 
key on your keyboard.</para></listitem> 
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="bar_previous.svg" format="SVG"/></imageobject></inlinemediaobject>
<inlinemediaobject><imageobject><imagedata fileref="bar_next.svg" format="SVG"/></imageobject></inlinemediaobject> 
Arrows - The present level is displayed. Click on one of the arrows to select another level. 
Generally, the activities offer several levels whose numbers depend on the activity. 
In &gcompris;, it is possible to go to the next level without having completed the current level.</para></listitem> 
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="bar_repeat.svg" format="SVG"/></imageobject>
</inlinemediaobject> Lips - Ask &gcompris; to repeat the question.</para></listitem> 
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="bar_help.svg" format="SVG"/></imageobject>
</inlinemediaobject> Question mark - Display the help dialog box. Sometimes, an activity can be too complex 
to be described easily in the description area. In this case, this function gives access to additional information.</para></listitem> 
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="bar_config.svg" format="SVG"/></imageobject>
</inlinemediaobject> Tool box - Configuration menu. The configuration is saved in the user repository (folder) 
under the name <filename>.config/gcompris/gcompris.conf</filename>. This is a text file which can be edited manually.</para></listitem> 
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="bar_about.svg" format="SVG"/></imageobject>
</inlinemediaobject> Capital "G" - Information box on &gcompris;, presents the main contributors and the version of the software.</para></listitem> 
<listitem><para><inlinemediaobject><imageobject><imagedata fileref="bar_exit.svg" format="SVG"/></imageobject>
</inlinemediaobject> Power - Quit &gcompris;. You can also use the short cut on your keyboard 
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></para></listitem> 
</itemizedlist>
</sect2>

<sect2 id="kiosk-mode">
<title>Kiosk Mode</title>
<para>When you use &gcompris; with small children or on a self-service kiosk, you can disable a certain number of options:</para>
<itemizedlist>
<listitem><para><userinput><command>gcompris --disable-quit</command></userinput> : disable the <guiicon>Quit</guiicon> button.</para></listitem> 
<listitem><para><userinput><command>gcompris -f</command></userinput> : run &gcompris; in fullscreen mode</para></listitem> 
<listitem><para><userinput><command>gcompris -C</command></userinput> : disable the cursor (touch screen mode)</para></listitem> 
</itemizedlist>
<para>These options can of course be combined.</para>
</sect2>

<sect2 id="keyboard-shortcuts">
<title>Keyboard Shortcuts</title>
<informaltable>
<tgroup cols="2">
<tbody>
<row>
<entry>Shortcut</entry>
<entry>Action</entry>
</row>
<row>
<entry>&Esc; or <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></entry>
<entry>Quit the current activity or dialog then return to the main menu</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry>
<entry>Quit &gcompris; without further notice</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></entry>
<entry>Toggle fullscreen mode</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></entry>
<entry>Toggle sound mute</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></entry>
<entry>Display or Hide the control bar</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>

</sect1>

<sect1 id="internationalization">
<title>Notes on Internationalization</title>
<para>&gcompris; is internationalized and is available in more than 50 languages. If you want 
to check if your language is available, you can start &gcompris; and select your language in 
the option of configuration.</para>
<para>Be careful, your operating system must support your language so that &gcompris; can use it. 
If you find a red cross while selecting a language in &gcompris;, this means that your system does not 
support it, even if a translation is available in &gcompris;.</para> 
<para>On &GNU;/&Linux;, if your language is not available, select another language support on your 
distribution to add it. In most cases, you have to install an additional package 'locale-xx' or 
'language-pack-xx' - xx is a language code such as 'En' for English. </para>
<para>If your language is not supported, you can contribute to the software and add the 
translation of your language. If you are interested, you can contact the 
<ulink url="https://l10n.kde.org/teams">translation team</ulink> of 
the &kde; project for your language. You can check the level of translation for your language on 
the <ulink url="https://l10n.kde.org/">&kde; translation web site</ulink>.</para>
</sect1>

<sect1 id="learning-language">
<title>Language learning</title>
<para>You can use &gcompris; in a foreign language that you are learning. Select a foreign language 
in the configuration menu. Do not forget to install the optional audio modules for this language in 
your &GNU;/&Linux; distribution.</para>
<para>&Windows; version is provided with all audio support that are available. Whilst using &gcompris; 
in another language it is possible to configure some activities more precisely using the audio set 
through the administration module.</para>
</sect1>

<sect1 id="customizing-activities">
<title>Customizing activities</title>
<para>You can customize some activities using tool button in them. For example, you can set lang in 
some text activities (like wordsgame), or make it show real car images instead of filled rectangles 
(traffic)</para>
<screenshot>
<screeninfo>Select mode of activity "Traffic"</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="traffic-select-mode.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>Select mode of activity "Traffic"</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</sect1>

<sect1 id="console-switches">
<title>Console Switches</title>
<para>Running &gcompris; from a command console with the --help option will display all the parameters it accepts:</para>
<informaltable>
<tgroup cols="2">
<tbody>
<row>
<entry>-f, --fullscreen</entry>
<entry>Run &gcompris; in fullscreen mode</entry>
</row>
<row>
<entry>-w, --window</entry>
<entry>Run &gcompris; in window mode</entry>
</row>
<row>
<entry>-s, --sound</entry>
<entry>Run &gcompris; with sound enabled</entry>
</row>
<row>
<entry>-m, --mute</entry>
<entry>Run &gcompris; without sound</entry>
</row>
<row>
<entry>-c, --cursor</entry>
<entry>Run &gcompris; with the default system cursor</entry>
</row>
<row>
<entry>-C, --nocursor</entry>
<entry>Run &gcompris; without cursor (touch screen mode)</entry>
</row>
<row>
<entry>-v, --version</entry>
<entry>Print the version of &gcompris;</entry>
</row>
<row>
<entry>--export-activities-as-sql</entry>
<entry>Export activities as SQL</entry>
</row>
<row>
<entry>--enable-config</entry>
<entry>Enable the config button (default)</entry>
</row>
<row>
<entry>--disable-config</entry>
<entry>Disable the config button</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<sect2 id="windows-example">
<title>&Windows; Example</title>
<para>You can add these switches in the desktop icon properties. Here is an example that runs &gcompris; in kiosk mode in full screen, without config button and cursor:</para>
<para><userinput><command>"C:\Program Files\Gcompris\gcompris-qt.exe" --disable-config -f -C</command></userinput></para>
</sect2>

<sect2 id="gnu-linux-example">
<title>&GNU;/&Linux; Example</title>
<para>Create an application launcher and configure the command line parameters. Here is an example that runs &gcompris; in kiosk mode in full screen, without config button and cursor:</para> 
<para><userinput><command>gcompris-qt --disable-config -f -C</command></userinput></para>
</sect2>

</sect1>

</chapter>
<chapter id="credits">

<title>Credits and License</title>

<para>
&gcompris;
</para>
<para>
Program copyright 2000-2018 Bruno Coudoin and others
</para>

<para>
Documentation Copyright see the 
<ulink url="https://gcompris.net/mediawiki-1.31.0/index.php?title=Manual&amp;action=history">Manual page history</ulink>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

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

&underGPL;        	 <!-- GPL License -->

</chapter>

&documentation.index;
</book>

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

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->