summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/epspdf/epspdf.install
blob: 759cebde26e15976c614aa0b6dcfa17cb770d1a1 (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
                              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]Supporting software
     * [8]Releases
     * [9]To do
     * [10]User Guide

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

   Epspdf has been created with TeX users in mind. For them, 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 for most users this is still not good enough.

   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. 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 Ruby/Tk.

Prerequisites

  Windows with setup progrogam

   Download Ghostscript and GSview from the [11]Ghostscript site. Ghostscript
   and GSview each come with a standard Windows setup program.

   You can get pdftops as part of the xpdf suite from the [12]xpdf site.
   Download the zipfile with Windows binaries and unpack it in a location of
   your choice. The Configure screen of epspdftk lets you browse for this
   location. You only have to do this once. Xpdf itself is not in this zip
   file.

   The necessary Ruby components are already included in the setup program.

  Windows zipfile with separately installed Ruby

   For Ghostscript, GSview and the xpdf suite, see above.

   You can get a [13]one-click Ruby installer from [14]Rubyforge. For Ruby
   version 1.8.4 and later you have to download and install Tcl/Tk
   separately, in the form of [15]ActiveTcl. If you are only interested in
   the command-line version then you can leave out ActiveTcl.

  Unix/Linux

   You need Ghostscript, preferably xpdf/pdftops, Ruby (version at least 1.8)
   and for GUI use also Ruby/Tk. These will almost certainly be available as
   packages from your distribution.

  Mac OS X

   Ghostscript and xpdf are available via the [16]Fink Project, in the Text
   section.

   If you don't (want to) use Fink, you can download and install Gerben
   Wierda's i-Installer from the [17]i-Installer Home Page and then use the
   i-Installer to download and install the Ghostscript i-package.

   There is a [18]package for the xpdf suite at
   [19]http://users.phg-online.de/tk/MOSXS/. Or you can compile it yourself.
   You can download the source from the [20]xpdf site. For compilation, you
   need to have XCode installed, but nothing else, I think, at least not
   under Tiger. You can safely omit the xpdf- and pdftoppm components if
   configure says that they will not be compiled because of missing
   libraries.

   Ruby 1.8.2 and Ruby/Tk are part of Mac OS X Tiger. X11 needs to be
   installed, although Ruby/Tk is not an X11 application. For earlier
   versions of Mac OS X, you are on your own.

Installation

  Windows with setup program

   Download the [21]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.

  Windows zipfile

   Download the [22]epspdf zip file, unpack it somewhere and create a
   shortcut for epspdftk.rbw. If you plan to use the command-line version,
   put a batchfile in a directory on your path with the line

 "<path_to_ruby.exe>" "<path_to_epspdf.rb>" %1 %2 %3 %4 %5 %6 %7 %8 %9

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

  Unix/Linux

   Download the [23]tar.gz archive and unpack it in some directory. All files
   should be in the same directory; that is how they find each other. If you
   plan to use epspdf.rb from the command-line, then you may want to create a
   shell script epspdf such as

 #!/bin/sh
 <path_to_epspdf>/epspdf.rb $*

   and put it somewhere on your path.

   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

   Install as for Unix/Linux. Here, too, all files should be in the same
   directory.

   You can try to start epspdftk.rb from the dock or by doubleclicking. If
   that doesn't work out, give the [24]epspdf.app applet a try. After
   unpacking, move the file epspdf.app to the same directory as the .rb
   files. The zipfile also includes this file in text format
   (epspdf.applescript).

   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 viewers for PostScript and pdf.
   Without GSview, you probably won't be able to view PostScript files.

  Unix/Linux

   Supported PostScript viewers include evince, gv, ggv and kghostview. These
   are also listed as pdf viewers. Additional pdf viewers are xpdf, gpdf and
   acroread/Adobe Reader. If you think that I omitted a PostScript- or pdf
   viewer, let me know and I'll probably add it in the next release.

  Mac OS X

   Epspdftk will always use Preview as viewer under OS X.

Files

     * [25]epspdf.0.2.12.tgz preferred for Unix and Mac OS X
     * [26]epspdf.0.2.12.zip preferred for Windows
     * [27]epspdf.0.2.12.exe Windows setup program, including Ruby/Tk subset
     * [28]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb

  Older releases

     * [29]epspdf.0.2.11.tgz for Unix and Mac OS X
     * [30]epspdf.0.2.11.zip for Windows
     * [31]epspdf.0.2.11.exe Windows setup program
     * [32]epspdf.0.2.01.tgz for Unix and Mac OS X
     * [33]epspdf.0.2.01.zip for Windows
     * [34]epspdf.0.2.exe, Windows setup program

Supporting software

     * [35]Ghostscript and GSview
     * [36]XPDF
     * [37]OS X binary for xpdf/pdftops
     * [38]Ruby one-click installer
     * [39]Ruby Home Page
     * [40]ActiveTcl

Releases

   0.2.12
           Current version. 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 [41]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

To do

     * Artwork
     * GUI for some pdftops options
     * Proper help
     * Support for bitmapped formats (maybe)

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

   Last revised: November 20, 2006

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#supporting
   8. http://tex.aanhet.net/epspdf/index.html#releases
   9. http://tex.aanhet.net/epspdf/index.html#todo
  10. http://tex.aanhet.net/epspdf/epspdf_UG.html
  11. http://www.cs.wisc.edu/~ghost/
  12. http://www.foolabs.com/xpdf/
  13. http://rubyforge.org/projects/rubyinstaller/
  14. http://rubyforge.org/
  15. http://activestate.com/Products/ActiveTcl/
  16. http://fink.sourceforge.net/
  17. http://ii2.sourceforge.net/
  18. http://users.phg-online.de/tk/MOSXS/xpdf-tools-3.dmg
  19. http://users.phg-online.de/tk/MOSXS/
  20. http://www.foolabs.com/xpdf/
  21. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
  22. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
  23. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
  24. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
  25. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
  26. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
  27. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
  28. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
  29. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz
  30. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip
  31. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe
  32. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
  33. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
  34. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
  35. http://www.cs.wisc.edu/~ghost/
  36. http://www.foolabs.com/xpdf/
  37. http://users.phg-online.de/tk/MOSXS/
  38. http://rubyforge.org/projects/rubyinstaller/
  39. http://ruby-lang.org/
  40. http://activestate.com/Products/ActiveTcl/
  41. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip