Markup: Support for groff files/manpages?

Created on 31 Mar 2015  路  6Comments  路  Source: github/markup

Would the introduction of troff/groff (man pages) rendering be accepted?

Currently, GitHub just displays groff files in source form, but with a tool like man2html or even just groff -mandoc -Thtml it could easily support displaying them in some basic HTML form.

Example groff file:
https://github.com/woodruffw/screenfetch-c/blob/master/man/screenfetch-c.1

Rendered with groff -mandoc -Thtml screenfetch-c.1:
https://gist.github.com/woodruffw/1cb8a95766f9fee4fbd4

And a picture of the output.

If this is the kind of thing that markup should support, I'd be happy to add it. If depending on an external utility like man2html or groff isn't acceptable, it should be possible to integrate the source of man2html (which is just a perl script) into this repo or translate it into ruby.

Most helpful comment

There is open pull request https://github.com/github/markup/pull/1196 for manpage support.

All 6 comments

I am interested in this as well. @woodruffw have you made any progress on implementing it?

I see #11 and #342 as related.

@hunterboerner Adding this would be pretty simple (just another rule for markup to check against`), but it seems like there's no interest from the maintainers/owners in adding new formats.

Any updates on this issue? I'd still love to see this support.

Unfortunately, we're unlikely to add any new format support in the future, as each format requires ongoing maintenance and security work from our end. We're still looking to properly sandbox blob rendering in the future, and if/when that happens it'd be a lot easier to add formats, but right now we just can't take on the extra work.

There is open pull request https://github.com/github/markup/pull/1196 for manpage support.

Was this page helpful?
0 / 5 - 0 ratings