Astrality
v1.0.1
Documentation
Astrality - A Dynamic Configuration File Manager
What does it do?
Getting started
Prerequisites
Installation
Configuration and further documentation
Configuration
The Astrality configuration directory
The Astrality configuration files
The configuration file syntax
Command substitution in configuration files
Astrality configuration options
Where to go from here
Templating
Template files
Context
Inserting context variables into your templates
The
env
context
Undefined context values
Default fallback context values
Integer placeholder resolution
Advanced templating
The
shell
filter
How to compile templates
Modules
What are modules?
How to define modules
Module definition syntax
Module dependencies
Action blocks
Actions
Context imports
Compile templates
Symlink files
Copy files
Stow a directory
Run shell commands
Trigger action blocks
The execution order of module actions
Global configuration options for modules
Module subdirectories
GitHub modules
Event listeners
What are event listeners?
What are event listeners used for?
How to set a module event listener
Events
An example using events
Event listener types
Daylight
Solar
Static
Time of day
Weekday
Periodic
Tutorial
Managing dotfiles with templates
A module using events
Example configuration
Tips and Tricks
Configuration of other applications
i3wm
Compton
Codebase
Changelog
[1.0.0] - 2018-05-24
Added
Changed
Fixed
How to contribute
Bug reports and feature requests
Improving the documentation
Contributing code
Getting up and running
Cloning the repository
Installing python3.6
Installing dependencies into a virtual environment
Running the developer version of Astrality
Writing code
The structure of the code base
Tests
Type annotations
Continuous testing
Debugging
Code style
Local documentation
API documentation
The structure of the code base
Modules
Actions module
Legalese
Attributions
Inspirations for themes
License
External resources
Source code on GitHub
YAML syntax documentation
Jinja2 templating documentation
Astrality
Docs
»
Welcome to the documentation for Astrality
Edit on GitHub
Next
Welcome to the documentation for Astrality
¶
Table of Contents
¶
Documentation
Astrality - A Dynamic Configuration File Manager
What does it do?
Getting started
Configuration
The Astrality configuration directory
The Astrality configuration files
The configuration file syntax
Astrality configuration options
Where to go from here
Templating
Template files
Context
Advanced templating
How to compile templates
Modules
What are modules?
How to define modules
Action blocks
Actions
Global configuration options for modules
Module subdirectories
GitHub modules
Event listeners
What are event listeners?
What are event listeners used for?
How to set a module event listener
Events
Event listener types
Tutorial
Managing dotfiles with templates
A module using events
Example configuration
Tips and Tricks
Configuration of other applications
Codebase
Changelog
[1.0.0] - 2018-05-24
How to contribute
Bug reports and feature requests
Improving the documentation
Contributing code
API documentation
The structure of the code base
Modules
Legalese
Attributions
Inspirations for themes
License
External resources
Source code on GitHub
YAML syntax documentation
Jinja2 templating documentation
Read the Docs
v: v1.0.1
Versions
latest
stable
v1.0.1
v1.0.0
Downloads
On Read the Docs
Project Home
Builds
Free document hosting provided by
Read the Docs
.