Where the wind takes us next year no turtle can tell
But we'll still be at home, come high water or hell,
Because home is wherever you carry your shell.
-- Windward, by Stephen Savitzky, 2015
This project is a sample customization package for Honu. It does nothing at all out of the box -- it's perfectly useless unless you fork it, hack on it, and otherwise make it your own. (My own customized version is called Mathilda, and you won't find it here on GitHub.)
Myrtle is meant to be installed in the same directory as Honu. It has a
bootstrap.sh
shell script that sets up the environment variables that Honu
is looking for, bootstraps Honu, and finally does its own install.
bootstrap.sh
This is the shell script that runs the configuration process. Just say:
wget -O - https://github.com/ssavitzky/Myrtle/raw/master/bootstrap.sh | bash
or something of the sort. You can also clone the repo and source it, but
half the fun is watching the magic unfold.
The sequence of events is:
- Set up environment variables for Honu
- Source Honu's bootstrap.sh from Github if it isn't local. ..- this, of course, installs your packages and dotfiles
- Install its own dotfiles, e.g. your mail aliases, bookmarks, etc.
- Overide some of the files in Honu/local.
MIT-LICENSE.txt
The license for this project.
Makefile
Once things get bootstrapped, the entire configuration process is run
via the Makefile. make install
is the main target; eventually there
will be targets for partial installs, e.g. on tiny systems or systems
where I don't have sudo
access.
For the most part, these function just like the corresponding directories in Honu. Some of them are empty except for their Makefile, waiting for you to add your own content.
bin/
Programs. Your choice. Symlinked from ../Honu/local
; .bashrc
already
knows to look there.
dotconfig/
Configuration files and directories that go into ~/.config/
. These are
symlinked so as not to conflict with the stuff already there.
dotfiles/
Configuration files that go into the home directory. They are symlinked rather than being copied.
emacs/
As with bin, we just symlink this from ../Honu/local
, where Honu's .emacs
is already set up to look for it.
local/
Files that are expected to be edited on a per-system or per-user basis.
Initial versions are created by make install
; they are symlinked into
../Honu/local
, so you can use them to override the defaults that Honu
installs.
opt/
The Makefile here lets you download and install various optional
programs from elsenet. (Right now the only one is dzen2
-- older
releases of Debian and Ubuntu don't have one that's recent enough to
include all the features I want to use with xmonad
.)
setup/
Scripts for configuring the things that can't (easily) be installed by
simply symlinking a dotfile. This includes a lot of Gnome options. There
are also files with a -pkgs
suffix, that install programs using apt
.
Copyright © Stephen R. Savitzky (HyperSpace Express)