Retour au menu principal

## Comportement du programme : fichier de configuration personnel

#### Syntaxe

aucune

#### Description

Le comportement par défaut de Atomsk peut être personnalisé grâce à un fichier de configuration.

Sur les systèmes UNIX/Linux, le comportement du programme peut être modifié pour l'ensemble des utilisateurs du système grâce au fichier de configuration `/etc/atomsk.conf`. De plus, chaque utilisateur peut posséder son propre fichier de configuration dans son dossier personnel (défini par la variable d'environnement `$XDG_CONFIG_HOME` ou, le cas échéant, défini comme étant le dossier caché `$HOME/.config/`) et nommé `atomsk.conf`. Enfin, un fichier de configuration nommé `atomsk.conf` peut aussi exister dans le dossier courant.

Sur les systèmes Microsoft® Windows®, chaque utilisateur peut posséder son propre fichier de configuration dans son dossier personnel (défini par la variable d'environnement `%HOMEPATH%`) et nommé `atomsk.ini`. Enfin, un fichier de configuration nommé `atomsk.ini` peut aussi exister dans le dossier courant.

Ce fichier de configuration est un fichier texte. Les lignes vides ou commençant avec un croisillon (#) sont ignorées, et les mots-clé suivants peuvent être utilisés :

- format <format> : indique un format pour lequel Atomsk doit toujours créer un fichier de sortie ; plusieurs formats peuvent être indiqués en utilisant ce mot-clé plusieurs fois (un par ligne).
- overw <valeur> : si <valeur> vaut "YES" alors les fichiers de sortie sont toujours écrasés sans demander à l'utilisateur, sinon Atomsk demande avant d'écraser un fichier ; identique à l'option `-overw`.
- ignore <valeur> : si <valeur> vaut "YES" alors les fichiers de sortie qui existent déjà ne sont pas réécrits, sinon Atomsk demande ; identique à l'option `-ignore`.
- nthreads <n> : limite à <n> le nombre maximum de processus OpenMP utilisés par Atomsk ; identique à l'option `-nthreads`;
- verbosity <n> : paramètre le niveau de verbosité à <n> ; identique à l'option `-verbosity`.
- lang <langue> : affiche les messages dans la <langue> donnée ; identique à l'option `-lang`;
- colour <valeur>: si <valeur> vaut "YES" alors Atomsk affichera certains messages en couleur (non disponible sur les systèmes Microsoft® Windows®).
- colour_default <couleur>: si l'option "colour" ci-dessus a été activée, alors la <couleur> donnée sera utilisée par défaut pour tous les messages. La <couleur> peut être "black" (noir), "red" (rouge), "green" (vert), "yellow" (jaune), "blue" (bleu), "magenta", "cyan", "grey" (gris), ou "white" (blanc). Des attributs peuvent être ajoutés, comme "bold" (gras), "italic" (italique), "underline" (souligné), et/ou "blink" (clignotant).
- colour_warning <couleur>: si l'option "colour" ci-dessus a été activée, alors la <couleur> donnée sera utilisée par défaut pour les messages d'alerte (warnings).
- colour_error <couleur>: si l'option "colour" ci-dessus a été activée, alors la <couleur> donnée sera utilisée par défaut pour les messages d'erreur.
- progressbar <style>: personnalise l'apparence des barres de progression. Le <style> peut être : "barrier", "bounce", "clock", "dots", "face", "inflate", "jump", "linear", "newton", "pacman", "rotate", "snail", "tunnel", "wave", "wheel", ou "none". Avec ce dernier ("none"), aucune barre de progression n'est affichée. Avec tout autre <style> (non valide), seul le pourcentage est affiché. Si ce mot-clé n'est pas utilisé, alors par défaut les barres de progression sont affichées avec le style "linear".

#### Défaut

Par défaut, aucun format de sortie n'est actif. La langue est celle utilisée par le système d'exploitation, ou l'anglais par défaut. Atomsk n'ignore ni n'écrase pas les fichiers, il demande à l'utilisateur ce qu'il faut faire. Le nombre de processus est celui défini par la variable d'environnement OMP_NUM_THREADS, ou prend la valeur maximale par défaut. Les messages en couleur sont désactivés. Les barres de progression sont affichées avec le style "linear".

Ces paramètres par défaut sont successivement remplacés (écrasés) par ceux définis dans :

- /etc/atomsk.conf
- ${HOME}/.config/atomsk.conf
- ./atomsk.conf
- les arguments en ligne de commande

#### Exemple

##### ~/.config/atomsk.conf

`# Ceci est un commentaire
# Toujours créer des fichiers de sortie aux formats xsf et cfg
format xsf
format cfg
# Si un fichier de sortie existe,
# ne pas le reconvertir
overw no
ignore yes
# Toujours exécuter en mode silencieux
verbosity 0
# Activer les couleurs
colour yes
colour_error red bold blink
`

Retour au menu principal