phd is an esoteric gopher server for small gopherholes.
point it at a directory and it'll serve up all its text files,
sub-directories, and binary files over gopher. any .gph files will
be served up as gopermaps and executable .gph files will be
run as a script with their output served to the client, like cgi!
special files:
dog.gph from disk.any line in a .gph file that doesn't contain tabs (\t) and doesn't
start with an i will get an i automatically prefixed, turning it
into a gopher information item.
any .gph file that is marked executable with be run as if it
were a shell script and its output will be sent to the client. it will
be passed three arguments: the query string (if any, the host, and the
port. do with them what you will.
for example:
$ cat echo.gph
#!/bin/sh
echo "Hi, world! You said:" $1
echo "1Visit Gopherpedia / gopherpedia.com 70"
then:
$ gopher-client gopher://localhost/1/echo?something
[INFO] Hi, world! You said: something
[LINK] Visit Gopherpedia
or more seriously:
$ cat figlet.gph
#!/bin/sh
figlet $1
then:
$ gopher-client gopher://localhost/1/figlet?hi gopher
[INFO] _ _ _
[INFO] | |__ (_) __ _ ___ _ __ | |__ ___ _ __
[INFO] | '_ \| | / _` |/ _ \| '_ \| '_ \ / _ \ '__|
[INFO] | | | | | | (_| | (_) | |_) | | | | __/ |
[INFO] |_| |_|_| \__, |\___/| .__/|_| |_|\___|_|
[INFO] |___/ |_|
Usage:
phd [options] <root directory>
Options:
-p, --port Port to bind to.
-h, --host Hostname to use when generating links.
Other flags:
-h, --help Print this screen.
-v, --version Print phd version.
Examples:
phd ./path/to/site # Serve directory over port 7070.
phd -p 70 docs # Serve 'docs' directory on port 70
phd -h gopher.com # Serve current directory over port 7070
# using hostname "gopher.com"
binaries for linux, mac, and raspberry pi are available at https://github.com/dvkt/phd/releases:
just unzip/untar the phd program into your $PATH and get going!
cargo run -- ./path/to/gopher/site