View source for Template:Welcome-foreign/doc

{{Documentation subpage}}
{{substituted}}
This [[WP:WT|welcome template]] may be used to welcome a user whose edits appear to show poor command of English (or whose edits are not in English at all) and who appear to be fluent in {{#ifeq: {{#language:{{{1|}}}|en}} | {{{1|}}} | another language| {{#language:{{{1|}}}|en}}}}.  It presents a brief welcome message in English, followed by an equivalent one in {{#ifeq: {{#language:{{{1|}}}|en}} | {{{1|}}} | the other language, if a translation is available | {{#language:{{{1|}}}|en}}}}.
{{toc limit|2}}
== Usage ==

{{tlsx|Welcome-foreign|lang{{=}}{{#ifeq: {{#language:{{{1|}}}|en}} | {{{1|}}} | xx | {{{1|}}} }}}}  # where 'xx' is a language code<br>
{{tlsx|Welcome-foreign|{{#ifeq: {{#language:{{{1|}}}|en}} | {{{1|}}} | xx | {{{1|}}} }}}} <span style="margin-left:2.8em"># same as above</span>

== Parameters ==

There is one required parameter, the named param {{para|lang}} (alias: positional {{para|1}}):

* {{para|lang}}{{snd}}a language code; e.g., 'fr' for French, or 'es' for Spanish (see [[m:Table of Wikimedia projects#Projects per language codes|language code table]])
* {{para|1}}{{snd}} same as above

== Example ==

{{tls|Welcome-foreign|{{#ifeq: {{#language:{{{1|}}}|en}} | {{{1|}}} | es | {{{1|}}} }}}} gives:
{{Welcome-foreign|{{#ifeq: {{#language:{{{1|}}}|en}} | {{{1|}}} | es | {{{1|}}} }}}}

== Adding a new language ==

This template will work for any language listed in the [[m:Table of Wikimedia projects|language code table]].  The welcome will be issued in two languages: English, and the user's language, if the lang code corresponds to a language for which a language subpage exists. So, Albanian, Chinese, Dutch, and so on, because the subpages [[Template:Welcome-foreign/Albanian|Albanian]], [[Template:Welcome-foreign/Chinese|Chinese]], and [[Template:Welcome-foreign/Dutch|Dutch]] exist.  For valid lang codes corresponding to a language that doesn't have a subpage, the welcome is issued in English only.  

To update the list, simply add a new subpage with the language name from the table. In particular, the language name should correspond to the value of <code><nowiki>{{#language:xx|en}}</nowiki></code> where 'xx' is the language code (so, <code>chr</code> → '{{#language:chr|en}}', <code>fa</code> → '{{#language:fa|en}}', and so on). Translate the content of [[Template:Welcome-foreign/English]] into the new language, and save it as <code>Template:{{BASEPAGENAME}}/''NewLanguage''</code>. The template code does not need to be changed, and will pick it up automatically. 

'''{{Gray|Suggestion:}}''' save early versions of your translation as <small><code>Template:{{BASEPAGENAME}}/''NewLanguage''&nbsp;(draft)</code></small> until you're certain it's correct. As soon as the file exists under the correct name, it is seen by the template and goes live.

== See also ==
* [[WP:Welcome templates]]{{snd}}for welcoming registered and unregistered users

For welcoming foreign-language users, wrapper templates exist for:
* Albanian → {{tls|welcomeen-sq}}
* Chinese → {{tls|welcomeen-zh}}
* Dutch → {{tls|welcomeen-nl}}
* Farsi (Persian) → {{tls|welcomeen-fa}}
* Finnish → {{tls|welcomeen-fi}}
* French  → {{tls|welcomeen-fr}}
* German → {{tls|welcomeen-de}}
* Hausa → {{tls|welcomeen-ha}}
* Hebrew → {{tls|welcomeen-he}}
* Hindi → {{tls|welcomeen-hi}}
* Japanese → {{tls|welcomeen-ja}}
* Korean → {{tls|welcomeen-ko}}
* Marathi → {{tls|welcomeen-mr}}
* Malayalam → {{tls|welcomeen-ml}}
* Portuguese → {{tls|welcomeen-pt}}
* Russian → {{tls|welcomeen-ru}}
* Spanish  → {{tls|welcomeen-es}}
* Swedish → {{tls|welcomeen-sv}}
* Turkish → {{tls|welcomeen-tr}}
* Ukrainian → {{tls|welcomeen-uk}}
* Urdu → {{tls|welcomeen-ur}}
* Vietnamese → {{tls|welcomeen-vi}}  

<includeonly>{{sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Non-English welcome messages]]
}}</includeonly>