Set Polish language

Site Operators
, ,
1

I’ve launched the latest version of Tutor locally. I set the language to Polish during the installation (and later manually via the CLI), and I also changed the language preferences through the GUI.

Unfortunately, none of that worked. I read somewhere in the documentation/forum that I should try using atlas pull and then rebuild the MFE and Tutor Docker images. While rebuilding the MFEs, I managed to blow up my VM! :smiley:

In any case, I was wondering if this atlas pull and rebuild even make sense, and if these actions will actually make the translation appear. From what I can see on Transifex, the Polish translation is at 98%.

I would appreciate any help or guidance on what I can do to successfully implement the Polish language.

2

Hi @TomaszCh - I’ve recategorized this to “Site Operators” to try to get the right eyes on it. I also cross posted this thread to the #wg-translations room in the Open edX slack.

1 Like
3

Hey @TomaszCh . I was exactly where you are a few weeks ago. Back then polish translations on transifex were quite bad. As an example all the buttons had the basic form (i.e. “Anulować”) and not the imperative (“Anuluj”). However I see that new ones have been pushed and look much better. Still a few are missing like the frontend-app-profile openedx-translations/translations/frontend-app-profile/src/i18n/messages at main · openedx/openedx-translations · GitHub.

From what I know rebuilding the images should always include the newest translations from the GitHub - openedx/openedx-translations: Open edX Translation files in sync with Transifex · GitHub repo which pulls them automatically from transifex.

You can see this is true by inspecting your logs during the build. In the Makefile of each MFE you can find the according command realizing this: pull_translations frontend-app-account/Makefile at master · openedx/frontend-app-account · GitHub

If you are looking to add custom translations or fill the missing ones I suggest the following approach:

  1. Fork/Clone the existing openedx-translations repo
  2. Add new translation files based on the existing english ones where needed
  3. Change the ATLAS_REPOSITORY and ATLAS_REVISION tutor environment variables (either via editing *tutor config edit *or using
    tutor config save --set ATLAS_REPOSITORY=YOUR_REPOand
    tutor confg save --set ATLAS_REVISION=YOUR_BRANCH
    then rebuilding the images.

Make sure the repos are public and you should be good!

If you want to see the changes live, verify you’ve linked the repos correctly and not wait for rebuilding the images:

  1. Clone desired MFE to see the changes in
  2. Mount it tutor mounts add path_to_cloned_mfe
  3. Check the mount tutor mounts list (it should be automatically recognized as an MFE)
  4. Inside the MFE catalog
    Modify the Makefile by adding the ATLAS_REPOSITORY and ATLAS_REVISION values at the top in an ATLAS_OPTIONS config variable like so:
    ATLAS_OPTIONS= --repository YOUR_REPO --revision YOUR_BRANCH.
    Then run:
    make pull_translations → now your src/i18n catalog should get populated with all translations for that specific MFE from your translations repo
    nvm use
    npm install
    npm run dev (if not available then npm run start) - platform has to be off since otherwise there will be a port clash. First run this then the platform

When you switch to polish in the account settings changes should be visible on the page! For that reason I recommend you try mounting the account MFE GitHub - openedx/frontend-app-account: Open edX micro-frontend application for managing user account information. · GitHub

Also make sure to clone the MFE from the release corresponding to the openedx version you’re using so the APIs match etc.

1 Like