4.3 KiB
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.
See the Getting Started guide.
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
-
create-config
will auto-generate a configuration file at$HOME/.config/burrow/config
. It will be populated by the default parameters listed below and provide an easy way to customize your configuration. At a minimum you should update yourconfig_dir_gopher
to point to the folder on your local computer where your gopher hole resides. -
phlog
will prompt for the title of a new 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. -
update-git
will silently attempt to update a git repository at the location of your gopher hole. It is appropriate for use by a cron job.
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_dir_gopher="$HOME/gopher" # local path to gopher site
config_gopher_server="sdf.org" # server of gopher host
config_gopher_port="70" # port of gopher host
config_gopher_root="/users/username/" # path on gopher host to gopher site
config_dir_phlog="phlog" # relative path to phlog
config_phlog_gophermap=true # phlogs use gophermap format by default
config_phlog_usedate=true # use a date-stamp on phlog posts
config_dir_recipebox="recipebox" # relative path to recipe box
config_recipebox_gophermap=false # recipes use plain text by default
config_recipebox_usedate=false # do not use a date-stamp on recipe filenames
config_dir_topics="topics" # relative path to topics directory
config_topics_gophermap=true # topic notes use gophermap format by default
config_topics_usedate=false # do not use a date-stamp on topic filenames
config_git_commit=false # automatically commit changes if git repo
config_git_push=false # automatically push changes if git repo
config_autofold=false # automatically break lines at specific width
config_foldwidth=66 # width of line used for autofold
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.