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

<bookinfo>
<title
>O manual do &cantor;</title>

<authorgroup>
<author
><personname
> <firstname
>Alexander</firstname
> <surname
>Rieder</surname
> </personname
> <email
>alexanderrieder@gmail.com</email
> </author>
<othercredit role="translator"
><firstname
>Marcus</firstname
> <surname
>Gama</surname
><affiliation
><address
> <email
>marcus.gama@gmail.com</email
></address
></affiliation
><contrib
>Tradução</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
>O &cantor; é uma aplicação que pretende fornecer uma área de trabalho agradável para outros pacotes matemáticos de 'Software' Livre. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>Matemática</keyword>
<keyword
>matemática</keyword>
<keyword
>Cantor</keyword>
<keyword
>Sage</keyword>
<keyword
>R</keyword>
<keyword
>Maxima</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &cantor; é uma aplicação que lhe permite usar as suas aplicações matemáticas favoritas dentro de uma interface de área de trabalho agradável e integrada no &kde;. Ele oferece janelas de assistência para as tarefas mais comuns e permite-lhe compartilhar as suas folhas de cálculo com os outros. </para>
</chapter>

<chapter id="using-kapp">
<title
>Usando o &cantor;</title>

<para
>Captura de tela: <screenshot>
<screeninfo
>Aqui está uma captura de tela do &cantor;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="screenshot.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Captura de tela</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>


<sect1 id="kapp-features">
<title
>Recursos do &cantor;</title>
<itemizedlist>
  <listitem
><para
>Uma área de trabalho agradável para avaliar expressões.</para
></listitem>
  <listitem
><para
>Área para visualizar os gráficos dos resultados na área de trabalho.</para
></listitem>
  <listitem
><para
>Uma estrutura simples e baseada em 'plugins' para adicionar diferentes infra-estruturas.</para
></listitem>
  <listitem
><para
>Integração do GetHotNewStuff para obter folhas de cálculo de exemplo (ou enviá-las.)</para
></listitem>
  <listitem
><para
>Formatação das fórmulas matemáticas com o LaTeX.</para
></listitem>
  <listitem
><para
>Realce de sintaxe ciente da infra-estrutura.</para
></listitem>
  <listitem
><para
>Janelas de assistência baseadas em 'plugins' para as tarefas mais comuns, como a integração de uma função ou a inserção de uma matriz.</para
></listitem>
</itemizedlist>
</sect1>

<sect1 id="backends">
<title
>As infraestruturas do &cantor;</title>
<para
>O &cantor; oferece diversas opções para a infra-estrutura que você poderá usar à vontade. A sua escolha deverá depender da tarefa que pretende efetuar. </para>
<para
>Atualmente, estão disponíveis as seguintes infra-estruturas: <variablelist>
    <varlistentry>
      <term
>Sage:</term>
      <listitem>
	<para
>O Sage é um sistema de 'software' matemático livre e 'open-source', licenciado sob a GPL. Combina o poder de muitos pacotes 'open-source' existentes com uma interface comum e baseada em Python. Veja mais informações em <ulink url="http://sagemath.org"
>http://sagemath.org</ulink
>. </para>
	</listitem>
    </varlistentry>
    <varlistentry>
      <term
>Maxima:</term>
      <listitem>
	<para
>O Maxima é um sistema para a manipulação de expressões simbólicas e numéricas, incluindo a derivação, a integração, as séries de Taylor, as transformadas de Laplace, as equações diferenciais ordinárias, os sistemas de equações lineares, os polinômios e os conjuntos, listas, vetores, matrizes e tensores. O Maxima oferece resultados numéricos de alta precisão, usando frações exatas, inteiros de precisão arbitrária e números de vírgula flutuante de precisão variável. O Maxima pode desenhar gráficos das funções e de dados em duas e três dimensões. Veja o <ulink url="http://maxima.sourceforge.net"
>http://maxima.sourceforge.net</ulink
> para obter mais informações. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>R:</term>
      <listitem>
	<para
>O R é uma linguagem e um ambiente para a computação e gráficos estatísticos, de forma semelhante à da linguagem e ambiente S. Oferece uma grande variedade de técnicas gráficas e estatísticas (modelação linear e não-linear, testes estatísticos clássicos, análises de séries temporais, classificação, agrupamentos, ...), sendo também altamente extensível. A linguagem S é normalmente o veículo de escolha para a investigação de metodologias estatísticas, sendo que o R oferece uma rota 'open-source' para participar nessa atividade. Veja mais informações em <ulink url="http://www.r-project.org"
>http://www.r-project.org</ulink
>. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>KAlgebra:</term>
      <listitem>
	<para
>O KAlgebra é uma calculadora gráfica, baseada NO MathML, que vem com o projeto de educação do KDE. Veja mais informações em <ulink url="http://edu.kde.org/kalgebra/"
>http://edu.kde.org/kalgebra/</ulink
>. </para>
      </listitem>
    </varlistentry>
  </variablelist>
</para>
</sect1>

<sect1 id="workspace">
<title
>O Espaço de Trabalho do &cantor;</title>
<para>
<screenshot>
  <screeninfo
>Imagem do Espaço de Trabalho do &cantor;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="screenshot.png" format="PNG"/>
    </imageobject>
    <imageobject>
      <imagedata fileref="screenshot.eps" format="EPS"/>
    </imageobject>
    <textobject>
      <phrase
>Imagem do Espaço de Trabalho do &cantor;</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>A interface da folha de cálculo do &cantor; consiste de três partes: <orderedlist>
    <listitem
><para
>A barra de páginas, onde você poderá circular entre as folhas de cálculo abertas;</para
></listitem>
    <listitem
><para
>Um painel de ajuda, onde você poderá obter ajuda sobre um determinado comando com a sintaxe "? comando";</para
></listitem>
    <listitem
