all repos — legit @ 9a8041a274ffb09e94260e081cca3ef0cb8e456b

fork of git.icyphox.sh/legit

readme: more info
Anirudh Oppiliappan x@icyphox.sh
Mon, 19 Dec 2022 10:52:16 +0530
commit

9a8041a274ffb09e94260e081cca3ef0cb8e456b

parent

fc65017b75f46e02bb32f43dce61fcea8090f785

1 files changed, 58 insertions(+), 1 deletions(-)

jump to
M readmereadme

@@ -6,8 +6,65 @@

Pronounced however you like; I prefer channeling my beret-wearing Frenchman, and say "Oui, il est le git!" -But yeah it's pretty legit, on god no cap fr fr. +But yeah it's pretty legit, no cap on god fr fr. + + +FEATURES + +• Fully customizable templates and stylesheets. +• Cloning over http(s). +• Less archaic HTML. +• Not CGI. + INSTALLING Clone it, 'go build' it. + + +CONFIG + +Uses yaml for configuration. Looks for a 'config.yaml' in the current +directory by default; pass the '--config' flag to point it elsewhere. + +Example config.yaml: + + repo: + scanPath: /var/www/git + readme: + - readme + - README + - readme.md + - README.md + mainBranch: + - master + - main + dirs: + templates: ./templates + static: ./static + meta: + title: git good + description: i think it's a skill issue + server: + name: git.icyphox.sh + host: 127.0.0.1 + port: 5555 + +These options are fairly self-explanatory, but of note are: + +• repo.scanPath: where all your git repos live (or die). legit doesn't + traverse subdirs yet. +• repo.readme: readme files to look for. Markdown isn't rendered. +• repo.mainBranch: main branch names to look for. +• server.name: used for go-import meta tags and clone URLs. + + +NOTES + +• Run legit behind a TLS terminating proxy like relayd(8) or nginx. +• The default head.html template uses my CDN to fetch fonts -- you may + or may not want this. +• Support or cgit-like filters (for readmes etc.) is planned. +• Pushing over https, while supported, is disabled because auth is a + pain. Use ssh. +• "Private" repos only available over Tailscale is planned.