# Ficheiros de programa e ficheiros de configuração do utilizador

Há dois grupos de ficheiros necessários para executar o Ancestris:

- os **ficheiros de programa**, que executam o programa;
- os **ficheiros de configuração do utilizador**, que armazenam as preferências do utilizador.

<p class="callout warning">Pode arriscar perder os ficheiros de programa porque pode sempre obtê-los na página do Ancestris;  
mas **deve fazer seguranças dos ficheiros de configuração do utilizador**, uma vez que são especificamente seus.</p>

## Ficheiros de programa

Os ficheiros de programa do Ancestris estarão dentro da pasta `ancestris` usada durante a instalação.

Pode inserir `whereis ancestris` num terminal para saber onde está essa pasta (não no **Windows**).

Esta pasta `ancestris` contém as seguintes sub-pastas:

- `ancestris`;
- `bin`: 
    - `ancestris` : ficheiro executável para iniciar o Ancestris em **MacOS** e **Linux**;
    - `ancestris.exe` : ficheiro executável para iniciar o Ancestris em Windows;
    - `ancestris64.exe` : ficheiro executável para iniciar o Ancestris no **Windows** com arquitectura Java de 64 bits (recomendado);
    - `ancestris.gif` : ícone Ancestris a usar ao criar um atalho do Ancestris;
    - ...;
- `etc`: 
    - `ancestris.conf` - ficheiro de configuração da aplicação
- `harness`;
- `platform`.

Ao reinstalar o Ancestris, está simplesmente a substituir estes ficheiros e pastas.

## Ficheiros de configuração do utilizador

### A **pasta do utilizador**

Os ficheiros de configuração do utilizador Ancestris estão na **pasta do utilizador**.

<p class="callout info">Pode ver a localização da **pasta do utilizador** no diálogo Acerca.  
Este diálogo pode ser acedido no menu principal, Ajuda/Acerca do Ancestris ou então clicando em [![icon_about.png](https://docs.ancestris.org/uploads/images/gallery/2020-08/scaled-1680-/icon_about.png)](https://docs.ancestris.org/uploads/images/gallery/2020-08/icon_about.png).  
  
Exemplo :  
[![pt_help_about.png](https://docs.ancestris.org/uploads/images/gallery/2020-09/scaled-1680-/pt_help_about.png)](https://docs.ancestris.org/uploads/images/gallery/2020-09/pt_help_about.png)</p>

Esta **pasta do utilizador** depende do seu sistema operativo.

- Windows : `C:\Users\[utilizador]\.ancestris\<version>`
- MacOS : `${HOME}/Library/Application Support/ancestris/<version>`
- Linux : `~/.ancestris/<version>`

Onde `<version>` é o número da versão instalada.

- `13` : neste caso, a versão estável. Verifique a [compatibilidade das versões](https://docs.ancestris.org/books/manual-do-utilizador/page/compatibilidade-das-versoes "Compatibilidade das versões").
- `trunk` : neste caso, a versão quotidiana, de desenvolvimento.

A pasta do utilizador, onde se encontra a personalização do Ancestris, estará, dependendo do sistema, em::

- Windows : 
    - Versão estável: `C:\Users\[your name]\...\.ancestris\XX`
    - Versão de desenvolvimento: `C:\Users\[your name]\...\.ancestris\trunk`
- macOS : 
    - Versão XX estável: `${HOME}/Library/Application Support/ancestris/XX`
    - Versão de desenvolvimento: `${HOME}/Library/Application Support/ancestris/trunk`
- Linux : 
    - Versão XX estável: `~/.ancestris/XX`
    - Versão de desenvolvimento: `~/.ancestris/trunk`

### O **ficheiro de configuração** e o **ficheiro de diário**

Há dois ficheiros especialmente importantes na pasta do utilizador para arranque do programa e diagnóstico de eventuais erros:

- **o ficheiro de configuração**: `<<em>pasta do utilizador</em>>/etc/ancestris.conf` define as configurações de arranque;

<p class="callout warning">Caso o **Ancestris** tenha problemas em detectar a versão Java, pode editar o ficheiro de configuração presente na pasta de instalação: &lt;*pasta de instalação do **Ancestris***&gt;/etc/ancestris.conf</p>

- **o ficheiro de diário**: `<<em>pasta do utilizador</em>>/ancestris/ancestris.log` armazena todos os avisos e mensagens de erro que ocorrem enquanto utiliza o Ancestris.

Aqui também estão localizadas as suas preferências e modelos personalizados:

- as suas **preferências** : `<<em>pasta do utilizador</em>>/ancestris/config`
- os seus **modelos pessoais** : `<<em>pasta do utilizador</em>>/ancestris/blueprints`
- os seus **almanaques** : `<<em>pasta do utilizador</em>>/ancestris/almanac`
- os seus **modelos de registo individual e familiar** : `<<em>pasta do utilizador</em>>/ancestris/gedart`
- o seu **histórico de modificações** : `<<em>pasta do utilizador</em>>/var/cache/ModificationsHistory`

Consulte o [manual do utilizador](https://docs.ancestris.org/books/manual-do-utilizador/page/modelos "Modelos") para saber para que servem esses modelos.

<p class="callout danger">**O Ancestris utiliza dois ficheiros de configuração, ambos chamados ancestris.conf**  
1. O primeiro é o ficheiro de configuração da aplicação, que faz parte da pasta Aplicação e é criado quando o Ancestris é instalado.   
2. O outro é o ficheiro de configuração do utilizador, que faz parte da pasta do utilizador e é criado quando modifica certas preferências ao utilizar o Ancestris.  
**O ficheiro de configuração do utilizador precede o ficheiro de configuração da alicação.**  
  
O ficheiro de configuração a verificar e actualizar é, portanto, o ficheiro de configuração do utilizador, se existir, e o ficheiro de configuração da aplicação, se não existir.  
- Se estiver a instalar o Ancestris, terá provavelmente de actualizar o ficheiro de configuração da aplicação.  
- Se já utilizou o Ancestris e pretende alterar a versão do Java, terá provavelmente de actualizar o ficheiro de configuração do utilizador. </p>

### Descrição detalhada

<table border="1" cellpadding="0" cellspacing="0" id="bkmrk-%7E%2F.ancestris%2Ftrunk-%3D" style="height: 888px; width: 100%; border-collapse: collapse;"><tbody><tr style="height: 29px;"><td style="width: 53.5803%; height: 10px;">~/.ancestris/12 ou ~/.ancestris/trunk</td><td style="width: 68.2715%; height: 10px;">**Pasta do utilizador**

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 10px;">- ancestris

</td><td style="width: 68.2715%; height: 10px;">- Modelos definidos pelo utilizador

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 53px;">- - - almanac

</td><td style="width: 68.2715%; height: 53px;">- - - Almanaques para a visualização cronológica e para relatórios cronológicos.

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 29px;">- - - blueprints

</td><td style="width: 68.2715%; height: 29px;">- - - Plantas disponíveis para exibir informações de genealogia na árvore dinâmica, editor Gedcom, etc.

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 29px;">- - - gedart

</td><td style="width: 68.2715%; height: 29px;">- - - Modelos padrão e modelos definidos pelo utilizador para o registo individual e familiar/relatório Gedart.

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 29px;">- - - **ancestris.log**

</td><td style="width: 68.2715%; height: 29px;">- - - **Ficheiro de diário do Ancestris.**
        - É o ficheiro que o suporte do Ancestris pode precisar caso nos envie um erro.
        - Pode definir o tamanho do diário nas [preferências](https://docs.ancestris.org/books/manual-do-utilizador/page/prefer%C3%AAncias "Preferências").

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 29px;">- config

</td><td style="width: 68.2715%; height: 29px;">- Preferências definidas pelo utilizador

</td></tr><tr style="height: 53px;"><td style="width: 53.5803%; height: 53px;">- - - Modules

</td><td style="width: 68.2715%; height: 53px;">- - - Preferências do utilizador das extensões instaladas

</td></tr><tr style="height: 53px;"><td style="width: 53.5803%; height: 53px;">- - - Preferences

</td><td style="width: 68.2715%; height: 53px;">- - - Preferências do utilizador de todas as vistas e ferramentas, excepto as das extensões instaladas

</td></tr><tr><td style="width: 53.5803%;">- - - Toolbars

</td><td style="width: 68.2715%;">- - - Configurações principais da barra de ferramentas

</td></tr><tr style="height: 53px;"><td style="width: 53.5803%; height: 53px;">- - - Windows2Local

</td><td style="width: 68.2715%; height: 53px;">- - - Posição das janelas

</td></tr><tr style="height: 53px;"><td style="width: 53.5803%; height: 53px;">- - - shortcuts.html

</td><td style="width: 68.2715%; height: 53px;">- - - Atalhos

</td></tr><tr style="height: 53px;"><td style="width: 53.5803%; height: 53px;">- etc

</td><td style="width: 68.2715%; height: 53px;">  
</td></tr><tr style="height: 53px;"><td style="width: 53.5803%; height: 53px;">- - - **ancestris.conf**

</td><td style="width: 68.2715%; height: 53px;">- - - - **Ficheiro de configuração do Ancestris para configurações de arranque**

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 53px;">- modules

</td><td style="width: 68.2715%; height: 53px;">- Extensões instaladas

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 53px;">- update\_tracking

</td><td style="width: 68.2715%; height: 53px;">- Informações de actualização de extensões instaladas

</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 53px;">- var

</td><td style="width: 68.2715%; height: 53px;">  
</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 53px;">- - - cache

</td><td style="width: 68.2715%; height: 53px;">  
</td></tr><tr style="height: 29px;"><td style="width: 53.5803%; height: 53px;">- - - - - ModificationsHistory

</td><td style="width: 68.2715%; height: 53px;">- - - - - Histórico de modificações de ficheiros Gedcom abertos pelo Ancestris

</td></tr><tr style="height: 53px;"><td style="width: 53.5803%; height: 53px;">- - - - - ...

</td><td style="width: 68.2715%; height: 53px;">- - - - - Informações temporárias armazenadas pelo Ancestris

</td></tr><tr style="height: 10px;"><td style="width: 53.5803%; height: 10px;">- - - log

</td><td style="width: 68.2715%; height: 10px;">- - - Ficheiros de diário temporários

</td></tr></tbody></table>

Ao reinstalar o Ancestris, os ficheiros de configuração do utilizador não são modificados, deverá poder executar a versão actualizada com todas as configurações anteriores.

<p class="callout warning">No entanto, pode haver algumas mudanças na maneira como a nova versão usa algumas das configurações.  
 - Se este for o caso, recomendamos que mantenha <span style="text-decoration: underline;">apenas</span> as pastas **ancestris**, **config**, **etc** e **ModificationsHistory**.  
 - Se tiver problemas com as janelas, recomendamos <span style="text-decoration: underline;">remover</span> a pasta **Windows2Local**.</p>

## Desinstalar o Ancestris

Para desinstalar o Ancestris, basta eliminar as 2 pastas dos ficheiros de programa e os ficheiros de configuração do utilizador.