<appendix id="installation">
<title
>Instalação</title>
<para
>As secções seguintes contêm instruções detalhadas sobre como obter, compilar e instalar o &kst; em conjunto com quaisquer bibliotecas ou pacotes opcionais. Se você usar um sistema de gestão de pacotes, podê-lo-á usar para instalar o &kst; em alternativa. </para>


<sect1 id="obtainingkst">
<title
>Obter o &kst;</title>
<para
>O &kst; faz parte do módulo 'kdeextragear-2' do &kde;. Você poderá obter também a última versão em separado da <ulink url="http://omega.astro.utoronto.ca/kst/"
>página Web</ulink
> do &kst;. Se quiser obter o &kst; a partir do CVS, está disponível através do CVS anónimo do &kde; ou com o repositório de <ulink url="http://kdewebcvs.pandmservices.com/cgi-bin/cvsweb.cgi/"
>WebCVS</ulink
> do &kde;. </para>
</sect1>

<sect1 id="installingfromsource">
<title
>Instalar o &kst; a Partir do Código</title>
<para
>As secções seguintes detalham como compilar e instalar o &kst; a partir do código. </para>

<sect2 id="installingrequirements">
<title
>Requisitos</title>
<para
>O &kst; v1.0.0 necessita das bibliotecas do &kde; 3.1 e do &Qt; 3.1. Quase todas as maiores distribuições de &Linux; têm pacotes para o &kde; e o &Qt;. Dado que o &Qt; é uma dependência do &kde;, se tiver a versão necessária do &kde; será o suficiente. Recomenda-se que se baseie na documentação da sua distribuição em particular para a instalação das bibliotecas do &kde;. Repare que não é necessário todo o ambiente de trabalho do &kde; &mdash; na maior parte dos casos, procure pelos pacotes chamados <filename
>kdebase-*</filename
> e <filename
>kdelibs-*</filename
>. Em alternativa, estão disponíveis mais informações na <ulink url="http://www.kde.org/download/"
>página Web</ulink
> do &kde;. </para>
</sect2>

<sect2 id="optionallibrariesandpackages">
<title
>Bibliotecas e Pacotes Opcionais</title>
<para
>As bibliotecas e pacotes seguintes são opcionais, mas oferecem uma funcionalidade completa de 'plugins' e dados no &kst; se forem instaladas. As instruções de instalação assumem que você tem acesso de 'root' no seu sistema.</para>
<note>
<para
>Você poderá já ter algumas ou todas essas bibliotecas ou pacotes instalados, onde, nesse caso, não existe necessidade de os reinstalar. Do mesmo modo, verifiqueprimeiro se já existem pacotes binários pré-compilados para as bibliotecas e pacotes no seu sistema de gestão de pacotes da sua distribuição, dado que poderá ser mais simples de instalar os pacotes binários. </para>
</note>

<sect3 id="gslrequirement">
<title
>&GNU; Scientific Library (GSL)</title>
<para
>A &GNU; Scientific Library oferece uma variedade de operações matemáticas para os 'plugins' incorporados do &kst;. Se tiver a GSL instalada irá activar uma variedade de 'plugins' como o ajuste linear e não-linear, a correlação e a interpolação. A biblioteca poderá ser obtida em <ulink url="ftp://ftp.gnu.org/gnu/gsl/"
>ftp://ftp.gnu.org/gnu/gsl/</ulink
>. Em alternativa, poderá encontrar a GSL em <filename
>/gnu/gsl</filename
> nas réplicas ('mirrors') indicadas em <ulink url="http://www.gnu.org/prep/ftp.html"
>http://www.gnu.org/prep/ftp.html</ulink
>. </para>

<para
>Obtenha o <filename
>gsl-[ver].tar.gz</filename
>, em que o [ver] é o maior número de versão encontrado na pasta. </para>

<para
>Depois descomprima o ficheiro: </para>
<screen
><userinput
><command
>tar -zxvf gsl-[ver].tar.gz</command
></userinput
></screen>
<para
>substituindo o [ver] com o número de versão do pacote transferido. </para>
<para
>Leia o ficheiro <filename
>INSTALL</filename
> na pasta resultante para obter instruções de instalação mais detalhadas. Para a maioria dos sistemas, o seguinte irá resultar: <screen
><userinput
><command
>cd gsl-[ver]</command>
<command
>./configure</command>
<command
>make</command>
<command
>make install</command
></userinput
></screen>
</para>

</sect3>

<sect3 id="fitsiorequirement">
<title
>CFITSIO</title>
<para
>A biblioteca CFITSIO oferece o suporte para a leitura e gravação no formato de dados FITS (Flexible Image Transport System). A biblioteca poderá ser obtida em <ulink url="ftp://heasarc.gsfc.nasa.gov/software/fitsio/c/"
>ftp://heasarc.gsfc.nasa.gov/software/fitsio/c/</ulink
>. Só terá de instalar a biblioteca se achar que é importante gravar no formato de ficheiro FITS. </para>

<para
>Obtenha o <filename
>cfitsio[ver].tar.gz</filename
>, em que o [ver] é o maior número de versão que existir na pasta. </para>

<para
>Depois descomprima o ficheiro: <screen
><userinput
><command
>tar -zxvf cfitsio[ver].tar.gz</command
></userinput
></screen
>, substituindo o [ver] pelo número de versão do ficheiro obtido. </para>

<para
>Leia o ficheiro <filename
>README</filename
> na pasta resultante para obter as instruções de instalar. Para a maioria dos sistemas, o seguinte irá resultar: <screen
><userinput
><command
>cd cfitsio</command>
<command
>./configure --prefix=/usr</command>
<command
>make</command>
<command
>make install</command
></userinput
></screen>
</para>

<para
>O utilizador poderá ter de alterar a pasta indicada para a opção do prefixo <option
>--prefix</option
>, mas a pasta mais comum é a <filename
>/usr</filename
> </para>
</sect3>
</sect2>

<sect2 id="compilingandinstalling">
<title
>Compilação e Instalação</title>
<para
>Logo que todos os pré-requisitos tenham sido cumpridos no seu sistema, poderá compilar e instalar o &kst;. Assume-se que você já instalou o pacote de código do &kst;. Caso contrário, leia por favor a secção <link linkend="obtainingkst"
>Obter o &kst;</link
>. </para>

<para
>A forma mais simples de instalar o &kst; é: <screen
><userinput
><command
>tar -zxvf kst-[ver].tar.gz</command>
<command
>cd kst-[ver]</command>
<command
>./configure --prefix=`kde-config --prefix`</command>
<command
>make</command>
<command
>make install</command
></userinput
></screen
>, substituindo o [ver] com a versão do &kst; que tiver. </para>
<important>
<para
>Repare que o <command
>kde-config --prefix</command
> está rodeado por plicas invertidas. É bastante importante que o utilitário <command
>kde-config</command
> devolva a localização correcta (sendo a maior provável a <filename
>/usr</filename
>), caso contrário o &kst; <emphasis
>não</emphasis
> será instalado convenientemente. Você poderá verificar a situação se o correr primeiro directamente: <screen
><userinput
><command
>kde-config --prefix</command
></userinput
></screen
> Garanta que não lhe aparece uma localização em branco. </para>
</important>

<para
>Você poderá ir lendo as mensagens que são apresentadas pelo programa <command
>configure</command
> &mdash; se der pela falta de algumas bibliotecas (como a GSL) que não deveriam estar em falta, volte atrás por favor e garanta que as bibliotecas e os ficheiros de inclusão foram instalados correctamente nas localizações apropriadas. </para>



</sect2>



</sect1>

</appendix>
