Difference between revisions of "Template:Userbox-lang/doc"

From FamilySearch Wiki
Jump to navigation Jump to search
(→‎Example: fix nocat parameters in examples)
m (added link)
 
(6 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
{{documentation subpage}}
 
{{documentation subpage}}
=== Purpose ===
 
 
This template can be used to display the language and level of ability spoken by a contributor on their [[user page]].
 
This template can be used to display the language and level of ability spoken by a contributor on their [[user page]].
  
 
=== Parameters ===
 
=== Parameters ===
The template has two unnamed parameters.
+
The template has two unnamed parameters and one named parameter.
# The first unnamed parameter is a two-letter code according to the {{wpd|ISO 639-1}} standard
+
==== Unnamed parameters ====
 +
# The first unnamed parameter is a two-letter code (see [[Template:ISO_639-1_Lists|ISO list]]) according to the {{wpd|ISO 639-1}} standard
 
# The second (optional) unnamed parameter is a number to indicate the level of ability in this language. If this parameter is omitted the wording for native speaker will be displayed.
 
# The second (optional) unnamed parameter is a number to indicate the level of ability in this language. If this parameter is omitted the wording for native speaker will be displayed.
## basic
+
#* 0 = limited or no ability
## intermediate
+
#* 1 = basic
## advanced  
+
#* 2 =  intermediate
## near-native
+
#* 3 =  advanced  
## professional
+
#* 4 =  near-native
 +
#* 5 =  professional
 +
==== Named parameters ====
 +
;skill : This (optional) parameter can be used to define a skill other than speaking, for example reading or writing. If omitted the default is speaking.
  
===Example===
+
===Examples ===
 +
==== Using different language codes ====
 
'''NOTE:''' The template can be called using {{tl|Userbox-lang}} or {{tl|UBX-lang}}
 
'''NOTE:''' The template can be called using {{tl|Userbox-lang}} or {{tl|UBX-lang}}
 
{| cellspacing="0" border="1"
 
{| cellspacing="0" border="1"
Line 43: Line 47:
 
|
 
|
 
{{Userbox-lang|ja|1|nocat=}}
 
{{Userbox-lang|ja|1|nocat=}}
 +
|}
 +
==== Using different ability levels ====
 +
Using English as an example the following shows the range of abilities that can be choosen.
 +
{| cellspacing="0" border="1"
 +
!style="width:33%"|Ability
 +
!style="width:33%"|You type
 +
!style="width:33%"|You get
 +
|-
 +
| Native ability
 +
|
 +
<pre>
 +
{{UBX-lang|en}}
 +
</pre>
 +
|
 +
{{UBX-lang|en|nocat=}}
 +
|-
 +
| Professional ability
 +
|
 +
<pre>
 +
{{UBX-lang|en|5}}
 +
</pre>
 +
|
 +
{{UBX-lang|en|5|nocat=}}
 +
|-
 +
| Near-native ability
 +
|
 +
<pre>
 +
{{Userbox-lang|en|4}}
 +
</pre>
 +
|
 +
{{Userbox-lang|en|4|nocat=}}
 +
|-
 +
|  Advanced ability
 +
|
 +
<pre>
 +
{{Userbox-lang|en|3}}
 +
</pre>
 +
|
 +
{{Userbox-lang|en|3|nocat=}}
 +
|-
 +
| Intermediate ability
 +
|
 +
<pre>
 +
{{Userbox-lang|en|2}}
 +
</pre>
 +
|
 +
{{Userbox-lang|en|2|nocat=}}
 +
|-
 +
| Basic ability
 +
|
 +
<pre>
 +
{{Userbox-lang|en|1}}
 +
</pre>
 +
|
 +
{{Userbox-lang|en|1|nocat=}}
 +
|-
 +
| Limited ability
 +
|
 +
<pre>
 +
{{Userbox-lang|en|0}}
 +
</pre>
 +
|
 +
{{Userbox-lang|en|0|nocat=}}
 +
|}
 +
 +
==== Using different skills ====
 +
{| cellspacing="0" border="1"
 +
!style="width:33%"|Situation
 +
!style="width:33%"|You type
 +
!style="width:33%"|You get
 +
|-
 +
| Intermediate reader speaker of Spanish
 +
|
 +
<pre>
 +
{{UBX-lang|es|2|skill=reader}}
 +
</pre>
 +
|
 +
{{UBX-lang|es|2|skill=reader|nocat=}}
 +
|-
 +
| Professional reader and writer of Welsh
 +
|
 +
<pre>
 +
{{UBX-lang|cy|5|skill=reader and writer}}
 +
</pre>
 +
|
 +
{{UBX-lang|cy|5|skill=reader and writer|nocat=}}
 +
|-
 +
| Basic reader, writer and speaker of German
 +
|
 +
<pre>
 +
{{UBX-lang|de|1
 +
|skill=reader, writer and speaker}}
 +
</pre>
 +
|
 +
{{UBX-lang|de|1|skill=reader, writer and speaker|nocat=}}
 
|}
 
|}
  
 
<includeonly>
 
<includeonly>
[[Category:Userboxes|{{PAGENAME}}]]
+
[[Category:Language Userboxes|{{PAGENAME}}]]
 
</includeonly>
 
</includeonly>

Latest revision as of 19:47, 18 February 2015

This template can be used to display the language and level of ability spoken by a contributor on their user page.

Parameters[edit source]

The template has two unnamed parameters and one named parameter.

Unnamed parameters[edit source]

  1. The first unnamed parameter is a two-letter code (see ISO list) according to the ISO 639-1 standard
  2. The second (optional) unnamed parameter is a number to indicate the level of ability in this language. If this parameter is omitted the wording for native speaker will be displayed.
    • 0 = limited or no ability
    • 1 = basic
    • 2 = intermediate
    • 3 = advanced
    • 4 = near-native
    • 5 = professional

Named parameters[edit source]

skill 
This (optional) parameter can be used to define a skill other than speaking, for example reading or writing. If omitted the default is speaking.

Examples[edit source]

Using different language codes[edit source]

NOTE: The template can be called using {{Userbox-lang}} or {{Template:Userbox-lang}}

Situation You type You get
Native speaker of English
{{UBX-lang|en}} 
en This user is a native speaker of English
Advanced speaker of Spanish
{{UBX-lang|es|3}} 
es-3 This user is an advanced speaker of Spanish
Basic speaker of Japanese
{{Userbox-lang|ja|1}} 
ja-1 This user is a basic speaker of Japanese

Using different ability levels[edit source]

Using English as an example the following shows the range of abilities that can be choosen.

Ability You type You get
Native ability
{{UBX-lang|en}} 
en This user is a native speaker of English
Professional ability
{{UBX-lang|en|5}} 
en-5 This user is a professional speaker of English
Near-native ability
{{Userbox-lang|en|4}} 
en-4 This user is a near-native speaker of English
Advanced ability
{{Userbox-lang|en|3}} 
en-3 This user is an advanced speaker of English
Intermediate ability
{{Userbox-lang|en|2}} 
en-2 This user is an intermediate speaker of English
Basic ability
{{Userbox-lang|en|1}} 
en-1 This user is a basic speaker of English
Limited ability
{{Userbox-lang|en|0}} 
en-0 This user does not understand English (or understands it with considerable difficulty).

Using different skills[edit source]

Situation You type You get
Intermediate reader speaker of Spanish
{{UBX-lang|es|2|skill=reader}} 
es-2 This user is an intermediate reader of Spanish
Professional reader and writer of Welsh
{{UBX-lang|cy|5|skill=reader and writer}} 
cy-5 This user is a professional reader and writer of Welsh
Basic reader, writer and speaker of German
{{UBX-lang|de|1
|skill=reader, writer and speaker}} 
de-1 This user is a basic reader, writer and speaker of German