name mode size
hn-gopher 040000
packages 040000
resources 040000
.gitignore 100644 132B
LICENSE 100644 34.52kB
README.md 100644 3.68kB
TODO 100644 23B
Vagrantfile 100755 1.66kB
deploy.sh 100755 1.08kB
README.md
``` _ _ _ _ _ | | | | | | | \ | | hngopher.com:70 | |__| | __ _ ___| | _____ _ __ | \| | _____ _____ | __ |/ _` |/ __| |/ / _ \ '__| | . ` |/ _ \ \ /\ / / __| | | | | (_| | (__| < __/ | | |\ | __/\ V V /\__ \ |_| |_|\__,_|\___|_|\_\___|_| |_| \_|\___| \_/\_/ |___/ - The Underground Hacker News Mirror (updated hourly) _________________ |\ \ | \ \ _ _ |\ \________________\ (>\---/<) |\\ | ____ | ,' `. |.\ | |\ \ | / q p \ | | |.\ \___|____ ( >(_Y_)< ) \ | ||\\ \ \ >-' `-' `-<-. \ | || \\___\ \ / _.,, ,,,- \ \|_____|| || !\_______\ /, )` '( ) ______ || || ! . . . | ; `._.' `--< \000 \~\\ || ! . . | : \ | ) \000 9\ \\|| ! . | \ ) ;_/ \000 9\ \.| ! | `._ _/_ ___.'-''' \000 9\ \|__!________/ `--''' ^^^^^`` \/_____\ ``` --- <p align="center"> <b><a href="gopher://hngopher.com">gopher://hngopher.com</a></b><br> <i>(see below for "How to view this site")</i> </p> --- HN Gopher is a read-only mirror for https://news.ycombinator.com/ served using the [gopher protocol](https://en.wikipedia.org/wiki/Gopher_(protocol)). I created this site for my own enjoyment, and to learn about gopher and the history of the internet before the world wide web. ## How to view this site The gopher protocol hasn't been supported by major web browsers since the early 2000's. Thankfully, there are still a few ways to browse Gopherspace in the modern age: - Use **lynx** from the command line ```bash $ lynx gopher://hngopher.com ``` - Floodgap provides a proxy gateway that converts **gopher** sites to **HTTP** so they can be viewed in your browser: [http://gopher.floodgap.com/gopher/gw?a=gopher%3A%2F%2Fhngopher.com](http://gopher.floodgap.com/gopher/gw?a=gopher%3A%2F%2Fhngopher.com) ## How to deploy this project The official server runs on Debian 8.7, but it should work on any Linux system that's capable of building [gophernicus](https://github.com/prologic/gophernicus). There's a ``deploy.sh`` script included in the repo that can be used to install the server and associated scripts. The gophernicus service is managed by **systemd** and listens on port 70 by default. Gopher pages are stored as static files in the **/var/gopher** directory. Files are continuously updated by cron jobs that ping the [Hacker News API](https://hacker-news.firebaseio.com/v0/) and [Algolia HN Search API](https://hn.algolia.com/api/v1/). ```bash $ git clone https://github.com/michael-lazar/hn-gopher.git $ cd hn-gopher $ sudo ./deploy.sh ``` ## License AGPLv3 ## Disclaimer *This project is not affiliated with, maintained, authorized, endorsed or sponsored by the Y Combinator company.*