<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [

  <!ENTITY kappname "&cantor;">
  <!ENTITY package "kdeedu">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE"
> 
]>
<book lang="&language;">

<bookinfo>
<title
>Manuel utilisateur de &cantor;</title>

<authorgroup>
<author
><personname
> <firstname
>Alexander</firstname
> <surname
>Rieder</surname
> </personname
> <email
>alexanderrieder@gmail.com</email
> </author>
&traducteurJoelleCornavin; 
</authorgroup>

<copyright>
<year
>2009</year>
<holder
>Alexander Rieder</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2009-08-26</date>
<releaseinfo
>0.1</releaseinfo>

<abstract>
<para
>&cantor; est une application dont le but est de fournir une vue esthétique des feuilles de calcul pour d'autres paquetages de mathématiques issus du <quote
>Logiciel libre</quote
>. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>mathématiques</keyword>
<keyword
>maths</keyword>
<keyword
>Cantor</keyword>
<keyword
>Sage</keyword>
<keyword
>R</keyword>
<keyword
>Maxima</keyword>
</keywordset>

</bookinfo>

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

<para
>&cantor; est une application conçue que vous puissiez utiliser vos applications de mathématiques favorites à partir d'une élégante interface de feuilles de calcul intégrée à &kde;. Elle fournit des boîtes de dialogue d'assistants pour les tâches courantes et permet de partager vos feuilles de calcul avec d'autres utilisateurs. </para>
</chapter>

<chapter id="using-kapp">
<title
>Utilisation de &cantor;</title>

<para
>Capture d'écran : <screenshot>
<screeninfo
>Voici une capture d'écran de &cantor;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="screenshot.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Capture d'écran</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>


<sect1 id="kapp-features">
<title
>Fonctionnalités de &cantor;</title>
<itemizedlist>
  <listitem
><para
>Vue intuitive d'une feuille de calcul pour évaluer des expressions.</para
></listitem>
  <listitem
><para
>Résultats de la représentation graphique à l'intérieur de la feuille de calcul.</para
></listitem>
  <listitem
><para
>Structure simple reposant sur des modules externes permettant d'ajouter différents moteurs.</para
></listitem>
  <listitem
><para
>Intégration de nouveautés (<quote
>GetHotNewStuff</quote
>) permettant de télécharger (ou d'envoyer) des exemples de feuilles de calcul).</para
></listitem>
  <listitem
><para
>Composition de formules mathématiques à l'aide de LaTeX.</para
></listitem>
  <listitem
><para
>Coloration syntaxique prenant en compte le moteur.</para
></listitem>
  <listitem
><para
>Boîtes de dialogue reposant sur des assistants pour vous aider dans les tâches courantes, telles que l'intégration d'une fonction ou la saisie d'une matrice.</para
></listitem>
</itemizedlist>
</sect1>

<sect1 id="backends">
<title
>Les moteurs de &cantor;</title>
<para
>&cantor; offre plusieurs choix de moteurs que vous pourriez être amené à utiliser avec. Le choix dépend de ce que vous voulez réaliser. </para>
<para
>Actuellement, les moteurs suivants sont disponibles : <variablelist>
    <varlistentry>
      <term
>Sage :</term>
      <listitem>
	<para
>Sage est un progiciel de mathématiques <quote
>open source</quote
> sous licence GPL. Il combine la puissance de nombreux paquetages <quote
>open source</quote
> existants, au sein d'une interface reposant sur Python. Consultez <ulink url="http://sagemath.org"
>http://sagemath.org</ulink
> pour plus d'informations. </para>
	</listitem>
    </varlistentry>
    <varlistentry>
      <term
>Maxima :</term>
      <listitem>
	<para
>Maxima est un système de manipulation d'expressions symboliques et numériques, dont la différenciation, l'intégration, les séries de Taylor, transformées de Laplace, équations différentielles ordinaires, systèmes d'équations linéaires, polynômes, ensembles, listes, vecteurs, matrices et tenseurs. Maxima produit des résultats numériques d'une grande précision grâce à l'utilisation de fractions exactes, d'entiers à précision arbitraire et de nombres à virgule flottante à précision variable. Maxima peut tracer des fonctions et des données en deux et trois dimensions. Consultez <ulink url="http://maxima.sourceforge.net"
>http://maxima.sourceforge.net</ulink
> pour plus d'informations. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>R :</term>
      <listitem>
	<para
>R est un langage et un environnement pour le calcul statistique et le traitement graphique, similaire au langage et à l'environnement S. Il fournit une large diversité de techniques statistiques (modélisation linéaire et non linéaire, test statistiques classiques, analyse de séries chronologiques, classification, agrégation (<quote
>clustering</quote
>)...) et graphiques, tout en étant très extensible. Le langage S est souvent le véhicule de choix pour la recherche en méthodologie statistique, alors que le langage R lui fournit une route <quote
>open source</quote
>. Consultez <ulink url="http://www.r-project.org"
>http://www.r-project.org</ulink
> pour plus d'informations. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>KAlgebra :</term>
      <listitem>
	<para
