dotfiles/README.md

58 lines
2.7 KiB
Markdown
Raw Normal View History

2021-01-07 08:09:41 +00:00
# .dotfiles
## Quick setup
Clone in `~/.dotfiles` and run make:
```
make bootstrap
```
## Contents
1. *installed_packages* directory used in Linux and Mac installations to create groups of installed packages, which can easily be cloned using **clone-installation** script. List is generated using **migrate-installation** script and it can be compared with any other using **compare-installation**.
2022-05-15 14:44:28 +00:00
2. *symlinks* directory containing many configuration files which are symlinked during installation process in their correct places to be used later
2021-01-07 08:09:41 +00:00
- **Git** related files - global *gitconfig* and *gitignore*
- **Shell** config files - bash/zsh/fish for linux/mac
- **Vim/Nvim** config files
- **Arch** config files - many configuration files controlling most of the setup
- **config** directory, containing custom configurations for many apps (most of Linux apps and some of Mac OS apps)
- **bin** director containing many useful scripts, many of them requiring **Arch Linux** and its setup
2022-05-15 14:44:28 +00:00
3. *tests* directory contains various generic tests that are used in CI to confirm the custom tools and configuration work as expected
2021-01-07 08:09:41 +00:00
## Installation manual
### Linux (Arch)
1. Install Arch based distribution of choice (Arch - https://wiki.archlinux.org/index.php/Installation_guide)
2. Install git
3. Clone this repo into $HOME
4. Run `make bootstrap`
5. (Optional) Run clone-installation and select installation to clone
### Linux (Other)
1. Install Linux distribution of choice
2. Install git
3. Clone this repo into $HOME
4. Run make `make bootstrap`
5. Everything should be fine. Many custom scripts may not work, since they rely on either **pacman** or some of the basic packages installed using **clone-installation** script, which is also using **pacman**
### Mac OS
1. Clone this repo into $HOME
2. Run make `make bootstrap`
3. If you need more homebrew packages, check *installed_packages* directory and choose your list. Install it by moving into specific packages set directory and running `brew bundle` (or `clone-installation` if you have sourced new ~/.profile)
### Windows
1. Clone this repo into user home
2. Run `make bootstrap` or run `windows/install_windows.bat` directly with double click or through cmd
3. This will only link vim and git configurations
## Post installation steps
After installation optionally check out `installed_packages` directory for packages to install using `clone-installation`.
This repository also provides a simple way to generate main personal ssh key to be used with GitHub:
```
make create_personal_ssh_github_key
```
2021-01-07 08:40:02 +00:00
It is recommended to also clone `vimwiki` and use it (this is a private repository and applies only to owner):
2021-01-07 08:09:41 +00:00
```
make clone_personal_viwiki
```