You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
lnav/docs/source/config.rst

55 lines
2.0 KiB
ReStructuredText

11 years ago
.. _Configuration:
11 years ago
Configuration
=============
The configuration for **lnav** is stored in the following JSON files in
:file:`~/.lnav`:
* :file:`config.json` - Contains local customizations that were done using the
:code:`:config` command.
* :file:`configs/default/*.json` - The default configuration files that are
built into lnav are written to this directory with :file:`.sample` appended.
Removing the :file:`.sample` extension and editing the file will allow you to
do basic customizations.
* :file:`configs/installed/*.json` - Contains configuration files installed
using the :code:`-i` flag (e.g. :code:`$ lnav -i /path/to/config.json`).
* :file:`configs/*/*.json` - Other directories that contain :file:`*.json`
files will be loaded on startup.
Options
-------
The following high-level configuration options are available:
.. jsonschema:: ../../src/internals/config-v1.schema.json#/properties/ui/properties/clock-format
.. jsonschema:: ../../src/internals/config-v1.schema.json#/properties/ui/properties/dim-text
.. jsonschema:: ../../src/internals/config-v1.schema.json#/properties/ui/properties/default-colors
.. jsonschema:: ../../src/internals/config-v1.schema.json#/properties/ui/properties/theme
.. jsonschema:: ../../src/internals/config-v1.schema.json#/properties/ui/properties/keymap
Themes
------
User interface themes are also defined through the JSON configuration files.
.. jsonschema:: ../../src/internals/config-v1.schema.json#/properties/ui/properties/theme-defs/patternProperties/([\w\-]+)/properties/vars
.. jsonschema:: ../../src/internals/config-v1.schema.json#/properties/ui/properties/theme-defs/patternProperties/([\w\-]+)/properties/styles
.. jsonschema:: ../../src/internals/config-v1.schema.json#/definitions/style
.. _keymaps:
Keymaps
-------
Keymaps in **lnav** map a key sequence to a command to execute.
.. jsonschema:: ../../src/internals/config-v1.schema.json#/properties/ui/properties/keymap-defs/patternProperties/([\w\-]+)