Osarius: added an option to display first and second names as link output; useful if specifying a disambiguation clause, to prevent the clause appearing in the like text, but still directing to the correct page

2024-01-03T10:22:34Z

added an option to display first and second names as link output; useful if specifying a disambiguation clause, to prevent the clause appearing in the like text, but still directing to the correct page

← Older revision		Revision as of 10:22, 3 January 2024
Line 7:		Line 7:
	\| second		\| second
	\| s = {{{1\|Example}}} {{str left\|{{{2\|Example}}}\|1}}.		\| s = {{{1\|Example}}} {{str left\|{{{2\|Example}}}\|1}}.
			\| full
			\| f = {{{1\|Example}}} {{{2\|Person}}}
	\| #default = {{#if: {{{2\|}}} \| {{{2\|Person}}} \| {{{1\|Example}}} }}		\| #default = {{#if: {{{2\|}}} \| {{{2\|Person}}} \| {{{1\|Example}}} }}
	}}}}]]<noinclude>		}}}}]]<noinclude><br /><br />
	Produces a link to the person specified, using a combination of names given. Requires at least one name to be passed.		Produces a link to the person specified, using a combination of names given. Requires at least one name to be passed.

Line 35:		Line 37:
	\|-		\|-
	\| <nowiki>{{pl\|Example\|d=actor, born 2000}}</nowiki> \|\| {{pl\|Example\|d=actor, born 2000}}		\| <nowiki>{{pl\|Example\|d=actor, born 2000}}</nowiki> \|\| {{pl\|Example\|d=actor, born 2000}}
			\|-
			\| <nowiki>{{pl\|Example\|Person\|t=f\|d=actor, born 2000}}</nowiki> \|\| {{pl\|Example\|Person\|t=f\|d=actor, born 2000}}
	\|-		\|-
	\| <nowiki>{{pl\|Example\|Person\|t=s\|d=actor, born 2000}}</nowiki> \|\| {{pl\|Example\|Person\|t=s\|d=actor, born 2000}}		\| <nowiki>{{pl\|Example\|Person\|t=s\|d=actor, born 2000}}</nowiki> \|\| {{pl\|Example\|Person\|t=s\|d=actor, born 2000}}
Line 72:		Line 76:
	\|-		\|-
	\| s		\| s
			\|-
			\| full \|\| rowspan="2" \| use the given name (first parameter),<br /> and the family name (second parameter)<br />(useful when disambiguation is needed) \|\| rowspan="2" \| <nowiki>{{pl\|Yannick\|Coquet\|t=f\|d=Akachese footballer}}</nowiki> \|\| rowspan="2" \| {{pl\|Yannick\|Coquet\|t=f\|d=Akachese footballer}}
			\|-
			\| f
	\|}		\|}
	</noinclude>		</noinclude>

Osarius: should make it a little bit easier to link goalscorers and players in squad lists mainly; no longer need to type out surnames multiple times etc

2024-01-02T09:50:21Z

should make it a little bit easier to link goalscorers and players in squad lists mainly; no longer need to type out surnames multiple times etc

New page

[[{{{1|Example}}} {{#if:{{{2|}}}|{{{2}}}}} {{#if: {{{d|}}} | ({{{d}}})}}|{{#if: {{{3|}}} | {{{3}}} | {{#switch: {{{t}}}
| initial
| i = {{str left|{{{1|Example}}}|1}}. {{{2|Person}}}
| first
| given
| g = {{{1|Example}}}
| second
| s = {{{1|Example}}} {{str left|{{{2|Example}}}|1}}.
| #default = {{#if: {{{2|}}} | {{{2|Person}}} | {{{1|Example}}} }}
}}}}]]<noinclude>
Produces a link to the person specified, using a combination of names given. Requires at least one name to be passed.

Use like so: <nowiki>{{PersonLink|FirstName|LastName}}</nowiki> to produce {{PersonLink|FirstName|LastName}}.

Can also use "Pl" as a shortcut, like <nowiki>{{pl|FirstName|LastName}}</nowiki> to produce the same output.

===Usage===
If a single name is passed, this will form the link in its entirety. For example <nowiki>{{pl|Neaniaõ}}</nowiki> would produce this link: {{pl|Neaniaõ}}

For most people, a given name and family name will be provided. In those cases, if no value is passed to "t", the template will assume only the family name should be shown. For example, <nowiki>{{pl|Yannick|Coquet}}</nowiki> would produce this link: {{pl|Yannick|Coquet}}

