# Fichiers applicatifs et fichiers des paramètres utilisateurs

Il y a deux ensembles de fichiers avec Ancestris.

- Les **fichiers applicatifs** qui font tourner l'application
- Les **fichiers des paramètres utilisateurs** qui regroupent vos préférences

<p class="callout warning">Vous pouvez perdre les fichiers applicatifs car ceux-ci peuvent toujours être récupérés depuis le site Ancestris  
en revanche **vous devez avoir un backup de vos paramètres utilisateurs** car ils vous sont spécifiques.</p>

## Fichiers applicatifs

Les fichiers applicatifs d'Ancestris sont dans le répertoire `ancestris` utilisé lors de l'installation.

Si vous tapez `whereis ancestris` dans un terminal sur **Linux**, ou `locate ancestris` sur **macOS** ou `dir ancestris /s /p` sur **Windows** pour localiser le répertoire dans lequel est installé Ancestris.

Le dossier `ancestris` contient les sous-dossiers suivants.

- `ancestris`
- `bin`
    - `ancestris` : fichier exécutable à lancer pour démarrer Ancestris pour m**acOS** et **Linux**
    - `ancestris.exe` : fichier exécutable à lancer pour démarrer Ancestris sous **Windows**
    - `ancestris64.exe` : fichier exécutable à lancer pour démarrer Ancestris sous **Windows** avec une architecture Java 64 bits (recommandé)
    - `ancestris.gif` : image utilisable pour créer un lanceur d'application
    - ...
- `etc`
    - `ancestris.conf`: fichier de Configuration Application
- `harness`
- `platform`

## Fichiers des paramètres utilisateurs

### Le **répertoire utilisateur** 

Les fichiers de configuration d'Ancestris se trouvent dans le **Répertoire utilisateur.**

<p class="callout info">L'emplacement du **répertoire utilisateur** est indiqué sur la fenêtre "À propos" d'Ancestris.  
Vous accédez à cette fenêtre par le menu principal / Aide / A propos d'Ancestris, ou bien avec le bouton [![About_box_button.png](https://docs.ancestris.org/uploads/images/gallery/2020-06/scaled-1680-/About_box_button.png).](https://docs.ancestris.org/uploads/images/gallery/2020-06/About_box_button.png)  
  
