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. Currently there is no way to translate script content.
To help translate Greasy Fork, you need to create an account on Transifex. Visit the registration page and follow the steps there to register.
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 Watch project in the header.
The next step depends on whether the language you want to translate to has already been set up.
Click the name 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 Join team in the upper right corner of the table with the translation files and confirm the dialog.
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 Submit 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 support portal.
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 [email protected].
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 and devise-i18n-views - 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 [email protected] with your request.
An overview on the roles and their permissions can be found in the Transifex FAQ.
Shortcuts are listed when clicking on the gear in the editor view, but the most important are:
- TAB - Save translation and go to next string
- Shift + TAB - Save translation and go to previous string
- Ctrl(or Alt) + Down - Go to next string (without saving)
- Ctrl(or Alt) + Up - Go to previous string (without saving)