Difference between revisions of "Template:Malay name/doc"

From blackwiki
Jump to navigation Jump to search
imported>Jacklee
m (Added links)
imported>Jonesey95
m (Fix Linter errors using AutoEd)
 
(21 intermediate revisions by 17 users not shown)
Line 1: Line 1:
<includeonly>{{template doc page transcluded|Template:Malay name}}</includeonly>
+
{{Documentation subpage}}
 +
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
  
 
<!--To amend this documentation, please make changes only below this comment.-->
 
<!--To amend this documentation, please make changes only below this comment.-->
 +
==Syntax==
 +
<pre>
 +
{{Malay name|[given name]|[patronymic]|note=on (optional)}}
 +
</pre>
 +
 
==Usage==
 
==Usage==
This template is put at the top of a biographical article to explain to readers that the second element of a Malay name is not the [[family name]] but a [[patronymic]], that is, the [[given name]] of his or her father. There are two versions of the template:
+
This template is a [[Wikipedia:Hatnote|hatnote]] that can be put at the top of a biographical article to explain to readers that the second element of a Malay name is not the [[surname|family name]] but a [[patronymic]], that is, the [[given name]] of the subject's father. The parameters that the template takes are listed below:
  
{| class="wikitable"
+
{| class=wikitable width=100%
 
|-
 
|-
!width="20%"|Template
+
!width=20%|Parameter
!Description
+
!width=80%|Description
 
+
|- style="vertical-align:top;"
|- valign="top"
+
| style="text-align:center;" |[''given name'']
|align="center"|{{tl|Malay name}}
+
|Replace this term with the person's given or personal name(s).
|This is the standard notice, which explains what is mentioned in the paragraph above.
+
|- style="vertical-align:top;"
 
+
| style="text-align:center;" |[''patronymic'']
|- valign="top"
+
|Replace this term with the person's patronymic, or father's name.
|align="center"|{{tl|Malay name2}}
+
|- style="vertical-align:top;"
|In addition to the standard notice, this template explains the meanings of the [[Malay language|Malay]] words ''bin'' (often abbreviated "''b.''") and ''binte'' ("''bte.''").
+
| style="text-align:center;" |note
 +
|'''Optional''': if "note=on", the following explanatory note is displayed: "The Arabic word ''bin'' (''b.'') or ''binti''/''binte'' (''bt.''/''bte.''), if used, means 'son of' or 'daughter of' respectively." These abbreviations are often used by [[Malays (ethnic group)|Malays]] in [[Brunei]], [[Malaysia]] and [[Singapore]]. If "note=off" or the "note" parameter is omitted, the explanatory note is not displayed.
 +
|}
  
 +
==Example==
 +
{| class=wikitable width=100%
 +
|-
 +
!width=40%|Wikitext
 +
!width=60%|Result
 +
|- style="vertical-align:top;"
 +
| style="text-align:center;" |<code><nowiki>{{Malay name|Zubir|Said}}</nowiki></code>
 +
|{{Malay name|Zubir|Said}}
 +
|- style="vertical-align:top;"
 +
| style="text-align:center;" |<code><nowiki>{{Malay name|Mohammad Said|Yusof|note=on}}</nowiki></code>
 +
|{{Malay name|Mohammad Said|Yusof|note=on}}
 
|}
 
|}
  
Each template should be used as follows:
+
<includeonly>{{Sandbox other||
 
+
<!-- CATEGORIES HERE, THANKS -->
:<nowiki>{{</nowiki>Malay name|''(given name)''|''(patronymic)''}}
+
[[Category:Hatnote templates for names]]
 
+
}}</includeonly>
For instance, if the subject of the biographical article is named "[[Zubir Said]]" or "Zubir bin Said", the template should be set out like this:
+
<templatedata>
 
+
{
:<nowiki>{{</nowiki>Malay name|Zubir|Said}}
+
"params": {
 +
"1": {
 +
"label": "Given name",
 +
"description": "The person's Given name in Malay",
 +
"example": "Najib",
 +
"type": "line",
 +
"required": true
 +
},
 +
"2": {
 +
"label": "Patronymic",
 +
"description": "The person's patronymic name in Malay",
 +
"example": "Razak",
 +
"type": "line",
 +
"required": true
 +
},
 +
"note": {
 +
"label": "Note",
 +
"example": "'off' or 'on'",
 +
"description": "If \"on\", attaches an explanatory note on Malay naming conventions",
 +
"type": "string"
 +
}
 +
},
 +
"format": "{{_| _ = _}}\n",
 +
"description": "Explains that the person the article is about has a Malay name, and optionally its associated naming customs"
 +
}
 +
</templatedata>

Latest revision as of 14:15, 31 May 2020

Syntax

{{Malay name|[given name]|[patronymic]|note=on (optional)}}

Usage

This template is a hatnote that can be put at the top of a biographical article to explain to readers that the second element of a Malay name is not the family name but a patronymic, that is, the given name of the subject's father. The parameters that the template takes are listed below:

Parameter Description
[given name] Replace this term with the person's given or personal name(s).
[patronymic] Replace this term with the person's patronymic, or father's name.
note Optional: if "note=on", the following explanatory note is displayed: "The Arabic word bin (b.) or binti/binte (bt./bte.), if used, means 'son of' or 'daughter of' respectively." These abbreviations are often used by Malays in Brunei, Malaysia and Singapore. If "note=off" or the "note" parameter is omitted, the explanatory note is not displayed.

Example

Wikitext Result
{{Malay name|Zubir|Said}}
{{Malay name|Mohammad Said|Yusof|note=on}}


Explains that the person the article is about has a Malay name, and optionally its associated naming customs

Template parameters

This template has custom formatting.

ParameterDescriptionTypeStatus
Given name1

The person's Given name in Malay

Example
Najib
Linerequired
Patronymic2

The person's patronymic name in Malay

Example
Razak
Linerequired
Notenote

If "on", attaches an explanatory note on Malay naming conventions

Example
'off' or 'on'
Stringoptional