From 9a8041a274ffb09e94260e081cca3ef0cb8e456b Mon Sep 17 00:00:00 2001 From: Anirudh Oppiliappan Date: Mon, 19 Dec 2022 10:52:16 +0530 Subject: [PATCH] readme: more info --- readme | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 58 insertions(+), 1 deletion(-) diff --git a/readme b/readme index f6dc662..71775e1 100644 --- a/readme +++ b/readme @@ -6,8 +6,65 @@ A git web frontend written in Go. 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.