Figure it out a good way to remove title= attribute on intersphinx nodes

[humitos]

I originally removed the node['reftitle'] attribute because it doesn't make sense the browser shows the default tooltip (browser's built-in) and immediately after that our tooltip was shown. This behavior is a little confusing and it's not styled in my opinion. That's why I removed it.

However, removing this attribute made other extensions break (sphinx.ext.inheritance_diagram) which expects that attribute exists.

I went back in 0a75b73 (#86) and I'm opening this issue to find a better solution to avoid this.

We could:

1. define it as node['reftitle'] = ''
   • it makes the browser to not show the built-in tooltip
   • I'm not sure about the accessibility implication it has
   • is the HTML still valid? It will generate a <a title=""> tag
2. use javascript to remove all the title= from tags with .hoverxref .external on document load
3. other ideas?

See #86 (comment)

[stsewd]

use javascript to remove all the title= from tags with .hoverxref .external on document load

I think that's a good solution, and it also keeps a good experience for people that don't have js enabled.

[stsewd]

Also, maybe there is a way to disable/improve the default tooltip with css?

[humitos]

use javascript to remove all the title= from tags with .hoverxref .external on document load

I found that this code works find only over our own nodes:

$('.hoverxref').each(function () { $(this).removeAttr('title')});