The index repo for docs.tortal.tech.
- HTML 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .forgejo/workflows | ||
| site | ||
| README.md | ||
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
- In the project, build its site and publish it with the git-pages action,
site: https://docs.tortal.tech/<repository name>/andtoken: ${{ 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. - 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).