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

From FamilySearch Wiki
Jump to navigation Jump to search
(→‎Parameters: add named parameter {{{skill}}})
m (added link)
 
(2 intermediate revisions by one other user not shown)
Line 5: Line 5:
 
The template has two unnamed parameters and one named parameter.
 
The template has two unnamed parameters and one named parameter.
 
==== Unnamed parameters ====
 
==== Unnamed parameters ====
# The first unnamed parameter is a two-letter code according to the {{wpd|ISO 639-1}} standard
+
# 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.
 
#* 0 = limited or no ability
 
#* 0 = limited or no ability
Line 16: Line 16:
 
;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.
 
;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 of different language codes===
+
===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 47: Line 48:
 
{{Userbox-lang|ja|1|nocat=}}
 
{{Userbox-lang|ja|1|nocat=}}
 
|}
 
|}
=== Example of different ability levels ===
+
==== Using different ability levels ====
 
Using English as an example the following shows the range of abilities that can be choosen.
 
Using English as an example the following shows the range of abilities that can be choosen.
 
{| cellspacing="0" border="1"
 
{| cellspacing="0" border="1"
Line 111: Line 112:
 
|}
 
|}
  
 +
==== 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