View source for Template:Userbox-lang/doc

{{documentation subpage}}
This template can be used to display the language and level of ability spoken by a contributor on their [[user page]].

=== Parameters ===
The template has two unnamed parameters and one named parameter.
==== Unnamed parameters ====
# The first unnamed parameter is a two-letter code 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.
#* 0 = limited or no ability
#* 1 = basic
#* 2 =  intermediate
#* 3 =  advanced 
#* 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.

===Examples ===
==== Using different language codes ====
'''NOTE:''' The template can be called using {{tl|Userbox-lang}} or {{tl|UBX-lang}}
{| cellspacing="0" border="1"
!style="width:33%"|Situation
!style="width:33%"|You type
!style="width:33%"|You get
|-
| Native speaker of English
|
<pre>
{{UBX-lang|en}} 
</pre>
|
{{UBX-lang|en|nocat=}}
|-
| Advanced speaker of Spanish
|
<pre>
{{UBX-lang|es|3}} 
</pre>
|
{{UBX-lang|es|3|nocat=}}
|-
| Basic speaker of Japanese
|
<pre>
{{Userbox-lang|ja|1}} 
</pre>
|
{{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>
[[Category:Userboxes|{{PAGENAME}}]]
</includeonly>