View source for Template:Google translation/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->

== Usage ==

This template creates an [[WP:EL|external link]] to a [[Google Translate]] page, which can translate the text from a [[Web page]] in a source language to a destination language. Syntax:

 <nowiki>{{Google translation|</nowiki>''destination language code''|''source language code''|''URL of page to translate''|''link text''<nowiki>}}</nowiki>

If you leave the <code>''link text''</code> argument blank, “Google translation” appears as the default text.

Some URLs that contain special characters, such as <code>&</code> or <code>=</code>, will break the template. The solution is to prepend the URL with <code>3=</code>, for example <code><nowiki>{{Google translation|ru|en|3=http://www.example.org/this-url-contains-=}}</nowiki></code> resulting in {{Google translation|ru|en|3=http://www.example.org/this-url-contains-=}}

The following languages below are available in any pairings, with their language code <ref>https://cloud.google.com/translate/docs/languages</ref>. (As of March 26, 2021):
{{div col|colwidth=16em}}
#[[Afrikaans]] <code>af</code>
#[[Albanian language|Albanian]] <code>sq</code>
#[[Amharic]] <code>am</code>
#[[Arabic]] <code>ar</code>
#[[Armenian language|Armenian]] <code>hy</code>
#[[Azerbaijani language|Azerbaijani]] <code>az</code>
#[[Basque language|Basque]] <code>eu</code>
#[[Belarusian language|Belarusian]] <code>be</code>
#[[Bengali language|Bengali]] <code>bn</code>
#[[Bosnian language|Bosnian]] <code>bs</code>
#[[Bulgarian language|Bulgarian]] <code>bg</code>
#[[Burmese language|Burmese]] <code>my</code>
#[[Catalan language|Catalan]] <code>ca</code>
#[[Cebuano language|Cebuano]] <code>ceb</code> (ISO-639-2)
#[[Chewa language|Chewa]] <code>ny</code>
#[[Chinese language|Chinese]] ([[simplified Chinese characters|Simplified]]) <code>zh</code> or <code>zh-TW</code> (BCP-47)
#[[Chinese language|Chinese]] ([[traditional Chinese characters|Traditional]]) <code>zh-CN</code> (BCP-47)
#[[Corsican language|Corsican]] <code>co</code>
#[[Croatian language|Croatian]] <code>hr</code>
#[[Czech language|Czech]] <code>cs</code>
#[[Danish language|Danish]] <code>da</code>
#[[Dutch language|Dutch]] <code>nl</code>
#[[English language|English]] <code>en</code>
#[[Esperanto]] <code>eo</code>
#[[Estonian language|Estonian]] <code>et</code>
#[[Filipino language|Filipino]] ([[Tagalog language|Tagalog]]) <code>tl</code>
#[[Finnish language|Finnish]] <code>fi</code>
#[[French language|French]] <code>fr</code>
#[[Galician language|Galician]] <code>gl</code>
#[[Georgian language|Georgian]] <code>ka</code>
#[[German language|German]] <code>de</code>
#[[Greek language|Greek]] <code>el</code>
#[[Gujarati language|Gujarati]] <code>gu</code>
#[[Haitian Creole]] <code>ht</code>
#[[Hausa language|Hausa]] <code>ha</code>
#[[Hawaiian language|Hawaiian]] <code>haw</code> (ISO-639-2)
#[[Hebrew language|Hebrew]] <code>he</code> or <code>iw</code>
#[[Hindi]] <code>hi</code>
#[[Hmong language|Hmong]] <code>hmn</code> (ISO-639-2)
#[[Hungarian language|Hungarian]] <code>hu</code>
#[[Icelandic language|Icelandic]] <code>is</code>
#[[Igbo language|Igbo]] <code>ig</code>
#[[Indonesian language|Indonesian]] <code>id</code>
#[[Irish language|Irish]] <code>ga</code>
#[[Italian language|Italian]] <code>it</code>
#[[Japanese language|Japanese]] <code>ja</code>
#[[Javanese language|Javanese]] <code>jv</code>
#[[Kannada]] <code>kn</code>
#[[Kazakh language|Kazakh]] <code>kk</code>
#[[Khmer language|Khmer]] <code>km</code>
#[[Kinyarwanda]] <code>rw</code>
#[[Korean language|Korean]] <code>ko</code>
#[[Kurdish languages|Kurdish]] ([[Kurmanji]]) <code>ku</code>
#[[Kyrgyz language|Kyrgyz]] <code>ky</code>
#[[Lao language|Lao]] <code>lo</code>
#[[Latin]] <code>la</code>
#[[Latvian language|Latvian]] <code>lv</code>
#[[Lithuanian language|Lithuanian]] <code>lt</code>
#[[Luxembourgish]] <code>lb</code>
#[[Macedonian language|Macedonian]] <code>mk</code>
#[[Malagasy language|Malagasy]] <code>mg</code>
#[[Malay language|Malay]] <code>ms</code>
#[[Malayalam]] <code>ml</code>
#[[Maltese language|Maltese]] <code>mt</code>
#[[Māori language|Maori]] <code>mi</code>
#[[Marathi language|Marathi]] <code>mr</code>
#[[Mongolian language|Mongolian]] <code>mn</code>
#[[Nepali language|Nepali]] <code>ne</code>
#[[Norwegian language|Norwegian]] ([[Bokmål]]) <code>no</code>
#[[Odia language|Odia]] <code>or</code>
#[[Pashto]] <code>ps</code>
#[[Persian language|Persian]] <code>fa</code>
#[[Polish language|Polish]] <code>pl</code>
#[[Portuguese language|Portuguese]] <code>pt</code>
#[[Punjabi language|Punjabi]] ([[Gurmukhi]]) <code>pa</code>
#[[Romanian language|Romanian]] <code>ro</code>
#[[Russian language|Russian]] <code>ru</code>
#[[Samoan language|Samoan]] <code>sm</code>
#[[Scottish Gaelic]] <code>gd</code>
#[[Serbian language|Serbian]] <code>sr</code>
#[[Shona language|Shona]] <code>sn</code>
#[[Sindhi language|Sindhi]] <code>sd</code>
#[[Sinhala language|Sinhala]] <code>si</code>
#[[Slovak language|Slovak]] <code>sk</code>
#[[Slovene language|Slovenian]] <code>sl</code>
#[[Somali language|Somali]] <code>so</code>
#[[Sotho language|Sotho]] <code>st</code>
#[[Spanish language|Spanish]] <code>es</code>
#[[Sundanese language|Sundanese]] <code>su</code>
#[[Swahili language|Swahili]] <code>sw</code>
#[[Swedish language|Swedish]] <code>sv</code>
#[[Tajik language|Tajik]] <code>tg</code>
#[[Tamil language|Tamil]] <code>ta</code>
#[[Tatar language|Tatar]] <code>tt</code>
#[[Telugu language|Telugu]] <code>te</code>
#[[Thai language|Thai]] <code>th</code>
#[[Turkish language|Turkish]] <code>tr</code>
#[[Turkmen language|Turkmen]] <code>tk</code>
#[[Ukrainian language|Ukrainian]] <code>uk</code>
#[[Urdu]] <code>ur</code>
#[[Uyghur language|Uyghur]] <code>ug</code>
#[[Uzbek language|Uzbek]] <code>uz</code>
#[[Vietnamese language|Vietnamese]] <code>vi</code>
#[[Welsh language|Welsh]] <code>cy</code>
#[[West Frisian language|West Frisian]] <code>fy</code>
#[[Xhosa language|Xhosa]] <code>xh</code>
#[[Yiddish]] <code>yi</code>
#[[Yoruba language|Yoruba]] <code>yo</code>
#[[Zulu language|Zulu]] <code>zu</code>
{{div col end}}

Some languages provide translations whose quality is [[Machine translation|not as good as a professional translation]]. This is because the underlying algorithms rely on having a sufficiently large corpus of existing high quality translations <ref>https://www.aclweb.org/anthology/W17-5704/</ref>. However, these translations are useful to get a rough idea of the original document. See [[Google Translate]] for updates to the list of available languages.

=== Avoid using in articles ===

[[WP:EL#Non-English language content]] advises against linking to non-English content from [[WP:WIAA|articles]] in the [[English Wikipedia]], but does not forbid it in all cases. Links to machine-translated pages from articles may lead to disputes with other editors, who may feel the quality of translation is insufficient to create a [[WP:RS|reliable source]]. Therefore, use your judgment, and check the quality of translation to make sure it is adequate to use as a source.

There should be no problem with using this template on non-article pages, such as [[Help:Talk page|talk pages]], the [[WP:HD|Help desk]], and so on. See the similar advice for template such as {{Tl|Google}}.

=== Examples ===

{| class="wikitable"
! Type this !! To get this !! What it produces
|-
| <code><nowiki>{{Google translation|en|zh-CN|https://zh.wikipedia.org|Translate the Chinese Wikipedia to English}}</nowiki></code> || {{Google translation|en|zh-CN|https://zh.wikipedia.org|Translate the Chinese Wikipedia to English}} || Translate the [[Chinese Wikipedia]] to English
|-
| <code><nowiki>{{Google translation|en|da|https://da.wikipedia.org|Translate the Danish Wikipedia to English}}</nowiki></code> || {{Google translation|en|da|https://da.wikipedia.org|Translate the Danish Wikipedia to English}} || Translate the [[Danish Wikipedia]] to English
|-
| <code><nowiki>{{Google translation|en|nl|https://nl.wikipedia.org|Translate the Dutch Wikipedia to English}}</nowiki></code> || {{Google translation|en|nl|https://nl.wikipedia.org|Translate the Dutch Wikipedia to English}} || Translate the [[Dutch Wikipedia]] to English
|-
| <code><nowiki>{{Google translation|en|de|https://de.wikipedia.org|Translate the German Wikipedia to English}}</nowiki></code> || {{Google translation|en|de|https://de.wikipedia.org|Translate the German Wikipedia to English}} || Translate the [[German Wikipedia]] to English
|-
| <code><nowiki>{{Google translation|en|it|https://it.wikipedia.org|Translate the Italian Wikipedia to English}}</nowiki></code> || {{Google translation|en|it|https://it.wikipedia.org|Translate the Italian Wikipedia to English}} || Translate the [[Italian Wikipedia]] to English
|-
| <code><nowiki>{{Google translation|en|pt|https://pt.wikipedia.org|Translate the Portuguese Wikipedia to English}}</nowiki></code> || {{Google translation|en|pt|https://pt.wikipedia.org|Translate the Portuguese Wikipedia to English}} || Translate the [[Portuguese Wikipedia]] to English
|-
| <code><nowiki>{{Google translation|en|es|https://es.wikipedia.org|Translate the Spanish Wikipedia to English}}</nowiki></code> || {{Google translation|en|es|https://es.wikipedia.org|Translate the Spanish Wikipedia to English}} || Translate the [[Spanish Wikipedia]] to English
|-
| <code><nowiki>{{Google translation|es|en|https://en.wikipedia.org|Translate the English Wikipedia to Spanish}}</nowiki></code> || {{Google translation|es|en|https://en.wikipedia.org|Translate the English Wikipedia to Spanish}} || Translate the [[English Wikipedia]] to Spanish
|-
| <code><nowiki>{{Google translation|pt|en|https://en.wikipedia.org|Translate the English Wikipedia to Portuguese}}</nowiki></code> || {{Google translation|pt|en|https://en.wikipedia.org|Translate the English Wikipedia to Portuguese}} || Translate the [[English Wikipedia]] to Portuguese
|-
| <code><nowiki>{{Google translation|it|en|https://en.wikipedia.org|Translate the English Wikipedia to Italian}}</nowiki></code> || {{Google translation|it|en|https://en.wikipedia.org|Translate the English Wikipedia to Italian}} || Translate the [[English Wikipedia]] to Italian
|-
| <code><nowiki>{{Google translation|ar|en|https://en.wikipedia.org|Translate the English Wikipedia to Arabic}}</nowiki></code> || {{Google translation|ar|en|https://en.wikipedia.org|Translate the English Wikipedia to Arabic}} || Translate the [[English Wikipedia]] to Arabic
|-
|}

== See also ==
* {{tl|machinetranslate}} - a "links to automatic translations" template that does more than Template:Google_translation.
* {{tl|rough translation}} - to tag articles whose text seems to be generated through machine translation
* [[WP:EIW#Transl]] - Editor's index to Wikipedia, links to resources for translation
{{Google templates}}

== External links ==

*[https://support.google.com/translate/?hl=en Google Translate Help]

<includeonly>{{Sandbox other||<!--
++++ PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, THANK YOU. -->
[[Category:Google templates|{{PAGENAME}}]]
[[Category:Wikipedia translation templates]]
[[es:Plantilla:Traducción Google]]
[[fr:Modèle:Traduction Google]]
[[ja:Template:Google translation]]
}}</includeonly>