summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/zref-vario
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/zref-vario')
-rw-r--r--Master/texmf-dist/doc/latex/zref-vario/CHANGELOG.md8
-rw-r--r--Master/texmf-dist/doc/latex/zref-vario/DEPENDS.txt2
-rw-r--r--Master/texmf-dist/doc/latex/zref-vario/MANIFEST.md148
-rw-r--r--Master/texmf-dist/doc/latex/zref-vario/README.md19
-rw-r--r--Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.pdfbin0 -> 539239 bytes
-rw-r--r--Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.tex52
-rw-r--r--Master/texmf-dist/doc/latex/zref-vario/zref-vario.pdfbin0 -> 119911 bytes
-rw-r--r--Master/texmf-dist/doc/latex/zref-vario/zref-vario.tex261
8 files changed, 490 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/zref-vario/CHANGELOG.md b/Master/texmf-dist/doc/latex/zref-vario/CHANGELOG.md
new file mode 100644
index 00000000000..7702b1e8151
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/CHANGELOG.md
@@ -0,0 +1,8 @@
+# Changelog
+
+## [Unreleased]
+
+## [v0.1.0-alpha](https://github.com/gusbrs/zref-vario/releases/tag/v0.1.0-alpha) (2022-01-31)
+
+### Added
+- Initial release.
diff --git a/Master/texmf-dist/doc/latex/zref-vario/DEPENDS.txt b/Master/texmf-dist/doc/latex/zref-vario/DEPENDS.txt
new file mode 100644
index 00000000000..b593a243a79
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/DEPENDS.txt
@@ -0,0 +1,2 @@
+hard zref-clever
+hard varioref
diff --git a/Master/texmf-dist/doc/latex/zref-vario/MANIFEST.md b/Master/texmf-dist/doc/latex/zref-vario/MANIFEST.md
new file mode 100644
index 00000000000..050277efd7b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/MANIFEST.md
@@ -0,0 +1,148 @@
+# Manifest for zref-vario
+
+This file is a listing of all files considered to be part of this package.
+It is automatically generated with `l3build manifest`.
+
+
+## Repository manifest
+
+The following groups list the files included in the development repository of the package.
+Files listed with a ‘†’ marker are included in the TDS but not CTAN files, and files listed
+with ‘‡’ are included in both.
+
+### Source files
+
+These are source files for a number of purposes, including the `unpack` process which
+generates the installation files of the package. Additional files included here will also
+be installed for processing such as testing.
+
+* zref-vario.dtx ‡
+* zref-vario.ins ‡
+
+### Typeset documentation source files
+
+These files are typeset using LaTeX to produce the PDF documentation for the package.
+
+* zref-vario-code.tex ‡
+* zref-vario.tex ‡
+
+### Text files
+
+Plain text files included as documentation or metadata.
+
+* CHANGELOG.md ‡
+* MANIFEST.md ‡
+* README.md ‡
+* readme-ctan.md
+* DEPENDS.txt ‡
+
+### Derived files
+
+The files created by ‘unpacking’ the package sources. This typically includes
+`.sty` and `.cls` files created from DocStrip `.dtx` files.
+
+* zref-vario.sty †
+
+### Typeset documents
+
+The output files (PDF, essentially) from typesetting the various source, demo,
+etc., package files.
+
+* zref-vario-code.pdf ‡
+* zref-vario.pdf ‡
+
+### Test files
+
+These files form the test suite for the package. `.lvt` or `.lte` files are the individual
+unit tests, and `.tlg` are the stored output for ensuring changes to the package produce
+the same output. These output files are sometimes shared and sometime specific for
+different engines (pdfTeX, XeTeX, LuaTeX, etc.).
+
+* zv-basic01.lvt
+* zv-basic02.lvt
+* zv-basic03.lvt
+* zv-basic04.lvt
+* zv-hyperref01.lvt
+* zv-languages01.lvt
+* zv-zcref-options01.lvt
+* zv-basic01.luatex.tlg
+* zv-basic01.luatexdev.tlg
+* zv-basic01.tlg
+* zv-basic01.xetex.tlg
+* zv-basic01.xetexdev.tlg
+* zv-basic02.luatex.tlg
+* zv-basic02.luatexdev.tlg
+* zv-basic02.tlg
+* zv-basic02.xetex.tlg
+* zv-basic02.xetexdev.tlg
+* zv-basic03.luatex.tlg
+* zv-basic03.luatexdev.tlg
+* zv-basic03.tlg
+* zv-basic03.xetex.tlg
+* zv-basic03.xetexdev.tlg
+* zv-basic04.luatex.tlg
+* zv-basic04.luatexdev.tlg
+* zv-basic04.tlg
+* zv-basic04.xetex.tlg
+* zv-basic04.xetexdev.tlg
+* zv-hyperref01.luatex.tlg
+* zv-hyperref01.luatexdev.tlg
+* zv-hyperref01.tlg
+* zv-hyperref01.xetex.tlg
+* zv-hyperref01.xetexdev.tlg
+* zv-languages01.tlg
+* zv-zcref-options01.luatex.tlg
+* zv-zcref-options01.luatexdev.tlg
+* zv-zcref-options01.tlg
+* zv-zcref-options01.xetex.tlg
+* zv-zcref-options01.xetexdev.tlg
+
+
+## TDS manifest
+
+The following groups list the files included in the TeX Directory Structure used to install
+the package into a TeX distribution.
+
+### Source files (TDS)
+
+All files included in the `zref-vario/source` directory.
+
+* zref-vario.dtx
+* zref-vario.ins
+
+### TeX files (TDS)
+
+All files included in the `zref-vario/tex` directory.
+
+* zref-vario.sty
+
+### Doc files (TDS)
+
+All files included in the `zref-vario/doc` directory.
+
+* CHANGELOG.md
+* DEPENDS.txt
+* MANIFEST.md
+* README.md
+* zref-vario-code.pdf
+* zref-vario-code.tex
+* zref-vario.pdf
+* zref-vario.tex
+
+
+## CTAN manifest
+
+The following group lists the files included in the CTAN package.
+
+### CTAN files
+
+* CHANGELOG.md
+* DEPENDS.txt
+* MANIFEST.md
+* README.md
+* zref-vario-code.pdf
+* zref-vario-code.tex
+* zref-vario.dtx
+* zref-vario.ins
+* zref-vario.pdf
+* zref-vario.tex
diff --git a/Master/texmf-dist/doc/latex/zref-vario/README.md b/Master/texmf-dist/doc/latex/zref-vario/README.md
new file mode 100644
index 00000000000..a76d0b945c3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/README.md
@@ -0,0 +1,19 @@
+# zref-vario
+
+**Extended LaTeX page cross-references with varioref and zref-clever**
+
+Author: Gustavo Barros
+Maintainer: Gustavo Barros
+
+`zref-vario` offers a compatibility layer for `varioref` to be used alongside
+`zref-clever`. It provides "`\z...`" counterparts to `varioref`'s main
+reference commands, each of which essentially does some (scoped) setup for
+`varioref`, then calls the original one.
+
+License: LPPL Version 1.3c
+
+Repository: https://github.com/gusbrs/zref-vario
+
+Bug tracker: https://github.com/gusbrs/zref-vario/issues
+
+CTAN: https://ctan.org/pkg/zref-vario
diff --git a/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.pdf b/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.pdf
new file mode 100644
index 00000000000..00e63f3389d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.tex b/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.tex
new file mode 100644
index 00000000000..949376f1972
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/zref-vario-code.tex
@@ -0,0 +1,52 @@
+% \iffalse meta-comment
+%
+% File: zref-vario-code.tex
+%
+% This file is part of the LaTeX package "zref-vario".
+%
+% Copyright (C) 2022 Gustavo Barros
+%
+% It may be distributed and/or modified under the conditions of the
+% LaTeX Project Public License (LPPL), either version 1.3c of this
+% license or (at your option) any later version. The latest version
+% of this license is in the file:
+%
+% https://www.latex-project.org/lppl.txt
+%
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+%
+% This work is "maintained" (as per LPPL maintenance status) by
+% Gustavo Barros.
+%
+% This work consists of the files zref-vario.dtx,
+% zref-vario.ins,
+% zref-vario.tex,
+% zref-vario-code.tex,
+% and the files listed in MANIFEST.md.
+%
+% The released version of this package is available from CTAN.
+%
+% -----------------------------------------------------------------------
+%
+% The development version of the package can be found at
+%
+% https://github.com/gusbrs/zref-vario
+%
+% for those people who are interested.
+%
+% -----------------------------------------------------------------------
+%
+% \fi
+
+\documentclass{l3doc}
+
+% Have \GetFileInfo pick up date and version data.
+\usepackage{zref-vario}
+
+\begin{document}
+
+\DocInput{zref-vario.dtx}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/zref-vario/zref-vario.pdf b/Master/texmf-dist/doc/latex/zref-vario/zref-vario.pdf
new file mode 100644
index 00000000000..8ff1c89bca0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/zref-vario.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/zref-vario/zref-vario.tex b/Master/texmf-dist/doc/latex/zref-vario/zref-vario.tex
new file mode 100644
index 00000000000..522e46a2076
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/zref-vario/zref-vario.tex
@@ -0,0 +1,261 @@
+% \iffalse meta-comment
+%
+% File: zref-vario.tex
+%
+% This file is part of the LaTeX package "zref-vario".
+%
+% Copyright (C) 2022 Gustavo Barros
+%
+% It may be distributed and/or modified under the conditions of the
+% LaTeX Project Public License (LPPL), either version 1.3c of this
+% license or (at your option) any later version. The latest version
+% of this license is in the file:
+%
+% https://www.latex-project.org/lppl.txt
+%
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+%
+% This work is "maintained" (as per LPPL maintenance status) by
+% Gustavo Barros.
+%
+% This work consists of the files zref-vario.dtx,
+% zref-vario.ins,
+% zref-vario.tex,
+% zref-vario-code.tex,
+% and the files listed in MANIFEST.md.
+%
+% The released version of this package is available from CTAN.
+%
+% -----------------------------------------------------------------------
+%
+% The development version of the package can be found at
+%
+% https://github.com/gusbrs/zref-vario
+%
+% for those people who are interested.
+%
+% -----------------------------------------------------------------------
+%
+% \fi
+
+\documentclass{l3doc}
+
+% The package itself *must* be loaded so that \GetFileInfo can pick up date
+% and version data.
+\usepackage{zref-vario}
+
+\usepackage[T1]{fontenc}
+
+\usepackage[sc]{mathpazo}
+\linespread{1.05}
+\usepackage[scale=.88]{tgheros} % sans
+\usepackage[varqu,scaled=1.03]{inconsolata} % tt
+
+\usepackage{listings}
+
+\usepackage{microtype}
+
+\hypersetup{hidelinks}
+
+\NewDocumentCommand\opt{m}{\texttt{#1}}
+
+\lstdefinestyle{code}{
+ language=[LaTeX]TeX,
+ % moretexcs={
+ % }
+}
+\lstdefinestyle{zrefvario}{
+ style=code,
+ % moretexcs={
+ % }
+}
+\lstset{
+ style=zrefvario,
+ basicstyle=\ttfamily\small,
+ columns=fullflexible,
+ keepspaces,
+ xleftmargin=\leftmargin,
+ xrightmargin=.5\leftmargin,
+}
+\lstnewenvironment{zvexample}[1][]{%
+ \renewcommand{\lstlistingname}{Example}%
+ \lstset{#1}%
+}{}
+
+\begin{document}
+
+\GetFileInfo{zref-vario.sty}
+
+\title{%
+ The \pkg{zref-vario} package%
+ \thanks{This file describes \fileversion, released \filedate.}%
+ \texorpdfstring{\\{}\medskip{}}{ - }%
+ User manual%
+ \texorpdfstring{\medskip{}}{}%
+}
+
+\author{%
+ Gustavo Barros%
+ \thanks{\url{https://github.com/gusbrs/zref-vario}}%
+}
+
+\date{\filedate}
+
+\maketitle
+
+\begin{center}
+ {\bfseries \abstractname\vspace{-.5em}\vspace{0pt}}
+\end{center}
+
+\begin{quotation}
+ \pkg{zref-vario} offers a compatibility layer for \pkg{varioref} to be used
+ alongside \pkg{zref-clever}. It provides ``\texttt{\cs{z}}\dots{}''
+ counterparts to \pkg{varioref}'s main reference commands, each of which
+ essentially does some (scoped) setup for \pkg{varioref}, then calls the
+ original one.
+\end{quotation}
+
+\bigskip{}
+
+\begin{center}
+ \textbf{EXPERIMENTAL}
+\end{center}
+
+\tableofcontents
+
+\clearpage{}
+
+\section{Loading the package}
+
+As usual:
+
+\begin{zvexample}
+\usepackage{zref-vario}
+\end{zvexample}
+
+
+\section{Dependencies}
+
+\pkg{zref-vario} requires \pkg{varioref} and \pkg{zref-clever}.
+
+
+\section{User interface}
+
+\begin{function}{\zvref}
+ \begin{syntax}
+ \cs{zvref}\meta{*}\oarg{options}\marg{label}
+ \end{syntax}
+\end{function}
+
+\begin{function}{\zvpageref}
+ \begin{syntax}
+ \cs{zvpageref}\meta{*}\oarg{options}\marg{label}
+ \end{syntax}
+\end{function}
+
+\begin{function}{\zvrefrange}
+ \begin{syntax}
+ \cs{zvrefrange}\meta{*}\oarg{options}\marg{label}\marg{label}
+ \end{syntax}
+\end{function}
+
+\begin{function}{\zvpagerefrange}
+ \begin{syntax}
+ \cs{zvpagerefrange}\meta{*}\oarg{options}\marg{label}\marg{label}
+ \end{syntax}
+\end{function}
+
+\begin{function}{\zfullref}
+ \begin{syntax}
+ \cs{zfullref}\meta{*}\oarg{options}\marg{label}
+ \end{syntax}
+\end{function}
+
+These user commands work pretty much as their \pkg{varioref}
+counterparts.\footnote{If you are not acquainted with them, see
+ \pkg{varioref}'s documentation.} Indeed, they are just wrappers around
+them. As such, differently from \pkg{zref-clever}'s commands, these can
+receive single labels as arguments, not lists of them. In all of them the
+starred version inhibits hyperlinking, and they (locally) set \pkg{varioref}'s
+\opt{nospace} option, so that the this syntax can be used unambiguously.
+
+All of them have a single optional argument, which can receive any of
+\cs{zcref}'s options, and those are set for calls to \cs{zcref} or
+\cs{zpageref} which are part of the building blocks of the reference formats
+and strings set for \pkg{varioref}. However, there is indeed some potential
+friction and caveats stemming from the use of these options, which were
+designed to work for single calls of \cs{zcref}, to apply to \emph{pairs} of
+them. Hence, whether each and every of these options is meaningful, useful,
+or potentially harmful in this context depends on the case, and it is up to
+the user to make proper use of them. Of course, one can always split the pair
+using \cs{zcref} and then \cs{zvpageref}, \cs{zvpagerefrange}, or
+\cs{zcpageref}, and have more control over each part. Anyway, the package
+does what it says: passes the options along to the underlying call(s) to
+\cs{zcref}.\footnote{Note that the options given to each call of these user
+ macros are set \emph{before} the call to the original \pkg{varioref}
+ counterpart. This means that options given to \cs{zcref} or \cs{zpageref}
+ in the strings and formats in \cs{zvLanguageSetup} will have precedence over
+ the former. Which is useful, so that we can distinguish to some degree the
+ first from the second call of \cs{zcref}/\cs{zpageref} done in the formats,
+ but does not eliminate the limitations which arise from the underlying
+ problem.}
+
+Besides these options, two other are provided corresponding to
+\pkg{varioref}'s commands' optional arguments: \opt{vcurrent} (the first
+optional argument) and \opt{vother} (the second optional argument). Of
+course, these are only available when the underlying \pkg{varioref} command
+supports them.
+
+\section{Customization}
+
+
+\begin{function}{\zvLanguageSetup}
+ \begin{syntax}
+ \cs{zvLanguageSetup}\marg{language}\marg{options}
+ \end{syntax}
+\end{function}
+
+User interface for customization of ``strings'' and ``formats'' for
+\meta{language}. \meta{language} must be known to \pkg{zref-clever}. The
+\meta{options} are familiar to users of \pkg{varioref}:
+\opt{reftextfaceafter}, \opt{reftextfacebefore}, \opt{reftextafter},
+\opt{reftextbefore}, \opt{reftextcurrent}, \opt{reftextfaraway},
+\opt{reftextpagerange}, \opt{reftextlabelrange}, \opt{vrefformat},
+\opt{vrefrangeformat}, and \opt{fullrefformat}.\footnote{For details, see
+ \pkg{varioref}'s documentation.} Their meaning is the same as the ones they
+have in \pkg{varioref} and, indeed, they work by setting those \pkg{varioref}
+macros to the values given to the corresponding options in
+\cs{zvLanguageSetup}. If you are setting up a language which has no built-in
+support, you should set at least the whole set of ``\texttt{reftext}\dots{}''
+options. Language independent default values are provided for the
+``\dots{}\texttt{format}'' options (equivalent to the ones from
+\pkg{varioref}, which are adequate to most use cases), so you may omit them.
+But, if you need to adjust them, the default values can be overridden by
+setting the corresponding options in \cs{zvLanguageSetup}.
+
+
+% \section{Acknowledgments}
+%
+% A number of people have contributed to \pkg{zref-vario}. Suggestions,
+% ideas, solutions to problems, bug reports or even encouragement were
+% generously provided by (in chronological order):
+%
+% The package's language settings have been provided or improved thanks to:
+%
+% If I have inadvertently left anyone off the list I apologize, and please let
+% me know, so that I can correct the oversight.
+%
+% Thank you all very much!
+
+
+\section{Change history}
+
+A change log with relevant changes for each version, eventual upgrade
+instructions, and upcoming changes, is maintained in the package's repository,
+at \url{https://github.com/gusbrs/zref-vario/blob/main/CHANGELOG.md}. An
+archive of historical versions of the package is also kept at
+\url{https://github.com/gusbrs/zref-vario/releases}.
+
+\end{document}