Alexander Hess
4c6526b1cc
- ignore apps whose config files are in the `dotfiles` repo (see: https://gitlab.webartifex.biz/alexander/dotfiles) - include various (config) files that should not be public: + Cisco's AnyConnect + history files for `bash`, `less`, `python`, `psql`, `tig`, and `zsh` + Nautilus' bookmarks + SSH config & known hosts
50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# 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.
|