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

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.

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 macOS 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.

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 .

Exemple :

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.

• 11 : dans le cas de la version principale
• 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 11: C:\Users\[your name]\...\.ancestris\11
  • Version 12: C:\Users\[your name]\...\.ancestris\trunk
• macOS :
  • Version 11:  ${HOME}/Library/Application Support/ancestris/11
  • Version 12: ${HOME}/Library/Application Support/ancestris/trunk
• Linux :
  • Version 11:  ~/.ancestris/11
  • Version 12: ~/.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.

Ancestris utilise deux fichiers de configuration, tous deux nommés ancestris.conf
1/ Le premier est le fichier de Configuration Application , qui fait partie du répertoire Application et qui est créé lors de l'installation d'Ancestris. 
2/ L'autre est le fichier de Configuration Utilisateur, 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. 

Description détaillée

~/.ancestris/trunk	Répertoire utilisateur
ancestris	Modèles définis par l'utilisateur
almanac	Almanachs de la vue chronologie et des rapports chronologiques
blueprints	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.
gedart	Modèles proposés et définis par l'utilisateur pour le rapport Fiches individuelles et familiales / Gedart
ancestris.log	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
config	Préférences d'utilisation
Modules	Préférences liées aux modules additionnels installés
Preferences	Préférences de toutes les fenêtres et outils à l'exception des modules additionnels installés.
Toolbars	Paramètres de la barre d'outils
Windows2Local	Position des fenêtres
shortcuts.html	Raccourcis
etc
ancestris.conf	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.
modules	Modules additionnels installés
update_tracking	Information de mise à jour pour tous les modules
var
cache
ModificationsHistory	Historiques de modifications des fichiers Gedcom ouverts par Ancestris depuis la dernière remise à zéro
...	Fichiers temporaires utilisés par Ancestris
log	Fichiers log temporaires

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.

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 ne conserver que les répertoires ancestris, config, etc et ModificationsHistory.
   - Si vous avez des soucis avec les positions de fenêtres, nous vous recommandons d'effacer le répertoire Windows2Local.

Desinstaller Ancestris

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