Translating

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.

Option 1: Crowdin

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.

Option 2: git

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

Fork GSConnect

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

Creating a Translation

1. Ensure the translation template is updated and aligned:

   git pull
   ninja -C _build org.gnome.Shell.Extensions.GSConnect-pot
   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.