From 41d36a6ccdbe245ef49d7979b1435f03e0794e48 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 20 Jul 2014 22:12:35 +0000 Subject: fancylabel (20jul14) git-svn-id: svn://tug.org/texlive/trunk@34669 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/fancylabel/fancylabel.pdf | Bin 0 -> 228751 bytes .../source/latex/fancylabel/fancylabel.dtx | 1621 ++++++++++++++++++++ .../source/latex/fancylabel/fancylabel.ins | 50 + .../texmf-dist/tex/latex/fancylabel/fancylabel.sty | 933 +++++++++++ Master/tlpkg/bin/tlpkg-ctan-check | 2 +- Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc | 1 + Master/tlpkg/tlpsrc/fancylabel.tlpsrc | 0 7 files changed, 2606 insertions(+), 1 deletion(-) create mode 100755 Master/texmf-dist/doc/latex/fancylabel/fancylabel.pdf create mode 100755 Master/texmf-dist/source/latex/fancylabel/fancylabel.dtx create mode 100755 Master/texmf-dist/source/latex/fancylabel/fancylabel.ins create mode 100644 Master/texmf-dist/tex/latex/fancylabel/fancylabel.sty create mode 100644 Master/tlpkg/tlpsrc/fancylabel.tlpsrc diff --git a/Master/texmf-dist/doc/latex/fancylabel/fancylabel.pdf b/Master/texmf-dist/doc/latex/fancylabel/fancylabel.pdf new file mode 100755 index 00000000000..08adba7a84d Binary files /dev/null and b/Master/texmf-dist/doc/latex/fancylabel/fancylabel.pdf differ diff --git a/Master/texmf-dist/source/latex/fancylabel/fancylabel.dtx b/Master/texmf-dist/source/latex/fancylabel/fancylabel.dtx new file mode 100755 index 00000000000..3c67c67a781 --- /dev/null +++ b/Master/texmf-dist/source/latex/fancylabel/fancylabel.dtx @@ -0,0 +1,1621 @@ +% \iffalse meta-comment +% +% Copyright (C) 2014 by Dominik Siegel +% +% This file may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either +% version 1.2 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.2 or later is part of all distributions of +% LaTeX version 1999/12/01 or later. +%% +%% To produce the documentation, do the following +%% +%% latex fancylabel.dtx +%% latex fancylabel.dtx +%% makeindex -s gind.ist -o fancylabel.ind fancylabel.idx +%% latex fancylabel.dtx +% +% \NeedsTeXFormat{LaTeX2e}[2005/12/01] +% \ProvidesPackage{fancylabel} +% [2014/07/15 v1.0] +% +%<*driver> +\documentclass{ltxdoc} +\usepackage[numbering=continuous,families={mark,sym},level=sub,sort=true]{fancylabel} +\usepackage{subfig} +\usepackage[hidelinks]{hyperref} +\GetFileInfo{fancylabel.dtx} +\EnableCrossrefs +\CodelineIndex +\RecordChanges +\OnlyDescription +\date{2014/07/15} +\begin{document} + \DocInput{fancylabel.dtx} +\end{document} +% +% \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 \~} +% +% \changes{v1.0}{2014/07/15}{Initial version} +% +% \GetFileInfo{fancylabel.sty} +% +% \DoNotIndex{\@auxout,\@end@token,\@ifnextchar,\@ifundefined,\@namedef,\@nameuse,\@onlypreamble} +% \DoNotIndex{\alph,\arabic,\AtEndDocument} +% \DoNotIndex{\csname} +% \DoNotIndex{\DeclareOptionX,\DeclareRobustCommand,\def,\define@choicekey,\define@key} +% \DoNotIndex{\else,\endcsname,\equal,\expandafter} +% \DoNotIndex{\fi} +% \DoNotIndex{\g@addto@macro,\global} +% \DoNotIndex{\ifcase,\ifthenelse,\immediate} +% \DoNotIndex{\NeedsTeXFormat,\newcommand,\newcounter,\newif,\nr} +% \DoNotIndex{\or} +% \DoNotIndex{\PackageError,\PackageWarning,\presetkeys,\ProcessOptionsX,\ProvidesPackage} +% \DoNotIndex{\relax,\RequirePackage} +% \DoNotIndex{\setcounter,\stepcounter,\string} +% \DoNotIndex{\val} +% \DoNotIndex{\write} +% \DoNotIndex{\xdef} +% +% \title{The \textsf{fancylabel} package\thanks{This document corresponds to \textsf{fancylabel}~\fileversion{}, dated \filedate.}} +% +% \author{Dominik Siegel \\ \texttt{dominik.siegel@yahoo.de}} +% +% \maketitle +% +% \begin{abstract} +% For \LaTeX{} referencing it is necessary to have unique labels. But sometimes you have similar objects (symbols, chemical structures, etc.) that appear more often than once in your document. When you write your document you cannot know from the beginning on in which position your object appears for the first time. Hence you don't know whether to place a |\label| or a |\ref|. +% +% This package basically provides the two new commands |\fancylabel| and |\fancyref|. With the |\fancylabel| command you don't have to know if it is time to set a |\label| or a |\ref|, |\fancylabel| will decide this for you. +% +% Additionally this package allows you various different numerations including numbering order, numbering level and numbering families. +% \end{abstract} +% +% +% \tableofcontents +% +% \section{Introduction} +% +% The idea of referencing in \LaTeX{} is to associate an object with a |\label|. Whenever you want to refer to it you just use |\ref|. This works as long as you have an unique object like a figure, a table, a section etc. But if you want the refer to repeating objects which are expected to have the same number like symbols, (chemical-) structures etc. referencing becomes more complex. +% +% \newcounter{mylabelcounter} +% \newcommand{\mylabel}[1]{\refstepcounter{mylabelcounter}\themylabelcounter\label{#1}} +% \begin{figure}[h] +% \centering +% \begin{tabular}{cccc} +% \Huge$\rightarrow$ & \Huge$\leftarrow$ & +% \Huge$\rightarrow$ & \Huge$\Leftarrow$ \\ +% \mylabel{arrow1} & \mylabel{arrow2} & +% \ref{arrow1} & \mylabel{arrow3} +% \end{tabular} +% \caption{Some repeating objects. Here we refer to symbol \ref{arrow2}.} +% \end{figure} +% +% In our example same arrows are supposed to get the same number. We define a counter and a new label command. This was actually quite simple. But the big disadvantage of this solution is, that you always have to take care where your object occurs for the first time. At the first occurrence you have to label it, at any other occurrence you have to refer. Every time you change the order you have to adjust the labeling by hand. +% +% \begin{verbatim} +% \newcounter{mylabelcounter} +% \newcommand{\mylabel}[1]{\refstepcounter{mylabelcounter}\themylabelcounter\label{#1}} +% \begin{figure}[h] +% ...figure code... +% \begin{tabular}{cccc} +% \Huge$\rightarrow$ & \Huge$\leftarrow$ & +% \Huge$\rightarrow$ & \Huge$\Leftarrow$ \\ +% \mylabel{arrow1} & \mylabel{arrow2} & +% \ref{arrow1} & \mylabel{arrow3} +% \end{tabular} +% ...figure code... +% \end{figure} +% \end{verbatim} +% +% Beside other additional functions and options this is exactly what the \textsf{fancylabel} package does for you. Whenever you insert an object you can use |\fancylabel|. The package will recognize if the label already exists and therefore decides whether to label or to refer. +% +% \begin{verbatim} +% \begin{figure}[h] +% ...figure code... +% \begin{tabular}{cccc} +% \Huge$\rightarrow$ & \Huge$\leftarrow$ & +% \Huge$\rightarrow$ & \Huge$\Leftarrow$ \\ +% \fancylabel{arrow1} & \fancylabel{arrow2} & +% \fancylabel{arrow1} & \fancylabel{arrow3} +% \end{tabular} +% ...figure code... +% \end{figure} +% \end{verbatim} +% \fancylabel*{arrow1,arrow2,arrow3} +% +% +% \section{Package Commands} +% \subsection{Label commands} +% \DescribeMacro{\fancylabel} +% \DescribeMacro{\fancylabel*} +% |\fancylabel[]{}|\\ +% |\fancylabel*[]{}|\vspace{0.5em} +% +% \noindent The |\fancylabel| command always checks if a label for || already exists and creates it if not. Then it prints the reference as |\fancyref| does. Additionally a || can be defined (For description see section \ref{fam}). The starred versions create a label without printing the reference. +% +% The argument || might also be a comma-separated list of indentifiers. In this case |\fancylabel| creates a label for all so far undefined indentifiers and prints a list of references. This list can be sorted and compressed automatically (see section \ref{sort} and \ref{compress}). +% +% +% \subsection{Sublabel commands} +% \DescribeMacro{\fancysublabel} +% \DescribeMacro{\fancysublabel-} +% \DescribeMacro{\fancysublabel*} +% |\fancysublabel[]{}{}|\\ +% |\fancysublabel-[]{}{}|\\ +% |\fancysublabel*[]{}{}|\vspace{0.5em} +% +% \noindent The |\fancysublabel| command is working in the same way as |\fancylabel| while providing a second level of referencing. If the corresponding label for || was not previously defined, it will be created as well. The output of |\fancysublabel| is the complete reference consisting in label and sublabel (e.\,g. 1a). The output of |\fancysublabel-| is only the sublabel (e.\,g. a). The starred version |\fancysublabel*| creates the sublabel without any output. +% +% While the argument || has to be a single indentifier, the || argument might be a comma-separated list. In this case |\fancysublabel| creates a sublabel for all so far undefined indentifiers and prints a list of references. This list can be sorted and compressed automatically (see section \ref{sort} and \ref{compress}). +% +% +% \subsection{Ref and subref commands} +% \DescribeMacro{\fancyref} +% \DescribeMacro{\fancyref*} +% \DescribeMacro{\fancysubref} +% \DescribeMacro{\fancysubref-} +% \DescribeMacro{\fancysubref*} +% |\fancyref[]{}|\\ +% |\fancyref*[]{}|\\ +% |\fancysubref[]{}{}|\\ +% |\fancysubref-[]{}{}|\\ +% |\fancysubref*[]{}{}|\vspace{0.5em} +% +% \noindent The function of these commands is compareable to their corresponding label commands. |\fancyref| prints the reference of || and remembers that this || has been requested. |\fancyref*| remembers the request without any output. +% +% |\fancysubref| prints the label and sublabel of || and || and remembers the request. |\fancysubref-| prints only the sublabel and remembers the request. |\fancysubref*| does only remember the request. +% +% +% \section{Options} +% \subsection{The families option}\label{fam} +% \DescribeMacro{families=} +% |\usepackage[families={}]{fancylabel}|\vspace{0.5em} +% +% \noindent You can define different families for your labels to have different counters. This can be done with the |families| option. If you don't specify the family in label or ref commands |family=default| will be used. This is the only predefined family. +% +% +% \begin{verbatim} +% \begin{figure}[h] +% ...figure code... +% \begin{tabular}{cccc} +% \Huge$\rightarrow$ & \Large\textcopyright & +% \Huge$\oplus$ & \Huge$\ominus$ \\ +% \fancylabel{arrow1} & \fancylabel[mark]{mark1} & +% \fancylabel[sym]{symbol1} & \fancylabel[sym]{symbol2} +% \end{tabular} +% ...figure code... +% \end{figure} +% \end{verbatim} +% +% \begin{figure}[h] +% \centering +% \begin{tabular}{cccc} +% \Huge$\rightarrow$ & \Large\textcopyright & +% \Huge$\oplus$ & \Huge$\ominus$ \\ +% \fancylabel{arrow1} & \fancylabel[mark]{mark1} & +% \fancylabel[sym]{symbol1} & \fancylabel[sym]{symbol2} +% \end{tabular} +% \caption{Objects of different families. For this example the families \texttt{mark} and \texttt{sym} have been defined using the family option.} +% \end{figure} +% +% +% +% The (sub-)labels and (sub-)refs will have |-| as prefix. This Prefix can be changed by redefining |\fancylabelformat| and |\fancysublabelformat|. For example the definition of the default-prefix can be changed by: +% \begin{verbatim} +% \renewcommand{\fancylabelformatdefault}{\arabic{fancylabel}} +% \end{verbatim} +% +% +% \subsection{The IgnoreFamilies option} +% \DescribeMacro{IgnoreFamilies=} +% |\usepackage[IgnoreFamilies=]{fancylabel}|\vspace{0.5em} +% +% \noindent If the option |IgnoreFamilies=true|, every label will be interpreted as it would be part of the |default| family. +% +% \subsection{The numbering option} +% \DescribeMacro{numbering=} +% |\usepackage[numbering=]{fancylabel}|\vspace{0.5em} +% +% \noindent The option |numbering| can have one of the following values: |continuous| (default), |ondemand| or |referenced|. We will now have a look on the following code compiled with different values for this option. +% +% \begin{verbatim} +% ...figure code... +% \begin{tabular}{cccc} +% \Huge$\Rightarrow$ & \Huge$\Leftrightarrow$ & +% \Huge$\Leftarrow$ & \Huge$\rightleftharpoons$ \\ +% \fancylabel{arrow4} & \fancylabel{arrow5} & +% \fancylabel{arrow6} & \fancylabel{arrow7} +% \end{tabular} +% \caption{This is some random text where I refer to symbol% +% \fancyref{arrow7} and symbol \fancyref{arrow5}.} +% ...figure code... +% \end{verbatim} +% +% \DescribeMacro{numbering=continuous} +% The |continuous| numbering means, that every |\fancylabel| will get its reference. The referencing order is in the order |\fancylabel| asked for. +% +% \fancylabelResetCounter{default} +% \begin{figure}[h] +% \centering +% \begin{tabular}{cccc} +% \Huge$\Rightarrow$ & \Huge$\Leftrightarrow$ & +% \Huge$\Leftarrow$ & \Huge$\rightleftharpoons$ \\ +% \fancylabel{arrow4} & \fancylabel{arrow5} & +% \fancylabel{arrow6} & \fancylabel{arrow7} +% \end{tabular} +% \caption{This is some random text where I refer to symbol \fancyref{arrow7} and symbol \fancyref{arrow5}.} +% \end{figure} +% +% \DescribeMacro{numbering=ondemand} +% The |ondemand| numbering means, that a |\fancylabel| will only get its reference, if a |\fancyref| refered to it. The referencing order is in the order |\fancylabel| asked for. +% +% \begin{figure}[h] +% \centering +% \begin{tabular}{cccc} +% \Huge$\Rightarrow$ & \Huge$\Leftrightarrow$ & +% \Huge$\Leftarrow$ & \Huge$\rightleftharpoons$ \\ +% & 1 & +% & 2 +% \end{tabular} +% \caption{This is some random text where I refer to symbol 2 and symbol 1.} +% \end{figure} +% +% \DescribeMacro{numbering=referenced} +% The |referenced| numbering means, that a |\fancylabel| will only get its reference, if a |\fancyref| refered to it. The referencing order is in the order |\fancyref| asked for. +% +% \begin{figure}[h] +% \centering +% \begin{tabular}{cccc} +% \Huge$\Rightarrow$ & \Huge$\Leftrightarrow$ & +% \Huge$\Leftarrow$ & \Huge$\rightleftharpoons$ \\ +% & 2 & +% & 1 +% \end{tabular} +% \caption{This is some random text where I refer to symbol 1 and symbol 2.} +% \end{figure} +% +% +% +% \subsection{The level option} +% \DescribeMacro{level=} +% |\usepackage[level=]{fancylabel}|\vspace{0.5em} +% +% \noindent The option |level| can have one of the following values: |sub| (default) or |same|. The value |sub| means, that all sublabels defined by |\fancysublabel| are interpreted as thought (two level numbering). The value |same| means, that all sublabels are interpreted as the would be labels defined with |\fancylabel| (one level numbering). +% +% \begin{verbatim} +% \begin{figure}[h] +% \centering +% \begin{tabular}{ccc} +% \Huge$\diamondsuit$ & +% \Huge$\heartsuit$ & +% \Huge$\spadesuit$ \\ +% \fancysublabel{cards}{diamond} & +% \fancysublabel{cards}{heart} & +% \fancysublabel{cards}{spade} \\ +% \end{tabular} +% \end{figure} +% \end{verbatim} +% +% \captionsetup[subfigure]{labelformat=empty} +% \begin{figure}[h] +% \centering +% \subfloat[Option \texttt{level=sub}.]{ +% \begin{tabular}{ccc} +% \Huge$\diamondsuit$ & +% \Huge$\heartsuit$ & +% \Huge$\spadesuit$ \\ +% \fancysublabel{cards}{diamond} & +% \fancysublabel{cards}{heart} & +% \fancysublabel{cards}{spade} \\ +% \end{tabular} +% }\quad\quad +% \subfloat[Option \texttt{level=same}.]{% +% \begin{tabular}{ccc} +% \Huge$\diamondsuit$ & +% \Huge$\heartsuit$ & +% \Huge$\spadesuit$ \\ +% 5 & +% 6 & +% 7 \\ +% \end{tabular} +% } +% \end{figure} +% +% +% \subsection{The sort option}\label{sort} +% \DescribeMacro{sort=} +% |\usepackage[sort=]{fancylabel}|\vspace{0.5em} +% +% \noindent If |sort=true| the output of fancylabels und fancyrefs will be sorted. By default this option is |false|. +% +% +% \subsection{The compress option}\label{compress} +% \DescribeMacro{compress=} +% |\usepackage[compress=]{fancylabel}|\vspace{0.5em} +% +% \noindent If |compress=true| the output of fancylabels und fancyrefs compressed. By default this option is |false|. +% +% +% \subsection{The CompressLink option} +% \DescribeMacro{CompressLink=} +% |\usepackage[CompressLink=]{fancylabel}|\vspace{0.5em} +% +% \noindent With the |CompressLink| option you can define the separator between the compressed labels. The default value is |CompressLink={-}|. +% +% +% \subsection{The CompressTwo option} +% \DescribeMacro{CompressTwo=} +% |\usepackage[CompressTwo=]{fancylabel}|\vspace{0.5em} +% +% \noindent By this option you can define if compression takes place even if there are only two sequential labels. By default this option is |false|. Example: |CompressTwo=true| $\rightarrow$ 1-2 and 1-3 or |CompressTwo=false| $\rightarrow$ 1,2 but 1-3. +% +% +% \subsection{The ListLastSublabelOnly option} +% \DescribeMacro{ListLastSublabelOnly=} +% |\usepackage[ListLastSublabelOnly=]{fancylabel}|\vspace{0.5em} +% +% \noindent If |ListLastSublabelOnly=true| (default), the output of a list of fancysublabels of fancysublabels is e.\,g. 1a-d,e. If |ListLastSublabelOnly=false|, the output of a list of fancysublabels of fancysublabels is e.\,g. 1a-1d,1e. +% +% +% \subsection{The ListSeparator option} +% \DescribeMacro{ListSeparator=} +% |\usepackage[ListSeparator=]{fancylabel}|\vspace{0.5em} +% +% \noindent This option defines the separator between two non-compressed values in a list. By default, |ListSeparator={,\hskip-0.16667em{ }}| which is a small white space allowing linebreak. +% +% +% \subsection{The ListLastLabelSeparator option} +% \DescribeMacro{ListLastLabelSeparator=} +% |\usepackage[ListLastLabelSeparator=]{fancylabel}|\vspace{0.5em} +% +% \noindent This option defines the separator between the last two values in a list (e.\,g. \texttt{ListLastLabelSeparator=\{\raisebox{-0.23em}{\textasciitilde}and\raisebox{-0.23em}{\textasciitilde}}\} $\rightarrow$ 1a-c,d~and~f). By default, this option has the same value as the |ListSeparator| option. Note: This option will only be applied in label commands! +% +% +% \subsection{The ListLastRefSeparator option} +% \DescribeMacro{ListLastRefSeparator=} +% |\usepackage[ListLastRefSeparator=]{fancylabel}|\vspace{0.5em} +% +% \noindent This option behaves like the |ListLastLabelSeparator| option but will only be applied in ref commands. +% +% +% \subsection{The DisableFamilyCheck option} +% \DescribeMacro{DisableFamilyCheck=} +% |\usepackage[DisableFamilyCheck=]{fancylabel}|\vspace{0.5em} +% +% \noindent When a new |\fancylabel| is defined the \textsf{fancylabel} package checks whether this || has already been used in other families and prints a warning. The option |DisableFamilyCheck=true| disables this check. The default value is |DisableFamilyCheck=false|. +% +% +% \section{Customization} +% \subsection{Reset counters} +% The label counters of each family can be reset by using the following command. Note that |=0| means that the next label will get the value 1. Note: This might cause crazy lists if the options |sort| or |compress| are used! +% \begin{verbatim} +% \renewcommand{\fancylabel@familystorage@}{} +% \end{verbatim} +% +% +% \subsection{Label und sublabel format} +% The format of labels and sublabels of each family can be adjusted by redefining the corresponding labelformat. In the following example you have to replace || by |default| to adjust the format of the default family. +% \begin{verbatim} +% \renewcommand{\fancylabelformat}{\arabic{fancylabel}} +% \renewcommand{\fancysublabelformat}{\arabic{fancylabel}\alph{fancysublabel}} +% \renewcommand{\fancyonlysublabelformat}{\alph{fancysublabel}} +% \end{verbatim} +% +% +% \subsection{NewLabelEvent} +% If you want to execute a macro everytime a new label has been defined you can modify the following command: +% \begin{verbatim} +% \fancylabelNewLabelEvent +% \end{verbatim} +% +% +% \subsection{ShowLabelEvent} +% If you want to execute a macro everytime a label is shown you can modify the following command: +% \begin{verbatim} +% \fancylabelShowLabelEvent +% \end{verbatim} +% +% +% \subsection{ShowRefEvent} +% If you want to execute a macro everytime a label is shown you can modify the following command: +% \begin{verbatim} +% \fancylabelShowRefEvent +% \end{verbatim} +% +% +% \subsection{Lists of labels} +% The \textsf{fancylabel} package draws up a comma-separated list of all labels that have been defined for each family. You can use these lists for further costumization. +% \begin{verbatim} +% \fancylabel@list@ +% \end{verbatim} +% +% +% +% \StopEventually{} +% +% \section{The implementation} +% +% \subsection{Identification} +% \begin{macrocode} +\NeedsTeXFormat{LaTeX2e}[2005/12/01] +\ProvidesPackage{fancylabel}[2014/07/15 v1.0 Referencing in a fancy way] +% \end{macrocode} +% +% \subsection{Loading packages and define counters} +% \begin{macrocode} +\RequirePackage{xkeyval} +\RequirePackage{ifthen} +\RequirePackage{suffix} +\newcounter{fancylabel} +\setcounter{fancylabel}{0} +\newcounter{fancysublabel} +\setcounter{fancysublabel}{0} +\presetkeys{fancylabel}{numbering=continuous,% + level=sub,% + IgnoreFamilies=false,% + sort=false,% + compress=false,% + CompressLink={-},% + CompressTwo=false,% + ListLastSublabelOnly=true, + ListSeparator={,\hskip-0.16667em{ }},% + ListLastLabelSeparator=\fancyref@ListSeparator,% + ListLastRefSeparator=\fancyref@ListSeparator,% + DisableFamilyCheck=false% + }{} +% \end{macrocode} +% +% \subsection{The options} +% \begin{macro}{\fancyref@addtolist} +% \begin{macrocode} +\newcommand{\fancyref@addtolist}[2]{% + % #1=value to be added to the list #2 + % #2=list + \ifthenelse{\equal{#1}{}}{}{% + \ifthenelse{\equal{#2}{}}{}{% + \g@addto@macro{#2}{,}% + }% + \g@addto@macro{#2}{#1}% + }% +} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\fancyref@addtoprintlist} +% \begin{macrocode} +\newcommand{\fancyref@addtoprintlist}[2]{% + % #1=value to be added to the list #2 + % #2=list + \ifthenelse{\equal{#1}{}}{}{% + \ifthenelse{\equal{#2}{}}{}{% + \g@addto@macro{#2}{\fancyref@ListSeparator}% + }% + \g@addto@macro{#2}{#1}% + }% +} +% \end{macrocode} +% \end{macro} +% \begin{macro}{families=} +% \begin{macrocode} +\define@key{fancylabel}{families}{% + \fancyref@foreach{\fancyref@DefineFamily}{}{#1}% +} +\newcommand{\fancyref@ListOfFamilies}{} +\newcommand{\fancyref@DefineFamily}[2]{% + % #1=empty + % #2=family + \@namedef{fancylabel@familystorage@#2}{0}% + \@namedef{fancylabelformat#2}{#2-\arabic{fancylabel}}% + \@namedef{fancyonlysublabelformat#2}{\alph{fancysublabel}}% + \@namedef{fancysublabelformat#2}{#2-\arabic{fancylabel}\alph{fancysublabel}}% + \@namedef{fancylabel@list@#2}{}% + \fancyref@addtolist{#2}{\fancyref@ListOfFamilies}% +} +\@onlypreamble\fancyref@DefineFamily +\fancyref@DefineFamily{}{default} +\renewcommand{\fancylabelformatdefault}{\arabic{fancylabel}} +\renewcommand{\fancysublabelformatdefault}{\arabic{fancylabel}\alph{fancysublabel}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{numbering=} +% \begin{macrocode} +\define@choicekey*+{fancylabel}{numbering}[\val\nr]{continuous,ondemand,referenced}{% + % ##1=family + % ##2=label + % ##3=sublabel + \ifcase\nr\relax% + % numbering=continuous + % Label will be set un the first time, \fancylabel{} is called + % Order of labels depends on the appearance of fancylabel{} + \newcommand{\fancyref@define@LabelUndef}[3]{% + \fancyref@newlabel{##1}{##2}{##3}% + }% + \newcommand{\fancyref@show@LabelUndef}[3]{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + \newcommand{\fancyref@define@LabelDef}[3]{}% + \newcommand{\fancyref@show@LabelDef}[3]{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + \newcommand{\fancyref@define@RefUndef}[3]{}% + \newcommand{\fancyref@show@RefUndef}[3]{% + \@ifundefined{fancyref@PrevRun@##1@##2@##3}{% + \fancyref@labelerror{##2}{##3}% + ???% + }{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + }% + \newcommand{\fancyref@define@RefDef}[3]{}% + \newcommand{\fancyref@show@RefDef}[3]{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + \or% + % numbering=ondemand + % Only set label if it was asked for during the last run + % Order of labels depends on the appearance of fancylabel{} + \newcommand{\fancyref@define@LabelUndef}[3]{% + \@ifundefined{fancyref@AskedPrevRun@##1@##2@##3}{}{% + \fancyref@newlabel{##1}{##2}{##3}% + }% + }% + \newcommand{\fancyref@show@LabelUndef}[3]{% + \@ifundefined{fancyref@AskedPrevRun@##1@##2@##3}{}{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + }% + \newcommand{\fancyref@define@LabelDef}[3]{}% + \newcommand{\fancyref@show@LabelDef}[3]{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + \newcommand{\fancyref@define@RefUndef}[3]{}% + \newcommand{\fancyref@show@RefUndef}[3]{% + \@ifundefined{fancyref@PrevRun@##1@##2@##3}{% + \fancyref@labelerror{##2}{##3}% + ???% + }{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + }% + \newcommand{\fancyref@define@RefDef}[3]{}% + \newcommand{\fancyref@show@RefDef}[3]{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + \or% + % numbering=referenced + % Only set label if it was asked for during the last run + % Order of labels depends on the appearance of fancyref{} + \newcommand{\fancyref@define@LabelUndef}[3]{}% + \newcommand{\fancyref@show@LabelUndef}[3]{% + \@ifundefined{fancyref@AskedPrevRun@##1@##2@##3}{}{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + }% + \newcommand{\fancyref@define@LabelDef}[3]{}% + \newcommand{\fancyref@show@LabelDef}[3]{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + \newcommand{\fancyref@define@RefUndef}[3]{% + \fancyref@newlabel{##1}{##2}{##3}% + }% + \newcommand{\fancyref@show@RefUndef}[3]{% + \@ifundefined{fancyref@PrevRun@##1@##2@##3}{% + \fancyref@labelerror{##2}{##3}% + ???% + }{% + \fancyref@showlabel{##1}{##2}{##3}% + }% + }% + \newcommand{\fancyref@define@RefDef}[3]{% + \fancyref@newlabel{##1}{##2}{##3}% + }% + \newcommand{\fancyref@show@RefDef}[3]{% + \fancyref@showlabel{##1}{##2}{##3}% Show label + }% + \fi% +}{% + \PackageError{fancylabel}{This value is not allowed. Allowed values are:% + 'continuous'(default), 'ondemand', 'referenced'.}{}% +} +% \end{macrocode} +% \end{macro} +% \begin{macro}{level=} +% \begin{macrocode} +\define@choicekey*+{fancylabel}{level}[\val\nr]{sub,same}{% + % ##1=family + % ##2=label + % ##3=sublabel + \ifcase\nr\relax% + % level=sub + \DeclareRobustCommand\fancysublabel[3][default]{{% + \fancysubreftrue% + \fancyref@subrefminusfalse% + \@fancylabel{##1}{##2}{##3}% + }}% + \WithSuffix\DeclareRobustCommand\fancysublabel-[3][default]{{% + \fancysubreftrue% + \fancyref@subrefminustrue% + \@fancylabel{##1}{##2}{##3}% + }}% + \WithSuffix\DeclareRobustCommand\fancysublabel*[3][default]{{% + \renewcommand{\@@fancylabel@show}[2]{}% + \fancysubreftrue% + \fancyref@subrefminusfalse% + \@fancylabel{##1}{##2}{##3}% + }}% + \DeclareRobustCommand\fancysubref[3][default]{{% + \fancysubreftrue% + \fancyref@subrefminusfalse% + \@fancyref{##1}{##2}{##3}% + }}% + \WithSuffix\DeclareRobustCommand\fancysubref-[3][default]{{% + \fancysubreftrue% + \fancyref@subrefminustrue% + \@fancyref{##1}{##2}{##3}% + }}% + \WithSuffix\DeclareRobustCommand\fancysubref*[3][default]{{% + \renewcommand{\@@fancylabel@show}[2]{}% + \fancysubreftrue% + \fancyref@subrefminusfalse% + \@fancyref{##1}{##2}{##3}% + }}% + \or% + % level=same + \DeclareRobustCommand\fancysublabel[3][default]{{% + \fancysubreffalse% + \fancyref@subrefminusfalse% + \@fancylabel{##1}{##2}{##3}% + }}% + \WithSuffix\DeclareRobustCommand\fancysublabel-[3][default]{{% + \fancysubreffalse% + \fancyref@subrefminustrue% + \@fancylabel{##1}{##2}{##3}% + }}% + \WithSuffix\DeclareRobustCommand\fancysublabel*[3][default]{{% + \renewcommand{\@@fancylabel@show}[2]{}% + \fancysubreffalse% + \fancyref@subrefminusfalse% + \@fancylabel{##1}{##2}{##3}% + }}% + \DeclareRobustCommand\fancysubref[3][default]{{% + \fancysubreffalse% + \fancyref@subrefminusfalse% + \@fancyref{##1}{##2}{##3}% + }}% + \WithSuffix\DeclareRobustCommand\fancysubref-[3][default]{{% + \fancysubreffalse% + \fancyref@subrefminustrue% + \@fancyref{##1}{##2}{##3}% + }}% + \WithSuffix\DeclareRobustCommand\fancysubref*[3][default]{{% + \renewcommand{\@@fancylabel@show}[2]{}% + \fancysubreffalse% + \fancyref@subrefminusfalse% + \@fancyref{##1}{##2}{##3}% + }}% + \fi% +}{% + \PackageError{fancylabel}{This value is not allowed. Allowed values are:% + 'sub'(default), 'same'.}{}% +} +\newif\iffancyref@subrefminus\fancyref@subrefminusfalse +% \end{macrocode} +% \end{macro} +% \begin{macro}{IgnoreFamilies=} +% \begin{macrocode} +\define@boolkey{fancylabel}{IgnoreFamilies}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{sort=} +% \begin{macrocode} +\define@boolkey{fancylabel}{sort}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{compress=} +% \begin{macrocode} +\define@boolkey{fancylabel}{compress}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{CompressLink=} +% \begin{macrocode} +\define@key{fancylabel}{CompressLink}{\def\fancyref@CompressLink{#1}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{CompressTwo=} +% \begin{macrocode} +\define@boolkey{fancylabel}{CompressTwo}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{ListLastSublabelOnly=} +% \begin{macrocode} +\define@boolkey{fancylabel}{ListLastSublabelOnly}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{ListSeparator=} +% \begin{macrocode} +\define@key{fancylabel}{ListSeparator}{\edef\fancyref@ListSeparator{#1}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{ListLastLabelSeparator=} +% \begin{macrocode} +\define@key{fancylabel}{ListLastLabelSeparator}{\edef\fancyref@ListLastLabelSeparator{#1}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{ListLastRefSeparator=} +% \begin{macrocode} +\define@key{fancylabel}{ListLastRefSeparator}{\edef\fancyref@ListLastRefSeparator{#1}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{DisableFamilyCheck=} +% \begin{macrocode} +\define@boolkey{fancylabel}{DisableFamilyCheck}{} +% \end{macrocode} +% \end{macro} +% \subsection{Error routines} +% \begin{macrocode} +% Error routines +\newif\iffancyref@rerunerror\fancyref@rerunerrorfalse % ReRun error +\newif\iffancysubref\fancysubreffalse % Subref or Ref +\AtEndDocument{% + \iffancyref@rerunerror% + \PackageWarning{fancylabel}{Fancylabels may have changed. % + Please run latex again.}% + \fi% +} +\newcommand{\fancyref@labelerror}[2]{% + % #1=label + % #2=sublabel + \ifthenelse{\equal{#2}{}}{% + \PackageWarning{fancylabel}{Undefined fancylabel "#1".}% + }{% + \PackageWarning{fancylabel}{Undefined fancysublabel "#1@#2".}% + }% + \global\fancyref@rerunerrortrue% +} +% \end{macrocode} +% \subsection{User macros} +% \begin{macro}{\fancylabel} +% \begin{macrocode} +\DeclareRobustCommand\fancylabel[2][default]{{% + % #1=family + % #2=label or list of labels + \fancysubreffalse% + \@fancylabel{#1}{#2}{}% +}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\fancylabel*} +% \begin{macrocode} +\WithSuffix\DeclareRobustCommand\fancylabel*[2][default]{{% + % #1=family + % #2=label or list of labels + \renewcommand{\@@fancylabel@show}[2]{}% + \fancysubreffalse% + \@fancylabel{#1}{#2}{}% +}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\fancyref} +% \begin{macrocode} +\DeclareRobustCommand\fancyref[2][default]{{% + % #1=family + % #2=label or list of labels + \@fancyref{#1}{#2}{}% +}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\fancyref*} +% \begin{macrocode} +\WithSuffix\DeclareRobustCommand\fancyref*[2][default]{{% + % #1=family + % #2=label or list of labels + \renewcommand{\@@fancylabel@show}[2]{}% + \@fancyref{#1}{#2}{}% +}} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\fancylabelNewLabelEvent} +% \begin{macrocode} +\newcommand{\fancylabelNewLabelEvent}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\fancylabelShowLabelEvent} +% \begin{macrocode} +\newcommand{\fancylabelShowLabelEvent}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\fancylabelShowRefEvent} +% \begin{macrocode} +\newcommand{\fancylabelShowRefEvent}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\fancylabelResetCounter} +% \begin{macrocode} +\newcommand{\fancylabelResetCounter}[1]{% + % #1=family + \@ifundefined{fancylabel@familystorage@#1}{% + \PackageError{fancylabel}{No fancylabel family '#1' defined.}{}% + }{% + \@namedef{fancylabel@familystorage@#1}{0}% + }% +} +% \end{macrocode} +% \end{macro} +% \subsection{Helper macros} +% \begin{macro}{\@fancylabel} +% \begin{macrocode} +\newif\iffancyref@showlabel@FirstSublabelInList% +\fancyref@showlabel@FirstSublabelInListtrue% +\newcommand{\@fancylabel}[3]{% + % #1=family + % #2=label or list of labels + % #3=sublabel or list of sublabels + \@fancylabelANDref{#1}{#2}{#3}% + % Define labels + \expandafter\fancyref@@sort\expandafter{\@fancylabel@list}{\@@fancylabel@define}% + % Print labels + \setcounter{fancyref@sort@x}{0}% + \expandafter\fancyref@@sort\expandafter{\fancyref@compress@list}{\@@fancylabel@show}% + \fancyref@print@list% +} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\@fancylabelANDref} +% \begin{macrocode} +\newcommand{\@fancylabelANDref}[3]{% + % #1=family + % #2=label or list of labels + % #3=sublabel or list of sublabels + \def\fancyref@sort@list{}% + \def\fancyref@sort@labellist@unsorted{}% + \def\fancyref@compress@list{}% + \def\fancyref@print@list{}% + \ifthenelse{\equal{#3}{}}{% + % true => List of labels + \newcommand{\@fancylabel@list}{#2}% + \newcommand{\@@fancylabel@define}[2]{% + % ##1= + % ##2=label (from list) + \@@@fancylabel@define{#1}{##2}{#3}% + }% + \newcommand{\@@fancyref@define}[2]{% + % ##1= + % ##2=label (from list) + \@@@fancyref@define{#1}{##2}{#3}% + }% + \def\fancyref@@@@@sort{% + fancyref@PrevRun@#1@\fancyref@@sort@value @% + }% + \def\fancyref@@@compress{% + fancyref@PrevRun@#1@\fancyref@@compress@value @% + }% + \newcommand{\fancyref@@@compress@entry}{% + {#1}{\fancyref@@compress@value}{}% + }% + }{% + % false => List of sublabels + \newcommand{\@fancylabel@list}{#3}% + \newcommand{\@@fancylabel@define}[2]{% + % ##1= + % ##2=sublabel (from list) + \@@@fancylabel@define{#1}{#2}{##2}% + }% + \newcommand{\@@fancyref@define}[2]{% + % ##1= + % ##2=sublabel (from list) + \@@@fancyref@define{#1}{#2}{##2}% + }% + \def\fancyref@@@@@sort{% + fancyref@PrevRun@#1@#2@\fancyref@@sort@value% + }% + \def\fancyref@@@compress{% + fancyref@PrevRun@#1@#2@\fancyref@@compress@value% + }% + \newcommand{\fancyref@@@compress@entry}{% + {#1}{#2}{\fancyref@@compress@value}% + }% + }% + % Sort + \fancyref@sort{\@fancylabel@list}% + % Compress + \fancyref@compress{\fancyref@sort@list}% + % Add the so far undefined labels to this list + \ifthenelse{\equal{\fancyref@sort@labellist@unsorted}{}}{}{% + \KV@fancylabel@compressfalse% + \fancyref@compress{\fancyref@sort@labellist@unsorted}% + \expandafter\fancyref@addtolist\expandafter{\fancyref@sort@labellist@unsorted}% + {\fancyref@sort@list}% + }% +} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\@@@fancylabel@define} +% \begin{macrocode} +\newcommand{\@@@fancylabel@define}[3]{% + % #1=family + % #2=label + % #3=sublabel + \@ifundefined{fancylabel@familystorage@#1}{% + \PackageError{fancylabel}{No fancylabel family '#1' defined. % + Use package option families for definition.}{}% + }{% + \@ifundefined{fancyref@ThisRun@#1@#2@#3}{% + \fancyref@define@LabelUndef{#1}{#2}{#3}% + }{% + \fancyref@define@LabelDef{#1}{#2}{#3}% + }% + }% +} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\@@fancylabel@show} +% \begin{macrocode} +\newcommand{\@@fancylabel@show}[2]{% + % #1= + % #2={}{