diff options
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/epspdf.install')
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.install | 320 |
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 |