The index repo for docs.tortal.tech.
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Ethan Hann 5032916da9
All checks were successful
Publish / publish (push) Successful in 8s
Match tortal.tech's style and clean up copy
2026-10-25 17:46:04 -05:00
.forgejo/workflows Publish the documentation host's front page 2026-10-25 15:27:12 -05:00
site Match tortal.tech's style and clean up copy 2026-10-25 17:46:04 -05:00
README.md Publish the documentation host's front page 2026-10-25 15:27:12 -05:00

docs-index

The front page of docs.tortal.tech, the documentation host for projects on git.tortal.tech.

Each project publishes its own site to docs.tortal.tech/<repository name>/ from its own workflow; this repository owns only the front page in site/. A push to main publishes it (.forgejo/workflows/publish.yml).

Adding a project

  1. In the project, build its site and publish it with the git-pages action, site: https://docs.tortal.tech/<repository name>/ and token: ${{ forgejo.token }}. The path must match the repository's name exactly, since the server checks that the token may push to the repository of that name.
  2. Add a card for it to site/index.html.

The server

git-pages runs on the home server behind Nginx Proxy Manager. Its config maps the host as a wildcard, so no secret or DNS record is needed per project:

[[wildcard]]
domain = "tortal.tech"
clone-url = "https://git.tortal.tech/ethan-hann/<project>.git"
index-repo = "docs-index"
index-repo-branch = "main"
authorization = "forgejo"

SavePoint's developer guide has the full setup (compose file, proxy and DNS).