526a6521fa | ||
---|---|---|
LICENSE | ||
Makefile | ||
README.md | ||
burrow | ||
burrow.1 | ||
burrow.d |
README.md
burrow
burrow is a helper for building and managing a gopher hole.
Installation
Requirements
- make
- bash 4+
Install
sudo make install
Note: On systems without admin access the binary can be run directly from the
git repo, but will lack man
support and command completion.
Uninstall
sudo make uninstall
Usage
burrow phlog # create new phlog post
burrow recipe # add new recipe to box
burrow create-config # generate a default config file
burrow update-git # pull latest git repo for gopher dir, if exists
-
phlog
will prompt for the title of the post, then open it in your default$EDITOR
. By default it will provide you a template, but you can override this by including a.template
file in your phlog directory. -
recipe
will prompt for the name of your recipe, then open it in your default$EDITOR
. By default it will provide you a template, but you can override this by including a.template
file in your recipe box directory. -
create-config
gives you the same settings as you have by default without a configuration file, but it provides you a starting point for customization. -
update-git
is appropriate for cron jobs to keep the gopher hole in sync.
man burrow
or burrow -h
for more information.
Config
The following locations are available for configuration:
$HOME/.config/burrow/config
$HOME/.config/burrow
$HOME/.burrow
These files are processed in the order listed. Variables defined in multiple locations will use the last assigned value.
The following options are available (defaults shown):
config_location_gopher="$HOME/gopher"
config_location_phlog="$HOME/gopher/phlog"
config_location_recipebox="$HOME/gopher/recipebox"
config_git_commit=false
config_git_push=false
config_autoindent=true
config_custom_editor=false
Note: This file is a valid Bash script and will be sourced upon load.
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.