diff options
author | Karl Berry <karl@freefriends.org> | 2010-06-11 00:40:54 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-06-11 00:40:54 +0000 |
commit | 8e5e9bbf8afd30acf79e6efd665b94f96e697a2c (patch) | |
tree | 9aff24dd8b7590720074f63c7e71dbcb777afd10 | |
parent | 244448534b4d3c120613c54a49e271c396913e79 (diff) |
new latex pkg hrefhide 1.0b (10jun10)
git-svn-id: svn://tug.org/texlive/trunk@18882 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r-- | Master/texmf-dist/doc/latex/hrefhide/README | 152 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdf | bin | 0 -> 135496 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex | 172 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdf | bin | 0 -> 362030 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/hrefhide/ltxdoc.cfg | 103 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/hrefhide/hrefhide.drv | 91 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/hrefhide/hrefhide.dtx | 1136 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/hrefhide/hrefhide.ins | 124 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/hrefhide/hrefhide.sty | 104 | ||||
-rwxr-xr-x | Master/tlpkg/bin/tlpkg-ctan-check | 3 | ||||
-rwxr-xr-x | Master/tlpkg/libexec/ctan2tds | 1 | ||||
-rw-r--r-- | Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc | 1 | ||||
-rw-r--r-- | Master/tlpkg/tlpsrc/hrefhide.tlpsrc | 0 |
13 files changed, 1886 insertions, 1 deletions
diff --git a/Master/texmf-dist/doc/latex/hrefhide/README b/Master/texmf-dist/doc/latex/hrefhide/README new file mode 100644 index 00000000000..f7b39c5a9c7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hrefhide/README @@ -0,0 +1,152 @@ +README for hrefhide package, 2010/06/03, v1.0b + + +TABLE OF CONTENTS +================= + +1 Introduction +2 Download +3 Installation +4 Additional Packages +5 New Features +6 Package Compatibility +7 Authors/Maintainers +8 Bug Reports +9 Known Problems + + +1 INTRODUCTION +============== + +This package provides the command \hrefdisplayonly (instead +of \href). While the (hyperlinked) text appears like an +ordinary \href in the compiled pdf-file, the same text will +be "hidden" when printing the text. It is not really +invisible, but just has the same colour as the background +(default: white). Therefore the layout is not changed when +printing the document. + + +2 DOWNLOAD +========== + +`hrefhide' should become available on CTAN soon: + CTAN:macros/latex/contrib/muench/hrefhide/ + +Also a ZIP file is provided that contains the files, already +sorted in a TDS tree (should become available on CTAN soon): + CTAN:install/macros/latex/contrib/muench/hrefhide.tds.zip + +`CTAN:' means one of the `Comprehensive TeX Archive Network' +nodes or one of its mirrors. This is explained in + http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives + +The CTAN stuff will be mirrored automatically from the +ftp server, so + ftp://ftp.tug.org/pub/tex/muench/pagesLTS/ +corresponds to + CTAN:macros/latex/contrib/muench/pagesLTS/ + + +3 INSTALLATION +============== + +Installation with ZIP file in TDS format +---------------------------------------- +The ZIP file `hrefhide.tds.zip' contains the files sorted +in a TDS tree. Thus you can directly unpack the ZIP file +inside a TDS tree. +(See CTAN:tds.zip for an explanation of TDS.) +Example: + cd /...somewhere.../texmf + unzip /...downloadpath.../hrefhide.tds.zip +Do not forget to refresh the file name database of this +TDS tree. +Example: + texhash /...somewhere.../texmf + +Manual installation +------------------- +a) Download the hrefhide files from CTAN or the TUG server. + If necessary, unpack them. +b) If directory `beta' exists, replace the files by the + counterparts in this directory, if you want to use the + latest versions. +c) Generate the package and driver files: + tex hrefhide.ins +d) Install the files `*.sty', and `*.cfg' in your TDS tree: + cp *.sty *.cfg TDS:tex/latex/muench/hrefhide/ + Replace `TDS:' by the prefix of your TDS tree + (texmf directory). +e) Copy the documentation files to + "TDS:doc/latex/muench/hrefhide/": + README, hrefhide.pdf, hrefhide-example.tex, + hrefhide-example.pdf. +f) Update the databases if necessary, e. g. for teTeX: + mktexlsr .../texmf + + +4 ADDITIONAL PACKAGES +===================== + +Depending on the driver and option settings, hrefhide loads +other packages: +* color.sty (part of the graphics package bundle): + CTAN:macros/latex/required/graphics/color.dtx +* hyperref.sty: + CTAN:macros/latex/contrib/hyperref/hyperref.dtx +* kvoptions.sty: + CTAN:macros/latex/contrib/oberdiek/kvoptions.pdf +which again load other packages +(see the result of the \listfiles command in the log-file + of the example). + + +5 PACKAGE COMPATIBILITY +======================= + +hrefhide must be loaded AFTER package hyperref: + + Package loading order: + + \usepackage[ocgcolorlinks]{hyperref} + \usepackage{hrefhide} + + +6 AUTHOR/MAINTAINER +===================== + +* Hans-Martin Münch + + +7 BUG REPORTS +============== + +A bug report should contain: +* Comprehensive problem description. This includes error or + warning messages. + * \errorcontextlines=\maxdimen can be added in the + TeX code to get more informations in TeX error messages. +* Minimal test file that shows the problem, but does not + contain any unnecessary packages and code. +* Used drivers/programs. +* Version information about used packages and programs. + * If you are using LaTeX, then add "\listfiles". Then + a list of version informations is printed at the end + of the LaTeX run. +* Please no other files than the minimal test file. + The other files .log, .dvi, .ps, .pdf are seldom + necessary, so send them only on request. +* Please .zip or .tar.gz your file(s) before sending them! + +Bug address +----------- +Bug reports can be send to the maintainer: + Hans-Martin Münch + <Martin [dot] Muench [at] Uni-Bonn [dot] de> + + +8 KNOWN PROBLEMS +================= + +* as yet: none...
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdf b/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdf Binary files differnew file mode 100644 index 00000000000..38f811d910e --- /dev/null +++ b/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdf diff --git a/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex b/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex new file mode 100644 index 00000000000..c5f9d7b2638 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex @@ -0,0 +1,172 @@ +%% +%% This is file `hrefhide-example.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% hrefhide.dtx (with options: `example') +%% +%% This is a generated file. +%% +%% IMPORTANT NOTICE: +%% The package takes options. +%% +%% The usual disclaimers apply: +%% If it doesn't work right that's your problem. +%% (Nevertheless, send an e-mail to the maintainer +%% when you find an error in this package.) +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either +%% version 1.3c of this license or (at your option) any later +%% version. This version of this license is in +%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% and the latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3c or later is part of all distributions of +%% LaTeX version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status "maintained". +%% +%% The Current Maintainer of this work is H.-Martin Muench +%% (Martin dot Muench at Uni-Bonn dot de). +%% +%% This work consists of the main source file hrefhide.dtx +%% and the derived files +%% hrefhide.sty, hrefhide.pdf, hrefhide.ins, hrefhide.drv, +%% hrefhide-example.tex. +%% +\documentclass[british]{article} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\usepackage{lipsum}[2005/01/26]% v1.0 +\usepackage[ocgcolorlinks]{hyperref}[2010/05/13]% v6.81e +\hypersetup{extension=pdf,% + plainpages=false,% + pdfpagelabels=true,% + hyperindex=false,% + pdflang={en},% + pdftitle={hrefhide package example},% + pdfauthor={Hans-Martin Muench},% + pdfsubject={Example for the hrefhide package},% + pdfkeywords={LaTeX, hrefhide, Hans-Martin Muench},% + pdfview=Fit,pdfstartview=Fit,% + pdfpagelayout=SinglePage,% + bookmarksopen=true% +} +\usepackage[linktextcolour=black,backgroundcolour=white,pdfborder={0 0 1}]{hrefhide}[2010/06/03]% v1.0b +%% This are the default options. %% +\makeatletter +%% Code from tcilatex.tex, Macros for Scientific Word and Scientific WorkPlace 5.5 <06 Oct 2005> %% +%% Copyright (C) 2005 Mackichan Software, Inc. %% +%% That macro file is NOT proprietary and may be freely copied and distributed. %% + \def\unit#1{\mathord{\thinspace\rm #1}}% +%% End of code from tcilatex.tex %% +\makeatother +\listfiles +\begin{document} +\pagenumbering{arabic} +\section*{Example for hrefhide} + +This example demonstrates the use of package\newline +\textsf{hrefhide}, v1.0b as of 2010/06/03 (HMM).\newline +The used options were \texttt{linktextcolour=black}, +\texttt{backgroundcolour=white}, and \texttt{pdfborder={0 0 1}} +(the default ones).\newline +For more details please see the documentation!\newline + +\textit{Print-\textbf{preview} the first page of this document +and compare it with the page as displayed in your pdf reader.}\newline + +\noindent {\color{green} Save per page about $200\unit{ml}$ water, +$2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\newline +Therefore please print only if this is really necessary.\newline +Maybe already the print-preview or just printing +the first page are sufficient?}\newline + +\bigskip +Lorem ipsum dolor sit amet \href{\#target}{link to target} consectetuer +adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet +dolore magna aliquam erat volutpat. + +Ut wisi enim ad minim +veniam \hrefdisplayonly{\#target}{hidden link to target} quis nostrud +exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea +commodo consequat. + +Duis autem vel eum iriure dolor \href{\#target}{link to target} in +hendrerit in vulputate velit esse molestie consequat, vel illum dolore +eu feugiat nulla facilisis at vero eros et accumsan et iusto odio +dignissim qui blandit praesent luptatum zzril delenit augue +duis dolore te feugait nulla facilisi.\newline + +\noindent \textbf{\textsf{% +\hrefdisplayonly{\#RefA}{A} +\hrefdisplayonly{\#RefB}{B} +\hrefdisplayonly{\#RefC}{C} +\hrefdisplayonly{\#RefD}{D} +\hrefdisplayonly{\#RefE}{E} +\hrefdisplayonly{\#RefF}{F} +\hrefdisplayonly{\#RefG}{G} +\hrefdisplayonly{\#RefH}{H} +\hrefdisplayonly{\#RefI}{I} +\hrefdisplayonly{\#RefJ}{J} +\hrefdisplayonly{\#RefK}{K} +\hrefdisplayonly{\#RefL}{L} +\hrefdisplayonly{\#RefM}{M} +\hrefdisplayonly{\#RefN}{N} +\hrefdisplayonly{\#RefO}{O} +\hrefdisplayonly{\#RefP}{P} +\hrefdisplayonly{\#RefQ}{Q} +\hrefdisplayonly{\#RefR}{R} +\hrefdisplayonly{\#RefS}{S} +\hrefdisplayonly{\#RefT}{T} +\hrefdisplayonly{\#RefU}{U} +\hrefdisplayonly{\#RefV}{V} +\hrefdisplayonly{\#RefW}{W} +\hrefdisplayonly{\#RefX}{X} +\hrefdisplayonly{\#RefY}{Y} +\hrefdisplayonly{\#RefZ}{Z}}} \linebreak + +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit, +vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida +mauris. Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna. + +\pagebreak +{\Large \textbf{Targets}}\\ +Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam +nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat +volutpat. \hypertarget{target}{target text} Ut wisi enim ad minim +veniam, quis nostrud exerci tation ullamcorper suscipit lobortis +nisl ut aliquip ex ea commodo consequat. + +\section[A]{\hypertarget{RefA}{A}} \lipsum[1] +\section[B]{\hypertarget{RefB}{B}} \lipsum[1] +\section[C]{\hypertarget{RefC}{C}} \lipsum[1] +\section[D]{\hypertarget{RefD}{D}} \lipsum[1] +\section[E]{\hypertarget{RefE}{E}} \lipsum[1] +\section[F]{\hypertarget{RefF}{F}} \lipsum[1] +\section[G]{\hypertarget{RefG}{G}} \lipsum[1] +\section[H]{\hypertarget{RefH}{H}} \lipsum[1] +\section[I]{\hypertarget{RefI}{I}} \lipsum[1] +\section[J]{\hypertarget{RefJ}{J}} \lipsum[1] +\section[K]{\hypertarget{RefK}{K}} \lipsum[1] +\section[L]{\hypertarget{RefL}{L}} \lipsum[1] +\section[M]{\hypertarget{RefM}{M}} \lipsum[1] +\section[N]{\hypertarget{RefN}{N}} \lipsum[1] +\section[O]{\hypertarget{RefO}{O}} \lipsum[1] +\section[P]{\hypertarget{RefP}{P}} \lipsum[1] +\section[Q]{\hypertarget{RefQ}{Q}} \lipsum[1] +\section[R]{\hypertarget{RefR}{R}} \lipsum[1] +\section[S]{\hypertarget{RefS}{S}} \lipsum[1] +\section[T]{\hypertarget{RefT}{T}} \lipsum[1] +\section[U]{\hypertarget{RefU}{U}} \lipsum[1] +\section[V]{\hypertarget{RefV}{V}} \lipsum[1] +\section[W]{\hypertarget{RefW}{W}} \lipsum[1] +\section[X]{\hypertarget{RefX}{X}} \lipsum[1] +\section[Y]{\hypertarget{RefY}{Y}} \lipsum[1] +\section[Z]{\hypertarget{RefZ}{Z}} \lipsum[1] + +\end{document} +\endinput +%% +%% End of file `hrefhide-example.tex'. diff --git a/Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdf b/Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdf Binary files differnew file mode 100644 index 00000000000..72d3be11104 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdf diff --git a/Master/texmf-dist/doc/latex/hrefhide/ltxdoc.cfg b/Master/texmf-dist/doc/latex/hrefhide/ltxdoc.cfg new file mode 100644 index 00000000000..3ee1f5363d4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hrefhide/ltxdoc.cfg @@ -0,0 +1,103 @@ +%% +%% This is file `ltxdoc.cfg', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% hrefhide.dtx (with options: `ltxdoc') +%% +%% This is a generated file. +%% +%% IMPORTANT NOTICE: +%% The package takes options. +%% +%% The usual disclaimers apply: +%% If it doesn't work right that's your problem. +%% (Nevertheless, send an e-mail to the maintainer +%% when you find an error in this package.) +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either +%% version 1.3c of this license or (at your option) any later +%% version. This version of this license is in +%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% and the latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3c or later is part of all distributions of +%% LaTeX version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status "maintained". +%% +%% The Current Maintainer of this work is H.-Martin Muench +%% (Martin dot Muench at Uni-Bonn dot de). +%% +%% This work consists of the main source file hrefhide.dtx +%% and the derived files +%% hrefhide.sty, hrefhide.pdf, hrefhide.ins, hrefhide.drv, +%% hrefhide-example.tex. +%% +\NeedsTeXFormat{LaTeX2e}[1994/06/01] +\ProvidesFile{ltxdoc.cfg}[2010/06/01 v1.0 configuration file for hrefhide (HMM)] + %% Code from original ltxdoc.cfg [2007/01/08 latex-tds: ltxdoc.cls configuration (HO)], %% + % copyrighted 2006, 2007 Heiko Oberdiek, part of project `latex-tds'. + % That file may be distributed and/or modified under the + % conditions of the LaTeX Project Public License, either version 1.3 + % of this license or (at your option) any later version. + % The latest version of this license is in + % http://www.latex-project.org/lppl.txt + % and version 1.3c or later is part of all distributions of LaTeX + % version 2005/12/01 or later. + % That work has the LPPL maintenance status `maintained'. + % The Current Maintainer of that work is Heiko Oberdiek. + % + \PassOptionsToClass{a4paper}{article} + \AtEndOfClass{% + \RequirePackage[numbered]{hypdoc}[2010/03/26]% v1.9 + \pdfstringdefDisableCommands{% + \let\env\relax % longtable.dtx + \let\mytt\relax % tabularx.dtx + }% + \addtolength{\topmargin}{-10mm}% + \addtolength{\textheight}{20mm}% + % Depending on the page style, the head or foot area + % are put into the text area. + % Usually the page style is the default "plain". + % tools/verbatim.dtx uses "myheadings". + \def\string@plain{plain}% + \def\string@myheadings{myheadings}% + \def\current@pagestyle{plain}% + \let\ltxdoc@cfg@pagestyle\pagestyle + \def\pagestyle#1{% + \def\current@pagestyle{#1}% + \ltxdoc@cfg@pagestyle{#1}% + }% + \edef\ltxdoc@cfg@jobname{\jobname}% + \def\ltxdoc@cfg@longtable{longtable}% + \@onelevel@sanitize\ltxdoc@cfg@longtable + \ifx\ltxdoc@cfg@jobname\ltxdoc@cfg@longtable + \def\current@pagestyle{both}% + \fi + \let\ltxdoc@cfg@document\document + \def\document{% + \ifx\current@pagestyle\string@plain + \addtolength{\textheight}{\headheight}% + \addtolength{\textheight}{\headsep}% + \setlength{\headheight}{0pt}% + \setlength{\headsep}{0pt}% + \global\textheight\textheight + \global\headheight\headheight + \global\headsep\headsep + \fi + \ifx\current@pagestyle\string@myheadings + \addtolength{\textheight}{\footskip}% + \global\textheight\textheight + \fi + \ltxdoc@cfg@document + }% + %% End of code from original ltxdoc.cfg [2007/01/08 latex-tds: ltxdoc.cls configuration (HO)] %% + %% Place additional code here. %% + } + +\endinput +%% +%% End of file `ltxdoc.cfg'. diff --git a/Master/texmf-dist/source/latex/hrefhide/hrefhide.drv b/Master/texmf-dist/source/latex/hrefhide/hrefhide.drv new file mode 100644 index 00000000000..7578d0ff54e --- /dev/null +++ b/Master/texmf-dist/source/latex/hrefhide/hrefhide.drv @@ -0,0 +1,91 @@ +%% +%% This is file `hrefhide.drv', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% hrefhide.dtx (with options: `driver') +%% +%% This is a generated file. +%% +%% IMPORTANT NOTICE: +%% The package takes options. +%% +%% The usual disclaimers apply: +%% If it doesn't work right that's your problem. +%% (Nevertheless, send an e-mail to the maintainer +%% when you find an error in this package.) +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either +%% version 1.3c of this license or (at your option) any later +%% version. This version of this license is in +%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% and the latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3c or later is part of all distributions of +%% LaTeX version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status "maintained". +%% +%% The Current Maintainer of this work is H.-Martin Muench +%% (Martin dot Muench at Uni-Bonn dot de). +%% +%% This work consists of the main source file hrefhide.dtx +%% and the derived files +%% hrefhide.sty, hrefhide.pdf, hrefhide.ins, hrefhide.drv, +%% hrefhide-example.tex. +%% +\NeedsTeXFormat{LaTeX2e}[1994/06/01] +\ProvidesFile{hrefhide.drv}[2010/06/01 v1.0b% + Hiding hyperrefs when printing pdf files (HMM)]% +\documentclass{ltxdoc}[2007/11/11]% v2.0u +\usepackage{holtxdoc}[2010/04/24]% v0.19; yes, I know it is *private* additional ltxdoc support (HO) +%% hrefhide may work with earlier versions of LaTeX2e and those +%% class and package, but this was not tested. +%% Please consider updating your LaTeX, class, and package +%% to the most recent version (if they are not already the most +%% recent version). +%% Warning: holtxdoc, 2010/04/24 v0.19, requires the packages +%% hypdoc, 2010/03/26, v1.9 +%% hyperref, 2010/03/30, v6.80u (latest: 2010/05/13, v6.81e) +%% pdftexcmds, 2010/04/01, v0.9 +%% ltxcmds, 2010/03/09, v1.4 (latest: 2010/04/26, v1.7) +%% hologo, 2010/04/24, v1.2 +%% array (latest: 2008/09/09, v2.4c) +%% (or more recent versions) and does neither work with +%% nor check for earlier versions! +\hypersetup{% + pdfsubject={Hiding hyperrefs when printing pdf files (HMM)},% + pdfkeywords={LaTeX, hrefhide, hyperref, href, pdf, hide, print, Hans-Martin Muench},% + pdfencoding=auto,% + pdflang={en},% + breaklinks=true,% + linktoc=all,% + pdfstartview=FitH,% + pdfpagelayout=OneColumn,% + bookmarksnumbered=true,% + bookmarksopen=true,% + bookmarksopenlevel=3,% + pdfmenubar=true,% + pdftoolbar=true,% + pdfwindowui=true,% + pdfnewwindow=true% +} +\setlength\hfuzz{1pt} % Ignore slight overfulls. +\CodelineIndex +\EnableCrossrefs +\hyphenation{docu-ment} +\makeatletter +%% Code from tcilatex.tex, Macros for Scientific Word and Scientific WorkPlace 5.5 <06 Oct 2005> %% +%% Copyright (C) 2005 Mackichan Software, Inc. %% +%% That macro file is NOT proprietary and may be freely copied and distributed. %% + \def\unit#1{\mathord{\thinspace\rm #1}}% +%% End of code from tcilatex.tex %% +\makeatother +\begin{document} + \DocInput{hrefhide.dtx}% +\end{document} +\endinput +%% +%% End of file `hrefhide.drv'. diff --git a/Master/texmf-dist/source/latex/hrefhide/hrefhide.dtx b/Master/texmf-dist/source/latex/hrefhide/hrefhide.dtx new file mode 100644 index 00000000000..2761a992911 --- /dev/null +++ b/Master/texmf-dist/source/latex/hrefhide/hrefhide.dtx @@ -0,0 +1,1136 @@ +% \iffalse meta-comment +% +% hrefhide package +% file version: v1.0b +% file date: 2010/06/03 +% documentation date: 2010/06/03 +% +% Copyright (C) 2010 H.-Martin M\"{u}nch (Martin dot Muench at Uni-Bonn dot de) +% Portions of code copyrighted by other people as marked. +% +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either +% version 1.3c of this license or (at your option) any later +% version. This version of this license is in +% http://www.latex-project.org/lppl/lppl-1-3c.txt +% and the latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.3c or later is part of all distributions of +% LaTeX version 2005/12/01 or later. +% +% This work has the LPPL maintenance status "maintained". +% +% The Current Maintainer of this work is H.-Martin Muench. +% +% This work consists of the main source file hrefhide.dtx +% and the derived files +% hrefhide.sty, hrefhide.ins, hrefhide.drv, +% hrefhide-example.tex, hrefhide.pdf. +% +% Unpacking: +% (a) If hrefhide.ins is present: +% tex hrefhide.ins +% (b) Without hrefhide.ins: +% tex hrefhide.dtx +% (c) If you insist on using LaTeX +% latex \let\install=y\input{hrefhide.dtx} +% (quote the arguments according to the demands of your shell) +% +% Documentation: +% (a) If hrefhide.drv is present: +% (pdf)latex hrefhide.drv +% makeindex -s gind.ist hrefhide.idx +% (pdf)latex hrefhide.drv +% makeindex -s gind.ist hrefhide.idx +% (pdf)latex hrefhide.drv +% (b) Without hrefhide.drv: +% (pdf)latex hrefhide.dtx +% makeindex -s gind.ist hrefhide.idx +% (pdf)latex hrefhide.dtx +% makeindex -s gind.ist hrefhide.idx +% (pdf)latex hrefhide.dtx +% +% The class ltxdoc loads the configuration file ltxdoc.cfg +% if available. Here you can specify further options, e.g. +% use DIN A4 as paper format: +% \PassOptionsToClass{a4paper}{article} +% +% Programm calls to get the documentation (for example): +% pdflatex hrefhide.dtx +% makeindex -s gind.ist hrefhide.idx +% % makeindex -s gglo.ist -o hrefhide.gls hrefhide.glo +% pdflatex hrefhide.dtx +% makeindex -s gind.ist hrefhide.idx +% % makeindex -s gglo.ist -o hrefhide.gls hrefhide.glo +% pdflatex hrefhide.dtx +% +% Installation: +% TDS:tex/latex/muench/hrefhide/hrefhide.sty +% TDS:doc/latex/muench/hrefhide/hrefhide.pdf +% TDS:doc/latex/muench/hrefhide/hrefhide-example.tex +% TDS:source/latex/muench/hrefhide/hrefhide.dtx +% +%<*ignore> +\begingroup + \def\x{LaTeX2e}% +\expandafter\endgroup +\ifcase 0\ifx\install y1\fi\expandafter + \ifx\csname processbatchFile\endcsname\relax\else1\fi + \ifx\fmtname\x\else 1\fi\relax +\else\csname fi\endcsname +%</ignore> +%<*install> +\input docstrip.tex + +\obeyspaces +\Msg{******************************************************} +\Msg{* Installation *} +\Msg{* Package: hrefhide v1.0b 2010/06/03 LaTeX2e package *} +\Msg{* Hiding hyperrefs when printing pdf files (HMM) *} +\Msg{******************************************************} + +\keepsilent +\askforoverwritefalse + +\let\MetaPrefix\relax +\preamble + +This is a generated file. + +IMPORTANT NOTICE: +The package takes options. + +The usual disclaimers apply: +If it doesn't work right that's your problem. +(Nevertheless, send an e-mail to the maintainer + when you find an error in this package.) + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either +version 1.3c of this license or (at your option) any later +version. This version of this license is in + http://www.latex-project.org/lppl/lppl-1-3c.txt +and the latest version of this license is in + http://www.latex-project.org/lppl.txt +and version 1.3c or later is part of all distributions of +LaTeX version 2005/12/01 or later. + +This work has the LPPL maintenance status "maintained". + +The Current Maintainer of this work is H.-Martin Muench +(Martin dot Muench at Uni-Bonn dot de). + +This work consists of the main source file hrefhide.dtx +and the derived files + hrefhide.sty, hrefhide.pdf, hrefhide.ins, hrefhide.drv, + hrefhide-example.tex. + +\endpreamble +\let\MetaPrefix\DoubleperCent + +\generate{% + \file{hrefhide.ins}{\from{hrefhide.dtx}{install}}% + \file{hrefhide.drv}{\from{hrefhide.dtx}{driver}}% + \file{ltxdoc.cfg}{\from{hrefhide.dtx}{ltxdoc}}% + \usedir{tex/latex/muench/hrefhide}% + \file{hrefhide.sty}{\from{hrefhide.dtx}{package}}% + \usedir{doc/latex/muench/hrefhide}% + \file{hrefhide-example.tex}{\from{hrefhide.dtx}{example}}% +} + +\obeyspaces +\Msg{**************************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the following *} +\Msg{* file into a directory searched by TeX: *} +\Msg{* *} +\Msg{* hrefhide.sty *} +\Msg{* *} +\Msg{* To produce the documentation run the file `hrefhide.drv' *} +\Msg{* through (pdf)LaTeX, e. g. *} +\Msg{* pdflatex hrefhide.dtx *} +\Msg{* makeindex -s gind.ist hrefhide.idx *} +\Msg{* pdflatex hrefhide.dtx *} +\Msg{* makeindex -s gind.ist hrefhide.idx *} +\Msg{* pdflatex hrefhide.dtx *} +\Msg{* *} +\Msg{* At least three runs are necessary e. g. to get the *} +\Msg{* references right! *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} +\Msg{**************************************************************} + +\endbatchfile + +%</install> +%<*ignore> +\fi +%</ignore> +% +% \section{The documentation driver file} +% +% The next bit of code contains the documentation driver file for +% \TeX{}, i.\,e., the file that will produce the documentation you +% are currently reading. It will be extracted from this file by the +% \texttt{docstrip} programme. That is, run \LaTeX\ on \texttt{docstrip} +% and specify the \texttt{driver} option when \texttt{docstrip} +% asks for options. +% +% \begin{macrocode} +%<*driver> +\NeedsTeXFormat{LaTeX2e}[1994/06/01] +\ProvidesFile{hrefhide.drv}[2010/06/01 v1.0b% + Hiding hyperrefs when printing pdf files (HMM)]% +\documentclass{ltxdoc}[2007/11/11]% v2.0u +\usepackage{holtxdoc}[2010/04/24]% v0.19; yes, I know it is *private* additional ltxdoc support (HO) +%% hrefhide may work with earlier versions of LaTeX2e and those +%% class and package, but this was not tested. +%% Please consider updating your LaTeX, class, and package +%% to the most recent version (if they are not already the most +%% recent version). +%% Warning: holtxdoc, 2010/04/24 v0.19, requires the packages +%% hypdoc, 2010/03/26, v1.9 +%% hyperref, 2010/03/30, v6.80u (latest: 2010/05/13, v6.81e) +%% pdftexcmds, 2010/04/01, v0.9 +%% ltxcmds, 2010/03/09, v1.4 (latest: 2010/04/26, v1.7) +%% hologo, 2010/04/24, v1.2 +%% array (latest: 2008/09/09, v2.4c) +%% (or more recent versions) and does neither work with +%% nor check for earlier versions! +\hypersetup{% + pdfsubject={Hiding hyperrefs when printing pdf files (HMM)},% + pdfkeywords={LaTeX, hrefhide, hyperref, href, pdf, hide, print, Hans-Martin Muench},% + pdfencoding=auto,% + pdflang={en},% + breaklinks=true,% + linktoc=all,% + pdfstartview=FitH,% + pdfpagelayout=OneColumn,% + bookmarksnumbered=true,% + bookmarksopen=true,% + bookmarksopenlevel=3,% + pdfmenubar=true,% + pdftoolbar=true,% + pdfwindowui=true,% + pdfnewwindow=true% +} +\setlength\hfuzz{1pt} % Ignore slight overfulls. +\CodelineIndex +%\PageIndex % instead of \CodelineIndex to get the page numbers +\EnableCrossrefs +%\DisableCrossrefs % Say \DisableCrossrefs if index is ready. +%\RecordChanges % Gather update information. +%\OnlyDescription % Comment out for implementation details. +\hyphenation{docu-ment} +\makeatletter +%% Code from tcilatex.tex, Macros for Scientific Word and Scientific WorkPlace 5.5 <06 Oct 2005> %% +%% Copyright (C) 2005 Mackichan Software, Inc. %% +%% That macro file is NOT proprietary and may be freely copied and distributed. %% + \def\unit#1{\mathord{\thinspace\rm #1}}% +%% End of code from tcilatex.tex %% +\makeatother +\begin{document} + \DocInput{hrefhide.dtx}% +\end{document} +%</driver> +% \end{macrocode} +% +% \begin{macrocode} +%<*ltxdoc> +\NeedsTeXFormat{LaTeX2e}[1994/06/01] +\ProvidesFile{ltxdoc.cfg}[2010/06/01 v1.0 configuration file for hrefhide (HMM)] + %% Code from original ltxdoc.cfg [2007/01/08 latex-tds: ltxdoc.cls configuration (HO)], %% + % copyrighted 2006, 2007 Heiko Oberdiek, part of project `latex-tds'. + % That file may be distributed and/or modified under the + % conditions of the LaTeX Project Public License, either version 1.3 + % of this license or (at your option) any later version. + % The latest version of this license is in + % http://www.latex-project.org/lppl.txt + % and version 1.3c or later is part of all distributions of LaTeX + % version 2005/12/01 or later. + % That work has the LPPL maintenance status `maintained'. + % The Current Maintainer of that work is Heiko Oberdiek. + % + \PassOptionsToClass{a4paper}{article} + \AtEndOfClass{% + \RequirePackage[numbered]{hypdoc}[2010/03/26]% v1.9 + \pdfstringdefDisableCommands{% + \let\env\relax % longtable.dtx + \let\mytt\relax % tabularx.dtx + }% + \addtolength{\topmargin}{-10mm}% + \addtolength{\textheight}{20mm}% + % Depending on the page style, the head or foot area + % are put into the text area. + % Usually the page style is the default "plain". + % tools/verbatim.dtx uses "myheadings". + \def\string@plain{plain}% + \def\string@myheadings{myheadings}% + \def\current@pagestyle{plain}% + \let\ltxdoc@cfg@pagestyle\pagestyle + \def\pagestyle#1{% + \def\current@pagestyle{#1}% + \ltxdoc@cfg@pagestyle{#1}% + }% + \edef\ltxdoc@cfg@jobname{\jobname}% + \def\ltxdoc@cfg@longtable{longtable}% + \@onelevel@sanitize\ltxdoc@cfg@longtable + \ifx\ltxdoc@cfg@jobname\ltxdoc@cfg@longtable + \def\current@pagestyle{both}% + \fi + \let\ltxdoc@cfg@document\document + \def\document{% + \ifx\current@pagestyle\string@plain + \addtolength{\textheight}{\headheight}% + \addtolength{\textheight}{\headsep}% + \setlength{\headheight}{0pt}% + \setlength{\headsep}{0pt}% + \global\textheight\textheight + \global\headheight\headheight + \global\headsep\headsep + \fi + \ifx\current@pagestyle\string@myheadings + \addtolength{\textheight}{\footskip}% + \global\textheight\textheight + \fi + \ltxdoc@cfg@document + }% + %% End of code from original ltxdoc.cfg [2007/01/08 latex-tds: ltxdoc.cls configuration (HO)] %% + %% Place additional code here. %% + } + +%</ltxdoc> +% \end{macrocode} +% +% \fi +% +% \CheckSum{0} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% \GetFileInfo{hrefhide.drv} +% +% \begingroup +% \def\x{\#,\$,\^,\_,\~,\ ,\&,\{,\},\%}% +% \makeatletter +% \@onelevel@sanitize\x +% \expandafter\endgroup +% \expandafter\DoNotIndex\expandafter{\x} +% \expandafter\DoNotIndex\expandafter{\string\ } +% \begingroup +% \makeatletter +% \lccode`9=32\relax +% \lowercase{%^^A +% \edef\x{\noexpand\DoNotIndex{\@backslashchar9}}%^^A +% }%^^A +% \expandafter\endgroup\x +% \DoNotIndex{\documentclass,\usepackage,\hfuzz,\small,\tt,\begin,\end} +% \DoNotIndex{\NeedsTeXFormat,\filedate,\fileversion,\DoNotIndex} +% \DoNotIndex{\def,\edef,\divide,\advance,\multiply} +% \DoNotIndex{\",\-,\,,\\,\hskip,\H,\ldots,\indent,\noindent,\textbackslash} +% \DoNotIndex{\textbf,\textit,\textquotedblleft,\textquotedblright,\textsf,\texttt,\Large} +% \DoNotIndex{\ifthenelse,\and,\equal,\whiledo,\if,\ifx,\ifnum,\else,\fi} +% \DoNotIndex{\CodelineIndex,\EnableCrossrefs,\DisableCrossrefs} +% \DoNotIndex{\DocInput,\AltMacroFont} +% \DoNotIndex{\@ne,\tw@,\thr@@} +% \DoNotIndex{\newpage,\pagebreak,\newline,\linebreak,\nolinebreak} +% \DoNotIndex{\lipsum,\MessageBreak,\pageref,\protect} +% \DoNotIndex{\kvoptions,\listfiles} +% \DoNotIndex{\makeatother,\makeatletter} +% \DoNotIndex{\RecordChanges,\OnlyDescription} +% \DoNotIndex{\smallskip,\medskip,\bigskip,\space,\thinspace} +% \DoNotIndex{\item,\footnote} +% \DoNotIndex{\plainTeX,\TeX,\LaTeX,\pdfLaTeX} +% \DoNotIndex{\chapter,\section} +% +% \title{The \textsf{hrefhide} package\footnote{This file% +% has version number v1.0b, last% +% revised 2010/06/03, documentation dated 2010/06/03.}} +% \author{H.-Martin M\"{u}nch\\ +% (\texttt{Martin dot Muench at Uni-Bonn dot de})} +% \date{2010/06/03} +% +% \maketitle +% +% \begin{abstract} +% This package allows to \textquotedblleft hide\textquotedblright\ some +% (hyperlinked) text when printing the document while keeping the layout. +% \end{abstract} +% +% \bigskip +% +% \noindent Disclaimer for web links: The author is not responsible for any contents +% referred to in this work unless he has full knowledge of illegal contents. +% If any damage occurs by the use of information presented there, only the +% author of the respective pages might be liable, not the one who has referred +% to these pages. +% +% \bigskip +% +% \noindent Save per page about $200\unit{ml}$ water, +% $2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\\ +% Therefore please print only if this is really necessary. +% +% \newpage +% +% \tableofcontents +% +% \newpage +% +% \section{Introduction} +% +% \indent This package provides the command +% \texttt{\textbackslash hrefdisplayonly} (instead of +% \texttt{\textbackslash href}). While the (hyperlinked) text +% appears like an ordinary \texttt{\textbackslash href} in the +% compiled \xext{pdf}-file, the same text will be +% \textquotedblleft hidden\textquotedblright\ when printing the text. +% It is not really invisible, but just has the same colour as the background +% (default: |white|). Therefore the layout is not changed when printing +% the document. +% +% \bigskip +% \noindent \textbf{Trademarks} appear throughout this +% documentation without any trademark symbol; they are the +% property of their respective trademark owner. There is no +% intention of infringement; the usage is to the benefit of +% the trademark owner. +% +% \bigskip +% +% \section{Usage} +% +% \indent Just load the package placing +% \begin{quote} +% |\usepackage[<|\textit{options}|>]{hrefhide}| +% \end{quote} +% \noindent in the preamble of your \LaTeXe\ source file +% \textbf{after} the \texttt{hyperref} package of Heiko Oberdiek. +% For a link, which shall not be printed, use +% \texttt{\textbackslash hrefdisplayonly} instead of +% \texttt{\textbackslash href}. This might be practical +% for example for internal links, which make no sense in a printed +% version (\textquotedblleft Klick here\textquotedblright\ does +% not work with real paper). +% +% \subsection{Options} +% \DescribeMacro{options} +% \indent The \textsf{hrefhide} package takes the following options: +% +% \subsubsection{linktextcolour\label{sss:linktextcolour}} +% \DescribeMacro{linktextcolour} +% \indent The option \texttt{linktextcolour} takes the colour of +% the text of the link. The default is \texttt{black}. +% +% \subsubsection{backgroundcolour\label{sss:backgroundcolour}} +% \DescribeMacro{backgroundcolour} +% \indent The option \texttt{backgroundcolour} takes the colour of +% the background of the link. The default is \texttt{white}. +% +% \subsubsection{pdfborder\label{sss:pdfborder}} +% \DescribeMacro{pdfborder} +% \indent The option \texttt{pdfborder} takes the configuration of +% the pdfborder around the link. The default is \texttt{\{0~0~1\}}, +% i.\,e.~a~1\,pt rectangular line. \texttt{\{0~0~0\}} means no line. +% +% \section{Alternatives\label{sec:Alternatives}} +% +% \DescribeMacro{(ocg)colorlinks} +% If option \texttt{(ocg)colorlinks} (of the \textsf{hyperref} package) +% is already used in your document, do \textbf{NOT} use this +% \textsf{hrefhide} package! For a link to be +% \textquotedblleft hidden\textquotedblright , just say +% \begin{verbatim} +% {\color{white} \href{...}{...}} +% \end{verbatim} +% (and replace \texttt{white} with the background colour). +% +% \bigskip +% +% \noindent (You programmed or found some alternative, +% which is available at \CTAN{}?\\ +% OK, send an e-mail to me with the name, location at \CTAN{}, +% and a short notice, and I will probably include it here.)\\ +% +% \newpage +% +% \section{Example} +% +% \begin{macrocode} +%<*example> +\documentclass[british]{article} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\usepackage{lipsum}[2005/01/26]% v1.0 +\usepackage[ocgcolorlinks]{hyperref}[2010/05/13]% v6.81e +\hypersetup{extension=pdf,% + plainpages=false,% + pdfpagelabels=true,% + hyperindex=false,% + pdflang={en},% + pdftitle={hrefhide package example},% + pdfauthor={Hans-Martin Muench},% + pdfsubject={Example for the hrefhide package},% + pdfkeywords={LaTeX, hrefhide, Hans-Martin Muench},% + pdfview=Fit,pdfstartview=Fit,% + pdfpagelayout=SinglePage,% + bookmarksopen=true% +} +\usepackage[linktextcolour=black,backgroundcolour=white,pdfborder={0 0 1}]{hrefhide}[2010/06/03]% v1.0b +%% This are the default options. %% +\makeatletter +%% Code from tcilatex.tex, Macros for Scientific Word and Scientific WorkPlace 5.5 <06 Oct 2005> %% +%% Copyright (C) 2005 Mackichan Software, Inc. %% +%% That macro file is NOT proprietary and may be freely copied and distributed. %% + \def\unit#1{\mathord{\thinspace\rm #1}}% +%% End of code from tcilatex.tex %% +\makeatother +\listfiles +\begin{document} +\pagenumbering{arabic} +\section*{Example for hrefhide} + +This example demonstrates the use of package\newline +\textsf{hrefhide}, v1.0b as of 2010/06/03 (HMM).\newline +The used options were \texttt{linktextcolour=black}, +\texttt{backgroundcolour=white}, and \texttt{pdfborder={0 0 1}} +(the default ones).\newline +For more details please see the documentation!\newline + +\textit{Print-\textbf{preview} the first page of this document +and compare it with the page as displayed in your pdf reader.}\newline + +\noindent {\color{green} Save per page about $200\unit{ml}$ water, +$2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\newline +Therefore please print only if this is really necessary.\newline +Maybe already the print-preview or just printing +the first page are sufficient?}\newline + +\bigskip +Lorem ipsum dolor sit amet \href{\#target}{link to target} consectetuer +adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet +dolore magna aliquam erat volutpat. + +Ut wisi enim ad minim +veniam \hrefdisplayonly{\#target}{hidden link to target} quis nostrud +exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea +commodo consequat. + +Duis autem vel eum iriure dolor \href{\#target}{link to target} in +hendrerit in vulputate velit esse molestie consequat, vel illum dolore +eu feugiat nulla facilisis at vero eros et accumsan et iusto odio +dignissim qui blandit praesent luptatum zzril delenit augue +duis dolore te feugait nulla facilisi.\newline + +\noindent \textbf{\textsf{% +\hrefdisplayonly{\#RefA}{A} +\hrefdisplayonly{\#RefB}{B} +\hrefdisplayonly{\#RefC}{C} +\hrefdisplayonly{\#RefD}{D} +\hrefdisplayonly{\#RefE}{E} +\hrefdisplayonly{\#RefF}{F} +\hrefdisplayonly{\#RefG}{G} +\hrefdisplayonly{\#RefH}{H} +\hrefdisplayonly{\#RefI}{I} +\hrefdisplayonly{\#RefJ}{J} +\hrefdisplayonly{\#RefK}{K} +\hrefdisplayonly{\#RefL}{L} +\hrefdisplayonly{\#RefM}{M} +\hrefdisplayonly{\#RefN}{N} +\hrefdisplayonly{\#RefO}{O} +\hrefdisplayonly{\#RefP}{P} +\hrefdisplayonly{\#RefQ}{Q} +\hrefdisplayonly{\#RefR}{R} +\hrefdisplayonly{\#RefS}{S} +\hrefdisplayonly{\#RefT}{T} +\hrefdisplayonly{\#RefU}{U} +\hrefdisplayonly{\#RefV}{V} +\hrefdisplayonly{\#RefW}{W} +\hrefdisplayonly{\#RefX}{X} +\hrefdisplayonly{\#RefY}{Y} +\hrefdisplayonly{\#RefZ}{Z}}} \linebreak + +Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit, +vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida +mauris. Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna. + +\pagebreak +{\Large \textbf{Targets}}\\ +Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam +nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat +volutpat. \hypertarget{target}{target text} Ut wisi enim ad minim +veniam, quis nostrud exerci tation ullamcorper suscipit lobortis +nisl ut aliquip ex ea commodo consequat. + +\section[A]{\hypertarget{RefA}{A}} \lipsum[1] +\section[B]{\hypertarget{RefB}{B}} \lipsum[1] +\section[C]{\hypertarget{RefC}{C}} \lipsum[1] +\section[D]{\hypertarget{RefD}{D}} \lipsum[1] +\section[E]{\hypertarget{RefE}{E}} \lipsum[1] +\section[F]{\hypertarget{RefF}{F}} \lipsum[1] +\section[G]{\hypertarget{RefG}{G}} \lipsum[1] +\section[H]{\hypertarget{RefH}{H}} \lipsum[1] +\section[I]{\hypertarget{RefI}{I}} \lipsum[1] +\section[J]{\hypertarget{RefJ}{J}} \lipsum[1] +\section[K]{\hypertarget{RefK}{K}} \lipsum[1] +\section[L]{\hypertarget{RefL}{L}} \lipsum[1] +\section[M]{\hypertarget{RefM}{M}} \lipsum[1] +\section[N]{\hypertarget{RefN}{N}} \lipsum[1] +\section[O]{\hypertarget{RefO}{O}} \lipsum[1] +\section[P]{\hypertarget{RefP}{P}} \lipsum[1] +\section[Q]{\hypertarget{RefQ}{Q}} \lipsum[1] +\section[R]{\hypertarget{RefR}{R}} \lipsum[1] +\section[S]{\hypertarget{RefS}{S}} \lipsum[1] +\section[T]{\hypertarget{RefT}{T}} \lipsum[1] +\section[U]{\hypertarget{RefU}{U}} \lipsum[1] +\section[V]{\hypertarget{RefV}{V}} \lipsum[1] +\section[W]{\hypertarget{RefW}{W}} \lipsum[1] +\section[X]{\hypertarget{RefX}{X}} \lipsum[1] +\section[Y]{\hypertarget{RefY}{Y}} \lipsum[1] +\section[Z]{\hypertarget{RefZ}{Z}} \lipsum[1] + +\end{document} +%</example> +% \end{macrocode} +% +% \newpage +% +% \section{The implementation} +% +% We start off by checking that we are loading into \LaTeXe\ and +% announcing the name and version of this package. +% +% \begin{macrocode} +%<*package> +% \end{macrocode} +% +% \begin{macrocode} +\NeedsTeXFormat{LaTeX2e}[1994/06/01] +\ProvidesPackage{hrefhide}[2010/06/03 v1.0b + Hiding hyperrefs when printing pdf files (HMM)]% + +% \end{macrocode} +% +% A short description of the \textsf{hrefhide} package: +% +% \begin{macrocode} +%% Allows to "hide" hyperlinked text in a pdf file when printing +%% ("Klick here" does not work on real paper) +%% by providing the command \hrefdisplayonly. + +% \end{macrocode} +% +% We need the \textsf{color} package of David~P. Carlisle +% (see subsection~\ref{ss:Downloads}): +% +% \begin{macrocode} +\RequirePackage{color}[2005/11/14]% v1.0j, from the graphics bundle +% \end{macrocode} +% +% the \textsf{hyperref} package of Heiko Oberdiek +% (see subsection~\ref{ss:Downloads}): +% +% \begin{macrocode} +\RequirePackage{hyperref}[2010/05/13]% v6.81e +% \end{macrocode} +% +% and the \textsf{kvoptions} package, also of Heiko Oberdiek +% (see subsection~\ref{ss:Downloads}): +% +% \begin{macrocode} +\RequirePackage{kvoptions}[2010/02/22]% v3.7 +% \end{macrocode} +% +% A last information for the user(s): +% +% \begin{macrocode} +%% hrefhide may work with earlier versions of those packages, +%% but this was not tested. Please consider updating your packages +%% to the most recent version (if they are not already the most +%% recent version). + +% \end{macrocode} +% \indent See subsection~\ref{ss:Downloads} about how to get them.\\ +% +% The options are introduced: +% +% \begin{macrocode} +\SetupKeyvalOptions{family = hrefhide, prefix = hrefhide@} +\DeclareStringOption[black]{linktextcolour}[black] +\DeclareStringOption[white]{backgroundcolour}[white] +\DeclareStringOption[{0 0 1}]{pdfborder}[{0 0 1}] + +\ProcessKeyvalOptions* + +% \end{macrocode} +% +% The new commands are defined: +% +% \begin{macro}{\hycon} +% \begin{macrocode} +\newcommand{\hycon}{% + \relax% + } + +% \end{macrocode} +% +% At the time beeing, |\hycon| does not do anything, +% but in case something would be needed to be done before +% the writing of the link +% (\textquotedblleft \textbf{hy}perlink \textbf{c}olouring \textbf{on}\textquotedblright), +% which should be \textquotedblleft hidden\textquotedblright , +% this would be the place.\\ +% \end{macro} +% +% \begin{macro}{\hycoff} +% \indent This package on the one hand uses the \texttt{ocgcolor} option +% of the \textsf{hyperref} package, but on the other hand +% does not really want coloured links (see \ref{sec:Alternatives}). +% Thus we kind of turn it off: +% +% \begin{macrocode} +\newcommand{\hycoff}{% +% \end{macrocode} +% +% It would be easier if one could just switch \texttt{ocgcolor} on +% and off with |\hypersetup{ocgcolor=true}| and +% |\hypersetup{ocgcolor=false}|, but the option \texttt{ocgcolor} +% of the \textsf{hyperref} package can only be used in the preamble +% of the document when calling the \textsf{hyperref} package. +% So we use it, but set the colour of the text of the link(s), +% +% \begin{macrocode} + \hypersetup{linkcolor=\hrefhide@linktextcolour}% +% \end{macrocode} +% +% \noindent e.\,g. \texttt{black}, which is possible also inside +% the main body of the document.\\ +% We redefine the border around the linked text, +% +% \begin{macrocode} + \def\@pdfborder{\hrefhide@pdfborder}% +% \end{macrocode} +% +% \noindent which would be |{0 0 0}| with normal \texttt{ocgcolor} option, +% i.\,e. there would be no frame at all.\\ +% While link colouring is really ON, we thus emulate the behaviour +% of link colouring OFF, therefore we give this message: +% +% \begin{macrocode} + \Hy@Info{Link coloring OFF (sort of; hrefhide package)}% + } + +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\hrefdisplayonly} +% The command |\hrefdisplayonly| is defined: +% +% \begin{macrocode} +\newcommand{\hrefdisplayonly}[2]{% + \hycon% +% \end{macrocode} +% +% \noindent (for whatever should be done before giving the link),\\ +% giving the link with text in |linkcolor|, +% i.\,e. |\hrefhide@linktextcolour|, when displayed, and +% in |\hrefhide@backgroundcolour|, when printed: +% +% \begin{macrocode} + {\color{\hrefhide@backgroundcolour} \href{#1}{#2}}% +% \end{macrocode} +% +% \noindent and afterwards we turn \textbf{hy}perlink \textbf{c}olouring \textbf{off} +% +% \begin{macrocode} + \hycoff% +% \end{macrocode} +% +% \noindent which is not really necessary with this version of the package, +% because it is \textbf{off} in the whole document, +% but let us just take no risk here. +% +% \begin{macrocode} + } + +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\AtBeginDocument} +% \begin{macrocode} +\AtBeginDocument{ +% \end{macrocode} +% +% \indent |\AtBeginDocument| it is checked whether +% the \textsf{hyperref} package was loaded with option +% \texttt{ocgcolorlinks}. This \textsf{hrefhide} package needs the +% \textsf{hyperref} package with option \texttt{ocgcolorlinks}. +% If package and/or option is missing, the appropriate error +% message is given. +% +% \begin{macrocode} + \ifHy@ocgcolorlinks \relax + \else + \PackageError{hrefhide}{hyperref package missing option ocgcolorlinks}{% + The package hrefhide needs the hyperref package\MessageBreak% + with option ocgcolorlinks.\MessageBreak% + That option is missing!\MessageBreak% + Now the link(s) will be ''hidden'' in pdf view also.\MessageBreak% + } + \fi +% \end{macrocode} +% +% \noindent We check whether |\Hy@driver| is |hpdftex|, i.\,e.~a~\xext{pdf}-file +% is in production. +% +% \begin{macrocode} + \def\hrefhide@driver{hpdftex} + \ifx\Hy@driver\hrefhide@driver \relax + \else +% \end{macrocode} +% +% \noindent If this is not the case (for example for a \xext{dvi}-file), +% the error message is given. +% +% \begin{macrocode} + \PackageError{hrefhide}{Producing not a pdf file}{% + The package hrefhide only works for a pdf file,\MessageBreak% + but driver \Hy@driver\space instead of \hrefhide@driver\space was found.\MessageBreak% + Use pdfLaTeX to compile your document.\MessageBreak% + (No large harm was done, but the respective\MessageBreak% + link text will neither be hidden when printing.)\MessageBreak% + } + \fi +% \end{macrocode} +% +% Because we need link colouring, we use option \texttt{ocgcolorlinks}, +% but because we do not want coloured links, we emulate the behaviour +% of link colouring OFF, therefore |\hycoff| is used |\AtBeginDocument|: +% +% \begin{macrocode} + \hycoff + } + +% \end{macrocode} +% \end{macro} +% +% \begin{macrocode} +%</package> +% \end{macrocode} +% +% \newpage +% +% \section{Installation} +% +% \subsection{Downloads\label{ss:Downloads}} +% +% Everything \textit{should} be available on \CTAN{}, \url{ftp://ftp.ctan.org/tex-archive/}, +% but may need additional packages themselves.\\ +% +% \DescribeMacro{hrefhide.dtx} +% For unpacking the |hrefhide.dtx| file and constructing the documentation it is required: +% \begin{description} +% \item[-] \TeX Format \LaTeXe, 1994/06/01, v2$\varepsilon $: \CTAN{} +% +% \item[-] document class \textsf{ltxdoc}, 2007/11/11, v2.0u,\\ +% \CTAN{macros/latex/base/ltxdoc.dtx} +% +% \item[-] package \textsf{holtxdoc}, 2010/04/24, v0.19,\\ +% \CTAN{macros/latex/contrib/oberdiek/holtxdoc.dtx} +% +% \item[-] package \textsf{hypdoc}, 2010/03/26, v1.9,\\ +% \CTAN{macros/latex/contrib/oberdiek/hypdoc.dtx} +% \end{description} +% +% \DescribeMacro{hrefhide.sty} +% The |hrefhide.sty| for \LaTeXe\ (i.\,e. all documents using +% the \textsf{hrefhide} package) requires: +% \begin{description} +% \item[-] \TeX Format \LaTeXe, 1994/06/01, v2$\varepsilon $, \CTAN{} +% +% \item[-] package \textsf{color}, 2005/11/14, v1.0j, from the \textsf{graphics}-bundle,\\ +% \CTAN{macros/required/graphics/color.dtx} +% +% \item[-] package \textsf{hyperref}, 2010/05/13, v6.81e,\\ +% \CTAN{macros/latex/contrib/hyperref/hyperref.dtx} +% +% \item[-] package \textsf{kvoptions}, 2010/02/22, v3.7,\\ +% \CTAN{macros/latex/contrib/oberdiek/kvoptions.dtx} +% \end{description} +% +% \DescribeMacro{hrefhide-example.tex} +% The |hrefhide-example.tex| requires the same files as all +% documents using the \textsf{hrefhide} package, and additionally: +% \begin{description} +% \item[-] class \textsf{article}, 2007/10/19, v1.4h, from \textsf{classes.dtx}:\\ +% \CTAN{macros/latex/base/classes.dtx} +% +% \item[-] package \textsf{lipsum}, 2005/01/26, v1.0,\\ +% \CTAN{macros/latex/contrib/lipsum/lipsum.dtx} +% +% \item[-] package \textsf{hrefhide}, 2010/06/03, v1.0b,\\ +% \CTAN{macros/latex/contrib/muench/hrefhide/hrefhide.dtx}\\ +% (submitted, should become available at that location soon)\\ +% (Well, it is the example file for this package, and because you are reading the +% documentation for the \textsf{hrefhide} package, it can be assumed that you already +% have some version of it -- is it the current one?) +% \end{description} +% +% \DescribeMacro{hyperref} +% As possible alternative in section \ref{sec:Alternatives} there is listed +% \begin{description} +% \item[-] package \textsf{hyperref}, 2010/05/13, v6.81e,\\ +% \CTAN{macros/latex/contrib/hyperref/} +% with option \texttt{ocgcolorlinks} and\\ +% |{\color{white} \href{...}{...}}|. +% \end{description} +% +% \DescribeMacro{Oberdiek} +% \DescribeMacro{hyperref} +% \DescribeMacro{kvoptions} +% All packages of Heiko Oberdiek's bundle `oberdiek' +% (especially \textsf{holtxdoc} and \textsf{kvoptions}) +% are also available in a TDS compliant ZIP archive:\\ +% \CTAN{install/macros/latex/contrib/oberdiek.tds.zip}.\\ +% \textbf{Warning}: holtxdoc, 2010/04/24 v0.19, requires the packages +% \begin{description} +% \item[-] hypdoc, 2010/03/26, v1.9 +% \item[-] hyperref, 2010/03/30, v6.80u (latest: 2010/05/13, v6.81e) +% \item[-] pdftexcmds, 2010/04/01, v0.9 +% \item[-] ltxcmds, 2010/03/09, v1.4 (latest: 2010/04/26, v1.7) +% \item[-] hologo, 2010/04/24, v1.2 +% \item[-] array (latest: 2008/09/09, v2.4c) +% \end{description} +% (or more recent versions) and does neither work with +% nor check for earlier versions!\\ +% (It is probably best to download\\ +% \CTAN{install/macros/latex/contrib/oberdiek.tds.zip} +% and use this, because the packages in there should be both +% recent and compatible.)\\ +% +% \subsection{Package, unpacking TDS} +% +% \paragraph{Package.} This package should become available on \CTAN{} soon: +% \begin{description} +% \item[\CTAN{macros/latex/contrib/muench/hrefhide/hrefhide.dtx}]\hspace*{0.1cm} \\ +% The source file. +% \item[\CTAN{macros/latex/contrib/muench/hrefhide/hrefhide.ins}]\hspace*{0.1cm} \\ +% The installation file. +% \item[\CTAN{macros/latex/contrib/muench/hrefhide/hrefhide.drv}]\hspace*{0.1cm} \\ +% The driver to generate the documentation. +% \item[\CTAN{macros/latex/contrib/muench/hrefhide/ltxdoc.cfg}]\hspace*{0.1cm} \\ +% The \LaTeX documentation configuration file, also for generating the documentation. +% \item[\CTAN{macros/latex/contrib/muench/hrefhide/hrefhide.pdf}]\hspace*{0.1cm} \\ +% The documentation. +% \item[\CTAN{macros/latex/contrib/muench/hrefhide/hrefhide.sty}]\hspace*{0.1cm} \\ +% The \xfile{sty}le file. +% \item[\CTAN{macros/latex/contrib/muench/hrefhide/hrefhide-example.tex}]\hspace*{0.1cm} \\ +% The example file. +% \item[\CTAN{macros/latex/contrib/muench/hrefhide/hrefhide-example.pdf}]\hspace*{0.1cm} \\ +% The compiled example file, as it should look like. +% \item[\CTAN{install/macros/latex/contrib/muench/hrefhide/hrefhide.tds.zip}]\hspace*{0.1cm} \\ +% Everything in TDS compliant, compiled format. +% \end{description} +% +% For required other packages, see the preceding subsection. +% +% \paragraph{Unpacking.} The \xext{dtx} file is a self-extracting +% \docstrip\ archive. The files are extracted by running the +% \xext{dtx} through \plainTeX: +% \begin{quote} +% \verb|tex hrefhide.dtx| +% \end{quote} +% +% About generating the documentation see paragraph~\ref{GenDoc} below.\\ +% +% \paragraph{TDS.} Now the different files must be moved into +% the different directories in your installation TDS tree +% (also known as \xfile{texmf} tree): +% \begin{quote} +% \def\t{^^A +% \begin{tabular}{@{}>{\ttfamily}l@{ $\rightarrow$ }>{\ttfamily}l@{}} +% hrefhide.sty & tex/latex/muench/hrefhide.sty\\ +% hrefhide.pdf & doc/latex/muench/hrefhide.pdf\\ +% hrefhide-example.tex & doc/latex/muench/hrefhide-example.tex\\ +% hrefhide-example.pdf & doc/latex/muench/hrefhide-example.pdf\\ +% hrefhide.dtx & source/latex/muench/hrefhide.dtx\\ +% \end{tabular}^^A +% }^^A +% \sbox0{\t}^^A +% \ifdim\wd0>\linewidth +% \begingroup +% \advance\linewidth by\leftmargin +% \advance\linewidth by\rightmargin +% \edef\x{\endgroup +% \def\noexpand\lw{\the\linewidth}^^A +% }\x +% \def\lwbox{^^A +% \leavevmode +% \hbox to \linewidth{^^A +% \kern-\leftmargin\relax +% \hss +% \usebox0 +% \hss +% \kern-\rightmargin\relax +% }^^A +% }^^A +% \ifdim\wd0>\lw +% \sbox0{\small\t}^^A +% \ifdim\wd0>\linewidth +% \ifdim\wd0>\lw +% \sbox0{\footnotesize\t}^^A +% \ifdim\wd0>\linewidth +% \ifdim\wd0>\lw +% \sbox0{\scriptsize\t}^^A +% \ifdim\wd0>\linewidth +% \ifdim\wd0>\lw +% \sbox0{\tiny\t}^^A +% \ifdim\wd0>\linewidth +% \lwbox +% \else +% \usebox0 +% \fi +% \else +% \lwbox +% \fi +% \else +% \usebox0 +% \fi +% \else +% \lwbox +% \fi +% \else +% \usebox0 +% \fi +% \else +% \lwbox +% \fi +% \else +% \usebox0 +% \fi +% \else +% \lwbox +% \fi +% \else +% \usebox0 +% \fi +% \end{quote} +% If you have a \xfile{docstrip.cfg} that configures and enables \docstrip's +% TDS installing feature, then some files can already be in the right +% place, see the documentation of \docstrip. +% +% \subsection{Refresh file name databases} +% +% If your \TeX~distribution (\teTeX, \mikTeX,\dots) relies on file name +% databases, you must refresh these. For example, \teTeX\ users run +% \verb|texhash| or \verb|mktexlsr|. +% +% \subsection{Some details for the interested} +% +% \paragraph{Unpacking with \LaTeX.} +% The \xext{dtx} chooses its action depending on the format: +% \begin{description} +% \item[\plainTeX:] Run \docstrip\ and extract the files. +% \item[\LaTeX:] Generate the documentation. +% \end{description} +% If you insist on using \LaTeX\ for \docstrip\ (really, +% \docstrip\ does not need \LaTeX), then inform the autodetect routine +% about your intention: +% \begin{quote} +% \verb|latex \let\install=y\input{hrefhide.dtx}| +% \end{quote} +% Do not forget to quote the argument according to the demands +% of your shell. +% +% \paragraph{Generating the documentation.\label{GenDoc}} +% You can use both the \xext{dtx} or the \xext{drv} to generate +% the documentation. The process can be configured by the +% configuration file \xfile{ltxdoc.cfg}. For instance, put the following +% line into this file, if you want to have A4 as paper format: +% \begin{quote} +% \verb|\PassOptionsToClass{a4paper}{article}| +% \end{quote} +% +% \noindent An example follows how to generate the +% documentation with \pdfLaTeX : +% +% \begin{quote} +%\begin{verbatim} +%pdflatex hrefhide.dtx +%makeindex -s gind.ist hrefhide.idx +%pdflatex hrefhide.dtx +%makeindex -s gind.ist hrefhide.idx +%pdflatex hrefhide.dtx +%\end{verbatim} +% \end{quote} +% +% \subsection{Compiling the example} +% +% The example file, \textsf{hrefhide-example.tex}, can be compiled via\\ +% \indent |pdflatex hrefhide-example.tex|\\ +% (but \textbf{not} |latex hrefhide-example.tex|!)\\ +% and will need two compiler runs to get +% all references right. +% +% \section{Things suggested to be done\label{sec:todo}} +% +% \begin{itemize} +% \item Include a correct checksum for \textsf{hrefhide}. +% \item Include the final place in the CTAN of the \textsf{hrefhide} package. +% \end{itemize} +% +% \section{Acknowledgements} +% +% I would like to thank Heiko Oberdiek +% (heiko dot oberdiek at googlemail dot com) for providing +% the \textsf{hyperref} as well as a~lot~(!) of other usefull packages +% (from which I also got everything I know about creating a file in +% \xext{dtx} format, ok, say it: copying), +% and the \Newsgroup{comp.text.tex} and \Newsgroup{de.comp.text.tex} +% newsgroups for their help in all things \TeX. +% +% \newpage +% +% \phantomsection +% \begin{History}\label{History} +% \begin{Version}{2010/02/18 v0.1} +% \item First idea about this as a reply of mine to a question on +% \Newsgroup{comp.text.tex} (Subject: "Hiding" interactive parts of pdf when printing) +% \end{Version} +% \begin{Version}{2010/06/01 v1.0} +% \item First version of the \textsf{hrefhide} package. +% \end{Version} +% \begin{Version}{2010/06/03 v1.0b} +% \item Example adapted to other examples of mine. +% \item Updated references to other packages. +% \item TDS locations updated. +% \item Several changes in the documentation and the Readme file. +% \end{Version} +% \end{History} +% +% % \PrintChanges +% +% \bigskip +% +% When you find a mistake or have a suggestion for an improvement of this package, +% please send an e-mail to the maintainer, thanks! +% +% \PrintIndex +% +% \Finale +% +\endinput
\ No newline at end of file diff --git a/Master/texmf-dist/source/latex/hrefhide/hrefhide.ins b/Master/texmf-dist/source/latex/hrefhide/hrefhide.ins new file mode 100644 index 00000000000..098e72f8da0 --- /dev/null +++ b/Master/texmf-dist/source/latex/hrefhide/hrefhide.ins @@ -0,0 +1,124 @@ +%% +%% This is file `hrefhide.ins', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% hrefhide.dtx (with options: `install') +%% +%% This is a generated file. +%% +%% IMPORTANT NOTICE: +%% The package takes options. +%% +%% The usual disclaimers apply: +%% If it doesn't work right that's your problem. +%% (Nevertheless, send an e-mail to the maintainer +%% when you find an error in this package.) +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either +%% version 1.3c of this license or (at your option) any later +%% version. This version of this license is in +%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% and the latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3c or later is part of all distributions of +%% LaTeX version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status "maintained". +%% +%% The Current Maintainer of this work is H.-Martin Muench +%% (Martin dot Muench at Uni-Bonn dot de). +%% +%% This work consists of the main source file hrefhide.dtx +%% and the derived files +%% hrefhide.sty, hrefhide.pdf, hrefhide.ins, hrefhide.drv, +%% hrefhide-example.tex. +%% +\input docstrip.tex + +\obeyspaces +\Msg{******************************************************} +\Msg{* Installation *} +\Msg{* Package: hrefhide v1.0b 2010/06/03 LaTeX2e package *} +\Msg{* Hiding hyperrefs when printing pdf files (HMM) *} +\Msg{******************************************************} + +\keepsilent +\askforoverwritefalse + +\let\MetaPrefix\relax +\preamble + +This is a generated file. + +IMPORTANT NOTICE: +The package takes options. + +The usual disclaimers apply: +If it doesn't work right that's your problem. +(Nevertheless, send an e-mail to the maintainer + when you find an error in this package.) + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either +version 1.3c of this license or (at your option) any later +version. This version of this license is in + http://www.latex-project.org/lppl/lppl-1-3c.txt +and the latest version of this license is in + http://www.latex-project.org/lppl.txt +and version 1.3c or later is part of all distributions of +LaTeX version 2005/12/01 or later. + +This work has the LPPL maintenance status "maintained". + +The Current Maintainer of this work is H.-Martin Muench +(Martin dot Muench at Uni-Bonn dot de). + +This work consists of the main source file hrefhide.dtx +and the derived files + hrefhide.sty, hrefhide.pdf, hrefhide.ins, hrefhide.drv, + hrefhide-example.tex. + +\endpreamble +\let\MetaPrefix\DoubleperCent + +\generate{% + \file{hrefhide.ins}{\from{hrefhide.dtx}{install}}% + \file{hrefhide.drv}{\from{hrefhide.dtx}{driver}}% + \file{ltxdoc.cfg}{\from{hrefhide.dtx}{ltxdoc}}% + \usedir{tex/latex/muench/hrefhide}% + \file{hrefhide.sty}{\from{hrefhide.dtx}{package}}% + \usedir{doc/latex/muench/hrefhide}% + \file{hrefhide-example.tex}{\from{hrefhide.dtx}{example}}% +} + +\obeyspaces +\Msg{**************************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the following *} +\Msg{* file into a directory searched by TeX: *} +\Msg{* *} +\Msg{* hrefhide.sty *} +\Msg{* *} +\Msg{* To produce the documentation run the file `hrefhide.drv' *} +\Msg{* through (pdf)LaTeX, e. g. *} +\Msg{* pdflatex hrefhide.dtx *} +\Msg{* makeindex -s gind.ist hrefhide.idx *} +\Msg{* pdflatex hrefhide.dtx *} +\Msg{* makeindex -s gind.ist hrefhide.idx *} +\Msg{* pdflatex hrefhide.dtx *} +\Msg{* *} +\Msg{* At least three runs are necessary e. g. to get the *} +\Msg{* references right! *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} +\Msg{**************************************************************} + +\endbatchfile + +\endinput +%% +%% End of file `hrefhide.ins'. diff --git a/Master/texmf-dist/tex/latex/hrefhide/hrefhide.sty b/Master/texmf-dist/tex/latex/hrefhide/hrefhide.sty new file mode 100644 index 00000000000..06929916844 --- /dev/null +++ b/Master/texmf-dist/tex/latex/hrefhide/hrefhide.sty @@ -0,0 +1,104 @@ +%% +%% This is file `hrefhide.sty', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% hrefhide.dtx (with options: `package') +%% +%% This is a generated file. +%% +%% IMPORTANT NOTICE: +%% The package takes options. +%% +%% The usual disclaimers apply: +%% If it doesn't work right that's your problem. +%% (Nevertheless, send an e-mail to the maintainer +%% when you find an error in this package.) +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either +%% version 1.3c of this license or (at your option) any later +%% version. This version of this license is in +%% http://www.latex-project.org/lppl/lppl-1-3c.txt +%% and the latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3c or later is part of all distributions of +%% LaTeX version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status "maintained". +%% +%% The Current Maintainer of this work is H.-Martin Muench +%% (Martin dot Muench at Uni-Bonn dot de). +%% +%% This work consists of the main source file hrefhide.dtx +%% and the derived files +%% hrefhide.sty, hrefhide.pdf, hrefhide.ins, hrefhide.drv, +%% hrefhide-example.tex. +%% +\NeedsTeXFormat{LaTeX2e}[1994/06/01] +\ProvidesPackage{hrefhide}[2010/06/03 v1.0b + Hiding hyperrefs when printing pdf files (HMM)]% + +%% Allows to "hide" hyperlinked text in a pdf file when printing +%% ("Klick here" does not work on real paper) +%% by providing the command \hrefdisplayonly. + +\RequirePackage{color}[2005/11/14]% v1.0j, from the graphics bundle +\RequirePackage{hyperref}[2010/05/13]% v6.81e +\RequirePackage{kvoptions}[2010/02/22]% v3.7 +%% hrefhide may work with earlier versions of those packages, +%% but this was not tested. Please consider updating your packages +%% to the most recent version (if they are not already the most +%% recent version). + +\SetupKeyvalOptions{family = hrefhide, prefix = hrefhide@} +\DeclareStringOption[black]{linktextcolour}[black] +\DeclareStringOption[white]{backgroundcolour}[white] +\DeclareStringOption[{0 0 1}]{pdfborder}[{0 0 1}] + +\ProcessKeyvalOptions* + +\newcommand{\hycon}{% + \relax% + } + +\newcommand{\hycoff}{% + \hypersetup{linkcolor=\hrefhide@linktextcolour}% + \def\@pdfborder{\hrefhide@pdfborder}% + \Hy@Info{Link coloring OFF (sort of; hrefhide package)}% + } + +\newcommand{\hrefdisplayonly}[2]{% + \hycon% + {\color{\hrefhide@backgroundcolour} \href{#1}{#2}}% + \hycoff% + } + +\AtBeginDocument{ + \ifHy@ocgcolorlinks \relax + \else + \PackageError{hrefhide}{hyperref package missing option ocgcolorlinks}{% + The package hrefhide needs the hyperref package\MessageBreak% + with option ocgcolorlinks.\MessageBreak% + That option is missing!\MessageBreak% + Now the link(s) will be ''hidden'' in pdf view also.\MessageBreak% + } + \fi + \def\hrefhide@driver{hpdftex} + \ifx\Hy@driver\hrefhide@driver \relax + \else + \PackageError{hrefhide}{Producing not a pdf file}{% + The package hrefhide only works for a pdf file,\MessageBreak% + but driver \Hy@driver\space instead of \hrefhide@driver\space was found.\MessageBreak% + Use pdfLaTeX to compile your document.\MessageBreak% + (No large harm was done, but the respective\MessageBreak% + link text will neither be hidden when printing.)\MessageBreak% + } + \fi + \hycoff + } + +\endinput +%% +%% End of file `hrefhide.sty'. diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check index 2376b65a33c..badfb962e19 100755 --- a/Master/tlpkg/bin/tlpkg-ctan-check +++ b/Master/tlpkg/bin/tlpkg-ctan-check @@ -156,7 +156,8 @@ my @TLP_working = qw( harvard harvardkyoto harvmac hatching hc hep hepnames hepparticles hepthesis hepunits here hexgame - hhtensor histogr historische-zeitschrift hitec hrlatex hvfloat hvindex + hhtensor histogr historische-zeitschrift hitec + hrefhide hrlatex hvfloat hvindex hypdvips hyper hypernat hyperref hyperxmp hyph-utf8 hyphen-base hyphenat hyphenex hyplain ibygrk icsv idxlayout ieeepes diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds index 6968a328640..b4788f4bc52 100755 --- a/Master/tlpkg/libexec/ctan2tds +++ b/Master/tlpkg/libexec/ctan2tds @@ -887,6 +887,7 @@ $standardtex='\.(.bx|cfg|sty|clo|ldf|cls|def|fd|cmap|4ht)$'; 'harvmac', 'mac\.tex', 'hc', '\.hld|' . $standardtex, 'hfoldsty', '\.sty|\.fd|\.cpa', + 'hrefhide', '\.sty|[^c]\.cfg', # omit ltxdoc.cfg, would be system-wide 'hyper', '^[^d].*\.sty|\.hyp', # not defpattern.sty 'hyphenex', 'ushyphex\.tex', 'hyplain', '(hyrules|hy.*plain|hylang)\..*', diff --git a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc index e1886cbb51a..29db7c5c9af 100644 --- a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc +++ b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc @@ -281,6 +281,7 @@ depend hhtensor depend histogr depend hitec depend hpsdiss +depend hrefhide depend hvindex depend hypdvips depend hyper diff --git a/Master/tlpkg/tlpsrc/hrefhide.tlpsrc b/Master/tlpkg/tlpsrc/hrefhide.tlpsrc new file mode 100644 index 00000000000..e69de29bb2d --- /dev/null +++ b/Master/tlpkg/tlpsrc/hrefhide.tlpsrc |