.dotfiles/README.md

30 lines
1.2 KiB
Markdown
Raw Normal View History

2022-02-24 01:57:45 +00:00
# `${HOME}/.dotfiles`
2022-02-24 01:37:35 +00:00
Version control for dotfiles and templates.
## Purpose
2022-02-24 01:57:45 +00:00
`${HOME}/.config` and `${HOME}` are a nightmare to version control. Maintaining a distinct dotfile directory then linking to those files is a much more sane way to cordon them off from the rest of the mess.
2022-02-24 01:37:35 +00:00
## Usage
Make changes and maintain dotfiles in this directory.
TODO: Everything below
Define symlinks or dumper within the `.links` file.
2022-02-24 01:57:45 +00:00
Run `${HOME}/scripts/update_configs.pl` to refresh links and dump templates.
2022-02-24 01:37:35 +00:00
## Details
### `.links`
This file contains a JSON hash of the configuration files available with either a path to be linked, or the name of a dumper contained within [`${HOME}/scripts/dotfiles`](https://git.john.me.tz/jpm/scripts).
2024-03-08 21:23:54 +00:00
### `${HOME}/.local/state/dotfiles.json`
2022-02-24 01:37:35 +00:00
2022-02-24 01:57:45 +00:00
This file contains a JSON hash of timestamps at which each configuration was last linked or dumped. The `${HOME}/scripts/update_configs.pl` script will use these times to know whether or not they need to be updated. It will do so if:
2022-02-24 01:37:35 +00:00
* it is a linked configuration file and the `.links` file has been updated since it was last linked.
2023-01-07 17:03:31 +00:00
* it is a dumpable template and the template has been updated since the last logged event.