P2h4k NPM | npm.io

P2H4K - PDF to HTML converter for Kindle

CLI tool to convert scientific papers into Kindle readable HTML docs.

This project is pure beta.

Features

Adjusted pdf2htmlEX options and HTML/CSS optimizations for Converting Scientific Papers.
Some Math characters in HTML are captured as images to avoid characters being garbled.
Send the converted file to an endpoint at the end of the process (OPTIONAL).

This project focuses on the use of the Kindle Personal Document service. If you are interested in use for Kindle Direct Publishing, contact me.

Feature requests are also welcome.

Usage

p2h4k /path/to/your/pdf [--post <url>][-v, --version][-h, --help]

For More details about options, see --help

Install

This project depends on pdf2htmlEX and many npm projects.

Please setup node.js and pdf2htmlEX by yourself.

Windows

If your computer is based on Windows and pdf2htmlEX is installed on Windows subsystem for Linux 2, no modification is needed.

Run

npm install -g p2h4k

yarn global install p2h4k

Others

Notice This project is only tested on Windows.

If your PC has another setup, clone this project, then rewrite Converter Class init (in src/main.ts) with your pdf2htmlEX command.

// let c = new Converter("wsl pdf2htmlEX");
// processingFile = c.convert(wslPath(processingFile), wslPath(tempDir));

let c = new Converter("/path/to/your/pdf2htmlEX");
processingFile = c.convert(processingFile, tempDir);

then build with npm|yarn run build, then follow the instructions for Windows.

Known Difficulty

Text markup on Kindle does not work properly.

Some texts cannot be selected.
Texts sometimes wrap other texts (while all texts can be read).

Causes and solutions are still unknown.

Develop

P2H4K/src
│  convertpdf.ts        small debug script
│  main.ts              entry point
│  pdfUtils.ts          functions and classes to process HTML as strings or to call external APIs/tools.
│  playwright.js        provide web APIs to edit HTML
│  webScript.ts         scripts run in web (to be called by playwright.js)
│  webUtils.ts          classes for webScript.ts

Any help (or bug report) would be appreciated!