Exemple :  
[![A_propos_répertoire_utilisateur.png](https://docs.ancestris.org/uploads/images/gallery/2020-06/scaled-1680-/A_propos_r%C3%A9pertoire_utilisateur.png)](https://docs.ancestris.org/uploads/images/gallery/2020-06/A_propos_r%C3%A9pertoire_utilisateur.png)</p>

Ce **répertoire utilisateur** dépend de votre système d'exploitation.

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

Où `<version>` est le numéro de version installée.

- `13` : dans le cas de la version stable. Vérifier dans la page de [Compatibilité des versions](https://docs.ancestris.org/books/mode-demploi/page/compatibilite-de-versions "Compatibilité de versions") pour connaitre le numéro de la version stable.
- `trunk` : dans le cas de la version quotidienne.

Le répertoire utilisateur, où se trouve la personnalisation d'Ancestris, est donc, selon votre système :

- Windows : 
    - Version stable: `C:\Users\[your name]\...\.ancestris\13`
    - Version quotidienne: `C:\Users\[your name]\...\.ancestris\trunk`
- macOS : 
    - Version stable: `${HOME}/Library/Application Support/ancestris/13`
    - Version quotidienne: `${HOME}/Library/Application Support/ancestris/trunk`
- Linux : 
    - Version stable: `~/.ancestris/13`
    - Version quotidienne: `~/.ancestris/trunk`

Si vous avez réinstallé Ancestris à partir d'une version précédente, et si vous voulez continuer à utiliser votre personnalisation précédente, il vous suffit de copier le répertoire utilisateur de la version précédente dans le répertoire utilisateur de la nouvelle version.

### Le **fichier de Configuration Utilisateur** et le **fichier log**

Il y a deux fichiers particulièrement importants dans ce Répertoire utilisateur pour le démarrage et le diagnostic de pannes éventuelles.

- **Le fichier de configuration** : `<Répertoire utilisateur>/etc/ancestris.conf`
- **Le fichier log** : `<Répertoire utilisateur>/ancestris/ancestris.log`

On y trouve aussi vos préférences et vos modèles de personnalisations.

- Vos **préférences** : `<Répertoire utilisateur>/ancestris/config`
- Vos **calques** personnels : `<Répertoire utilisateur>/ancestris/blueprints`
- Vos **almanachs** personnels : `<Répertoire utilisateur>/ancestris/almanac`
- Vos **modèles de fiches individuelles et familiales** personnels : `<Répertoire utilisateur>/ancestris/gedart`
- Vos **historiques de modifications** : `<Répertoire utilisateur>/var/cache/ModificationsHistory`

Référez-vous au mode d'emploi plus tard pour savoir à quoi servent ces modèles.

<p class="callout danger">**Ancestris utilise deux fichiers de configuration, tous deux nommés ancestris.conf**  
1/ Le premier est le fichier de <span style="text-decoration: underline;">Configuration Application</span> , qui fait partie du répertoire Application et qui est créé lors de l'installation d'Ancestris.   
2/ L'autre est le fichier de <span style="text-decoration: underline;">Configuration Utilisateur</span>, qui fait partie du répertoire utilisateur, et qui est créé lorsque vous modifiez certaines préférences lors de l'utilisation d'Ancestris.  
  
**Le fichier de Configuration Utilisateur est prioritaire sur le fichier de Configuration Application.**  
  
Le fichier de configuration à vérifier et à mettre à jour est donc le fichier de Configuration Utilisateur s'il existe, et le fichier de Configuration Application dans le cas contraire.  
- Si vous installez Ancestris, vous devrez probablement mettre à jour le fichier de Configuration Application.  
- Si vous avez déjà utilisé Ancestris et que vous voulez changer la version de java, vous devrez probablement mettre à jour le fichier de Configuration Utilisateur.   
</p>

### Description détaillée

<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: 40.6174%; height: 10px;">~/.ancestris/13 ou ~/.ancestris/trunk</td><td style="width: 62.3455%; height: 10px;">**Répertoire utilisateur**

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

</td><td style="width: 62.3455%; height: 10px;">- Modèles définis par l'utilisateur

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

</td><td style="width: 62.3455%; height: 53px;">- - - Almanachs de la vue chronologie et des rapports chronologiques

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

</td><td style="width: 62.3455%; height: 29px;">- - - Calques disponibles pour afficher les informations généalogiques dans les fenêtres d'information dans la vue Arbre dynamique, dans l'éditeur Gedcom, etc.

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

</td><td style="width: 62.3455%; height: 29px;">- - - Modèles proposés et définis par l'utilisateur pour le rapport Fiches individuelles et familiales / Gedart

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

</td><td style="width: 62.3455%; height: 29px;">- - - **Fichier log d'Ancestris**
        - C'est le fichier que l'équipe Support d'Ancestris est susceptible de vous demander lorsque vous leur soumettez une erreur
        - Vous pouvez définir la taille maximale de ce fichier dans les Préférences

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

</td><td style="width: 62.3455%; height: 29px;">- Préférences d'utilisation

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

</td><td style="width: 62.3455%; height: 53px;">- - - Préférences liées aux modules additionnels installés

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

</td><td style="width: 62.3455%; height: 53px;">- - - Préférences de toutes les fenêtres et outils à l'exception des modules additionnels installés.

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

</td><td style="width: 62.3455%;">- - - Paramètres de la barre d'outils

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

</td><td style="width: 62.3455%; height: 53px;">- - - Position des fenêtres

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

</td><td style="width: 62.3455%; height: 53px;">- - - Raccourcis

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

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

</td><td style="width: 62.3455%; height: 53px;">- - - **C'est le second fichier de configuration d'Ancestris.**
        - Ce fichier de configuration complète le fichier de configuration de l'application Ancestris placé dans [les fichiers applicatifs décrits ci-dessus](#bkmrk-fichiers-applicatifs).

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

</td><td style="width: 62.3455%; height: 53px;">- Modules additionnels installés

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

</td><td style="width: 62.3455%; height: 53px;">- Information de mise à jour pour tous les modules

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

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

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

</td><td style="width: 62.3455%; height: 53px;">- - - - - Historiques de modifications des fichiers Gedcom ouverts par Ancestris depuis la dernière remise à zéro

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

</td><td style="width: 62.3455%; height: 53px;">- - - - - Fichiers temporaires utilisés par Ancestris

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

</td><td style="width: 62.3455%; height: 10px;">- - - Fichiers log temporaires

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

Lorsque vous réinstallez Ancestris, les fichiers paramètres utilisateurs ne sont pas modifiés et vous devriez pouvoir changer de version tout en conservant vos paramètres précédents.

<p class="callout warning">Attention, il se peut qu'une nouvelle version d'Ancestris utilise certains paramètres différemment.  
 - Si c'est le cas, nous vous suggérons de <span style="text-decoration: underline;">ne conserver que</span> les répertoires **ancestris**, **config**, **etc** et **ModificationsHistory**.   
 - Si vous avez des soucis avec les positions de fenêtres, nous vous recommandons d'<span style="text-decoration: underline;">effacer</span> le répertoire **Windows2Local**.</p>

## Desinstaller Ancestris

Pour désinstaller Ancestris, il suffit de supprimer de votre ordinateur les 2 répertoires Ancestris Applicatifs et Paramètres Utilisateurs.