Move tooltips out of skin.xml into source code

[jus]

Tooltips should move out of the skins.xml into the source for various reasons
- to support ongoing mixxx-i18n efforts
- to provide a coherent user experience for all skins
- to eliminate a source of error for skin designers

Current tooltips are maybe a little to extensive so the content could use an overhaul too.

Also we should find a way to differentiate between "regular" tooltips and library tooltips as suggested here: https://bugs.launchpad.net/mixxx/+bug/662540

[RJ Skerry-Ryan (rryan)]

I agree that the tooltips shouldn't be in the skin.xml. Were you thinking we would automatically figure out the tooltip to display based on the connections? We could also switch to an ID system that works like this:

Deprecate the <Tooltip> section. Allow widget tags to take a tooltip="" attribute.

<Visual tooltip="waveform-display">

</Visual>

In the code, there will be a tooltips file that maps the tooltip IDs to their text. This way, we can submit the tooltip text for translations. If a skin designer would like to provide a custom tooltip or override a Mixxx default one, they can make a tooltips.xml to stick in their skin folder. It could look like this:

<tooltips>
<tooltip id="waveform-display" language="en">Custom text for waveform tooltip</tooltip>
<tooltip id="waveform-display" language="fr">...</tooltip>
</tooltips>

This should be discouraged since the skin designer will have to provide translations for their tooltips, but it will still allow them to make custom tooltips, while using the Mixxx provided ones by default. What do you think?

[jus (jus)]

Nah, no custom tooltips anymore but allow styling.
Have the standard ones translated and displayed with the associated shortcuts and thats it.

Tooltip attribute sounds good.
Naming convention should be in line with <ConfigKey> http://mixxx.org/wiki/doku.php/midi_controller_mapping_file_format#ui_midi_controls_and_names
This way we use these Key/Control names for Midi,Keyboard and Skins.

Some things to think on:
* That <Visual> and <Text> are some kind of exceptions
* That a button can have more than 1 <NumberStates>
* To display tooltips for the <Property> field inside a <TrackProperty> node

If the tooltips get some polish, we should separate them from the library tooltips
https://bugs.launchpad.net/mixxx/+bug/662540

It should be also possible to de/activate them from within the UI.

[RJ Skerry-Ryan (rryan)]

Skins now support a <TooltipId> tag in place of a <Tooltip> tag. If you
provide an ID of a tooltip we have hardcoded in Mixxx then the tooltip will
be the translated, hard-coded version. I didn't go with attributes since
generally we don't use attributes much in the skin.xml so I figured I'd
keep with the style.

I didn't do anything fancy with left-click or right-click tooltips. I just
verbatim copied each one and gave each unique tooltip in our current set of
skin.xml tooltips into its own tooltip id.

On Mon, May 7, 2012 at 2:20 PM, RJ Ryan <email address hidden> wrote:

> ** Changed in: mixxx
> Assignee: (unassigned) => RJ Ryan (rryan)
>
> --
> You received this bug notification because you are a member of Mixxx
> Development Team, which is subscribed to Mixxx.
> https://bugs.launchpad.net/bugs/691864
>
> Title:
> Move tooltips out of skin.xml into source code
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/mixxx/+bug/691864/+subscriptions
>

[Swiftb0y (swiftb0y)]

Mixxx now uses GitHub for bug tracking. This bug has been migrated to:
https://github.com/mixxxdj/mixxx/issues/5721