pdf2htmlEX

发表于 | 分类于

###install

  • brew install fontforge --HEAD
  • brew tap homebrew/versions
  • brew install pdf2htmlex
  • brew install -v pdf2htmlex --HEAD

###Usage

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
用法: pdf2htmlEX [options] <input.pdf> [<output.html>]
0 关闭； 1 开启
  -f,--first-page <int>         需要转换的起始页 (默认: 1)
  -l,--last-page <int>          需要转换的最后一页 (默认: 2147483647)
  --zoom <fp>                   缩放比例
  --fit-width <fp>              适合宽度 <fp> 像素
  --fit-height <fp>             适合高度 <fp> 像素
  --use-cropbox <int>           使用剪切框 (default: 1)
  --hdpi <fp>                   图像水平分辨率 (default: 144)
  --vdpi <fp>                   图像垂直分辨率 (default: 144)
  --embed <string>              指定哪些元素应该被嵌入到输出
  --embed-css <int>             将CSS文件嵌入到输出中 (default: 1)
  --embed-font <int>            将字体文件嵌入到输出中 (default: 1)
  --embed-image <int>           将图片文件嵌入到输出中 (default: 1)
  --embed-javascript <int>      将javascript文件嵌入到输出中 (default: 1)
  --embed-outline <int>         将链接嵌入到输出中 (default: 1)
  --split-pages <int>           将页面分割为单独的文件 (default: 0)
  --dest-dir <string>           指定目标目录 (default: ".")
  --css-filename <string>       生成的css文件的文件名 (default: "")
  --page-filename <string>      分割的网页名称  (default:"")
  --outline-filename <string>   生成的链接文件名称 (default:"")
  --process-nontext <int>       渲染图行，文字除外 (default: 1)
  --process-outline <int>       在html中显示链接 (default: 1)
  --printing <int>              支持打印 (default: 1)
  --fallback <int>              在备用模式下输出 (default: 0)
  --embed-external-font <int>   嵌入局部匹配的外部字体 (default: 1)
  --font-format <string>        嵌入的字体文件后缀 (ttf,otf,woff,svg) (default: "woff")
  --decompose-ligature <int>    分解连字-> fi (default:0)
  --auto-hint <int>             使用fontforge的autohint上的字体时不提示 (default: 0)
  --external-hint-tool <string> 字体外部提示工具 (overrides --auto-hint) (default: "")
  --stretch-narrow-glyph <int>  伸展狭窄的字形，而不是填充 (default: 0)
  --squeeze-wide-glyph <int>    收缩较宽的字形，而不是截断 (default: 1)
  --override-fstype <int>       clear the fstype bits in TTF/OTF fonts (default:0)
  --process-type3 <int>         convert Type 3 fonts for web (experimental) (default: 0)
  --heps <fp>                   合并文本的水平临界值，单位：像素(default: 1)
  --veps <fp>                   vertical threshold for merging text, in pixels (default: 1)
  --space-threshold <fp>        断字临界值 (临界值 * em) (default:0.125)
  --font-size-multiplier <fp>   一个大于1的值增加渲染精度 (default: 4)
  --space-as-offset <int>       把空格字符作为偏移量 (default: 0)
  --tounicode <int>             如何处理ToUnicode的CMap (0=auto, 1=force,-1=ignore) (default: 0)
  --optimize-text <int>         尽量减少用于文本的HTML元素的数目 (default: 0)
  --bg-format <string>          指定背景图像格式 (default: "png")
  -o,--owner-password <string>  所有者密码 (为了加密文件)
  -u,--user-password <string>   用户密码 (为了加密文件)
  --no-drm <int>                覆盖文档的 DRM 设置 (default: 0)
  --clean-tmp <int>             转换后删除临时文件 (default: 1)
  --data-dir <string>           指定的数据目录 (default: ".\share\pdf2htmlEX")
  --debug <int>                 打印调试信息 (default: 0)
  -v,--version                  打印版权和版本信息
  -h,--help                     打印使用帮助信息

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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
pdf2htmlEX(1)               General Commands Manual              pdf2htmlEX(1)

NAME
         pdf2htmlEX - converts PDF to HTML without losing text and format.

USAGE
         pdf2htmlEX [options] <input-filename> [<output-filename>]

DESCRIPTION
       pdf2htmlEX is a utility that converts PDF files to HTML files.

       pdf2htmlEX  tries its best to render the PDF precisely, maintain proper
       styling, while retaining text and optimizing for Web.

       Fonts are extracted form PDF and then embedded into HTML (Type 3  fonts
       are  not  supported).  Text  in  the  converted  HTML  file  is usually
       selectable and copyable.

       Other objects are rendered as images and also embedded.

