<?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 % Italian "INCLUDE"
> 
]>
<book lang="&language;">

<bookinfo>
<title
>Manuale di &cantor;</title>

<authorgroup>
<author
><personname
> <firstname
>Alexander</firstname
> <surname
>Rieder</surname
> </personname
> <email
>alexanderrieder@gmail.com</email
> </author>
<othercredit role="translator"
><firstname
>Pino</firstname
><surname
>Toscano</surname
><affiliation
><address
><email
>toscano.pino@tiscali.it</email
></address
></affiliation
><contrib
>Traduzione italiana</contrib
></othercredit
> 
</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; mira a fornire una comoda interfaccia a fogli di lavoro per altri software matematici. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>matematica</keyword>
<keyword
>matematica</keyword>
<keyword
>Cantor</keyword>
<keyword
>Sage</keyword>
<keyword
>R</keyword>
<keyword
>Maxima</keyword>
</keywordset>

</bookinfo>

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

<para
>&cantor; è un'applicazione che ti permette di usare le tue applicazioni matematiche preferite da una elegante interfaccia a fogli di lavoro integrata in &kde;. Fornisce assistenti per aiutare con le operazioni comuni e ti permette di condividere i tuoi fogli di lavoro con altre persone. </para>
</chapter>

<chapter id="using-kapp">
<title
>Uso di &cantor;</title>

<para
>Immagine: <screenshot>
<screeninfo
>Ecco un'immagine di &cantor;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="screenshot.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Immagine</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>


<sect1 id="kapp-features">
<title
>Funzioni di &cantor;</title>
<itemizedlist>
  <listitem
><para
>Intuitiva vista a fogli di lavoro per la valutazione di espressioni.</para
></listitem>
  <listitem
><para
>Risultati del disegno di grafici mostrati nel foglio di lavoro.</para
></listitem>
  <listitem
><para
>Semplice struttura ad estensioni che permette di aggiungere vari backend.</para
></listitem>
  <listitem
><para
>Integrazione con il sistema «Scarica le novità» di &kde; che permette di scaricare o inviare fogli di lavoro.</para
></listitem>
  <listitem
><para
>Scrittura di formule matematiche usando LaTeX.</para
></listitem>
  <listitem
><para
>Evidenziazione della sintassi specifica per backend.</para
></listitem>
  <listitem
><para
>Estensioni per assistenti per aiutare con operazioni comuni, ad esempio l'integrazione di una funzione o l'inserimento di una matrice.</para
></listitem>
</itemizedlist>
</sect1>

<sect1 id="backends">
<title
>Backend di &cantor;</title>
<para
>&cantor; offre diversi backend da usare. La scelta del backend dipende dagli obiettivi da realizzare. </para>
<para
>Al momento, sono disponibili i seguenti backend: <variablelist>
    <varlistentry>
      <term
>Sage:</term>
      <listitem>
	<para
>Sage è un software matematico libero open source rilasciato secondo i termini della licenza GPL. Combina la potenza di molti pacchetti open source in un'unica interfaccia basata su Python. Per maggiori informazioni, consulta <ulink url="http://sagemath.org"
>http://sagemath.org</ulink
> </para>
	</listitem>
    </varlistentry>
    <varlistentry>
      <term
>Maxima:</term>
      <listitem>
	<para
>Maxima è un sistema per la manipolazione di espressioni simboliche e numeriche, includendo differenziazione, integrazione, serie di Taylor, trasformate di Laplace, equazioni differenziali ordinarie, sistemi di equazioni lineari, polinomi, e di insiemi, liste, vettori, matrici e tensori. Maxima ottiene risultati numeri ad alta precisione usando frazioni esatta, numeri interi di precisione arbitraria e numeri in virgola mobile a precisione variabile. Maxima può disegnare il grafico di funzioni e dati in due e tre dimensioni. Per maggiori informazioni, consulta <ulink url="http://maxima.sourceforge.net"
>http://maxima.sourceforge.net</ulink
> </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>R:</term>
      <listitem>
	<para
