Last night, I published some man pages of my own software as HTML documents.
They are available here: https://hannesbraun.net/share/man/index.html
Maybe, the web versions are going to be useful for someone. I don’t know.
It’s actually a project that I started back in March this year. But I never
published something. If you are interested, the script I’m using to generate
them is also available: https://git.sr.ht/~hannes/webman
This repository is currently not listed publicly on my account. The scripts aren’t very flexible right now. But I might polish this up in the future, if it proves to be useful.
The script itself is making use of scd2html and pandoc. After running those tools, it just embeds their output into a basic HTML template and generates an index for all the man pages generated.
This project was originally inspired by the manual available on the website of “Plan 9 from User Space”: https://9fans.github.io/plan9port/man/
I think those previous blog posts (which were pretty short) belong into a microblog rather than in my main blog. And services like Twitter or twtxt are usually a bit restrictive through their length of 140 characters. That might be desirable in some cases. But for my use case, it’s mostly too short. So let’s try this thing here…