Program configuration file - Atomsk

Program behaviour: setting up a configuration file

Syntax

none

Description

The default behaviour of Atomsk can be changed by setting up a configuration file.

When running on UNIX/Linux systems, the behaviour of the program can be set in a system-wide configuration file /etc/atomsk.conf. Each user can also customize the behaviour of the program by setting up his own personal configuration file, which must be placed in the user's configuration directory (defined by the environment variable $XDG_CONFIG_HOME or, if the latter is not defined, defined to be the hidden directory $HOME/.config/) and named atomsk.conf.

When running on Microsoft® Windows® environments, each user can customize the behaviour of the program by setting up a personal configuration file, which must be placed in the user's personal directory (defined by the %HOMEPATH% environment variable) and named atomsk.ini (text file).

This configuration file has a pretty simple format. Empty lines and lines starting with the hash symbol (#) are ignored, and the following keywords can be used:

format <format>: indicates a format that Atomsk must always activate for output; several formats can be indicated by using this keyword several times (one line per keyword);
overw <value>: if <value> is YES then existing files are always overwritten, otherwise Atomsk will ask; identical to the command-line option -overw;
ignore <value>: if <value> is YES then conversion is skipped if output files already exist, otherwise Atomsk will ask; identical to the command-line option -ignore;
verbosity <n>: set the verbosity level to <n> ; identical to the command-line option -verbosity;
lang <language>: set the language of the program to <language> ; identical to the command-line option -lang;

This configuration file is loaded at the very beginning of the program, before command-line options are interpreted, therefore command-line options will override the parameters that are set in this file.

Default

When no personal configuration file is found it is simply ignored, and the program runs with the default behaviour.

Example

~/.config/atomsk.conf

# This is a comment # Always output to xsf and cfg format xsf format cfg # If output files already exist, # don't ask, just ignore them overw no ignore yes # Always run in silent mode verbosity 0

Back to main menu