burrow
To create a gopher hole on tilde.institute, a user can easily get started by doing the following:
$ mkdir public_gopher
$ burrow gophermap
Gophernicus will interpret any text you add here as information lines unless they begin with one of gophernicus' special characters or contains a tab. As a general rule, don't use tabs unless you're intentionally linking something.
Add a cool header to the file (check out figlet
!), then somewhere
near the top, paste:
==== Last Updated: February 19th, 2019 ====
The date doesn't matter, really. Whenever you "phlog" with burrow
it will update the date for you. How sweet is that?
Now lets add a link to your phlog that you're totally going to have:
1phlog[tab]phlog
That [tab]
should be a literal tab, though. Make sure your editor
doesn't convert it to spaces. Now, save and quit the editor.
$ mkdir ~/public_gopher/phlog
$ burrow phlog
You'll be prompted for a title. If you hit enter and give no title then burrow will abort.
Once you hit enter after giving your title a temporary file will open in
your default $EDITOR
. Don't like that editor? Be sure to change your
environment var!
If you quit your phlog file without saving the post is aborted. If you save and quit, it will create a new phlog entry, add it to your phlog gophermap that now exists, and update the date on your root gophermap. That's it!
You have an RSS file sitting in the root of your gopher hole at
rss.xml
. It will automatically generate when you phlog, like a
winner. You can edit your root gophermap
at any time by using burrow's
gophermap
action. If you create other folders and gophermaps in the
future you can use burrow's gophermap function to target them. For
instance, to open the phlog listings you would:
$ burrow gophermap /phlog
Editing gophermaps with burrow
will ensure they're always
saved and formatted properly! Any other files are just text, so open them
directly with your editor of choice.
That's it! Happy gophering.
~tomasino