Translating - GSConnect/gnome-shell-extension-gsconnect GitHub Wiki

Thank you for considering contributing a translation to this project. Consider subscribing to the Translation Thread to be notified of changes and updates. I usually give notice before the next release, and you can ask for more time to get your translation into the next release.

Crowdin works well for most languages and can be translated from the web interface or setup with POEdit. You can join as a translator at https://crwd.in/gsconnect and request to add a new language, if necessary.

To contribute a translation you'll need a GitHub account, git, meson and a translation program like Gtranslator or POEdit.

Once you have everything, start by creating a fork on Github:

Then clone your fork with git and setup the project with meson:

$ git clone https://github.com/<your_username>/gnome-shell-extension-gsconnect.git
$ cd gnome-shell-extension-gsconnect
$ meson . _build

1. Ensure the translation template is updated and aligned:

   git pull
   ninja -C _build org.gnome.Shell.Extensions.GSConnect-pot

There is also a tool to update/create .po files for individual languages, but it conflicts with crowdin on the way to handle line breaks so it is not recommended to run it. It's included here for completeness, e.g. if you want to add new languages with a local only process.

ninja -C _build org.gnome.Shell.Extensions.GSConnect-update-po

2. Use the translation program to create a new translation for your language from po/org.gnome.Shell.Extensions.GSConnect.pot.

   Save your translation in po/ with the others, then make sure the language code for your translation is in po/LINGUAS. For example, if your translation is named fr.po it should have fr on its own line:

   es
   fr
   pl
   

3. To test your translation install the extension and restart GNOME Shell:

   ninja -C _build install-zip

   If you are using X11/Xorg you can restart Gnome Shell with Alt + F2 then restart. If you are using Wayland you must restart your session.

4. When you're happy with your translation, commit the changes and push them to your fork:

   git commit -a -m "Add/update French translation"
   git push

5. Then open a new Pull Request from your fork at https://github.com/<your_username>/gnome-shell-extension-gsconnect.