>R è un linguaggio di programmazione e un ambiente per l'analisi e il disegno statistico, simile al linguaggio di programmazione e ambiente S. Dispone di un'ampia varietà di tecniche statistiche (modellazione lineare e non lineare, classici test di statistica, analisi di serie storiche, classificazione, clustering, ...) e di disegno; inoltre è altamente estensibile. Spesso il linguaggio S è scelto per le ricerche statistiche, e R fornisce un modo open source per prendere parte a quella attività. Per maggiori informazioni, consulta <ulink url="http://www.r-project.org"
>http://www.r-project.org</ulink
> </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>KAlgebra:</term>
      <listitem>
	<para
>KAlgebra è una calcolatrice grafica basata su MathML, fornita come parte del progetto «KDE Education». Per maggiori informazioni, consulta <ulink url="http://edu.kde.org/kalgebra/"
>http://edu.kde.org/kalgebra/</ulink
>. </para>
      </listitem>
    </varlistentry>
  </variablelist>
</para>
</sect1>

<sect1 id="workspace">
<title
>Il foglio di lavoro di &cantor;</title>
<para>
<screenshot>
  <screeninfo
>Immagine del foglio di lavoro di &cantor;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="screenshot.png" format="PNG"/>
    </imageobject>
    <imageobject>
      <imagedata fileref="screenshot.eps" format="EPS"/>
    </imageobject>
    <textobject>
      <phrase
>Immagine del foglio di lavoro di &cantor;</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>L'interfaccia di un foglio di lavoro di &cantor; consiste in tre parti: <orderedlist>
    <listitem
><para
>la barra delle schede, che puoi usare per cambiare il foglio di lavoro aperto;</para
></listitem>
    <listitem
><para
>un pannello di aiuto, dove viene mostrata la guida di un comando specifico se inserisci «? comando»;</para
></listitem>
    <listitem
><para
>il foglio di lavoro.</para
></listitem>
  </orderedlist>
</para>
<sect2 id="worksheet">
<title
>Il foglio di lavoro</title>
<para
>Il foglio di lavoro è l'area principale usata per lavorare in &cantor;. Usando i fogli di lavoro puoi inserire espressioni, permettere ai backend di effettuare calcoli e osservare i risultati. I comandi accettati dai fogli di lavoro dipendono dal backend usato, quindi dovresti imparare la sintassi corretta a seconda del backend (il pulsante «Mostra aiuto» te la mostra direttamente). Se conosci un comando, ma hai bisogno di informazioni aggiuntive, puoi scrivere «? comando», facendo così apparire l'aiuto contestuale a destra del foglio di lavoro. Se vuoi vedere alcuni fogli di lavoro d'esempio, puoi scegliere <guimenuitem
>Scarica fogli di lavoro d'esempio</guimenuitem
> dal menu <guimenu
>File</guimenu
> e scaricare quindi i fogli di lavoro che altri utenti hanno pubblicato. </para>
<sect3 id="worksheet-settings">
  <title
>Impostazioni</title>
  <para
>Il menu <guimenu
>Impostazioni</guimenu
> ti permette di modificare alcune impostazioni dell'aspetto del foglio di lavoro corrente. </para>
  <variablelist>
    <varlistentry>
      <term
>Scrittura usando LaTeX</term>
      <listitem>
	<para
>Questa impostazione cambia il modo in cui i risultati sono mostrati. Se abilitata, i risultati sono passati al sistema LaTeX, producendo formule eleganti. Ad esempio, <quote
>3*x^2*sqrt(2)*x+2/3</quote
> diventa <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
>Evidenziazione della sintassi</term>
      <listitem>
	<para
>L'evidenziazione della sintassi aumenta la leggibilità del codice, evidenziando con vari colori le parole chiave o le parentesi corrispondenti. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>Completamento delle parole</term>
      <listitem>
	<para
