How to contribute translations
There are two ways you can contribute a translation: with a pull request or at Web translate it. But lets start with some....
We integrated the awesome extensions @siefca made for the i18n Gem and for Rails: i18n-inflector and i18n-inflector-rails. Based on what the user has written into the gender field and our definitions the gender is guessed. Look at the readme of i18n-inflector for more documentation and how to use them. You can use the named patterns easily via Web translate it if you want to do so. However if you want to contribute a definition please make a pull request.
First look if you could find an existing translation.
If you have to create a new one look here and check for which code is used there for your language.
If your language isn't available there choose the right code according to ISO 639-1 (or ISO 639-2/3 if your language has no ISO 639-1 code) in lowercase letters. If you want to create a country-specific one, that is not the most spoken type of it, append - and your country code according to ISO 3166-1 in uppercase letters.
Examples:
-
defor German -
de-ATfor German specific to Austria
If you want to create formal or informal versions of your translation append _informal or _formal to the version that is less common for social networks.
Examples:
-
frfor the French formal one and -
fr_informalfor the informal one
Note: If you want to take the responsibility for your language then it's completely fine, however using both methods at a time is too much work, so please provide constant updates if you want to do it this way. Do keep in mind that you have to watch for changes yourself, there's no automatism that updates everything in this way. Also be sure that you are the person to be contacted about it in your local community and add a way to contact you/contribute to the translation to the Languages handled outside of Web translate it section below.
First read and follow Contributing to Diaspora: Using git.
- config/locales/devise/devise.< code >.yml
- config/locales/diaspora/< code >.yml
- config/locales/javascript/javascript.< code >.yml
- Only add something to config/locales/inflections/< code >.yml if you know what you're doing, look at the note about inflected languages above for more informations. If you're unsure just ignore that directory.
- config/locales/cldr/ is an upstream resource too. You shouldn't need to touch it.
If you want to create a new translation copy the en files, choose the correct language code (see above) and change every occurrence of en with your code. Don't forget the root element in the files!
If you want to fix an untranslatable strings or something feel free, but only add the new key to en.yml/devise.en.yml/javascript.en.yml.
If you want to give constant updates you can also notify me (@MrZYX, IRC: MrZYX, E-Mail: me@mrzyx.de) and give me the URL to a Git Repository and I'll do regular pulls in my update workflow.
First go to Web translate it and create/sign-in to your account.
Then go to diaspora's project site and join the team.
Choose your language or suggest a new one and request an invitation.
You'll receive an email containing a link to accept your invitation. Note that this can take one or two days since I have to manually approve your request ;) Once you have gotten the mail and clicked on the link you'll see something like this:
After you accepted it you can click on the "Translations" tab and start translating:
Thank you for contributing!