pdf2htmlEX/README.md

pdf2html**EX**
=============================


[**View Demo**](http://coolwanglu.github.com/pdf2htmlEX/demo/demo.html)

[**Another Demo (CJK)**](http://coolwanglu.github.com/pdf2htmlEX/demo/chn.html)

**WINDOWS XP USERS: Please make sure ClearType is turned on** 

(Control Panel -> Display -> Appearance -> Effects -> "Use the following method to smooth edges of screen fonts" -> ClearType)

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 recent versions of modern web browsers such as Mozilla Firefox & Google Chrome.

This program is designed for scientific papers with complicate formulas and figures, so a precise rendering is also the #1 concern.

Features
----------------------------
* Single HTML file output 
* Precise rendering 
* Text Selection
* Font embedding 
* Proper styling (Color, Transformation...)
* Optimization for Web 

Not supported yet
----------------------------
* Several Font types & encodings
* Non-text object (Don't worry, they will be rendered as images)
* Blend Mode
* ...

Dependency
----------------------------
* Recent version of GCC (no guarantee on other compilers)
* libpoppler with xpdf header >= 0.20.2
* boost c++ library (format, program options, gil, filesystem, serialization, system(which is actually required by filesystem))
* fontforge **Please use [the lastest version](https://github.com/fontforge/fontforge)**

HOW TO COMPILE
----------------------------
    cmake . && make && sudo make install

HOW TO USE
----------------------------
    pdf2htmlEX /path/to/sample.pdf

LICENSE
----------------------------
GPLv3


We would like to acknowledge the following projects that have been consulted while writing this program:
* pdftops & pdftohtml from poppler 
* MuPDF
* PDF.js
* Crocodoc
* Google Doc

AUTHORS
----------------------------
* Lu Wang <coolwanglu@gmail.com>
* Hongliang Tian <tatetian@gmail.com>
initial import 2012-08-04 18:03:53 +00:00			`pdf2htmlEX`
			`=============================`

update README 2012-08-04 18:25:47 +00:00
			`[View Demo](http://coolwanglu.github.com/pdf2htmlEX/demo/demo.html)`
update REAMD 2012-08-18 08:05:36 +00:00
update README 2012-08-18 07:55:21 +00:00			`[Another Demo (CJK)](http://coolwanglu.github.com/pdf2htmlEX/demo/chn.html)`
add demo link in README 2012-08-04 18:22:50 +00:00
update README 2012-08-18 07:46:07 +00:00			`WINDOWS XP USERS: Please make sure ClearType is turned on`

update README 2012-08-17 13:45:16 +00:00			`(Control Panel -> Display -> Appearance -> Effects -> "Use the following method to smooth edges of screen fonts" -> ClearType)`

initial import 2012-08-04 18:03:53 +00:00			`Introduction`
			`-----------------------------`
update README 2012-08-07 12:16:05 +00:00			`pdf2htmlEX renders PDF files in HTML, utilizing modern Web technologies, aims to provide an accuracy rendering, while keeping optimized for Web display.`
initial import 2012-08-04 18:03:53 +00:00
update README 2012-08-07 12:16:05 +00:00			`It is optimized for recent versions of modern web browsers such as Mozilla Firefox & Google Chrome.`

			`This program is designed for scientific papers with complicate formulas and figures, so a precise rendering is also the #1 concern.`
initial import 2012-08-04 18:03:53 +00:00
			`Features`
			`----------------------------`
working on single HTML 2012-08-14 18:54:39 +00:00			`* Single HTML file output`
update README 2012-08-07 12:16:05 +00:00			`* Precise rendering`
working 2012-08-05 15:54:15 +00:00			`* Text Selection`
update README 2012-08-09 17:20:47 +00:00			`* Font embedding`
update readme 2012-08-06 17:22:25 +00:00			`* Proper styling (Color, Transformation...)`
initial import 2012-08-04 18:03:53 +00:00			`* Optimization for Web`

			`Not supported yet`
			`----------------------------`
update README 2012-08-12 11:01:13 +00:00			`* Several Font types & encodings`
update readme 2012-08-06 06:32:12 +00:00			`* Non-text object (Don't worry, they will be rendered as images)`
update readme 2012-08-06 17:22:25 +00:00			`* Blend Mode`
			`* ...`
initial import 2012-08-04 18:03:53 +00:00
			`Dependency`
			`----------------------------`
clean code, solve the infinite-writing problem when tmp_dir == dest_dir 2012-08-15 07:29:35 +00:00			`* Recent version of GCC (no guarantee on other compilers)`
initial import 2012-08-04 18:03:53 +00:00			`* libpoppler with xpdf header >= 0.20.2`
.. 2012-08-15 03:15:33 +00:00			`* boost c++ library (format, program options, gil, filesystem, serialization, system(which is actually required by filesystem))`
update README 2012-08-13 05:28:05 +00:00			`* fontforge Please use [the lastest version](https://github.com/fontforge/fontforge)`
initial import 2012-08-04 18:03:53 +00:00
			`HOW TO COMPILE`
			`----------------------------`
background image embedding works now 2012-08-14 18:28:19 +00:00			`cmake . && make && sudo make install`
initial import 2012-08-04 18:03:53 +00:00
			`HOW TO USE`
			`----------------------------`
background image embedding works now 2012-08-14 18:28:19 +00:00			`pdf2htmlEX /path/to/sample.pdf`
initial import 2012-08-04 18:03:53 +00:00
			`LICENSE`
			`----------------------------`
			`GPLv3`


			`We would like to acknowledge the following projects that have been consulted while writing this program:`
			`* pdftops & pdftohtml from poppler`
support cid fonts 2012-08-11 11:55:06 +00:00			`* MuPDF`
initial import 2012-08-04 18:03:53 +00:00			`* PDF.js`
			`* Crocodoc`
			`* Google Doc`

			`AUTHORS`
			`----------------------------`
update README 2012-08-04 18:27:18 +00:00			`* Lu Wang <coolwanglu@gmail.com>`
			`* Hongliang Tian <tatetian@gmail.com>`
initial import 2012-08-04 18:03:53 +00:00