diff options
author | Siep Kroonenberg <siepo@cybercomm.nl> | 2008-07-27 20:42:58 +0000 |
---|---|---|
committer | Siep Kroonenberg <siepo@cybercomm.nl> | 2008-07-27 20:42:58 +0000 |
commit | 7aeaf5c135f604e1fe30c5c6ecc2b11b54f01e67 (patch) | |
tree | d0809312979e89f75133408004b760a661a90c19 /Master/texmf-dist/doc/epspdf | |
parent | 81d3bf31b8ea3a46c75779abba79692988607eda (diff) |
epspdf: updated docs, minor tweaks
git-svn-id: svn://tug.org/texlive/trunk@9821 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/epspdf')
-rw-r--r-- | Master/texmf-dist/doc/epspdf/epspdf.install | 278 | ||||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/epspdf_UG.html | 38 | ||||
-rw-r--r-- | Master/texmf-dist/doc/epspdf/index.html | 247 |
3 files changed, 337 insertions, 226 deletions
diff --git a/Master/texmf-dist/doc/epspdf/epspdf.install b/Master/texmf-dist/doc/epspdf/epspdf.install index 759cebde26e..b05bc5d7d8e 100644 --- a/Master/texmf-dist/doc/epspdf/epspdf.install +++ b/Master/texmf-dist/doc/epspdf/epspdf.install @@ -14,10 +14,8 @@ Table of Contents * [4]Installation * [5]Preview programs * [6]Files - * [7]Supporting software - * [8]Releases - * [9]To do - * [10]User Guide + * [7]Releases + * [8]User Guide Features @@ -31,6 +29,7 @@ Features * GUI- and command-line version * GUI-configurable preferences * Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS X + * Support for TeX Live Epspdf has been created with TeX users in mind. For them, eps and pdf are the preferred graphics formats. @@ -54,68 +53,119 @@ Features 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 - Windows with setup progrogam + These are the required and optional prerequisites: - Download Ghostscript and GSview from the [11]Ghostscript site. Ghostscript - and GSview each come with a standard Windows setup program. + * 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 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. + You may not have to install all of these yourself. - The necessary Ruby components are already included in the setup program. + Linux - Windows zipfile with separately installed Ruby + 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. - For Ghostscript, GSview and the xpdf suite, see above. + Mac OS X (Tiger and later) - 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. + 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/. - Unix/Linux + 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 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. + Windows (Windows 2000 and later) - Mac OS X + If you use the TeXLive package (2008 or later): + Epspdf and epspdftk will use Ghostscript and pdftops built into + TeX Live. You still need to download and install Ruby and + optionally Tcl/Tk. + + If you install from the setup program: + This package includes a subset of Ruby/Tk, but you have to provide + Ghostscript and pdftops yourself. + + If you use the zipfile: + In this case, you have to provide everything yourself. + + URLs for the prerequisites + + Ghostscript and GSview ([10]http://pages.cs.wisc.edu/~ghost/) + Contains sources and Windows binaries. The Windows binaries come + with standard GUI Windows setup programs. + + XPDF ([11]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 ([12]http://users.phg-online.de/tk/MOSXS/) + These are universal binaries. + + TeX Live ([13]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. - Ghostscript and xpdf are available via the [16]Fink Project, in the Text - section. + MacTeX ([14]http://www.tug.org/mactex/) + MacTeX is based on TeX Live. Its set of add-ons includes + Ghostscript, and can be downloaded separately. - 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. + The MacPorts Project ([15]http://www.macports.org/) + MacTeX has Poppler- and xpdf packages either of which include + pdftops. - 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 one-click installer fro Windows ( + [16]http://rubyforge.org/projects/rubyinstaller/) + Current versions (1.8.4 and later) require Tcl/Tk to be separately + installed. - 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. + Old releases of Ruby one-click installer ( + [17]http://rubyforge.org/frs/?group_id=167) + Versions prior to 1.8.4 include Tcl/Tk. + + Ruby source code ([18]http://www.ruby-lang.org/en/downloads/) + For those people who prefer to roll their own... + + ActiveTcl from ActiveState ( + [19]http://activestate.com/Products/ActiveTcl/ + Get version 8.4, not 8.5. Installation - Windows with setup program + 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 [21]epspdftk setup program. You can run it in the usual way, + Download the [20]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 + Download the [21]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 @@ -125,10 +175,10 @@ Installation Unix/Linux - Download the [23]tar.gz archive and unpack it in some directory. All files + Download the [22]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 + plan to use epspdf.rb from the command-line, then create a shell script + epspdf such as #!/bin/sh <path_to_epspdf>/epspdf.rb $* @@ -144,7 +194,7 @@ Installation 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 + that doesn't work out, give the [23]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). @@ -156,15 +206,17 @@ 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. + Epspdftk will use the default Windows viewers 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. 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. + acroread/Adobe Reader. You can also specify a previewer manually in the + configuration screen; see the user guide, under [24]"The configuration + screen".. Mac OS X @@ -172,36 +224,38 @@ Preview programs 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 + * [25]epspdf.0.3.0.tgz preferred for Unix and Mac OS X + * [26]epspdf.0.3.0.zip preferred for Windows + * [27]epspdf.0.3.0.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 + * [29]epspdf.0.2.12.tgz for Unix and Mac OS X + * [30]epspdf.0.2.12.zip for Windows + * [31]epspdf.0.2.12.exe Windows setup program + * [32]epspdf.0.2.11.tgz for Unix and Mac OS X + * [33]epspdf.0.2.11.zip for Windows + * [34]epspdf.0.2.11.exe Windows setup program + * [35]epspdf.0.2.01.tgz for Unix and Mac OS X + * [36]epspdf.0.2.01.zip for Windows + * [37]epspdf.0.2.exe, Windows setup program Releases + 0.3.0 + Current version. Under Windows, now recognizes whether it is + embedded in TeX Live 2008 and then uses 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 - 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. + 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. @@ -220,24 +274,16 @@ Releases 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. + $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 -To do - - * Artwork - * GUI for some pdftops options - * Proper help - * Support for bitmapped formats (maybe) - -------------------------------------------------------------------------- - Last revised: November 20, 2006 + Last revised: July 27, 2008 References @@ -248,38 +294,34 @@ References 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 + 7. http://tex.aanhet.net/epspdf/index.html#releases + 8. http://tex.aanhet.net/epspdf/epspdf_UG.html + 9. http://users.phg-online.de/tk/MOSXS/ + 10. http://pages.cs.wisc.edu/~ghost/ + 11. http://www.foolabs.com/xpdf/ + 12. http://users.phg-online.de/tk/MOSXS/ + 13. http://www.tug.org/texlive/ + 14. http://www.tug.org/mactex/ + 15. http://www.macports.org/ + 16. http://rubyforge.org/projects/rubyinstaller/ + 17. http://rubyforge.org/frs/?group_id=167 + 18. http://www.ruby-lang.org/en/downloads/ + 19. http://activestate.com/Products/ActiveTcl/ + 20. http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe + 21. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip + 22. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz + 23. http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip + 24. http://tex.aanhet.net/epspdf/epspdf_UG.html#configure + 25. http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz + 26. http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip + 27. http://tex.aanhet.net/epspdf/epspdf.0.3.0.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 + 29. http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz + 30. http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip + 31. http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe + 32. http://tex.aanhet.net/epspdf/epspdf.0.2.11.tgz + 33. http://tex.aanhet.net/epspdf/epspdf.0.2.11.zip + 34. http://tex.aanhet.net/epspdf/epspdf.0.2.11.exe + 35. http://tex.aanhet.net/epspdf/epspdf.0.2.01.tgz + 36. http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip + 37. http://tex.aanhet.net/epspdf/epspdf.0.2.exe diff --git a/Master/texmf-dist/doc/epspdf/epspdf_UG.html b/Master/texmf-dist/doc/epspdf/epspdf_UG.html index 27a7d96626a..6ac2368788f 100644 --- a/Master/texmf-dist/doc/epspdf/epspdf_UG.html +++ b/Master/texmf-dist/doc/epspdf/epspdf_UG.html @@ -41,7 +41,8 @@ configurable; see below under <a href="#configure">The Configuration screen.</a></p> <p>The View button is grayed if epspdf thinks that there is no -previewer for the current file.</p> +previewer for the current file; see <a href="index.html#preview">the +epspdf main page</a> for details.</p> <p class="display"><img src="images/greenbroccoli.png" alt=""/></p> @@ -120,6 +121,15 @@ represent eps files on screen without having to interpret the PostScript code itself. Epspdf currently has no option to preserve or add them.</p> +<h2>On-the-fly conversion</h2> + +<p>Daniel Becker wrote a LaTeX package epspdfconversion which +converts eps files on the fly to pdf, like Heiko Oberdiek's epstopdf +package, but with epspdf as backend. It can make use of the epspdf +conversion options. Both packages are available from <a +href="http://www.tug.org/ctan.html">CTAN</a> and included in TeX +Live.</p> + <h2>Exporting PostScript from Windows programs</h2> <p>Often, the only way to get EPS or PostScript from a Windows @@ -158,14 +168,24 @@ PostScript output option. Using the Archive output option instead solved the problem. In general, experiment a bit in generating your PostScript.</p> +<h3>Mac OS X problems with epspdftk</h3> + +<p>Even though epspdftk is not an X11 program, you may still need +some pieces of X11 and the X11 SDK, which are optional installs of +OS X.</p> + +<p>Under Leopard, the window that is displayed during the conversion +stays blank. I have no idea why.</p> + <h3>Resources for troubleshooting</h3> -<p><i>Logfile.</i> Epspdf and epspdftk maintain a log file -epspdf.log in your home directory or, in case of Windows, your -profile directory. This profile directory may be c:\Documents and -Settings\<your user name>. Otherwise, open a DOS box and type -'<tt>echo %USERPROFILE%</tt>', which will produce this -information.</p> +<p><i>Logfile.</i> Epspdf and epspdftk maintain a log file. For Unix +and Mac OS X it is epspdf.log in your home directory. For Windows, +it is epspdf.log or epspdftl.log in your profile directory. The +latter filename is used if epspdf is embedded in TeX Live. This +profile directory may be c:\Documents and Settings\<your user +name>. Otherwise, open a DOS box and type '<tt>echo +%USERPROFILE%</tt>', which will produce this information.</p> <p>This logfile lists all Ghostscript- and pdftops program calls plus error information. 'EPCallError' is probably a program @@ -175,11 +195,11 @@ may be a program error as well.</p> <p><i>Temporary files.</i> The temporary files may give clues as well. They will be deleted at the end of the session (for the command-line version, give a -d parameter to keep the temporary -files). Check the logfile which temporary files have been +files). The logfile can tell you which temporary files have been created.</p> <h3><a href="index.html">Main page...</a></h3> <hr/> -<p class="fineprint">Last revised: Noverber 20, 2006</p> +<p class="fineprint">Last revised: July 27, 2008</p> </body></html> diff --git a/Master/texmf-dist/doc/epspdf/index.html b/Master/texmf-dist/doc/epspdf/index.html index 476deff50c9..a247c60bb07 100644 --- a/Master/texmf-dist/doc/epspdf/index.html +++ b/Master/texmf-dist/doc/epspdf/index.html @@ -31,9 +31,7 @@ this page</a></p> <li><a href="#install">Installation</a></li> <li><a href="#preview">Preview programs</a></li> <li><a href="#files">Files</a></li> -<li><a href="#supporting">Supporting software</a></li> <li><a href="#releases">Releases</a></li> -<li><a href="#todo">To do</a></li> <li><a href="epspdf_UG.html">User Guide</a></li> </ul> @@ -49,7 +47,9 @@ this page</a></p> <li>Grayscaling (sometimes)</li> <li>GUI- and command-line version</li> <li>GUI-configurable preferences</li> -<li>Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS X</li> +<li>Multiplatform: works unchanged on Windows, Unix/Linux and Mac OS +X</li> +<li>Support for TeX Live</li> </ul> <p>Epspdf has been created with TeX users in mind. For them, eps and @@ -75,85 +75,144 @@ does whatever back-and-forth conversions are necessary.</p> <p>The command-line program epspdf is written in Ruby. Epspdftk, its GUI companion, in Ruby/Tk.</p> +<p>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.</p> + <h2><a name="prerequisites"/>Prerequisites</h2> -<h3>Windows with setup progrogam</h3> +<p>These are the required and optional prerequisites:</p> +<ul> +<li>Ghostscript</li> +<li>pdftops from the xpdf suite, strongly recommended for better + pdf to PostScript conversions</li> +<li>Ruby 1.8.<i>x</i></li> +<li>Tcl/Tk is only required for the GUI interface. Only version 8.4 + has been tested.</li> +<li>Optional: viewers for PostScript and pdf</li> +</ul> -<p>Download Ghostscript and GSview from the <a -href="http://www.cs.wisc.edu/~ghost/">Ghostscript site.</a> -Ghostscript and GSview each come with a standard Windows setup -program.</p> +<p>You may not have to install all of these yourself.</p> -<p>You can get pdftops as part of the xpdf suite from the <a -href="http://www.foolabs.com/xpdf/">xpdf site.</a> 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.</p> +<h3>Linux</h3> -<p>The necessary Ruby components are already included in the setup -program.</p> +<p>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.</p> -<h3>Windows zipfile with separately installed Ruby</h3> +<h3>Mac OS X (Tiger and later)</h3> -<p>For Ghostscript, GSview and the xpdf suite, see above.</p> +<p>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 <a +href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/</a>.</p> -<p>You can get a <a -href="http://rubyforge.org/projects/rubyinstaller/">one-click Ruby -installer</a> from <a href="http://rubyforge.org/">Rubyforge.</a> -For Ruby version 1.8.4 and later you have to download and install -Tcl/Tk separately, in the form of <a -href="http://activestate.com/Products/ActiveTcl/">ActiveTcl.</a> If -you are only interested in the command-line version then you can -leave out ActiveTcl.</p> +<p>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.</p> -<h3>Unix/Linux</h3> +<h3>Windows (Windows 2000 and later)</h3> -<p>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.</p> +<dl> -<h3>Mac OS X</h3> +<dt>If you use the TeXLive package (2008 or later):</dt> <dd>Epspdf +and epspdftk will use Ghostscript and pdftops built into TeX +Live. You still need to download and install Ruby and optionally +Tcl/Tk.</dd> + +<dt>If you install from the setup program:</dt> <dd>This package +includes a subset of Ruby/Tk, but you have to provide Ghostscript +and pdftops yourself.</dd> + +<dt>If you use the zipfile:</dt> <dd>In this case, you have to +provide everything yourself.</dd> + +</dl> + + +<h3>URLs for the prerequisites</h3> + +<dl> + +<dt>Ghostscript and GSview (<a + href="http://pages.cs.wisc.edu/~ghost/">http://pages.cs.wisc.edu/~ghost/</a>)</dt> + <dd>Contains sources and Windows binaries. The Windows binaries + come with standard GUI Windows setup programs.</dd> + +<dt>XPDF (<a + href="http://www.foolabs.com/xpdf/">http://www.foolabs.com/xpdf/</a>)</dt> + <dd> 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. </dd> + +<dt>XPDF, Mac OS X binaries (<a + href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/</a>)</dt> + <dd>These are universal binaries.</dd> + +<dt>TeX Live (<a + href="http://www.tug.org/texlive/">http://www.tug.org/texlive/</a>)</dt> + <dd>TeX Live 2008 includes epspdf as an optional install. For + Windows, this version doesn't require external copies of pdftops + or Ghostscript.</dd> + +<dt>MacTeX (<a + href="http://www.tug.org/mactex/">http://www.tug.org/mactex/</a>)</dt> + <dd>MacTeX is based on TeX Live. Its set of add-ons includes + Ghostscript, and can be downloaded separately.</dd> + +<dt>The MacPorts Project (<a + href="http://www.macports.org/">http://www.macports.org/</a>)</dt> + <dd>MacTeX has Poppler- and xpdf packages either of which include + pdftops.</dd> + +<dt>Ruby one-click installer fro Windows (<a + href="http://rubyforge.org/projects/rubyinstaller/"> + http://rubyforge.org/projects/rubyinstaller/</a>)</dt> <dd>Current + versions (1.8.4 and later) require Tcl/Tk to be separately + installed.</dd> + +<dt>Old releases of Ruby one-click installer (<a + href="http://rubyforge.org/frs/?group_id=167"> + http://rubyforge.org/frs/?group_id=167</a>)</dt> <dd>Versions + prior to 1.8.4 include Tcl/Tk.</dd> + +<dt>Ruby source code (<a + href="http://www.ruby-lang.org/en/downloads/">http://www.ruby-lang.org/en/downloads/</a>)</dt><dd>For + those people who prefer to roll their own...</dd> + +<dt>ActiveTcl from ActiveState (<a + href="http://activestate.com/Products/ActiveTcl/"> + http://activestate.com/Products/ActiveTcl/</a></dt> <dd> Get + version 8.4, not 8.5.</dd> + +</dl> -<p>Ghostscript and xpdf are available via the <a -href="http://fink.sourceforge.net/">Fink Project</a>, in the Text -section.</p> - -<p>If you don't (want to) use Fink, you can download and -install Gerben Wierda's i-Installer from the <a -href="http://ii2.sourceforge.net/">i-Installer Home Page</a> and -then use the i-Installer to download and install the Ghostscript -i-package.</p> - -<p>There is -a <a -href="http://users.phg-online.de/tk/MOSXS/xpdf-tools-3.dmg">package</a> -for the xpdf suite -at <a -href="http://users.phg-online.de/tk/MOSXS/">http://users.phg-online.de/tk/MOSXS/.</a> -Or you can compile it yourself. You can download the source from -the <a href="http://www.foolabs.com/xpdf/">xpdf site</a>. 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.</p> - -<p>Ruby 1.8.2 and Ruby/Tk are part of Mac OS X Tiger. X11 needs to -be installed, although Ruby/Tk is <i>not</i> an X11 application. For -earlier versions of Mac OS X, you are on your own.</p> <h2><a name="install"/>Installation</h2> -<h3>Windows with setup program</h3> +<p>First make sure that the prerequisites are met. Then:</p> + +<h3>TeX Live 2008</h3> -<p>Download the <a href="epspdf.0.2.12.exe">epspdftk setup +<p>Use TeX Live's package manager tlmgr for installation.</p> + +<h3>Windows setup program</h3> + +<p>Download the <a href="epspdf.0.3.0.exe">epspdftk setup program.</a> 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.</p> <h3>Windows zipfile</h3> -<p>Download the <a href="epspdf.0.2.12.zip">epspdf zip file</a>, +<p>Download the <a href="epspdf.0.3.0.zip">epspdf zip file</a>, 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</p> @@ -166,11 +225,11 @@ on your path with the line</p> <h3>Unix/Linux</h3> -<p>Download the <a href="epspdf.0.2.12.tgz">tar.gz archive</a> and +<p>Download the <a href="epspdf.0.3.0.tgz">tar.gz archive</a> 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 <tt>epspdf</tt> such as</p> +epspdf.rb from the command-line, then create a shell script +<tt>epspdf</tt> such as</p> <pre> #!/bin/sh @@ -204,16 +263,18 @@ problem files.</p> <h3>Windows</h3> <p>Epspdftk will use the default Windows viewers for PostScript and -pdf. Without GSview, you probably won't be able to view PostScript +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.</p> <h3>Unix/Linux</h3> <p>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.</p> +viewers are xpdf, gpdf and acroread/Adobe Reader. You can also +specify a previewer manually in the configuration screen; see the +user guide, under <a href="epspdf_UG.html#configure">"The +configuration screen".</a>.</p> <h3>Mac OS X</h3> @@ -222,13 +283,13 @@ add it in the next release.</p> <h2><a name="files"/>Files</h2> <ul> -<li><a href="epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a> preferred for Unix +<li><a href="epspdf.0.3.0.tgz">epspdf.0.3.0.tgz</a> preferred for Unix and Mac OS X</li> -<li><a href="epspdf.0.2.12.zip">epspdf.0.2.12.zip</a> preferred for +<li><a href="epspdf.0.3.0.zip">epspdf.0.3.0.zip</a> preferred for Windows</li> -<li><a href="epspdf.0.2.12.exe">epspdf.0.2.12.exe</a> Windows setup +<li><a href="epspdf.0.3.0.exe">epspdf.0.3.0.exe</a> Windows setup program, including Ruby/Tk subset</li> <li><a href="epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a> Mac OS X @@ -237,6 +298,12 @@ applet for starting epspdftk.rb</li> <h3>Older releases</h3> <ul> +<li><a href="epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a> for Unix +and Mac OS X</li> +<li><a href="epspdf.0.2.12.zip">epspdf.0.2.12.zip</a> for +Windows</li> +<li><a href="epspdf.0.2.12.exe">epspdf.0.2.12.exe</a> Windows setup + program</li> <li><a href="epspdf.0.2.11.tgz">epspdf.0.2.11.tgz</a> for Unix and Mac OS X</li> <li><a href="epspdf.0.2.11.zip">epspdf.0.2.11.zip</a> for @@ -251,25 +318,16 @@ Windows</li> program</li> </ul> -<h2><a name="supporting"/>Supporting software</h2> - -<ul> -<li><a href="http://www.cs.wisc.edu/~ghost/">Ghostscript and - GSview</a></li> -<li><a href="http://www.foolabs.com/xpdf/">XPDF</a></li> -<li><a href="http://users.phg-online.de/tk/MOSXS/">OS X - binary for xpdf/pdftops</a></li> -<li><a href="http://rubyforge.org/projects/rubyinstaller/">Ruby one-click - installer</a></li> -<li><a href="http://ruby-lang.org/">Ruby Home Page</a></li> -<li><a -href="http://activestate.com/Products/ActiveTcl/">ActiveTcl</a></li> -</ul> - <h2><a name="releases"/>Releases</h2> -<dl> -<dt>0.2.12</dt><dd>Current version. Bug fixes: log rotation now +<dl> <dt>0.3.0</dt><dd>Current version. Under Windows, now +recognizes whether it is embedded in TeX Live 2008 and then uses +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.</dd> + +<dt>0.2.12</dt><dd>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 @@ -289,24 +347,15 @@ sessions).</dd><dd>Changes in documentation.</dd> <dt>0.2.01</dt><dd>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.</dd><dd>Epspdf.app is now <a -href="epspdf_app.0.2.01.zip">packaged separately</a>, under Mac OS +$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.</dd> <dt>0.2</dt><dd>Original release</dd> </dl> -<h2><a name="todo"/>To do</h2> - -<ul> -<li>Artwork</li> -<li>GUI for some pdftops options</li> -<li>Proper help</li> -<li>Support for bitmapped formats (maybe)</li> -</ul> - <hr/> -<p class="fineprint">Last revised: November 20, 2006</p> +<p class="fineprint">Last revised: July 27, 2008</p> </body></html> |