summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf/epspdf.install
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-03-08 01:37:33 +0000
committerKarl Berry <karl@freefriends.org>2009-03-08 01:37:33 +0000
commit527a74fac35059aa094d70a74a74949e35655060 (patch)
treef72b507060bd21b802a6b47aa453ce236031a239 /Master/texmf-dist/doc/support/epspdf/epspdf.install
parentff0e5deb9aa09b585004a4e4c66a0543979e8425 (diff)
epspdf update
git-svn-id: svn://tug.org/texlive/trunk@12334 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/epspdf.install')
-rw-r--r--Master/texmf-dist/doc/support/epspdf/epspdf.install359
1 files changed, 359 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/epspdf.install b/Master/texmf-dist/doc/support/epspdf/epspdf.install
new file mode 100644
index 00000000000..8aa4fa90f07
--- /dev/null
+++ b/Master/texmf-dist/doc/support/epspdf/epspdf.install
@@ -0,0 +1,359 @@
+ 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]Releases
+ * [8]User Manual
+
+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
+ * Support for TeX Live and MiKTeX
+
+ Epspdf has been created with TeX in mind. For TeX and its derivatives, 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 converting text back to PostScript. 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.
+
+ 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.
+
+Prerequisites
+
+ These are the required and optional prerequisites, which will be checked
+ for when epspdf starts:
+
+ * 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.
+ * Optional: viewers for PostScript and pdf
+
+ You may not have to install all of these yourself.
+
+ 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.
+
+ Mac OS X (Tiger and later)
+
+ 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/.
+
+ 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.
+
+ 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:
+
+ 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)
+
+ URLs for the prerequisites
+
+ 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 ([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 ([14]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.
+
+ 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 ([17]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/)
+ 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)
+ Versions prior to 1.8.4 include Tcl/Tk.
+
+ Ruby source code ([20]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.
+
+Installation
+
+ First make sure that the prerequisites are met. Then:
+
+ 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,
+ 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
+ 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:
+
+ epspdf "my file.eps" "my file.pdf"
+
+ Epspdf[tk] has been tested with Windows 2000, Windows XP and Windows
+ Vista.
+
+ Unix/Linux
+
+ Download the [24]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
+
+ #!/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 [25]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 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.
+
+ 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 [26]user manual..
+
+ Mac OS X
+
+ Epspdftk will always use the default pdf viewer under OS X, usually
+ Preview or Adobe Reader.
+
+Files
+
+ * [27]epspdf.0.4.0.tgz preferred for Unix and Mac OS X
+ * [28]epspdf.0.4.0.zip preferred for Windows
+ * [29]epspdf.0.4.0.exe Windows setup program, including Ruby/Tk subset
+ * [30]epspdf_app.0.2.01.zip Mac OS X applet for starting epspdftk.rb
+
+ Older releases
+
+ * [31]epspdf.0.3.0.tgz for Unix and Mac OS X
+ * [32]epspdf.0.3.0.zip for Windows
+ * [33]epspdf.0.3.0.exe Windows setup program
+ * [34]epspdf.0.2.12.tgz for Unix and Mac OS X
+ * [35]epspdf.0.2.12.zip for Windows
+ * [36]epspdf.0.2.12.exe Windows setup program
+ * [37]epspdf.0.2.11.tgz for Unix and Mac OS X
+ * [38]epspdf.0.2.11.zip for Windows
+ * [39]epspdf.0.2.11.exe Windows setup program
+ * [40]epspdf.0.2.01.tgz for Unix and Mac OS X
+ * [41]epspdf.0.2.01.zip for Windows
+ * [42]epspdf.0.2.exe, Windows setup program
+
+Releases
+
+ 0.4.0
+ Current version. Optionally uses hires boundingbox. Faster startup
+ due to simpler testing of prerequisites. Grayscaling: support for
+ HSB color model, although I yet have to encounter a PostScript
+ file using this. Manual converted to texinfo format. Windows: new
+ View with... button; support for MikTeX's built-in Ghostscript;
+ streamlined Ruby subset, with Tcl/Tk compiled from source.
+
+ 0.3.0
+ Under Windows, now recognizes whether it is embedded in TeX Live
+ 2008 and then can use ghostscript/pdftops from TeX Live. Also
+ added TeX Live wrapper scripts. Uninstaller for Windows setup
+ program. Bug fixes: now accepts non-numerical version strings for
+ pdftops. No longer checks for viewers under Mac OS X.
+
+ 0.2.12
+ 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 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
+
+ --------------------------------------------------------------------------
+
+ Last revised: February 29, 2009
+
+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#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.3.0.exe
+ 23. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
+ 24. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
+ 25. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
+ 26. http://tex.aanhet.net/epspdf/epspdf.pdf
+ 27. http://tex.aanhet.net/epspdf/epspdf.0.4.0.tgz
+ 28. http://tex.aanhet.net/epspdf/epspdf.0.4.0.zip
+ 29. http://tex.aanhet.net/epspdf/epspdf.0.4.0.exe
+ 30. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip
+ 31. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz
+ 32. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip
+ 33. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe
+ 34. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz
+ 35. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip
+ 36. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe
+ 37. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz
+ 38. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip
+ 39. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe
+ 40. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz
+ 41. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip
+ 42. http://tex.aanhet.net/epspdf/epspdf.0.2.exe