dotfiles-ansible/README.md

# dotfiles v2

This is the continuation of [my old dotfiles](/folliehiyuki/dotfiles) without all the Xorg stuff I don't use.

## 🧰 Usage

```bash
# Install non-core Ansible modules if only ansible-core package is installed
ansible-galaxy collection install -r requirements/collections.yml

# Create an encrypted vars file to store secret variables
# (see "Variables" section below)
mkdir -p host_vars/$HOSTNAME
touch host_vars/$HOSTNAME/secrets.yml
ansible-vault encrypt host_vars/$HOSTNAME/secrets.yml
ansible-vault edit host_vars/$HOSTNAME/secrets.yml

# Run the playbook
ansible-playbook playbooks/system.yml
ansible-playbook playbooks/dotfiles.yml
```

## Variables

Beside variables defined in [group_vars/all/](./group_vars/all), these are also available:
- `vault_password` (required): the password of the created user (used by [system.yml](./playbooks/system.yml) playbook)
- `pixiv_refresh_token`: in-browser refresh token used in gallery-dl to access Pixiv
- `google_calendar_id`, `google_oauth_client_id`, `google_oauth_client_secret`: used in calcurse CalDAV config
- `user_ssh_key_path`: configure Git to sign commits with this SSH key

## Playbooks

- [system.yml](./playbooks/system.yml) should be the first to be run. Needs to be run as `root`.
- [dotfiles.yml](./playbooks/dotfiles.yml) configures `$HOME` directory.
- [extend.yml](./playbooks/extend.yml) contains additional tasks unrelated to dotfiles and system deployment, but useful (for me).

## 📓 Notes

The playbooks gear toward my Linux distribution of choice - [Alpine Linux](https://alpinelinux.org). Tasks included in them might not work on other distributions (e.g. `apk` tasks)

## 🌟 Credits

- [eoli3n/dotfiles](https://github.com/eoli3n/dotfiles)
- [samhh/dotfiles](https://github.com/samhh/dotfiles)
- [zsugabubus/dotfiles](https://github.com/zsugabubus/dotfiles)
- [sircmpwn/dotfiles](https://git.sr.ht/~sircmpwn/dotfiles)
- [rjarry/dotfiles](https://git.sr.ht/~rjarry/dotfiles)
- [wangl-cc/dotfiles](https://github.com/wangl-cc/dotfiles)

## 📄 License

MIT
Bunch of changes - amfora: update config v1.9.1 - nvim: - feline.nvim: use string.format() instead of tostring() - gitsigns.nvim: use signcolumn instead of numhl - lsp: disable eslint for now - asciidoc stuff 2021-12-09 18:30:13 +01:00			`# dotfiles v2`
Initial commit 2021-07-18 02:07:34 +02:00
Use lowercase characters for the nickname 2024-01-26 18:00:00 +01:00			`This is the continuation of [my old dotfiles](/folliehiyuki/dotfiles) without all the Xorg stuff I don't use.`
roles: add nvim 2021-11-05 20:50:48 +01:00
Update README 2024-02-15 18:00:00 +01:00			`## 🧰 Usage`
nvim: remove wilder.nvim + reorder cmp's sources 2021-11-15 15:57:29 +01:00
Big commit. I think I'm done for most parts :) 2021-12-20 19:33:08 +01:00			```bash
Update README 2024-02-15 18:00:00 +01:00			`# Install non-core Ansible modules if only ansible-core package is installed`
Group roles and playbooks together Also remove test Dockerfile. I run the playbook everyday so no need for testing 2022-08-22 16:39:26 +02:00			`ansible-galaxy collection install -r requirements/collections.yml`
Update README 2024-02-15 18:00:00 +01:00
			`# Create an encrypted vars file to store secret variables`
			`# (see "Variables" section below)`
			`mkdir -p host_vars/$HOSTNAME`
			`touch host_vars/$HOSTNAME/secrets.yml`
			`ansible-vault encrypt host_vars/$HOSTNAME/secrets.yml`
			`ansible-vault edit host_vars/$HOSTNAME/secrets.yml`

Big commit. I think I'm done for most parts :) 2021-12-20 19:33:08 +01:00			`# Run the playbook`
Update README 2024-02-15 18:00:00 +01:00			`ansible-playbook playbooks/system.yml`
Group roles and playbooks together Also remove test Dockerfile. I run the playbook everyday so no need for testing 2022-08-22 16:39:26 +02:00			`ansible-playbook playbooks/dotfiles.yml`
nvim: remove wilder.nvim + reorder cmp's sources 2021-11-15 15:57:29 +01:00			```

Update README 2024-02-15 18:00:00 +01:00			`## Variables`
Big commit. I think I'm done for most parts :) 2021-12-20 19:33:08 +01:00
Update README 2024-02-15 18:00:00 +01:00			`Beside variables defined in [group_vars/all/](./group_vars/all), these are also available:`
			- `vault_password` (required): the password of the created user (used by [system.yml](./playbooks/system.yml) playbook)
			- `pixiv_refresh_token`: in-browser refresh token used in gallery-dl to access Pixiv
Keep things up to date - fish: add new syntax on version 3.6.0, use default key bindings as much as possible - refactor Ansible copy module in a couple of places - add calcurse task (mainly for my job) - preview scripts: - add lowdown as an alternative for glow and mdcat - fallback to bat to preview JSON file when jq and python fail - starship: use blue color for K8s module (cyan is confusing with directory module) - flatpak: drop Whalebird (I use Tokodon now) - gallery-dl: scanned through configuration docs once in a while 2023-01-08 05:00:00 +01:00			- `google_calendar_id`, `google_oauth_client_id`, `google_oauth_client_secret`: used in calcurse CalDAV config
git: colorize diff and some more tweaks 2023-01-28 05:00:00 +01:00			- `user_ssh_key_path`: configure Git to sign commits with this SSH key
Keep things up to date - fish: add new syntax on version 3.6.0, use default key bindings as much as possible - refactor Ansible copy module in a couple of places - add calcurse task (mainly for my job) - preview scripts: - add lowdown as an alternative for glow and mdcat - fallback to bat to preview JSON file when jq and python fail - starship: use blue color for K8s module (cyan is confusing with directory module) - flatpak: drop Whalebird (I use Tokodon now) - gallery-dl: scanned through configuration docs once in a while 2023-01-08 05:00:00 +01:00
Update README 2024-02-15 18:00:00 +01:00			`## Playbooks`
roles: add nvim 2021-11-05 20:50:48 +01:00
Update README 2024-02-15 18:00:00 +01:00			- [system.yml](./playbooks/system.yml) should be the first to be run. Needs to be run as `root`.
			- [dotfiles.yml](./playbooks/dotfiles.yml) configures `$HOME` directory.
			`- [extend.yml](./playbooks/extend.yml) contains additional tasks unrelated to dotfiles and system deployment, but useful (for me).`

			`## 📓 Notes`
Clean up template and playbook structure - Add ui_background variable instead of defining if-else in templates for waybar and launchers - dotfiles.yml: make when statements more visible 2022-02-06 15:15:38 +01:00
Update README 2024-02-15 18:00:00 +01:00			The playbooks gear toward my Linux distribution of choice - [Alpine Linux](https://alpinelinux.org). Tasks included in them might not work on other distributions (e.g. `apk` tasks)
roles: add nvim 2021-11-05 20:50:48 +01:00
Bunch of changes - amfora: update config v1.9.1 - nvim: - feline.nvim: use string.format() instead of tostring() - gitsigns.nvim: use signcolumn instead of numhl - lsp: disable eslint for now - asciidoc stuff 2021-12-09 18:30:13 +01:00			`## 🌟 Credits`
roles: add nvim 2021-11-05 20:50:48 +01:00
roles: add amfora, bash, foot 2021-11-07 09:41:20 +01:00			`- [eoli3n/dotfiles](https://github.com/eoli3n/dotfiles)`
fish: use neovim for man pages and add some envs 2022-01-10 19:54:42 +01:00			`- [samhh/dotfiles](https://github.com/samhh/dotfiles)`
Add ssh role And other small changes: - nvim: - drop gemini syntax (the default gemtext syntax is fine) - add Latex preview binding - anime-downloader: use animerush as default provider 2022-02-23 16:16:09 +01:00			`- [zsugabubus/dotfiles](https://github.com/zsugabubus/dotfiles)`
Fix lint errors + bunch of changes - scripts: - add urlfilter script - update bukumenu and searchmenu to use urlfilter script - packages: use 'bundler' ansible module to bootstrap Vagrant - README: add goals 2022-03-05 09:13:46 +01:00			`- [sircmpwn/dotfiles](https://git.sr.ht/~sircmpwn/dotfiles)`
Lots of updates - scripts: improve notifications - aerc: redefine stylesets and config - gpg: get rid of the comments - nvim: update nvim-tree.lua config - playbooks: use a custom hex_to_rgb filter to define colors for some applications 2022-05-29 09:55:52 +02:00			`- [rjarry/dotfiles](https://git.sr.ht/~rjarry/dotfiles)`
Remove `default_browser` variable and go-s config => bring back the old searchmenu script ^-^ for simplicity => just hardcode xdg-open for web link (need xdg-utils) - pyradio, alacritty: update config for newer version - weechat: - remove wee-slack (Slack is so terrible using it inside the terminal is much worse (blame the API :>)) - add my nick on OFTC (just hanging out on AlpineLinux's channels) - scripts: add `fake-lua` script to display Lua version in Starship prompt (kudos to https://github.com/wangl-cc/dotfiles) - TODO: remove stuff as I'm working on my new Neovim config right now 2023-04-01 19:00:00 +02:00			`- [wangl-cc/dotfiles](https://github.com/wangl-cc/dotfiles)`
roles: add nvim 2021-11-05 20:50:48 +01:00
Bunch of changes - amfora: update config v1.9.1 - nvim: - feline.nvim: use string.format() instead of tostring() - gitsigns.nvim: use signcolumn instead of numhl - lsp: disable eslint for now - asciidoc stuff 2021-12-09 18:30:13 +01:00			`## 📄 License`
roles: add nvim 2021-11-05 20:50:48 +01:00
			`MIT`