OPTIONS
   Pages
       -f, --first-page <num> (Default: 1)
              Specify the first page to process

       -l, --last-page <num> (Default: last page)
              Specify the last page to process

   Dimensions
       --zoom <ratio>, --fit-width <width>, --fit-height <height>
              --zoom specifies the zoom  factor  directly;  --fit-width/height
              specifies  the maximum width/height of a page, the values are in
              pixels.

              If multiple values are specified, the minimum one will be used.

              If none is specified, pages will be rendered as 72DPI.

       --use-cropbox <0|1> (Default: 1)
              Use CropBox instead of MediaBox for output.

       --hdpi <dpi>, --vdpi <dpi> (Default: 144)
              Specify the horizontal and vertical DPI for images

   Output
       --embed <string>
       --embed-css <0|1> (Default: 1)
       --embed-font <0|1> (Default: 1)
       --embed-image <0|1> (Default: 1)
       --embed-javascript <0|1> (Default: 1)
       --embed-outline <0|1> (Default: 1)
              Specify which elements should be embedded into the  output  HTML
              file.

              If  switched  off,  separated files will be generated along with
              the HTML file for the corresponding elements.

              --embed accepts a string as argument. Each letter of the  string
              must  be  one  of  `cCfFiIjJoO`, which corresponds to one of the
              --embed-*** switches. Lower case letters for 0  and  upper  case
              letters  for  1.  For  example,  `--embed  cFIJo` means to embed
              everything but CSS files and outlines.

       --split-pages <0|1> (Default: 0)
              If turned on, the content of each page is stored in a  separated
              file.

              This  switch is useful if you want pages to be loaded separately
              & dynamically -- a supporting server might be necessary.

              Also see --page-filename.

       --dest-dir <dir> (Default: .)
              Specify destination folder.

       --css-filename <filename> (Default: <none>)
              Specify the filename of the generated css file, if not embedded.

              If it's empty, the file name will be determined automatically.

       --page-filename <filename> (Default: <none>)
              Specify the filename template for pages when --split-pages is 1

              A %d placeholder may be included in `filename` to indicate where
              the  page  number  should  be placed. The placeholder supports a
              limited subset of normal numerical placeholders, including spec‐
              ified width and zero padding.

              If  `filename`  does not contain a placeholder for the page num‐
              ber, the page number will be inserted directly before  the  file
              extension.  If the filename does not have an extension, the page
              number will be placed at the end of the file name.

              If --page-filename is not specified,  <input-filename>  will  be
              used for the output filename, replacing the extension with .page
              and adding the page number directly before the extension.

              Examples

              pdf2htmlEX --split-pages 1 foo.pdf

                Yields page files foo1.page, foo2.page, etc.

              pdf2htmlEX --split-pages 1 foo.pdf --page-filename bar.baz

                Yields page files bar1.baz, bar2.baz, etc.

              pdf2htmlEX --split-pages 1 foo.pdf --page-filename page%dbar.baz

                Yields page files page1bar.baz, page2bar.baz, etc.

              pdf2htmlEX --split-pages 1 foo.pdf --page-filename bar%03d.baz

                Yields page files bar001.baz, bar002.baz, etc.

       --outline-filename <filename> (Default: <none>)
              Specify the filename of  the  generated  outline  file,  if  not
              embedded.

              If it's empty, the file name will be determined automatically.

       --process-nontext <0|1> (Default: 1)
              Whether to process non-text objects (as images)

       --process-outline <0|1> (Default: 1)
              Whether to show outline in the generated HTML

       --printing <0|1> (Default: 1)
              Enable  printing  support.  Disabling this option may reduce the
              size of CSS.

       --fallback <0|1> (Default: 0)
              Output in fallback mode, for better accuracy and browser compat‐
              ibility, but the size becomes larger.

       --tmp-file-size-limit <limit> (Default: -1)
              This  limits the total size (in KB) of the temporary files which
              will also limit the total size of the output file.  This  is  an
              estimate and it will stop after a page, once the total temporary
              files size is greater than this number.

              -1 means no limit and is the default.

   Fonts
       --embed-external-font <0|1> (Default: 1)
              Specify whether the local matched fonts, for fonts not  embedded
              in PDF, should be embedded into HTML.

              If  this  switch  is off, only font names are exported such that
              web browsers may try to find proper fonts themselves,  and  that
              might cause issues about incorrect font metrics.

       --font-format <format> (Default: woff)
              Specify the format of fonts extracted from the PDF file.

       --decompose-ligature <0|1> (Default: 0)
              Decompose ligatures. For example 'fi' -> 'f''i'.

       --auto-hint <0|1> (Default: 0)
              If  set  to 1, hints will be generated for the fonts using font‐
              forge.

              This may be preceded by --external-hint-tool.

       --external-hint-tool <tool> (Default: <none>)
              If specified, the tool will be called in order to enhanced hint‐
              ing for fonts, this will precede --auto-hint.

              The  tool  will  be called as '<tool> <in.suffix> <out.suffix>',
              where suffix will be the same as specified for --font-format.

       --stretch-narrow-glyph <0|1> (Default: 0)
              If set to 1, glyphs narrower  than  described  in  PDF  will  be
              stretched;  otherwise  space  will be padded to the right of the
              glyphs

       --squeeze-wide-glyph <0|1> (Default: 1)
              If set to  1,  glyphs  wider  than  described  in  PDF  will  be
              squeezed; otherwise it will be truncated.

       --override-fstype <0|1> (Default: 0)
              Clear the fstype bits in TTF/OTF fonts.

              Turn  this  on  if Internet Explorer complains about 'Permission
              must be Installable' AND you have permission to do so.

       --process-type3 <0|1> (Default: 0)
              If turned on, pdf2htmlEX will try to convert Type 3  fonts  such
              that  text can be rendered natively in HTML.  Otherwise all text
              with Type 3 fonts will be rendered as image.

              This feature is highly experimental.

   Text
       --heps <len>, --veps <len> (Default: 1)
              Specify the maximum  tolerable  horizontal/vertical  offset  (in
              pixels).

              pdf2htmlEX  would try to optimize the generated HTML file moving
              Text within this distance.

       --space-threshold <ratio> (Default: 0.125)
              pdf2htmlEX would insert a whitespace character ' ' if  the  dis‐
              tance  between two consecutive letters in the same line is wider
              than ratio * font_size.

       --font-size-multiplier <ratio> (Default: 4.0)
              Many web browsers limit the minimum font size,  and  many  would
              round the given font size, which results in incorrect rendering.

              Specify a ratio greater than 1 would resolve this issue, however
              it might freeze some browsers.

              For some versions of Firefox, however, there will be  a  problem
              when  the  font size is too large, in which case a smaller value
              should be specified here.

       --space-as-offset <0|1> (Default: 0)
              If set to 1, space characters will be treated as offsets,  which
              allows a better optimization.

              For  PDF  files  with  bad encodings, turning on this option may
              cause losing characters.

       --tounicode <-1|0|1> (Default: 0)
              A ToUnicode map may be provided for each font in PDF which indi‐
              cates  the  'meaning'  of the characters. However often there is
              better "ToUnicode" info in Type 0/1  fonts,  and  sometimes  the
              ToUnicode map provided is wrong.  If this value is set to 1, the
              ToUnicode Map is always applied, if provided in PDF, and charac‐
              ters may not render correctly in HTML if there are collisions.

              If  set to -1, a customized map is used such that rendering will
              be correct in HTML (visually the same), but you may not get cor‐
              rect characters by select & copy & paste.

              If  set  to  0, pdf2htmlEX would try its best to balance the two
              methods above.

       --optimize-text <0|1> (Default: 0)
              If set to 1, pdf2htmlEX will try to reduce the  number  of  HTML
              elements used for text. Turn it off if anything goes wrong.

   Background Image
       --bg-format <format> (Default: png)
              Specify  the  background  image  format.  Run `pdf2htmlEX -v` to
              check all supported formats.

   PDF Protection
       -o, --owner-password <password>
              Specify owner password

       -u, --user-password <password>
              Specify user password

       --no-drm <0|1> (Default: 0)
              Override document DRM settings

              Turn this on only when you have permission.

   Misc.
       --clean-tmp <0|1> (Default: 1)
              If switched off, intermediate files won't be cleaned in the end.

       --data-dir <dir> (Default: /usr/local/share/pdf2htmlEX)
              Specify the folder holding the manifest  and  other  files  (see
              below for the manifest file)`

       --tmp-dir <dir> (Default: /tmp)
              Specify the temporary folder to use for temporary files

       --css-draw <0|1> (Default: 0)
              Experimental and unsupported CSS drawing

       --debug <0|1> (Default: 0)
              Print debug information.

   Meta
       -v, --version
              Print copyright and version info

       --help Print usage information

MANIFEST and DATA-DIR
       When  split-pages  is 0, the manifest file describes how the final html
       page should be generated.

       By default, pdf2htmlEX will use the manifest in  the  default  data-dir
       (run  `pdf2htmlEX  -v` to check), which gives a simple demo of its syn‐
       tax.

       You can modify the default one, or you can create a new one and specify
       the correct data-dir in the command line.

       All files referred by the manifest must be located in the data-dir.

EXAMPLE
       pdf2htmlEX /path/to/file.pdf
              Convert file.pdf into file.html

       pdf2htmlEX --clean-tmp 0 --debug 1 /path/to/file.pdf
              Convert file.pdf and leave all intermediate files.

       pdf2htmlEX --dest-dir out --embed fi /path/to/file.pdf
              Convert  file.pdf  into out/file.html and leave font/image files
              separated.

COPYRIGHT
       Copyright 2012,2013 Lu Wang <[email protected]>

       pdf2htmlEX is licensed under GPLv3 with additional terms, read  LICENSE
       for details.

AUTHOR
       pdf2htmlEX is written by Lu Wang <[email protected]>

SEE ALSO
       Home page
              https://github.com/coolwanglu/pdf2htmlEX

       pdf2htmlEX Wiki
              https://github.com/coolwanglu/pdf2htmlEX/wiki

                                pdf2htmlEX 0.12                  pdf2htmlEX(1)

pdftohtml -f 1 -l 2 poppler: because xpdf, pdf2image, and poppler install conflicting executables Please brew unlink poppler before continuing.

###参考：