dotfiles/README.md
2026-03-29 00:03:55 +01:00

68 lines
1.5 KiB
Markdown

# dotfiles
Managed with [GNU Stow](https://www.gnu.org/software/stow/).
## Packages
| Package | Target | Description |
|----------|--------------|------------------------------------|
| `bash` | `~` | `.bashrc` and `.bashrc.d/` |
| `vim` | `~` | `.vimrc` and `.vim/` with plugins |
| `portage`| `/etc` | Gentoo portage configuration |
## Installation
### 1. Clone
```bash
git clone --recurse-submodules forgejo@lohic.dev:loic/dotfiles.git ~/Documents/dotfiles
cd ~/Documents/dotfiles
```
If already cloned without submodules:
```bash
git submodule update --init --recursive
```
### 2. Install stow
Gentoo:
```bash
sudo emerge app-admin/stow
```
### 3. Apply packages
```bash
cd ~/Documents/dotfiles
stow bash
stow vim
sudo stow --target /etc portage
```
## Vim plugins
Plugins are managed as git submodules in `vim/.vim/pack/`:
| Plugin | Category |
|-------------------------|----------|
| vim-lsp | lsp |
| asyncomplete.vim | lsp |
| asyncomplete-lsp.vim | lsp |
| vim-lsp-settings | lsp |
| everforest | theme |
| vim-polyglot | theme |
| fzf.vim | utils |
| vim-fugitive | utils |
| vim-repeat | utils |
| vim-singlechar | utils |
| vim-surround | utils |
| vim-vinegar | utils |
To update all plugins:
```bash
git submodule update --remote --merge
```