From 509097bf0b4626e78be6296b0e451ecf3a659d4b Mon Sep 17 00:00:00 2001 From: Ben Harris Date: Sat, 28 Sep 2019 13:42:15 -0400 Subject: [PATCH] add gopher wiki article --- wiki/source/gopher.md | 59 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 wiki/source/gopher.md diff --git a/wiki/source/gopher.md b/wiki/source/gopher.md new file mode 100644 index 0000000..3d610fd --- /dev/null +++ b/wiki/source/gopher.md @@ -0,0 +1,59 @@ +--- +title: gopher +author: benharri +--- + +tilde.club now serves gopher! we're using +[gophernicus](https://github.com/gophernicus/gophernicus) as our +gopherd. + +user pages are served from your `~/public_gopher` dirs and can be +accessed at `gopher://tilde.club/1/~username`. note that the itemtype +`1` is required. + +## basic gophermap syntax + +files named `gophermap` are the gopher equivalent to index.html. each +line in a gophermap consists of the following parts separated by literal +tab characters: + +- item type +- display name +- selector +- host +- port + +for example: + +`1tildeclub/tilde.club70` + +basic item types include: + +- `0` - text file +- `1` - directory +- `7` - search query +- `9` - binary file +- `g` - gif image +- `h` - html file +- `i` - info text +- `I` - generic image file (not a gif) + +gophernicus also supports the following special types: + +- `#` - comment +- `!title` - only valid on the first line +- `-file` - hide file from listings +- `:ext=type` - change filetype +- `~` - include a list of users with a valid `~/public_gopher` +- `=mapfile` - include or execute a script or gophermap +- `-` - stop processing gophermap and include file listing + +- `.` - stop processing gophermap (default) + +## additional resources + +see [gophernicus' gophermap +documentation](https://github.com/gophernicus/gophernicus/blob/master/README.Gophermap) +for more info on available item types and other special selectors. + +if you're completely new to gopher, check out the [gopher zone](https://gopher.zone)!