pdf2htmlEX/README.md

#![](http://coolwanglu.github.io/pdf2htmlEX/images/pdf2htmlEX-64x64.png)pdf2htmlEX 

<!--
[![Build Status](https://travis-ci.org/coolwanglu/pdf2htmlEX.png?branch=master)](https://travis-ci.org/coolwanglu/pdf2htmlEX)

-->
A beautiful demo is worth a thousand words:

- **Bible de Genève, 1564** (fonts and typography): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/geneve.html) / [PDF](https://github.com/raphink/geneve_1564/raw/master/geneve_1564.pdf)
- **Cheat Sheet** (math formulas): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/cheat.html) / [PDF](http://www.tug.org/texshowcase/cheat.pdf)
- **Scientific Paper** (text and figures): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/demo.html) / [PDF](http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.148.349&rep=rep1&type=pdf)
- **Full Circle Magazine** (read while downloading): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/issue65_en.html) / [PDF](http://dl.fullcirclemagazine.org/issue65_en.pdf)
- **Git Manual** (CJK support): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/chn.html) / [PDF](http://files.cnblogs.com/phphuaibei/git%E6%90%AD%E5%BB%BA.pdf)
- [Try your own files](https://github.com/coolwanglu/pdf2htmlEX/wiki/Try-Your-Own-Files)

[Browser requirements](https://github.com/coolwanglu/pdf2htmlEX/wiki/Browser-Requirements)
 
### Introduction

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

pdf2htmlEX is best for text-based PDF files, for example scientific papers with complicated formulas and figures.
Text, fonts and formats are natively preserved in HTML such that you can still search and copy.
The generated HTML file is static, with optional features powered by JavaScript.

[Learn more about who and why should use pdf2htmlEX](https://github.com/coolwanglu/pdf2htmlEX/wiki/Introduction)

### Features

* Precise and native text in HTML
* Flexible Output
* Moderate Size
* More PDF stuffs that you love: links, outlines & printing
* Experimental: SVG background output & Type 3 font conversion

[Learn more](https://github.com/coolwanglu/pdf2htmlEX/wiki/Feature-List)   
[Compare with others](https://github.com/coolwanglu/pdf2htmlEX/wiki/Comparison)

### Wiki Portals

 * [Wiki Home](https://github.com/coolwanglu/pdf2htmlEX/wiki)
 * [Download](https://github.com/coolwanglu/pdf2htmlEX/wiki/Download)
 * [Building](https://github.com/coolwanglu/pdf2htmlEX/wiki/Building)
 * [Quick Start](https://github.com/coolwanglu/pdf2htmlEX/wiki/QuickStart)
 * [How to contribute](https://github.com/coolwanglu/pdf2htmlEX/wiki/Contribute)
 * [How to report](https://github.com/coolwanglu/pdf2htmlEX/wiki/How-to-report)
 * [FAQ](https://github.com/coolwanglu/pdf2htmlEX/wiki/FAQ)

### Contact

 * Latest news about pdf2htmlEX can be found on [@pdf2htmlEX](https://twitter.com/pdf2htmlEX) or [the blog](http://pdf2htmlex.blogspot.com) 
 * For questions and help please post to <pdf2htmlex@googlegroups.com>, and you can subscribe to the mailing list [here](https://groups.google.com/forum/#!forum/pdf2htmlex). **DO NOT create issues on the tracker**
 * Bug reports and feature requests should go to the [issue tracker](https://github.com/coolwanglu/pdf2htmlEX/issues?milestone=2&sort=updated&state=open). **DO NOT post to the mailing list**
 * You can help this project by [making a donation](http://coolwanglu.github.io/pdf2htmlEX/donate.html). Thanks!
 * The author can be reached by 王璐 (Lu Wang) <coolwanglu@gmail.com> or [@coolwanglu](https://twitter.com/coolwanglu). 
  - Messages in **中文**, **English** or **日本語** are accepted.
  - Messages are checked on a regular basis so please expect some delay.

### LICENSE

Most parts are licensed under GPLv3 with additional terms (see below).
Others are respectively licensed under MIT License and Creative Commons Attribution 3.0

Read `LICENSE` for more detail.

#### For Online Services

You are free and welcome to modify pdf2htmlEX for your online services, 
but you should credit pdf2htmlEX if your service involves "online conversion" facilitated by pdf2htmlEX.
You are also encouraged to send me a name and a URL for the purpose of statistics.

Read `LICENSE` for more detail.

### Acknowledgements

pdf2htmlEX is made possible thanks to the following projects:

* [poppler](http://poppler.freedesktop.org/)
* [Fontforge](http://fontforge.org/)
* [jQuery](http://jquery.com/)

pdf2htmlEX is inspired by the following projects:

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

#### Special Thanks

* Hongliang Tian
* Wanmin Liu
Update README.md 2013-09-27 05:59:03 +00:00			`#![](http://coolwanglu.github.io/pdf2htmlEX/images/pdf2htmlEX-64x64.png)pdf2htmlEX`
Travis CI status image in README 2013-01-25 13:11:27 +00:00
add license for logo/ 2013-10-09 11:15:17 +00:00			`<!--`
Update README.md 2013-01-25 18:10:07 +00:00			`[![Build Status](https://travis-ci.org/coolwanglu/pdf2htmlEX.png?branch=master)](https://travis-ci.org/coolwanglu/pdf2htmlEX)`
READMe 2012-09-26 14:44:50 +00:00
add license for logo/ 2013-10-09 11:15:17 +00:00			`-->`
update README 2012-09-07 17:50:18 +00:00			`A beautiful demo is worth a thousand words:`
update README 2012-08-04 18:25:47 +00:00
update title for demo 2013-09-10 12:33:50 +00:00			`- Bible de Genève, 1564 (fonts and typography): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/geneve.html) / [PDF](https://github.com/raphink/geneve_1564/raw/master/geneve_1564.pdf)`
update demo description 2013-05-04 15:39:08 +00:00			`- Cheat Sheet (math formulas): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/cheat.html) / [PDF](http://www.tug.org/texshowcase/cheat.pdf)`
			`- Scientific Paper (text and figures): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/demo.html) / [PDF](http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.148.349&rep=rep1&type=pdf)`
			`- Full Circle Magazine (read while downloading): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/issue65_en.html) / [PDF](http://dl.fullcirclemagazine.org/issue65_en.pdf)`
			`- Git Manual (CJK support): [HTML](http://coolwanglu.github.com/pdf2htmlEX/demo/chn.html) / [PDF](http://files.cnblogs.com/phphuaibei/git%E6%90%AD%E5%BB%BA.pdf)`
Update README.md 2013-10-05 09:08:14 +00:00			`- [Try your own files](https://github.com/coolwanglu/pdf2htmlEX/wiki/Try-Your-Own-Files)`
.. 2013-03-19 11:00:40 +00:00
			`[Browser requirements](https://github.com/coolwanglu/pdf2htmlEX/wiki/Browser-Requirements)`
Update README.md 2013-03-12 13:18:44 +00:00
Update README.md 2013-05-10 14:25:05 +00:00			`### Introduction`
update README 2012-08-28 09:54:27 +00:00
Update README.md 2013-01-31 11:25:53 +00:00			`pdf2htmlEX renders PDF files in HTML, utilizing modern Web technologies.`
.. 2013-07-05 21:59:45 +00:00			`It aims to provide an accurate rendering, while keeping optimized for Web display.`
initial import 2012-08-04 18:03:53 +00:00
Update README.md 2013-01-31 11:25:53 +00:00			`pdf2htmlEX is best for text-based PDF files, for example scientific papers with complicated formulas and figures.`
.. 2013-07-05 21:59:45 +00:00			`Text, fonts and formats are natively preserved in HTML such that you can still search and copy.`
			`The generated HTML file is static, with optional features powered by JavaScript.`
update README 2012-08-28 09:54:27 +00:00
.. 2013-05-04 17:58:27 +00:00			`[Learn more about who and why should use pdf2htmlEX](https://github.com/coolwanglu/pdf2htmlEX/wiki/Introduction)`
Update README.md 2012-12-12 08:54:48 +00:00
Update README.md 2013-05-10 14:25:05 +00:00			`### Features`
initial import 2012-08-04 18:03:53 +00:00
.. 2013-05-04 17:52:53 +00:00			`* Precise and native text in HTML`
readme 2013-05-04 13:33:55 +00:00			`* Flexible Output`
			`* Moderate Size`
			`* More PDF stuffs that you love: links, outlines & printing`
readme 2013-09-21 05:58:00 +00:00			`* Experimental: SVG background output & Type 3 font conversion`
Update README.md 2013-02-01 08:16:01 +00:00
.. 2013-05-04 17:52:53 +00:00			`[Learn more](https://github.com/coolwanglu/pdf2htmlEX/wiki/Feature-List)`
Update README.md 2013-02-02 06:43:40 +00:00			`[Compare with others](https://github.com/coolwanglu/pdf2htmlEX/wiki/Comparison)`
initial import 2012-08-04 18:03:53 +00:00
Update README.md 2013-05-10 14:25:05 +00:00			`### Wiki Portals`
tweaking font-size-multiplier and auto-hint 2012-09-21 10:12:14 +00:00
Update README.md 2013-05-10 14:12:56 +00:00			`* [Wiki Home](https://github.com/coolwanglu/pdf2htmlEX/wiki)`
			`* [Download](https://github.com/coolwanglu/pdf2htmlEX/wiki/Download)`
			`* [Building](https://github.com/coolwanglu/pdf2htmlEX/wiki/Building)`
			`* [Quick Start](https://github.com/coolwanglu/pdf2htmlEX/wiki/QuickStart)`
Update README.md 2013-05-10 14:22:47 +00:00			`* [How to contribute](https://github.com/coolwanglu/pdf2htmlEX/wiki/Contribute)`
update README 2013-09-08 06:55:39 +00:00			`* [How to report](https://github.com/coolwanglu/pdf2htmlEX/wiki/How-to-report)`
Update README.md 2013-05-10 14:12:56 +00:00			`* [FAQ](https://github.com/coolwanglu/pdf2htmlEX/wiki/FAQ)`
tweaking font-size-multiplier and auto-hint 2012-09-21 10:12:14 +00:00
Update README.md 2013-10-10 07:11:58 +00:00			`### Contact`

Update README.md 2013-10-10 07:14:58 +00:00			`* Latest news about pdf2htmlEX can be found on [@pdf2htmlEX](https://twitter.com/pdf2htmlEX) or [the blog](http://pdf2htmlex.blogspot.com)`
			`* For questions and help please post to <pdf2htmlex@googlegroups.com>, and you can subscribe to the mailing list [here](https://groups.google.com/forum/#!forum/pdf2htmlex). DO NOT create issues on the tracker`
Update README.md 2013-10-10 07:11:58 +00:00			`* Bug reports and feature requests should go to the [issue tracker](https://github.com/coolwanglu/pdf2htmlEX/issues?milestone=2&sort=updated&state=open). DO NOT post to the mailing list`
Update README.md 2013-10-10 07:16:57 +00:00			`* You can help this project by [making a donation](http://coolwanglu.github.io/pdf2htmlEX/donate.html). Thanks!`
Update README.md 2013-10-10 07:14:58 +00:00			`* The author can be reached by 王璐 (Lu Wang) <coolwanglu@gmail.com> or [@coolwanglu](https://twitter.com/coolwanglu).`
			`- Messages in 中文, English or 日本語 are accepted.`
			`- Messages are checked on a regular basis so please expect some delay.`
Update README.md 2013-10-10 07:11:58 +00:00
Update README.md 2013-05-10 14:25:05 +00:00			`### LICENSE`
initial import 2012-08-04 18:03:53 +00:00
add license for logo/ 2013-10-09 11:15:17 +00:00			`Most parts are licensed under GPLv3 with additional terms (see below).`
			`Others are respectively licensed under MIT License and Creative Commons Attribution 3.0`
Update README.md 2013-10-10 07:18:10 +00:00
tentative license update 2013-05-09 14:59:29 +00:00			Read `LICENSE` for more detail.
initial import 2012-08-04 18:03:53 +00:00
Update README.md 2013-05-10 14:25:05 +00:00			`#### For Online Services`
README.md 2012-09-07 10:23:38 +00:00
tentative license update 2013-05-09 14:59:29 +00:00			`You are free and welcome to modify pdf2htmlEX for your online services,`
.. 2013-05-10 08:46:11 +00:00			`but you should credit pdf2htmlEX if your service involves "online conversion" facilitated by pdf2htmlEX.`
tentative license update 2013-05-09 14:59:29 +00:00			`You are also encouraged to send me a name and a URL for the purpose of statistics.`
README.md 2012-09-07 10:23:38 +00:00
tentative license update 2013-05-09 14:59:29 +00:00			Read `LICENSE` for more detail.
twitter link 2013-05-05 09:24:48 +00:00
Update README.md 2013-05-10 14:38:59 +00:00			`### Acknowledgements`
update README 2012-08-28 09:54:27 +00:00
.. 2012-09-21 13:38:23 +00:00			`pdf2htmlEX is made possible thanks to the following projects:`
.. 2012-09-21 13:35:27 +00:00
.. 2012-09-21 13:38:23 +00:00			`* [poppler](http://poppler.freedesktop.org/)`
			`* [Fontforge](http://fontforge.org/)`
add jquery 2012-09-22 06:41:29 +00:00			`* [jQuery](http://jquery.com/)`
.. 2012-09-21 13:35:27 +00:00
README 2012-09-18 16:45:20 +00:00			`pdf2htmlEX is inspired by the following projects:`
initial import 2012-08-04 18:03:53 +00:00
			`* 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`

Update README.md 2013-05-10 14:25:05 +00:00			`#### Special Thanks`
update README 2012-08-28 09:54:27 +00:00
.. 2013-02-05 14:53:14 +00:00			`* Hongliang Tian`
			`* Wanmin Liu`
initial import 2012-08-04 18:03:53 +00:00