Skip to content

Protocol Servers ​

Hypernext serves content over multiple protocols simultaneously. Each protocol is configured in config.yml under the protocols section.

HTTP ​

The primary web interface serves HTML with Microformats2 classes (h-entry, h-card, h-feed). Routes:

  • / — Home page
  • /:collection/:slug — Document pages
  • /rss.xml — RSS feed
  • /sitemap.xml — XML sitemap
  • /health — Health check

Gemini ​

TLS-encrypted Gemini protocol. Requires certPath and keyPath in config. Serves Gemtext format.

Gopher ​

Classic Gopher protocol. Serves menu listings and text content.

Spartan ​

Lightweight Spartan protocol. Uses Gemtext format for responses.

NEX ​

Headerless raw protocol. Sends content directly without headers.

Text Protocol ​

Simple text protocol with 2-digit status codes (20 OK, 40 Not Found).

Finger ​

Serves author information from config.author fields.