diff options
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/epspdf.install')
| -rw-r--r-- | Master/texmf-dist/doc/support/epspdf/epspdf.install | 279 |
1 files changed, 155 insertions, 124 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.install b/Master/texmf-dist/doc/support/epspdf/epspdf.install index 4e20e2f4152..fec78698435 100644 --- a/Master/texmf-dist/doc/support/epspdf/epspdf.install +++ b/Master/texmf-dist/doc/support/epspdf/epspdf.install @@ -11,11 +11,12 @@ Table of Contents * [2]Features * [3]Prerequisites - * [4]Installation - * [5]Preview programs - * [6]Files - * [7]Releases - * [8]User Manual + * [4]Ruby/Tk + * [5]Installation + * [6]Preview programs + * [7]Files + * [8]Releases + * [9]User Manual Features @@ -54,8 +55,8 @@ Features companion, in Ruby/Tk. Starting with the 2008 edition, epspdf is included in TeX Live as an - optional package, complete with wrapper scripts epspdf and epspdftk which - can be called from the command-line without further ado. + optional package, complete with wrappers epspdf and epspdftk which can be + called from the command-line without further ado. Prerequisites @@ -65,9 +66,9 @@ Prerequisites * Ghostscript * pdftops from the xpdf suite, strongly recommended for better pdf to PostScript conversions - * Ruby 1.8.x - * Tcl/Tk is only required for the GUI interface. Only version 8.4 has - been tested. + * 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. * Optional: viewers for PostScript and pdf You may not have to install all of these yourself. @@ -75,25 +76,36 @@ Prerequisites Linux On a current Linux distribution you can almost certainly install - everything from your distribution's package repositories. You may have to - install Ruby's Tk bindings, in addition to Ruby and Tcl/Tk themselves. The - name of such a package might be e.g. libtcltk-ruby. As to PostScript- and - pdf viewers: epspdf tests for several popular viewers, but the - configuration screen also lets you specify viewers manually. + 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 later) + Mac OS X (Tiger and Leopard) - Warning! Epspdf has not yet been tested with Snow Leopard. There is a - report that epspdftk fails under Snow Leopard. + Ruby, Tcl/Tk and Ruby/Tk are already part of Tiger and Leopard. - 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/. + Ghostscript is included in MacTeX, but is also available via e.g. + MacPorts. - 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. + 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 + + For Ghostscript and pdftops, see above. + + 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. + + Snow Leopard's built-in Ruby is fine for command-line use and on-the-fly + conversions. Windows (Windows 2000 and later) @@ -101,99 +113,112 @@ Prerequisites 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: - 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 wrapper batchfiles epspdf.bat and - epspdftk.bat. 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) + 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 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) URLs for the prerequisites - Ghostscript and GSview ([12]http://pages.cs.wisc.edu/~ghost/) + Ghostscript and GSview ([15]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/) + XPDF ([16]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/) + XPDF, Mac OS X binaries ([17]http://users.phg-online.de/tk/MOSXS/) These are universal binaries. - TeX Live ([15]http://www.tug.org/texlive/) - TeX Live 2008 includes epspdf as an optional install. For Windows, - this version doesn't require external copies of pdftops or - Ghostscript but does not include Ruby or Tcl/Tk. + TeX Live ([18]http://www.tug.org/texlive/) + TeX Live ≥ 2008 includes pdftops, Ghostscript and optionally + epspdf. - MacTeX ([16]http://www.tug.org/mactex/) + MacTeX ([19]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/) + The MacPorts Project ([20]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/) + [21]http://rubyforge.org/projects/rubyinstaller/) Current versions (1.8.4 and later) require Tcl/Tk to be separately installed. Old releases of Ruby one-click installer ( - [19]http://rubyforge.org/frs/?group_id=167) + [22]http://rubyforge.org/frs/?group_id=167) Versions prior to 1.8.4 include Tcl/Tk. - Ruby source code ([20]http://www.ruby-lang.org/en/downloads/) + Ruby source code ([23]http://www.ruby-lang.org/en/downloads/) For those people who prefer to roll their own... ActiveTcl from ActiveState ( - [21]http://activestate.com/Products/ActiveTcl/ - Get version 8.4, not 8.5. + [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. + + 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. Installation First make sure that the prerequisites are met. Then: - TeX Live 2008 + 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, + Download the [25]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 [23]epspdf zip file, unpack it somewhere and create a + 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 "<path_to_ruby.exe>" "<path_to_epspdf.rb>" %* - With such a batchfile, the caller has to take care of quoting: + Similarly for epspdftk. With such a batchfile, the caller has to take care + of quoting: epspdf "my file.eps" "my file.pdf" - Epspdf[tk] has been tested with Windows 2000, Windows XP and Windows - Vista. + Epspdf[tk] has been tested with Windows 2000, Windows XP and Windows 7. Unix/Linux - Download the [24]tar.gz archive and unpack it in some directory. All files + 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 @@ -213,7 +238,10 @@ Installation 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. + 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. Epspdf mostly duplicates functionality of Preview. But having an alternate conversion engine means that you can have another shot at problem files. @@ -233,7 +261,7 @@ Preview programs 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 [25]user manual.. + manually in the configuration screen; see the [29]user manual.. Mac OS X @@ -242,33 +270,34 @@ Preview programs Files - * [26]epspdf.0.4.2.tgz preferred for Unix and Mac OS X - * [27]epspdf.0.4.2.zip preferred for Windows - * [28]epspdf.0.4.2.exe Windows setup program, including Ruby/Tk subset - * [29]epspdftk.0.4.2.dmg.gz compressed disk image with epspdftk wrapped - into a Mac OS X "app" + * [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 Older releases - * [30]epspdf.0.3.0.tgz for Unix and Mac OS X - * [31]epspdf.0.3.0.zip for Windows - * [32]epspdf.0.3.0.exe Windows setup program - * [33]epspdf.0.2.12.tgz for Unix and Mac OS X - * [34]epspdf.0.2.12.zip for Windows - * [35]epspdf.0.2.12.exe Windows setup program - * [36]epspdf.0.2.11.tgz for Unix and Mac OS X - * [37]epspdf.0.2.11.zip for Windows - * [38]epspdf.0.2.11.exe Windows setup program - * [39]epspdf.0.2.01.tgz for Unix and Mac OS X - * [40]epspdf.0.2.01.zip for Windows - * [41]epspdf.0.2.exe, Windows setup program - * [42]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb + * [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 Releases + 0.4.3 + Current version. Fixes for compatibility with Ruby 1.9 and, under + Windows, for newer Ghostscript versions. Documentation updates. + 0.4.2 - Current version. More liberal documentation license. Slight - documentation updates. + More liberal documentation license. Slight documentation updates. 0.4.1 Documentation: added section on bitmaps. Windows setup program: @@ -323,7 +352,7 @@ Releases -------------------------------------------------------------------------- - Last revised: September 11, 2009 + Last revised: Januari 27, 2010 References @@ -331,42 +360,44 @@ 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#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://rubyforge.org/frs/?group_id=167 - 20. http://www.ruby-lang.org/en/downloads/ - 21. http://activestate.com/Products/ActiveTcl/ - 22. http://tex.aanhet.net/epspdf/epspdf.0.4.2.exe - 23. http://tex.aanhet.net/epspdf/epspdf.0.4.2.zip - 24. http://tex.aanhet.net/epspdf/epspdf.0.4.2.tgz - 25. http://tex.aanhet.net/epspdf/epspdf.pdf - 26. http://tex.aanhet.net/epspdf/epspdf.0.4.2.tgz - 27. http://tex.aanhet.net/epspdf/epspdf.0.4.2.zip - 28. http://tex.aanhet.net/epspdf/epspdf.0.4.2.exe - 29. http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz - 30. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz - 31. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip - 32. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe - 33. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz - 34. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip - 35. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe - 36. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz - 37. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip - 38. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe - 39. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz - 40. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip - 41. http://tex.aanhet.net/epspdf/epspdf.0.2.exe - 42. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip + 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 |