参考文献提示工具

From mediawiki.org
This page is a translated version of the page Reference Tooltips and the translation is 98% complete.
Outdated translations are marked like this.
一个参考文献提示工具的示例;手形鼠标指针悬停在脚注链接[19]上。 参考文献提示工具可以直接显示脚注内容。用户不必点击这个链接,更不必手动滚动页面到脚注19处。

当鼠标指针悬停在脚注上时,小工具参考文献提示工具能够直接显示出脚注的内容。

用户不必向下滚动页面,提示内容将直接显示在该正文行中。

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

简介

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

  • w:MediaWiki:Gadget-ReferenceTooltips.js
    • Replace https://en.wikipedia.org/w/load.php 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。 Extension:小工具 也必须一同加载。

设计理由

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

假说

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

现有工作流

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

用户体验

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

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

JavaScript和对触屏设备的特别考虑

本功能要求启用JavaScript。 没有启用JavaScript的浏览器不能使用本功能。

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

设置

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

  • 提示工具在悬停时出现,还是在点击时出现;
  • 提示工具显示延时(默认为200毫秒);
  • 对于‎<abbr>标签中的缩写是否显示提示工具。 (例如:abbr.

参见