diff options
Diffstat (limited to 'Master/texmf-dist/doc/epspdf/epspdf.install')
| -rw-r--r-- | Master/texmf-dist/doc/epspdf/epspdf.install | 285 |
1 files changed, 285 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/epspdf/epspdf.install b/Master/texmf-dist/doc/epspdf/epspdf.install new file mode 100644 index 00000000000..759cebde26e --- /dev/null +++ b/Master/texmf-dist/doc/epspdf/epspdf.install @@ -0,0 +1,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 |