wiki/pages/gopher.md

Getting Started With Gopher

Using burrow

To create a gopher hole on tilde.institute, a user can easily get started by doing the following:

Create the gopher directory

$ mkdir public_gopher 

Create a root gophermap

$ 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.

Create a phlog directory

$ mkdir ~/public_gopher/phlog 

Now create a new phlog with burrow

$ 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

back