Debian Codegraph @

texmf-dist/source/latex/zref-vario/zref-vario.dtx

raw
1 % \iffalse meta-comment
2 %
3 % File: zref-vario.dtx
4 %
5 % This file is part of the LaTeX package "zref-vario".
6 %
7 % Copyright (C) 2022-2024 gusbrs
8 %
9 % It may be distributed and/or modified under the conditions of the
10 % LaTeX Project Public License (LPPL), either version 1.3c of this
11 % license or (at your option) any later version. The latest version
12 % of this license is in the file:
13 %
14 % https://www.latex-project.org/lppl.txt
15 %
16 % and version 1.3 or later is part of all distributions of LaTeX
17 % version 2005/12/01 or later.
18 %
19 %
20 % This work is "maintained" (as per LPPL maintenance status) by gusbrs.
21 %
22 % This work consists of the files zref-vario.dtx,
23 % zref-vario.ins,
24 % zref-vario-doc.tex,
25 % zref-vario-code.tex,
26 % and the files generated from them.
27 %
28 % The released version of this package is available from CTAN.
29 %
30 % -----------------------------------------------------------------------
31 %
32 % The development version of the package can be found at
33 %
34 % https://github.com/gusbrs/zref-vario
35 %
36 % for those people who are interested.
37 %
38 % -----------------------------------------------------------------------
39 %
40 % \fi
41 %
42 % \iffalse
43 %<*driver>
44 \documentclass{l3doc}
45
46 % Have \GetFileInfo pick up date and version data and used in the
47 % documentation.
48 \usepackage{zref-vario}
49
50 \begin{document}
51
52 \DocInput{zref-vario.dtx}
53
54 \end{document}
55 %</driver>
56 % \fi
57 %
58 % \DoNotIndex{\\,\{,\}}
59 %
60 % \NewDocumentCommand\githubissue{m}{^^A
61 % issue~\href{https://github.com/gusbrs/zref-vario/issues/#1}{\##1}}
62 %
63 % \NewDocumentCommand\githubPR{m}{^^A
64 % PR~\href{https://github.com/gusbrs/zref-vario/pull/#1}{\##1}}
65 %
66 % \NewDocumentCommand\contributor{m}{#1}
67 % \NewDocumentCommand\username{m}{`\texttt{#1}'}
68 %
69 % \NewDocumentCommand\opt{m}{\texttt{#1}}
70 %
71 % \pdfstringdefDisableCommands{^^A
72 % \def\opt#1{#1}
73 % }
74 %
75 % ^^A Have the Index at 'section' level rather than 'part'. Otherwise it is
76 % ^^A just the same definition from 'l3doc.cls'.
77 % \IndexPrologue{^^A
78 % \section*{Index}
79 % \markboth{Index}{Index}
80 % \addcontentsline{toc}{section}{Index}
81 % The italic numbers denote the pages where the corresponding entry is
82 % described, numbers underlined point to the definition, all others indicate
83 % the places where it is used.^^A
84 % }
85 %
86 %
87 % \GetFileInfo{zref-vario.sty}
88 %
89 % \title{^^A
90 % The \pkg{zref-vario} package^^A
91 % \texorpdfstring{\\{}\medskip{}}{ - }^^A
92 % Code documentation^^A
93 % \texorpdfstring{\medskip{}}{}^^A
94 % }
95 %
96 % \author{^^A
97 % \texorpdfstring{\texttt{gusbrs}\\[0.8em]
98 % \url{https://github.com/gusbrs/zref-vario}\\
99 % \url{https://www.ctan.org/pkg/zref-vario}}{gusbrs}}
100 %
101 % \date{Version \fileversion\ -- \filedate}
102 %
103 % \maketitle
104 %
105 % \begin{center}
106 % \textbf{EXPERIMENTAL}
107 % \end{center}
108 %
109 %
110 % \tableofcontents
111 %
112 % \clearpage{}
113 %
114 % \section{Initial setup}
115 %
116 % Start the \pkg{DocStrip} guards.
117 % \begin{macrocode}
118 %<*package>
119 % \end{macrocode}
120 %
121 % Identify the internal prefix (\LaTeX3 \pkg{DocStrip} convention).
122 % \begin{macrocode}
123 %<@@=zrefvario>
124 % \end{macrocode}
125 %
126 %
127 % \begin{macrocode}
128 \def\zrefvario@required@kernel{2023-11-01}
129 \NeedsTeXFormat{LaTeX2e}[\zrefvario@required@kernel]
130 \providecommand\IfFormatAtLeastTF{\@ifl@t@r\fmtversion}
131 \IfFormatAtLeastTF{\zrefvario@required@kernel}
132 {}
133 {%
134 \PackageError{zref-vario}{LaTeX kernel too old}
135 {%
136 'zref-vario' requires a LaTeX kernel \zrefvario@required@kernel\space or newer.%
137 }%
138 }%
139 % \end{macrocode}
140 %
141 %
142 % Identify the package.
143 % \begin{macrocode}
144 \ProvidesExplPackage {zref-vario} {2024-11-25} {0.1.12}
145 {Extended LaTeX page cross-references with varioref and zref-clever}
146 % \end{macrocode}
147 %
148 %
149 % Required packages.
150 %
151 % \begin{macrocode}
152 \RequirePackage { zref-clever } [ 2022-01-28 ] % v0.2.0-alpha
153 \RequirePackage { varioref }
154 % \end{macrocode}
155 %
156 % Also note that, contrary to \pkg{zref-clever}, \pkg{zref-vario} is
157 % incompatible with \pkg{cleveref}, because the latter patches \pkg{varioref}
158 % in ways that break \pkg{zref-vario}.
159 %
160 %
161 % \begin{macro}
162 % {
163 % \l_@@_tmpa_tl ,
164 % \l_@@_tmpb_tl ,
165 % }
166 % Temporary scratch variables.
167 % \begin{macrocode}
168 \tl_new:N \l_@@_tmpa_tl
169 \tl_new:N \l_@@_tmpb_tl
170 % \end{macrocode}
171 % \end{macro}
172 %
173 %
174 % \section{Options}
175 %
176 % \subsection*{\cs{zvsetup}}
177 %
178 %
179 % \begin{macro}[int]{\zvsetup}
180 % Provide \cs{zvsetup}.
181 % \begin{syntax}
182 % \cs{zvsetup}\marg{options}
183 % \end{syntax}
184 % \begin{macrocode}
185 \NewDocumentCommand \zvsetup { m }
186 { \keys_set:nn { zref-vario/setup } {#1} }
187 % \end{macrocode}
188 % \end{macro}
189 %
190 %
191 % \subsection*{\opt{pageprop}}
192 %
193 % \begin{macrocode}
194 \tl_new:N \l_@@_pageprop_tl
195 \keys_define:nn { zref-vario/setup }
196 {
197 pageprop .code:n =
198 {
199 \zref@ifpropundefined {#1}
200 { \msg_warning:nnn { zref-vario } { pageprop-not-declared } {#1} }
201 {
202 \zref@iflistcontainsprop { \ZREF@mainlist } {#1}
203 { \tl_set:Nn \l_@@_pageprop_tl {#1} }
204 { \msg_warning:nnn { zref-vario } { pageprop-not-in-main } {#1} }
205 }
206 } ,
207 pageprop .value_required:n = true ,
208 pageprop .initial:n = { page } ,
209 }
210 \AddToHook { begindocument }
211 {
212 \keys_define:nn { zref-vario/setup }
213 {
214 pageprop .code:n =
215 {
216 \msg_warning:nnn { zref-vario }
217 { option-preamble-only } { pageprop }
218 }
219 }
220 }
221 \msg_new:nnn { zref-vario } { option-preamble-only }
222 { Option~'#1'~only~available~in~the~preamble~\msg_line_context:. }
223 \msg_new:nnn { zref-vario } { pageprop-not-declared }
224 {
225 Property~'#1'~not~declared~\msg_line_context:.~
226 Using~default~'page'~property.
227 }
228 \msg_new:nnn { zref-vario } { pageprop-not-in-main }
229 {
230 Property~'#1'~not~in~main~list~\msg_line_context:.~
231 Using~default~'page'~property.
232 }
233 % \end{macrocode}
234 %
235 %
236 % \section{Reference format}
237 %
238 % Provide some functions to define options names in a standard form.
239 %
240 % \begin{macro}[EXP]{\@@_ref_opt_default_cs:nn}
241 % \begin{syntax}
242 % \cs{@@_ref_opt_default_cs:nn} \Arg{option} \Arg{signature}
243 % \end{syntax}
244 % \begin{macrocode}
245 \cs_new:Npn \@@_ref_opt_default_cs:nn #1#2
246 { @@_ref_opt_default_ #1 : #2 }
247 % \end{macrocode}
248 % \end{macro}
249 %
250 %
251 % \begin{macro}[EXP]{\@@_base_lang:n}
252 % \begin{syntax}
253 % \cs{@@_base_lang:n} \Arg{language}
254 % \end{syntax}
255 % \begin{macrocode}
256 \cs_new:Npn \@@_base_lang:n #1
257 {
258 \zrefclever_language_if_declared:nTF {#1}
259 { \tl_use:c { \zrefclever_language_varname:n {#1} } }
260 { zv_unknown_language }
261 }
262 \cs_generate_variant:Nn \@@_base_lang:n { e }
263 % \end{macrocode}
264 % \end{macro}
265 %
266 % \begin{macro}{\l_@@_ref_language_tl}
267 % An internal version of \cs{l_zrefclever_ref_language_tl}, since we need to
268 % retreive the current value of the variable in multiple places.
269 % \begin{macrocode}
270 \tl_new:N \l_@@_ref_language_tl
271 \tl_set:Nn \l_@@_ref_language_tl { \l_zrefclever_ref_language_tl }
272 % \end{macrocode}
273 % \end{macro}
274 %
275 % \begin{macro}[EXP]{\@@_ref_opt_name_lang_tl:nn}
276 % \begin{syntax}
277 % \cs{@@_ref_opt_name_lang_tl:nn} \Arg{lang} \Arg{option}
278 % \end{syntax}
279 % \begin{macrocode}
280 \cs_new:Npn \@@_ref_opt_name_lang_tl:nn #1#2
281 { g_@@_ref_opt_lang_ \@@_base_lang:n {#1} _ #2 _tl }
282 \cs_generate_variant:Nn \@@_ref_opt_name_lang_tl:nn { en }
283 % \end{macrocode}
284 % \end{macro}
285 %
286 % \begin{macro}[EXP]{\@@_ref_opt_name_lang_cs:nnn}
287 % \begin{syntax}
288 % \cs{@@_ref_opt_name_lang_cs:nnn} \Arg{lang} \Arg{option} \Arg{signature}
289 % \end{syntax}
290 % \begin{macrocode}
291 \cs_new:Npn \@@_ref_opt_name_lang_cs:nnn #1#2#3
292 { @@_ref_opt_lang_ \@@_base_lang:n {#1} _ #2 : #3 }
293 \cs_generate_variant:Nn \@@_ref_opt_name_lang_cs:nnn { enn }
294 % \end{macrocode}
295 % \end{macro}
296 %
297 %
298 % Retrieving options values.
299 %
300 % \begin{macro}
301 % {
302 % \@@_ref_opt_tl_get:nnN ,
303 % \@@_ref_opt_cs_get:nnnN ,
304 % }
305 % \begin{syntax}
306 % \cs{@@_ref_opt_tl_get:nnN} \Arg{lang} \Arg{option} \Arg{tl var to set}
307 % \cs{@@_ref_opt_cs_get:nnnN} \Arg{lang} \Arg{option}
308 % ~~\Arg{cs signature} \Arg{cs to set}
309 % \end{syntax}
310 % \begin{macrocode}
311 \cs_new_protected:Npn \@@_ref_opt_tl_get:nnN #1#2#3
312 {
313 \tl_if_exist:cTF
314 { \@@_ref_opt_name_lang_tl:nn {#1} {#2} }
315 {
316 \tl_set_eq:Nc #3
317 { \@@_ref_opt_name_lang_tl:nn {#1} {#2} }
318 }
319 {
320 \tl_set_eq:Nc #3
321 { \@@_ref_opt_name_lang_tl:nn { zv_unknown_language } {#2} }
322 }
323 }
324 \cs_generate_variant:Nn \@@_ref_opt_tl_get:nnN { enN }
325 \cs_new_protected:Npn \@@_ref_opt_cs_get:nnnN #1#2#3#4
326 {
327 \cs_if_exist:cTF
328 { \@@_ref_opt_name_lang_cs:nnn {#1} {#2} {#3} }
329 {
330 \cs_set_eq:Nc #4
331 { \@@_ref_opt_name_lang_cs:nnn {#1} {#2} {#3} }
332 }
333 {
334 \cs_if_exist:cTF
335 { \@@_ref_opt_default_cs:nn {#2} {#3} }
336 {
337 \cs_set_eq:Nc #4
338 { \@@_ref_opt_default_cs:nn {#2} {#3} }
339 }
340 {
341 \cs_set_eq:Nc #4
342 {
343 \@@_ref_opt_name_lang_cs:nnn
344 { zv_unknown_language } {#2} {#3}
345 }
346 }
347 }
348 }
349 \cs_generate_variant:Nn \@@_ref_opt_cs_get:nnnN { ennN }
350 % \end{macrocode}
351 % \end{macro}
352 %
353 %
354 % Handle the options set of the user commands, and add support for
355 % \pkg{varioref} optional arguments. All commands can receive the same set of
356 % options \cs{zcref} can, and these are processed the same way and
357 % ``consumed'' by any \cs{zcref} or \cs{zcpageref} calls. Besides those,
358 % \opt{vother} is made available for \cs{zvpageref}, corresponding to its
359 % second optional argument, and \opt{vcurrent} which is available to all
360 % commands except \cs{fullref}, corresponding to their first optional
361 % arguments. The distinction between \cs{l_@@_reftextcurrent_tl} and
362 % \cs{l_@@_vref_reftextcurrent_tl} is in their default/initial values. The
363 % default values for the optional arguments of \cs{vpageref}, \cs{vrefrange},
364 % and \cs{vpagerefrange} are set to \cs{reftextcurrent}, while the default
365 % value of the optional argument of \cs{vref} is empty.
366 %
367 % \begin{macrocode}
368 \tl_new:N \l_@@_reftextcurrent_tl
369 \tl_set:Nn \l_@@_reftextcurrent_tl { \reftextcurrent }
370 \tl_new:N \l_@@_vref_reftextcurrent_tl
371 \tl_new:N \l_@@_reftextother_tl
372 \keys_define:nn { zref-vario/current }
373 {
374 vcurrent .code:n =
375 {
376 \tl_set:Nn \l_@@_reftextcurrent_tl {#1}
377 \tl_set:Nn \l_@@_vref_reftextcurrent_tl {#1}
378 } ,
379 vcurrent .value_required:n = true ,
380 }
381 \keys_define:nn { zref-vario/other }
382 {
383 vother .tl_set:N = \l_@@_reftextother_tl ,
384 vother .value_required:n = true ,
385 }
386 % \end{macrocode}
387 %
388 % See \url{https://github.com/latex3/latex3/issues/1254}.
389 % ^^A zref-vario/ref
390 % ^^A zref-vario/ref-oneoptarg
391 % ^^A zref-vario/ref-twooptargs
392 % \begin{macrocode}
393 \keys_define:nn { zref-vario }
394 {
395 ref .inherit:n =
396 { zref-clever/reference } ,
397 ref-oneoptarg .inherit:n =
398 { zref-clever/reference , zref-vario/current } ,
399 ref-twooptargs .inherit:n =
400 { zref-clever/reference , zref-vario/current , zref-vario/other } ,
401 }
402 % \end{macrocode}
403 %
404 %
405 % \begin{macro}[int]{\zvLanguageSetup}
406 % User interface for setting ``strings'' (\texttt{reftext\dots{}} options) and
407 % ``formats'' (\texttt{\dots{}format} options) for each language.
408 % \begin{syntax}
409 % \cs{zvLanguageSetup}\marg{language}\marg{options}
410 % \end{syntax}
411 % \begin{macrocode}
412 \tl_new:N \l_@@_setup_language_tl
413 \seq_new:N \g_@@_setup_languages_seq
414 \NewDocumentCommand \zvLanguageSetup { m m }
415 {
416 \AddToHook { begindocument/before }
417 {
418 \group_begin:
419 \zrefclever_language_if_declared:nTF {#1}
420 {
421 \tl_set:Nn \l_@@_setup_language_tl {#1}
422 \keys_set:nn { zref-vario/langsetup } {#2}
423 \seq_gput_right:Ne \g_@@_setup_languages_seq
424 { \@@_base_lang:n {#1} }
425 }
426 { \msg_warning:nnn { zref-vario } { unknown-language-setup } {#1} }
427 \group_end:
428 }
429 }
430 \msg_new:nnn { zref-vario } { unknown-language-setup }
431 {
432 Language~'#1'~is~unknown~\msg_line_context:.~Can't~set~it~up.~
433 The~language~must~be~declared~for~'zref-clever',~see~its~documentation.
434 }
435 \@onlypreamble \zvLanguageSetup
436 % \end{macrocode}
437 % \end{macro}
438 %
439 %
440 % \begin{macrocode}
441 \cs_new_protected:Npn \@@_opt_tl_gset:Nn #1#2
442 {
443 \tl_if_exist:NF #1
444 { \tl_new:N #1 }
445 \tl_gset:Nn #1 {#2}
446 }
447 \cs_generate_variant:Nn \@@_opt_tl_gset:Nn { cn }
448 % \end{macrocode}
449 %
450 % \begin{macrocode}
451 \keys_define:nn { zref-vario/langsetup }
452 {
453 reftextfaceafter .code:n =
454 {
455 \@@_opt_tl_gset:cn
456 {
457 \@@_ref_opt_name_lang_tl:en
458 { \l_@@_setup_language_tl }
459 { reftextfaceafter }
460 } {#1}
461 } ,
462 reftextfacebefore .code:n =
463 {
464 \@@_opt_tl_gset:cn
465 {
466 \@@_ref_opt_name_lang_tl:en
467 { \l_@@_setup_language_tl }
468 { reftextfacebefore }
469 } {#1}
470 } ,
471 reftextafter .code:n =
472 {
473 \@@_opt_tl_gset:cn
474 {
475 \@@_ref_opt_name_lang_tl:en
476 { \l_@@_setup_language_tl }
477 { reftextafter }
478 } {#1}
479 } ,
480 reftextbefore .code:n =
481 {
482 \@@_opt_tl_gset:cn
483 {
484 \@@_ref_opt_name_lang_tl:en
485 { \l_@@_setup_language_tl }
486 { reftextbefore }
487 } {#1}
488 } ,
489 reftextcurrent .code:n =
490 {
491 \@@_opt_tl_gset:cn
492 {
493 \@@_ref_opt_name_lang_tl:en
494 { \l_@@_setup_language_tl }
495 { reftextcurrent }
496 } {#1}
497 } ,
498 reftextfaraway .code:n =
499 {
500 \cs_gset_nopar:cpn
501 {
502 \@@_ref_opt_name_lang_cs:enn
503 { \l_@@_setup_language_tl }
504 { reftextfaraway } { n }
505 }
506 ##1
507 {#1}
508 } ,
509 reftextpagerange .code:n =
510 {
511 \cs_gset_nopar:cpn
512 {
513 \@@_ref_opt_name_lang_cs:enn
514 { \l_@@_setup_language_tl }
515 { reftextpagerange } { nn }
516 }
517 ##1##2
518 {#1}
519 } ,
520 reftextlabelrange .code:n =
521 {
522 \cs_gset_nopar:cpn
523 {
524 \@@_ref_opt_name_lang_cs:enn
525 { \l_@@_setup_language_tl }
526 { reftextlabelrange } { nn }
527 }
528 ##1##2
529 {#1}
530 } ,
531 vrefformat .code:n =
532 {
533 \cs_gset_nopar:cpn
534 {
535 \@@_ref_opt_name_lang_cs:enn
536 { \l_@@_setup_language_tl }
537 { vrefformat } { nn }
538 }
539 ##1##2
540 {#1}
541 } ,
542 vrefrangeformat .code:n =
543 {
544 \cs_gset_nopar:cpn
545 {
546 \@@_ref_opt_name_lang_cs:enn
547 { \l_@@_setup_language_tl }
548 { vrefrangeformat } { nnn }
549 }
550 ##1##2##3
551 {#1}
552 } ,
553 fullrefformat .code:n =
554 {
555 \cs_gset_nopar:cpn
556 {
557 \@@_ref_opt_name_lang_cs:enn
558 { \l_@@_setup_language_tl }
559 { fullrefformat } { n }
560 }
561 ##1
562 {#1}
563 } ,
564 }
565 % \end{macrocode}
566 %
567 %
568 % Default reference formats for all languages. These will be used by
569 % \cs{@@_ref_opt_cs_get:nnnN}, unless a language specific setting for the same
570 % format has been set. \cs{zreftextfaraway} is defined so it can be called
571 % with different arguments in \cs{zvpageref} (where it is alone) and in
572 % \cs{zfullref} (where it is the second of the pair).
573 %
574 % \begin{macrocode}
575 \cs_new_nopar:cpn
576 { \@@_ref_opt_default_cs:nn { vrefformat } { nn } } #1#2
577 {
578 \zcref {#2} ~
579 \zvpageref [ S=false, typeset=both, vcurrent={#1} ] {#2}
580 }
581 \cs_new_nopar:cpn
582 { \@@_ref_opt_default_cs:nn { vrefrangeformat } { nnn } } #1#2#3
583 {
584 \reftextlabelrange {#2} {#3} ~
585 \zvpagerefrange [ S=false, typeset=both, vcurrent={#1} ] {#2} {#3}
586 }
587 \cs_new_nopar:cpn
588 { \@@_ref_opt_default_cs:nn { fullrefformat } { n } } #1
589 {
590 \zcref {#1} ~
591 \zreftextfaraway [ S=false, typeset=both ] {#1}
592 }
593 \NewDocumentCommand \zreftextfaraway { s O { } m }
594 { \zref@wrapper@babel \@@_zreftextfaraway:nnn {#3} {#1} {#2} }
595 \cs_new_protected:Npn \@@_zreftextfaraway:nnn #1#2#3
596 {
597 \group_begin:
598 \keys_set:nn { zref-vario/ref } {#3}
599 \bool_if:nT {#2}
600 {
601 \keys_set:nn { zref-vario/ref } { nohyperref }
602 \bool_set_false:N \l_@@_hyperlink_bool
603 }
604 \tl_set:Nn \l_@@_linklabel_tl {#1}
605 \@@_varioref_setup:
606 \reftextfaraway {#1}
607 \group_end:
608 }
609 % \end{macrocode}
610 %
611 %
612 % Warnings and values for missing strings / unknown languages.
613 %
614 % \begin{macrocode}
615 \group_begin:
616 \tl_set:Nn \l_@@_setup_language_tl { zv_unknown_language }
617 \AddToHook { begindocument/before }
618 {
619 \keys_set:nn { zref-vario/langsetup }
620 {
621 reftextfaceafter =
622 {
623 \msg_warning:nnee { zref-vario } { missing-string }
624 { reftextfaceafter } { \l_@@_ref_language_tl }
625 \zref@default
626 } ,
627 reftextfacebefore =
628 {
629 \msg_warning:nnee { zref-vario } { missing-string }
630 { reftextfacebefore } { \l_@@_ref_language_tl }
631 \zref@default
632 } ,
633 reftextafter =
634 {
635 \msg_warning:nnee { zref-vario } { missing-string }
636 { reftextafter } { \l_@@_ref_language_tl }
637 \zref@default
638 } ,
639 reftextbefore =
640 {
641 \msg_warning:nnee { zref-vario } { missing-string }
642 { reftextbefore } { \l_@@_ref_language_tl }
643 \zref@default
644 } ,
645 reftextcurrent =
646 {
647 \msg_warning:nnee { zref-vario } { missing-string }
648 { reftextcurrent } { \l_@@_ref_language_tl }
649 \zref@default
650 } ,
651 reftextfaraway =
652 {
653 \msg_warning:nnee { zref-vario } { missing-string }
654 { reftextfaraway } { \l_@@_ref_language_tl }
655 \zref@default
656 } ,
657 reftextpagerange =
658 {
659 \msg_warning:nnee { zref-vario } { missing-string }
660 { reftextpagerange } { \l_@@_ref_language_tl }
661 \zref@default
662 } ,
663 reftextlabelrange =
664 {
665 \msg_warning:nnee { zref-vario } { missing-string }
666 { reftextlabelrange } { \l_@@_ref_language_tl }
667 \zref@default
668 } ,
669 }
670 }
671 \group_end:
672 \msg_new:nnn { zref-vario } { missing-string }
673 { Missing~'#1'~string~for~language~'#2'~\msg_line_context:. }
674 % \end{macrocode}
675 %
676 %
677 % A general initial warning in case the language is altogether not set up.
678 %
679 % \begin{macrocode}
680 \AddToHook { begindocument/before }
681 {
682 \AddToHook { begindocument }
683 {
684 \seq_if_in:NeF \g_@@_setup_languages_seq
685 { \@@_base_lang:e { \l_@@_ref_language_tl } }
686 {
687 \msg_warning:nne { zref-vario } { language-not-setup }
688 { \l_@@_ref_language_tl }
689 }
690 }
691 }
692 \msg_new:nnn { zref-vario } { language-not-setup }
693 {
694 Language~'#1'~is~not~set~up~for~'zref-vario'.~
695 See~documentation~for~'\iow_char:N\\zvLanguageSetup'.
696 }
697 % \end{macrocode}
698 %
699 %
700 %
701 % Provide proper hyperlinking for the ``nearby'' page references.
702 % \pkg{hyperref} makes \cs{vref} a \emph{single} link, including both the
703 % standard and the page reference (see Ulrike Fischer's answer and discussion
704 % in the comments at \url{https://tex.stackexchange.com/a/655106}). However,
705 % it does not provide the same treatment to \cs{vpageref}, where there's no
706 % linking at all for nearby pages, to \cs{vrefrange}, \cs{vpagerefrange}, or
707 % \cs{vnameref}. In my view, this makes \pkg{hyperref} inconsistent.
708 % \pkg{cleveref} indeed discusses the issue in the ``Known Bugs and
709 % Work-Arounds'' section, mentioning two problems. The first, that the page
710 % reference does not honor the \texttt{nameinlink} option, which it is
711 % actually the same behavior we get from \cs{vnameref}. The second, that
712 % nearby page references are not included in the links or hyperlinked when by
713 % themselves. This latter problem may be considered undesirable, and even a
714 % ``bug'', but at least \pkg{cleveref}'s behavior in this regard is
715 % consistent.
716 %
717 % This is actually tricky and I think the best alternative here is to not even
718 % try to make a single link of both references, as \pkg{hyperref} does for
719 % \cs{vref}. But rather to offer ways to hyperlink the ``nearby'' page
720 % references separately, which is something that can work for paired
721 % references and for standalone page references just as well.
722 % \cs{zvhyperlink} is provided for such purpose, and is meant to be used
723 % either in the reference format settings of \cs{zvLanguageSetup}, or in the
724 % \opt{vcurrent} and \opt{vother} options of the reference commands. It only
725 % makes a hyperlink if used in one such place (technically, if
726 % \cs{l_@@_linklabel_tl} is not empty), if \cs{l_@@_hyperlink_bool} is true
727 % (to control for starred variants) and if \pkg{hyperref} and
728 % \pkg{zref-hyperref} are loaded, otherwise it passes on its argument
729 % untouched.
730 %
731 %
732 % \begin{macrocode}
733 \bool_new:N \g_@@_zref_hyperref_loaded_bool
734 \bool_new:N \l_@@_hyperlink_bool
735 \AddToHook { package/zref-hyperref/after }
736 {
737 \AddToHook { package/hyperref/after }
738 {
739 \bool_gset_true:N \g_@@_zref_hyperref_loaded_bool
740 \bool_set_true:N \l_@@_hyperlink_bool
741 }
742 }
743 \tl_new:N \l_@@_linklabel_tl
744 % \end{macrocode}
745 %
746 % \begin{macro}[int]{\zvhyperlink}
747 % \begin{syntax}
748 % \cs{zvhyperlink}\marg{text}
749 % \end{syntax}
750 % \begin{macrocode}
751 \NewDocumentCommand \zvhyperlink { m }
752 { \@@_hyperlink:n {#1} }
753 \cs_new_protected:Npn \@@_hyperlink:n #1
754 {
755 \bool_lazy_all:nTF
756 {
757 { \g_@@_zref_hyperref_loaded_bool }
758 { \l_@@_hyperlink_bool }
759 { ! \tl_if_empty_p:V \l_@@_linklabel_tl }
760 }
761 {
762 \hyperlink
763 { \zref@extractdefault { \l_@@_linklabel_tl } { anchor } { } }
764 {#1}
765 }
766 {#1}
767 }
768 % \end{macrocode}
769 % \end{macro}
770 %
771 %
772 %
773 % \section{User interface}
774 %
775 % \begin{macro}
776 % {
777 % \@@_vref_pagenum:Nn ,
778 % \@@_vrefpagenum:Nn ,
779 % \@@_vref_label:n ,
780 % }
781 % These three small functions are responsible for ``connecting''
782 % \pkg{varioref} with \pkg{zref}, instead of with the standard referencing
783 % system. They are meant to locally replace their \pkg{varioref}
784 % counterparts: \cs{vref@pagenum}, \cs{vrefpagenum}, and \cs{vref@label}.
785 % \begin{macrocode}
786 \cs_new_protected:Npn \@@_vref_pagenum:Nn #1#2
787 {
788 \exp_args:NNNo \exp_args:NNo \cs_set_nopar:Npn #1
789 { \zref@extractdefault {#2} { \l_@@_pageprop_tl } { ?? } }
790 }
791 \cs_new_protected:Npn \@@_vrefpagenum:Nn #1#2
792 {
793 \zref@refused {#2}
794 \@@_vref_pagenum:Nn #1 {#2}
795 }
796 \cs_new_protected:Npn \@@_vref_label:n #1
797 { \zref@labelbyprops {#1} { \l_@@_pageprop_tl } }
798 % \end{macrocode}
799 % \end{macro}
800 %
801 % \begin{macro}{\@@_varioref_setup:}
802 % Sets things up for \pkg{varioref} to work with \pkg{zref}/\pkg{zref-clever}.
803 % It is pretty straightforward, but it is the core of the package.
804 % \cs{l_@@_varioref_setup_bool} ensures this setup runs only once in case of
805 % nested calls to the package's commands.
806 % \begin{macrocode}
807 \bool_new:N \l_@@_varioref_setup_bool
808 \cs_new_protected:Npn \@@_varioref_setup:
809 {
810 \bool_if:NF \l_@@_varioref_setup_bool
811 {
812 \bool_set_true:N \l_@@_varioref_setup_bool
813 \@vrefhandlespacefalse
814 \cs_set_eq:NN \vref@pagenum \@@_vref_pagenum:Nn
815 \cs_set_eq:NN \vrefpagenum \@@_vrefpagenum:Nn
816 \cs_set_eq:NN \vref@label \@@_vref_label:n
817 \@@_ref_opt_tl_get:enN
818 { \l_@@_ref_language_tl }
819 { reftextfaceafter }
820 \reftextfaceafter
821 \@@_ref_opt_tl_get:enN
822 { \l_@@_ref_language_tl }
823 { reftextfacebefore }
824 \reftextfacebefore
825 \@@_ref_opt_tl_get:enN
826 { \l_@@_ref_language_tl }
827 { reftextafter }
828 \reftextafter
829 \@@_ref_opt_tl_get:enN
830 { \l_@@_ref_language_tl }
831 { reftextbefore }
832 \reftextbefore
833 \@@_ref_opt_tl_get:enN
834 { \l_@@_ref_language_tl }
835 { reftextcurrent }
836 \reftextcurrent
837 \@@_ref_opt_cs_get:ennN
838 { \l_@@_ref_language_tl }
839 { reftextfaraway } { n }
840 \reftextfaraway
841 \@@_ref_opt_cs_get:ennN
842 { \l_@@_ref_language_tl }
843 { reftextpagerange } { nn }
844 \reftextpagerange
845 \@@_ref_opt_cs_get:ennN
846 { \l_@@_ref_language_tl }
847 { reftextlabelrange } { nn }
848 \reftextlabelrange
849 \@@_ref_opt_cs_get:ennN
850 { \l_@@_ref_language_tl }
851 { vrefformat } { nn }
852 \vrefformat
853 \@@_ref_opt_cs_get:ennN
854 { \l_@@_ref_language_tl }
855 { vrefrangeformat } { nnn }
856 \vrefrangeformat
857 \@@_ref_opt_cs_get:ennN
858 { \l_@@_ref_language_tl }
859 { fullrefformat } { n }
860 \fullrefformat
861 }
862 }
863 % \end{macrocode}
864 % \end{macro}
865 %
866 %
867 % User commands.
868 %
869 % \begin{macro}[int]{\zvref}
870 % \begin{syntax}
871 % \cs{zvref}\meta{*}\oarg{options}\marg{label}
872 % \end{syntax}
873 % \begin{macrocode}
874 \NewDocumentCommand \zvref { s O { } m }
875 { \zref@wrapper@babel \@@_zvref:nnn {#3} {#1} {#2} }
876 \cs_new_protected:Npn \@@_zvref:nnn #1#2#3
877 {
878 \group_begin:
879 \keys_set:nn { zref-vario/ref-oneoptarg } {#3}
880 \bool_if:nT {#2}
881 {
882 \keys_set:nn { zref-vario/ref } { nohyperref }
883 \bool_set_false:N \l_@@_hyperlink_bool
884 }
885 \tl_set:Nn \l_@@_linklabel_tl {#1}
886 \@@_varioref_setup:
887 \@@_vref:Vn \l_@@_vref_reftextcurrent_tl {#1}
888 \group_end:
889 }
890 % \end{macrocode}
891 % ``Ideally'', we'd be using \cs{vref} here, but \pkg{hyperref} redefines
892 % \cs{vref@star} and \cs{vr@f}, hard-coding what was supposed to be
893 % configurable\dots{}, so we use \cs{vrefformat} instead, which is the
894 % original definition of \cs{vref@star}, and \cs{vr@f} also boils down to
895 % \cs{vref@star} when \cs{@vrefhandlespace} is false, which is our case.
896 % \begin{macrocode}
897 \cs_new_protected:Npn \@@_vref:nn #1#2
898 { \vrefformat {#1} {#2} }
899 \cs_generate_variant:Nn \@@_vref:nn { Vn }
900 % \end{macrocode}
901 % \end{macro}
902 %
903 %
904 % \begin{macro}[int]{\zvpageref}
905 % \begin{syntax}
906 % \cs{zvpageref}\meta{*}\oarg{options}\marg{label}
907 % \end{syntax}
908 % \begin{macrocode}
909 \NewDocumentCommand \zvpageref { s O { } m }
910 { \zref@wrapper@babel \@@_zvpageref:nnn {#3} {#1} {#2} }
911 \cs_new_protected:Npn \@@_zvpageref:nnn #1#2#3
912 {
913 \group_begin:
914 \keys_set:nn { zref-vario/ref-twooptargs } {#3}
915 \bool_if:nT {#2}
916 {
917 \keys_set:nn { zref-vario/ref } { nohyperref }
918 \bool_set_false:N \l_@@_hyperlink_bool
919 }
920 \tl_set:Nn \l_@@_linklabel_tl {#1}
921 \@@_varioref_setup:
922 \@@_vpageref:VVn \l_@@_reftextcurrent_tl
923 \l_@@_reftextother_tl {#1}
924 \bool_lazy_and:nnT
925 { \g_@@_zrefcheck_available_bool }
926 { \l_@@_with_vcheck_bool }
927 {
928 \zrefcheck_zrefvario_label:
929 \vref@pagenum \l_@@_tmpa_tl { \the\c@vrcnt @vr }
930 \vrefpagenum \l_@@_tmpb_tl {#1}
931 \tl_if_eq:NNT \l_@@_tmpa_tl \l_@@_tmpb_tl
932 {
933 \zrefcheck_zrefvario_run_check_on_label:Vn
934 \l_@@_vcheck_tl {#1}
935 }
936 }
937 \group_end:
938 }
939 \cs_new_protected:Npn \@@_vpageref:nnn #1#2#3
940 { \vpageref [{#1}] [#2] {#3} }
941 \cs_generate_variant:Nn \@@_vpageref:nnn { VVn }
942 % \end{macrocode}
943 % \end{macro}
944 %
945 %
946 % \begin{macro}[int]{\zvrefrange}
947 % \begin{syntax}
948 % \cs{zvrefrange}\meta{*}\oarg{options}\marg{label}\marg{label}
949 % \end{syntax}
950 % \begin{macrocode}
951 \NewDocumentCommand \zvrefrange { s O { } m m }
952 {
953 \zref@wrapper@babel
954 { \zref@wrapper@babel \@@_zvrefrange:nnnn {#3} }
955 {#4} {#1} {#2}
956 }
957 \cs_new_protected:Npn \@@_zvrefrange:nnnn #1#2#3#4
958 {
959 \group_begin:
960 \keys_set:nn { zref-vario/ref-oneoptarg } {#4}
961 \bool_if:nT {#3}
962 {
963 \keys_set:nn { zref-vario/ref } { nohyperref }
964 \bool_set_false:N \l_@@_hyperlink_bool
965 }
966 \@@_varioref_setup:
967 \vpagerefcompare {#1} {#2}
968 { \tl_set:Nn \l_@@_linklabel_tl {#1} } { }
969 \@@_vrefrange:Vnn \l_@@_reftextcurrent_tl {#1} {#2}
970 \group_end:
971 }
972 \cs_new_protected:Npn \@@_vrefrange:nnn #1#2#3
973 { \vrefrange [{#1}] {#2} {#3} }
974 \cs_generate_variant:Nn \@@_vrefrange:nnn { Vnn }
975 % \end{macrocode}
976 % \end{macro}
977 %
978 %
979 % \begin{macro}[int]{\zvpagerefrange}
980 % \begin{syntax}
981 % \cs{zvpagerefrange}\meta{*}\oarg{options}\marg{label}\marg{label}
982 % \end{syntax}
983 % \begin{macrocode}
984 \NewDocumentCommand \zvpagerefrange { s O { } m m }
985 {
986 \zref@wrapper@babel
987 { \zref@wrapper@babel \@@_zvpagerefrange:nnnn {#3} }
988 {#4} {#1} {#2}
989 }
990 \cs_new_protected:Npn \@@_zvpagerefrange:nnnn #1#2#3#4
991 {
992 \group_begin:
993 \keys_set:nn { zref-vario/ref-oneoptarg } {#4}
994 \bool_if:nT {#3}
995 {
996 \keys_set:nn { zref-vario/ref } { nohyperref }
997 \bool_set_false:N \l_@@_hyperlink_bool
998 }
999 \@@_varioref_setup:
1000 \vpagerefcompare {#1} {#2}
1001 { \tl_set:Nn \l_@@_linklabel_tl {#1} } { }
1002 \@@_vpagerefrange:Vnn \l_@@_reftextcurrent_tl {#1} {#2}
1003 \bool_lazy_and:nnT
1004 { \g_@@_zrefcheck_available_bool }
1005 { \l_@@_with_vcheck_bool }
1006 {
1007 \zrefcheck_zrefvario_label:
1008 \vrefpagenum \l_@@_tmpa_tl {#1}
1009 \vrefpagenum \l_@@_tmpb_tl {#2}
1010 \tl_if_eq:NNT \l_@@_tmpa_tl \l_@@_tmpb_tl
1011 {
1012 \vref@pagenum \l_@@_tmpa_tl { \the\c@vrcnt @vr }
1013 \tl_if_eq:NNT \l_@@_tmpa_tl \l_@@_tmpb_tl
1014 {
1015 \zrefcheck_zrefvario_run_check_on_label:Vn
1016 \l_@@_vcheck_tl {#1}
1017 \zrefcheck_zrefvario_run_check_on_label:Vn
1018 \l_@@_vcheck_tl {#2}
1019 }
1020 }
1021 }
1022 \group_end:
1023 }
1024 \cs_new_protected:Npn \@@_vpagerefrange:nnn #1#2#3
1025 { \vpagerefrange [{#1}] {#2} {#3} }
1026 \cs_generate_variant:Nn \@@_vpagerefrange:nnn { Vnn }
1027 % \end{macrocode}
1028 % \end{macro}
1029 %
1030 %
1031 % \begin{macro}[int]{\zfullref}
1032 % \begin{syntax}
1033 % \cs{zfullref}\meta{*}\oarg{options}\marg{label}
1034 % \end{syntax}
1035 % \begin{macrocode}
1036 \NewDocumentCommand \zfullref { s O { } m }
1037 { \zref@wrapper@babel \@@_zfullref:nnn {#3} {#1} {#2} }
1038 \cs_new_protected:Npn \@@_zfullref:nnn #1#2#3
1039 {
1040 \group_begin:
1041 \keys_set:nn { zref-vario/ref } {#3}
1042 \bool_if:nT {#2}
1043 {
1044 \keys_set:nn { zref-vario/ref } { nohyperref }
1045 \bool_set_false:N \l_@@_hyperlink_bool
1046 }
1047 \tl_set:Nn \l_@@_linklabel_tl {#1}
1048 \@@_varioref_setup:
1049 \fullref {#1}
1050 \group_end:
1051 }
1052 % \end{macrocode}
1053 % \end{macro}
1054 %
1055 %
1056 %
1057 % \section{\pkg{zref-check} integration}
1058 %
1059 % Integration with \pkg{zref-check}. \opt{vcheck}, differently from
1060 % \opt{check}, receives only two values \texttt{above} and \texttt{below},
1061 % since these are the only two checks which make sense for \pkg{zref-vario}.
1062 % This means that it also does not take \cs{zcheck}'s options, but these can
1063 % always be passed to \opt{check}. Besides this, \opt{vcheck}'s check should
1064 % only be done when label(s) and reference are in the same page, that is, when
1065 % \opt{vcurrent} is used. Furthermore, since \pkg{varioref} handles the case
1066 % where the reference crosses page boundaries, we only set one label for the
1067 % purpose, and this is done at the end of the reference, because that's the
1068 % point \pkg{varioref} itself uses to check if label and reference are in the
1069 % same page.
1070 %
1071 % \begin{macrocode}
1072 \bool_new:N \g_@@_zrefcheck_available_bool
1073 \bool_new:N \l_@@_with_vcheck_bool
1074 \tl_new:N \l_@@_vcheck_tl
1075 \AddToHook { begindocument/before }
1076 {
1077 \IfPackageLoadedTF { zref-check }
1078 {
1079 \IfPackageAtLeastTF { zref-check } { 2022-02-08 }
1080 {
1081 \bool_gset_true:N \g_@@_zrefcheck_available_bool
1082 \keys_define:nn { zref-vario/current }
1083 {
1084 vcheck .choices:nn =
1085 { above , below }
1086 {
1087 \bool_set_true:N \l_@@_with_vcheck_bool
1088 \tl_set:NV \l_@@_vcheck_tl \l_keys_choice_tl
1089 } ,
1090 }
1091 }
1092 {
1093 \bool_gset_false:N \g_@@_zrefcheck_available_bool
1094 \keys_define:nn { zref-vario/current }
1095 {
1096 vcheck .code:n =
1097 { \msg_warning:nn { zref-vario } { zref-check-unavailable } } ,
1098 }
1099 }
1100 }
1101 {
1102 \bool_gset_false:N \g_@@_zrefcheck_available_bool
1103 \keys_define:nn { zref-vario/current }
1104 {
1105 vcheck .code:n =
1106 { \msg_warning:nn { zref-vario } { zref-check-unavailable } } ,
1107 }
1108 }
1109 }
1110 \msg_new:nnn { zref-vario } { zref-check-unavailable }
1111 {
1112 Option~'vcheck'~is~only~available~when~'zref-check'~is~loaded~
1113 and~newer~than~'2022-02-08~v0.2.4'.
1114 }
1115 % \end{macrocode}
1116 %
1117 %
1118 % \section{Languages}
1119 %
1120 % Localization for the languages provided by the author, except where
1121 % otherwise stated. However, I could only do so thanks to \pkg{varioref}, in
1122 % particular for languages I don't really know. So, credits go to the
1123 % contributors of \pkg{varioref}. Of course, if any native speaker would like
1124 % to review these, or contribute new ones, it is much welcome. Note, however,
1125 % that since \pkg{zref-vario} depends on \pkg{zref-clever} and piggybacks on
1126 % its language infrastructure, it only makes sense to provide localization
1127 % here for languages already supported by \pkg{zref-clever}.
1128 %
1129 %
1130 % \begin{macrocode}
1131 \zvLanguageSetup { english }
1132 {
1133 reftextfaceafter =
1134 {on~the~\zvhyperlink{\reftextvario{facing}{next}~page}} ,
1135 reftextfacebefore =
1136 {on~the~\zvhyperlink{\reftextvario{facing}{preceding}~page}} ,
1137 reftextafter =
1138 {on~the~\zvhyperlink{\reftextvario{following}{next}~page}} ,
1139 reftextbefore =
1140 {on~the~\zvhyperlink{\reftextvario{preceding}{previous}~page}} ,
1141 reftextcurrent =
1142 {on~\reftextvario{}{the~}\zvhyperlink{\reftextvario{this}{current}~page}} ,
1143 reftextfaraway = {on~\zcpageref{#1}} ,
1144 reftextpagerange = {on~\zcpageref[range]{#1,#2}} ,
1145 reftextlabelrange = {\zcref[range]{#1,#2}} ,
1146 }
1147 % \end{macrocode}
1148 %
1149 %
1150 % \begin{macrocode}
1151 \zvLanguageSetup { german }
1152 {
1153 reftextfaceafter = {auf~der~\zvhyperlink{nächsten~Seite}} ,
1154 reftextfacebefore = {auf~der~\zvhyperlink{vorherigen~Seite}} ,
1155 reftextafter = {auf~der~\zvhyperlink{nächsten~Seite}} ,
1156 reftextbefore = {auf~der~\zvhyperlink{vorherigen~Seite}} ,
1157 reftextcurrent = {auf~\zvhyperlink{dieser~Seite}} ,
1158 reftextfaraway = {auf~\zcpageref[d=D,g=f]{#1}} ,
1159 reftextpagerange = {auf~den~\zcpageref[range,d=D,g=f]{#1,#2}} ,
1160 reftextlabelrange = {\zcref[range]{#1,#2}} ,
1161 }
1162 % \end{macrocode}
1163 %
1164 %
1165 % \begin{macrocode}
1166 \zvLanguageSetup { french }
1167 {
1168 reftextfaceafter =
1169 {\zvhyperlink{page~\reftextvario{ci-contre}{suivante}}} ,
1170 reftextfacebefore =
1171 {\zvhyperlink{page~\reftextvario{ci-contre}{précédente}}} ,
1172 reftextafter = {\zvhyperlink{page~suivante}} ,
1173 reftextbefore = {\zvhyperlink{page~précédente}} ,
1174 reftextcurrent = {de~la~\zvhyperlink{présente~page}} ,
1175 reftextfaraway = {\zcpageref[g=f]{#1}} ,
1176 reftextpagerange = {\zcpageref[range,g=f]{#1,#2}} ,
1177 reftextlabelrange = {\zcref[range]{#1,#2}} ,
1178 }
1179 % \end{macrocode}
1180 %
1181 %
1182 % \begin{macrocode}
1183 \zvLanguageSetup { portuguese }
1184 {
1185 reftextfaceafter =
1186 {na~\zvhyperlink{\reftextvario{página~oposta}{próxima~página}}} ,
1187 reftextfacebefore =
1188 {na~\zvhyperlink{página~\reftextvario{oposta}{anterior}}} ,
1189 reftextafter =
1190 {na~\zvhyperlink{\reftextvario{página~seguinte}{próxima~página}}} ,
1191 reftextbefore =
1192 {na~\zvhyperlink{página~\reftextvario{anterior}{precedente}}} ,
1193 reftextcurrent = {\zvhyperlink{nesta~página}} ,
1194 reftextfaraway = {na~\zcpageref[g=f]{#1}} ,
1195 reftextpagerange = {nas~\zcpageref[range,g=f]{#1,#2}} ,
1196 reftextlabelrange = {\zcref[range]{#1,#2}} ,
1197 }
1198 % \end{macrocode}
1199 %
1200 %
1201 % \begin{macrocode}
1202 \zvLanguageSetup { spanish }
1203 {
1204 reftextfaceafter = {en~la~\zvhyperlink{página~siguiente}} ,
1205 reftextfacebefore = {en~la~\zvhyperlink{página~anterior}} ,
1206 reftextafter = {en~la~\zvhyperlink{página~siguiente}} ,
1207 reftextbefore = {en~la~\zvhyperlink{página~anterior}} ,
1208 reftextcurrent = {en~\zvhyperlink{esta~página}} ,
1209 reftextfaraway = {en~la~\zcpageref[g=f]{#1}} ,
1210 reftextpagerange = {en~las~\zcpageref[range,g=f]{#1,#2}} ,
1211 reftextlabelrange = {\zcref[range]{#1,#2}} ,
1212 }
1213 % \end{macrocode}
1214 %
1215 %
1216 % \begin{macrocode}
1217 \zvLanguageSetup { dutch }
1218 {
1219 reftextfaceafter =
1220 {op~de~\zvhyperlink{\reftextvario{rechter~pagina}{pagina~hiernaast}}} ,
1221 reftextfacebefore =
1222 {op~de~\zvhyperlink{\reftextvario{linker~pagina}{pagina~hiernaast}}} ,
1223 reftextafter =
1224 {op~de~\zvhyperlink{\reftextvario{volgende~pagina}{pagina~hierna}}} ,
1225 reftextbefore =
1226 {op~de~\zvhyperlink{\reftextvario{vorige~pagina}{pagina~hiervoor}}} ,
1227 reftextcurrent = {op~\zvhyperlink{deze~pagina}} ,
1228 reftextfaraway = {op~\zcpageref[g=f]{#1}} ,
1229 reftextpagerange = {op~\zcpageref[range,g=f]{#1,#2}} ,
1230 reftextlabelrange = {\zcref[range]{#1,#2}} ,
1231 }
1232 % \end{macrocode}
1233 %
1234 %
1235 % Italian localization improved thanks to \contributor{Matteo Ferrigato} (at
1236 % \githubissue{1}).
1237 %
1238 % \begin{macrocode}
1239 \zvLanguageSetup { italian }
1240 {
1241 reftextfaceafter =
1242 {nella~\zvhyperlink{pagina~\reftextvario{a~fianco}{successiva}}} ,
1243 reftextfacebefore =
1244 {nella~\zvhyperlink{pagina~\reftextvario{a~fianco}{precedente}}} ,
1245 reftextafter =
1246 {nella~\zvhyperlink{pagina~\reftextvario{seguente}{successiva}}} ,
1247 reftextbefore = {nella~\zvhyperlink{pagina~precedente}} ,
1248 reftextcurrent = {in~\zvhyperlink{questa~pagina}} ,
1249 reftextfaraway = {a~\zcpageref[g=f]{#1}} ,
1250 reftextpagerange = {nelle~\zcpageref[range,g=f]{#1,#2}} ,
1251 reftextlabelrange = {\zcref[range]{#1,#2}} ,
1252 }
1253 % \end{macrocode}
1254 %
1255 %
1256 % Swedish localization initially provided by \contributor{\username{Timmyfox}}
1257 % (at \githubissue{3}).
1258 %
1259 % \begin{macrocode}
1260 \zvLanguageSetup { swedish }
1261 {
1262 reftextfaceafter =
1263 {på~\zvhyperlink{\reftextvario{motstående}{nästa}~sida}} ,
1264 reftextfacebefore =
1265 {på~\zvhyperlink{\reftextvario{motstående}{föregående}~sida}} ,
1266 reftextafter =
1267 {på~\zvhyperlink{\reftextvario{följande}{nästa}~sida}} ,
1268 reftextbefore =
1269 {på~\zvhyperlink{föregående~sida}} ,
1270 reftextcurrent =
1271 {på~\zvhyperlink{\reftextvario{den~här~sidan}{denna~sida}}} ,
1272 reftextfaraway = {på~\zcpageref{#1}} ,
1273 reftextpagerange = {på~\zcpageref[range]{#1,#2}} ,
1274 reftextlabelrange = {\zcref[range]{#1,#2}} ,
1275 }
1276 % \end{macrocode}
1277 %
1278 %
1279 % \begin{macrocode}
1280 %</package>
1281 % \end{macrocode}
1282 %
1283 %
1284 % \PrintIndex
1285 %