Browse man pages in style with your personal manservant.
Fed up with browsing manual pages in a console using
less or Googling for
the man page only to realize that your local install differs from the man page
you found? Me too, so last night I hacked together manservant to serve up
local man pages over HTTP with some pretty UI sprinkled over it.
Here's tmux's man page served to you by manservant:
Manservant is a simple Sinatra application, and is run just like any other Rack application.
The simplest way to run manservant is through Pow. Ensure you have Pow installed and working, and run the following to install manservant:
git clone https://github.com/jimeh/manservant.git ~/.pow/man cd ~/.pow/man bundle install
Then visit http://man.dev/ in your browser.
There's many ways to run a Rack application, and I'm not gonna cover that
here. But if you merely want to get manservant up and running to have a look,
just clone the repo and run
rackup inside the project directory:
git clone https://github.com/jimeh/manservant.git ~/Projects/manservant cd ~/Projects/manservant rackup
Then visit http://localhost:9292/ in your browser.
- Man page to HTML conversion is done by man2html, which is bundled into manservant.
- The HTML UI style is shamelessly ripped from the ronn gem's HTML output format.
- Less shitty code.
- Caching of rendered man pages.
- Write some tests.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Added some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request
Copyright (c) 2012 Jim Myhrberg
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.