Commons:Translation possible/Learn more

Shortcut: COM:TPLM català | čeština | Deutsch | English | español | Esperanto | فارسی | français | galego | עברית | hrvatski | italiano | 日本語 | 한국어 | македонски | polski | português | русский | українська | Tiếng Việt | 中文（繁體） | 中文（简体） | +/−

How to translate an SVG file

Further information: Help:Translation tutorial and Commons:Graphic Lab/Translations

This page explains how to translate inside labels or captions in an SVG file. You are probably here because someone tagged an image with {{Translate}}. Please note that this template and its related pages is a one-man idea. If you have questions or comments about it, please use the template discussion page.

What is SVG?

SVG is an image file format that consists of plain XML text. Therefore the text labels stored in it can be easily translated. For more information about SVG or XML, please use the links. There are Wikipedia articles in many languages.

How powerful are SVGs

• SVGs produce nice images you can zoom in, with a high level of precision and without losing definition:

• 
• 

• SVGs can hold different text translations within the same file; the following images use the same image file, but the text depends on the context. The first image uses the language of the page dynamically. The second image is forced to display its text in English (of course, there is no difference with the first image if the page is already in English). The remaining images additionally show examples in French and German, respectively (using the same image file):

• 
• 
• 
• 

How do I edit SVGs?

There are different ways to translate text in SVG:

• Use a graphics editor such as Inkscape. For compatibility, save the file as "Plain SVG", not "Inkscape SVG", as the latter format may introduce errors, even though it complies with the SVG specification.
• Edit the SVG file as a text file.

For editing image in any offline editor, first download the file you want to edit, open the file in the editor, translate the labels, and then save it. When finished, upload the file to Commons under a new name.

Text editing

Note that instead of using a graphics editor, you can use any (plain text) editor capable to store the text in UTF-8 format. Find text to translate by searching for <text> tags. In some cases this might be a path for more advanced users as text coordinates adjustments might be needed and some more advanced "garbage" might decrease readability of the SVG.

Preparing a file for translation

Using real text

Main gallery: Template:Path text SVG.

Only real text, in the form of the SVG <text> element, can be translated. Do not use paths instead of text when creating or generating a SVG (with some justified exceptions).

Anchoring the text correctly

To make sure text placement "just work" in the translated versions, you should properly use the anchoring functionality of the SVG format and your editor. In most editors (including Inkscape), the function is decided by the typographic alignment option. Anchoring decides how the position of the text is specified. Anchoring to the center means the coordinates specified is the center of the text, and is used in most editors for centering.

By saying "properly use", we mean that the way you anchor it matches the actual design intentions. For example, to center some text on a pyramid, you use the centering anchor while putting the anchor point itself at the middle of the shape. To position a label for something on its right, use the "end" (right-hand-side) anchor. The "align and distribute" option in Inkscape DOES NOT change your anchoring options; it only moves the elements around.

(Yes, the "end" anchor is only on the right for left-to-right languages. A translation tool should probably invert it for RTL languages.)

Multiple translations within one SVG file (preferred method)

Shortcut

• Switch SVG

An example of a simple SVG with translations in one file. Go to file's page and render this text in English, German, French, Spanish...

An example of a simple SVG with translations in one file. See the description page for details

Similar example with arrows

You can place multiple translations into one SVG file using the SVG <switch> element. The resulting multilingual file has the advantage of sharing graphics; if the graphics are updated, then all the languages get the updated graphics. Compare to having several translated files; an update to one of the files does not propagate to the other language versions.

However, not all graphics editors can edit the text contained in the switch element. In such cases, a graphics editor may still be used to edit the text positions and sizes (such as in Inkscape), and the SVG Translate tool at Commons can be used to add translations, and most separate text editors can be used to make changes to the texts throughout the multiple languages. Loading an SVG file with switch translations into a graphics editor and then saving it may remove all the translations. Please note that multi-language translations in SVG files larger than 5MB may not render properly due to a bug.

It is advisable to give an extra margin for text contained in images with switch elements, in order to allow for current or future languages that need more letters.

Coding

When you have a <switch> element, its children (sub-elements) represent possible choices. The children of the switch should have a systemLanguage attribute that specifies the language(s). SVG sequentially looks at each child; if there is a systemLanguage attribute and it does not match, SVG moves on to the next child. If the systemLanguage attribute matches or is not present, then SVG renders that child and does not look further. Omitting the systemLanguage attribute from the last child will implement a default rendering.

Note: The order is important! All children following the child with the omitted systemLanguage are ignored and have no effect!

<switch transform="translate(100,200)">
  <text systemLanguage="en">Population pyramid of Russia (2010)</text>
  <text systemLanguage="de">Alterspyramide von Russland (2010)</text>
  <text systemLanguage="ru">Половозрастная диаграмма России (2010)</text>
  <text>Population pyramid of Russia (2010)</text>
</switch>

Even if the default rendering is English, it is good practice to place an explicit systemLanguage="en" with the same text. The language matching rules can give unexpected behavior when the file is opened in a browser configured for multiple languages. If the languages do not follow the same sequence in each switch, then a browser may display a mix of languages. In addition, the language matching rules will change in SVG 2.0.

You can also have a systemLanguage attribute on an element that is not a child of a switch element. In this case the element will only be rendered if the language matches. Otherwise the element in question will not be displayed.

Currently, only a few graphical editors support language switches in SVG, so you may need to edit the SVG file with a plain text editor. A good practise is to place the switches in the defs section. The SVG Translate may be used if the SVG file follows specific conventions.

