1
0
mirror of https://github.com/pdf2htmlEX/pdf2htmlEX.git synced 2024-07-02 16:25:41 +00:00
pdf2htmlEX/README.md
2013-10-16 18:21:31 +08:00

94 lines
4.5 KiB
Markdown

#![](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
pdf2htmlEX, as a whole package, is licensed under GPLv3 with additional terms (see below).
Some resource files are released with relaxed licenses, read `LICENSE` for more details.
#### 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