summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf/epspdf.install
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/epspdf.install')
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.install320
1 files changed, 151 insertions, 169 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.install b/Master/texmf-dist/doc/support/epspdf/epspdf.install
index fec78698435..d982a1db824 100644
--- a/Master/texmf-dist/doc/support/epspdf/epspdf.install
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.install
@@ -11,12 +11,11 @@ Table of Contents
* [2]Features
* [3]Prerequisites
- * [4]Ruby/Tk
- * [5]Installation
- * [6]Preview programs
- * [7]Files
- * [8]Releases
- * [9]User Manual
+ * [4]Installation
+ * [5]Preview programs
+ * [6]Files
+ * [7]Releases
+ * [8]User Manual
Features
@@ -38,7 +37,7 @@ Features
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.
+ 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.
@@ -52,12 +51,17 @@ Features
does whatever back-and-forth conversions are necessary.
The command-line program epspdf is written in Ruby. Epspdftk, its GUI
- companion, in Ruby/Tk.
+ companion, in Tcl/Tk. Versions prior to 0.5 were written in Ruby/Tk.
- Starting with the 2008 edition, epspdf is included in TeX Live as an
- optional package, complete with wrappers epspdf and epspdftk which can be
+ 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
@@ -67,8 +71,8 @@ Prerequisites
* 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. The version (8.4 or
- 8.5) must be supported by your Ruby.
+ * 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.
@@ -76,44 +80,31 @@ Prerequisites
Linux
On a current Linux distribution you can almost certainly install
- everything from your distribution's package repositories. Ruby's Tk
- bindings may be in a separate package, with a name such as libtcltk-ruby.
- 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 (Tiger and Leopard)
-
- Ruby, Tcl/Tk and Ruby/Tk are already part of Tiger and Leopard.
-
- Ghostscript is included in MacTeX, but is also available via e.g.
- MacPorts.
+ 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.
- You can get pdftops from MacPorts as part of either Poppler or xpdf.
- Another source is [10]http://users.phg-online.de/tk/MOSXS/. If you want to
- compile xpdf it 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.
-
- Mac OS X Snow Leopard
+ Mac OS X
- For Ghostscript and pdftops, see above.
+ Note. Version 0.5 has not been tested with Tiger.
- Unfortunately, in Snow Leopard Ruby's Tk bindings went missing, so the GUI
- interface won't work with the built-in Ruby; see [11]below. If you compile
- Ruby yourself from [12]source you get the Tk interface automatically. Call
- configure with a --enable-pthread option.
+ 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/.
- Snow Leopard's built-in Ruby is fine for command-line use and on-the-fly
- conversions.
+ 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 includes a partial Ruby installation. See the table below:
+ installer which takes care of the Ruby- and Tcl/Tk requirements. See the
+ table below:
- TeX distribution Installer Zipfile
+ 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
@@ -122,70 +113,52 @@ Prerequisites
(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 1.8 and Tcl/Tk.
- TeX Live[13](1) No additional Ruby, Tcl/Tk[14](2)
- requirements
- MiKTeX Pdftops (optional) Pdftops (optional); Ruby 1.8,
- Tcl/Tk(optional)
- Other/None Ghostscript, pdftops Ghostscript; pdftops(optional),
- (optional) Ruby 1.8, Tcl/Tk (optional)
+ 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 ([15]http://pages.cs.wisc.edu/~ghost/)
+ 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 ([16]http://www.foolabs.com/xpdf/)
+ 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 ([17]http://users.phg-online.de/tk/MOSXS/)
+ XPDF, Mac OS X binaries ([14]http://users.phg-online.de/tk/MOSXS/)
These are universal binaries.
- TeX Live ([18]http://www.tug.org/texlive/)
+ TeX Live ([15]http://www.tug.org/texlive/)
TeX Live ≥ 2008 includes pdftops, Ghostscript and optionally
epspdf.
- MacTeX ([19]http://www.tug.org/mactex/)
+ 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 ([20]http://www.macports.org/)
+ 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 (
- [21]http://rubyforge.org/projects/rubyinstaller/)
- Current versions (1.8.4 and later) require Tcl/Tk to be separately
- installed.
+ [18]http://rubyforge.org/projects/rubyinstaller/)
- Old releases of Ruby one-click installer (
- [22]http://rubyforge.org/frs/?group_id=167)
- Versions prior to 1.8.4 include Tcl/Tk.
-
- Ruby source code ([23]http://www.ruby-lang.org/en/downloads/)
+ Ruby source code ([19]http://www.ruby-lang.org/en/downloads/)
For those people who prefer to roll their own...
- ActiveTcl from ActiveState (
- [24]http://activestate.com/Products/ActiveTcl/
- Version 8.4 is the safer bet.
-
- Ruby's Tk interface library
-
- At the moment, the Ruby Tk interface is not as readily available as it has
- been: at some time during the 8.4 cycle, the Windows Ruby one-click
- installer dropped Tcl/Tk, and aimed instead to hook up to any
- already-installed Tcl/Tk. As to Ruby 1.9: at the moment I know of no
- easy-to-use installer on Windows which includes a Tk interface library. On
- Mac OS X 10.6 (Snow Leopard) the Ruby Tk interface library also went
- missing, although both Ruby and Tcl/Tk are still included.
+ Tcl Developer Xchange ([20]http://www.tcl.tk/)
- I am working on a pure Tcl/Tk interface, i.e.a Tcl/Tk script which calls
- epspdf as a program, not as a library, but I can give no ETA. This will
- eliminate dependence on a Ruby/Tk interface library.
+ ActiveTcl from ActiveState (
+ [21]http://activestate.com/Products/ActiveTcl/
Installation
@@ -197,31 +170,37 @@ Installation
Windows setup program
- Download the [25]epspdftk setup program. You can run it in the usual way,
+ 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 [26]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
+ Download the [24]epspdf zip file, unpack it somewhere and create a
+ batchfile epspdf.bat such as
+
+ ruby "<path_to_epspdf.rb>" %*
- "<path_to_ruby.exe>" "<path_to_epspdf.rb>" %*
+ for epspdf.rb, and a batchfile epspdftk.bat
- Similarly for epspdftk. With such a batchfile, the caller has to take care
- of quoting:
+ wish85 "<path_to_epspdftk.tcl>" %1
- epspdf "my file.eps" "my file.pdf"
+ 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 [27]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 create a shell script
- epspdf such as
+ 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 shell script epspdf
+ such as
#!/bin/sh
<path_to_epspdf>/epspdf.rb "$@"
@@ -233,15 +212,10 @@ Installation
Mac OS X
- You can install as for Unix/Linux. Here, too, all files should be in the
- same directory.
-
- 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. The current
- version has been created and tested with Leopard. As pointed out
- [28]above, under Snow Leopard the GUI program epspdftk will not work
- without a third-party Ruby/Tk.
+ 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.
@@ -250,51 +224,58 @@ Preview programs
Windows
- Epspdftk will use the default Windows programs for PostScript and pdf. If
- you have TeX Live 2008 or later then you can assign <TeX Live
- root>\bin\win32\psv.bat as previewer for .ps- and .eps files. For Windows
- only, there is an additional "View with..." button to select a viewer
- yourself.
+ Epspdftk will use the default Windows programs for PostScript and pdf.
Unix/Linux
- Supported PostScript viewers include evince, gv, gsview and okular. These
- are also listed as pdf viewers. Additional pdf viewers are xpdf, gpdf,
- epdfview and acroread/Adobe Reader. You can also specify a previewer
- manually in the configuration screen; see the [29]user manual..
+ 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 will always use the default pdf viewer under OS X, usually
- Preview or Adobe Reader.
+ Epspdftk uses the default pdf viewer under OS X, usually Preview or Adobe
+ Reader.
Files
- * [30]epspdf.0.4.3.tgz preferred for Unix and Mac OS X; GUI fails under
- OS X Snow Leopard with built-in Ruby
- * [31]epspdf.0.4.3.zip preferred for Windows
- * [32]epspdf.0.4.3.exe Windows setup program, including Ruby/Tk subset
- * [33]epspdftk.0.4.3.dmg.gz; built and tested on Leopard
+ * [27]epspdf.0.5.tgz preferred for Unix and Mac OS X
+ * [28]epspdf.0.5.zip preferred for Windows if you don't want to use the
+ installer below
+ * [29]epspdf.0.5.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.dmg.gz compressed disk image with epspdftk wrapped
+ into a Mac OS X "app"
Older releases
- * [34]epspdftk.0.4.2.dmg.gz; tested on Tiger and Leopard
- * [35]epspdf.0.3.0.tgz for Unix and Mac OS X
- * [36]epspdf.0.3.0.zip for Windows
- * [37]epspdf.0.3.0.exe Windows setup program
- * [38]epspdf.0.2.12.tgz for Unix, including Mac OS X
- * [39]epspdf.0.2.12.zip for Windows
- * [40]epspdf.0.2.12.exe Windows setup program
- * [41]epspdf.0.2.01.tgz for Unix and Mac OS X
- * [42]epspdf.0.2.01.zip for Windows
- * [43]epspdf.0.2.exe, Windows setup program
- * [44]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
+ * [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
+ Current version. Ruby/Tk GUI replaced with Tcl/Tk GUI. Starpack
+ wrapper for Windows setup version.
+
0.4.3
- Current version. Fixes for compatibility with Ruby 1.9 and, under
- Windows, for newer Ghostscript versions. Documentation updates.
+ 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.
@@ -352,7 +333,7 @@ Releases
--------------------------------------------------------------------------
- Last revised: Januari 27, 2010
+ Last revised: March 29, 2010
References
@@ -360,44 +341,45 @@ References
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#rubytk
- 5. http://tex.aanhet.net/epspdf/index.html#install
- 6. http://tex.aanhet.net/epspdf/index.html#preview
- 7. http://tex.aanhet.net/epspdf/index.html#files
- 8. http://tex.aanhet.net/epspdf/index.html#releases
- 9. http://tex.aanhet.net/epspdf/epspdf.pdf
- 10. http://users.phg-online.de/tk/MOSXS/
- 11. http://tex.aanhet.net/epspdf/index.html#rubytk
- 12. http://www.ruby-lang.org/en/downloads/
- 13. http://tex.aanhet.net/epspdf/index.html#tlnote
- 14. http://tex.aanhet.net/epspdf/index.html#tlzipnote
- 15. http://pages.cs.wisc.edu/~ghost/
- 16. http://www.foolabs.com/xpdf/
- 17. http://users.phg-online.de/tk/MOSXS/
- 18. http://www.tug.org/texlive/
- 19. http://www.tug.org/mactex/
- 20. http://www.macports.org/
- 21. http://rubyforge.org/projects/rubyinstaller/
- 22. http://rubyforge.org/frs/?group_id=167
- 23. http://www.ruby-lang.org/en/downloads/
- 24. http://activestate.com/Products/ActiveTcl/
- 25. http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe
- 26. http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip
- 27. http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz
- 28. http://tex.aanhet.net/epspdf/index.html#rubytk
- 29. http://tex.aanhet.net/epspdf/epspdf.pdf
- 30. http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz
- 31. http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip
- 32. http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe
- 33. http://tex.aanhet.net/epspdf/epspdftk.0.4.3.dmg.gz
- 34. http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz
- 35. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
- 36. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
- 37. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
- 38. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
- 39. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
- 40. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
- 41. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
- 42. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
- 43. http://tex.aanhet.net/epspdf/epspdf.0.2.exe
- 44. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
+ 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.exe
+ 23. http://nsis.sourceforge.net/
+ 24. http://tex.aanhet.net/epspdf/epspdf.0.5.zip
+ 25. http://tex.aanhet.net/epspdf/epspdf.0.5.tgz
+ 26. http://tex.aanhet.net/epspdf/epspdf.pdf
+ 27. http://tex.aanhet.net/epspdf/epspdf.0.5.tgz
+ 28. http://tex.aanhet.net/epspdf/epspdf.0.5.zip
+ 29. http://tex.aanhet.net/epspdf/epspdf.0.5.exe
+ 30. http://tex.aanhet.net/epspdf/epspdftk.0.5.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