2022-10-17 03:01:04 +02:00
|
|
|
# man2ebook
|
|
|
|
|
|
2022-10-17 04:40:13 +02:00
|
|
|
A tool to convert all installed man pages to a simple ebook with contents in the head.
|
|
|
|
|
|
|
|
|
|
Maybe this could be only a small shell script but if not I will use Python.
|
|
|
|
|
|
|
|
|
|
## Why man pages as ebook?
|
|
|
|
|
|
2022-10-17 06:16:58 +02:00
|
|
|
Because I want to read them comfortable on my ebook reader when traveling but all man pages in one book.
|
|
|
|
|
Not more... ;)
|
2022-10-17 04:40:13 +02:00
|
|
|
|
|
|
|
|
## Helpful libraries and tools
|
|
|
|
|
|
2022-10-17 06:16:58 +02:00
|
|
|
- https://pandoc.org/ - Haskell - Then maybe make use of https://pypi.org/project/pandocfilters/,
|
2022-10-17 05:43:09 +02:00
|
|
|
https://pypi.org/project/pypandoc/ or https://pypi.org/project/pandoc/.
|
2022-10-17 04:40:13 +02:00
|
|
|
(very mature features for document conversion like direct manpage input and epub output,
|
2022-10-17 05:43:09 +02:00
|
|
|
but I don't know much about pandoc, so I need to discover this.)
|
2022-10-17 04:40:13 +02:00
|
|
|
- https://www.gnu.org/software/groff/
|
|
|
|
|
(man -Thtml df > df.html)
|
|
|
|
|
- https://linux.die.net/man/1/man2html
|
|
|
|
|
(is nice because it must not generate html, head and body)
|
|
|
|
|
- https://pypi.org/project/epubmaker/ - Python
|
|
|
|
|
(maybe nice but unmaintained)
|
|
|
|
|
- https://docutils.sourceforge.io/ - Python
|
|
|
|
|
(as I can see now it only converts from .rst files.)
|
|
|
|
|
- https://github.com/hanez/aov-html2epub - Bash
|
