Translating Greasy Fork
Greasy Fork lets user choose the language they want to browse the site in. The translations are provided by the community. This guide shows you how to contribute translations to Greasy Fork using the Transifex translation editor.
Note that the translations are for the Greasy Fork site itself and not for the individual scripts on the site. Translations of script content can only be done by the script's author.
To help translate Greasy Fork, you need to create an account on Transifex. Visit the registration page and follow the steps there to register.
The below text needs a bit of an update but still contains useful info. For complimentary info, Transifex's own user intro is a good starting point. Getting Started as a Translator
After registering, you can join the Greasy Fork project from its project page. To receive email updates, for example when a file has changed, click the eye-icon (Watch project) in the header.
The next step depends on whether the language you want to translate to has already been set up.
Click View resource button of the language you want to translate to see the language information page. To be able to translate a language, you must be part of the team for that language. Click on tree-dots, then in dropdown menu click Join team in the upper right corner of the table with the translation files and click Join.
Your request must be confirmed by a team coordinator before you can start translating.
Click Languages, click Request language, then select your language. When selecting for a language, keep in mind that all language names are in English and searching for language codes like en doesn't work. After selecting a language, click Request and wait for a team manager to confirm your request. Once you are confirmed, you can start translating.
A short introduction on the translator can be found in the Transifex Help Center.
The glossary of the project is for phrases or words that have different translations in a language. Add those words to the glossary to keep the translation on Greasy Fork consistent. All words with a glossary entry are highlighted in the original language and the translation is provided to you.
Translations should be made live on Greasy Fork within a few days. New translations must reach a minimum level before being put live. If your changes aren't being made live, file a GitHub issue or e-mail jason.barnabe@gmail.com.
Greasy Fork uses libraries for certain things that have their own translation projects. You may wish to contribute to these projects as well, if translations are missing in them:
- rails-i18n - general translations for the framework Greasy Fork runs on
- devise-i18n - translations for things dealing with users (login, registration, etc.)
- will-paginate-i18n - translations for pagination (1/2/3/next/previous links)
Transifex doesn't let you create a join request for more than one team. If you want to translate more than one language, file a GitHub issue or contact jason.barnabe@gmail.com with your request.
An overview on the roles and their permissions can be found in the Transifex Help Center.
Shortcuts are listed when clicking on tree-dots, then Keyboard Shortcuts in the editor view, but the most important are:
- TAB or Ctrl + Alt + ↓ - Save translation and go to next string
- Shift + TAB or Ctrl + Alt + ↑ - Save translation and select the previous string
- Ctrl + ↓ or Alt + ↓ - Select the next string (without saving)
- Ctrl + ↑ or Alt + ↑ - Select the previous string (without saving)
If you are the first translator for a language, you are able to review translations. All translations, reviewed or not, are included on Greasy Fork. Because reviewing a translation makes it so that other users cannot change the translation, we ask that you not review them. If someone has a reviewed a translation you would like to change, contact a Team Manager to unreview it..
In the translation box click each of one, few, many, other and specify a correct translation for the selected quantity (see declension). Then the Save button will be enabled.
