扩展:修订滑块

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:RevisionSlider and the translation is 64% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎español • ‎français • ‎galego • ‎italiano • ‎polski • ‎português do Brasil • ‎Ελληνικά • ‎русский • ‎українська • ‎עברית • ‎فارسی • ‎کوردی • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
MediaWiki扩展手册
OOjs UI icon advanced.svg
Extension:RevisionSlider
发布状态: 稳定版
Screenshot Revision slider EN large.png
实现 User interface
描述 添加滑块界面至修订视图以允许更容易地在修订版本之间移动
作者 德国维基媒体协会(WMDE)
最新版本 1.0.0 (持续更新)
兼容性方针 发行分支
MediaWiki 1.25+
数据更新
许可协议 GNU General Public License 2.0 or later
下载
翻译RevisionSlider扩展如果在translatewiki.net可用
检查使用和版本矩阵。
问题 开放的工作 · 报告错误

修订滑块(RevisionSlider)扩展添加滑块界面至修订视图,这样您可以更容易地在修订版本间移动。

安装

  • 下载文件,并将其放置在您extensions/文件夹中的RevisionSlider目录内。
  • 将下列代码放置在您的LocalSettings.php的底部:
    wfLoadExtension( 'RevisionSlider' );
    
  • Yes 完成 – 在您的wiki上导航至Special:Version,以验证扩展已成功安装。

用法

Slide0 collapsed.svg

在差异页面时,滑块默认被折叠,并只能在页面顶部看见一行称作“浏览历史”的下拉栏。点击该栏以展开修订滑块。

RevisionSlider Help Step1.svg

一旦展开,修订滑块会取得有关修订版本的数据,并允许您在差异页面上导航并比较修订版本。

RevisionSlider Help Step2.svg

每个竖条代表页面的修订版本。

上方的竖条显示页面大小的增长,下方的竖条则显示其减小。

在图片中,修订版本1代表添加的内容,而修订版本2代表移除内容。

RevisionSlider Help Step3.svg

要比较特定的修订版本,可使用黄色和蓝色指针选择修订版本。蓝色的指针控制新修订版本,黄色的指责映射到旧修订版本。

There are several ways to do this:

  • You can drag and drop the knob to the desired position on the slider.
  • You can click on the desired position on the slider line. To select the newer revision, click on the blue line, and for selecting the older revision, click on the yellow line. To indicate which revision you're about to select, a preview of a blue or yellow knob appears and the bar turns blue or yellow.
  • You can click into the bar above the middle line (to select the newer revision) or below the line (to select the older revision). This also gives you a preview of the knob on the middle line.


If you move the blue knob to a position left of the yellow knob, the yellow knob is automatically moved along, and vice versa if you move the yellow knob to a position right of the blue knob.

RevisionSlider Help Step4.svg

使用向后和向前箭头以在修订版本历史间移动,并显示新旧修订版本。


Opt-out

If you are not using the RevisionSlider at all and also don't want to see the collapsed RevisionSlider bar at the top of the diff page, you can opt-out by checking Don't show the RevisionSlider in your preferences under Appearance -> Diffs.

技术背景

JavaScript钩

当新的修订被选择时,修订滑块使用AJAX重新加载差异页面。一旦页面被重新加载,wikipage.content和wikipage.diff钩会被剔除。如果用户JavaScript或扩展JavaScript在差异页面起作用,您可能需要监听这些钩。

例子

API调用和取得数据

除非您展开了该工具栏,工具不会进行任何API调用。只有当用户展开了滑块时,它才取得有关修订版本的数据(修订版本id、时间戳、用户、摘要、大小和标记)。工具只取得当前屏幕上可用修订版本的数据(最多500个修订版本),且有关额外修订版本的数据只当用户使用箭头在时间轴上向前或向后导航时才会加载。

背景

修订滑块[1]是实现德语社群愿望单[2]最大愿望之一的功能,并由德国维基媒体协会(WMDE)的TCB团队开发。它受DerHexer的revisionjumper小工具启发,并基于维基媒体基金会社群技术团队原型

Notes (for rather technical audience) on RTL issues discovered while developing the extension have been published on the separate subpage.

参考资料