Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

man2ebook

This is a trivial script to generate an epub from a list of man pages. I wrote this as none of the alternatives did what I wanted, and I find reading man pages on my ebook reader on the go very practical.

Requirements

You need man2html and calibre installed, and of course the list of man pages you want to read, installed such that man can find them.

Note that on Debian/Ubuntu, the man2html-base package is enough, the man2html package brings in Apache as well for a CGI interface, which is not useful.

Usage

Simply run the generate script, passing the list of desired man pages, ideally in the form of name.section:

./generate.sh namespaces.7 credentials.7

The section is required when the name resolves to multiple sections.

The output will be left as index.epub. You can customise the metadata as needed, of course.

Notes

Backend

The current backend is man2html, more specifically the version as distributed in Debian—and this has lots of patches. I've tried to use mandoc as well, but it has worse quirks than man2html.

The advantage of man2html is that it can generate a tree of documents for which internal links (references) work correctly, which almost makes the result feel like a coherent document.

Alternatives

There are a couple of repositories that seem to do the same, but not quite:

  • https://github.com/younix/man2epub: doesn't seem to generate cross-links, only standalone pages in the document; also very specific to openbsd/its man syntax, I think;
  • https://github.com/nerab/manbook: while promising, it's untouched (except bumping of dependencies) in a long while, and actually misses the main functionality, of combining pages into a book;

On the "generate HTML from man pages" there are other tools, but even investigating them seemed more complex than just writing a simple shell script. So, that's the story.

Iustin Pop, iustin@k1024.org.

About

A trivial script to generate an epub from a list of man pages

Topics

Resources

License

Packages

No packages published