diff options
author | Karl Berry <karl@freefriends.org> | 2017-01-16 23:14:32 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-01-16 23:14:32 +0000 |
commit | 6976bfac339cc2549939072c43d80c8c2f68b49c (patch) | |
tree | 92bbd248bd6c922d6451239035ed5eae4968938d /Master/texmf-dist/doc/latex | |
parent | c4924cb3f7ffb2985272e1c2441d67a116f37373 (diff) |
nameauth (14jan17)
git-svn-id: svn://tug.org/texlive/trunk@42975 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/nameauth/README | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nameauth/README.txt | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nameauth/examples.tex | 187 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/nameauth/nameauth.pdf | bin | 875403 -> 956426 bytes |
4 files changed, 116 insertions, 75 deletions
diff --git a/Master/texmf-dist/doc/latex/nameauth/README b/Master/texmf-dist/doc/latex/nameauth/README index 1e50e9ee7e3..6a67fe35238 100644 --- a/Master/texmf-dist/doc/latex/nameauth/README +++ b/Master/texmf-dist/doc/latex/nameauth/README @@ -3,7 +3,7 @@ nameauth:| Name authority management for consistency in text and index Author:| Charles P. Schaum E-mail:| charles dot schaum at comcast dot net - License:| Released under the LaTeX Project Public License v1.3c or later + License:| Released under the LaTeX Project Public License 1.3c or later See:| http://www.latex-project.org/lppl.txt Short description: diff --git a/Master/texmf-dist/doc/latex/nameauth/README.txt b/Master/texmf-dist/doc/latex/nameauth/README.txt index 1e50e9ee7e3..6a67fe35238 100644 --- a/Master/texmf-dist/doc/latex/nameauth/README.txt +++ b/Master/texmf-dist/doc/latex/nameauth/README.txt @@ -3,7 +3,7 @@ nameauth:| Name authority management for consistency in text and index Author:| Charles P. Schaum E-mail:| charles dot schaum at comcast dot net - License:| Released under the LaTeX Project Public License v1.3c or later + License:| Released under the LaTeX Project Public License 1.3c or later See:| http://www.latex-project.org/lppl.txt Short description: diff --git a/Master/texmf-dist/doc/latex/nameauth/examples.tex b/Master/texmf-dist/doc/latex/nameauth/examples.tex index f469316175f..85c62eb98f1 100644 --- a/Master/texmf-dist/doc/latex/nameauth/examples.tex +++ b/Master/texmf-dist/doc/latex/nameauth/examples.tex @@ -4,25 +4,23 @@ %% This is an example file used with the nameauth package. %% See README and nameauth.pdf for copyright info. %% +\section*{Test for Latex Engine} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% Test which LaTeX engine you are using %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%% -\section*{Test for Latex Engine} \begin{verbatim} \usepackage{ifxetex} \usepackage{ifluatex} - -\ifxetex% uses fontspec - \usepackage{fontspec} +\ifxetex% uses fontspec + \usepackage{fontspec}% check package docs \defaultfontfeatures{Mapping=tex-text} - \usepackage{xunicode} - \usepackage{xltxtra} + \usepackage{xunicode}% check if outmoded + \usepackage{xltxtra}% check if outmoded \else - \ifluatex% also uses fontspec - \usepackage{fontspec} + \ifluatex% also uses fontspec + \usepackage{fontspec}% check package docs \defaultfontfeatures{Ligatures=TeX} - \else% traditional NFSS + \else% traditional NFSS \usepackage[utf8]{inputenc} \usepackage[TS1,T1]{fontenc} \fi @@ -37,13 +35,22 @@ %% %% This macro is suitable to replace \NamesFormat and \FrontNamesFormat. %% -\section*{First Use in Margin} +\section*{First Use in Margin: $\epsilon$-\TeX} \begin{verbatim} \renewcommand*\NamesFormat[1]% {% #1% - \ifinner - \else + \unless\ifinner + \marginpar{\raggedleft\scriptsize #1}% + \fi +} +\end{verbatim} +\section*{First Use in Margin: Historic \TeX} +\begin{verbatim} +\renewcommand*\NamesFormat[1]% +{% + #1% + \ifinner\else \marginpar{\raggedleft\scriptsize #1}% \fi } @@ -58,103 +65,135 @@ %% %% This macro is suitable to replace \NamesFormat and \FrontNamesFormat. %% -\section*{Text Tag With First Use} +\section*{Text Tag With First Use: $\epsilon$-\TeX} \begin{verbatim} -\newif\ifNoTextTag +\newif\ifNoTag \makeatletter -\renewcommand*\NamesFormat[1]% -{% +\renewcommand*\NamesFormat[1]{\begingroup% + \protected@edef\temp{\endgroup\textbf{#1}% + \unless\ifNoTag + \if@nameauth@InName + {\bfseries\noexpand\NameQueryInfo + [\unexpanded\expandafter{\the\@nameauth@toksa}] + {\unexpanded\expandafter{\the\@nameauth@toksb}} + [\unexpanded\expandafter{\the\@nameauth@toksc}]}\fi + \if@nameauth@InAKA + \noexpand\NameQueryInfo + [\unexpanded\expandafter{\the\@nameauth@toksa}] + {\unexpanded\expandafter{\the\@nameauth@toksb}} + [\unexpanded\expandafter{\the\@nameauth@toksc}]\fi + \fi}\temp\global\NoTagfalse} +\makeatother +\end{verbatim} +\section*{Text Tag With First Use: Historic \TeX} +\begin{verbatim} +\newif\ifNoTag +\makeatletter +\renewcommand*\NamesFormat[1]{% \let\ex\expandafter% #1% \if@nameauth@InName - \ifNoTextTag + \ifNoTag \else \ex\ex\ex\ex\ex\ex\ex\NameQueryInfo\ex\ex\ex\ex\ex\ex\ex[% \ex\ex\ex\the\ex\ex\ex\@nameauth@toksa\ex\ex\ex]% \ex\ex\ex{\ex\the\ex\@nameauth@toksb\ex}\ex[\the\@nameauth@toksc]% - \fi - \fi + \fi\fi \if@nameauth@InAKA - \ifNoTextTag + \ifNoTag \else \ex\ex\ex\ex\ex\ex\ex\NameQueryInfo\ex\ex\ex\ex\ex\ex\ex[% \ex\ex\ex\the\ex\ex\ex\@nameauth@toksa\ex\ex\ex]% \ex\ex\ex{\ex\the\ex\@nameauth@toksb\ex}\ex[\the\@nameauth@toksc]% - \fi - \fi - \global\NoTextTagfalse% -} + \fi\fi + \global\NoTagfalse} \makeatother \end{verbatim} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%% Surname index entries in small caps -%% First surname instances in text are small caps +%% Surname index entries in an fbox +%% First surname instances in text are in an fbox %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% -%% Below we create a Boolean value \ifSC and set it true. That means -%% the surnames in the index will be in small caps. -%% -%% We then create a macro \DoFormat that prints its argument in -%% small caps if \ifSC is true, or makes no font change -%% and prints the the argument. +%% We create a macro \Fbox that prints its argument in a framed +%% box when \@nameauth@DoAlt is true, or it just prints its argument. %% -%% \MainNameHook ignores its argument, sets \SCfalse to suppress -%% small caps in the text only, then calls the name parser used -%% specifically in formatting hooks. %% -%% The hook macro can replace both \MainNameHook and \FrontNameHook. -%% -\section*{Continental Small Caps} +\section*{Formatting and Capping: New Style} \begin{verbatim} \makeatletter - -\newif\ifSC -\SCtrue - -\def\DoFormat#1{% - \ifSC - \textsc{#1}% - \else - #1% - \fi +\newcommand*\Fbox[1]{% + \if@nameauth@DoAlt + \fbox{#1}\else#1\fi } +\makeatother + +\renewcommand*\MainNameHook[1]{\NameOnly\NameParser} -\renewcommand*\MainNameHook[1]{\SCfalse\NameParser} \let\FrontNameHook\MainNameHook \end{verbatim} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%% Surname index entries in talic -%% First surname instances in text are italic -%% Capitalize name within that formatting +%% Use both the arguments passed to the hooks +%% and \NameParser under different conditions +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% +%% We redefine the hooks to print a name in the text and in +%% a margin paragraph. We change some of the internal flags +%% to make \NameParser print the name differently. +%% +%% +\section*{Putting \texttt{\textbackslash NameParser} on Display} +\begin{verbatim} +\makeatletter +\renewcommand*\NamesFormat[1]{% + #1\unless\ifinner + \marginpar{\small\raggedleft% + \@nameauth@FullNametrue% + \@nameauth@FirstNamefalse% + \@nameauth@EastFNfalse% + \NameParser}% + \fi} +\renewcommand*\MainNameHook[1]{% + \AltOff#1\unless\ifinner + \marginpar{\small\raggedleft% + \@nameauth@FullNamefalse% + \@nameauth@FirstNamefalse% + \@nameauth@EastFNfalse% + \NameParser}% + \fi} +\makeatother +\end{verbatim} +\clearpage +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Surname index entries in an fbox +%% First surname instances in text are in an fbox +%% We can capitalize name within that formatting %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% -%% Below we create a Boolean value \ifItal and set it true. -%% This will trigger italics, similar to the Continental -%% example above. +%% Below we create a Boolean value \ifFbox and set it true. +%% This will trigger an fbox %% -%% We then create a macro \DoFormat that prints its argument in -%% italic when \ifItal is true, or makes no font change otherwise. +%% We then create a macro \Fbox that prints its argument in +%% an fbox when \ifFbox is true, or makes no change otherwise. %% -%% The \CP macro only capitalizies its argument inside \NamesFormat below. +%% The \AltCap macro only capitalizies its argument inside the formatting +%% hook \NamesFormat below. %% %% \Namesformat ignores its argument, sets \InHooktrue, then %% calls the name parser used specifically in formatting hooks. %% -%% The hook macro is suitable to replace \NamesFormat and \FrontNamesFormat. -%% To replace \MainNameHook and \FrontNameHook, wrap the hook macro -%% between \Italfalse and \italtrue for first-only italic. %% -\section*{Formatting and Capping} +\section*{Formatting and Capping: Old Style} \begin{verbatim} -\newif\ifItal +\newif\ifFbox \newif\ifFirstCap \newif\ifInHook -\Italtrue +\Fboxtrue -\def\DoFormat#1{% - \ifItal\textit{#1}\else#1\fi +\renewcommand*\Fbox[1]{% + \ifFbox\fbox{#1}\else#1\fi } -\def\CP#1{% + +\renewcommand*\AltCap[1]{% \ifInHook \ifFirstCap\uppercase{#1}\else#1\fi \else @@ -162,19 +201,21 @@ \fi } -\newcommand*\CapMe{\FirstCaptrue} -\makeatletter% +\renewcommand\CapThis{\FirstCaptrue} + \renewcommand*\NamesFormat[1] {% \InHooktrue\NameParser\InHookfalse% \global\FirstCapfalse% } + \renewcommand*\MainNameHook[1] {% - \Italfalse\InHooktrue\NameParser\InHookfalse% - \global\FirstCapfalse\Italtrue% + \Fboxfalse\InHooktrue\NameParser\InHookfalse% + \global\FirstCapfalse\Fboxtrue% } + \let\FrontNamesFormat\Namesformat \let\FrontNameHook\MainNameHook \end{verbatim} -\end{document} +\end{document}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf b/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf Binary files differindex 24541e6d550..1c29d15eb5f 100644 --- a/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf +++ b/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf |