diff options
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/index.html')
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/index.html | 386 |
1 files changed, 83 insertions, 303 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/index.html b/Master/texmf-dist/doc/support/epspdf/index.html index 5e8cd48eb9e..7c6d18d0d15 100644 --- a/Master/texmf-dist/doc/support/epspdf/index.html +++ b/Master/texmf-dist/doc/support/epspdf/index.html @@ -31,16 +31,17 @@ dot nl</tt></i></p> <p><a href="http://tex.aanhet.net/epspdf/">Current online version of this page</a></p> +<p><a href="http://tex.aanhet.net/epspdf/legacy.html">Legacy +Ruby-based versions</a></p> + <h2>Table of Contents</h2> <ul> <li><a href="#features">Features</a></li> <li><a href="#prerequisites">Prerequisites</a></li> <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="#releases">Releases</a></li> -<li><a href="epspdf.pdf">User Manual</a></li> </ul> <h2><a name="features"/>Features</h2> @@ -52,11 +53,10 @@ this page</a></p> <li>Also converts from pdf back to PostScript and eps</li> <li>Removal of preview headers from eps files</li> <li>Cropping extra whitespace</li> -<li>Grayscaling (sometimes)</li> +<li>Grayscaling</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 and Unix/Linux</li> <li>Support for TeX Live and MiKTeX</li> </ul> @@ -72,23 +72,24 @@ GUI.</p> <p>Epspdftk adds a GUI, with buttons to select options and with dialogs for opening and saving files.</p> -<p>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.</p> +<p>A lot more can be done with multistep conversions: grayscaling, +page selection, computing a tight boundingbox. People who depend on +PSTricks will appreciate the option to go from pdf to +PostScript.</p> + +<p>Where it makes sense, epspdf uses additional software for a +better outcome.</p> -<p>The command-line program epspdf is written in Ruby. Epspdftk, its -GUI companion, in Tcl/Tk. Versions prior to 0.5 were written in -Ruby/Tk.</p> +<p>The command-line program epspdf is written in texlua, which is +already part of recent versions of MikTeX and TeX Live. Versions <a +href="http://tex.aanhet.net/epspdf/legacy.html">prior to 0.6</a> +were written in Ruby. Epspdftk, its GUI companion, is written in in +Tcl/Tk.</p> -<p>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.</p> +<p>Starting with the 2008 edition, TeX Live includes epspdf in some +form as an optional package, complete with wrapper scripts epspdf +and epspdftk which can be called from the command-line without +further ado.</p> <p>There is also a third-party LaTeX package epspdfconversion which uses epspdf for on-the-fly conversion of eps graphics to pdf, with @@ -100,159 +101,75 @@ ado.</p> <p>These are the required and optional prerequisites, which will be checked for when epspdf starts:</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> or 1.9.<i>x</i></li> -<li>Tcl/Tk is only required for the GUI interface. Versions 8.4 - and 8.5 have been tested.</li> -<li>Optional: viewers for PostScript and pdf</li> -</ul> - -<p>You may not have to install all of these yourself.</p> - -<h3>Linux</h3> - -<p>On a current Linux distribution you can almost certainly install -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.</p> - -<h3>Mac OS X</h3> - -<p><b>Note.</b> Version 0.5.x has not been tested with Tiger.</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>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.</p> - -<h3>Windows (Windows 2000 and later)</h3> - -<p>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 takes care of the Ruby- -and Tcl/Tk requirements. See the table below:</p> - -<table id="prereq"> - - <thead><tr><th class="fcol">TeX - distribution</th><th>Installer</th><th>Zipfile</th></tr></thead> - - <tfoot> - <tr><td colspan="3"><b><a name="tlnote" - class="fineprint"> (1)</a></b> 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.</td></tr> - - <tr><td colspan="3"><b><a name="tlzipnote" - class="fineprint"> (2)</a></b> 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 and Tcl/Tk.</td></tr> - </tfoot> - - <tr><th class="fcol">TeX Live<a href="#tlnote">(1)</a></th><td>No additional - requirements</td> <td>Ruby, Tcl/Tk<a href="#tlzipnote">(2)</a></td></tr> - - <tr><th class="fcol">MiKTeX</th><td>Pdftops (optional)</td> <td>Pdftops - (optional); Ruby, Tcl/Tk(optional)</td></tr> - - <tr><th class="fcol">Other/None</th><td>Ghostscript, pdftops (optional)</td> - <td>Ghostscript; pdftops(optional), Ruby, Tcl/Tk - (optional)</td></tr> - -</table> - -<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 pdftops, Ghostscript and - optionally epspdf.</dd> +<li>A recent TeX installation, either <a + href="http://www.tug.org/texlive/">TeX Live</a> or <a + href="http://miktex.org/">MikTeX</a>. If this is not an option, + get a <a href="http://tex.aanhet.net/epspdf/legacy.html">legacy + version</a> of epspdf instead.</li> -<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> +<li><a href="http://ghostscript.com">Ghostscript</a></li> -<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> +<li>Optional: pdftops from the <a + href="http://www.foolabs.com/xpdf/">xpdf suite</a> or from the <a + href="http://poppler.freedesktop.org/">Poppler + utilities</a>. Pdftops may do a better job of preserving scalable + fonts when converting from pdf to ps.</li> -<dt>Ruby one-click installer for Windows (<a - href="http://rubyforge.org/projects/rubyinstaller/"> - http://rubyforge.org/projects/rubyinstaller/</a>)</dt> +<li><a href="http://www.tcl.tk/">Tcl/Tk</a> for the GUI + interface. Versions 8.4 and 8.5 have been tested. A single-file <a + href="http://wiki.tcl.tk/52">TclKit</a> runtime is + sufficient. Recent <a + href="http://www.patthoyts.tk/tclkit/win32-ix86/">Windows + precompiled tclkit binaries</a> are available.</li> -<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> +<li>Optional: viewers for PostScript and pdf</li> -<dt>Tcl Developer Xchange (<a href="http://www.tcl.tk/">http://www.tcl.tk/</a>)</dt> +</ul> -<dt>ActiveTcl from ActiveState (<a - href="http://activestate.com/Products/ActiveTcl/"> - http://activestate.com/Products/ActiveTcl/</a></dt> -</dl> +<p>On Windows, both MikTeX and TeX Live already include a copy of +Ghostscript. TeX Live for Windows also includes pdftops.</p> +<p>If you have MiKTeX and a copy of pdftops.exe, then you can point +epspdf to this file from within the GUI. You need to do this only +once.</p> <h2><a name="install"/>Installation</h2> -<p>First make sure that the prerequisites are met. Then:</p> +<p>If you have a sufficiently recent standalone TeX Live, just + install the package. Otherwise:</p> -<h3>TeX Live ≥ 2008</h3> +<h3>Unix/Linux</h3> -<p>Use TeX Live's package manager tlmgr for installation.</p> +<p>Unpack the archive somewhere and create symlinks to epspdf.tlu + and epspdftk.tcl in a directory on your searchpath.</p> <h3>Windows setup program</h3> -<p>Download the <a href="epspdf.0.5.3.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> +<p>This is a conventional Windows installer. If it does not find +texlua.exe on the searchpath then it gives a warning and a chance to +abort. It creates a shortcut to the epspdftk GUI and it also creates +an uninstaller.</p> + +<p>It installs epspdftk in the form of a so-called +<em>starpack</em>, which +consists of the epspdftk script and a Tcl/Tk runtime, wrapped into +a single file. The command-line script epspdf.tlu remains a separate +file.</p> -<p>The setup program has been created -with <a href="http://nsis.sourceforge.net/">NSIS</a>.</p> +<p>This installer has been created with <a +href="http://nsis.sourceforge.net/">NSIS</a>.</p> <h3>Windows zipfile</h3> -<p>Download the <a href="epspdf.0.5.3.zip">epspdf zip file</a>, -unpack it somewhere and create a batchfile epspdf.bat such as</p> +<p>Download the epspdf zip file, unpack it somewhere and create a +batchfile epspdf.bat such as</p> <pre> -ruby "<path_to_epspdf.rb>" %* +texlua "<path_to_epspdf.tlu>" %* </pre> -<p>for epspdf.rb, and a batchfile epspdftk.bat</p> +<p>for epspdf.tlu, and a batchfile epspdftk.bat</p> <pre> wish85 "<path_to_epspdftk.tcl>" %1 @@ -261,176 +178,39 @@ wish85 "<path_to_epspdftk.tcl>" %1 <p>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.</p> - -<p>Epspdf[tk] has been tested with Windows 2000, Windows XP and -Windows 7.</p> - -<h3>Unix/Linux</h3> - -<p>Download the <a href="epspdf.0.5.3.tgz">tar.gz archive</a> and -unpack it in some directory. If you plan to use epspdf.rb from the -command-line, create a symlink to <tt>epspdf.rb</tt> somewhere on -your searchpath.</p> - -<p>You can do the same for epspdftk. The first command-line -parameter will be interpreted as startup directory for the file -browser.</p> - -<h3>Mac OS X</h3> - -<p>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 <q>app</q>. Double-click once to expand, a second time to -mount, then drag epspdftk.app to the Applications folder.</p> - -<p>Epspdf mostly duplicates functionality of Preview. But having an -alternate conversion engine means that you can have another shot at -problem files.</p> - -<h2><a name="preview"/>Preview programs</h2> + sure that wish85 and these batchfiles are on your searchpath.</p> -<h3>Windows</h3> - -<p>Epspdftk will use the default Windows programs for PostScript and -pdf.</p> - -<h3>Unix/Linux</h3> - -<p>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 <a -href="epspdf.pdf"> user manual.</a>.</p> - -<h3>Mac OS X</h3> - -<p>Epspdftk uses the default pdf viewer under OS X, usually Preview -or Adobe Reader.</p> +<p>Epspdf[tk] has been tested with Windows XP, Windows 7 and +Windows 8.</p> <h2><a name="files"/>Files</h2> <ul> -<li><a href="epspdf.0.5.3.tgz">epspdf.0.5.3.tgz</a> preferred for Unix + + <li><a href="epspdf.0.6.03.tgz">epspdf.0.6.0.tgz</a> preferred for Unix and Mac OS X</li> -<li><a href="epspdf.0.5.3.zip">epspdf.0.5.3.zip</a> preferred for +<li><a href="epspdf.0.6.0.zip">epspdf.0.6.0.zip</a> preferred for Windows if you don't want to use the installer below</li> -<li><a href="epspdf.0.5.3.exe">epspdf.0.5.3.exe</a> Windows setup - program, including Ruby subset. The epspdftk script has been - packaged with a basic Tcl/Tk into a single exe file (starpack).</li> +<li><a href="epspdf.0.6.0.exe">epspdf.0.6.0.exe</a> Windows setup + program which installs epspdf with a buit-in Tcl/Tk runtime.</li> -<li><a href="epspdftk.0.5.3.dmg.gz">epspdftk.0.5.3.dmg.gz</a> - compressed disk image with epspdftk wrapped into a Mac OS X <q>app</q></li> </ul> -<h3>Older releases</h3> +<h2><a name="releases"/>Releases</h2> + <ul> -<li><a href="http://tex.aanhet.net/epspdf/epspdftk.0.4.3.dmg.gz">epspdftk.0.4.3.dmg.gz</a>; - GUI doesn't work on Snow Leopard</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.tgz">epspdf.0.4.3.tgz</a> -for Unix and Mac OS X</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.zip">epspdf.0.4.3.zip</a> -for Windows</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.4.3.exe">epspdf.0.4.3.exe</a> -Windows setup program</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdftk.0.4.2.dmg.gz">epspdftk.0.4.2.dmg.gz</a>; - tested on Tiger and Leopard</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.tgz">epspdf.0.3.0.tgz</a> -for Unix and Mac OS X</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.zip">epspdf.0.3.0.zip</a> -for Windows</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.3.0.exe">epspdf.0.3.0.exe</a> -Windows setup program</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.tgz">epspdf.0.2.12.tgz</a> -for Unix, including Mac OS X</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.zip">epspdf.0.2.12.zip</a> -for Windows</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.12.exe">epspdf.0.2.12.exe</a> -Windows setup program</li> -<li><a href="http:/tex.aanhet.net/epspdf/epspdf.0.2.01.tgz">epspdf.0.2.01.tgz</a> -for Unix - and Mac OS X</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.01.zip">epspdf.0.2.01.zip</a> -for Windows</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf.0.2.exe">epspdf.0.2.exe</a>, -Windows setup program</li> -<li><a href="http://tex.aanhet.net/epspdf/epspdf_app.0.2.01.zip">epspdf_app.0.2.01.zip</a> -Mac OS X applet for starting epspdftk.rb</li> -</ul> -<h2><a name="releases"/>Releases</h2> +<li>0.6.0 Current version. Command-line component +rewritten in texlua.</li> + +<li><a href="http://tex.aanhet.net/epspdf/legacy.html">Legacy +Ruby-based versions</a></li> -<dl><dt>0.5.3</dt><dd>Current version. Minor initialization fix for - Windows. The AppleScript wrapper for Mac OS X no longer starts a - terminal. For users of Linux/Unix, there is no reason to - upgrade.</dd> - -<dt>0.5.2</dt><dd>Under Unix, wrapper scripts can now be replaced - with simple symlinks.</dd> - -<dt>0.5.1</dt><dd>Bug fix for boundingbox atend.</dd> - -<dt>0.5</dt><dd>Ruby/Tk GUI replaced with Tcl/Tk GUI. Starpack - wrapper for Windows setup version.</dd> - -<dt>0.4.3</dt><dd>Fixes for compatibility with Ruby 1.9 and, under - Windows, for newer Ghostscript versions. Documentation - updates.</dd> - -<dt>0.4.2</dt><dd>More liberal documentation - license. Slight documentation updates.</dd> - -<dt>0.4.1</dt><dd>Documentation: added section on - bitmaps. Windows setup program: added missing Tcl/Tk - licenses. Mac: double-clickable epspdftk.app with included - epspdftk replaces double-clickable epspdf.app add-on.</dd> - -<dt>0.4.0</dt><dd>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 - <q>View with...</q> button; support for MikTeX's built-in - Ghostscript; streamlined Ruby subset, with Tcl/Tk compiled from - source.</dd> - -<dt>0.3.0</dt><dd>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.</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 changes in user - guide.</dd> - -<dt>0.2.11</dt><dd> Minor fixes. Changes in documentation.</dd> - -<dt>0.2.10</dt><dd>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.</dd> - <dd>The File Open dialog remembers the last directory visited - (between calls, not between program 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. 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> +</ul> <hr/> -<p class="fineprint">Last revised: February 27, 2011</p> +<p class="fineprint">Last revised: February 7, 2013</p> </body></html> |