Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xunleii/.dots
https://github.com/xunleii/.dots
Last synced: 10 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/xunleii/.dots
- Owner: xunleii
- License: wtfpl
- Created: 2021-05-10T18:44:03.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-04T08:03:04.000Z (2 months ago)
- Last Synced: 2024-10-13T00:55:41.744Z (24 days ago)
- Language: Shell
- Size: 295 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> [!WARNING]
> This repo is intended to be used for myself... Use at your own risk
# .dots
## TLDR;
```bash
sudo apt-add-repository ppa:fish-shell/release-3
sudo apt upgrade
sudo apt update
sudo apt install fish gzip keychain neovim unzip
BINDIR=$HOME/.local/bin sh -c "$(curl -fsLS https://raw.githubusercontent.com/twpayne/chezmoi/master/assets/scripts/install.sh)" -- init --apply https://github.com/xunleii/.dots
```
## How to use this repository
To be honest, I recommend NOT using this repository, but building your own fork with your own settings.
I created this repository to store my own configuration and settings for my computers; even if it works for me, I don't guarantee it will for you.
Currently, it has been tested for these systems:
- ~~**Fedora 37 Workstation**~~ _(no more maintained)_
- **WSL Ubuntu 23.04** on **Windows 11** _(to be tested on CI)_
## Packages requirements
> [!Note]
> Since all my _dots_ files are intended to be run in _WSL_, I removed all configurations for all GUI applications _(like Terminator or Kitty)_. So no dependency on the Windows manager is necessary.
### [chezmoi](https://www.chezmoi.io) - _dot files_ manager
> [!Note]
> `chezmoi` is automatically installed on bootstrap... by `chezmoi` itself
`chezmoi` is a fantastic _dot files_ manager that I use to bootstrap and maintain all of my settings.
### [fish](https://fishshell.com) shell - a smart and user-friendly command line shell
I use `fish` a lot on a daily basis, so it's mandatory to install it.
However, I recommend that you use the latest stable version in order to be totally in line with my settings. For example, on Ubuntu, the fish package is too old for my configuration and you need to install the official PPA (https://launchpad.net/~fish-shell/+archive/ubuntu/release-3).
Everything is explained in their documentation (https://fishshell.com).
### [asdf](https://asdf-vm.com) - runtime versions manager
> [!NOTE]
> `asdf` is automatically installed on bootstrap, using `chezmoi` externals
To manage certain packages _(`terraform`, `kubectl`, but also `python` or `golang`)_, I use `asdf`. `asdf` is a kind of easily configurable "package manager" which can manage several versions on a single computer. What's more, these versions are automatically managed in a file called `.tool-versions`, which allows each project to have different package versions without any problem _(for example, I use it to manage several versions of `python` depending on the project)_.
### [direnv](https://direnv.net) - unclutter your .profile
> [!NOTE]
> `direnv` is automatically installed on bootstrap, using `chezmoi` externals
Like `asdf` but for environment variables and "project layout" _(sort of preconfigured environment for languages like `python` or `golang`)_. It's very practical because I can configure an environment according to where I am.
## LICENSE
