සැකිල්ල:Family name hatnote/doc

සැකිල්ල:Family name hatnote is placed at the top of a biographical article to explain to readers which part of a name is the family name.

Usage

Parameter	Description	Status
|1=	The surname or family name of the subject.	Required
|2=	Triggers different text based on the language (see below).	Required for |lang=Manchu; optional for others.
|3=	For transliterated names or there are multiple name types.	Optional
|nd=	Use for Dutch names when a marital name is involved	Conditional
|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 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

The |lang= parameter will trigger a link to <lang> name (for example, Arabic name) if the page exists. Exceptions are listed below:

Language	Article
Eastern Slavic	Eastern 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 |lang= set	{{Family name hatnote|Simpson}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Simpson ය.
Burmese	{{Family name hatnote|Htang|lang=Burmese}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Htang ය.
Dutch	{{Family name hatnote|Van der Sar|lang=Dutch}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Van der Sar ය.
Ijebu	{{Family name hatnote|Àjàyí|lang=Ijebu}}	මෙම Ijebu name තුළ, family yoruba name වන්නේ Àjàyí ය.
Mongolian	{{Family name hatnote|Tsedenbal|lang=Mongolian}}	මෙම ලිපිය තුළ, given name වන්නේ Tsedenbal ය. The article title contains neither a patronymic nor a family name.
Ottoman Turkish	{{Family name hatnote|Namık Kemal|lang=Ottoman Turkish}}	මෙම Ottoman Turkish style name තුළ, given name වන්නේ Namık Kemal ය. There is no family name.

Second parameter

The second parameter triggers different wording depending on the language.

Language	Code	Example Output
Argentine	{{Family name hatnote|Acosta|Benitez|lang=Argentine}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Acosta and the marital name is Benitez ය.
Basque	{{Family name hatnote|Arana|Goiri|lang=Basque}}	මෙම ලිපිය තුළ, first වාසගම වන්නේ Arana and the second is Goiri ය.
Bulgarian	{{Family name hatnote|Ivanova|Georgieva-Kinova|lang=Bulgarian}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Ivanova ය.
Cambodian	{{Family name hatnote|Sok|Narvaratt|lang=Cambodian}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Sok ය. In accordance with Cambodian custom, this person should be referred to by the given name, Narvaratt.
Catalan	{{Family name hatnote|Miró|Ferrà|lang=Catalan}}	මෙම ලිපිය තුළ, first or paternal වාසගම වන්නේ Miró and the second or maternal family name is Ferrà; both are generally joined by the conjunction "i" ය.
Chilean	{{Family name hatnote|Ocampo|Soto|lang=Chilean}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Ocampo ය.
Chinese	{{Family name hatnote|Wang|De|lang=Chinese}}	මෙම ලිපිය තුළ, පවුල් නාමය වන්නේ Wang and De is a generation name ය.
Chinese Indonesian	{{Family name hatnote|Han|Su|lang=Chinese Indonesian}}	මෙම ලිපිය තුළ, family name වන්නේ Han and Su is a generation name ය.
Congolese	{{Family name hatnote|Tshisekedi|Tshilombo|lang=Congolese}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Tshisekedi and the post-surname is Tshilombo ය.
Dutch	{{Family name hatnote|Van der Sar|Sar|lang=Dutch}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Van der Sar, not Sar ය.
Dutch (if |nd=y)	{{Family name hatnote|Noordewier|Reddingius|nd=yes|lang=Dutch}}	මෙම ලිපිය තුළ, birth වාසගම වන්නේ Noordewier and the marital name is Reddingius ය.
Eastern Slavic	{{Family name hatnote|Aleksandrovitch|Imyarek|lang=Eastern Slavic}}	මෙම ලිපිය තුළ, patronymic වන්නේ Aleksandrovitch and the family name is Imyarek ය.
Galician	{{Family name hatnote|Núñez|Castillo|lang=Galician}}	මෙම ලිපිය තුළ, first වාසගම වන්නේ Núñez and the second is Castillo ය.
German	{{Family name hatnote|Von Allmen|Allmen|lang=German}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Von Allmen ය.
Hmong	{{Family name hatnote|Kaying|Pha|lang=Hmong}}	මෙම Hmong name තුළ, වාසගම වන්නේ Kaying ය. In accordance with Hmong custom, this person should be referred to by the given name, Pha.
Korean	{{Family name hatnote|Lee|Han|lang=Korean}}	මෙම ලිපිය තුළ, පවුල් නාමය වන්නේ Lee. අවධි නාමය හෝ ලේඛන නාමය ඇති විට, වාසගම වන්නේ Han ය.
Lebanese Arabic	{{Family name hatnote|Ali|Maatouk|lang=Lebanese}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Ali ය.
Manchu	{{Family name hatnote|Oboi|Gūwalgiya|lang=Manchu}}	මෙම ලිපිය තුළ, given name වන්නේ Oboi ය. In accordance with Manchu custom, it should be used solely or with titles but not with the clan name Gūwalgiya.
Medieval	{{Family name hatnote|Wolfram|von Eschenbach|lang=Medieval}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Wolfram ය.
Mongolian	{{Family name hatnote|Tsedenbal|Yumjaagiin|lang=Mongolian}}	මෙම ලිපිය තුළ, given name වන්නේ Tsedenbal ය. Yumjaagiin is a patronymic, not a family name.
ni-Vanuatu	{{Family name hatnote|Natapei|Rapi|lang=Ni-Vanuatu}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Natapei, and the traditional name is Rapi ය.
Ottoman Turkish	{{Family name hatnote|Osman Hamdi|Bey|lang=Ottoman Turkish}}	මෙම Ottoman Turkish style name තුළ, given name වන්නේ Osman Hamdi, the title is Bey, and there is no family name ය.
Romance	{{Family name hatnote|de Perier|Perier|lang=Romance}}	මෙම Romance language name තුළ, වාසගම වන්නේ de Perierමිස, Perier නොවේ. ය.
Slavic	{{Family name hatnote|Wołkowski|Wolkowski|lang=Slavic}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Wołkowski, sometimes transliterated as Wolkowski ය.
Spanish	{{Family name hatnote|Gómez|Cruz|lang=Spanish}}	මෙම ලිපිය තුළ, first or paternal වාසගම වන්නේ Gómez and the second or maternal family name is Cruz ය.
Turkic	{{Family name hatnote|Bölükbaşı|Bolukbasi|lang=Turkic}}	මෙම Turkic name තුළ, වාසගම වන්නේ Bölükbaşı, sometimes transliterated as Bolukbasi ය.
Vietnamese	{{Family name hatnote|Phan|Khải|lang=Vietnamese}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Phan ය. In accordance with Vietnamese custom, this person should be referred to by the given name, Khải.
All others (A, not B)	{{Family name hatnote|Wilson|Clark}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Wilsonමිස, Clark නොවේ. ය.

Third parameter

With the exception of |lang=Toponymic, the third parameter is used for transliterated names or a second name type.

Language	Code	Example Output
Hong Kong	{{Family name hatnote|Chan|Jackie|Kong-sang|lang=Hong Kong}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Chan ය. In accordance with Hong Kong custom, their Western-style name is Jackie and their Chinese-style name is Kong-sang.
Macau	{{Family name hatnote|Ho|Edmund|Hau Wah|lang=Macau}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Ho ය.
Manchu	{{Family name hatnote|Hūlušun|Nara|Hulusun|lang=Manchu}}	මෙම ලිපිය තුළ, given name වන්නේ Hūlušun, but is often simplified to Hulusun in English-language text ය. In accordance with Manchu custom, it should be used solely or with titles but not with the clan name Nara.
Ottoman Turkish	{{Family name hatnote|Ali|Pasha|Çandarlı|lang=Ottoman Turkish}}	මෙම Ottoman Turkish style name තුළ, given name වන්නේ Ali, the title is Pasha, and the family name is Çandarlı ය.
Ottoman Turkish (if no title)	{{Family name hatnote|Ali||Çandarlı|lang=Ottoman Turkish}}	මෙම Ottoman Turkish style name තුළ, given name වන්නේ Ali, and the family name is Çandarlı ය.
Toponymic	{{Family name hatnote|London|Edward|English name|lang=Toponymic}}	මෙම English name තුළ, toponymic surname වන්නේ London ය. It is not a family name, and the person should be referred to by the given name, Edward.
Vietnamese	{{Family name hatnote|Ngô|Diệm|Ngo|lang=Vietnamese}}	මෙම ලිපිය තුළ, වාසගම වන්නේ Ngô, but is often simplified to Ngo in English-language text ය. In accordance with Vietnamese custom, this person should be referred to by the given name, Diệm.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Family name hatnote

Placed at the top of a biographical article to explain to readers which part of a name is the family name.

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
Surname or family name	1	The primary element in the person's surname	String	required
Additional name element	2	Secondary element in the person's surname (depending upon language)	String	suggested
Additional name element	3	Tertiary element in the person's surname or transliteration (depending upon language)	String	suggested
Language	lang	Language or naming convention. Note: Spell out the language name; do not use ISO codes Suggested values Argentine Basque Bulgarian Burmese Cambodian Catalan Chilean Chinese Chinese Indonesian Congolese Dutch Eastern Slavic Galician German Hmong Ijebu Korean Lebanese Manchu Medieval Mongolian Ni-Vanuatu Ottoman Turkish Romance Slavic Spanish Toponymic Turkic Vietnamese Hong Kong Macau Example lang=Spanish (not lang=es)	String	suggested
Dutch marital name	nd	Use only with Dutch surnames where the person's married name is to be specified	String	suggested
Explanation type	type	Whether the explanation should be rendered as a footnote, a hatnote, or neither (default). Suggested values footnote hatnote Default Neither	String	optional
Reference group type	reftype	Name of footnote template to use, such as efn, efn-lr, or NoteTag. Suggested values efn efn-lr efn-ua efn-ur efn-lg NoteTag Default efn	Line	optional

Tracking categories

• ප්‍රවර්ගය:Pages using family name hatnote with no first parameter (0)

See also

• WP:SUR

• {{Bhutanese name}}
• {{British barrelled name}}
• {{Dinka name}}
• {{Ethiopian name}}
• {{Fijian name}}
• {{Given name hatnote}}
• {{Icelandic name}}
• {{Indian patronymic}}
• {{Indonesian name}}
• {{Malay name}}
• {{Norse name}}
• {{Patronymic name}}
• {{Pakistani name}}
• {{Philippine name}}
• {{Portuguese name}}
• {{Spanish colonial name}}
• {{Spanish married name}}
• {{Traditional Norwegian name}}
• {{Western name order}} (primarily relevant to Hungarian names)
• {{Western Slavic name}}