How to translate an SVG file[edit]

Further information: Help:Translation tutorial

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.

Using numbers instead of labels[edit]

On images with few labels, an alternative 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 can be used for all languages. Image:Robal.png 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, Image:ISS configuration sep-2006 en.svg has English labels, and a version with numeric labels Image: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.

What is SVG?[edit]

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 do I edit SVGs?[edit]

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

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[edit]

Note that instead of using a graphics editor, you can use any text editor capable of using UTF-8. 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.

How to place new language version in Commons[edit]

When creating SVG files for multiple language versions, it would be good, by Commons:File naming, to save them with language-specific name. To avoid a naming conflict with other languages, you can put the language suffix (such as -en for English) just before .svg file extension. For example, Image:Gibraltar map-en.svg is the English version of "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.

It would look like this:

[edit]

German
English
Spanish
French
Hebrew
Italian
Hungarian
Macedonian
Malay
Polish
Ukrainian
Urdu

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

Multiple translations within one SVG file [edit]

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

You can place multiple translations into one SVG file using the SVG <switch> element.

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. 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.

<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 SVG editors support language switches in SVG, so you will probably have to edit the SVG file with a text editor. Loading an SVG file with switch translations into a graphical editor and then saving it may remove all the translations.

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)".

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 render the SVG in the language "en".

Note: If a file has an English text and a default text specified, the default display on the file page is not the default text but the English text!

Language codes[edit]

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

