summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf/epspdf.install
blob: dbd25d7ef1aab471578d9af51c5519ec3dbc65c7 (plain)
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
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
                              Epspdf and epspdftk


   A multiplatform GUI- and command-line converter for [e]ps and pdf.


   Siep Kroonenberg,

   siepo at cybercomm dot nl


   [1]Current online version of this page


Table of Contents


     * [2]Features

     * [3]Prerequisites

     * [4]Installation

     * [5]Preview programs

     * [6]Files

     * [7]Releases

     * [8]User Manual


Features


     * Distiller

     * Works both for documents and for graphics

     * Single-page selection

     * Also converts from pdf back to PostScript and eps

     * Removal of preview headers from eps files

     * Cropping extra whitespace

     * Grayscaling (sometimes)

     * GUI- and command-line version

     * GUI-configurable preferences

     * Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS X

     * Support for TeX Live and MiKTeX


   Epspdf has been created with TeX in mind. For TeX and its derivatives, eps

   and pdf are the preferred graphics formats.


   Ghostscript can convert PostScript to pdf. However, few people are

   prepared to deal with the ghostscript command-line. Several command-line

   utilities try to help out, e.g. epstopdf, a2ping, and the convert utility

   from ImageMagick. But many users simply want a GUI.


   Epspdftk adds a GUI, with buttons to select options and with dialogs for

   opening and saving files.


   A lot more can be done if you can round-trip between PostScript and pdf.

   Although Ghostscript can go from pdf to PostScript, pdftops does a much

   better job converting text back to PostScript. This opens several new

   possibilities: grayscaling and computing a better boundingbox for either

   eps- or pdf graphics, and page selection from multipage PostScript- and

   pdf documents. Epspdf will use pdftops if it can find it, and silently

   does whatever back-and-forth conversions are necessary.


   The command-line program epspdf is written in Ruby. Epspdftk, its GUI

   companion, in Tcl/Tk. Versions prior to 0.5 were written in Ruby/Tk.


   Starting with the 2008 edition, TeX Live includes epspdf as an optional

   package, complete with wrapper scripts epspdf and epspdftk which can be

   called from the command-line without further ado.


   There is also a third-party LaTeX package epspdfconversion which uses

   epspdf for on-the-fly conversion of eps graphics to pdf, with options to

   control grayscaling and boundingbox generation. See CTAN or your TeX

   distribution.


