DenysMedvid/pdf2htmlEX
1
0
Fork 0
mirror of https://github.com/pdf2htmlEX/pdf2htmlEX.git synced 2024-12-22 13:00:08 +00:00
Code
784 Commits 6 Branches 31 Tags 137 MiB
HTML 66.7%
C++ 20.3%
Shell 4.9%
Python 2.5%
JavaScript 2.1%
Other 3.4%
2e91696b33
Go to file
Lu Wang 2e91696b33 improve manpage; show data-dir in -v
2013-01-29 22:52:32 +08:00
debian changelog 2013-01-29 22:31:34 +08:00
share outline is closed by default, and will be opened by pdf2htmlEX.js if not empty 2013-01-29 22:23:59 +08:00
src improve manpage; show data-dir in -v 2013-01-29 22:52:32 +08:00
test changelog 2013-01-26 14:23:28 +08:00
.gitignore added pdf2htmlEX-config.h to .gitignore 2013-01-25 13:25:06 +00:00
.travis.yml Travis CI: print version 2013-01-25 13:02:57 +00:00
AUTHORS credit authors 2013-01-29 17:40:09 +08:00
build_for_ppa.py debian 2013-01-28 01:51:30 +08:00
ChangeLog changelog 2013-01-29 22:31:34 +08:00
CMakeLists.txt process outline 2013-01-28 21:01:02 +08:00
LICENSE license of jquery 2012-09-12 18:53:19 +08:00
LICENSE_GPLv2 update License 2012-08-31 21:19:46 +08:00
LICENSE_GPLv3 update License 2012-08-31 21:19:46 +08:00
pdf2htmlEX.1.in improve manpage; show data-dir in -v 2013-01-29 22:52:32 +08:00
README.md readme 2013-01-28 21:59:06 +08:00
TODO fix css, don't increase specificity 2013-01-29 02:35:34 +08:00

README.md

pdf2htmlEX

Build Status

A beautiful demo is worth a thousand words:

Introduction

pdf2htmlEX renders PDF files in HTML, utilizing modern Web technologies, aims to provide an accuracy rendering, while keeping optimized for Web display.

It is optimized for modern web browsers. On Linux/Mac, the generated HTML pages could be as beautiful as PDF files.

This program is designed for scientific papers with complicate formulas and figures, therefore precise rendering is the #1 concern. But of course general PDF files are also supported.

Why HTML ?

HTML, together with CSS and Javascript, is much more open and flexible than PDF. Almost everything can be customized.

  • Embedding documents to web pages with consistent theme and behavior
  • Cross references to other documents are much easier and intuitive
  • More functions to the document with Javascript, e.g. access control, animation, statistics

Readers can also be benefitted

  • Read while downloading
  • Plugin-free

Features

  • Optional single HTML file output
  • Precise rendering
  • Text perserved - you can select & copy & paste
  • Proper styling
    • Font - extracted and reencoded
    • Color
    • Transformation
  • Links
  • Outline
  • [EXPERIMENTAL] Path drawing with CSS
    • Orthogonal lines
    • Rectangles
    • Linear gradients
  • Not fully supported (Rendered as images)
    • Type 3 fonts
    • Non-text object

Get started

Ubuntu

PPA, which is not so up-to-date.

ArchLinux

AUR Package, special thanks to Arthur Titeica arthur.titeica@gmail.com

Gentoo

Install through Overlay gentoo-zh, mrueg or sunrise, thanks to the packagers.

Mac

Homebrew Formula, special thanks to Jamie Ly me@jamie.ly

Macports (local repo), special thanks to Deepak Thukral iapain@iapa.in

Windows

The code may be built with Cygwin.

Or with MinGW with some modifications.

More info can be found on the pdf2htmlEX page in TeX Wiki (in Japanese), special thanks to Haruhiko Okumura

Build from source

Dependency

  • CMake, pkg-config
  • GNU Getopt
  • compilers support C++11, for example
  • GCC >= 4.4.6
  • I heard about successful build with Clang
  • poppler with xpdf header >= 0.20.0 (compile with --enable-xpdf-headers)
  • Install libpng (and headers) BEFORE you compile poppler if you want background images generated
  • Install poppler-data if your want CJK support
  • fontforge (with header files)
  • git version is recommended to avoid annoying compilation issues
  • [Optional] ttfautohint
  • run pdf2htmlEX with --external-hint-tool=ttfautohint to enable it

Compiling

git clone --depth 1 git://github.com/coolwanglu/pdf2htmlEX.git
cd pdf2htmlEX
cmake . && make && sudo make install

Usage

pdf2htmlEX /path/to/foobar.pdf

pdf2htmlEX --help

man pdf2htmlEX

FAQ

LICENSE

GPLv2 & GPLv3 Dual licensed

pdf2htmlEX is totally free, please credit pdf2htmlEX if you use it

Please consider sponsoring it if you use it for commercial purpose

Font extraction, conversion or redistribution may be illegal, please check your local laws

Donate Now

Acknowledge

pdf2htmlEX is made possible thanks to the following projects:

pdf2htmlEX is inspired by the following projects:

  • pdftops & pdftohtml from poppler
  • MuPDF
  • PDF.js
  • Crocodoc
  • Google Doc

Contact

  • Mailing list pdf2htmlex@googlegroups.com

    • Please read FAQ before sending emails. Or your message might be ignored.
    • Please use the latest master branch.

  • Lu Wang coolwanglu@gmail.com

    • Please use the mailing list above unless for personal enquiries.
    • Accepting messages in Chinese, English or Japanese.

Special Thanks