Intaai wowonod montok do Templat:Portuguese name/doc

{{Documentation subpage}}
{{High-use}}

This template may be placed at the top of a biographical article of someone with a [[Portuguese name]] to identify maternal and/or paternal surnames which make up the family name, as well as any [[generational title]] like "Filho".

== Usage ==

;Invocation

{{tlc|Portuguese name{{!}}''MATERNAL''{{!}}''PATERNAL''{{!}}''SUFFIX''}}<br/>
{{tlc|Portuguese name|1{{=}}''MATERNAL''|2{{=}}''PATERNAL''{{!}}3{{=}}''SUFFIX''}}<br/>
{{tlc|Portuguese name|first{{=}}''MATERNAL''|second{{=}}''PATERNAL''{{!}}suffix{{=}}''SUFFIX''}}

;Parameters

* "1" or "first"{{snd}}the first or maternal [[Surname|family name]] (optional, but usually present)
* "2" or "second"{{snd}}the second or paternal family name  (optional, but usually present)
* "3" or "suffix"{{snd}}the [[Suffix (name)#Generational titles|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 ==

* For [[Daniel Alves da Silva]]: {{tlx|Portuguese name|Alves|Silva}} or {{tlx|Portuguese name|<nowiki>first=Alves|second=Silva</nowiki>}} &rarr;
{{Portuguese name|Alves|Silva}} 
* For [[Armando Monteiro Filho]]: {{tlx|Portuguese name|<nowiki>second=Monteiro|suffix=Filho</nowiki>}} &rarr; {{Portuguese name|second=Monteiro|suffix=Filho}}
* For Armando de Queiroz Monteiro Filho: {{tlx|Portuguese name|<nowiki>first=Queiroz|second=Monteiro|suffix=Filho</nowiki>}} &rarr; {{Portuguese name|first=Queiroz|second=Monteiro|suffix=Filho}}
* For [[Edmundo Alves de Souza Neto]]: {{tlx|Portuguese name|<nowiki>first=Alves|second=Souza|suffix=Neto</nowiki>}} &rarr; {{Portuguese name|first=Alves|second=Souza|suffix=Neto}}
* For [[Eduardo Jorge Martins Alves Sobrinho]]: {{tlx|Portuguese name|Martins|Alves|suffix{{=}}Sobrinho}} &rarr; {{Portuguese name|Martins|Alves|suffix=Sobrinho}}


'''''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 {{para|suffix}} parameter. Rarely, '''Filho''' is the family name; in this case, it would be in the {{para|first}} or {{para|second}} parameter, and the {{para|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 {{para|suffix}} parameter.

==TemplateData==

{{TemplateDataHeader}}
<templatedata>
{
	"params": {
		"1": {
			"aliases": [
				"first"
			],
			"label": "Family or maternal name",
			"description": "The person's maternal family name",
			"example": "Alves",
			"type": "string",
			"required": false
		},
		"2": {
			"aliases": [
				"second"
			],
			"label": "Paternal name",
			"description": "The person's paternal name",
			"example": "Silva",
			"type": "string",
			"required": false
		},
		"3": {
			"aliases": [
				"suffix"
			],
			"label": "Generational suffix",
			"description": "The person's generational suffix",
			"example": "Filho",
			"type": "string",
			"required": false
		}
	},
	"format": "{{_|_=_}}\n",
	"description": "Introduces a person as having a Portuguese name, according to Portuguese naming customs"
}
</templatedata>

==Tracking categories==
* {{clc|Portuguese name template needing maintenance}} – For articles using this template with no parameters, or for articles using this template with an unrecognized suffix.

==See also==
* {{tl|Family name hatnote}}
* [[Generational suffix]]
* [[Neto (suffix)]]

<includeonly>{{Sandbox other||
[[Category:Hatnote templates for names]]
[[Category:Templates that add a tracking category]]
}}</includeonly>