>KAlgebra est une calculatrice graphique reposant sur MathML livrée avec le projet KDE Education. Consultez <ulink url="http://edu.kde.org/kalgebra/"
>http://edu.kde.org/kalgebra/</ulink
> pour plus d'informations. </para>
      </listitem>
    </varlistentry>
  </variablelist>
</para>
</sect1>

<sect1 id="workspace">
<title
>L'espace de travail de &cantor;</title>
<para>
<screenshot>
  <screeninfo
>Capture d'écran de l'espace de travail de &cantor;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="screenshot.png" format="PNG"/>
    </imageobject>
    <imageobject>
      <imagedata fileref="screenshot.eps" format="EPS"/>
    </imageobject>
    <textobject>
      <phrase
>Capture d'écran de l'espace de travail de &cantor;</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>L'interface de feuille de calcul de &cantor; est composée de trois parties : <orderedlist>
    <listitem
><para
>La barre d'onglets, où vous pouvez naviguer entre les feuilles de calcul ouvertes ;</para
></listitem>
    <listitem
><para
>Un panneau d'aide, où s'affiche l'aide pour une commande spécifique si vous saisissez <quote
>? commande</quote
> ;</para
></listitem>
    <listitem
><para
>La feuille de calcul proprement dite.</para
></listitem>
  </orderedlist>
</para>
<sect2 id="worksheet">
<title
>La feuille de calcul</title>
<para
>La feuille de calcul est la zone de travail de base pour travailler avec &cantor;. Dedans, vous pouvez saisir des expressions, autoriser le moteur à effectuer des calculs et en observer les résultats. Comme les commandes qu'accepte la feuille de calcul dépendent du moteur choisi, vous devrez apprendre la syntaxe du moteur approprié (le bouton <quote
>Afficher l'aide</quote
> vous y mène directement). Lorsque vous connaissez la commande mais que vous avez besoin d'informations complémentaires, vous pouvez saisir <quote
>? commande</quote
> et l'aide contextuelle apparaît sur la droite de la feuille de calcul. Si vous voulez voir quelques exemples de feuilles de calcul, vous pouvez aller dans <guimenuitem
>Télécharger des exemples de feuilles de calcul</guimenuitem
> dans le menu <guimenu
>Fichier</guimenu
> et télécharger les feuilles de calcul que d'autres utilisateurs ont publiées. </para>
<sect3 id="worksheet-settings">
  <title
>Configuration</title>
  <para
>Le menu <guimenu
>Configuration</guimenu
> permet de modifier certains paramètres de l'apparence de votre feuille de calcul actuelle. </para>
  <variablelist>
    <varlistentry>
      <term
>Composition à l'aide de LaTeX</term>
      <listitem>
	<para
>Cette option modifie la manière dont les résultats vous sont présentés. Si elle est cochée, cette option fait passer le résultat par le système LaTeX pour produire des formules visuellement esthétiques. Par exemple, <quote
>3*x^2*sqrt(2)*x+2/3</quote
> devient <inlinemediaobject>
	      <imageobject>
		<imagedata fileref="latex_formula.png" format="PNG"/>
	      </imageobject>
	      <imageobject>
		<imagedata fileref="latex_formula.eps" format="EPS"/>
	      </imageobject>
	      <textobject
><phrase
>3*x^2*sqrt(2)*x+2/3</phrase
></textobject>
	  </inlinemediaobject>
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>Coloration syntaxique</term>
      <listitem>
	<para
>La coloration syntaxique augmente la lisibilité du code, en mettant en surbrillance des mots clés ou en appariant des accolades dans différentes couleurs. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>Complètement</term>
      <listitem>
	<para
>Lorsque cette option est cochée, &cantor; affiche les complètements possibles pour la commande que vous saisissez actuellement quand vous appuyez sur la touche Tab. S'il ne reste qu'un seul choix, ce paramètre insère le reste de la commande à votre place. </para>
      </listitem>
    </varlistentry>
  <varlistentry>
    <term
