Template:Family name footnote

Template documentationviewedithistorypurge

Template:Family name footnote is placed at the top of a biographical article to explain to readers which part of a name is the family name. It should go immediately after the bolded name, before the parenthetical. It requires that the article include {{notelist}} or, if <syntaxhighlight lang="wikitext" inline style="display: none;" />|reftype= is used, another footnote template.

Usage

Parameter	Description	Status
<syntaxhighlight lang="wikitext" inline style="display: none;" />|1=	The surname or family name of the subject.	Required
<syntaxhighlight lang="wikitext" inline style="display: none;" />|2=	Triggers different text based on the language (see below).	Required for <syntaxhighlight lang="wikitext" inline style="display: none;" />|lang=Manchu; optional for others.
<syntaxhighlight lang="wikitext" inline style="display: none;" />|3=	For transliterated names or there are multiple name types.	Optional
<syntaxhighlight lang="wikitext" inline style="display: none;" />|nd=	Use for Dutch names when a marital name is involved	Conditional
<syntaxhighlight lang="wikitext" inline style="display: none;" />|lang=	The country or origin of the name; links to related articles if they exist. Note: language names must be spelled out, not ISO codes, for example Spanish not es.	Optional

Footnotes vs. hatnotes

There is no universal consensus on whether to use footnotes or hatnotes for family name explanations. However, never use both. For names that are clear to the average reader, such as Jeremy Lin, use no explanation.

Hatnotes ({{Family name hatnote}}) are a high-emphasis method of name explanation, and have been used widely on Wikipedia for many years. Some editors argue that they are well-suited to articles where the name is particularly in need of clarification (such as when the name Foo Bar is one article and Bar Foo is another), or where a footnotes system would have to be introduced for the explanation.

Footnotes are a newer, lower-emphasis method of name explanation introduced in 2020. Some editors argue that they better avoid giving undue prominence to name explanations. Others argue that they fit name explanations better as they do not muddle the navigational purpose of hatnotes. They may be particularly well-suited to articles that already have other hatnotes (where another might induce banner blindness), or where there is a preexisting footnote system (and thus no need to introduce one).

Supported languages

All languages are supported. The <syntaxhighlight lang="wikitext" inline style="display: none;" />|lang= parameter will trigger the text output "<lang> name", wikilinked if the page exists; for example, <syntaxhighlight lang="wikitext" inline style="display: none;" />|lang=Arabic will result in "Arabic name". Exceptions are listed below:

Language	Article
East Slavic	East Slavic naming customs
Hmong	Hmong people
Ijebu	Ijebu Kingdom
Lebanese	Lebanese Arabic
Ottoman Turkish	Ottoman Turkish
Romance	Romance language
Toponymic	third parameter is linked
Turkic	Turkic languages

Examples

First parameter only

Regardless of language, this template requires a first parameter for the given surname. For instances where the language may not commonly use a family name, the text reflects this.

Language	Code	Example Output
No <syntaxhighlight lang="wikitext" inline style="display: none;" />|lang= set	{{Family name footnote|Simpson}}
Burmese	{{Family name footnote|Htang|lang=Burmese}}
Dutch	{{Family name footnote|Van der Sar|lang=Dutch}}
Ijebu	{{Family name footnote|Àjàyí|lang=Ijebu}}
Mongolian	{{Family name footnote|Tsedenbal|lang=Mongolian}}
Ottoman Turkish	{{Family name footnote|Namık Kemal|lang=Ottoman Turkish}}

Second parameter

The second parameter triggers different wording depending on the language.

Language	Code	Example Output
Argentine	{{Family name footnote|Acosta|Benitez|lang=Argentine}}
Basque	{{Family name footnote|Arana|Goiri|lang=Basque}}
Bulgarian	{{Family name footnote|Ivanova|Georgieva-Kinova|lang=Bulgarian}}
Cambodian	{{Family name footnote|Sok|Narvaratt|lang=Cambodian}}
Catalan	{{Family name footnote|Miró|Ferrà|lang=Catalan}}
Chilean	{{Family name footnote|Ocampo|Soto|lang=Chilean}}
Chinese	{{Family name footnote|Wang|De|lang=Chinese}}
Chinese Indonesian	{{Family name footnote|Han|Su|lang=Chinese Indonesian}}
Congolese	{{Family name footnote|Tshisekedi|Tshilombo|lang=Congolese}}
Dutch	{{Family name footnote|Van der Sar|Sar|lang=Dutch}}
Dutch (if <syntaxhighlight lang="wikitext" inline style="display: none;" />|nd=y)	{{Family name footnote|Noordewier|Reddingius|nd=yes|lang=Dutch}}
East Slavic	{{Family name footnote|Aleksandrovitch|Imyarek|lang=East Slavic}}
Galician	{{Family name footnote|Núñez|Castillo|lang=Galician}}
German	{{Family name footnote|Von Allmen|Allmen|lang=German}}
Hispanic American	{{Family name footnote|Bolívar|Palacios|lang=Hispanic American}}
Hmong	{{Family name footnote|Kaying|Pha|lang=Hmong}}
Korean	{{Family name footnote|Lee|Han|lang=Korean}}
Lebanese Arabic	{{Family name footnote|Ali|Maatouk|lang=Lebanese}}
Manchu	{{Family name footnote|Oboi|Gūwalgiya|lang=Manchu}}
Medieval	{{Family name footnote|Wolfram|von Eschenbach|lang=Medieval}}
Mexican	{{Family name footnote|Juárez|García|lang=Mexican}}
Mongolian	{{Family name footnote|Tsedenbal|Yumjaagiin|lang=Mongolian}}
ni-Vanuatu	{{Family name footnote|Natapei|Rapi|lang=Ni-Vanuatu}}
Ottoman Turkish	{{Family name footnote|Osman Hamdi|Bey|lang=Ottoman Turkish}}
Romance	{{Family name footnote|de Perier|Perier|lang=Romance}}
Slavic	{{Family name footnote|Wołkowski|Wolkowski|lang=Slavic}}
Spanish	{{Family name footnote|Gómez|Cruz|lang=Spanish}}
Turkic	{{Family name footnote|Bölükbaşı|Bolukbasi|lang=Turkic}}
Vietnamese	{{Family name footnote|Phan|Khải|lang=Vietnamese}}
All others (A, not B)	{{Family name footnote|Wilson|Clark}}

