Reference Tooltips/zh



当鼠标指针悬停在脚注上时，小工具参考文献提示工具能够直接显示出脚注的内容. 用户不必向下滚动页面，提示内容将直接显示在该正文行中.

本功能在很多wiki上默认启用，用户可以通过本功能的选项菜单关闭这个小工具（这将设置一个cookie）；已登录的用户可以在“特殊:参数设置”页面的小工具选项卡中永久关闭它.

简介
本工具最初由User:Yair rand在2012年开发，并由User:Jack who built the house在2019年修改. 要在您的wiki上安装该小工具，请添加下列文件并进行以下操作：


 * w:MediaWiki:Gadget-ReferenceTooltips.js
 * Replace  with the appropriate URL for your own wiki (as of 27 April 2020, this is around line 479); failing to do so may cause an exception in the JavaScript console, and the tooltips will fail to show up
 * w:MediaWiki:Gadget-ReferenceTooltips.css
 * Add the line "ReferenceTooltips[ResourceLoader|default|type=general|dependencies=mediawiki.cookie,jquery.client]|ReferenceTooltips.js|ReferenceTooltips.css" to MediaWiki:Gadgets-definition
 * Create a description for the gadget to be displayed in the user preferences by editing MediaWiki:Gadget-ReferenceTooltips on your wiki; copy-paste the content from w:MediaWiki:Gadget-ReferenceTooltips, or create your own if you wish

此时，该小工具已被添加且默认被载入.

小工具的正常工作依赖于：mediawiki.cookie、jquery.client. 也必须一同加载.

设计理由
当前，Wikimedia站点将所有参考文献列于文章底部. 对于长页面，特别是那些有很多参考文献的页面，这种方式并不理想. 为了查看这些参考文献，用户需要往返于整个页面的各个位置，在这一过程中，用户很可能丢失其阅读进度.

假说
这是一项通用的实用功能. 我们猜想，如果用户不必穿梭于页面，而是立刻看到参考文献，他们会更愿意访问这些脚注的内容.



现有工作流
在一篇文章中，添加有脚注的内容旁会有一个含有内部链接的上标. 点击这个链接，用户将被导航到页面底部的参考文献列表. 对应参考文献项目将高亮显示. 接着，用户点击该链接，打开参考文献外部链接.



用户体验
当用户将鼠标指针悬停在文章的引用上标链接上时，包含脚注内容的小工具将显示. 用户可以将鼠标指针移入悬浮框内，点击链接以访问外部参考文献.

点击该上标链接的行为保持不变（用户将被导航到参考文献列表）.



JavaScript和对触屏设备的特别考虑
本功能要求启用JavaScript. 没有启用JavaScript的浏览器不能使用本功能.

如果不禁用现有的“点击跳转到参考文献列表”这一行为，本功能在平板电脑等触屏设备上可能会失效.

设置
要修改本小工具的设置，将鼠标悬停在一处引用之上，待提示工具出现时，点击齿轮图标. 以下项目可供设置：


 * 提示工具在悬停时出现，还是在点击时出现；
 * 提示工具显示延时（默认为200毫秒）；
 * 对于标签中的缩写是否显示提示工具. （例如：abbr. ）



参见

 * w:User talk:Yair rand/ReferenceTooltips – 讨论页
 * – alternative implementation as an extension
 * – alternative implementation as an extension