The different text translations will have different lengths, so the text anchor point should be chosen carefully. The text-anchor attribute can be set to start (left justified in most languages), middle (centered), or end (right justified). The text elements default to x="0" and y="0", so the switch element can set the text anchor point with transform="translate(100,200)".

CSS can be added to globally scale text for verbose or concise translations, such as:

 <style type="text/css">
text[systemLanguage="es" i] { font-size: 80%; }
text[systemLanguage="zh" i] { font-size:125%; }
 </style>

Setting up multiple translations within one SVG file with Inkscape

Inkscape does not support the addition of language switches, but they are recognized as a "Conditional Group". Editing with text editor is required. To start using the switch element in Inkscape, the following steps are:

1. Always, in a new drawing, you need to add the two tags of <switch>...</switch>. In a new drawing, or in a previous localized drawing, you will have to add the items (usually text to localize) between these two tags and with systemLanguage assigned.
2. In drawings that use labels and arrows, it can often happen that (depending on the language) the labels and arrows position is not the most appropriate. You can correct it, after the previous step, directly with Inkscape. But if you need to change the text or arrows of a language that is not what Inkscape has configured, you must first change the Inkscape interface. To change the language of the Inkscape interface: from the menu bar, select "Edit|Preferences..."; then in the opened window, in the second group ("Interface") change the language. You can look at the code from the last example, above (SystemLanguageArrows.svg). Note: In the examples, the ID names of the objects have been changed in order to be followed more easily.
3. For the previous changes, you must be careful about the changes you make, otherwise Inkscape will not show what you want. If this is the first time you do it, first try changing the examples above. Sometimes the Inkscape XML editor ("Edit|XML Editor...") can be useful for you to find an error in your changes.

Viewing

Most browsers support viewing SVG files with switch elements. The browser will display the languages according to the browser's default language settings. If one wants to view a different language, then change the language of the browser and restart it.

Another way of viewing the file is to upload it to File:Test.svg and select the desired language from the dropdown list.

Tool

• https://svgtranslate.toolforge.org

  Hint: The tool is reported as buggy. When in doubt, it is preferable to edit svg files with a plain text editor.

Use

To use the file in non-English wiki project, you can use it as usual, but with the |lang= parameter

use "lang=en" -- displays in English

use "lang=id" -- displays in Indonesian

use "lang=zh-hans" -- displays in Simplified Chinese

You may also use the same method for gallery

• 
  "lang=en"
• 
  "lang=id"
• 
  "lang=zh-hans"

When rendering a multi-lingual SVG image on a MediaWiki page, the language to use can be specified using syntax like [[File:SystemLanguage.svg|lang=de]]. The attribute "lang" is optional; if it is missing, MediaWiki will attempt to use the wiki's default language or fallback to English ("en").

Note: If a switch element has an English-language clause (systemLanguage="en") and a default language clause (no systemLanguage attribute), then MediaWiki will display the English-language clause.

Maps

Multiple translations with symbols

Example for Symbols and Labels

It becomes more complex, if you have not only a label but additionally one ore more symbols identifying an object.

You can see in an example on the right how to do this in a clear, concise and comprehensible manner:

Define the symbols in the <defs> section, insert them into the map using a <use> statement, and then place the label (in multiple languages) relative (sic!) to the symbol with a second <use> statement.

Multiple translations with a mix of ltr and rtl languages

Draft of a sample file (arabic)

Draft of a sample file (english)

It looks more authentic when the icon is placed before the text within a legend. This is a challenge, if you have to handle a mixture of left-to-right and right-to-left languages. It is a matter of using an additional <switch> construction to shift the icons to either the left or right position. This results in nested <switch> statements that are quite complex.

You can see in an example on the right how to do this in a clear, concise and comprehensible manner:

Define the symbols and the switches with the translations of the labels in the <defs> section. Then group each of them in a <g> element. Then insert them both into the legends section in another <switch> construction. Do this twice, once for 'rtl' languages, then for all others ('ltr' languages). Each time with an adjusted y="4711" parameter, so that the icons are placed on the right-hand side of the legend one time and on the left-hand side the other time.

See also a more complex example.

See also Category Multilingual SVG maps

How to place new monolingual version in Commons

When creating a translated version of an SVG file, it should be saved using the filename of the original file with an IETF langtag suffix. See Commons:File naming. For example, File:Gibraltar map-en.svg is the English version of File:Gibraltar map.svg.

For linking different versions of file one to another, use "other versions" templates like all in Category:Other versions templates. Copy one of them and use in your image.

Using the template creates a gallery of the different language versions:

• 
  català
• 
  Deutsch
• 
  English
• 
  English
• 
  English
• 
  español
• 
  français
• 
  italiano
• 
  magyar
• 
  Bahasa Melayu
• 
  polski
• 
  македонски
• 
  українська
• 
  עברית
• 
  اردو

Disputed isthmus and land

• 
  English
• 
  español
• 
  español
• 
  español (claimed isthmus)
• 
  español (non Utrech territories)
• 
  español (reclaimed land)
• 
  galego

Also the template {{Derived from}} will be useful to display link to original version of your localized image.

Language codes

SVG files use IETF language tags to specify languages. They are often referred to as BCP 47 language tags, but BCP 47 is the combination of IETF RFC 5646 and RFC 4647. The Wikimedia Foundation uses language identifiers that usually match IETF langtags, but there are some differences. For example, the IETF language tag als is for Tosk Albanian, but Wikimedia uses that tag for Alemannisch (which IETF represents as gsw). Simple English is simple in Wikimedia but en-simple in IETF. Please be aware of the distinction and use IETF language tags (not MediaWiki language identifiers) in SVG files.

