-
Notifications
You must be signed in to change notification settings - Fork 7
/
index.html
122 lines (103 loc) · 5.64 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="chrome=1">
<title>dompdf by dompdf</title>
<link rel="stylesheet" href="stylesheets/styles.css">
<link rel="stylesheet" href="stylesheets/pygment_trac.css">
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
<!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
</head>
<body>
<div class="wrapper">
<header>
<h1>dompdf</h1>
<p>dompdf project</p>
<p class="view"><a href="https://github.com/dompdf">View My GitHub Profile</a></p>
</header>
<section>
<p><strong>dompdf is an HTML to PDF converter</strong>.
At its heart, dompdf is (mostly) a <a href="http://www.w3.org/TR/CSS2/" rel="nofollow">CSS 2.1</a>
compliant
HTML layout and rendering engine written in PHP. It is a style-driven renderer:
it will download and read external stylesheets, inline style tags, and the style
attributes of individual HTML elements. It also supports most presentational
HTML attributes.</p>
</p>
<p>PDF rendering is currently provided either by <a href="http://www.pdflib.com/">PDFLib</a> or by a bundled
version the R&OS CPDF class written by Wayne Munro. (Some important changes have been made to the
R&OS class, however). In order to use PDFLib with dompdf, the <a
href="http://pecl.php.net/package/pdflib">PDFLib PECL extension</a> is required. Using PDFLib
improves performance and reduces the memory requirements of dompdf somewhat, while the R&OS CPDF
class, though slightly slower, eliminates any dependencies on external PDF libraries.</p>
<p><a href="http://www.twitter.com/dompdf"><img src="http://twitter-badges.s3.amazonaws.com/twitter-a.png"
alt="Follow us on Twitter"></a>
<a href="https://plus.google.com/108710008521858993320?prsrc=3"><img
src="https://ssl.gstatic.com/images/icons/gplus-32.png" alt="Follow us on Google+"></a></p>
<h1>Features</h1>
<ul>
<li>Handles most CSS 2.1 and a few CSS3 properties, including @import, @media &
@page rules</li>
<li>Supports most presentational HTML 4.0 attributes</li>
<li>Supports external stylesheets, either local or through http/ftp (via
fopen-wrappers)</li>
<li>Supports complex tables, including row & column spans, separate & collapsed
border models, individual cell styling</li>
<li>Image support (gif, png (8, 24 and 32 bit with alpha channel), bmp & jpeg)</li>
<li>No dependencies on external PDF libraries, thanks to the R&OS PDF class</li>
<li>Inline PHP support</li>
<li>Basic SVG support</li>
</ul>
<h1>Requirements</h1>
<ul>
<li>PHP version 7.1 or higher</li>
<li>DOM extension</li>
<li>MBString extension</li>
<li>php-font-lib</li>
<li>php-svg-lib</li>
</ul>
<p>Note that some required dependencies may have further dependencies (notably php-svg-lib requires
sabberworm/php-css-parser).</p>
<h3>Recommendations</h3>
<ul>
<li>OPcache (OPcache, XCache, APC, etc.): improves performance</li>
<li>GD (for image processing)</li>
<li>IMagick or GMagick extension: improves image processing performance</li>
</ul>
<p>Visit the wiki for more information:
<a
href="https://github.com/dompdf/dompdf/wiki/Requirements">https://github.com/dompdf/dompdf/wiki/Requirements</a>
</p>
<h1>Limitations (Known Issues)</h1>
<ul>
<li>Dompdf is not particularly tolerant to poorly-formed HTML input. To avoid
any unexpected rendering issues you should either enable the built-in HTML5
parser at runtime (<code>$dompdf->set_option('isHtml5ParserEnabled', true);</code>)
or run your HTML through a HTML validator/cleaner (such as
<a href="http://tidy.sourceforge.net" rel="nofollow">Tidy</a> or the
<a href="http://validator.w3.org" rel="nofollow">W3C Markup Validation Service</a>).</li>
<li>Table cells are not pageable, meaning a table row must fit on a single page.</li>
<li>Elements are rendered on the active page when they are parsed.</li>
</ul>
</section>
<footer>
<p><small>Hosted on GitHub Pages — Theme by <a
href="https://github.com/orderedlist">orderedlist</a></small></p>
</footer>
</div>
<script src="javascripts/scale.fix.js"></script>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-7721386-5");
pageTracker._trackPageview();
} catch (err) { }
</script>
</body>
</html>