PHAROS by Ben Collver <
[email protected]>
=============================================
* Description
* Requirements
* Configuration
* Installation
Description
===========
Pharos is a gopher front-end to the Internet Archive written in AWK.
It is named after the light-house island near Alexandria.
Requirements
============
* Runs under the Gophernicus gopher server.
<
gopher://gopher.gophernicus.org/>
* Written in AWK. Tested using busybox awk.
* Commands used:
* env, mktemp, rm, strings, xargs
* curl <
https://curl.se/>
* json2tsv <
gopher://codemadness.org/1/phlog/json2tsv/>
* webdump <
gopher://codemadness.org/1/phlog/webdump/>
Configuration
=============
To set configuration variables, edit config.m4
AWK_EXT allows use of non-standard features in gawk and mawk
CACHE_ENABLED caches content in sqlite to reduce API calls
Installation
============
Installation depends on m4. I use m4 to achieve a portable module
system in any major awk. Gawk has @include() but that isn't
portable. The make.sh script process the source code and generates
the CGI files based on the settings in config.m4.
$ sh clean.sh
$ sh make.sh
Copy cgi/* into the CGI directory.
Copy gopher/* into a gopher directory.
This separation between CGI and gophermaps is necessary because
dynamic gophermaps not binary-safe in gophernicus.