X-Git-Url: https://git.r.bdr.sh/rbdr/dotfiles/blobdiff_plain/fe9e7669cf3a5c546ad77647532379d1e9e2ea73..cdf144ae0b9e28556ba36aa414f0bf110e4d31cf:/README.md?ds=sidebyside diff --git a/README.md b/README.md index 987bbfe..3735424 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,70 @@ # Dotfiles -To set up run `install_dotfiles` +To set up run `./install` It provides configuration for: +* nvim +* tmux * zsh +* git +* ripgrep +* tmuxp +* kitty +* karabiner * weechat -* vim * nethack * terminfo italics support +* yabai & skhdc +* asdf + +## Prerequisites + +The scripts here have support for `brew`, `pacman`, or `apt`. +Install brew with: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` + +It might also be a good idea to install the xcode command line tools with `xcode-select --install` + +## Provisioning + +These dotfiles include some provisioning scripts for `brew`, `pacman`, and `apt`. + +To set up run `./provision ` where `` is one of: + +* `essential` +* `nice` +* `cask_essential` (only `brew`) +* `cask_nice` (only `brew`) + +To see what each recipe installs, check the files under `provisioning/` + +## Local zshrc + +For local modifications to the zshrc create `~/.zshrc.local`. + +## Local vim overrides + +For local modifications to your neovim init create `~/.config/nvim/lua/init_local.lua` + +## Environment modification + +In order to specify the environment in the prompt, create a function +called `env_info_provider` and echo your environment details (eg. +`dev`, `staging`, `production`) + +## LSP & Neovim + +For the LSP to work, some external dependencies might be needed. As some of +these depend on what version asdf has loaded, or specific projects, they're +not included by default. + +See [the nvim-lspconfig docs][lsp] for more info. +[lsp]: https://github.com/neovim/nvim-lspconfig/blob/master/doc/server_configurations.md + +## Private Files + +There are some potentially sensitive files included. They're PGP encrypted. If +you need them you can run `./sensitive`. To update them if they change, +run `./sensitive update` instead. + +For passwords, make sure you have setup the `pass` store.