Debian Codegraph @

texmf-dist/tex/latex-dev/tools/showkeys.sty

raw
1 %%
2 %% This is file `showkeys.sty',
3 %% generated with the docstrip utility.
4 %%
5 %% The original source files were:
6 %%
7 %% showkeys.dtx (with options: `package')
8 %%
9 %% This is a generated file.
10 %%
11 %% The source is maintained by the LaTeX Project team and bug
12 %% reports for it can be opened at https://latex-project.org/bugs/
13 %% (but please observe conditions on bug reports sent to that address!)
14 %%
15 %%
16 %% Copyright (C) 1993-2026
17 %% The LaTeX Project and any individual authors listed elsewhere
18 %% in this file.
19 %%
20 %% This file was generated from file(s) of the Standard LaTeX `Tools Bundle'.
21 %% --------------------------------------------------------------------------
22 %%
23 %% It may be distributed and/or modified under the
24 %% conditions of the LaTeX Project Public License, either version 1.3c
25 %% of this license or (at your option) any later version.
26 %% The latest version of this license is in
27 %% https://www.latex-project.org/lppl.txt
28 %% and version 1.3c or later is part of all distributions of LaTeX
29 %% version 2005/12/01 or later.
30 %%
31 %% This file may only be distributed together with a copy of the LaTeX
32 %% `Tools Bundle'. You may however distribute the LaTeX `Tools Bundle'
33 %% without such generated files.
34 %%
35 %% The list of all files belonging to the LaTeX `Tools Bundle' is
36 %% given in the file `manifest.txt'.
37 %%
38 %% File: showkeys.dtx Copyright (C) 1992-1997 David Carlisle
39 %% File: showkeys.dtx Copyright (C) 2006-2025 David Carlisle, LaTeX Project
40 \NeedsTeXFormat{LaTeX2e}
41
42 \DeclareRelease{}{1994-06-01}{showkeys-2014-10-28.sty}
43 \DeclareRelease{}{2014-10-28}{showkeys-2014-10-28.sty}
44 \DeclareCurrentRelease{}{2022-06-01}
45
46 \ProvidesPackage{showkeys}
47 [2024/05/23 v3.21 Show cite and label keys (DPC, MH)]
48 \DeclareOption{notref}{\let\SK@ref\@empty}
49 \DeclareOption{notcite}{\let\SK@cite\@empty}
50 \let\SK@refcolor\relax
51 \let\SK@labelcolor\relax
52 \DeclareOption{color}{\AtEndOfPackage{%
53 \RequirePackage{color}%
54 \definecolor{refkey}{gray}{.75}%
55 \definecolor{labelkey}{gray}{.75}%
56 \def\SK@refcolor{\color{refkey}}%
57 \def\SK@labelcolor{\color{labelkey}}}}
58 \DeclareOption{final}{%
59 \providecommand*\showkeyslabelformat[1]{}%
60 \endinput}
61 \DeclareOption{draft}{}
62 \ProcessOptions
63 \let\SK@label\label
64 \let\SK@bibitem\@bibitem
65 \let\SK@lbibitem\@lbibitem
66 \@ifl@t@r\fmtversion{2023-06-01}
67 {\AddToHookWithArguments{label}{\SK@\SK@@label{#1}}}
68 {\def\label#1{%
69 \@bsphack
70 \SK@\SK@@label{#1}%
71 \begingroup
72 \SK@label{#1}%
73 \endgroup
74 \@esphack}}
75 \def\@bibitem#1{%
76 \SK@bibitem{#1}\SK@\SK@@label{#1}\ignorespaces}
77 \def\@lbibitem[#1]#2{%
78 \SK@lbibitem[{#1}]{#2}\SK@\SK@@label{#2}\ignorespaces}
79 \def\SK@#1#2{%
80 \protected@edef\@tempa{#2}%
81 \expandafter#1\meaning\@tempa\SK@}
82 \providecommand*\showkeyslabelformat[1]{%
83 \fbox{\normalfont\small\ttfamily#1}}
84 \def\SK@@label#1>#2\SK@{%
85 \gdef\SK@lab{\smash{\SK@labelcolor\showkeyslabelformat{#2}}}%
86 \ifvmode
87 \if@inlabel
88 \global\setbox\@labels\hbox{%
89 \llap{\SK@lab\SK@lab@relax
90 \kern\@totalleftmargin\kern\marginparsep}%
91 \unhbox\@labels}%
92 \else
93 \dimen@\prevdepth
94 \nointerlineskip
95 \ifinner
96 \skip@\lastskip\unskip
97 \advance\skip@\lastskip\unskip
98 \setbox\z@\lastbox
99 \ifvoid\z@
100 \llap{\SK@lab\SK@lab@relax\kern\marginparsep}%
101 \else
102 \hbox{\box\z@\rlap{\kern\marginparsep\SK@labx}}%
103 \fi
104 \vskip\skip@
105 \else
106 \llap{\SK@lab\SK@lab@relax\kern\marginparsep}%
107 \fi
108 \prevdepth\dimen@
109 \fi
110 \else
111 \csname SK@\@currenvir\endcsname
112 \ifSK@equation\else
113 \ifmmode
114 \SK@labx
115 \else
116 \ifinner
117 \rlap\SK@lab
118 \else
119 \vadjust{\llap{\SK@lab\kern\marginparsep}}%
120 \fi
121 \SK@lab@relax
122 \fi
123 \fi
124 \fi}
125 \AtBeginDocument{%
126 \let\SK@eqnnum\@eqnnum
127 \@ifpackageloaded{amsmath}{%
128 \let\SK@tagform@\tagform@
129 \let\SK@maketag@@@\maketag@@@
130 \iftagsleft@
131 \def\tagform@#1{%
132 \ifx\df@label\@empty
133 \SK@lab@relax
134 \else
135 \expandafter\SK@@label\meaning\df@label\SK@
136 \fi
137 \llap{\SK@lab\kern\marginparsep}%
138 \SK@lab@relax\SK@tagform@{#1}}%
139 \def\maketag@@@#1{%
140 \ifx\df@label\@empty
141 \SK@lab@relax
142 \else
143 \expandafter\SK@@label\meaning\df@label\SK@
144 \fi
145 \llap{\SK@lab\kern\marginparsep}\SK@lab@relax
146 \SK@maketag@@@{#1}%
147 }%
148 \def\@eqnnum{%
149 \llap{\SK@lab\kern\displaywidth\kern\marginparsep}%
150 \SK@lab@relax\SK@eqnnum}%
151 \else
152 \def\tagform@#1{%
153 \ifx\df@label\@empty
154 \SK@lab@relax
155 \else
156 \expandafter\SK@@label\meaning\df@label\SK@
157 \fi
158 \SK@tagform@{#1}%
159 \rlap{\kern\marginparsep\SK@lab}\SK@lab@relax}%
160 \def\maketag@@@#1{%
161 \ifx\df@label\@empty
162 \SK@lab@relax
163 \else
164 \expandafter\SK@@label\meaning\df@label\SK@
165 \fi
166 \SK@maketag@@@{#1}%
167 \rlap{\kern\marginparsep\SK@lab}\SK@lab@relax
168 }%
169 \def\@eqnnum{\SK@eqnnum\rlap{\kern\marginparsep\SK@lab}%
170 \SK@lab@relax}%
171 \fi
172 }%
173 {%
174 \@ifundefined{[email protected]}{%
175 \def\@eqnnum{\SK@eqnnum\rlap{\kern\marginparsep\SK@lab}%
176 \SK@lab@relax}%
177 }{%
178 \def\@eqnnum{%
179 \llap{\SK@lab\kern\displaywidth\kern\marginparsep}%
180 \SK@lab@relax\SK@eqnnum}%
181 }%
182 }%
183 }
184 \def\SK@labx{\rlap\SK@lab\global\let\SK@lab\relax}
185 \def\SK@lab@relax{\global\let\SK@lab\relax}\SK@lab@relax
186 \newif\ifSK@equation
187 \let\SK@equation\SK@equationtrue
188 \let\SK@eqnarray\SK@equationtrue
189 \toks@\expandafter{\eqnarray}
190 \edef\eqnarray{\let\noexpand\tagform@\noexpand\SK@tagform@\the\toks@}
191 \let\SK@align\SK@equationtrue
192 \let\SK@alignat\SK@equationtrue
193 \let\SK@xalignat\SK@equationtrue
194 \let\SK@xxalignat\SK@equationtrue
195 \let\SK@gather\SK@equationtrue
196 \let\SK@multline\SK@equationtrue
197 \let\SK@flalign\SK@equationtrue
198 \expandafter\let\csname SK@align*\endcsname\SK@equationtrue
199 \expandafter\let\csname SK@alignat*\endcsname\SK@equationtrue
200 \expandafter\let\csname SK@flalign*\endcsname\SK@equationtrue
201 \expandafter\let\csname SK@gather*\endcsname\SK@equationtrue
202 \expandafter\let\csname SK@multline*\endcsname\SK@equationtrue
203 \expandafter\let\csname SK@equation*\endcsname\SK@equationtrue
204 \def\SK@def#1{%
205 \edef\@tempa{\expandafter\@gobble\string#1}%
206 \@ifundefined{\@tempa\space}%
207 {\expandafter\let\csname SK@\@tempa\endcsname#1}%
208 {\expandafter\let\csname SK@\@tempa\expandafter\endcsname
209 \csname\@tempa\space\endcsname}%
210 \expandafter\def\expandafter#1\expandafter{%
211 \expandafter\protect\csname\@tempa\space\endcsname}%
212 \expandafter\def\csname\@tempa\space\endcsname}
213 \ifx\SK@ref\@empty
214 \else
215 \AtBeginDocument{%
216 \let\@kernel@ref@\@kernel@ref
217 \let\@kernel@sref@\@kernel@sref
218 \SK@def\@kernel@ref#1{\SK@\SK@@ref{#1}\SK@@kernel@ref{#1}}%
219 \SK@def\@kernel@sref#1{\SK@\SK@@ref{#1}\SK@@kernel@sref{#1}}%
220 \SK@def\@kernel@pageref#1{\SK@\SK@@ref{#1}\SK@@kernel@pageref{#1}}%
221 \SK@def\@kernel@spageref#1{\SK@\SK@@ref{#1}\SK@@kernel@spageref{#1}}%
222 \SK@def\@kernel@Ref#1{{\let\@kernel@ref\@kernel@ref@\SK@\SK@@ref{#1}\SK@@kernel@Ref{#1}}}%
223 \SK@def\@kernel@sRef#1{\let\@kernel@sref\@kernel@sref@\SK@\SK@@ref{#1}\SK@@kernel@sRef{#1}}%
224 \@ifpackageloaded{varioref}{%
225 \SK@def\@@vpageref#1[#2]#3{{%
226 \leavevmode\unskip\SK@\SK@@ref{#3}\SK@@@vpageref{#1}[{#2}]{#3}}}%%
227 }{}}
228 \fi
229 \ifx\SK@cite\@empty
230 \AtBeginDocument{%
231 \ifx\HAR@checkdef\@undefined\else
232 \expandafter\let\expandafter
233 \SK@HAR@bi\csname\string\harvarditem\endcsname
234 \expandafter\def\csname\string\harvarditem\endcsname[#1]#2#3#4{%
235 \SK@HAR@bi[{#1}]{#2}{#3}{#4}\SK@\SK@@label{#4}}%
236 \fi}
237 \else
238 \AtBeginDocument{%
239 \ifx\HAR@checkdef\@undefined
240 \ifx\citen\@undefined
241 \SK@def\@citex[#1]#2{\SK@citex[{#1}]{#2}}%
242 \else
243 \SK@def\citen#1{\SK@\SK@@ref{#1}\SK@citen{#1}}%
244 \fi
245 \SK@def\citeauthor#1{\SK@\SK@@ref{#1}\SK@citeauthor{#1}}%
246 \SK@def\citefullauthor#1{\SK@\SK@@ref{#1}\SK@citefullauthor{#1}}%
247 \SK@def\citeyear#1{\SK@\SK@@ref{#1}\SK@citeyear{#1}}%
248 \else
249 \SK@def\HAR@checkdef#1#2{%
250 \expandafter\SK@\expandafter\SK@@ref\expandafter{#1}%
251 \SK@HAR@checkdef{#1}{#2}}%
252 \expandafter\let\expandafter
253 \SK@HAR@bi\csname\string\harvarditem\endcsname
254 \expandafter\def\csname\string\harvarditem\endcsname[#1]#2#3#4{%
255 \SK@HAR@bi[{#1}]{#2}{#3}{#4}\SK@\SK@@label{#4}}%
256 \fi}
257 \def\SK@citex[#1]#2{%
258 \SK@\SK@@ref{#2}\SK@@citex[{#1}]{#2}}
259 \fi
260 \def\SK@@ref#1>#2\SK@{%
261 \leavevmode\vbox to\z@{{%
262 \vss
263 \SK@refcolor
264 \rlap{\vrule\raise .75em%
265 \hbox{\underbar{\normalfont\footnotesize\ttfamily#2}}}}}}
266 \endinput
267 %%
268 %% End of file `showkeys.sty'.