Click here to show a list of all WikiMedia language codes supported:

List of languages supported on Wikimedia Commons.

Code	Language name (in English)	Native language name
bol	Bole	bòo pìkkà
bm	Bambara	bamanankan
id	Indonesian	Bahasa Indonesia
gsw	Alemannic	Alemannisch
abr	Abron	Abron
bas	Basaa	Basaa
dlg	Dolgan	долган тыла
bug	Buginese	Basa Ugi
sas	Sasak	Sasak
abs	Ambonese Malay	bahasa ambon
af	Afrikaans	Afrikaans
ppl	Nawat	Nawat
aae	Arbëresh	Arbërisht
als	Alemannic	Alemannisch
ms	Malay	Bahasa Melayu
bcl	Central Bikol	Bikol Central
ban	Balinese	Basa Bali
ast	Asturian	asturianu
ase	American Sign Language	American sign language
zh-min-nan	Minnan	Bân-lâm-gú
az	Azerbaijani	azərbaycanca
frp	Arpitan	arpetan
bax	Bamun	Bamum
nan-latn-pehoeji	Minnan (Pe̍h-ōe-jī)	Bân-lâm-gí (Pe̍h-ōe-jī)
rup	Aromanian	armãneashti
bbc-latn	Batak Toba (Latin script)	Batak Toba
roa-rup	Aromanian	armãneashti
bkc	Baka	Baka
atj	Atikamekw	Atikamekw
smn	Inari Sami	anarâškielâ
kaj	Jju	Jju
bkh	Bakoko	Bakoko
ace	Acehnese	Acèh
en-us	American English	American English
yua	Yucatec Maya	maaya t’aan
ang	Old English	Ænglisc
ksf	Bafia	Bafia
jv-java	Javanese (Javanese script)	ꦗꦮ
map-bms	Banyumasan	Basa Banyumasan
an	Aragonese	aragonés
sma	Southern Sami	åarjelsaemien
gor	Gorontalo	Bahasa Hulontalo
btm	Batak Mandailing	Batak Mandailing
gn	Guarani	Avañe'ẽ
mui	Musi	Baso Palembang
bfd	Bafut	Bafut
nan-latn-tailo	Minnan (Tâi-lô)	Bân-lâm-gí (Tâi-lô)
sje	Pite Sami	bidumsámegiella
ay	Aymara	Aymar aru
bjn	Banjar	Banjar
agq	Aghem	Aghem
bdr	West Coast Bajau	Bajau Sama
bew	Betawi	Betawi
aig	Antiguan and Barbudan Creole English	Aanteegan an' Baabyuudan
bbc	Batak Toba	Batak Toba
hoc-latn	Ho (Latin script)	Ho
ak	Akan	Akan
bi	Bislama	Bislama
bar	Bavarian	Boarisch
bs	Bosnian	bosanski
br	Breton	brezhoneg
brh	Brahui	Bráhuí
en-gb	British English	British English
en-ca	Canadian English	Canadian English
cps	Capiznon	Capiceño
cal	Carolinian	Carolinian
ca	Catalan	català
ceb	Cebuano	Cebuano
cs	Czech	čeština
cho	Choctaw	Chahta anumpa
ch	Chamorro	Chamoru
cbk-zam	Chavacano	Chavacano de Zamboanga
ny	Nyanja	Chi-Chewa
chn	Chinook Jargon	chinuk wawa
sn	Shona	chiShona
tum	Tumbuka	chiTumbuka
lua	Luba-Lulua	ciluba
sei	Seri	Cmique Itom
co	Corsican	corsu
cy	Welsh	Cymraeg
dga	Southern Dagaare	Dagaare
dag	Dagbani	dagbanli
da	Danish	dansk
se	Northern Sami	davvisámegiella
se-no	Northern Sami (Norway)	davvisámegiella (Norgga bealde)
se-se	Northern Sami (Sweden)	davvisámegiella (Ruoŧa bealde)
de	German	Deutsch
se-fi	Northern Sami (Finland)	davvisámegiella (Suoma bealde)
pdc	Pennsylvania German	Deitsch
de-formal	German (formal address)	Deutsch (Sie-Form)
nv	Navajo	Diné bizaad
dsb	Lower Sorbian	dolnoserbski
na	Nauru	Dorerin Naoero
dua	Duala	Duala
mh	Marshallese	Ebon
et	Estonian	eesti
efi	Efik	Efịk
etu	Ejagham	Ejagham
vmw	Makhuwa	emakhuwa
egl	Emilian	Emiliàn
eml	Emiliano-Romagnolo	emiliàn e rumagnòl
en	English	English
es	Spanish	español
es-formal	Spanish (formal address)	español (formal)
es-419	Latin American Spanish	español de América Latina
eo	Esperanto	Esperanto
eu	Basque	euskara
ext	Extremaduran	estremeñu
eto	Eton	Eton
ee	Ewe	eʋegbe
ewo	Ewondo	Ewondo
wls	Wallisian	Fakaʻuvea
gur	Frafra	farefare
fmp	Fe'Fe'	Fe'fe
hif	Fiji Hindi	Fiji Hindi
hif-latn	Fiji Hindi (Latin script)	Fiji Hindi
fon	Fon	fɔ̀ngbè
fr	French	français
fo	Faroese	føroyskt
frc	Cajun French	français cadien
fy	Western Frisian	Frysk
ff	Fula	Fulfulde
fur	Friulian	furlan
gaa	Ga	Ga
ga	Irish	Gaeilge
gv	Manx	Gaelg
sm	Samoan	Gagana Samoa
gag	Gagauz	Gagauz
gd	Scottish Gaelic	Gàidhlig
gl	Galician	galego
gya	Gbaya	Gbaya
aln	Gheg Albanian	Gegë
gpe	Ghanaian Pidgin	Ghanaian Pidgin
bbj	Ghomala	Ghomála
ki	Kikuyu	Gĩkũyũ
gom-latn	Goan Konkani (Latin script)	Gõychi Konknni
guw	Gun	gungbe
hak-latn	Hakka (Latin script)	Hak-kâ-ngî (Pha̍k-fa-sṳ)
cnh	Hakha-Chin	Hakha Chin
ha	Hausa	Hausa
haw	Hawaiian	Hawaiʻi
ho	Hiri Motu	Hiri Motu
hsb	Upper Sorbian	hornjoserbsce
io	Ido	Ido
hr	Croatian	hrvatski
hrx	Hunsrik	Hunsrik
ibb	Ibibio	ibibio
igl	Igala	Igala
ig	Igbo	Igbo
rw	Kinyarwanda	Ikinyarwanda
rn	Rundi	ikirundi
ilo	Iloko	Ilokano
hil	Hiligaynon	Ilonggo
ia	Interlingua	interlingua
ie	Interlingue	Interlingue
ike-latn	Eastern Canadian (Latin script)	inuktitut
ik	Inupiaq	Iñupiatun
bto	Rinconada Bikol	Iriga Bicolano
nr	South Ndebele	isiNdebele seSewula
xh	Xhosa	isiXhosa
zu	Zulu	isiZulu
is	Icelandic	íslenska
isu	Isu	Isu
it	Italian	italiano
iba	Iban	Jaku Iban
jv	Javanese	Jawa
smj	Lule Sami	julevsámegiella
jut	Jutish	jysk
rmf	Finnish Kalo	kaalengo tšimb
kbp	Kabiye	Kabɩyɛ
kea	Kabuverdianu	kabuverdianu
dtp	Central Dusun	Kadazandusun
kl	Kalaallisut	kalaallisut
pam	Pampanga	Kapampangan
kr	Kanuri	kanuri
cak	Kaqchikel	Kaqchikel
kai	Karekare	Karai-karai
krl	Karelian	karjal
csb	Kashubian	kaszëbsczi
ker	Kera	Kera
kw	Cornish	kernowek
hke	Hunde	kihunde
krj	Kinaray-a	Kinaray-a
kiu	Kirmanjki	Kırmancki
sw	Swahili	Kiswahili
bkm	Kom	Kom
kg	Kongo	Kongo
avk	Kotava	Kotava
nyo	Nyoro	Orunyoro
cpx-latn	Puxian (Latin script)	Pó-sing-gṳ̂ (Báⁿ-uā-ci̍)
ce	Chechen	нохчийн
be	Belarusian	беларуская
nds-nl	Low Saxon	Nedersaksies
nia	Nias	Li Niha
ne	Nepali	नेपाली
sjd	Kildin Sami	кӣллт са̄мь кӣлл
mi	Māori	Māori
rut	Rutul	мыхаӀбишды
frr	Northern Frisian	Nordfriisk
te	Telugu	తెలుగు
mwl	Mirandese	Mirandés
tg-cyrl	Tajik (Cyrillic script)	тоҷикӣ
pt-br	Brazilian Portuguese	português do Brasil
mnw	Mon	ဘာသာမန်
nl-informal	Dutch (informal address)	Nederlands (informeel)
ruq-cyrl	Megleno-Romanian (Cyrillic script)	Влахесте
tay	Atayal	Tayal
fit	Tornedalen Finnish	meänkieli
niu	Niuean	Niuē
vut	Vute	Vute
tt-latn	Tatar (Latin script)	tatarça
loz	Lozi	Silozi
shi	Tachelhit	Taclḥit
bqz	Mka'a	Mka'a
tt	Tatar	татарча / tatarça
gcr	Guianan Creole	kriyòl gwiyannen
cdo-latn	Mindong (Latin script)	Mìng-dĕ̤ng-ngṳ̄ (Bàng-uâ-cê)
sh-cyrl	Serbo-Croatian (Cyrillic script)	српскохрватски (ћирилица)
za	Zhuang	Vahcuengh
yrl	Nheengatu	Nhẽẽgatú
lbe	Lak	лакку
ks	Kashmiri	کٲشُر
sg	Sango	Sängö
os	Ossetic	ирон
st	Southern Sotho	Sesotho
ss	Swati	SiSwati
sty	Siberian Tatar	себертатар
ku-latn	Kurdish (Latin script)	kurdî (latînî)
kri	Krio	Krio
tg	Tajik	тоҷикӣ
wlx	Wali	waale
ojb	Northwestern Ojibwa	Ojibwemowin
de-at	Austrian German	Österreichisches Deutsch
mnc	Manchu	manju gisun
knc	Central Kanuri	Yerwa Kanuri
bat-smg	Samogitian	žemaitėška
mg	Malagasy	Malagasy
ng	Ndonga	Oshiwambo
lg	Ganda	Luganda
bg	Bulgarian	български
mr	Marathi	मराठी
bpy	Bishnupriya	বিষ্ণুপ্রিয়া মণিপুরী
nla	Ngombala	Ngombala
kk-latn	Kazakh (Latin script)	qazaqşa (latın)
pih	Pitcairn-Norfolk	Norfuk / Pitkern
sr	Serbian	српски / srpski
tru	Turoyo	Ṫuroyo
crh	Crimean Tatar	qırımtatarca
ady-cyrl	Adyghe (Cyrillic script)	адыгабзэ
ht	Haitian Creole	Kreyòl ayisyen
nit	Southeastern Kolami	కొలామి
sh-latn	Serbo-Croatian (Latin script)	srpskohrvatski (latinica)
cr	Cree	Nēhiyawēwin / ᓀᐦᐃᔭᐍᐏᐣ
tly	Talysh	tolışi
nds	Low German	Plattdüütsch
nnh	Ngiemboon	Ngiemboon
sq	Albanian	shqip
crh-latn	Crimean Tatar (Latin script)	qırımtatarca (Latin)
mai	Maithili	मैथिली
shy-latn	Shawiya (Latin script)	tacawit
sh	Serbo-Croatian	srpskohrvatski / српскохрватски
ku	Kurdish	kurdî
wes	Pidgin (Cameroon)	Pidgin (Cameroon)
nap	Neapolitan	Napulitano
be-tarask	Belarusian (Taraškievica orthography)	беларуская (тарашкевіца)
pwn	Paiwan	pinayuanan
vep	Veps	vepsän kel’
ses	Koyraboro Senni	Koyraboro Senni
kum	Kumyk	къумукъ
ts	Tsonga	Xitsonga
rmc	Carpathian Romani	romaňi čhib
nmz	Nawdm	nawdm
bh	Bhojpuri	भोजपुरी
fkv	Kvensk	kvääni
tg-latn	Tajik (Latin script)	tojikī
bo	Tibetan	བོད་ཡིག
nso	Northern Sotho	Sesotho sa Leboa
kk-kz	Kazakh (Kazakhstan)	қазақша (Қазақстан)
li	Limburgish	Limburgs
cop	Coptic	ϯⲙⲉⲧⲣⲉⲙⲛ̀ⲭⲏⲙⲓ
arn	Mapuche	mapudungun
hyw	Western Armenian	Արեւմտահայերէն
fi	Finnish	suomi
ro	Romanian	română
pnt	Pontic	Ποντιακά
to	Tongan	lea faka-Tonga
so	Somali	Soomaaliga
lzz	Laz	Lazuri
mo	Moldovan	молдовеняскэ
tpi	Tok Pisin	Tok Pisin
hi	Hindi	हिन्दी
si	Sinhala	සිංහල
lo	Lao	ລາວ
wya	Wyandot	Wyandot
gju-deva	Gujari (Devanagari script)	गुज्जरी
mcp	Maka	Maka
lld	Ladin	Ladin
pt	Portuguese	português
bn	Bangla	বাংলা
anp	Angika	अंगिका
qu	Quechua	Runa Simi
cu	Church Slavic	словѣньскъ / ⰔⰎⰑⰂⰡⰐⰠⰔⰍⰟ
ccp	Chakma	𑄌𑄋𑄴𑄟𑄳𑄦
koi	Komi-Permyak	перем коми
inh	Ingush	гӀалгӀай
kj	Kuanyama	Kwanyama
fj	Fijian	Na Vosa Vakaviti
tn	Tswana	Setswana
mn	Mongolian	монгол
pdt	Plautdietsch	Plautdietsch
thq	Kochila Tharu	काेचिला थारु
kn	Kannada	ಕನ್ನಡ
kjp	Eastern Pwo	ဖၠုံလိက်
byv	Medumba	Medumba
myv	Erzya	эрзянь
nmg	Kwasio	Kwasio
kk-tr	Kazakh (Turkey)	qazaqşa (Türkïya)
syl	Sylheti	ꠍꠤꠟꠐꠤ
mhr	Eastern Mari	олык марий
mk	Macedonian	македонски
mrh	Mara	Mara
gom-deva	Goan Konkani (Devanagari script)	गोंयची कोंकणी
qug	Chimborazo Highland Quichua	Runa shimi
mt	Maltese	Malti
mdf	Moksha	мокшень
gu	Gujarati	ગુજરાતી
tk	Turkmen	Türkmençe
hu	Hungarian	magyar
ksw	S'gaw Karen	စှီၤ
rm	Romansh	rumantsch
nrm	Norman	Nouormand
ady	Adyghe	адыгабзэ
om	Oromo	Oromoo
sk	Slovak	slovenčina
kcg	Tyap	Tyap
nod	Northern Thai	ᨣᩤᩴᨾᩮᩬᩥᨦ
km	Khmer	ភាសាខ្មែរ
hz	Herero	Otsiherero
no	Norwegian	norsk
acf	Saint Lucian Creole	Kwéyòl Sent Lisi
mni	Manipuri	ꯃꯤꯇꯩ ꯂꯣꯟ
kgg	Kusunda	गेम्येहाक़ गिपन
ty	Tahitian	reo tahiti
fiu-vro	Võro	võro
nog	Nogai	ногайша
nup	Nupe	Nupe
nov	Novial	Novial
crh-ro	Dobrujan Tatar	tatarşa
av	Avaric	авар
zea	Zeelandic	Zeêuws
szl	Silesian	ślůnski
dty	Doteli	डोटेली
yo	Yoruba	Yorùbá
bgc	Haryanvi	हरियाणवी
ybb	Yemba	Yemba
vo	Volapük	Volapük
yas	Nugunu	Nugunu
xsy	Saisiyat	saisiyat
new	Newari	नेपाल भाषा
sl	Slovenian	slovenščina
tl	Tagalog	Tagalog
xmf	Mingrelian	მარგალური
min	Minangkabau	Minangkabau
sah	Yakut	саха тыла
pl	Polish	polski
ml	Malayalam	മലയാളം
nl	Dutch	Nederlands
rgn	Romagnol	Rumagnôl
vot	Votic	Vaďďa
bfw	Bonda	ରେମସାମ୍
ami	Amis	Pangcah
isv-latn	Interslavic (Latin script)	medžuslovjansky
kab	Kabyle	Taqbaylit
el	Greek	Ελληνικά
nyn	Nyankole	runyankore
grc	Ancient Greek	Ἀρχαία ἑλληνικὴ
wo	Wolof	Wolof
gcf	Guadeloupean Creole	kréyòl Gwadloup
kbd	Kabardian	адыгэбзэ
war	Waray	Winaray
vro	Võro	võro
shn	Shan	တႆး
lez	Lezghian	лезги
zgh-latn	Standard Moroccan Tamazight (Latin script)	tamaziɣt tanawayt
vmf	Main-Franconian	Mainfränkisch
kaa	Kara-Kalpak	Qaraqalpaqsha
nge	Ngémba	Ngémba
kge	Komering	Kumoring
vi	Vietnamese	Tiếng Việt
vec	Venetian	vèneto
ve	Venda	Tshivenda
uz-latn	Uzbek (Latin script)	oʻzbekcha
uz-cyrl	Uzbek (Cyrillic script)	ўзбекча
tw	Twi	Twi
uk	Ukrainian	українська
ug-latn	Uyghur (Latin script)	Uyghurche
din	Dinka	Thuɔŋjäŋ
nys	Nyungar	Nyunga
udm	Udmurt	удмурт
tyv	Tuvinian	тыва дыл
mad	Madurese	Madhurâ
mos	Mossi	moore
uz	Uzbek	oʻzbekcha / ўзбекча
lad	Ladino	Ladino
tvu	Tunen	Tunen
jam	Jamaican Creole English	Patois
ttj	Tooro	Orutooro
bho	Bhojpuri	भोजपुरी
tt-cyrl	Tatar (Cyrillic script)	татарча
mrj	Western Mari	кырык мары
trv	Taroko	Seediq
tr	Turkish	Türkçe
shi-latn	Tachelhit (Latin script)	Taclḥit
tpv	Tanapag	Tanapag
tok	Toki Pona	toki pona
lt	Lithuanian	lietuvių
th	Thai	ไทย
dz	Dzongkha	ཇོང་ཁ
isv-cyrl	Interslavic (Cyrillic script)	меджусловјанскы
tcy	Tulu	ತುಳು
liv	Livonian	Līvõ kēļ
sco	Scots	Scots
awa	Awadhi	अवधी
kjh	Khakas	хакас
aeb-latn	Tunisian Arabic (Latin script)	Tûnsî
kk	Kazakh	қазақша
sv	Swedish	svenska
su	Sundanese	Sunda
chy	Cheyenne	Tsetsêhestâhese
srq	Sirionó	mbia cheë
kbd-cyrl	Kabardian (Cyrillic script)	адыгэбзэ
jbo	Lojban	la .lojban.
bxr	Russia Buriat	буряад
lns	Lamnso'	Lamnso
sro	Campidanese Sardinian	sardu campidanesu
srn	Sranan Tongo	Sranantongo
sr-el	Serbian (Latin script)	srpski (latinica)
sr-ec	Serbian (Cyrillic script)	српски (ћирилица)
ln	Lingala	lingála
my	Burmese	မြန်မာဘာသာ
lv	Latvian	latviešu
ky	Kyrgyz	кыргызча
tdd	Tai Nuea	ᥖᥭᥰ ᥖᥬᥲ ᥑᥨᥒᥰ
pcd	Picard	Picard
guc	Wayuu	wayuunaiki
pcm	Nigerian Pidgin	Naijá
lem	Nomaande	Nomaande
ruq	Megleno-Romanian	Vlăheşte
de-ch	Swiss High German	Schweizer Hochdeutsch
crh-cyrl	Crimean Tatar (Cyrillic script)	къырымтатарджа (Кирилл)
or	Odia	ଓଡ଼ିଆ
ann	Obolo	Obolo
hy	Armenian	հայերեն
nn	Norwegian Nynorsk	norsk nynorsk
nah	Nahuatl	Nāhuatl
olo	Livvi-Karelian	livvinkarjala
rki	Arakanese	ရခိုင်
tet	Tetum	tetun
kv	Komi	коми
stq	Saterland Frisian	Seeltersk
gld	Nanai	на̄ни
ksh	Colognian	Ripoarisch
szy	Sakizaya	Sakizaya
lij	Ligurian	Ligure
mag	Magahi	मगही
pag	Pangasinan	Pangasinan
simple	Simple English	Simple English
mnc-latn	Manchu (Latin script)	manju gisun
lfn	Lingua Franca Nova	Lingua Franca Nova
sms	Skolt Sami	nuõrttsääʹmǩiõll
mcn	Massa	vùn màsànà
as	Assamese	অসমীয়া
shy	Shawiya	tacawit
vls	West Flemish	West-Vlams
hu-formal	Hungarian (formal address)	magyar (formal)
pap	Papiamento	Papiamentu
kk-cyrl	Kazakh (Cyrillic script)	қазақша (кирил)
tly-cyrl	Talysh (Cyrillic script)	толыши
sgs	Samogitian	žemaitėška
scn	Sicilian	sicilianu
osa-latn	Osage (Latin script)	Wažáže íe
ta	Tamil	தமிழ்
pfl	Palatine German	Pälzisch
gom	Goan Konkani	गोंयची कोंकणी / Gõychi Konknni
ljp	Lampung Api	Lampung Api
sdc	Sassarese Sardinian	Sassaresu
wa	Walloon	walon
pa	Punjabi	ਪੰਜਾਬੀ
mua	Mundang	Mundang
ks-deva	Kashmiri (Devanagari script)	कॉशुर
sa	Sanskrit	संस्कृतम्
lmo	Lombard	lombard
diq	Dimli	Zazaki
ka	Georgian	ქართული
la	Latin	Latina
lus	Mizo	Mizo ţawng
be-x-old	Belarusian (Taraškievica orthography)	беларуская (тарашкевіца)
rue	Rusyn	русиньскый
mus	Muscogee	Mvskoke
fvr	Fur	poor’íŋ belé’ŋ
hoc	Ho	𑢹𑣉𑣉 𑣎𑣋𑣜
ruq-latn	Megleno-Romanian (Latin script)	Vlăheşte
kus	Kusaal	Kʋsaal
ru	Russian	русский
sju	Ume Sami	ubmejesámiengiälla
rsk	Pannonian Rusyn	руски
roa-tara	Tarantino	tarandíne
aa	Afar	Qafár af
ba	Bashkir	башҡортса
rmy	Vlax Romani	romani čhib
bag	Tuki	Tuki
fat	Fanti	mfantse
wal	Wolaytta	wolaytta
xal	Kalmyk	хальмг
nb	Norwegian Bokmål	norsk bokmål
lb	Luxembourgish	Lëtzebuergesch
yav	Yangben	Yangben
alt	Southern Altai	алтай тил
sli	Lower Silesian	Schläsch
rif	Riffian	Tarifit
cv	Chuvash	чӑвашла
ab	Abkhazian	аԥсшәа
quc	Kʼicheʼ	Qatzijob\ʼal
rwr	Marwari (India)	मारवाड़ी
blk	Pa'O	ပအိုဝ်ႏဘာႏသာႏ
bci	Baoulé	wawle
krc	Karachay-Balkar	къарачай-малкъар
pap-aw	Papiamento (Aruba)	Papiamento
prg	Prussian	prūsiskan
dso	Desiya	ଦେଶିଆ
pms	Piedmontese	Piemontèis
yat	Yambeta	Yambeta
pi	Pali	पालि
sc	Sardinian	sardu
oc	Occitan	occitan
nnz	Nda'Nda'	Nda'nda
ltg	Latgalian	latgaļu
bug-bugi	Buginese (Buginese script)	ᨅᨔ ᨕᨘᨁᨗ
ban-bali	Balinese (Balinese script)	ᬩᬲᬩᬮᬶ
sat	Santali	ᱥᱟᱱᱛᱟᱲᱤ
ike-cans	Eastern Canadian (Aboriginal syllabics)	ᐃᓄᒃᑎᑐᑦ
chr	Cherokee	ᏣᎳᎩ
iu	Inuktitut	ᐃᓄᒃᑎᑐᑦ / inuktitut
got	Gothic	𐌲𐌿𐍄𐌹𐍃𐌺
tzm	Central Atlas Tamazight	ⵜⴰⵎⴰⵣⵉⵖⵜ
tig	Tigre	ትግሬ
zgh	Standard Moroccan Tamazight	ⵜⴰⵎⴰⵣⵉⵖⵜ ⵜⴰⵏⴰⵡⴰⵢⵜ
shi-tfng	Tachelhit (Tifinagh script)	ⵜⴰⵛⵍⵃⵉⵜ
ti	Tigrinya	ትግርኛ
am	Amharic	አማርኛ
ii	Sichuan Yi	ꆇꉙ
ko-kp	Korean (North Korea)	조선말
ko	Korean	한국어
ja	Japanese	日本語
ryu	Okinawan	沖縄口
zh	Chinese	中文
zh-cn	Chinese (China)	中文（中国大陆）
zh-sg	Chinese (Singapore)	中文（新加坡）
zh-mo	Chinese (Macau)	中文（澳門）
zh-hans	Simplified Chinese	中文（简体）
zh-hant	Traditional Chinese	中文（繁體）
zh-tw	Chinese (Taiwan)	中文（臺灣）
zh-hk	Chinese (Hong Kong)	中文（香港）
zh-my	Chinese (Malaysia)	中文（马来西亚）
wuu-hant	Wu (Traditional Han script)	吳語（正體）
wuu	Wu	吴语
wuu-hans	Wu (Simplified Han script)	吴语（简体）
hak	Hakka Chinese	客家語 / Hak-kâ-ngî
hak-hant	Hakka (Traditional Han script)	客家語（繁體）
hak-hans	Hakka (Simplified Han script)	客家语（简体）
lzh	Literary Chinese	文言
zh-classical	Literary Chinese	文言
yue	Cantonese	粵語
hsn	Xiang	湘語
zh-yue	Cantonese	粵語
yue-hant	Cantonese (Traditional Han script)	粵語（繁體）
yue-hans	Cantonese (Simplified Han script)	粵语（简体）
cpx-hant	Puxian (Traditional Han script)	莆仙語（繁體）
cpx	Puxian	莆仙語 / Pó-sing-gṳ̂
cpx-hans	Puxian (Simplified Han script)	莆仙语（简体）
gan	Gan	贛語
gan-hant	Gan (Traditional Han script)	贛語（繁體）
nan-hani	Minnan (Han script)	閩南語
gan-hans	Gan (Simplified Han script)	赣语（简体）
nan	Minnan	閩南語 / Bân-lâm-gí
nan-hant	Minnan (Traditional Han script)	閩南語（傳統漢字）
cdo	Mindong	閩東語 / Mìng-dĕ̤ng-ngṳ̄
cdo-hant	Mindong (Traditional Han script)	閩東語（傳統漢字）
mnc-mong	Manchu (Mongolian script)	ᠮᠠᠨᠵᡠ ᡤᡳᠰᡠᠨ
yi	Yiddish	ייִדיש
he	Hebrew	עברית
ug-arab	Uyghur (Arabic script)	ئۇيغۇرچە
ug	Uyghur	ئۇيغۇرچە / Uyghurche
ur	Urdu	اردو
ary	Moroccan Arabic	الدارجة
ar	Arabic	العربية
bqi	Bakhtiari	بختیاری
ms-arab	Malay (Jawi script)	بهاس ملايو
ps	Pashto	پښتو
pnb	Western Punjabi	پنجابی
aeb-arab	Tunisian Arabic (Arabic script)	تونسي
aeb	Tunisian Arabic	تونسي / Tûnsî
azb	South Azerbaijani	تۆرکجه
arq	Algerian Arabic	جازايرية
bcc	Southern Balochi	جهلسری بلوچی
bgn	Western Balochi	روچ کپتین بلوچی
skr	Saraiki	سرائیکی
skr-arab	Saraiki (Arabic script)	سرائیکی
sd	Sindhi	سنڌي
apc	Levantine Arabic	شامي
acm	Iraqi Arabic	عراقي
fa	Persian	فارسی
kk-arab	Kazakh (Arabic script)	قازاقشا (تٴوتە)
kk-cn	Kazakh (China)	قازاقشا (جۇنگو)
ku-arab	Kurdish (Arabic script)	کوردی (عەرەبی)
ks-arab	Kashmiri (Arabic script)	کٲشُر
khw	Khowar	کھوار
ckb	Central Kurdish	کوردی
sdh	Southern Kurdish	کوردی خوارگ
gju-arab	Gujari (Arabic script)	گوجری
glk	Gilaki	گیلکی
ota	Ottoman Turkish	لسان عثمانى
lrc	Northern Luri	لۊری شومالی
luz	Southern Luri	لئری دوٙمینی
lki	Laki	لەکی
mzn	Mazanderani	مازِرونی
arz	Egyptian Arabic	مصرى
hno	Northern Hindko	ہندکو
nqo	N’Ko	ߒߞߏ
arc	Aramaic	ܐܪܡܝܐ
dv	Divehi	ދިވެހިބަސް

