diff options
author | Karl Berry <karl@freefriends.org> | 2018-09-08 21:41:40 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-09-08 21:41:40 +0000 |
commit | 80b28c052dd903d1c5c60a1faafd530bec8f5e45 (patch) | |
tree | abfbd5f51a0c77909ccb703f62dfbbeed6f05654 /Master/texmf-dist/doc | |
parent | 3c44afcf87fb8597bb6da350f1777c8bf5b14517 (diff) |
thumbpdf (8sep18)
git-svn-id: svn://tug.org/texlive/trunk@48625 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/generic/thumbpdf/README | 75 |
1 files changed, 69 insertions, 6 deletions
diff --git a/Master/texmf-dist/doc/generic/thumbpdf/README b/Master/texmf-dist/doc/generic/thumbpdf/README index 78f0e51d077..8cfa320058d 100644 --- a/Master/texmf-dist/doc/generic/thumbpdf/README +++ b/Master/texmf-dist/doc/generic/thumbpdf/README @@ -1,4 +1,4 @@ -README for project thumbpdf 2014/07/15 v3.16 +README for project thumbpdf 2018/09/07 v3.17 TABLE OF CONTENTS ================= @@ -345,25 +345,37 @@ F. USER INTERFACE * Additional thumbnails: `<jobname>.tno' If `<jobname>.tno' is found, the thumbnails are automatically included by the program `thumbpdf.tex'. - Format of this file: + Format of this file:# + +``` \thumb{filename without `.png' extension}% or \thumb[name]{filename with/without extension} +``` + Examples: + +``` \thumb{one}% --> \thisthumb{one}, recommended \thumb{one.png}% --> \thisthumb{one.png} \thumb[two]{one}% --> \thisthumb{two} \thumb[one]{./extrathumb/one.png}% --> thisthumb{one} - The first example shows that the `.png' extension +``` + +The first example shows that the `.png' extension is supported and recommended. But `.jpg' or `.tif' files also work. This data can be included in the main tex file that includes `thumbpdf.sty' with the \DeclareThumbs feature: - \usepackage{thumbpdf}% or \input thumbpdf.sty + +``` +\usepackage{thumbpdf}% or \input thumbpdf.sty \DeclareThumbs{ \thumb{one} \thumb[two]{./extra/two.jpg} } - Then the file `\jobname.tno' is written with the thumbnail +``` + +Then the file `\jobname.tno' is written with the thumbnail declarations. (LaTeX's \nofiles is respected.) * Program `thumbpdf.tex' Execept for debugging there is no reason for an user to call it @@ -403,12 +415,15 @@ G. AUTHOR ========= Heiko Oberdiek Email: heiko.oberdiek at googlemail.com + ho-tex at tug.org H. QUESTIONS, SUGGESTED IMPROVEMENTS ==================================== If you have questions, problems with `thumbpdf', error reports, if you have improvements or want to have additional features, -please send them to the author. +please send them via github issues: +https://github.com/ho-tex/thumbpdf/issues + Other ps->pdf routes: * pstill: I did not succeed. It seems that the used pdfmark specials @@ -458,54 +473,68 @@ I. KNOWN PROBLEMS J. HISTORY ========== + 1999/02/14 v1.0 first release + 1999/02/23 v1.1 * Bug in thumbpdf.sty removed (#2->#1). * New option in thumbpdf.pl: --resolution. * Automatic calculation of the resolution for Ghostscript (max. size 106x106). + 1999/03/01 v1.2 * Optimizition: indirect objects for length values removed. + 1999/03/12 v1.3 * Copyright: LPPL + 1999/05/05 v1.4 * Detecting of cygwin-perl. * Save memory by sharing `RGB' objects (devices: png16, png256). + 1999/06/13 v1.5 * Gs detection extended (thumbpdf.pl). * Installation part of readme.txt rewritten and table of contents added. + 1999/07/27 v1.6 * Bug in thumbpdf.sty fixed (handling of \pdfpageattr). * Warning if there are missing thumbs (thumbpdf.sty). * Added section `Known Problems' in `readme.txt'. + 1999/08/08 v1.7 * Bug in thumbpdf.sty fixed. This bug was introduced in version 1.6, therefore this version should not be used. * Adaptation for pdfTeX version 0.14a. * LPPL 1.1 + 1999/09/09 v1.8 * Bug in thumbpdf.sty fixed. \PackageWarning cannot be used in \shipout, because \protect has been set to \noexpand (mysterious LaTeX behaviour?). + 1999/09/16 v1.9 * The perl script now detects direct /Length objects, that pdfTeX uses including JPEG images. + 2000/01/11 v1.10 * Bug in /Length detection removed. * Direct /Length in RGB objects supported. * \immediate before \pdfximage removed. * thumbpdf.sty revised. + 2000/01/19 v1.11 * Small fix for perl versions that cannot handle "my" in "for" loops. * LPPL 1.2 + 2000/02/11 v1.12 (not released) * Option `clean' added. * `<jobname>.tnd' replaces `thumbpdf.tex', if thumbpdf is called: thumbpdf [options] <jobname>[.pdf] * `<jobname>.tno' can be used instead of `thumbopt.tex'. * \DeclareThumbs added. + 2000/02/22 v2.0 * Support for the dvips/ps2pdf route by pdfmark specials. * Temporary files are removed. @@ -514,32 +543,40 @@ J. HISTORY thumbdta.tex ==> <jobname>.tpt, <jobname>.tpm added thumbopt.tex ==> <jobname>.tno * Syntax change: <jobname> is now required. + 2000/02/28 v2.1 * Environment variable `THUMBPDF' supported. * `thumbpdf.cfg' supported. * TDS place for readme.txt: texmf/doc/generic/thumbpdf/readme.txt * Errors in `readme.txt' corrected. + 2000/03/07 v2.2 * Support for Distiller 3 and 4, the streams are uncompressed. * Call of gs is changed in order to show the currently processed page number of the pdf file. * Option --printgscmd creates the command line file `thumbpdf.gs' for the Ghostscript call. + 2000/03/22 v2.3 * Bug fix: --useps now works. + 2000/04/10 v2.4 * Fix for ActiveState Perl 5.6.0: uc line changed, fork removed. (Thanks to Andreas Buehmann <andreas.buehmann@gmx.de>.) * Test of `thumbpdf.tex' version. + 2000/07/29 v2.5 * Save trick in call of ghostscript. * Undocumented option --gspages added. * Problem with ActiveState perl 5.6.0 (win32) added to section "Known Problems". + 2000/09/27 v2.6 * Information about ActiveState perl 5.6.0 updated. + 2000/10/27 v2.7 * -dFIXEDMEDIA=0 added in gs call. + 2001/01/12 v2.8: * Bug fix in dvips mode and active option `level2': pack parameter corrected for little-endian machines. @@ -550,19 +587,24 @@ J. HISTORY * Ghostscript uses the MediaBox for calculating the page size. For version 6.50 a patch is added to use the /CropBox instead. + 2001/03/29 v2.9: * Option --password added. + 2001/04/02 v2.10: * Small corrections in readme.txt, contributed by Michael Wiedmann. + 2001/04/26 v2.11: * Option --antialias added (suggestion of Juergen Bausa). * This version is not released. + 2002/01/11 v3.0: * Syntax of option --antialias changed. The option is enabled as default, so that the ghostscript step is now slower. * Support for VTeX's PS mode added. * Greek mode added (experimental). * Signal handlers added for cleanup. + 2002/05/26 v3.1: * SIG_HUP unkown in Windows. * Bug fix: The signal function for __DIE__ "cleanup" aborts @@ -572,44 +614,65 @@ J. HISTORY removed from list. "vtexpdfmark" was detected, "vtex" did not work and perhaps it will be used later for VTeX in PDF mode. + 2002/05/26 v3.2: * Fix: "MacOS/X: darwin" is now not interpreted as Windows. + 2003/03/19 v3.3: * Fix for gs 8.00 in mode dvips: THB_DistillerPatch also applied to ghostscript >= 8.00. + 2003/06/06 v3.4: * Bug fix, two forgotten "pop"s added for Distiller case. + 2004/10/24 v3.5: * Revert Cygwin detection: is unix (request by Jan Nieuwenhuizen). * LPPL 1.3. + 2004/11/19 v3.6: * Bug fix for dvips mode and gs < 8.00 (/stackunderflow in pop). + 2004/11/19 v3.7: * For easier debugging, the special thumbpdf objects are now valid PDF objects that are referenced in the Catalog. * Remove of extra '\n' before "endstream" that is added by pdfTeX 1.20a. + 2005/07/06 v3.8: * Fix because of pdfTeX 1.30. + 2007/11/07 v3.9: * Deprecation warning of perl 5.8.8 fixed. + 2008/04/16 v3.10: * TDS archive `thumbpdf.tds.zip' provided. + 2010/07/07 v3.11: * \pdfcompresslevel=0 and \pdfminorversion=4 added for thumbpdf.tex. * \input is used with file name extension for "thumbpdf.tex". * Warning if \pdfobjcompresslevel>0. + 2011/08/09 v3.12: * Support for LuaTeX added. + 2011/08/10 v3.13: * Use gswin64c in Windows with 64 bits. * Fix of version date of thumbpdf.sty. + 2012/04/09 v3.14: * Fix for plain TeX compatibility (offending \RequirePackage). + 2012/04/18 v3.15: * Option --version added. * File `readme.txt' renamed to `README'. + 2014/07/15 v3.16 * Patch for `thumbpdf.pl' by Norbert Preining because of pdfTeX 1.40.15 (TeX Live 2014). + +2018/09/07 v3.17 + * Move to ho-tex github organisation + https://github.com/ho-tex/thumbpdf + * Patch for `thumbpdf.pl' by David Carlisle for new perl { regex handling + * Update warning messages for Oberdiek bundle issue 46 from Karl Berry |