Review Request 126369: [OS X] adaptation(s) to platform limitations (WIP)

Sun May 29 21:07:18 UTC 2016

> On May 29, 2016, 5:51 p.m., Kai Uwe Broulik wrote:
> > src/kstatusnotifieritem.cpp, line 909
> > <https://git.reviewboard.kde.org/r/126369/diff/4/?file=467228#file467228line909>
> >
> >     i18nc please
> 
> René J.V. Bertin wrote:
>     I'm not sure what to expect here, what effect is using `i18nc("!")` going to have? AFAIK the exclamation mark is pretty universal, and translating it might reduce the label's effectiveness. I've tried many options to label the Dock icon (that's what we're talking about here) and found no better alternative.
> 
> Kai Uwe Broulik wrote:
>     We cannot assume that. Greek does not use the "?" question mark symbol, for example. That's where the "c" comes in, you explain translators that you exactly want ("one symbol")
> 
> Burkhard Lück wrote:
>     To say "one symbol" is not sufficient for translators.
>     You need to explain what this char is used for, its role in the gui, see http://api.kde.org/frameworks/ki18n/html/prg_guide.html#good_ctxt
> 
> René J.V. Bertin wrote:
>     Not to appear stubborn, but in your example, wouldn't a Greek font use the appropriate symbol at the place of the question mark? Or do I need to specify the `U+` Unicode code for that, like I do for the bullet?
> 
> Burkhard Lück wrote:
>     You say "the exclamation mark is pretty universal" and that maybe true, but what about locales not having something like an exclamation mark?
>     translation teams have their locale with their specific character set *and* style guides how to translate
>     E. g in the german translation team we never translate an exclamation mark at the end of a messages literally, it nearly always is replaced by a period
>     context like noun or verb or U+ Unicode code have no meaning for translators

The point should have become moot with my last revision which uses a symbol rather than a punctuation mark. But I would think that (at least nowadays) even those locales you mention have been exposed to the kind of universal sign language that icons are. This is not written text that is to be translated in a semantically and gramatically correct way. It's a pictogram. Look at the icons shown in alert or question dialogs, or the icons shown on vehicle dashboards. The text accompanying them is translated, but not the icon, even if that icon contains a symbol like an exclamation or question mark. Or does KDE replace those icons with something else for locales that don't have exclamation and/or question marks?

Sadly I don't know of an easy way to check what Apple themselves do in this context. Alert dialogs mostly show the application icon rather than an icon that conveys the nature of the alert, and there's evidently no doubt that *those* icons don't depend on locale.

- René J.V.

-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://git.reviewboard.kde.org/r/126369/#review95984
-----------------------------------------------------------

On May 29, 2016, 8:03 p.m., René J.V. Bertin wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://git.reviewboard.kde.org/r/126369/
> -----------------------------------------------------------
> 
> (Updated May 29, 2016, 8:03 p.m.)
> 
> 
> Review request for KDE Software on Mac OS X and KDE Frameworks.
> 
> 
> Repository: knotifications
> 
> 
> Description
> -------
> 
> OS X has a number of limitations in features used by KNotifications, notably concerning the status notifier item (aka system tray icon).
> 
> This RR will likely evolve to address multiple limitations (at least also the NeedsAttention state); at the moment it only proposes an emulation of `QMenu::addSection`.
> 
> `QMenu::addSection` works by adding a QAction with a "texted separator" at the insertion location. Texted separators do not exist in menu items in the OS X "global" menubar (they become regular separators), and Qt will not provide a platform-specific implementation. Loss of the section title text is maybe not always an issue, but I think it is in the system tray menu. I therefore propose to emulate `QMenu::addSection` by replacing the texted separator with an inactive (disabled) menu item that shows the text, followed by a standard separator. Menus in the notification area are much less subject to interface guidelines, so the presence of an item icon is acceptable and IMO useful for the `titleAction`.
> 
> Testing the NeedsAttention state with the tests/kstatusnotifieritemtest application leads to disappearance of the menubar icon, i.e. the access to the notifier menu becomes invisible rather than blinking (which is what I get on Linux using the same packaging). Adding a few qDebug statements shows that the `attentionIcon` is empty.
> I'd appreciate a crash course how this feature is supposed to work, so I can see if an OS X implementation might be feasible.
> 
> 
> Diffs
> -----
> 
>   CMakeLists.txt 7cf8379 
>   src/CMakeLists.txt 7eb3125 
>   src/knotification.cpp 352cf49 
>   src/kstatusnotifieritem.cpp 27abfb8 
>   src/kstatusnotifieritemprivate_p.h 8fdfd4c 
>   src/notifybypopup.cpp 7d69a36 
>   tests/kstatusnotifieritemtest.cpp 973fc85 
> 
> Diff: https://git.reviewboard.kde.org/r/126369/diff/
> 
> 
> Testing
> -------
> 
> On OS X 10.9.5 with Qt 5.5.1 and frameworks 5.17.0 .
> 
> 
> File Attachments
> ----------------
> 
> the systray icon & menu created by kstatusnotifieritemtest . This application has no icon to show.
>   https://git.reviewboard.kde.org/media/uploaded/files/2015/12/16/286037ae-07b3-454a-a226-1748854493a1__kstatusnotifieritemtest-systray.png
> The systray icon and menu created by the KDE4 kwalletmanager (code has an equivalent patch)
>   https://git.reviewboard.kde.org/media/uploaded/files/2015/12/16/4fc9d4e4-1537-478c-9196-94cbc17b6b7c__kwalletmanager-systray.png
> An Apple systray icon+menu that shows icons (which cannot be hidden)
>   https://git.reviewboard.kde.org/media/uploaded/files/2015/12/16/fc48a963-2e18-4396-bd38-062d41688118__Apple-systray-menu-with-icons.png
> kstatusnotifieritemtest with added appIcon
>   https://git.reviewboard.kde.org/media/uploaded/files/2015/12/17/e896e90d-f0a8-43f7-9199-847572832df7__kstatusnotifieritemtest-with-appIcon.png
> kstatusnotifieritemtest-with-appIcon+attention.png
>   https://git.reviewboard.kde.org/media/uploaded/files/2015/12/17/f41081db-8e09-4ea2-95c1-f507c62109d4__kstatusnotifieritemtest-with-appIconattention.png
> 
> 
> Thanks,
> 
> René J.V. Bertin
> 
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-frameworks-devel/attachments/20160529/3ded52a4/attachment.html>