Skip to content

RFC: Publish man pages as HTML pages

Hugo Barrera requested to merge WhyNotHugo/abuild:publish-man into master

Render man pages as HTML and publish them via GitLab Pages. This is mostly a proof of concept; if using GitLab Pages is undesirable, then the files can also be published elsewhere by just rsync'ing them. Looks like GitLab Pages is disabled, so maybe publishing can be done via some other simple mechanism (like just rsync into a server running nginx?). I can adapt this as needed.

I can also move the bulk of the script into Makefile is that sounds like a better approach.

The css stylesheet is the one from: https://darkman.whynothugo.nl/

Currently the content from the man pages is copy-pasted into the wiki. This should provide an online version of the man page to which wiki pages (and other material) can link instead.

Merge request reports