summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/epspdf/index.html
diff options
context:
space:
mode:
authorSiep Kroonenberg <siepo@cybercomm.nl>2010-03-29 10:43:59 +0000
committerSiep Kroonenberg <siepo@cybercomm.nl>2010-03-29 10:43:59 +0000
commite2f24386f207b8ca102a8a3535dd91ed99d7a7e1 (patch)
treecacea5e2f05f62cfa127c7e55852fcf7b0bb6611 /Master/texmf-dist/doc/support/epspdf/index.html
parent94f4030050e1d0cbad1ee1f93076439592593b93 (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.html210
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>
-"&lt;path_to_ruby.exe&gt;" "&lt;path_to_epspdf.rb&gt;" %*
+ruby "&lt;path_to_epspdf.rb&gt;" %*
</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 "&lt;path_to_epspdftk.tcl&gt;" %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 &lt;TeX
-Live root&gt;\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>