Contribute translations: Difference between revisions
m (New translation) |
|||
| Line 2: | Line 2: | ||
{{Languages}} | {{Languages}} | ||
== | == Tools used to translate == | ||
=== WebTranslateIt === | === WebTranslateIt === | ||
| Line 11: | Line 11: | ||
[[Image:WTI_Translate.png|thumb|Start translating!]] | [[Image:WTI_Translate.png|thumb|Start translating!]] | ||
We use [https://webtranslateit.com WebTranslateIt] to manage translation. | |||
There are two projects for Diaspora on WebTranslateIt. | |||
* [https://webtranslateit.com/en/projects/3020-Diaspora diaspora/Diaspora] | * [https://webtranslateit.com/en/projects/3020-Diaspora diaspora/Diaspora] for translating the software. | ||
* [https://webtranslateit.com/en/projects/7017-Website diaspora/Website] | * [https://webtranslateit.com/en/projects/7017-Website diaspora/Website] for translating diasporafoundation.org. | ||
If you want to contribute to translation, you need to register to WebTranslateIt. | |||
# | # First go to [https://webtranslateit.com/en/sign_up WebTranslateIt] and create/sign-in to your account. | ||
# | # Then go to [https://webtranslateit.com/en/projects/3020-Diaspora the project site for Diaspora], [https://webtranslateit.com/en/projects/10365-JSXC JSXC (Chat frontend)] and/or [https://webtranslateit.com/en/projects/7017-Website the project site for diasporafoundation.org] 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. 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. | ||
=== Github === | === Github === | ||
Some languages are not handled inside WebTranslateIt. You will need to use Github and open a pull request to contribute to those. | |||
==== diaspora/diaspora ==== | ==== diaspora/diaspora ==== | ||
* es-VE: [https://github.com/ruby-ve | * es-VE: [https://github.com/ruby-ve team] | ||
* gl: [http://trasno.net/ | * gl: [http://trasno.net/ team] | ||
* sq: [https://github.com/ujdhesa | * sq: [https://github.com/ujdhesa maintainer] | ||
==== diaspora/diaspora-project-site ==== | ==== diaspora/diaspora-project-site ==== | ||
| Line 44: | Line 44: | ||
Complete me! | Complete me! | ||
== | == I want to add a new language to diaspora*! == | ||
First look if you could find an existing translation. | |||
If you have to create a new one inform [https://webtranslateit.com/en/projects/3020-diaspora/people a project manager] so that they create the new language for you. As soon as the new language was created you can start translating. | If you have to create a new one inform [https://webtranslateit.com/en/projects/3020-diaspora/people a project manager] so that they create the new language for you. As soon as the new language was created you can start translating. | ||
== | == General notes == | ||
=== | === Languages with high inflection and grammar different to English === | ||
We integrated the awesome extensions [https://github.com/siefca siefca] made for Rails and the [https://github.com/svenfuchs/i18n i18n gem]: [https://github.com/siefca/i18n-inflector i18n-inflector] and [https://github.com/siefca/i18n-inflector-rails i18n-inflector-rails]. Based on what the user has written into the gender field and our [https://github.com/diaspora/diaspora/tree/master/config/locales/inflections definitions] the gender is guessed. Look at the readme of i18n-inflector for more documentation on how to use them. You can use the named patterns easily via [https://webtranslateit.com WebTranslateIt] if you want to do so. However if you want to contribute a definition please make a [[Git Workflow|pull request]]. | We integrated the awesome extensions [https://github.com/siefca siefca] made for Rails and the [https://github.com/svenfuchs/i18n i18n gem]: [https://github.com/siefca/i18n-inflector i18n-inflector] and [https://github.com/siefca/i18n-inflector-rails i18n-inflector-rails]. Based on what the user has written into the gender field and our [https://github.com/diaspora/diaspora/tree/master/config/locales/inflections definitions] the gender is guessed. Look at the readme of i18n-inflector for more documentation on how to use them. You can use the named patterns easily via [https://webtranslateit.com WebTranslateIt] if you want to do so. However if you want to contribute a definition please make a [[Git Workflow|pull request]]. | ||
=== | === Hardcoded string === | ||
There is probably some missing strings which are still untranslatable in diaspora*. If you want to fix those feel free, but only add the new key to <tt>en.yml</tt>/<tt>devise.en.yml</tt>/<tt>javascript.en.yml</tt>. | There is probably some missing strings which are still untranslatable in diaspora*. If you want to fix those feel free, but only add the new key to <tt>en.yml</tt>/<tt>devise.en.yml</tt>/<tt>javascript.en.yml</tt>. Or you can simply [https://github.com/diaspora/diaspora/issues/new create an issue on GitHub]. | ||
== | == Translating the wiki == | ||
If you want to translate a page in the wiki make sure to include [[Template:Languages]] at '''the top'''. Then click on the red link for your language and start translating. If your language isn't yet in the template, feel free to add it. | |||
For more discussion around translating the wiki please have a look at [https://discourse.diasporafoundation.org/t/translating-the-wiki/228 this Discourse discussion]. | |||
Thank you for contributing! | |||
[[Category:Technical]] | [[Category:Technical]] | ||
Revision as of 18:11, 3 February 2018
Tools used to translate
WebTranslateIt
We use WebTranslateIt to manage translation.
There are two projects for Diaspora on WebTranslateIt.
- diaspora/Diaspora for translating the software.
- diaspora/Website for translating diasporafoundation.org.
If you want to contribute to translation, you need to register to WebTranslateIt.
- First go to WebTranslateIt and create/sign-in to your account.
- Then go to the project site for Diaspora, JSXC (Chat frontend) and/or the project site for diasporafoundation.org 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. 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.
Github
Some languages are not handled inside WebTranslateIt. You will need to use Github and open a pull request to contribute to those.
diaspora/diaspora
- es-VE: team
- gl: team
- sq: maintainer
diaspora/diaspora-project-site
Complete me!
diaspora/jsxc
Complete me!
I want to add a new language to diaspora*!
First look if you could find an existing translation.
If you have to create a new one inform a project manager so that they create the new language for you. As soon as the new language was created you can start translating.
General notes
Languages with high inflection and grammar different to English
We integrated the awesome extensions siefca made for Rails and the i18n gem: 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 on how to use them. You can use the named patterns easily via WebTranslateIt if you want to do so. However if you want to contribute a definition please make a pull request.
Hardcoded string
There is probably some missing strings which are still untranslatable in diaspora*. If you want to fix those feel free, but only add the new key to en.yml/devise.en.yml/javascript.en.yml. Or you can simply create an issue on GitHub.
Translating the wiki
If you want to translate a page in the wiki make sure to include Template:Languages at the top. Then click on the red link for your language and start translating. If your language isn't yet in the template, feel free to add it.
For more discussion around translating the wiki please have a look at this Discourse discussion.
Thank you for contributing!