><para
>A folha de cálculo em si.</para
></listitem>
  </orderedlist>
</para>
<sect2 id="worksheet">
<title
>A Folha de Cálculo</title>
<para
>A folha de cálculo é a área básica para trabalhar com o &cantor;. Nela, você poderá introduzir as expressões, deixar que a infra-estrutura faça os seus cálculos e olhar para os resultados. Os comandos que as folhas de cálculo aceitam dependem da infra-estrutura escolhida, sendo que você deverá aprender a sintaxe apropriada (o botão Mostrar a Ajuda o leva diretamente para a documentação). Se souber o comando, mas precisar de informações adicionais, você poderá escrever "? comando", para que apareça uma ajuda de contexto à direita da área de trabalho. Se você quiser ver folhas de exemplo, poderá ir à opção <guimenuitem
>Obter Folhas de Exemplo</guimenuitem
> no menu <guimenu
>Arquivo</guimenu
> e obter as folhas que outros usuários tiverem publicado. </para>
<sect3 id="worksheet-settings">
  <title
>Configurações</title>
  <para
>O menu de <guimenu
>Configurações</guimenu
> permite-lhe alterar algumas opções da aparência da sua folha de cálculo atual. </para>
  <variablelist>
    <varlistentry>
      <term
>Formatação com o LaTeX</term>
      <listitem>
	<para
>Esta opção muda a forma como os resultados são apresentados a si. Se estiver ativada, irá passar o resultado pelo sistema LaTeX, de modo a produzir fórmulas apelativas visualmente. Por exemplo, o <quote
>3*x^2*sqrt(2)*x+2/3</quote
> transforma-se em <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
>Realce de Sintaxe</term>
      <listitem>
	<para
>O Realce de Sintaxe aumenta a legibilidade do código, realçando as palavras-chave ou os parêntesis correspondentes com cores diferentes. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>Completação com Tabulação</term>
      <listitem>
	<para
>Quando esta opção estiver ativa, o &cantor; mostrará completações possíveis para o comando que estiver digitando no momento, ao usar a tecla Tab. Se só existir uma escolha possível, ele irá inserir o resto do comando para você. </para>
      </listitem>
    </varlistentry>
  <varlistentry>
    <term
>Números de Linha</term>
    <listitem>
      <para
>Esta opção controla se as diferentes expressões deverão ter um número à frente, de modo que, se possível, possa por exemplo no Maxima voltar a invocar os resultados mais antigos com o 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
>Referência de comandos</title>

<sect1 id="kapp-mainwindow">
<title
>A janela principal do &cantor;</title>

<sect2 id="file-menu">
<title
>O menu <guimenu
>Arquivo</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Novo</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Cria um novo documento</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Salvar</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Salva o documento</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sai</action
> do &cantor;</para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

<sect2 id="help-menu">
<title
>O Menu <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>
</chapter>

<chapter id="developers">
<title
>Guia de Programação do &cantor;</title>

<para
>O &cantor; é facilmente extensível com 'plugins'. Você poderá criar <variablelist>
  <varlistentry>
    <term
>Infraestruturas:</term>
    <listitem>
      <para
>Uma nova infra-estrutura permite-lhe usar a interface do &cantor; com um programa diferente. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>Assistentes:</term>
    <listitem>
      <para
>Os assistentes são janelas que automatizam as tarefas mais comuns (como a inserção de uma matriz ou a execução de um programa.) </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>
<para
>Atualmente, não existe nenhum tutorial de desenvolvimento ou documentação da API; por isso, se precisar criar um 'plugin', você terá que consultar o código. Todas as definições da interface estão na pasta 'lib'. Para as implementações de exemplo, veja alguns dos 'plugins' que vêm com o &cantor;. </para>

</chapter>

<chapter id="faq">
<title
>Perguntas e respostas</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
  <question
><para
>O Item do Menu <guimenuitem
>Formatação com o LaTeX</guimenuitem
> não está disponível</para
></question>
  <answer
><para
>Nem todas as infra-estruturas suportam todas as opções.</para
></answer>
</qandaentry>
<qandaentry>
  <question
><para
>Instalei o Sage/Maxima, mas a infra-estrutura apropriada não aparece.</para
></question>
  <answer>
    <para
>Talvez o &cantor; não tenha detectado a localização corretamente. Vá à janela de Configuração e mude a localização da aplicação apropriada. </para>
  </answer>
</qandaentry>
<qandaentry>
  <question
><para
>Que nome mais estúpido - o que ele tem a ver com matemática?</para
></question>
  <answer
><para
>Cantor vem do matemático Alemão Georg Cantor, o criador da teoria dos conjuntos.</para
></answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Créditos e licença</title>

<para
>&cantor; </para>
<para
>Direitos autorais do programa 2009 Alexander Rieder <email
>alexanderrieder@gmail.com</email
> </para>

<para
>Direitos autorais da documentação &copy; 2009 Alexander Rieder <email
>alexanderrieder@gmail.com</email
> </para>

<para
>Tradução de Marcus Gama<email
>marcus.gama@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-kapp">
<title
>Como obter o &cantor;</title>
&install.intro.documentation; </sect1>

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

<para
>Para poder usar com sucesso o &cantor;, você precisa do &kde; 4. Se quiser suporte para a formatação dos dados, precisa do LaTeX e da LibSpectre. Para usar as diferentes infra-estruturas, é necessário o pacote matemático apropriado. </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
>Compilação e instalação</title>
&install.compile.documentation; </sect1>

<sect1 id="configuration">
<title
>Configuração</title>

<para
>Dependendo do seu sistema, você poderá ter que ajustar as localizações para as diferentes aplicações usadas pelo &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;
-->