Template:Family name hatnote/doc

This is a documentation subpage for Template:Family name hatnote.
It contains usage information, categories and other content that is not part of the original template page.

Shortcut

{{fnh}}

This template is used on approximately 68,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Template: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	Optional
`\|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

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	Yoruba name
Lebanese	Lebanese Arabic
Ottoman Turkish	Ottoman Turkish language
Romance	Romance languages
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}}`	In this article, the surname is Simpson.
Burmese	`{{Family name hatnote\|Htang\|lang=Burmese}}`	In this article, the given name is Htang. There is no family name.
Dutch	`{{Family name hatnote\|Van der Sar\|lang=Dutch}}`	In this article, the surname is Van der Sar.
Ijebu	`{{Family name hatnote\|Àjàyí\|lang=Ijebu}}`	In this Ijebu name, the Yoruba surname is Àjàyí.
Ottoman Turkish	`{{Family name hatnote\|Namık Kemal\|lang=Ottoman Turkish}}`	In this Ottoman Turkish style name, the given name is 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}}`	In this article, the surname is Acosta and the marital name is Benitez.
Basque	`{{Family name hatnote\|Arana\|Goiri\|lang=Basque}}`	In this article, the first surname is Arana and the second is Goiri.
Cambodian	`{{Family name hatnote\|Sok\|Narvaratt\|lang=Cambodian}}`^[a]	In this article, the surname is 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}}`	In this article, the first or paternal surname is Miró and the second or maternal family name is Ferrà; both are generally joined by the conjunction "i".
Congolese	`{{Family name hatnote\|Tshisekedi\|Tshilombo\|lang=Congolese}}`	In this article, the surname is Tshisekedi and the post-surname is Tshilombo.
Chinese	`{{Family name hatnote\|Wang\|De\|lang=Chinese}}`	In this article, the family name is Wang and De is a generation name.
Chinese Indonesian	`{{Family name hatnote\|Han\|Su\|lang=Chinese Indonesian}}`	In this article, the family name is Han and Su is a generation name.
Dutch (if `\|nd=no`)	`{{Family name hatnote\|Van der Sar\|Sar\|lang=Dutch}}`	In this article, the surname is Van der Sar, not Sar.
Dutch (if `\|nd=y`)	`{{Family name hatnote\|Noordewier\|Reddingius\|lang=Dutch}}`	In this article, the birth surname is Noordewier and the marital name is Reddingius.
Eastern Slavic	`{{Family name hatnote\|Aleksandrovitch\|Imyarek\|lang=Eastern Slavic}}`	In this name that follows Eastern Slavic naming conventions, the patronymic is Aleksandrovitch and the family name is Imyarek.
Galician	`{{Family name hatnote\|Núñez\|Castillo\|lang=Galician}}`	In this article, the first surname is Núñez and the second is Castillo.
German	`{{Family name hatnote\|Von Allmen\|Allmen\|lang=German}}`	In this article, the surname is Von Allmen, not Allmen.
Hmong	`{{Family name hatnote\|Kaying\|Pha\|lang=Hmong}}`^[a]	In this Hmong name, the surname is 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}}`	In this article, the family name is Lee. In the stage name or pen-name, the surname is Han.
Lebanese Arabic	`{{Family name hatnote\|Ali\|Maatouk\|lang=Lebanese}}`	In this Lebanese name, the father's name is Ali and the family name is Maatouk.
Manchu^[b]	`{{Family name hatnote\|Oboi\|Gūwalgiya\|lang=Manchu}}`	In this article, the given name is Oboi. In accordance with Manchu custom, it should be used alone or with titles but not with the clan name Gūwalgiya.
Mongolian	`{{Family name hatnote\|Tsedenbal\|Yumjaagiin\|lang=Mongolian}}`^[c]	In this article, the given name is Tsedenbal. Yumjaagiin is a patronymic, not a family name.
ni-Vanuatu	`{{Family name hatnote\|Natapei\|Rapi\|lang=Ni-Vanuatu}}`	In this article, the surname is Natapei, and the traditional name is Rapi.
Ottoman Turkish	`{{Family name hatnote\|Osman Hamdi\|Bey\|lang=Ottoman Turkish}}`^[d]	In this Ottoman Turkish style name, the given name is Osman Hamdi, the title is Bey, and there is no family name.
Romance	`{{Family name hatnote\|de Perier\|Perier\|lang=Romance}}`	In this Romance language name, the surname is de Perier, not Perier.
Slavic	`{{Family name hatnote\|Wołkowski\|Wolkowski\|lang=Slavic}}`	In this article, the surname is Wołkowski, sometimes transliterated as Wolkowski.
Spanish	`{{Family name hatnote\|Gómez\|Cruz\|lang=Spanish}}`	In this article, the first or paternal surname is Gómez and the second or maternal family name is Cruz.
Turkic	`{{Family name hatnote\|Bölükbaşı\|Bolukbasi\|lang=Turkic}}`	In this Turkic name, the surname is Bölükbaşı, sometimes transliterated as Bolukbasi.
Vietnamese	`{{Family name hatnote\|Phan\|Khải\|lang=Vietnamese}}`^[a]^[e]	In this article, the surname is 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}}`	In this article, the surname is Wilson, not 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}}`	In this article, the surname is Chan. In accordance with Hong Kong custom, the Western-style name is Jackie and the Chinese-style name is Kong-sang.
Manchu	`{{Family name hatnote\|Hūlušun\|Nara\|Hulusun\|lang=Manchu}}`	In this article, the given name is Hūlušun, but is often simplified to Hulusun in English-language text. In accordance with Manchu custom, it should be used alone or with titles but not with the clan name Nara.
Ottoman Turkish	`{{Family name hatnote\|Ali\|Pasha\|Çandarlızade\|lang=Ottoman Turkish}}`	In this Ottoman Turkish style name, the given name is Ali, the title is Pasha, and the family name is Çandarlızade.
Ottoman Turkish (if no title)	`{{Family name hatnote\|Ali\|Çandarlızade\|lang=Ottoman Turkish}}`^[f]	In this Ottoman Turkish style name, the given name is Ali, and the family name is Çandarlızade.
Toponymic	`{{Family name hatnote\|London\|Edward\|English name\|lang=Toponymic}}`	In this English name, the toponymic surname is 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}}`	In this article, the surname is 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

No description.

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Surname or family name	`1`	no description	String	required
2	`2`	no description	Unknown	optional
3	`3`	no description	Unknown	optional
Language	`lang`	no description Example Telugu	Unknown	suggested
nd	`nd`	no description	Unknown	optional

Notes

^ ^a ^b ^c For Cambodian, Hmong, or Vietnamese, |2= is not required, and will still add the explanatory note.
^ The second parameter is required for this language
^ For Mongolian, if |2= is not used, it will state that there is neither a patronymic nor family name.
^ For Ottoman Turkish, if |3= is given, the family name will be listed as well.
^ Vietnamese has a "transliterated" message similar to Slavic and Turkic, but is triggered by |3=.
^ For Ottoman Turkish, if |2= is left empty (note the double pipe, ||), "the title is..." section is not included.

Tracking categories

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