Third parameter

With the exception of <syntaxhighlight lang="wikitext" inline style="display: none;" />|lang=Toponymic, the third parameter is used for transliterated names or a second name type.

Language	Code	Example Output
Hong Kong	{{Family name footnote|Chan|Jackie|Kong-sang|lang=Hong Kong}}
Macau	{{Family name footnote|Ho|Edmund|Hau Wah|lang=Macau}}
Manchu	{{Family name footnote|Hūlušun|Nara|Hulusun|lang=Manchu}}
Ottoman Turkish	{{Family name footnote|Ali|Pasha|Çandarlı|lang=Ottoman Turkish}}
Ottoman Turkish (if no title)	{{Family name footnote|Ali||Çandarlı|lang=Ottoman Turkish}}
Toponymic	{{Family name footnote|London|Edward|English name|lang=Toponymic}}
Vietnamese	{{Family name footnote|Ngô|Diệm|Ngo|lang=Vietnamese}}

Tracking categories

• Category:Pages using family name hatnote with no first parameter (0)

See also

• WP:SUR
• Generational suffix
• Neto (suffix)

• {{Bhutanese name}}
• {{British barrelled name}}
• {{Dinka name}}
• {{Ethiopian name}}
• {{Family name explanation}}
• {{Family name footnote}}
• {{Family name hatnote}}
• {{Fijian name}}
• {{Filipino name}}
• {{Given name footnote}}
• {{Given name hatnote}}
• {{Icelandic name}}
• {{Indian patronymic}}
• {{Indonesian name}}
• {{Malay name}}
• {{Norse name}}
• {{Pakistani name}}
• {{Patronymic name}}
• {{Patronymic names}}
• {{Portuguese name}}
• {{Spanish colonial name}}
• {{Spanish married name}}
• {{Traditional Norwegian name}}
• {{Western name order}} (typically for Hungarian and Japanese names)
• {{Western Slavic name}}

Notes

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Family name footnote in articles based on its TemplateData.

TemplateData for Family name footnote

<templatedata> { "params": { "1": { "label": "Surname or family name", "description": "The primary element in the person's surname", "type": "string", "required": true }, "2": { "label": "Additional name element", "description": "Secondary element in the person's surname (depending upon language)", "type": "string", "suggested": true }, "3": { "label": "Additional name element", "description": "Tertiary element in the person's surname or transliteration (depending upon language)", "type": "string", "suggested": true }, "lang": { "label": "Language", "description": "Language or naming convention. Note: Spell out the language name; do not use ISO codes", "type": "string", "suggested": true, "example": "Spanish", "suggestedvalues": [ "Argentine", "Basque", "Bulgarian", "Burmese", "Cambodian", "Catalan", "Chilean", "Chinese", "Chinese Indonesian", "Congolese", "Dutch", "East Slavic", "Galician", "German", "Hispanic American", "Hmong", "Ijebu", "Korean", "Lebanese", "Manchu", "Medieval", "Mexican", "Mongolian", "Ni-Vanuatu", "Ottoman Turkish", "Romance", "Slavic", "Spanish", "Toponymic", "Turkic", "Vietnamese", "Hong Kong", "Macau" ] }, "nd": { "label": "Dutch marital name", "description": "Use only with Dutch surnames where the person's married name is to be specified", "type": "string", "suggested": true }, "type": { "description": "Whether the explanation should be rendered as a footnote, a hatnote, or neither (default).", "type": "string", "suggestedvalues": [ "footnote", "hatnote" ], "default": "Neither", "label": "Explanation type" }, "reftype": { "label": "Reference group type", "description": "Name of footnote template to use, such as efn, efn-lr, or NoteTag.", "type": "line", "default": "efn", "suggestedvalues": [ "efn", "efn-lr", "efn-ua", "efn-ur", "efn-lg", "NoteTag" ] } }, "format": "inline", "description": "Placed at the top of a biographical article to explain to readers which part of a name is the family name." } </templatedata>

The above documentation is transcluded from Template:Family name footnote/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.