dotfiles/README.md

82 lines
2.5 KiB
Markdown
Raw Normal View History

2022-08-14 07:36:50 +00:00
# dotfiles
2022-08-29 12:36:44 +00:00
Contains my configurations for the software I use.
I'm looking to move forward to configuration with NixOS, but until I get
a bit more experiment on NixOS, I'll keep this repository as simple as possible.
2023-06-08 05:04:50 +00:00
- As of 2023-06-07, I have little interest in keeping configurations
([`init.lua`](./native_configs/neovim/init.lua), [`sshconfig`](./native_configs/ssh/config),...)
to be idempotent for Nix and non-Nix targets.
2022-11-06 14:06:36 +00:00
## Nix
2022-08-30 14:29:44 +00:00
Monorepo that contains my commonly used personal environments.
I hope to incorporate my configs at [gh:pegasust/dotfiles](https://github.com/pegasust/dotfiles)
onto this repo for quick env setup (especially devel) on new machines.
2022-08-29 12:36:44 +00:00
## How do I apply these config
2023-06-08 05:04:50 +00:00
- Clone and nixify
2022-08-29 12:36:44 +00:00
### neovim
My main text editor. It's based on `vim`, but stays loyal to `lua` ecosystem
- Config file: `./nvim/init.lua`
- Command: `ln [-s] $PWD/nvim/init.lua ~/.config/nvim`
#### Notes
- Ensure that neovim is installed and invocable by `nvim`.
- For information on installing neovim, visit their [github page](https://github.com/neovim/neovim/wiki/Installing-Neovim)
### tmux
Terminal multiplexor. Allows creating persistent sessions and multiple terminal windows
from one terminal.
2022-11-14 17:07:11 +00:00
- Config file: `./tmux/tmux.conf`
- Command: `ln [-s] $PWD/tmux/tmux.conf ~/.tmux.conf`
- Or `ln [-s] $PWD/tmux/tmux.conf ~/.config/tmux/tmux.conf` (hardcoded, `$XDG_CONFIG_HOME` is ignored)
2022-08-29 12:36:44 +00:00
#### Notes
2023-06-08 05:04:50 +00:00
- Unsure of the minimum version of tmux. I have had an ancient HPC server
2022-08-29 12:36:44 +00:00
that does not respond well to one of the config lines.
### zk
Zettelkasten notebook. This is how I document my learning and reflect on myself
via writing and typing.
I am in the process of moving away from Obsidian so that I can write ZK notes
text-editor agnostically.
- Config file: `zk/config.toml`
- Command: `ln [-s] $PWD/zk/config.toml ~/.config/zk/config.toml`
- Templates: `zk/templates/`
- Command: `ln -s $PWD/zk/templates ~/.config/zk/templates`
2023-06-08 05:04:50 +00:00
Note (2023-06-07): I'm now using a mix of nvim-zk with Notion. I'm still figuring out
a centralize place to put my notes and use it to do some knowledge graph magic
2023-03-23 07:56:15 +00:00
## Troubleshoots
### My MacOS just updated, `nix` is no-longer here
- An easy fix is to add the following to the **bottom** of `/etc/zshrc`
```sh
2023-06-08 05:04:50 +00:00
# Nix {{{
2023-03-23 07:56:15 +00:00
if [ -e '/nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh' ]; then
. '/nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh'
fi
2023-06-08 05:04:50 +00:00
# }}}
2023-03-23 07:56:15 +00:00
```
- Otherwise, consult [`gh-gist:meeech/a_help-osx-borked-my-nix.md`](https://gist.github.com/meeech/0b97a86f235d10bc4e2a1116eec38e7e)
2022-08-30 14:29:44 +00:00