gnome-shell-extension-mpris-indicator-button icon indicating copy to clipboard operation
gnome-shell-extension-mpris-indicator-button copied to clipboard

Translations

Open JasonLG1979 opened this issue 4 years ago • 10 comments

This extension has a few user visible strings and strings that will be read a loud by screen readers that require translation.

It would be of great if someone would help me make that possible.

JasonLG1979 avatar Nov 02 '19 07:11 JasonLG1979

Update: So I've split out all translatable strings totranslations.js that is the only file that has translatable strings. Each translatable string has a very detailed description.

I've set it up so that once this extension has been translated to a language that translation should only ever need updating to add any additional future translations and any preexisting translations should not need touched, or ever break. The translations are independent of the rest of the code.

The actual build system still needs to be implemented though. That's where I could use someone's help that knows what they're doing, because I don't.

If a real build system is needed I would prefer meson over make.

JasonLG1979 avatar Nov 02 '19 20:11 JasonLG1979

I've noticed a bit of a potential issue. Currently in some situations it may not be possible to get the translations in the right grammatical order because of how accessibility works in GNOME Shell.

For example when you mouse over a playlist item in the playlist menu the screen reader will say:

"player name PlayLists Item; playlist's name".

So for example it might say:

"Pithos Playlist Item; Imagine Dragon Radio".

(note that the ; is important. it causes the screen reader to pause a bit to make the speech sound a little more natural.)

That makes sense in English, but not so much maybe in other languages. The problem is that I can't change all of ordering of the phrase. The order of the the accessibility bit ("player name PlayLists Item;") can be changed, but it will always be before the playlist's name.

JasonLG1979 avatar Nov 03 '19 15:11 JasonLG1979

I'll help you out with the PT-BR translation whenever I get the chance.

saboya avatar Feb 16 '20 01:02 saboya

@saboya That would be awesome. Before you start I need to tweak some of the translatable strings a bit and actually get off my lazy butt and figure out how to finish the rest of the translations plumbing.

JasonLG1979 avatar Feb 16 '20 07:02 JasonLG1979

So where exactly do i place Bulgarian translations?

mystiquewolf avatar May 08 '20 13:05 mystiquewolf

I can help with Latinamerican Spanish translations whenever the code is ready.

fcastilloec avatar May 15 '20 07:05 fcastilloec

I can help with Latinamerican Spanish translations whenever the code is ready.

I've been kinda dragging my feet on this. I need to do a lot of reading. I've never really dealt with translations before. Got to figure out how to do it.

JasonLG1979 avatar May 15 '20 07:05 JasonLG1979

Very usefull extension, Great Work!

I don know at what point are you, but you can take a look at this video, at least it helped me to understand how manage translations. https://www.youtube.com/watch?v=WmWjwE-M4D0

About the screen reader issue, in Latin languages, spanish, italian, portuguese, ... can be written grammatically to fit this order, just let the translator know that, once you have the po files i can help with it.

K3rcus avatar Jun 05 '20 02:06 K3rcus

I'll do the Dutch translation once this is implemented 🙂

Vistaus avatar Jul 14 '21 12:07 Vistaus

Created the pull request #68 - german translation is already included also the pot file which can be used to create more translations (I used poedit https://packages.debian.org/bookworm/poedit ) usually the pot/po files are the ones which checked in the command "gnome-extensions pack --podir=../po [email protected]" (in our case) will create a zip with the correct locale structure out of the *.po files

More info https://gjs.guide/extensions/development/translations.html#marking-strings-for-translation

ChrisLauinger77 avatar Oct 31 '22 08:10 ChrisLauinger77