aa Afar Qafár af
ab Abkhazian Аҧсшәа
abs Ambonese Malay bahasa ambon
ace Achinese Acèh
ady Adyghe адыгабзэ
ady-cyrl Adyghe (Cyrillic script) адыгабзэ
aeb Tunisian Arabic تونسي/Tûnsî
aeb-arab Tunisian Arabic (Arabic script) تونسي
aeb-latn Tunisian Arabic (Latin script) Tûnsî
af Afrikaans Afrikaans
ak Akan Akan
aln Gheg Albanian Gegë
als Alemannisch Alemannisch
am Amharic አማርኛ
an Aragonese aragonés
ang Old English Ænglisc
anp Angika अङ्गिका
ar Arabic العربية
arc Aramaic ܐܪܡܝܐ
arn Mapuche mapudungun
arq Algerian Arabic جازايرية
ary Moroccan Arabic Maġribi
arz Egyptian Arabic مصرى
as Assamese অসমীয়া
ase American Sign Language American sign language
ast Asturian asturianu
atj Atikamekw Atikamekw
av Avaric авар
avk Kotava Kotava
awa Awadhi अवधी
ay Aymara Aymar aru
az Azerbaijani azərbaycanca
azb South Azerbaijani تۆرکجه
ba Bashkir башҡортса
ban Balinese Basa Bali
bar Bavarian Boarisch
bat-smg Samogitian žemaitėška
bbc Batak Toba Batak Toba
bbc-latn Batak Toba (Latin script) Batak Toba
bcc Southern Balochi جهلسری بلوچی
bcl Central Bikol Bikol Central
be Belarusian беларуская
be-tarask Belarusian (Taraškievica orthography) беларуская (тарашкевіца)‎
be-x-old Belarusian (Taraškievica orthography) беларуская (тарашкевіца)‎
bg Bulgarian български
bgn Western Balochi روچ کپتین بلوچی
bh Bhojpuri भोजपुरी
bho Bhojpuri भोजपुरी
bi Bislama Bislama
bjn Banjar Bahasa Banjar
bm Bambara bamanankan
bn Bangla বাংলা
bo Tibetan བོད་ཡིག
bpy Bishnupriya বিষ্ণুপ্রিয়া মণিপুরী
bqi Bakhtiari بختیاری
br Breton brezhoneg
brh Brahui Bráhuí
bs Bosnian bosanski
btm Batak Mandailing Batak Mandailing
bto Iriga Bicolano Iriga Bicolano
bug Buginese ᨅᨔ ᨕᨘᨁᨗ
bxr Russia Buriat буряад
ca Catalan català
cbk-zam Chavacano Chavacano de Zamboanga
cdo Min Dong Chinese Mìng-dĕ̤ng-ngṳ̄
ce Chechen нохчийн
ceb Cebuano Cebuano
ch Chamorro Chamoru
cho Choctaw Choctaw
chr Cherokee ᏣᎳᎩ
chy Cheyenne Tsetsêhestâhese
ckb Central Kurdish کوردی
co Corsican corsu
cps Capiznon Capiceño
cr Cree Nēhiyawēwin / ᓀᐦᐃᔭᐍᐏᐣ
crh Crimean Turkish qırımtatarca
crh-cyrl Crimean Tatar (Cyrillic script) къырымтатарджа (Кирилл)‎
crh-latn Crimean Tatar (Latin script) qırımtatarca (Latin)‎
cs Czech čeština
csb Kashubian kaszëbsczi
cu Church Slavic словѣньскъ / ⰔⰎⰑⰂⰡⰐⰠⰔⰍⰟ
cv Chuvash Чӑвашла
cy Welsh Cymraeg
da Danish dansk
de German Deutsch
de-at Austrian German Österreichisches Deutsch
de-ch Swiss High German Schweizer Hochdeutsch
de-formal German (formal address) Deutsch (Sie-Form)‎
din Dinka Thuɔŋjäŋ
diq Zazaki Zazaki
dsb Lower Sorbian dolnoserbski
dtp Central Dusun Dusun Bundu-liwan
dty Doteli डोटेली
dv Divehi ދިވެހިބަސް
dz Dzongkha ཇོང་ཁ
ee Ewe eʋegbe
egl Emilian Emiliàn
el Greek Ελληνικά
eml Emiliano-Romagnolo emiliàn e rumagnòl
en English English
en-ca Canadian English Canadian English
en-gb British English British English
eo Esperanto Esperanto
es Spanish español
es-419 Latin American Spanish español de América Latina
es-formal español (formal)‎ español (formal)‎
et Estonian eesti
eu Basque euskara
ext Extremaduran estremeñu
fa Persian فارسی
ff Fulah Fulfulde
fi Finnish suomi
fit Tornedalen Finnish meänkieli
fiu-vro Võro Võro
fj Fijian Na Vosa Vakaviti
fo Faroese føroyskt
fr French français
frc Cajun French français cadien
frp Arpitan arpetan
frr Northern Frisian Nordfriisk
fur Friulian furlan
fy Western Frisian Frysk
ga Irish Gaeilge
gag Gagauz Gagauz
gan Gan Chinese 贛語
gan-hans Gan (Simplified) 赣语（简体）‎
gan-hant Gan (Traditional) 贛語（繁體）‎
gcr kréyòl gwiyanè kréyòl gwiyanè
gd Scottish Gaelic Gàidhlig
gl Galician galego
glk Gilaki گیلکی
gn Guarani Avañe'ẽ
gom Goan Konkani गोंयची कोंकणी / Gõychi Konknni
gom-deva Goan Konkani (Devanagari script) गोंयची कोंकणी
gom-latn Goan Konkani (Latin script) Gõychi Konknni
gor Gorontalo Bahasa Hulontalo
got Gothic 𐌲𐌿𐍄𐌹𐍃𐌺
grc Ancient Greek Ἀρχαία ἑλληνικὴ
gsw Swiss German Alemannisch
gu Gujarati ગુજરાતી
gv Manx Gaelg
ha Hausa Hausa
hak Hakka Chinese 客家語/Hak-kâ-ngî
haw Hawaiian Hawaiʻi
he Hebrew עברית
hi Hindi हिन्दी
hif Fiji Hindi Fiji Hindi
hif-latn Fiji Hindi (Latin script) Fiji Hindi
hil Hiligaynon Ilonggo
ho Hiri Motu Hiri Motu
hr Croatian hrvatski
hrx Hunsrik Hunsrik
hsb Upper Sorbian hornjoserbsce
ht Haitian Creole Kreyòl ayisyen
hu Hungarian magyar
hu-formal magyar (formal)‎ magyar (formal)‎
hy Armenian Հայերեն
hyw արեւմտահայերէն արեւմտահայերէն
hz Herero Otsiherero
ia Interlingua interlingua
id Indonesian Bahasa Indonesia
ie Interlingue Interlingue
ig Igbo Igbo
ii Sichuan Yi ꆇꉙ
ik Inupiaq Iñupiak
ike-cans Eastern Canadian (Aboriginal syllabics) ᐃᓄᒃᑎᑐᑦ
ike-latn Eastern Canadian (Latin script) inuktitut
ilo Iloko Ilokano
inh Ingush ГӀалгӀай
io Ido Ido
is Icelandic íslenska
it Italian italiano
iu Inuktitut ᐃᓄᒃᑎᑐᑦ/inuktitut
ja Japanese 日本語
jam Jamaican Creole English Patois
jbo Lojban la .lojban.
jut Jutish jysk
jv Javanese Basa Jawa
ka Georgian ქართული
kaa Kara-Kalpak Qaraqalpaqsha
kab Kabyle Taqbaylit
kbd Kabardian Адыгэбзэ
kbd-cyrl Kabardian (Cyrillic script) Адыгэбзэ
kbp Kabiye Kabɩyɛ
kg Kongo Kongo
khw Khowar کھوار
ki Kikuyu Gĩkũyũ
kiu Kirmanjki Kırmancki
kj Kuanyama Kwanyama
kk Kazakh қазақша
kk-arab Kazakh (Arabic script) قازاقشا (تٴوتە)‏
kk-cn Kazakh (China) قازاقشا (جۇنگو)‏
kk-cyrl Kazakh (Cyrillic script) қазақша (кирил)‎
kk-kz Kazakh (Kazakhstan) қазақша (Қазақстан)‎
kk-latn Kazakh (Latin script) qazaqşa (latın)‎
kk-tr Kazakh (Turkey) qazaqşa (Türkïya)‎
kl Kalaallisut kalaallisut
km Khmer ភាសាខ្មែរ
kn Kannada ಕನ್ನಡ
ko Korean 한국어
ko-kp Korean (North Korea) 조선말
koi Komi-Permyak Перем Коми
kr Kanuri Kanuri
krc Karachay-Balkar къарачай-малкъар
kri Krio Krio
krj Kinaray-a Kinaray-a
krl Karelian karjal
ks Kashmiri कॉशुर / کٲشُر
ks-arab Kashmiri (Arabic script) کٲشُر
ks-deva Kashmiri (Devanagari script) कॉशुर
ksh Colognian Ripoarisch
ku Kurdish kurdî
ku-arab Kurdish (Arabic script) كوردي (عەرەبی)‏
ku-latn Kurdish (Latin script) kurdî (latînî)‎
kum Kumyk къумукъ
kv Komi коми
kw Cornish kernowek
ky Kyrgyz Кыргызча
la Latin Latina
lad Ladino Ladino
lb Luxembourgish Lëtzebuergesch
lbe Lak лакку
lez Lezghian лезги
lfn Lingua Franca Nova Lingua Franca Nova
lg Ganda Luganda
li Limburgish Limburgs
lij Ligurian Ligure
liv Livonian Līvõ kēļ
lki Laki لەکی
lmo Lombard lumbaart
ln Lingala lingála
lo Lao ລາວ
loz Lozi Silozi
lrc Northern Luri لۊری شومالی
lt Lithuanian lietuvių
ltg Latgalian latgaļu
lus Mizo Mizo ţawng
luz Southern Luri لئری دوٙمینی
lv Latvian latviešu
lzh Literary Chinese 文言
lzz Laz Lazuri
mai Maithili मैथिली
map-bms Basa Banyumasan Basa Banyumasan
mdf Moksha мокшень
mg Malagasy Malagasy
mh Marshallese Ebon
mhr Eastern Mari олык марий
mi Maori Māori
min Minangkabau Baso Minangkabau
mk Macedonian македонски
ml Malayalam മലയാളം
mn Mongolian монгол
mni Manipuri মেইতেই লোন্
mo Moldovan молдовеняскэ
mr Marathi मराठी
mrj Western Mari кырык мары
ms Malay Bahasa Melayu
mt Maltese Malti
mus Creek Mvskoke
mwl Mirandese Mirandés
my Burmese မြန်မာဘာသာ
myv Erzya эрзянь
mzn Mazanderani مازِرونی
na Nauru Dorerin Naoero
nah Nāhuatl Nāhuatl
nan Min Nan Chinese Bân-lâm-gú
nap Neapolitan Napulitano
nb Norwegian Bokmål norsk bokmål
nds Low German Plattdüütsch
nds-nl Low Saxon Nedersaksies
ne Nepali नेपाली
new Newari नेपाल भाषा
ng Ndonga Oshiwambo
niu Niuean Niuē
nl Dutch Nederlands
nl-informal Nederlands (informeel)‎ Nederlands (informeel)‎
nn Norwegian Nynorsk norsk nynorsk
no Norwegian norsk
nov Novial Novial
nrm Norman Nouormand
nso Northern Sotho Sesotho sa Leboa
nv Navajo Diné bizaad
ny Nyanja Chi-Chewa
nys Nyunga Nyunga
oc Occitan occitan
olo Livvi-Karelian Livvinkarjala
om Oromo Oromoo
or Odia ଓଡ଼ିଆ
os Ossetic Ирон
pa Punjabi ਪੰਜਾਬੀ
pag Pangasinan Pangasinan
pam Pampanga Kapampangan
pap Papiamento Papiamentu
pcd Picard Picard
pdc Pennsylvania German Deitsch
pdt Plautdietsch Plautdietsch
pfl Palatine German Pälzisch
pi Pali पालि
pih Norfuk / Pitkern Norfuk / Pitkern
pl Polish polski
pms Piedmontese Piemontèis
pnb Western Punjabi پنجابی
pnt Pontic Ποντιακά
prg Prussian Prūsiskan
ps Pashto پښتو
pt Portuguese português
pt-br Brazilian Portuguese português do Brasil
qu Quechua Runa Simi
qug Chimborazo Highland Quichua Runa shimi
rgn Romagnol Rumagnôl
rif Riffian Tarifit
rm Romansh rumantsch
rmy Romani Romani
rn Rundi Kirundi
ro Romanian română
roa-rup Aromanian armãneashti
roa-tara Tarantino tarandíne
ru Russian русский
rue Rusyn русиньскый
rup Aromanian armãneashti
ruq Megleno-Romanian Vlăheşte
ruq-cyrl Megleno-Romanian (Cyrillic script) Влахесте
ruq-latn Megleno-Romanian (Latin script) Vlăheşte
rw Kinyarwanda Kinyarwanda
sa Sanskrit संस्कृतम्
sah Sakha саха тыла
sat Santali ᱥᱟᱱᱛᱟᱲᱤ
sc Sardinian sardu
scn Sicilian sicilianu
sco Scots Scots
sd Sindhi سنڌي
sdc Sassarese Sardinian Sassaresu
sdh Southern Kurdish کوردی خوارگ
se Northern Sami davvisámegiella
sei Seri Cmique Itom
ses Koyraboro Senni Koyraboro Senni
sg Sango Sängö
sgs Samogitian žemaitėška
sh Serbo-Croatian srpskohrvatski / српскохрватски
shi Tachelhit Tašlḥiyt/ⵜⴰⵛⵍⵃⵉⵜ
shi-latn Tachelhit (Latin script) Tašlḥiyt
shi-tfng Tachelhit (Tifinagh script) ⵜⴰⵛⵍⵃⵉⵜ
shn Shan ၽႃႇသႃႇတႆး
shy-latn Shawiya (Latin script) tachawit
si Sinhala සිංහල
simple Simple English Simple English
sk Slovak slovenčina
skr Saraiki سرائیکی
skr-arab Saraiki (Arabic script) سرائیکی
sl Slovenian slovenščina
sli Lower Silesian Schläsch
sm Samoan Gagana Samoa
sma Southern Sami Åarjelsaemien
sn Shona chiShona
so Somali Soomaaliga
sq Albanian shqip
sr Serbian српски / srpski
sr-ec Serbian (Cyrillic script) српски (ћирилица)‎
sr-el Serbian (Latin script) srpski (latinica)‎
srn Sranan Tongo Sranantongo
ss Swati SiSwati
st Southern Sotho Sesotho
stq Saterland Frisian Seeltersk
sty cебертатар cебертатар
su Sundanese Basa Sunda
sv Swedish svenska
sw Swahili Kiswahili
szl Silesian ślůnski
ta Tamil தமிழ்
tay Tayal Tayal
tcy Tulu ತುಳು
te Telugu తెలుగు
tet Tetum tetun
tg Tajik тоҷикӣ
tg-cyrl Tajik (Cyrillic script) тоҷикӣ
tg-latn Tajik (Latin script) tojikī
th Thai ไทย
ti Tigrinya ትግርኛ
tk Turkmen Türkmençe
tl Tagalog Tagalog
tly Talysh толышә зывон
tn Tswana Setswana
to Tongan lea faka-Tonga
tpi Tok Pisin Tok Pisin
tr Turkish Türkçe
tru Turoyo Ṫuroyo
ts Tsonga Xitsonga
tt Tatar татарча/tatarça
tt-cyrl Tatar (Cyrillic script) татарча
tt-latn Tatar (Latin script) tatarça
tum Tumbuka chiTumbuka
tw Twi Twi
ty Tahitian reo tahiti
tyv Tuvinian тыва дыл
tzm Central Atlas Tamazight ⵜⴰⵎⴰⵣⵉⵖⵜ
udm Udmurt удмурт
ug Uyghur ئۇيغۇرچە / Uyghurche
ug-arab Uyghur (Arabic script) ئۇيغۇرچە
ug-latn Uyghur (Latin script) Uyghurche
uk Ukrainian українська
ur Urdu اردو
uz Uzbek oʻzbekcha/ўзбекча
uz-cyrl Uzbek (Cyrillic script) ўзбекча
uz-latn Uzbek (Latin script) oʻzbekcha
ve Venda Tshivenda
vec Venetian vèneto
vep Veps vepsän kel’
vi Vietnamese Tiếng Việt
vls West Flemish West-Vlams
vmf Main-Franconian Mainfränkisch
vo Volapük Volapük
vot Votic Vaďďa
vro Võro Võro
wa Walloon walon
war Waray Winaray
wo Wolof Wolof
wuu Wu Chinese 吴语
xal Kalmyk хальмг
xh Xhosa isiXhosa
xmf Mingrelian მარგალური
yi Yiddish ייִדיש
yo Yoruba Yorùbá
yue Cantonese 粵語
za Zhuang Vahcuengh
zea Zeelandic Zeêuws
zgh Standard Moroccan Tamazight ⵜⴰⵎⴰⵣⵉⵖⵜ ⵜⴰⵏⴰⵡⴰⵢⵜ
zh Chinese 中文
zh-classical Classical Chinese 文言
zh-cn Chinese (China) 中文（中国大陆）‎
zh-hans Simplified Chinese 中文（简体）‎
zh-hant Traditional Chinese 中文（繁體）‎
zh-hk Chinese (Hong Kong) 中文（香港）‎
zh-min-nan Chinese (Min Nan) Bân-lâm-gú
zh-mo Chinese (Macau) 中文（澳門）‎
zh-my Chinese (Malaysia) 中文（马来西亚）‎
zh-sg Chinese (Singapore) 中文（新加坡）‎
zh-tw Chinese (Taiwan) 中文（台灣）‎
zh-yue Cantonese 粵語
zu Zulu isiZulu

Support this template[edit]

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!

Commons:Translation possible/Learn more

Contents

How to translate an SVG file[edit]

Using numbers instead of labels[edit]

What is SVG?[edit]

How do I edit SVGs?[edit]

Text editing[edit]

How to place new language version in Commons[edit]

Multiple translations within one SVG file [edit]

See also[edit]

Language codes[edit]

Support this template[edit]

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigate

Participate

Print/export

Tools

In Wikipedia