dots/site
2023-11-01 14:23:15 +11:00
..
_includes Remove unused Subscribe button from footer 2023-10-16 14:06:12 +11:00
_scripts Make partial-dl-test way more robust and thorough 2023-10-16 15:38:13 +11:00
assets Remove some spurious margin from pretty homepage/script 2023-11-01 14:21:45 +11:00
.ruby-version Specify Ruby version to use (3.2.2) 2023-10-16 13:48:14 +11:00
_config.yml Install Highlight.js for on-the-fly highlighting of curlable script 2023-11-01 14:14:38 +11:00
bun.lockb Install Highlight.js for on-the-fly highlighting of curlable script 2023-11-01 14:14:38 +11:00
Gemfile Upgrade to Jekyll 4.3.2 and Minima 3 2023-10-16 14:05:40 +11:00
Gemfile.lock Upgrade to Jekyll 4.3.2 and Minima 3 2023-10-16 14:05:40 +11:00
index.html Highlight dots homepage on the fly if you open it in browser 2023-11-01 14:20:04 +11:00
local Fix broken symlink making ~/.local available to Jekyll site 2023-11-01 12:12:10 +11:00
netlify.toml Fix publish dir relative to base 2023-11-01 14:23:15 +11:00
package.json Install Highlight.js for on-the-fly highlighting of curlable script 2023-11-01 14:14:38 +11:00
partial-dl-test.html Push Jekyll site files into a subdirectory to avoid confusing them with actual dots script files 2020-06-18 12:00:16 +10:00
README.html Hmm, try using separate symlinks that aren't excluded from Jekyll to load the base repo stuff into the site? Might be more reliable 2020-06-18 14:00:35 +10:00
README.md Hmm, try using separate symlinks that aren't excluded from Jekyll to load the base repo stuff into the site? Might be more reliable 2020-06-18 14:00:35 +10:00

dot/dots Netlify Status

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.

Subcommands

Much like git and many other tools, dots is based around subcommands for accessing particular functions. The available commands are:

bootstrap

Set up dotfiles on a brand-new system. Will create a DOTFILES package directory, clone GNU Stow into it if necessary, clone itself and other default packages, and then link everything using Stow. This is the default command if dots is run on a system where DOTFILES doesn't already exist, leading to the succinct bootstrap snippet shown above.

clone

Will clone one or more packages specified into your DOTFILES directory. Packages must be specified as Git repository URLs, but two forms of shorthand are supported:

  • GitHub package paths: "sharkdp/bat", "hlandau/acmetool". "https://github.com/" will automatically be prepended to find the correct GitHub repository.
  • Simple package names: "git", "emacs", "task". The entire DOTS_SOURCE_PREFIX is prepended to these names, hopefully producing a URL that points to your self-hosted Git service.

fetch

Will simply run git fetch -p for each of the specified package names. If there are no package names provided, will implicitly run over all packages.

Will employ GNU Stow to symlink each of the packages specified by name into your HOME. If no package names are provided, will implicitly link all packages.

pull

Very similar to fetch. Will simply run git pull for each of the specified package names. If there are no package names provided, will implicitly run over all packages.

status

Can be abbreviated to st. Will list all packages you have cloned into your dotfiles directory, along with their Git status (whether the working directory is clean, whether there are commits to push or pull, that sort of thing). This command is the default if you have already bootstrapped.