>Numéros de ligne</term>
    <listitem>
      <para
>Ce réglage décide s'il faut ou non afficher un numéro devant les différentes expressions, ce qui permet de se rappeler de résultats antérieurs - dans Maxima, par exemple, il s'agit de la commande <quote
>%O1</quote
>. </para>
    </listitem>
  </varlistentry>
  </variablelist>
</sect3>
</sect2>
</sect1>
<!--
<sect1 id="assistant-dlgs">
<title
>The assistant dialogs</title>
TODO add screenshots and descriptions of each assistant
</sect1>
-->
</chapter>
<chapter id="commands">
<title
>Référence des commandes</title>

<sect1 id="kapp-mainwindow">
<title
>La fenêtre principale de &cantor;</title>

<sect2 id="file-menu">
<title
>Le menu <guimenu
>Fichier</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Nouveau</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Crée un nouveau document</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Enregistrer</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Enregistre le document</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Quitter</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Quitte</action
> &cantor;</para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

<sect2 id="help-menu">
<title
>Le menu <guimenu
>Aide</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>
</chapter>

<chapter id="developers">
<title
>Guide du développeur de &cantor;</title>

<para
>&cantor; est facilement extensible par des modules externes. Vous pouvez écrire <variablelist>
  <varlistentry>
    <term
>Des moteurs :</term>
    <listitem>
      <para
>Un nouveau moteur permet d'utiliser l'interface de &cantor; avec un programme différent. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>Des assistants :</term>
    <listitem>
      <para
>Les assistants fournissent des boîtes de dialogue permettant l'automatisation de tâches courantes (telles que la saisie d'une matrice ou le lancement d'un script). </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>
<para
>Pour le moment, comme il n'existe pas de tutoriels spéciaux pour les développeurs ou de documentation de l'API, si vous voulez écrire un un module externe, vous devez lire les sources du début à la fin. Toutes les définitions de l'interface sont dans le dossier /lib. Pour voir quelques exemples d'implémentations, regardez les modules externes livrés avec &cantor;. </para>

</chapter>

<chapter id="faq">
<title
>Questions et réponses</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
  <question
><para
>L'élément de menu <guimenuitem
>Composition à l'aide de LaTeX</guimenuitem
> n'est pas disponible</para
></question>
  <answer
><para
>Tous les moteurs ne prennent pas en charge toutes les options.</para
></answer>
</qandaentry>
<qandaentry>
  <question
><para
>J'ai installé Sage / Maxima, mais le moteur approprié n'apparaît pas.</para
></question>
  <answer>
    <para
>Une explication possible est que &cantor; n'a pas correctement détecté l'emplacement. Vérifiez dans la boîte de dialogue <quote
>Configuration</quote
> et modifiez l'emplacement de l'application appropriée. </para>
  </answer>
</qandaentry>
<qandaentry>
  <question
><para
>Quel nom particulier - qu'a-t-il à voir avec les mathématiques ?</para
></question>
  <answer
><para
>Le nom donné à &cantor; vient du mathématicien allemand Georg Cantor, l'auteur de la théorie des ensembles.</para
></answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Remerciements et licence</title>

<para
>&cantor; </para>
<para
>Programme sous copyright 2009 Alexander Rieder <email
>alexanderrieder@gmail.com</email
> </para>

<para
>Documentation sous copyright &copy; 2009 Alexander Rieder <email
>alexanderrieder@gmail.com</email
> </para>

<para
>Traduction française par &JoelleCornavin;.</para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-kapp">
<title
>Comment obtenir &cantor;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Prérequis</title>

<para
>Pour pouvoir employer &cantor; avec succès, il vous faut &kde; 4. Si vous souhaitez que la prise en charge de la composition soit activée, installez LaTeX et LibSpectre. Pour utiliser les différents moteurs, le paquetage de mathématiques approprié est requis. </para>

<!--
<para>
All required libraries as well as &cantor; itself can be found
on <ulink url="ftp://ftp.kapp.org"
>The &cantor; home page</ulink
>.
</para>
-->


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

<sect1 id="compilation">
<title
>Compilation et installation</title>
&install.compile.documentation; </sect1>

<sect1 id="configuration">
<title
>Configuration</title>

<para
>Selon votre système, vous pouvez être amené à ajuster les emplacements des différentes applications que &cantor; utilise. </para>

</sect1>

</appendix>

&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;
-->
