From 8f6599a9f86ce52e246d5595a68700551208ee9c Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 29 Apr 2010 23:56:27 +0000 Subject: epspdfconversion 0.6 (29apr10) git-svn-id: svn://tug.org/texlive/trunk@18048 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/epspdfconversion/README | 2 +- .../latex/epspdfconversion/epspdfconversion.pdf | Bin 443231 -> 461696 bytes .../example/epspdfconversion_docu.tex | 208 ++++++++++----------- .../epspdfconversion/example/optionstable.tex | 6 +- 4 files changed, 106 insertions(+), 110 deletions(-) (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/epspdfconversion/README b/Master/texmf-dist/doc/latex/epspdfconversion/README index 4904bae0642..8ad3f46af06 100644 --- a/Master/texmf-dist/doc/latex/epspdfconversion/README +++ b/Master/texmf-dist/doc/latex/epspdfconversion/README @@ -1,4 +1,4 @@ -This package facilitates the use of the epspdf tools (on +epspdfconversion.sty facilitates the use of the epspdf tools (on CTAN in pub/tex/support) from within PDFLaTeX. EPS graphic files are converted "on the fly". It is similar to and based on the epstopdf package and allows to pass several options diff --git a/Master/texmf-dist/doc/latex/epspdfconversion/epspdfconversion.pdf b/Master/texmf-dist/doc/latex/epspdfconversion/epspdfconversion.pdf index 43670fa618e..71177c1f426 100644 Binary files a/Master/texmf-dist/doc/latex/epspdfconversion/epspdfconversion.pdf and b/Master/texmf-dist/doc/latex/epspdfconversion/epspdfconversion.pdf differ diff --git a/Master/texmf-dist/doc/latex/epspdfconversion/example/epspdfconversion_docu.tex b/Master/texmf-dist/doc/latex/epspdfconversion/example/epspdfconversion_docu.tex index b13e175cc24..7deb81a42b0 100644 --- a/Master/texmf-dist/doc/latex/epspdfconversion/example/epspdfconversion_docu.tex +++ b/Master/texmf-dist/doc/latex/epspdfconversion/example/epspdfconversion_docu.tex @@ -1,12 +1,17 @@ - \documentclass[11pt]{scrartcl} \usepackage[T1]{fontenc} \usepackage[latin1]{inputenc} \usepackage{microtype} \usepackage[english]{babel} \usepackage{booktabs} -\usepackage{tabularx} +\usepackage{tabularx} +\usepackage[a4paper,left=1in,right=1in,top=1in,bottom=1in]{geometry}% For setting page dimensions / another option: landscape ,,left=1in,right=1in,top=1in,bottom=1in +\usepackage{fancyvrb} +\VerbatimFootnotes + +%\usepackage{multitoc} + %DRAWING, IMAGES \usepackage[final]{graphicx} @@ -20,13 +25,12 @@ %Anführungen mit \enquote{++++} \usepackage[babel,% -english= american, %american, +english=american, %american, german=quotes %, guillemets, swiss ]{csquotes} %DIMENSIONS -\usepackage[a4paper,left=1.3in,right=1.3in,top=1.3in,bottom=1.3in]{geometry}% \setlength{\parindent}{0mm} \addtolength{\parskip}{1mm} @@ -44,11 +48,10 @@ filecolor=black, menucolor=black, pagecolor=black, urlcolor=dunkelblau, -hypertexnames=true, -pdftitle = {The package epspdfconversion v0.5}, +pdftitle = {The package epspdfconversion v0.6}, pdfsubject = {documentation of the package epspdfconversion.sty }, -pdfkeywords = {epspdf, conversion, LaTeX, eps, eps->pdf}, -pdfauthor = {daniel.becker@uni-rostock.de} +pdfkeywords = {epspdf, epspdfconversion, LaTeX, eps, eps->pdf, images in pdflatex}, +pdfauthor = {d.becker@jpberlin.de} } \usepackage{ltxtable} @@ -76,23 +79,24 @@ pdfauthor = {daniel.becker@uni-rostock.de} \hypersetup{pageanchor=false} \title{The package {\pack}} -\author{Daniel Becker\\ \texttt{\href{mailto:daniel.becker@uni-rostock.de}{daniel.becker@uni-rostock.de}} +\author{Daniel Becker\\ \texttt{\href{mailto:d.becker@jpberlin.de}{d.becker@jpberlin.de}} \thanks{Many thanks to Siep Kroonenberg and Heiko Oberdiek for their help.} } -\date{2. September 2009, version 0.5} +\date{30. April 2010, version 0.6} + \maketitle \tableofcontents -\section{What is it for?} + + +\section{Purpose of \pack} This package enables the use of the epspdf tools (see \url{http://tex.aanhet.net/epspdf/}) from within (pdf)LaTeX \enquote{on the fly}. It is similar to and based on the epstopdf package that uses the script \verb"epstopdf" for the actual conversion while this packages uses \verb"epspdf" (Note the \verb"epsTOpdf" vs \verb"epspdf").\footnote{You might also want to read the documentation of epstopdf. See \url{http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/epstopdf.pdf}.} It is possible to pass several options to the \verb"epspdf" conversion-command. While this package can be used for the conversion of eps-files to pdf, the \verb"epspdf"-tools itself can do the conversion both ways.\footnote{It might be possible to add support for conversion like pdf->pdf or pdf->eps and so on. If you are interested, contact me.} -Use this package at your own risk.\footnote{I am by no means an {\TeX}pert. What I did is to take the epstopdf-package (\url{http://www.ctan.org/tex-archive/help/Catalogue/entries/epstopdf.html}) and adjusted it to my needs and then gave this the new name {\pack}. Heiko Oberdiek then improved the code a lot.} - I am using this package for the inclusion of eps-figures that are produced en-masse by a software packages like Stata, Mathematica or Maple and that are often updated. The package makes sure that I can include the eps-figures easily and the updating of the corresponding pdf's is done ``on-the-fly''. Using the \verb"epspdf"-tools (and not \verb"epstopdf") helps a lot to prepare a final pdf that is, for example, accepted by your print shop (really grayscale, prepress-ready, ...). \section{Installation} @@ -100,34 +104,28 @@ I am using this package for the inclusion of eps-figures that are produced en-ma If you are using a recent version of TeXLive ($\geqslant$ 2008), you can skip steps 1-4. \begin{enumerate} - \item Go to \url{http://tex.aanhet.net/epspdf/} and follow the installation instructions there. - - Alternative URL's for \verb"epspdf" are \\ \url{http://www.ctan.org/tex-archive/support/epspdf/} or\\ \url{http://www.ctan.org/tex-archive/help/Catalogue/entries/epspdf.html} - - See also Bruno Voisin's notes at \url{http://tug.org/pipermail/macostex-archives/2007-April/030318.html}. - - \item the package needs a recent version of the epstopf-package as a prerequisite, at least version 2.2. - - \item Make sure that you can use \verb"epspdf" from the command line. I am using Mac OS X. After the installation of epspdf (or with TeXLive / MacTeX $\geqslant$ 2008), the following command is working from the command line (assuming the file \verb"/Users/daniel/Desktop/testimage.eps" exists): +%%%%%%%%%%%%%% + \item Install \verb"epspdf": Go to \url{http://tex.aanhet.net/epspdf/} and follow the installation instructions there.\footnote{If you are using Windows and do not know how to install epspdf and use it from the command line: The trick is to create a batch-file \verb"epspdf.bat" and place it somewhere where windows can find it (in your path, similar to pdflatex.exe etc.). This file should contain the line\\ +\verb+ruby "" \%*+ \\ + where +\verb"path\_to\_epspdf.rb" + needs to replaced the path to epspdf that is valid in your machine, for example by +\verb"" +. If everything went ok, you should be able to execute the command epspdf from the command line in Windows (\enquote{Start > Programs > Accessories > Command Prompt}.} +%%%%%%%%%%%%%% +% \item the package needs a recent version of the epstopf-package as a prerequisite, at least version 2.2. +%%%%%%%%%%%%%% + \item Check your \verb"epspdf" installation: Make sure that you can use \verb"epspdf" from the command line. I am using Mac OS X. After the installation of epspdf (or with TeXLive / MacTeX $\geqslant$ 2008), the following command is working from the command line (assuming the file \verb"/Users/daniel/Desktop/testimage.eps" exists): \begin{verbatim} -macbook-daniel:~ daniel$ which epstopdf -/usr/texbin/epstopdf +macbook-daniel:~ daniel$ which epspdf +/usr/texbin/epspdf macbook-daniel:~ daniel$ epspdf /Users/daniel/Desktop/testimage.eps \end{verbatim} -It results in a file \verb"/Users/daniel/Desktop/testimage.pdf". - -I did no testing for other Systems (Windows,...) -- simply follow the instructions at the \verb"epspdf"-website. It would be nice if you let me know whether this package works for you.\footnote{The package seems to work as expected with a Linux/TeXLive2007 and with a Windows/MikTeX2.5 installation.} - \item Put the sty-file {\pack}.sty for this package where TeX can find it. For example in the same directory as your main .tex file. Or -- again on Mac OS X -- in \verb"~/Library/texmf/tex/latex/" where the \verb"~" stands for your home directory. +It results in a file \verb"/Users/daniel/Desktop/testimage.pdf". +%%%%%%%%%%%%%% + \item The package requires that shell-escape are enabled such that TeX is allowed to execute the command epspdf if needed. You should get a warning in your .log-file if this is not the case. Be aware that allowing that is a security risk. - If you are using MikTeX, you can use the package-manager to install \\{\pack}. If you are using a recent version of TeXLive, it is already included in your distribution. - \item The package requires that shell escapes are enabled. You should get a warning in your .log-file if this is not the case. - - - -However, a test with MikTeX and the command-line option -shell-escape resulted in the warning ``Package epstopdf Warning: Shell escape feature is not enabled.'' Try \verb"--enable-write18" if you are using MikTeX. Look for \enquote{shell escape} and \enquote{write18} in the Help-Section of your preferred application for Typesetting on how to enable it (TeXShop, WinEdt, ....). - - - +Enabling shell-escape means that you have to call pdflatex with additional options. In my case -- I use TeXShop on Mac OS X with MacTeX/TeXLive as the TeX-installation in the background -- the command specified for pdflatex is\\ \verb"pdflatex --file-line-error --shell-escape --synctex=1". If you are using MikTeX on Windows as TeX-installation, use \verb"--enable-write18" instead of \verb"--shell-escape". Look for \enquote{shell escape} and \enquote{write18} in the Help-Section of your preferred application for Typesetting on how to enable it (TeXShop, WinEdt, ....). \end{enumerate} \section{Usage} @@ -144,7 +142,7 @@ By default, if you include your eps-figure \emph{with} the \verb".eps" extension \begin{verbatim} \includegraphics[width=0.5\textwidth]{image.eps} \end{verbatim} -, there will be a conversion to pdf named \verb"image-epspdf-to.pdf" that is then used in your document. The next run will only call a conversion if the original .eps-file is newer (has been updated in the meanwhile). This is to save typesetting time. You can change this behaviour with the option \verb"update=false", see below. +, there will be a conversion of your \verb"image.eps"-file to a pdf-file named \verb"image-epspdf-to.pdf" that is then used in your document. The next run will only call a conversion if the original .eps-file is newer (has been updated in the meanwhile). This is to save typesetting time. You can change this behaviour with the option \verb"update=false", see below. If you insist on using \verb"\includegraphics" without the extension, as in \begin{verbatim} @@ -162,7 +160,7 @@ Package grfext Info: Graphics extension search list: (grfext) [.eps,.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF, .JPG,.JPEG,.JBIG2,.JB2] \end{verbatim} -This implies that image.eps is found first and used with a conversion to pdf is necessary. Complicated? Consider to use \verb"\includegraphics" with the extension, that avoids confusion which file actually makes it into you document. See options prepend, prefersuffix, update, suffix below and try to figure out how many different scenarios there are. +This implies that image.eps is found first and used with a conversion to pdf is necessary. Complicated? Consider to use \verb"\includegraphics" \emph{with} the extension. This avoids confusion which file actually makes it into your document. See options prepend, prefersuffix, update, suffix below and try to figure out how many different scenarios there are. Below, I include a figure \verb"testimage.eps" and another \verb"testimage-static.eps" with the following lines. @@ -176,9 +174,7 @@ Below, I include a figure \verb"testimage.eps" and another \verb"testimage-stati \section{Options} -{\pack} accepts several options. Table \ref{optiontable} gives an overview. The explanations are more or less taken from the documentationof epspdf and epstopdf. - - +{\pack} accepts several options. Table \ref{optiontable} gives an overview. The explanations are more or less taken from the documentation of epspdf and epstopdf. %Put the following code in your main document. store the table in an extra-tex-file named LongTable.tex that might live in a subfolder Tables @@ -225,14 +221,14 @@ For example, to restore the behaviour of the epstopdf-package, you could write This allows you to use whatever tool you want for your eps->pdf conversion. -\section{A test} - -What follows is the output of the \verb"\includegraphics"-command from page \pageref{bilderbefehle}. - - -\begin{center} -\includegraphics[width=0.5\textwidth]{image.eps} -\end{center} +%\section{A test} +% +%What follows is the output of the \verb"\includegraphics"-command from page \pageref{bilderbefehle}. +% +% +%\begin{center} +%\includegraphics[width=0.5\textwidth]{image.eps} +%\end{center} \section{Switching options temporarily} @@ -258,7 +254,7 @@ The figure \verb"image2.eps" will be exceptionally in color, other figures in gr \section{A note for users of latexmk} -latexmk is a perl script for running LaTeX, BibTex, Makeindex etc the correct number of times. See \url{http://www.phys.psu.edu/~collins/software/latexmk/}. It can be configured to run pdflatex if an eps-image has been updated (since version V. 3.21i). In your local configuration file, you should have something like this: +(pdf)latexmk is a perl script for running LaTeX, BibTex, Makeindex etc the correct number of times. See \url{http://www.phys.psu.edu/~collins/software/latexmk/}. It can be configured to run pdflatex if an eps-image has been updated (since version V. 3.21i) -- hence updating an eps-file is considered to be an update of the document. In your local configuration file, you should have something like this: \small \begin{verbatim} @@ -267,69 +263,71 @@ add_cus_dep('eps', 'pdf', 0, 'cus_dep_require_primary_run'); \end{verbatim} \normalsize -Note that both epstopdf and latexmk are under active development. Please check the latexmk-documentation to if you have difficulties with setting up a latexmk-configuration that works together with epstopdf and {\pack}. +This makes latexmk to pay attention for .eps-files. If they are updated, pdflatexmk triggers a run of pdflatex (uses the subroutine \verb+cus_dep_require_primary_run+) and {\pack} can do the necessary conversion of the file. -\section{--help of epstopdf} +Note that both epstopdf and latexmk are under active development. If you have difficulties to use latexmk together with {\pack}, please let me know. -The help of epspdf (version 0.4.1) reads: +%\section{--help of epstopdf} % -\small -\begin{verbatim} -macbook-daniel:~ daniel$ epspdf --help -Epspdf version 0.4.1 -Copyright (C) 2006, 2008, 2009 Siep Kroonenberg -Epspdf 0.4.0 -Convert between [e]ps and pdf formats -Usage: epspdf.rb [options] infile [outfile] - -Default for outfile is file.pdf if infile is file.eps or file.ps -Default for outfile is file.eps if infile is file.pdf - - -g, --gray, --grey Convert to grayscale; - success not guaranteed - -G, --GRAY, --GREY Try harder to convert to grayscale - -p, --pagenumber=PAGENUMBER Page to be converted or selected - -b, --bbox, --BoundingBox Compute tight boundingbox - -n, --no-hires Don't use hires boundingbox - -r, --hires Use hires boundingbox - -T, --target=TARGET Target use of pdf; one of - default, printer, prepress, screen, ebook - -N, --pdfversion=PDFVERSION Pdf version to be generated - -V, --version=PDFVERSION Deprecated; use `-N' or `--pdfversion'. - -I Ignore pdftops even if available - (default: use if available) - -U Use pdftops if available - (overrides previous -I setting) - -C, --custom=CUSTOMOPTIONS Custom options for conversion to pdf, - view Use.htm and ps2pdf.htm from - the Ghostscript documentation set - -P, --psoptions=PSOPTIONS Options for pdftops; default -level3, - don't include -eps or page number options; - these will be generated by the program - -i, --info Info: display detected filetype - -s Save (some) settings - -d Debug: don't remove temp files - - -v Prints version info - -h, --help Show this message -macbook-daniel:~ daniel$ -\end{verbatim} -\normalsize +%The help of epspdf (version 0.5) reads: +%% +%\small +%\begin{verbatim} +%Daniels-MacBook:~ danielb$ epspdf --help +%Epspdf version 0.5 +%Copyright (C) 2006, 2008, 2009, 2010 Siep Kroonenberg +%Convert between [e]ps and pdf formats +%Usage: epspdf.rb [options] infile [outfile] +% +%Default for outfile is file.pdf if infile is file.eps or file.ps +%Default for outfile is file.eps if infile is file.pdf +% +% -g, --gray, --grey Convert to grayscale; +% success not guaranteed +% -G, --GRAY, --GREY Try harder to convert to grayscale +% -p, --pagenumber=PAGENUMBER Page to be converted or selected +% -b, --bbox, --BoundingBox Compute tight boundingbox +% -n, --no-hires Don't use hires boundingbox +% -r, --hires Use hires boundingbox +% -T, --target=TARGET Target use of pdf; one of +% default, printer, prepress, screen, ebook +% -N, --pdfversion=PDFVERSION Pdf version to be generated +% -V, --version=PDFVERSION Deprecated; use `-N' or `--pdfversion'. +% -I Ignore pdftops even if available +% (default: use if available) +% -U Use pdftops if available +% (overrides previous -I setting) +% -C, --custom=CUSTOMOPTIONS Custom options for conversion to pdf, +% view Use.htm and ps2pdf.htm from +% the Ghostscript documentation set +% -P, --psoptions=PSOPTIONS Options for pdftops; default -level3, +% don't include -eps or page number options; +% these will be generated by the program +% -i, --info Info: display detected filetype +% -s Save (some) settings +% -d Debug: don't remove temp files +% --gui[=ACTION] Do not use; reserved for GUI +% +% -v Prints version info +% -h, --help Show this message +%\end{verbatim} +%\normalsize -\vfill +%\vfill +\small \section{Version-history, ToDo's} - - - - - - \begin{description} - \item[ToDo's] add support for ps->pdf, pdf->pdf / add support for tif and others in pdflatex via convert / add support for pdf-inclusion in latex (not pdf-latex) / add support for more file-types (tif, jpeg,...) in latex (not pdf-latex). Please report errors and missing features. + \item[Possible ToDo's] add support for ps->pdf, pdf->pdf / add support for tif and others in pdflatex via convert / add support for pdf-inclusion in latex (not pdf-latex) / add support for more file-types (tif, jpeg,...) in latex (not pdf-latex). Please report errors and missing features. + \item[v.0.6, 2010-04-30:] small improvements and documentation updates + \begin{itemize} + \item pdfversion now uses epspdf's --pdfversion. --version in epspdf is to print the version number of epspdf (currently, epspdf is at 0.5) + \item new author email + \item documentation updates +\end{itemize} \item[v.0.5, 2009-09-02:] this update makes use of changes in the epstopdf-package v2.2\begin{itemize} \item new options update,verbose,prefersuffix,suffix,outdir @@ -348,7 +346,7 @@ macbook-daniel:~ daniel$ \item The command \verb"\epspdfconversioncmdline" has been renamed to\\ \verb"\epspdfconversioncmdline". \item the documentation has been updated \end{itemize} - \item[v.0.2, 2007-09-21:] the package is now simply based on epstopdf. It essentially defines \verb"\@namedef{Gin@rule@.eps}#1{{pdf}{.pdf}{`\epspdfconversioncmdline #1}}" differently than epstopdf. The code has been cleaned up. Improvements of documentation and additional warning about pdfminorversion.... + \item[v.0.2, 2007-09-21:] the package is now simply based on epstopdf. It essentially defines \\ \verb"\@namedef{Gin@rule@.eps}#1{{pdf}{.pdf}{`\epspdfconversioncmdline #1}}" differently than epstopdf. The code has been cleaned up. Improvements of documentation and additional warning about pdfminorversion.... \item[v.0.1, 2007-09-21:] first try \end{description} diff --git a/Master/texmf-dist/doc/latex/epspdfconversion/example/optionstable.tex b/Master/texmf-dist/doc/latex/epspdfconversion/example/optionstable.tex index 041b8c17695..8db060e2ebb 100644 --- a/Master/texmf-dist/doc/latex/epspdfconversion/example/optionstable.tex +++ b/Master/texmf-dist/doc/latex/epspdfconversion/example/optionstable.tex @@ -21,11 +21,9 @@ option & explanation \\ \midrule \endhead % before a page break you will see: \midrule -\multicolumn{2}{r}{... to be continued on next page ....} \\ +\multicolumn{2}{r}{... continued on the next page ....} \\ \endfoot % when the tabloe ends, you will see: -\midrule -\multicolumn{2}{r}{(end of table)}\\ \bottomrule \endlastfoot %%%%% @@ -72,7 +70,7 @@ but you can also control the behaviour of epstopdf.sty by means of setting optio % \verb"prepend" | \verb"prepend=true" | \verb"prepend=false" & Determines whether .eps is appended (if false) or prepended (if true) to the Graphics extension search list. (default: false). (Note that there is no option append. Use \verb"prepend=false" instead.)\\ & \\ % -\verb"update" | \verb"update=true" | \verb"update=false" & The conversion program is only called, if the target file does not exist or is older than the source image file.\\ & \\ +\verb"update" | \verb"update=true" | \verb"update=false" & The conversion program is only called, if the target file does not exist or is older than the source image file. If false, the conversion is done with any run of pdflatex.\\ & \\ % \verb"verbose" | \verb"verbose=true" | \verb"verbose=false" & prints some information about the image in the .log file (default: true). \\ & \\ -- cgit v1.2.3