dot/dots
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity
Bootstrap and simple management script for my dotfiles https://dots.00dani.me/README
55 commits 1 branch 0 tags 193 KiB
JavaScript 81.8%
Shell 12.7%
TypeScript 2.3%
HTML 1.7%
Ruby 1.4%
Other 0.1%
Find a file
Danielle McLean b12ce74be9
Document the environment variables that can be set to customise dots
2020-06-18 13:47:48 +10:00
config/zsh/functions Add a dots pull command which just git pulls in every package 2016-10-30 10:17:24 +11:00
local/bin Make the 'bare' dots package prefix configurable, defaulting to my Gitea dot org 2020-06-18 13:37:53 +10:00
site Completely ditch the custom main.scss file, since I wasn't doing anything special with it anyway 2020-06-18 13:28:12 +10:00
.gitignore Update gitignore: the newer version of Jekyll uses different stuff that must be ignored, apparently 2020-06-18 12:07:04 +10:00
.stow-local-ignore Push Jekyll site files into a subdirectory to avoid confusing them with actual dots script files 2020-06-18 12:00:16 +10:00
.stow-rename Added zsh completion support :D 2016-10-27 16:33:59 +11:00
README.md Document the environment variables that can be set to customise dots 2020-06-18 13:47:48 +10:00

README.md

dot/dots

A fast and easy bootstrap for my dotfiles that also acts as a simple management script once installed. Bootstrapping is as simple as:

curl https://dots.00dani.me | zsh

If you're wary about piping scripts into your shell - you should be - then feel free to download the script and check it out first. dots is designed to crash harmlessly rather than run something dangerous if curl is interrupted, however.

curl https://dots.00dani.me > dots
less dots
# reviewing ... looks okay!
zsh dots

When run through either of these methods, dots will install itself, GNU Stow (if not already installed globally), and my configuration for git, vim, and zsh.

By default, packages are installed by dots to ~/dotfiles and then linked into ~ using Stow. Environment variables are available for customising this behaviour.

Environment Variables

  • DOTFILES - the location to clone new packages. Defaults to ~/dotfiles. Don't set it to ~, because that'll just be super confusing.
  • DOTS_SOURCE_PREFIX - a URL prefix that will be prepended to simple package names, like "git" and "vim". Defaults to https://git.00dani.me/dot. You might want to change this to point at your own Git hosting.
  • STOW - which GNU Stow binary to use. Defaults to stow. You probably don't need to change this.
  • HOME - the target directory for linking packages. Probably not a good idea to change this either.