In the case of a person who has a "common" name which is different to their given and family names, for example the RLStates player "Pele", whose full name was "Edson Arantes do Nascimento", and the link should point to the full name, you will need to pass all three names. So you would use <nowiki>{{pl|Edson Arantes|do Nascimento|Pele}}</nowiki>, which would then link the text "Pele" to "Edson Arantes do Nascimento". Though in such cases, it would probably be better to redirect "Pele" to "Edson Arantes do Nascimento" in the first place, and just pass <nowiki>{{pl|Pele}}</nowiki>. This same approach can be used for famous personalities who may be better known by a stage name, though again, it may be better to create redirects so the full name does not need to be typed out every time.

Here is a table of example combinations to illustrate:

{| class="wikitable"
|-
! Input !! Output
|-
| <nowiki>{{pl|Example}}</nowiki> || {{pl|Example}}
|-
| <nowiki>{{pl|Example|Person}}</nowiki> || {{pl|Example|Person}}
|-
| <nowiki>{{pl|Example|Person|Mr. X}}</nowiki> || {{pl|Example|Person|Mr. X}}
|-
| <nowiki>{{pl|Example|d=actor, born 2000}}</nowiki> || {{pl|Example|d=actor, born 2000}}
|-
| <nowiki>{{pl|Example|Person|t=s|d=actor, born 2000}}</nowiki> || {{pl|Example|Person|t=s|d=actor, born 2000}}
|-
| <nowiki>{{pl|Example|Person|Mr. X|t=s|d=actor, born 2000}}</nowiki> || {{pl|Example|Person|Mr. X|t=s|d=actor, born 2000}}
|-
| <nowiki>{{pl|Example|Person|Mr. X|d=actor, born 2000}}</nowiki> || {{pl|Example|Person|Mr. X|d=actor, born 2000}}
|}

====Disambiguation clauses====
If there are multiple well known players with the same common name (let's go with "Pele"), you would need to specify which one you want to link to. For this, use the "d" parameter. So if there were a second Neaniaõ, who played for Examplestan, maybe we would distinguish between them by adding "(Examplestani footballer)" to the end of his page title. In which case, <nowiki>{{pl|Neaniaõ}}</nowiki> would point to the wrong person. To get around that, we could pass the disambiguation to the "d" parameter of this template, like <nowiki>{{pl|Neaniaõ|d=Examplestani footballer}}</nowiki>, to produce a link to "Neaniaõ (Examplestani footballer)" instead.

====Type values====
There are also different ways to display the link. While the template will always concatenate the first two parameters passed to produce the link text, and then add the value passed to "d" at the end in brackets if present, we can change how this is displayed. If we only pass two values, the template will use the second one as the link text (on the assumption this is the ''family'' name, e.g. "Coquet"). If we pass three values, the third value will form the link text (on the assumption this is the ''common'' name, e.g. "Pele"), even if a value is passed to "t".

In all other cases, the template will look at the "t" value. The table below shows the different outputs.

{| class="wikitable"
|-
! t-value !! description !! example !! output
|-
| (blank) || default setting: use the family name (second parameter) || <nowiki>{{pl|Yannick|Coquet}}</nowiki> || {{pl|Yannick|Coquet}}
|-
| (blank)<br />with third parameter || default setting: use the "common" name (third parameter) || <nowiki>{{pl|Yannick|Coquet|Le Capitain}}</nowiki> || {{pl|Yannick|Coquet|Le Capitain}}
|-
| initial || rowspan="2" | use the initial of the given name (first parameter),<br /> and the family name (second parameter) || rowspan="2" | <nowiki>{{pl|Yannick|Coquet|t=i}}</nowiki> || rowspan="2" | {{pl|Yannick|Coquet|t=i}}
|-
| i
|-
| first || rowspan="3" | use the given name (first parameter) || rowspan="3" | <nowiki>{{pl|Yannick|Coquet|t=g}}</nowiki> || rowspan="3" | {{pl|Yannick|Coquet|t=g}}
|-
| given
|-
| g
|-
| second || rowspan="2" | use the given name (first parameter),<br /> and the initial of the family name (second parameter) || rowspan="2" | <nowiki>{{pl|Yannick|Coquet|t=s}}</nowiki> || rowspan="2" | {{pl|Yannick|Coquet|t=s}}
|-
| s
|}
</noinclude>

Template:PersonLink - Revision history

Osarius: added an option to display first and second names as link output; useful if specifying a disambiguation clause, to prevent the clause appearing in the like text, but still directing to the correct page

Osarius: should make it a little bit easier to link goalscorers and players in squad lists mainly; no longer need to type out surnames multiple times etc