dotfiles/README.md

51 lines
1.5 KiB
Markdown
Raw Permalink Normal View History

# Dotfiles
This repository contains useful (config) files that I use on my machines.
## Initialization
On a freshly set up machine, run:
```bash
curl https://gitlab.webartifex.biz/alexander/dotfiles/-/raw/main/.config/shell/init_dotfiles.sh \
> /tmp/init_dotfiles.sh \
&& source /tmp/init_dotfiles.sh \
&& rm /tmp/init_dotfiles.sh
```
This gives you a local copy of the latest version of this repository
(located in `~/.dotfiles`)
and initializes all the dotfiles provided here on your system.
Furthermore, `zsh` is set up with [`oh-my-zsh`](https://ohmyz.sh/) and `zplug`.
**Note**: Log out and in again so that `bash` and `zsh` run as *login* shells.
Otherwise, `~/.profile` is probably *not* sourced.
Don't worry: Your current dotfiles are backed up in the `~/.dotfiles.bak` folder!
### Python Development Environments
The develop environments for Python are managed by [`pyenv`](https://github.com/pyenv/pyenv).
To set them up, run:
```bash
install-pyenv && create-or-update-python-envs
```
Several Python binaries are installed.
Additionally, two `virtualenv`s, "interactive" and "utils", are also created:
- "interactive" is the default environment with *no* libraries installed, and
- "utils" hosts globally available utilities.
Use `pyenv local ...` to specify a particular Python binary for a project.
### Non-public Dotfiles
After setting up the Python environments (i.e., the "utils"),
running `mackup restore` symlinks further dotfiles into `~/`.
This only works for this project's maintainer.