Prerequisites


   These are the required and optional prerequisites, which will be checked

   for when epspdf starts:


     * Ghostscript

     * pdftops from the xpdf suite, strongly recommended for better pdf to

       PostScript conversions

     * Ruby 1.8.x or 1.9.x

     * Tcl/Tk is only required for the GUI interface. Versions 8.4 and 8.5

       have been tested.

     * Optional: viewers for PostScript and pdf


   You may not have to install all of these yourself.


  Linux


   On a current Linux distribution you can almost certainly install

   everything from your distribution's package repositories. As to

   PostScript- and pdf viewers: epspdf tests for several popular viewers, but

   the configuration screen also lets you specify viewers manually.


  Mac OS X


   Note. Version 0.5.x has not been tested with Tiger.


   Ruby and Tcl/Tk are already part of the operating system. Ghostscript is

   included in MacTeX, but is also available via e.g. MacPorts. You can get

   pdftops from MacPorts as part of either Poppler or xpdf. Another source is

   [9]http://users.phg-online.de/tk/MOSXS/.


   If you want to compile xpdf yourself, which is not hard, you can ignore

   warnings about X, Motif or FreeType not being found since these missing

   libraries won't affect the compilation of pdftops.


  Windows (Windows 2000 and later)


   By itself, Windows lacks any of the prerequisites of epspdf. However, a

   TeX installation may fill some of the gaps, and there is a special Windows

   installer which takes care of the Ruby- and Tcl/Tk requirements. See the

   table below:


     TeX distribution          Installer                   Zipfile

   (1) MikTeX and TeX Live ≥ 2008 include a hidden Ghostscript which is

   always installed, and which epspdf knows how to find. Caveat: although

   older versions of TeX Live include a Ghostscript installer, it is not

   impossible to install an older TeX Live without Ghostscript, in which case

   you have to provide a Ghostscript yourself.

   (2) With TeX Live ≥ 2008, you are better off installing the TeX Live

   package, which also gives you wrappers for epspdf and epspdftk for use on

   the command-line and for on-the-fly conversions. You still need to install

   Ruby and Tcl/Tk.

     TeX Live[10](1)    No additional            Ruby, Tcl/Tk[11](2)

                        requirements

          MiKTeX        Pdftops (optional)       Pdftops (optional); Ruby,

                                                 Tcl/Tk(optional)

                        Ghostscript, pdftops     Ghostscript;

        Other/None      (optional)               pdftops(optional), Ruby,

                                                 Tcl/Tk (optional)


  URLs for the prerequisites


   Ghostscript and GSview ([12]http://pages.cs.wisc.edu/~ghost/)

           Contains sources and Windows binaries. The Windows binaries come

           with standard GUI Windows setup programs.


   XPDF ([13]http://www.foolabs.com/xpdf/)

           Sources and Windows binaries. The Windows binaries are packaged

           into a zipfile, which has to be manually unpacked. The Configure

           screen of epspdftk lets you browse for the chosen location. You

           have to do this only once.


   XPDF, Mac OS X binaries ([14]http://users.phg-online.de/tk/MOSXS/)

           These are universal binaries.


   TeX Live ([15]http://www.tug.org/texlive/)

           TeX Live ≥ 2008 includes pdftops, Ghostscript and optionally

           epspdf.


   MacTeX ([16]http://www.tug.org/mactex/)

           MacTeX is based on TeX Live. Its set of add-ons includes

           Ghostscript, and can be downloaded separately.


   The MacPorts Project ([17]http://www.macports.org/)

           MacTeX has Poppler- and xpdf packages either of which include

           pdftops.


   Ruby one-click installer for Windows (

   [18]http://rubyforge.org/projects/rubyinstaller/)


   Ruby source code ([19]http://www.ruby-lang.org/en/downloads/)

           For those people who prefer to roll their own...


   Tcl Developer Xchange ([20]http://www.tcl.tk/)


   ActiveTcl from ActiveState (

   [21]http://activestate.com/Products/ActiveTcl/


Installation


   First make sure that the prerequisites are met. Then:


  TeX Live ≥ 2008


   Use TeX Live's package manager tlmgr for installation.


  Windows setup program


   Download the [22]epspdftk setup program. You can run it in the usual way,

   by double-clicking. The setup program will create entries in your start

   menu for epspdftk and for the user manual.


   The setup program has been created with [23]NSIS.


  Windows zipfile


   Download the [24]epspdf zip file, unpack it somewhere and create a

   batchfile epspdf.bat such as


 ruby "<path_to_epspdf.rb>" %*


   for epspdf.rb, and a batchfile epspdftk.bat


 wish85 "<path_to_epspdftk.tcl>" %1


   for epspdftk.tcl. The wish executable might also be named wish[.exe] or

   wish84[.exe]. The first command-line parameter will be interpreted as

   startup directory for the file browser. Make sure that wish85, ruby and

   these batchfiles are on your searchpath.


   Epspdf[tk] has been tested with Windows 2000, Windows XP and Windows 7.


  Unix/Linux


   Download the [25]tar.gz archive and unpack it in some directory. If you

   plan to use epspdf.rb from the command-line, create a symlink to epspdf.rb

   somewhere on your searchpath.


   You can do the same for epspdftk. The first command-line parameter will be

   interpreted as startup directory for the file browser.


  Mac OS X


   Although you can install as for Unix/Linux, there is also a compressed

   disk image epspdf.x.x.x.dmg.gz which wraps epspdftk into a Max OS X "app".

   Double-click once to expand, a second time to mount, then drag

   epspdftk.app to the Applications folder.


   Epspdf mostly duplicates functionality of Preview. But having an alternate

   conversion engine means that you can have another shot at problem files.


Preview programs


  Windows


   Epspdftk will use the default Windows programs for PostScript and pdf.


  Unix/Linux


   Supported PostScript viewers include evince, gv and okular. These are also

   listed as pdf viewers. Additional pdf viewers are xpdf, kpdf, epdfview and

   acroread/Adobe Reader. You can also specify a previewer manually in the

   configuration screen; see the [26]user manual..


  Mac OS X


   Epspdftk uses the default pdf viewer under OS X, usually Preview or Adobe

   Reader.


Files


     * [27]epspdf.0.5.3.tgz preferred for Unix and Mac OS X

     * [28]epspdf.0.5.3.zip preferred for Windows if you don't want to use

       the installer below

     * [29]epspdf.0.5.3.exe Windows setup program, including Ruby subset. The

       epspdftk script has been packaged with a basic Tcl/Tk into a single

       exe file (starpack).

     * [30]epspdftk.0.5.3.dmg.gz compressed disk image with epspdftk wrapped

       into a Mac OS X "app"


  Older releases


     * [31]epspdftk.0.4.3.dmg.gz; GUI doesn't work on Snow Leopard

     * [32]epspdf.0.4.3.tgz for Unix and Mac OS X

     * [33]epspdf.0.4.3.zip for Windows

     * [34]epspdf.0.4.3.exe Windows setup program

     * [35]epspdftk.0.4.2.dmg.gz; tested on Tiger and Leopard

     * [36]epspdf.0.3.0.tgz for Unix and Mac OS X

     * [37]epspdf.0.3.0.zip for Windows

     * [38]epspdf.0.3.0.exe Windows setup program

     * [39]epspdf.0.2.12.tgz for Unix, including Mac OS X

     * [40]epspdf.0.2.12.zip for Windows

     * [41]epspdf.0.2.12.exe Windows setup program

     * [42]epspdf.0.2.01.tgz for Unix and Mac OS X

     * [43]epspdf.0.2.01.zip for Windows

     * [44]epspdf.0.2.exe, Windows setup program

     * [45]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb


Releases


   0.5.3

           Current version. Minor initialization fix for Windows. The

           AppleScript wrapper for Mac OS X no longer starts a terminal. For

           users of Linux/Unix, there is no reason to upgrade.


   0.5.2

           Under Unix, wrapper scripts can now be replaced with simple

           symlinks.


   0.5.1

           Bug fix for boundingbox atend.


   0.5

           Ruby/Tk GUI replaced with Tcl/Tk GUI. Starpack wrapper for Windows

           setup version.


   0.4.3

           Fixes for compatibility with Ruby 1.9 and, under Windows, for

           newer Ghostscript versions. Documentation updates.


   0.4.2

           More liberal documentation license. Slight documentation updates.


   0.4.1

           Documentation: added section on bitmaps. Windows setup program:

           added missing Tcl/Tk licenses. Mac: double-clickable epspdftk.app

           with included epspdftk replaces double-clickable epspdf.app

           add-on.


   0.4.0

           Optionally uses hires boundingbox. Faster startup due to simpler

           testing of prerequisites. Grayscaling: support for HSB color

           model, although I yet have to encounter a PostScript file using

           this. Manual converted to texinfo format. Windows: new "View

           with..." button; support for MikTeX's built-in Ghostscript;

           streamlined Ruby subset, with Tcl/Tk compiled from source.


   0.3.0

           Under Windows, now recognizes whether it is embedded in TeX Live

           2008 and then can use ghostscript/pdftops from TeX Live. Also

           added TeX Live wrapper scripts. Uninstaller for Windows setup

           program. Bug fixes: now accepts non-numerical version strings for

           pdftops. No longer checks for viewers under Mac OS X.


   0.2.12

           Bug fixes: log rotation now works. Under Windows, sometimes

           boundingboxes couldn't be calculated. This was caused by double

           quotes within backquotes. This is now avoided by using short

           filenames within backquotes. Minor changes in user guide.


   0.2.11

           Minor fixes. Changes in documentation.


   0.2.10

           A computed boundingbox is now expanded by one point in all

           directions. This should prevent too-tight cropping. There is no

           interface for changing this amount; it can only be changed by

           hand-editing the bb_spread option in the .epspdfrc file or in the

           HKCU\software\epspdf registry key.

           The File Open dialog remembers the last directory visited (between

           calls, not between program sessions).

           Changes in documentation.


   0.2.01

           Fixes to the Applescript applet epspdf.app for starting up

           epspdftk under Mac OS X. It picks up the terminal search path and

           no longer requires correct settings in

           $HOME/.MacOSX/environment.plist. Epspdf.app is now packaged

           separately, under Mac OS X, and now has an intact resource fork.

           It has been removed from the other archives.


   0.2

           Original release


   --------------------------------------------------------------------------


   Last revised: February 27, 2011


References


   Visible links

   1. http://tex.aanhet.net/epspdf/

   2. http://tex.aanhet.net/epspdf/index.html#features

   3. http://tex.aanhet.net/epspdf/index.html#prerequisites

   4. http://tex.aanhet.net/epspdf/index.html#install

   5. http://tex.aanhet.net/epspdf/index.html#preview

   6. http://tex.aanhet.net/epspdf/index.html#files

   7. http://tex.aanhet.net/epspdf/index.html#releases

   8. http://tex.aanhet.net/epspdf/epspdf.pdf

   9. http://users.phg-online.de/tk/MOSXS/

  10. http://tex.aanhet.net/epspdf/index.html#tlnote

  11. http://tex.aanhet.net/epspdf/index.html#tlzipnote

  12. http://pages.cs.wisc.edu/~ghost/

  13. http://www.foolabs.com/xpdf/

  14. http://users.phg-online.de/tk/MOSXS/

  15. http://www.tug.org/texlive/

  16. http://www.tug.org/mactex/

  17. http://www.macports.org/

  18. http://rubyforge.org/projects/rubyinstaller/

  19. http://www.ruby-lang.org/en/downloads/

  20. http://www.tcl.tk/

  21. http://activestate.com/Products/ActiveTcl/

  22. http://tex.aanhet.net/epspdf/epspdf.0.5.3.exe

  23. http://nsis.sourceforge.net/

  24. http://tex.aanhet.net/epspdf/epspdf.0.5.3.zip

  25. http://tex.aanhet.net/epspdf/epspdf.0.5.3.tgz

  26. http://tex.aanhet.net/epspdf/epspdf.pdf

  27. http://tex.aanhet.net/epspdf/epspdf.0.5.3.tgz

  28. http://tex.aanhet.net/epspdf/epspdf.0.5.3.zip

  29. http://tex.aanhet.net/epspdf/epspdf.0.5.3.exe

  30. http://tex.aanhet.net/epspdf/epspdftk.0.5.3.dmg.gz

  31. http://tex.aanhet.net/epspdf/epspdftk.0.4.3.dmg.gz

  32. http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz

  33. http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip

  34. http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe

  35. http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz

  36. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz

  37. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip

  38. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe

  39. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz

  40. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip

  41. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe

  42. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz

  43. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip

  44. http://tex.aanhet.net/epspdf/epspdf.0.2.exe

  45. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip