This repository has been archived on 2024-03-28. You can view files and clone it, but cannot push or open issues or pull requests.
dotfiles/readme.md

158 lines
4.7 KiB
Markdown
Raw Normal View History

2020-11-06 00:31:43 -06:00
# lytedev's dotfiles
2017-02-05 14:38:57 -06:00
2021-11-03 12:01:43 -05:00
My various configuration files. I can't recommend using them directly, just
take what you like.
2020-11-06 12:00:43 -06:00
2021-11-03 13:28:25 -05:00
## Links
2020-11-06 11:52:18 -06:00
2021-11-03 13:28:25 -05:00
[🖥️ Upstream][upstream] • [🐙 GitHub Mirror][github]
2021-11-03 13:27:46 -05:00
# Basic Setup
```bash
curl -LO lyte.dev/df.sh && sh -i df.sh
```
2021-11-03 13:27:46 -05:00
2021-11-03 13:36:35 -05:00
## Manual Setup
2021-11-03 13:27:46 -05:00
```bash
git clone https://git.lyte.dev/lytedev/dotfiles.git "$HOME/.config/lytedev-dotfiles"
"$HOME/.config/lytedev-dotfiles/common/bin/dotfiles-setup"
```
2021-11-03 13:27:46 -05:00
2023-04-16 02:50:54 -05:00
## Provisioned Setup
This method is incomplete and unstable. It takes a fresh box with a network
connection and fully sets it up the way I like.
```bash
curl -LO lyte.dev/dfi.sh && sh -i dfi.sh
```
2021-11-03 13:24:05 -05:00
# Repo Structure
My dotfiles are composed together by layering "environments" since I want my dotfiles to be flexible across servers, laptops, desktops, and even my phone (via Termux).
```
lytedev-dotfiles
|- common --- common to all hosts and operating systems
| |- bin ------- programs or scripts useful to all hosts/OSs
| |- data ------ shared storage for certain scripts
| '- {app...} -- configuration related to {app}
|- host ----- specific to specific hosts or types of hosts
| |- desktop --- for desktop-class machines
| |- headless -- for server-class machines with no display/GUI
| '- laptop ---- for portable, battery-having machines
'- os ------- specific to operating systems
|- linux ----- you alread know <3
| |- desktop ------ for desktop-class machines
| |- headless ----- for server-class machines with no display/GUI
| |- bin ---------- programs/scripts useful to linux machines
| |- {distro...} -- configuration related to {distro}
| '- {app...} ----- linux-specific configuration related to {app}
'- macos ----- for those stupid macbooks work tries to make you use
```
2021-11-03 13:24:05 -05:00
Any environment should be able to extend the configuration of any application
in some unique way. This isn't possible with all applications, of course, since
some programs do not make it easy (or possible) to include multiple
configuration files or to extend a single file by having it include others via
globs or some other mechanism.
One example of doing this well is with fish:
```fish
for s in $ENV_PATH/*/config.d.fish; source $s (dirname $s); end
```
2021-11-03 13:24:05 -05:00
This way, if any environment (a dir in $ENV_PATH) has a `config.f.fish` script
inside, it will be sourced by the main configuration file.
Likewise, some setup only happens in certain environments via the
`dotfiles-setup.d.fish` script.
2021-11-03 13:27:04 -05:00
One important note on environments is that even though they are laid out like
a tree (directories), you do NOT automatically get the parent-environment's
configuration, so if you are setting up a Arch Linux desktop machine, you
cannot only link the `os/linux/arch` and `host/desktop` environments but will
also need to include `os/linux` if you want the Linux-generic configuration.
2021-11-03 13:27:46 -05:00
# Post-Setup
2021-11-03 12:01:43 -05:00
You will want to symlink relevant environment layers into the `$ENV_PATH` in
order to have your OS-specific applications be configured and common
applications configured for the host OS.
2017-02-05 14:38:57 -06:00
2022-12-13 14:12:29 -06:00
There's a handy script that makes this super easy (note that you
2021-11-03 12:52:33 -05:00
can select multiple environments with TAB):
2021-09-24 13:06:43 -05:00
```bash
dotfiles-link-environments
2022-08-09 09:41:58 -05:00
```
2021-11-03 12:01:43 -05:00
You can also list the possible environments:
```bash
cat $DOTFILES_PATH/common/envs
```
2021-11-03 12:01:43 -05:00
2021-11-03 12:52:33 -05:00
And then link them yourself (note that environments must be in $ENV_PATH and
cannot be nested, so replacing slashes with dashes is a nice way to show what's
going on):
2021-11-03 12:01:43 -05:00
```
ln -s (pwd)/os/linux $ENV_PATH/os-linux
ln -s (pwd)/os/linux/arch $ENV_PATH/os-linux-arch
ln -s (pwd)/host/laptop $ENV_PATH/host-laptop
ln -s (pwd)/host/laptop/third $ENV_PATH/os-laptop-third
# etc...
```
2021-11-03 12:01:43 -05:00
And run setup again once you've finished linking all related environments:
```bash
dotfiles-setup
```
2021-11-03 12:01:43 -05:00
2021-11-03 13:43:35 -05:00
# Updating
Fork this repo, update your origin to point to your fork, and commit changes:
```bash
git remote origin set-url $YOUR_REPO
```
2021-11-03 13:43:35 -05:00
Then you can just pull your changes down from wherever.
## No I want your updates
You don't. I rip and tear my dotfiles all the time and will break your entire
machine. Remember about not using other people's dotfiles directly?
But if you must, you can add an upstream remote to point to my repo:
```bash
git remote add upstream https://git.lyte.dev/lytedev/dotfiles.git
```
2021-11-03 13:43:35 -05:00
Then you can fetch and merge in my changes whenever you want:
```bash
git fetch upstream
git merge upstream/master
```
2021-11-03 13:43:35 -05:00
2022-08-09 09:41:36 -05:00
# Todo
2023-04-16 02:50:54 -05:00
They're littered throughout the repo in code comments. `rg -i todo`
2022-08-09 09:41:36 -05:00
2021-11-03 13:28:25 -05:00
# Screenshots
2023-04-16 02:50:54 -05:00
Any relevant screenshots should be findable here:
[files.lyte.dev/images](https://files.lyte.dev/images/)
2021-11-03 13:28:25 -05:00
2021-11-03 13:43:35 -05:00
[upstream]: https://git.lyte.dev/lytedev/dotfiles
2019-03-19 10:58:12 -05:00
[github]: https://github.com/lytedev/dotfiles
[desktop-screenshot]: https://files.lyte.dev/unix/desktop-screenshot.png
2020-11-06 11:59:39 -06:00
[battlestation-photo]: https://files.lyte.dev/unix/battlestation.jpg