Astrality Logo
v1.0.0

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
Next

© Copyright 2018, Jakob Gerhard Martinussen. Revision 49453ca3.

Built with Sphinx using a theme provided by Read the Docs.
Read the Docs v: v1.0.0
Versions
latest
stable
v1.0.0
v0.6
Downloads
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.