readme formatting

This commit is contained in:
Erin 2023-07-12 01:22:07 -04:00
parent 3df589aa46
commit 9a730a128b

View file

@ -4,7 +4,10 @@ too many dotfiles
## Installation
Use [GNU Stow](https://www.gnu.org/software/stow/) (`apt install stow`, etc.). The repo has a `.stowrc` which should target your home directory as the installation directory, but in some cases the `~` may not be evaluated and you'll have to specify `--target="$HOME"`.
Use [GNU Stow][stow] (`apt install stow`, etc.). The repo has a `.stowrc` which
should target your home directory as the installation directory, but in some
cases the `~` may not be evaluated and you'll have to specify
`--target="$HOME"`.
Install the essentials with `stow zsh vim git`.
@ -12,12 +15,22 @@ Install the essentials with `stow zsh vim git`.
### Git
Most of my git configuration lives in `~/.config/git/personal.gitconfig`, which is `include`d from `~/.gitconfig`. I do this to separate system-specific configuration that may be set by automated tools (i.e. the Github CLI setting up credential managers for guthub.com and gist.github.com) from my personal, cross-platform configuration (e.g. my identity and aliases).
Most of my git configuration lives in `~/.config/git/personal.gitconfig`, which
is `include`d from `~/.gitconfig`. I do this to separate system-specific
configuration that may be set by automated tools (i.e. the Github CLI setting up
credential managers for guthub.com and gist.github.com) from my personal,
cross-platform configuration (e.g. my identity and aliases).
Keep configuration that should be synced between computers in the `personal.gitconfig` file, and after cloning the repository, consider telling Git to ignore local changes to the main `.gitconfig` file:
Keep configuration that should be synced between computers in the
`personal.gitconfig` file, and after cloning the repository, consider telling
Git to ignore local changes to the main `.gitconfig` file:
git update-index --skip-worktree git/.gitconfig
### KDE
Files in `~/.local/share/color-schemes` come from [my repo of KDE titlebar color schemes](https://github.com/eritbh/kde-application-titlebar-themes).
Files in `~/.local/share/color-schemes` come from [my repo of KDE titlebar color
schemes][colors].
[stow]: https://www.gnu.org/software/stow
[colors]: https://github.com/eritbh/kde-application-titlebar-themes