Template:Userbox-lang/doc: Difference between revisions

From FamilySearch Wiki
m (added link)
(→‎Example: fix nocat parameters in examples)
(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 and one named parameter.
The template has two 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
## basic
#* 1 = basic
## intermediate
#* 2 =  intermediate
## advanced  
#* 3 =  advanced  
## near-native
#* 4 =  near-native
## professional
#* 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.


===Examples ===
===Example===
==== 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 43:
|
|
{{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:Language Userboxes|{{PAGENAME}}]]
[[Category:Userboxes|{{PAGENAME}}]]
</includeonly>
</includeonly>

Revision as of 06:23, 28 December 2010

Purpose[edit source]

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.

  1. The first unnamed parameter is a two-letter code 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.
    1. basic
    2. intermediate
    3. advanced
    4. near-native
    5. professional

Example[edit source]

NOTE: The template can be called using {{Userbox-lang}} or {{UBX-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