burrow

burrow is a helper for building and managing a gopher hole.

Installation

Requirements

• bash 4+ (OSX: brew install bash)
• GNU sed (OSX: brew install gnu-sed --with-default-names)
• GNU getopt (OSX: brew install gnu-getopt --with-default-names)

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 or update a recipe to box
burrow topic          # add or update a topic file
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.

• topic will prompt for the name of the topic, 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 topics 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:

1. $HOME/.config/burrow/config
2. $HOME/.config/burrow
3. $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_dir_gopher="$HOME/gopher"       # local path to gopher site
config_dir_phlog="phlog"               # relative path to phlog
config_dir_recipebox="recipebox"       # relative path to recipe box
config_dir_topics="topics"             # relative path to topics directory
config_gopher_server="sdf.org"         # server of gopher host
config_gopher_port="70"                # port of gopher host
config_gopher_root="/users/username/"  # absolute path on gopher host to gopher site
config_git_commit=false                # automatically commit changes if git repo
config_git_push=false                  # automatically push changes if git repo
config_autoindent=true                 # automatically reformat gophermaps with leading spaces
                                       # and parse links at the end of file

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.

License

GPL3