dotfiles/README.md

# brethil's dotfiles

My own dotfiles. `zsh` configuration based on [antibody](https://github.com/getantibody/antibody) and [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh), `vim` configuration uses [vim-plug](https://github.com/junegunn/vim-plug), [ALE](https://github.com/dense-analysis/ale) and more.

[!ci.decapod.one status](https://ci.decapod.one/api/badges/2/status.svg)

[zsh theme](docs/brethil-theme.png "zsh theme")
[vim theme](docs/vim.png "vim theme")
[tmux theme](docs/tmux.png "tmux theme")

## Description

    ├── README.md
    ├──────── Main files ────────
    │ ├── aliases/
    │ │     └── aliases definitions. Add .zsh files here to include more
    │ ├── functions/
    │ │     └── functions definitions. ADD .zsh files here to include more
    │ ├── colors.zsh
    │ │     └── ANSI color escapes
    │ ├── ansible
    │ │     └── ansible playboooks/config
    │ ├── brethil_dotfile.sh:
    │ │     └── ansible playboooks/config
    │ ├── antibody_plugins.txt
    │ │     zsh plugins sourced by antibody
    ├──────── oh-my-zsh themes ────────
    │ ├── themes
    │ │     ├─ brethil.zsh-theme
    │ └     └─ brethil-minimal.zsh-theme
    ├──────── Misc rc files────────
    │ ├── gitconfig
    │ │     └── git configuration
    │ ├── ipython/
    │ │     ├── ipython configs
    │ ├── vim
    │ │    ├── vimrc
    │ │    │ └── main vim rc
    │ │    ├── plugs.vim
    │ │    │ └── plugins to be installed with vim-plug
    │ │    ├── plugins_config.vim
    │ │    │ └── plugins configuration
    │ │    ├── shortcuts.vim
    │ │    │ └── vim shortcuts definitions
    │ │    └── functions.vim
    │ │      └── miscellaneous vim function
    │ └── pdbrc.py
    │      └── pdb++ rc (a drop-in replacement for pdb)
    ├──────── Other ─────────────
    ├── extras/check_for_update.zsh
    │      └── selfupdate script
    └── useful_commands

## Installation

### With ansible:

```bash
bash dev/add_community.general.sh # only if community.general is not installed
ansible-playbook -v -i <hosts file> ansible/playbooks/setup.yml
```

This playbook can be tested [with a docker container](dev/README.md)

### Manually

This requires [antibody](https://github.com/getantibody/antibody) to be installed.

```bash
git clone https://git.decapod.one/brethil/dotfiles ~/.dotfiles
echo 'DOTFILES=~/.dotfiles' >> ~/.zshrc
echo 'source $DOTFILES/brethil_dotfile.sh'
ln -s ~/.dotfiles ~/.vimrc
```

## Updating

A self-update mechanism is included. It asks for confirmation to pull the latest changes
from the git repo every two weeks. This also updates the git-sourced repositories installed
by the install script. The self-update routine can be called manually by calling

```bash
dotfiles_selfupdate
```

This can be disabling by setting the `DISABLE_DOTFILES_AUTO_UPDATE` env var before before sourcing `brethil_dotfile.sh`

## Try it out

Docker images are regularly built, and they include a full development environment (hence are quite large)

```bash
docker run -it registry.decapod.one/brethil/dotfiles
```