1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
|
# `plover.oslayer.config` -- Platform-specific configuration
This module provides platform-specific information like paths to configuration
files and asset directories.
```{py:module} plover.oslayer.config
```
```{data} PLATFORM
:type: str
The platform Plover is running on; one of `win`, `mac`, `bsd` or
`linux`.
```
```{data} PLUGINS_PLATFORM
:type: str
Same as {data}`PLATFORM`.
```
```{data} PROGRAM_DIR
:type: str
The directory Plover is running from. In most cases, this will be the
directory the Plover executable itself is in, but when running from an app
bundle on macOS, this is the directory `Plover.app` is in.
```
```{data} CONFIG_BASENAME
:type: str
The name of Plover's configuration file. By default this is `plover.cfg`.
```
```{data} CONFIG_DIR
:type: str
The directory containing Plover's configuration.
If the main config file is in the same directory as the program itself,
then Plover is running in *portable mode*, in which case this is equivalent
to the program directory {data}`PROGRAM_DIR`.
Otherwise, the location of this directory depends on the platform:
* Windows: `%USERPROFILE%\AppData\Local\plover`
* macOS: `~/Library/Application Support/plover`
* Linux: `~/.config/plover`
```
```{data} CONFIG_FILE
:type: str
The full path name of the Plover configuration file.
```
```{data} ASSETS_DIR
:type: str
The directory containing Plover's assets, such as icons and dictionaries.
```
|