There are currently 538 supported languages (plus the language tag zxx denoting the absence of any linguistic content).

Note

SVG systemLanguage codes must be valid BCP 47 language tags (code differences).

Using numbers instead of labels

An example of an image with few labels.

On images with few labels, an alternative to either many translated files, or a multilingual SVG file, is to have only one file with numeric labels in it, and a table below, with different translations, and there is thus a single image that can be used for all languages. File:Robal.png or File:Insect anatomy diagram.svg is a good example.

If you think this image will be better with numbers instead of translated text, you can change {{Translate}} template to {{Convert to international}} or make numbers yourself.

For instance, File:ISS configuration sep-2006 en.svg has English labels, and a version with numeric labels File:ISS configuration sep-2006 numbers.svg was created by replacing the labels in the English version. But it's still not fully internationalized, because title and date are still written in the image in English.

Placing labels outside the image

Some images allow text to be placed around its periphery, as in the following example. Optionally add leading lines where appropriate. A table with explicit dimensions aids layout.

										Rankine (°Ra)
										Kelvin (K)
										Fahrenheit (°F)
										Celsius (°C) Réaumur (°Ré) Rømer (°Rø) Newton (°N)
										Delisle (°D)
	Absolute zero	Lowest recorded surface temperature on Earth	Fahrenheit's ice/water/salt mixture	Melting point of ice (at standard pressure)	Average surface temperature on Earth (15 °C)	Average human body temperature (37 °C)	Highest recorded surface temperature on Earth	Boiling point of water (at standard pressure)

Support this template

You don't have to translate this part; it should be enough if this information is here in English. Users who do not yet have a version in their language will find it here, I guess.

You can support this template by translating this help page into your language and saving it as a sub-page. The template consists of three parts. For example, for the German template they are:

• The template localization page Template:Translate/de
• The help page linked from the localized template Commons:Translation possible/Mehr erfahren
• The language links list templates Template:Translate/lang and Template:Commons:Translation possible/lang for both of them

The template page should contain the template itself and the quick info text translated from the English template.

The help page (this page) in your language should be saved under the subject that you would use in your language, like "Learn more" (which I selected for English).

The language link template is the same for every version of this template. It contains all the links to existing language versions. Please add your language there and there, if you have created a new translation.

Thank you for your support!

See also

• German tutorial
• The 'switch' element W3C
• The 'systemLanguage' attribute W3C
• Example files using <switch> element
• (DEAD LINK) SVG Processing: Efficient Language Translation by Bryan Schnabel, 2009 (Multiple file (XLIFF) rather than switch element approach.)
• Category:Language-neutral