Template:Efn Portuguese name/doc

This is a documentation subpage for Template:Efn Portuguese name.
It may contain usage information, categories and other content that is not part of the original template page.

This template may be put near the top of a biographical article, after the first bolded mention of a person's Portuguese name, to create a note explaining the maternal and/or paternal surnames which make up the family name, as well as any generational title like "Filho".

Usage

Invocation

{{efn Portuguese name|MATERNAL|PATERNAL|SUFFIX}}

{{efn Portuguese name|1=MATERNAL|2=PATERNAL|3=SUFFIX}}

{{efn Portuguese name|first=MATERNAL|second=PATERNAL|suffix=SUFFIX}}

Parameters

"1" or "first" – the first or maternal family name (optional, but usually present)
"2" or "second" – the second or paternal family name (optional, but usually present)
"3" or "suffix" – the generational suffix, if any (e.g., Filho, Júnior, Neto, Sobrinho, Segundo, Terceiro) (optional)

Note: Each parameter is optional, but a maintenance category will be added to articles that use this template without any parameters.

Examples

Wikitext	Result
'''Daniel Alves da Silva'''{{efn Portuguese name\|Alves\|Silva}} {{notelist}}	Daniel Alves da Silva^[a] ^ This name uses Portuguese naming customs: the first or maternal family name is Alves and the second or paternal family name is Silva.
'''Armando Monteiro Filho'''{{efn Portuguese name\|second=Monteiro\|suffix=Filho}} {{notelist}}	Armando Monteiro Filho^[a] ^ This name uses Portuguese naming customs: the second or paternal family name is Monteiro. "Filho" is a generational suffix meaning "son", which is used for someone whose name is the same as their father, like "Jr." in English.
'''Armando de Queiroz Monteiro Filho'''{{efn Portuguese name\|first=Queiroz\|second=Monteiro\|suffix=Filho\|reftype=efn-lr}} {{notelist-lr}}	Armando de Queiroz Monteiro Filho^[i] ^ This name uses Portuguese naming customs: the first or maternal family name is Queiroz and the second or paternal family name is Monteiro. "Filho" is a generational suffix meaning "son", which is used for someone whose name is the same as their father, like "Jr." in English.
'''Edmundo Alves de Souza Neto'''{{efn Portuguese name\|first=Alves\|second=Souza\|suffix=Neto\|reftype=NoteTag}} {{NoteFoot}}	Edmundo Alves de Souza Neto^{[note 1]} ^ This name uses Portuguese naming customs: the first or maternal family name is Alves and the second or paternal family name is Souza. "Neto" is a generational suffix meaning "grandson", which is used for someone whose name is the same as their father and grandfather, like "III" in English.
'''Eduardo Jorge Martins Alves Sobrinho'''{{efn Portuguese name\|Martins\|Alves\|Sobrinho}} {{notelist}}	Eduardo Jorge Martins Alves Sobrinho^[a] ^ This name uses Portuguese naming customs: the first or maternal family name is Martins and the second or paternal family name is Alves. "Sobrinho" is a generational suffix meaning "nephew".

Usage note: In Portuguese names, Filho, if it appears, is usually a generational suffix meaning "Junior", and is not a family name, so it should be placed in the optional |suffix= parameter. Rarely, Filho is the family name; in this case, it would be in the |first= or |second= parameter, and the |suffix= parameter should be omitted. The same applies to Neto or Sobrinho which can be either a suffix (usually) or a family name (rarely). If you are not sure if something is a generational suffix or not, do not use the |suffix= parameter.

TemplateData

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

TemplateData for Efn Portuguese name

This template may be put near the top of a biographical article, after the first bolded mention of a person's Portuguese name, to create a note explaining the maternal and/or paternal surnames which make up the family name, as well as any generational title like "Filho".

Template parameters
This template has custom formatting.
Parameter		Description	Type	Status
Family or maternal name	`1` `first`	The person's maternal family name Example Alves	String	optional
Paternal name	`2` `second`	The person's paternal name Example Silva	String	optional
Generational suffix	`3` `suffix`	The person's generational suffix Example Filho	String	optional
Reference group type	`reftype`	Name of footnote template to use, such as efn, efn-lr, or NoteTag. Default efn Example efn-lr	String	optional

Template use by reference group type

Group type	Footnote template	List template	Sample labels
lower-alpha	`{{efn}}` `{{efn-la}}`	`{{notelist}}` `{{notelist-la}}`	a b c d e f g h i j
upper-alpha	`{{efn-ua}}`	`{{notelist-ua}}`	A B C D E F G H I J
lower-roman	`{{efn-lr}}`	`{{notelist-lr}}`	i ii iii iv v vi vii viii ix x
upper-roman	`{{efn-ur}}`	`{{notelist-ur}}`	I II III IV V VI VII VIII IX X
lower-greek	`{{efn-lg}}`	`{{notelist-lg}}`	α β γ δ ε ζ η θ ι κ
Note	`{{NoteTag}}`	`{{NoteFoot}}`	note 1 note 2 note 3

Tracking categories

Category:Portuguese name template needing maintenance (1) – For articles using this template with no parameters, or for articles using this template with an unrecognized suffix.