Website: a Gemini capsule mirror of the docs #57

New Issue

2026-10-06T15:35:04Z

twisla commented

2026-10-06 15:35:04 +00:00

Idea

The project's docs served over Gemini as well as over HTTP, readable in the device's own Gemini App (#12, Q186).

Why

It suits the project: the device has a Gemini client, and a firmware's documentation read on the device itself is a good demonstration of it.

What's known

The docs are Markdown in the repository (docs/, README, CONTEXT.md). Gemtext can be generated from the same source, so there is nothing to keep in step by hand.
A capsule needs a Gemini server (Agate, molly-brown, ...) and a certificate. The server that hosts roro9stack.net is the natural place.
Tables, images and inline code don't exist in gemtext: the conversion has to say what it does with them.

Questions

Which server, and is it worth running one more service for this?
Generated at the same moment as the site (zola build), or by a script of its own?
A capsule for the whole site, or only for the user guide?

## Idea The project's docs served over Gemini as well as over HTTP, readable in the device's own Gemini App (#12, Q186). ## Why It suits the project: the device has a Gemini client, and a firmware's documentation read on the device itself is a good demonstration of it. ## What's known - The docs are Markdown in the repository (`docs/`, README, CONTEXT.md). Gemtext can be generated from the same source, so there is nothing to keep in step by hand. - A capsule needs a Gemini server (Agate, molly-brown, ...) and a certificate. The server that hosts roro9stack.net is the natural place. - Tables, images and inline code don't exist in gemtext: the conversion has to say what it does with them. ## Questions 1. Which server, and is it worth running one more service for this? 2. Generated at the same moment as the site (`zola build`), or by a script of its own? 3. A capsule for the whole site, or only for the user guide? ## Related #12, `docs/milestones/W1.md`, the Gemini App (`docs/milestones/G1.md`).

twisla added this to the W1 Website milestone 2026-10-06 15:35:04 +00:00

twisla added the

area/website labels 2026-10-06 15:35:04 +00:00

Sign in to join this conversation.