A while ago, I took down my git forge and replaced it with pgit. It more or less does what I want, but I have a few gripes:
- It doesn’t render the README into HTML
- It doesn’t allow people to view images I’ve committed
- I don’t care for monospace fonts
After my daughter messaged me asking for a wiring diagram that pgit wasn’t making available, I started looking for a replacement.
The Cast
- pgit
- What I’m using now. It checks most of my boxes, but I need a few more things.
- stagit
- Same complaints as pgit, plus it’s even more obtuse to non-hackers.
- GitGen
- Fixes the README issue, but requires images to be hosted elsewhere. Also doesn’t let you read any of the files in the browser.
- gitmal
- Fixes README and image hosting, but doesn’t provide any link to clone the repo. No option to limit commit history (not good for big repos)
- itsy-gitsy
- Hides the README behind a confusing entry page, no option to limit commit history.
- git-arr
- README is buried, otherwise I like it.
- git2html
- Not designed for general public use.
- stagen
- I like that it uses templates, maybe I’ll fork it.
I’m kind of disappointed by everything, sigh.
What I Want
After reviewing all these,
I think I understand what I want.
I want something that checks out HEAD on the main branch,
and creates an index.html with README.md converted to HTML,
and then a directory tree.
I want all .md files to be written as .md.html files as well,
and I want links to .md files to link to the .md.html files.
That’s it.