vole
Clone
Read only, no credentials:
https://rodent.software/git/vole.git
Write over SSH with a registered key:
git clone ssh://git@0.0.0.0:2222/vole.git
A free and open-source forge that lives in your Git repo.
Name the instance in the tab and the brand link
3d707ea78961adff55cb7b3cb8a61c5697e726a4 · Keenan Nemetz · 19h ago · parent 2c988ecd
Name the instance in the tab and the brand link instance_name reached the home heading only, so a renamed instance still put "Vole" in the one place a reader always looks and in the brand link's accessible name. Put the name on the shared page data and read it in the chrome. An instance that never set one still says Vole, and the separator never renders on its own. Prose about the software, such as the status page's restart instruction, keeps the product name: it names the program, not the organisation's forge.
docs/configuration.md +7−2
| @@ -56,7 +56,7 @@ vole admin account list | |||
| 56 | 56 | | `ssh_max_connections` | `64` | Simultaneous connections on that listener; past it a connection is closed before the handshake rather than queued | | |
| 57 | 57 | | `ssh_max_git_processes` | `16` | Git processes across every SSH connection; past it a command waits a short while, then is told to retry | | |
| 58 | 58 | | `ssh_handshake_timeout_seconds` | `20` | How long a connection may take to finish the SSH handshake before it is dropped | | |
| 59 | | `instance_name` | `"Vole"` | Heading on the home page | | ||
| 59 | | `instance_name` | `"Vole"` | What the instance calls itself: the home page heading, every page's document title, and the brand link's accessible name | | ||
| 60 | 60 | | `instance_repo` | `"vole-instance"` | Repository whose tree customizes the instance; empty disables it | | |
| 61 | 61 | | `public_url` | empty | Canonical browser address; must be HTTPS to enable passkey sign-in | | |
| 62 | 62 | | `acme_email` | empty | Contact address given to the certificate authority | | |
| @@ -172,7 +172,12 @@ card's body. The heading is `instance_name`, which is what the forge calls itsel | |||
| 172 | 172 | instance_name = "Acme Forge" | |
| 173 | 173 | ``` | |
| 174 | 174 | ||
| 175 | None of this changes the `vole` wordmark in the top bar. | ||
| 175 | The name is also the document title on every page (`Issues · Acme Forge`) and | ||
| 176 | the accessible name of the brand link ("Acme Forge home"), so a renamed instance | ||
| 177 | is renamed in the tab as well as in the heading. The brand mark in the top bar | ||
| 178 | stays Vole's emblem, and prose about the software itself, such as the status | ||
| 179 | page's "restart Vole", keeps the product name: the instance name describes the | ||
| 180 | organisation's forge, not the program serving it. | ||
| 176 | 181 | ||
| 177 | 182 | ### Theming | |
| 178 | 183 | ||