diff options
author | Siep Kroonenberg <siepo@cybercomm.nl> | 2010-03-29 10:43:59 +0000 |
---|---|---|
committer | Siep Kroonenberg <siepo@cybercomm.nl> | 2010-03-29 10:43:59 +0000 |
commit | e2f24386f207b8ca102a8a3535dd91ed99d7a7e1 (patch) | |
tree | cacea5e2f05f62cfa127c7e55852fcf7b0bb6611 /Master/texmf-dist/doc/support/epspdf/index.html | |
parent | 94f4030050e1d0cbad1ee1f93076439592593b93 (diff) |
Epspdf rev. 0.5, documentation
git-svn-id: svn://tug.org/texlive/trunk@17605 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/epspdf/index.html')
-rw-r--r-- | Master/texmf-dist/doc/support/epspdf/index.html | 210 |
1 files changed, 97 insertions, 113 deletions
diff --git a/Master/texmf-dist/doc/support/epspdf/index.html b/Master/texmf-dist/doc/support/epspdf/index.html index 3503e71f931..5df7df22fca 100644 --- a/Master/texmf-dist/doc/support/epspdf/index.html +++ b/Master/texmf-dist/doc/support/epspdf/index.html @@ -12,14 +12,20 @@ </head><body> -<h1 class="display">Epspdf and epspdftk</h1> +<div id="pagehead"> -<p class="display">A multiplatform GUI- and command-line converter +<h1>Epspdf and epspdftk</h1> + +<p>A multiplatform GUI- and command-line converter for [e]ps and pdf.</p> -<p class="display"><i>Siep Kroonenberg,<br/><tt>siepo at cybercomm +<p><i>Siep Kroonenberg,<br/><tt>siepo at cybercomm dot nl</tt></i></p> +</div> + +<p id="logo"><img src="images/epspdf.png" alt=""/></p> + <p><a href="http://tex.aanhet.net/epspdf/">Current online version of this page</a></p> @@ -28,7 +34,6 @@ this page</a></p> <ul> <li><a href="#features">Features</a></li> <li><a href="#prerequisites">Prerequisites</a></li> -<li><a href="#rubytk">Ruby/Tk</a></li> <li><a href="#install">Installation</a></li> <li><a href="#preview">Preview programs</a></li> <li><a href="#files">Files</a></li> @@ -59,8 +64,8 @@ derivatives, eps and pdf are the preferred graphics formats.</p> <p>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.</p> +the convert utility from ImageMagick. But many users simply want a +GUI.</p> <p>Epspdftk adds a GUI, with buttons to select options and with dialogs for opening and saving files.</p> @@ -74,14 +79,20 @@ 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>The command-line program epspdf is written in Ruby. Epspdftk, -its GUI companion, in Ruby/Tk.</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>Starting with the 2008 edition, epspdf is included in TeX Live as -an optional package, complete with wrappers epspdf and +<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>There is also a third-party LaTeX package epspdfconversion which + uses epspdf for on-the-fly conversion of eps graphics to pdf, with + options to control grayscaling and boundingbox generation. See + CTAN or your TeX distribution.</p> + <h2><a name="prerequisites"/>Prerequisites</h2> <p>These are the required and optional prerequisites, which will be @@ -91,8 +102,8 @@ checked for when epspdf starts:</p> <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. The version (8.4 - or 8.5) must be supported by your Ruby.</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> @@ -101,47 +112,31 @@ checked for when epspdf starts:</p> <h3>Linux</h3> <p>On a current Linux distribution you can almost certainly install -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.</p> +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 (Tiger and Leopard)</h3> +<h3>Mac OS X</h3> -<p>Ruby, Tcl/Tk and Ruby/Tk are already part of Tiger and - Leopard.</p> +<p><b>Note.</b> Version 0.5 has not been tested with Tiger.</p> -<p>Ghostscript is included in MacTeX, but is also available via -e.g. MacPorts.</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 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>. 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 +<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>Mac OS X Snow Leopard</h3> - -<p>For Ghostscript and pdftops, see above.</p> - -<p>Unfortunately, in Snow Leopard Ruby's Tk bindings went missing, - so the GUI interface won't work with the built-in Ruby; - see <a href="#rubytk">below</a>. If you compile Ruby yourself - from <a href="http://www.ruby-lang.org/en/downloads/">source</a> - you get the Tk interface automatically. Call <tt>configure</tt> - with a <tt>--enable-pthread</tt> option.</p> - -<p>Snow Leopard's built-in Ruby is fine for command-line use and - on-the-fly conversions.</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 includes a partial Ruby -installation. See the table below:</p> +there is a special Windows installer which takes care of the Ruby- +and Tcl/Tk requirements. See the table below:</p> <table id="prereq"> @@ -162,17 +157,17 @@ installation. See the table below:</p> 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.</td></tr> + 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 1.8, Tcl/Tk(optional)</td></tr> + (optional); Ruby, Tcl/Tk(optional)</td></tr> <tr><th class="fcol">Other/None</th><td>Ghostscript, pdftops (optional)</td> - <td>Ghostscript; pdftops(optional), Ruby 1.8, Tcl/Tk + <td>Ghostscript; pdftops(optional), Ruby, Tcl/Tk (optional)</td></tr> </table> @@ -214,39 +209,19 @@ installation. See the table below:</p> <dt>Ruby one-click installer for 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> + http://rubyforge.org/projects/rubyinstaller/</a>)</dt> <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>Tcl Developer Xchange (<a href="http://www.tcl.tk/">http://www.tcl.tk/</a>)</dt> + <dt>ActiveTcl from ActiveState (<a href="http://activestate.com/Products/ActiveTcl/"> - http://activestate.com/Products/ActiveTcl/</a></dt> <dd> - Version 8.4 is the safer bet.</dd> + http://activestate.com/Products/ActiveTcl/</a></dt> </dl> -<h3><a name="rubytk">Ruby's Tk interface library</a></h3> - -<p>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.</p> -<p>I am working on a pure Tcl/Tk interface, <i>i.e.</i>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.</p> <h2><a name="install"/>Installation</h2> @@ -258,37 +233,43 @@ installation. See the table below:</p> <h3>Windows setup program</h3> -<p>Download the <a href="epspdf.0.4.3.exe">epspdftk setup +<p>Download the <a href="epspdf.0.5.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>The setup program has been created +with <a href="http://nsis.sourceforge.net/">NSIS</a></p>. + <h3>Windows zipfile</h3> -<p>Download the <a href="epspdf.0.4.3.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> +<p>Download the <a href="epspdf.0.5.zip">epspdf zip file</a>, +unpack it somewhere and create a batchfile epspdf.bat such as</p> <pre> -"<path_to_ruby.exe>" "<path_to_epspdf.rb>" %* +ruby "<path_to_epspdf.rb>" %* </pre> -<p>Similarly for epspdftk. With such a batchfile, the caller has to -take care of quoting:</p> +<p>for epspdf.rb, and a batchfile epspdftk.bat</p> + <pre> -epspdf "my file.eps" "my file.pdf" +wish85 "<path_to_epspdftk.tcl>" %1 </pre> +<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.4.3.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 create a shell script +<p>Download the <a href="epspdf.0.5.tgz">tar.gz archive</a> and +unpack it in some directory. If you plan to use epspdf.rb from the +command-line, create a shell script <tt>epspdf</tt> such as</p> <pre> @@ -304,16 +285,10 @@ browser.</p> <h3>Mac OS X</h3> -<p>You can install as for Unix/Linux. Here, too, all files should be -in the same directory.</p> - -<p>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. The current version has been created and tested -with Leopard. As pointed out <a href="#rubytk">above</a>, under Snow -Leopard the GUI program epspdftk will not work without a third-party -Ruby/Tk.</p> +<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 @@ -324,42 +299,48 @@ problem files.</p> <h3>Windows</h3> <p>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 <q>View -with...</q> button to select a viewer yourself.</p> +pdf.</p> <h3>Unix/Linux</h3> -<p>Supported PostScript viewers include evince, gv, gsview and +<p>Supported PostScript viewers include evince, gv and okular. These are also listed as pdf viewers. Additional pdf viewers -are xpdf, gpdf, epdfview and acroread/Adobe Reader. You can also +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 will always use the default pdf viewer under OS X, -usually Preview or Adobe Reader.</p> +<p>Epspdftk uses the default pdf viewer under OS X, usually Preview +or Adobe Reader.</p> <h2><a name="files"/>Files</h2> <ul> -<li><a href="epspdf.0.4.3.tgz">epspdf.0.4.3.tgz</a> preferred for Unix -and Mac OS X; GUI fails under OS X Snow Leopard with built-in Ruby</li> +<li><a href="epspdf.0.5.tgz">epspdf.0.5.tgz</a> preferred for Unix +and Mac OS X</li> -<li><a href="epspdf.0.4.3.zip">epspdf.0.4.3.zip</a> preferred for -Windows</li> +<li><a href="epspdf.0.5.zip">epspdf.0.5.zip</a> preferred for +Windows if you don't want to use the installer below</li> -<li><a href="epspdf.0.4.3.exe">epspdf.0.4.3.exe</a> Windows setup - program, including Ruby/Tk subset</li> +<li><a href="epspdf.0.5.exe">epspdf.0.5.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="epspdftk.0.4.3.dmg.gz">epspdftk.0.4.3.dmg.gz</a>; - built and tested on Leopard</li> +<li><a href="epspdftk.0.5.dmg.gz">epspdftk.0.5.dmg.gz</a> + compressed disk image with epspdftk wrapped into a Mac OS X <q>app</q></li> </ul> <h3>Older releases</h3> <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> @@ -387,9 +368,12 @@ Mac OS X applet for starting epspdftk.rb</li> <h2><a name="releases"/>Releases</h2> -<dl><dt>0.4.3</dt><dd>Current version. Fixes for compatibility with - Ruby 1.9 and, under Windows, for newer Ghostscript - versions. Documentation updates.</dd> +<dl><dt>0.5</dt><dd>Current version. 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> @@ -443,5 +427,5 @@ Mac OS X applet for starting epspdftk.rb</li> <hr/> -<p class="fineprint">Last revised: Januari 27, 2010</p> +<p class="fineprint">Last revised: March 29, 2010</p> </body></html> |