>Quando questa opzione è abilitata, premendo il tasto Tab &cantor; mostrerà i possibili completamenti per il comando che stai scrivendo. Se c'è solo una scelta possibile, il resto del comando sarà inserito automaticamente. </para>
      </listitem>
    </varlistentry>
  <varlistentry>
    <term
>Numeri di riga</term>
    <listitem>
      <para
>Questa impostazione controlla se ci dovrebbe essere un numero prima di ogni espressione. Ciò permette di richiamare i risultati più vecchi &mdash; ad esempio, in Maxima ciò viene fatto con il comando <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
>Guida ai comandi</title>

<sect1 id="kapp-mainwindow">
<title
>La finestra principale di &cantor;</title>

<sect2 id="file-menu">
<title
>Il menu <guimenu
>File</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Nuovo</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Crea un nuovo documento</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Salva</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Salva il documento</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Esci</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Esce</action
> da &cantor;</para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

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

</sect1>
</chapter>

<chapter id="developers">
<title
>Guida di &cantor; allo sviluppatore</title>

<para
>Le funzionalità di &cantor; possono essere aumentate con estensioni. Puoi scrivere <variablelist>
  <varlistentry>
    <term
>Backend:</term>
    <listitem>
      <para
>Un nuovo backend permette di usare l'interfaccia di &cantor; con un programma diverso. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>Assistenti:</term>
    <listitem>
      <para
>Gli assistenti forniscono finestra di dialogo per automatizzare operazioni comuni (tipo l'inserimento di una matrice o l'avvio di uno script). </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>
<para
>Al momento, non c'è alcuna esercitazione per sviluppatori o documentazione della API, quindi se vuoi scrivere un'estensione dovrai leggere i sorgenti. Le definizioni di tutte le interfacce sono nella directory «lib». Per alcuni esempi di implementazioni, guarda le estensioni fornite con &cantor;. </para>

</chapter>

<chapter id="faq">
<title
>Domande e risposte</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
  <question
><para
>La voce di menu <guimenuitem
>Scrittura usando LaTeX</guimenuitem
> non è disponibile</para
></question>
  <answer
><para
>Non tutti i backend supportano tutte le opzioni.</para
></answer>
</qandaentry>
<qandaentry>
  <question
><para
>Ho installato Sage/Maxima, ma il backend corrispondente non appare.</para
></question>
  <answer>
    <para
>Una possibile spiegazione è che &cantor; non ne ha trovato la posizione. Vai nella finestra di dialogo delle impostazioni e modifica il percorso dell'applicazione. </para>
  </answer>
</qandaentry>
<qandaentry>
  <question
><para
>Che nome strano – cosa ha che fare con la matematica?</para
></question>
  <answer
><para
>Cantor è chiamato così in onore del matematico tedesco Georg Cantor, il creatore della teoria degli insiemi.</para
></answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Ringraziamenti e licenza</title>

<para
>&cantor; </para>
<para
>Copyright del programma 2009 Alexander Rieder <email
>alexanderrieder@gmail.com</email
> </para>

<para
>Copyright della documentazione &copy; 2009 Alexander Rieder <email
>alexanderrieder@gmail.com</email
> </para>

<para
>Traduzione italiana di Pino Toscano <email
>toscano.pino@tiscali.it</email
></para
> 
&underFDL; &underGPL; </chapter>

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

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

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

<para
>Per usare &cantor; hai bisogno di &kde; 4. Se vuoi il supporto alla scrittura elegante di formule, devi installare LaTeX e LibSpectre. Per usare i vari backend, i pacchetti matematici appropriati sono richiesti. </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
>Compilazione e installazione</title>
&install.compile.documentation; </sect1>

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

<para
>A seconda del tuo sistema, potresti dover impostare i percorsi delle varie applicazioni usate da &cantor;. </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;
-->