7
GitHub - icyphox/legit: web frontend for git, written in go
source link: https://github.com/icyphox/legit
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
legit ----- 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, 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. • Cloning only works in bare repos -- this is a limitation inherent to git. You can still view bare repos just fine in legit. • 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. LICENSE legit is licensed under MIT.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK