Skip to content

How to translate Drop Feeds ?

dauphine-dev edited this page Oct 14, 2023 · 6 revisions

The initial translation

Welcome new translator :-)

  1. Clone (preferred method) or download Drop Feeds master branch.
  2. Go in "_locales" folder,
  3. Create a new folder named with the targeted language code (for example "nl" for Dutch, or "es" for Spanish, see here to found your language code)
  4. Copy the "messages.json" file from "en" folder into the new language folder and translate it
  5. Merge the translation
  • 5.1 If you have cloned the folder (the recommended way) then do a pull request on 1.0.x branch, and I will merge it with Drop Feed code.
  • 5.2 If you have downloaded the Drop Feeds repository, then attach your new translated 'messages.json' in a new message in this issue (don't forget to mention your code language).
  • Note: I prefer 5.1 way, but you are not comfortable with GIT don't hesitate to use the 5.2 way

Update translation when a new version comes

When a new Drop Feeds version is created:

  • it come with the file to-translate at the root of the repository.
  • this file contains the list of new entries to translate, and/or the entries need to be updated.
  • a issue is opened to ask help to update the translation of the new version then process like for the initial translation but work with the version branch.
  • after few days the new version will be make public (available on Mozilla add-ons page), if the translation update come after that work the master branch

But don't worries, if you haven't worked with right branch, I will pick up the file and put in the right branch, then don't hesitate to update translations :-)

Translate user scripts help

User script helps are locate in (where xx is the language code) :
help/xx/userScripts

Translate files feedTransformerHelp.html, and virtualFeedHelp.html

They are html files, then don't modify tags and attributes and translate only the real text.

For example:
<img src="/themes/_templates/img/scripts-delete.png"> : delete the script</li>
in French becomes:
<img src="/themes/_templates/img/scripts-delete.png"> : supprimer le script</li>
Only the part " : delete the script" has been translated.