Debian Codegraph @

texmf-dist/source/latex/se2thesis/se2colors.dtx

raw
1 % \iffalse meta-comment
2 %
3 % File: se2colors.dtx Copyright (C) 2022--2024 Stephan Lukasczyk
4 %
5 % It may be distributed and/or modified under the conditions of the
6 % LaTeX Project Public License (LPPL), either version 1.3c of this
7 % license or (at your option) any later version. The latest version
8 % of this license is in the file
9 %
10 % https://www.latex-project.org/lppl.txt
11 %
12 % This file is part of the "se2thesis bundle" (The Work in LPPL)
13 % and all files in that bundle must be distributed together.
14 %
15 % The released version of this bundle is available from CTAN.
16 %
17 % ---------------------------------------------------------------------
18 %
19 % The development version of the bundle can be found at
20 %
21 % https://github.com/se2p/se2thesis
22 %
23 % for those people who are interested.
24 %
25 % ---------------------------------------------------------------------
26 %
27 %<*driver>
28 \documentclass{l3doc}
29 % The next line is needed so that \GetFileInfo will be able to pick up
30 % version data.
31 \usepackage{se2colors}
32
33 \usepackage[UKenglish]{babel}
34 \usepackage{hvfloat}
35 \usepackage{hvlogos}
36 \usepackage{booktabs}
37
38 % Taken from xcolor.dtx
39 \makeatletter
40 \def\testclr#1#{\@testclr{#1}}
41 \def\@testclr#1#2{{\fboxsep\z@\fbox{\colorbox#1{#2}{\phantom{XXX}}}}}
42 \makeatother
43
44 \begin{document}
45 \DocInput{\jobname.dtx}
46 \end{document}
47 %</driver>
48 % \fi
49 %
50 % \GetFileInfo{se2colors.sty}
51 %
52 % \title{^^A
53 % \pkg{se2colors}---Colour Definitions for the \pkg{se2thesis} Bundle^^A
54 % \thanks{This file describes \fileversion, last revised \filedate.}^^A
55 % }
56 %
57 % \author{^^A
58 % Stephan Lukasczyk^^A
59 % \thanks{^^A
60 % E-mail: \href{mailto:[email protected]}{[email protected]}^^A
61 % }^^A
62 % }
63 %
64 % \date{Released \filedate}
65 %
66 % \maketitle
67 %
68 % \begin{documentation}
69 %
70 % \section{The \pkg{se2colors} package}\label{sec:doc-se2colors}
71 %
72 % Several colours are specific to the university
73 % and we want to have a comprehensive interface
74 % to access them throughout all our packages.
75 %
76 % The \pkg{se2colors} package provides this exact features.
77 % One can load it using |\usepackage{se2colors}| in the document preamble.
78 %
79 % \begin{function}[updated = 2022-11-03]{cmode}
80 % \begin{syntax}
81 % |cmode| = \meta{choice}
82 % \end{syntax}
83 % Selects the colour mode that shall be used for creating the results,
84 % a choice from the options specified in \cref{tab:coloursoptions}.
85 % The default setting is |4C|.
86 % \end{function}
87 %
88 % \begin{table}[th]
89 % \tabcaption{\label{tab:coloursoptions}%
90 % Options provided by \pkg{se2colors}.%
91 % }
92 % \centering
93 % \begin{tabular}{@{} l l @{}} \toprule
94 % Option & Description \\ \midrule
95 % %
96 % |cmode=4C|
97 % & Define colours in CMYK colour space (\emph{default}). \\
98 % %
99 % |cmode=CMYK|
100 % & Alias for the previous. \\
101 % %
102 % |CMYK|, |cmyk|
103 % & Aliases for the previous. \\
104 % %
105 % |cmode=RGB|
106 % & Define colours in RGB colour space. \\
107 % %
108 % |RGB|, |rgb|
109 % & Aliases for the previous. \\
110 % %
111 % |cmode=BW|
112 % & Define colours in black-and-white colour space. \\
113 % %
114 % |cmode=1C|
115 % & Alias for the previous. \\
116 % %
117 % |gray|
118 % & Alias for the previous. \\
119 % %
120 % \bottomrule
121 % \end{tabular}
122 % \end{table}
123 %
124 % We define two basic colours that are taken from the University's logo,
125 % namely |UPSE2-Gray| \testclr{UPSE2-Gray}
126 % and |UPSE2-Orange| \testclr{UPSE2-Orange}.
127 %
128 % Additionally,
129 % we define four colours for the four faculties of the University:
130 % \begin{itemize}
131 % \item the Faculty of Law |UPSE2-JUR| \testclr{UPSE2-JUR},
132 % \item the School of Business, Economics and Information Systems
133 % |UPSE2-WIWI| \testclr{UPSE2-WIWI},
134 % \item the Faculty of Arts and Humanities
135 % |UPSE2-PHIL| \testclr{UPSE2-PHIL}, and
136 % \item the Faculty of Computer Science and Mathematics
137 % |UPSE2-FIM| \testclr{UPSE2-FIM}.
138 % \end{itemize}
139 %
140 % Finally,
141 % we define a full set of supplementary colours:
142 % \begin{itemize}
143 % \item |UPSE2-DarkGray| \testclr{UPSE2-DarkGray}
144 % with its derivatives \\
145 % |UPSE2-DarkGray1| \testclr{UPSE2-DarkGray1},
146 % |UPSE2-DarkGray2| \testclr{UPSE2-DarkGray2},
147 % |UPSE2-DarkGray3| \testclr{UPSE2-DarkGray3},
148 % |UPSE2-DarkGray4| \testclr{UPSE2-DarkGray4}, and
149 % |UPSE2-DarkGray5| \testclr{UPSE2-DarkGray5}.
150 % \item |UPSE2-White| \testclr{UPSE2-White}
151 % with its derivatives \\
152 % |UPSE2-White1| \testclr{UPSE2-White1},
153 % |UPSE2-White2| \testclr{UPSE2-White2},
154 % |UPSE2-White3| \testclr{UPSE2-White3},
155 % |UPSE2-White4| \testclr{UPSE2-White4}, and
156 % |UPSE2-White5| \testclr{UPSE2-White5}.
157 % \item |UPSE2-MediumGray| \testclr{UPSE2-MediumGray}
158 % with its derivatives \\
159 % |UPSE2-MediumGray1| \testclr{UPSE2-MediumGray1},
160 % |UPSE2-MediumGray2| \testclr{UPSE2-MediumGray2},
161 % |UPSE2-MediumGray3| \testclr{UPSE2-MediumGray3},
162 % |UPSE2-MediumGray4| \testclr{UPSE2-MediumGray4}, and
163 % |UPSE2-MediumGray5| \testclr{UPSE2-MediumGray5}.
164 % \item |UPSE2-LightGray| \testclr{UPSE2-LightGray}
165 % with its derivatives \\
166 % |UPSE2-LightGray1| \testclr{UPSE2-LightGray1},
167 % |UPSE2-LightGray2| \testclr{UPSE2-LightGray2},
168 % |UPSE2-LightGray3| \testclr{UPSE2-LightGray3},
169 % |UPSE2-LightGray4| \testclr{UPSE2-LightGray4}, and
170 % |UPSE2-LightGray5| \testclr{UPSE2-LightGray5}.
171 % \item |UPSE2-Orange| \testclr{UPSE2-Orange}
172 % with its derivatives \\
173 % |UPSE2-Orange1| \testclr{UPSE2-Orange1},
174 % |UPSE2-Orange2| \testclr{UPSE2-Orange2},
175 % |UPSE2-Orange3| \testclr{UPSE2-Orange3},
176 % |UPSE2-Orange4| \testclr{UPSE2-Orange4}, and
177 % |UPSE2-Orange5| \testclr{UPSE2-Orange5}.
178 % \item |UPSE2-LightRed| \testclr{UPSE2-LightRed}
179 % with its derivatives \\
180 % |UPSE2-LightRed1| \testclr{UPSE2-LightRed1},
181 % |UPSE2-LightRed2| \testclr{UPSE2-LightRed2},
182 % |UPSE2-LightRed3| \testclr{UPSE2-LightRed3},
183 % |UPSE2-LightRed4| \testclr{UPSE2-LightRed4}, and
184 % |UPSE2-LightRed5| \testclr{UPSE2-LightRed5}.
185 % \item |UPSE2-DarkRed| \testclr{UPSE2-DarkRed}
186 % with its derivatives \\
187 % |UPSE2-DarkRed1| \testclr{UPSE2-DarkRed1},
188 % |UPSE2-DarkRed2| \testclr{UPSE2-DarkRed2},
189 % |UPSE2-DarkRed3| \testclr{UPSE2-DarkRed3},
190 % |UPSE2-DarkRed4| \testclr{UPSE2-DarkRed4}, and
191 % |UPSE2-DarkRed5| \testclr{UPSE2-DarkRed5}.
192 % \item |UPSE2-Green| \testclr{UPSE2-Green}
193 % with its derivatives \\
194 % |UPSE2-Green1| \testclr{UPSE2-Green1},
195 % |UPSE2-Green2| \testclr{UPSE2-Green2},
196 % |UPSE2-Green3| \testclr{UPSE2-Green3},
197 % |UPSE2-Green4| \testclr{UPSE2-Green4}, and
198 % |UPSE2-Green5| \testclr{UPSE2-Green5}.
199 % \item |UPSE2-Blue| \testclr{UPSE2-Blue}
200 % with its derivatives \\
201 % |UPSE2-Blue1| \testclr{UPSE2-Blue1},
202 % |UPSE2-Blue2| \testclr{UPSE2-Blue2},
203 % |UPSE2-Blue3| \testclr{UPSE2-Blue3},
204 % |UPSE2-Blue4| \testclr{UPSE2-Blue4}, and
205 % |UPSE2-Blue5| \testclr{UPSE2-Blue5}.
206 % \item |UPSE2-AccentGray| \testclr{UPSE2-AccentGray}
207 % with its derivatives \\
208 % |UPSE2-AccentGray1| \testclr{UPSE2-AccentGray1},
209 % |UPSE2-AccentGray2| \testclr{UPSE2-AccentGray2},
210 % |UPSE2-AccentGray3| \testclr{UPSE2-AccentGray3},
211 % |UPSE2-AccentGray4| \testclr{UPSE2-AccentGray4}, and
212 % |UPSE2-AccentGray5| \testclr{UPSE2-AccentGray5}.
213 % \end{itemize}
214 %
215 % \end{documentation}
216 %
217 % \begin{implementation}
218 %
219 % \section{\pkg{se2colors} implementation}
220 %
221 % Start the \pkg{DocStrip} guards.
222 % \begin{macrocode}
223 %<*package>
224 % \end{macrocode}
225 %
226 % Identify the internal prefix (\LaTeX3 \pkg{DocStrip} convention): only
227 % internal material in this \emph{submodule} should be used directly.
228 % \begin{macrocode}
229 %<@@=slcd_colors>
230 % \end{macrocode}
231 %
232 % Identify the package and give the overall version information.
233 % \begin{macrocode}
234 \ProvidesExplPackage {se2colors} {2026-04-03} {4.4.1}
235 {A colour support package for the se2thesis bundle}
236 % \end{macrocode}
237 %
238 % \subsection{Load-time options}
239 %
240 % \begin{macro}{\l_@@_colormode_tl}
241 % Holds the colour mode selected by the user as a package load-time option.
242 % \begin{macrocode}
243 \keys_define:nn { seiicolors }
244 {
245 cmode .choice:,
246 cmode / 4C .code:n = {
247 \PassOptionsToPackage{ cmyk }{ xcolor }
248 \tl_gset:Nn \l_@@_colormode_tl { 4C }
249 },
250 cmode / RGB .code:n = {
251 \PassOptionsToPackage{ rgb }{ xcolor }
252 \tl_gset:Nn \l_@@_colormode_tl { RGB }
253 },
254 cmode / BW .code:n = {
255 \PassOptionsToPackage{ gray }{ xcolor }
256 \tl_gset:Nn \l_@@_colormode_tl { BW }
257 },
258 cmode / CMYK .meta:n = { cmode=4C },
259 cmode / cmyk .meta:n = { cmode=4C },
260 cmode / rgb .meta:n = { cmode=RGB },
261 cmode / gray .meta:n = { cmode=BW },
262 cmode / bw .meta:n = { cmode=BW },
263 RGB .meta:n = { cmode=RGB },
264 rgb .meta:n = { cmode=RGB },
265 CMYK .meta:n = { cmode=4C },
266 cmyk .meta:n = { cmode=4C },
267 BW .meta:n = { cmode=BW },
268 bw .meta:n = { cmode=BW },
269 gray .meta:n = { cmode=BW },
270 }
271 \keys_set:nn { seiicolors } { cmode = 4C }
272 % \end{macrocode}
273 % \end{macro}
274 %
275 % \subsection{Option handling}
276 %
277 % \begin{macrocode}
278 \IfFormatAtLeastTF { 2022-06-01 }
279 { \ProcessKeyOptions [ seiicolors ] }
280 {
281 \RequirePackage { l3keys2e }
282 \ProcessKeysOptions { seiicolors }
283 }
284 % \end{macrocode}
285 %
286 % \subsection{Colour definitions}
287 %
288 % Load the \pkg{xcolor} package for colour definitions.
289 % \begin{macrocode}
290 \RequirePackage{ xcolor }
291 % \end{macrocode}
292 %
293 %
294 % Define the primary colours gray and orange as given by the University of
295 % Passau's style guides.
296 % \begin{macrocode}
297 \definecolorset[named]{ RGB/cmyk } { UPSE2- } {} {%
298 Orange,242,148,0/0.00,0.44,0.95,0.01;%
299 Gray,153,159,158/0.40,0.28,0.28,0.00;%
300 JUR,229,49,56/0.01,0.90,0.81,0.01;%
301 WIWI,0,96,57/0.87,0.20,0.87,0.36;%
302 PHIL,188,42,51/0.06,0.93,0.81,0.11;%
303 FIM,0,90,161/0.93,0.63,0.01,0.02;%
304 DarkGray,77,77,77/0.74,0.67,0.62,0.18;%
305 White,255,255,255/0.00,0.00,0.00,0.00;%
306 MediumGray,127,127,127/0.52,0.43,0.40,0.02;%
307 LightGray,229,229,229/0.08,0.06,0.04,0.00;%
308 LightRed,229,49,56/0.01,0.90,0.81,0.01;%
309 DarkRed,188,42,51/0.06,0.93,0.80,0.11;%
310 Green,0,96,57/0.87,0.20,0.86,0.35;%
311 Blue,0,90,161/0.93,0.63,0.01,0.02;%
312 AccentGray,153,159,158/0.40,0.28,0.28,0.00%
313 }
314 % \end{macrocode}
315 %
316 % Define the derived colours.
317 % \begin{macrocode}
318 \colorlet{ UPSE2-DarkGray1 } { UPSE2-DarkGray!20!white }
319 \colorlet{ UPSE2-DarkGray2 } { UPSE2-DarkGray!40!white }
320 \colorlet{ UPSE2-DarkGray3 } { UPSE2-DarkGray!60!white }
321 \colorlet{ UPSE2-DarkGray4 } { UPSE2-DarkGray!75!black }
322 \colorlet{ UPSE2-DarkGray5 } { UPSE2-DarkGray!50!black }
323 \colorlet{ UPSE2-White1 } { UPSE2-White!95!black }
324 \colorlet{ UPSE2-White2 } { UPSE2-White!85!black }
325 \colorlet{ UPSE2-White3 } { UPSE2-White!75!black }
326 \colorlet{ UPSE2-White4 } { UPSE2-White!65!black }
327 \colorlet{ UPSE2-White5 } { UPSE2-White!50!black }
328 \colorlet{ UPSE2-MediumGray1 } { UPSE2-MediumGray!20!white }
329 \colorlet{ UPSE2-MediumGray2 } { UPSE2-MediumGray!40!white }
330 \colorlet{ UPSE2-MediumGray3 } { UPSE2-MediumGray!60!white }
331 \colorlet{ UPSE2-MediumGray4 } { UPSE2-MediumGray!75!black }
332 \colorlet{ UPSE2-MediumGray5 } { UPSE2-MediumGray!50!black }
333 \colorlet{ UPSE2-LightGray1 } { UPSE2-LightGray!90!black }
334 \colorlet{ UPSE2-LightGray2 } { UPSE2-LightGray!75!black }
335 \colorlet{ UPSE2-LightGray3 } { UPSE2-LightGray!55!black }
336 \colorlet{ UPSE2-LightGray4 } { UPSE2-LightGray!25!black }
337 \colorlet{ UPSE2-LightGray5 } { UPSE2-LightGray!10!black }
338 \colorlet{ UPSE2-Orange1 } { UPSE2-Orange!20!white }
339 \colorlet{ UPSE2-Orange2 } { UPSE2-Orange!40!white }
340 \colorlet{ UPSE2-Orange3 } { UPSE2-Orange!60!white }
341 \colorlet{ UPSE2-Orange4 } { UPSE2-Orange!75!black }
342 \colorlet{ UPSE2-Orange5 } { UPSE2-Orange!50!black }
343 \colorlet{ UPSE2-LightRed1 } { UPSE2-LightRed!20!white }
344 \colorlet{ UPSE2-LightRed2 } { UPSE2-LightRed!40!white }
345 \colorlet{ UPSE2-LightRed3 } { UPSE2-LightRed!60!white }
346 \colorlet{ UPSE2-LightRed4 } { UPSE2-LightRed!75!black }
347 \colorlet{ UPSE2-LightRed5 } { UPSE2-LightRed!50!black }
348 \colorlet{ UPSE2-DarkRed1 } { UPSE2-DarkRed!20!white }
349 \colorlet{ UPSE2-DarkRed2 } { UPSE2-DarkRed!40!white }
350 \colorlet{ UPSE2-DarkRed3 } { UPSE2-DarkRed!60!white }
351 \colorlet{ UPSE2-DarkRed4 } { UPSE2-DarkRed!75!black }
352 \colorlet{ UPSE2-DarkRed5 } { UPSE2-DarkRed!50!black }
353 \colorlet{ UPSE2-Green1 } { UPSE2-Green!10!white }
354 \colorlet{ UPSE2-Green2 } { UPSE2-Green!25!white }
355 \colorlet{ UPSE2-Green3 } { UPSE2-Green!50!white }
356 \colorlet{ UPSE2-Green4 } { UPSE2-Green!75!white }
357 \colorlet{ UPSE2-Green5 } { UPSE2-Green!90!white }
358 \colorlet{ UPSE2-Blue1 } { UPSE2-Blue!20!white }
359 \colorlet{ UPSE2-Blue2 } { UPSE2-Blue!40!white }
360 \colorlet{ UPSE2-Blue3 } { UPSE2-Blue!60!white }
361 \colorlet{ UPSE2-Blue4 } { UPSE2-Blue!75!black }
362 \colorlet{ UPSE2-Blue5 } { UPSE2-Blue!50!black }
363 \colorlet{ UPSE2-AccentGray1 } { UPSE2-AccentGray!20!white }
364 \colorlet{ UPSE2-AccentGray2 } { UPSE2-AccentGray!40!white }
365 \colorlet{ UPSE2-AccentGray3 } { UPSE2-AccentGray!60!white }
366 \colorlet{ UPSE2-AccentGray4 } { UPSE2-AccentGray!75!black }
367 \colorlet{ UPSE2-AccentGray5 } { UPSE2-AccentGray!50!black }
368 % \end{macrocode}
369 %
370 % \begin{macrocode}
371 %</package>
372 % \end{macrocode}
373 %
374 % \end{implementation}
375 %
376 % \PrintIndex