Arch Linux

axper

Member

Registered: 2013-01-25

Posts: 115

man2archwiki - View local manpages in browser with ArcWiki-style CSS

EDIT:
The original project is discontinued because I discovered mdocml, which partially does what I wanted to do, but much better. I created another project, man2archwiki which is a wrapper around mdocml - it displays the manpage your $BROWSER with ArchWiki's CSS.

Original post:
I don't like reading long documentation pages on the terminal. So I tried to make a tool to convert them to HTML.
Currently it supports most popular man and groff macros only, and will work for manpages which use the "safe" subset of groff language.

Here's a preview image with Archwiki's CSS.

Keep in mind it's very unstable and the code is horrible as I am just learning Python.

https://github.com/axper/hitman

If stars align perfectly I plan to make a Firefox plugin out of this project.

Thanks to jasonwryan for project name!

Last edited by axper (2014-06-29 14:42:56)

karol

Archivist

Registered: 2009-05-06

Posts: 25,440

Re: man2archwiki - View local manpages in browser with ArcWiki-style CSS

How does ti compare to https://aur.archlinux.org/packages/mdocml/ ?

axper

Member

Registered: 2013-01-25

Posts: 115

Re: man2archwiki - View local manpages in browser with ArcWiki-style CSS

That project is good, why I haven't heard about it earlier? Added it to the wiki: https://wiki.archlinux.org/index.php/Ma … dable_HTML

Mathuin

Member

Registered: 2014-04-11

Posts: 16

Re: man2archwiki - View local manpages in browser with ArcWiki-style CSS

This looks nice. I'm not a huge fan of the default CSS though. I quite like ronn's "toc" CSS; which looks like this: http://rtomayko.github.io/ronn/ronn.1.html. You can find the corresponding CSS here.

axper

Member

Registered: 2013-01-25

Posts: 115

Re: man2archwiki - View local manpages in browser with ArcWiki-style CSS

Ronn looks nice too. It's pages are fixed length and it's all monospace though.

BTW see https://github.com/axper/man2archwiki instead.

Rasi

Member

From: Germany

Registered: 2007-08-14

Posts: 1,914

Website

Re: man2archwiki - View local manpages in browser with ArcWiki-style CSS

you should edit the originals post title to reflect the name change

---

He hoped and prayed that there wasn't an afterlife. Then he realized there was a contradiction involved here and merely hoped that there wasn't an afterlife.

Douglas Adams

karol

Archivist

Registered: 2009-05-06

Posts: 25,440

Re: man2archwiki - View local manpages in browser with ArcWiki-style CSS

+1
I've just noticed https://github.com/axper/hitman/commit/ … a4153984a2

You might want to get back to the previous thread too.

axper

Member

Registered: 2013-01-25

Posts: 115

Re: man2archwiki - View local manpages in browser with ArcWiki-style CSS

Yeah, I updated the original post. The other thread links here anyway. Thanks!