This non-Western syntax limits alternate names and cross-references, prevents the use of comma-delimited names, and complicates indexing. It is a “ghost of nameauth past” that remains for the sake of backward compatibility and to prevent “holes”
where naming macro arguments are discarded without apparent reason.
\Name{⟨SNN⟩}[⟨Alternate⟩]
The genesis of this syntax was the use of the⟨Alternate⟩field for variant forenames in Western names, personal names in Eastern names, and sobriquets, titles, and so on in ancient names. Yet this prevented using alternate names for non-Western names and it limited those names to an unacceptable second-tier status. Developing the comma delimiter in⟨SNN, Affix⟩ presented significant challenges, but it was worth overcoming them to put all name forms on equal footing.
We show this syntax for the sake of completeness, but we strongly encourage using the comma-delimited syntax instead.
• One mustleave emptythe first optional ⟨FNN⟩argument.
• One mustneveruse the comma-delimited argument ⟨Affix⟩.
• These namesalwaysuse⟨Alternate⟩, which acts like⟨Affix⟩usually does, and affects both name and index patterns (Section6.1).
• These names take the form⟨SNN Alternate⟩ in the index.
• In this manual we designate these names with a double dagger (‡).
1 \Name{Henry}[VIII] % Ancient
2 \Name{Chiang}[Kai-shek] % Eastern
3 \begin{nameauth}
4 \< Dagb & & Dagobert & I > % Ancient
5 \< Yosh & & Yoshida & Shigeru > % Eastern
6 \< Fukuyama & &
7 \noexpand\textUC{Fukuyama} & Takeshi > % Alt. format
8 \end{nameauth}
After studying in the US during the 1930s, in 1954 Rev. \Fukuyama\ddag FUKUYAMA Takeshi‡ published Nihon Fukuin R¯uteru Ky¯okai Shi (History of the Evangelical Lutheran Church in Japan).
\ForgetThis\Name{Henry}[VIII]\ddag Henry VIII‡
\Name{Henry}[VIII]\ddag Henry‡
\ForgetThis\Name{Chiang}[Kai-shek]\ddag Chiang Kai-shek‡
\Name{Chiang}[Kai-shek]\ddag Chiang‡
\Dagb\ddag Dagobert I‡
\Dagb\ddag Dagobert‡
\CapName\Yosh\ddag YOSHIDA Shigeru‡
\CapName\RevName\LYosh\ddag Shigeru YOSHIDA‡
\AltFormatActive
\ForgetThis\Fukuyama\ddag FUKUYAMA Takeshi‡
\Fukuyama\ddag FUKUYAMA‡
\AltFormatInactive
Regardless of its flaws, the obsolete syntax shares name patterns, index tags, data tags, and index entries with the current syntax:
Obsolete syntax: \ForgetThis\Name{Henry}[VIII]\ddag Henry VIII‡
\ShowPattern{Henry}[VIII] Henry,VIII
Current syntax: \Name{Henry, VIII} Henry
\ShowPattern{Henry, VIII} Henry,VIII
We do not expect people to use the obsolete syntax much anymore. Here we list more advantages to using the current syntax and avoiding the old.
• Only the newer syntax permits variants:
\Name*{Henry, VIII}[Tudor]Henry Tudor.
• The proper form for the old syntax is, e.g.:
\Name*{Henry}[VIII]:Henry VIII.
• \Name[Henry]{VIII}is a malformed Western name:
“Henry VIII” and “VIII”.
• \Name[Henry]{VIII}[Tudor]also is malformed:
“Tudor VIII” and “VIII”
• Both incorrect name forms have the same index entry:
“VIII, Henry”
Back to Table of Contents
Names, once they are in common use, quickly become mere sounds, their etymology being buried, like so many of the earth’s marvels, beneath the dust of habit.
—Salman Rushdie,The Satanic Verses(1988)
13 Advanced Customization
This section is meant to help those who want to access package internals as they add features, as well as those who want to design their own constructs and mesh them with nameauth. Here we set the formatting hooks to the package default, setting aside the common usage in this manual. We also use alternate formatting for much of this section. We set up the following hooks:
1 \renewcommand*\NamesFormat{}
2 \renewcommand*\FrontNamesFormat{}
3 \renewcommand*\MainNameHook{\AltOff}
4 \renewcommand*\FrontNameHook{\AltOff}
13.1 Using Package Internals
We move toward custom formatting by starting with the established paradigm of alternate formatting (Section 11.3). We will change the “back-end” macros to a degree, so that we get a substantially similar experience with custom code.
When designing macros that work with alternate formatting hooks, the Boolean flags that one must know are\if@nameauth@DoAlt, which is toggled by\AltOnand
\AltOff; \if@nameauth@DoCaps, which handles capitalization via \AltCaps, and
\if@nameauth@InHook, which is true when the formatting hooks are called.
Next, instead of using\textSC and friends, we define a new macro that works in similar fashion.\Fboxdraws a frame around the name:
1 \documentclass{article}
2 \input{compat.tex} % Included with nameauth; needed only if
3 % compiling on multiple TeX distros or LaTeX engines.
4 \usepackage{makeidx}
5 \usepackage[altformat]{nameauth}
6 \makeindex
7
8 % Alternate formatting macro definition
9 \makeatletter
10 \newcommand*\Fbox[1]{%
11 \if@nameauth@DoAlt\protect\fbox{#1}\else#1\fi
12 }
13 \makeatother
Since \AltCapsis part of nameauth, one need not reinvent that wheel. Just use it in the name arguments and sorting macros:
14
15 % Quick interface definition
16 \begin{nameauth}
17 \< deSmet & Pierre-Jean &
18 \noexpand\Fbox{\noexpand\AltCaps{d}e~Smet} & >
19 \end{nameauth}
20
21 % Sorting and tagging
22 \PretagName[Pierre-Jean]%
23 {\noexpand\Fbox{\noexpand\AltCaps{d}e~Smet}}%
24 {de~Smet, Pierre-Jean}
The final step is redefining the hooks, which can be quite simple:
25
26 \renewcommand*\MainNameHook{\AltOff}
27 \renewcommand*\FrontNameHook{\AltOff}
28
29 \begin{document}
30
31 \deSmet\ was a Jesuit missionary who arrived in North
32 America in 1821 at the age of twenty, after a year of seminary
33 education. \CapThis\deSmet\ was ordained in 1827 and worked
34 among American Indian nations after 1837. We can show the forms
35 \LdeSmet\ and \SdeSmet.
36
37 \printindex
38 \end{document}
Pierre-Jean de Smet was a Jesuit missionary who arrived in North America in 1821 at the age of twenty, after a year of seminary education. De Smet was ordained in 1827 and worked among American Indian nations after 1837. We can show the forms Pierre-Jean de Smet and Pierre-Jean.
Some formatting, such as the use of \textSC, is fairly standard. Other formatting, such as\Fboxabove, is more ornamental.