Jump to content

Help:差异

From mediawiki.org
This page is a translated version of the page Help:Diff and the translation is 98% complete.
PD 注意:當您編輯本頁面時,即同意以CC0協議授權您的貢獻。您可以在公有領域帮助页面找到更多信息。 PD

差異(diff)可用于比較一个页面的兩個修訂版本間的差異。 差異是 MediaWiki wiki 中頁面導航和內容審核的基本組成部分。

维基生态中的平台有不同版本的「差异」,这具体取决于使用的设备和 MediaWiki 的设置。

何時和為何使用差異

差異主要用於複查自己或他人對頁面做出的改變。 這样做可能有很多原因:

  • 幫助發現破壞行為
  • 確認一個章節、句子或字詞何时被增加或移除
  • 確認是哪位編輯者做出修改
  • 作為進一步操作的起點,「差异」包含编辑撤销等操作以及到編輯者的个人主页、討論頁的链接。

如何檢視差異

最普遍的做法是通过「歷史紀錄」檢視差異。 这可以通过點擊「查看历史」標籤访问。 在那里,您可以使用「之前」以查看单次修订的「差异」,或者使用「单选」和「对比所选修订」按钮以查看多次修订的「差异」。

大多数特殊页面的变更列表通常包含记录差异的链接,例如:

查看差异的另一种方法是使用Special:Diff页面。 要使用它,您必须知道用于比较的修订版本ID。 可以通过查看diff URL的diff=123部分来检索修订版本ID,其中123是修订版本ID。 此外,您可以使用oldid参数的值来获得该版本与前一个版本的差异。

展示差异的组成部分

下面是差异页面重要部分的直观展示,您将在查看两个版本之间的差异时看到它们。

展示差异的组成部分


这个可交互的示例展示了差异页面的顶部(有些链接是空链接)。 旧版本显示在左侧,新版本显示在右侧。

Edit summaries in diffs are great)
(correction, + MediaWiki User's Guide
 
第8行: 第8行:
  For sysops and those with the rollback flag, a revert button is shown allowing them to revert from the new version to the old one.   For sysops and those with the rollback flag, a revert button is shown allowing them to revert from the new version to the old one.
This is only shown when viewing the diff between the current version and the one immediately preceding it. + This is only shown when viewing the diff between the recent version of a page and the last version by an author other than the one of the most current version.
  This example shows the top of the diff page, with the links described above.   This example shows the top of the diff page, with the links described above.
第25行: 第25行:
  </table>   </table>
+ [[MediaWiki User's Guide]]
+

没有更改的文本

没有更改的文本是浅灰色背景上的深灰色文本(仅显示更改文本前后的部分)。

颜色对比
旧版本 新版本
没有更改的文本 没有更改的文本

移动的文本

从一个位置移动到另一个位置的相同文本通常表示为被添加和被删除的文本。 安装MediaWiki时启用了Wikidiff2 的话,可能会有一个箭头图标更清楚地指示移动文本的位置。

添加的文本

包含添加文本的行的前面有一个加号图标 (+)。 添加的单词和字符以粗体突出显示。

移除的文本

包含移除文本的行的前面有一个减号图标 ()。 移除的单词和字符以粗体突出显示。

替换的文本

当出现 + 图标和 − 图标时,我们可以看到哪些内容被替换为新内容。

修改过的文本是白色背景上的黑色文本,旧段落外有橙色边框,新段落外有蓝色边框。

插入和删除的文本用彩色背景和粗体突出显示。 如果整个段落被删除或插入,则不加高亮或加粗,另一侧则为空白。

颜色对比
旧版本 新版本
发生更改的段落 发生更改的段落
颜色对比
旧版本 新版本
移除的段落  
  添加的段落
颜色对比
旧版本 新版本
移除的字符 添加的字符

链接到差异

可以在查看差异页面时复制URL来链接到差异——这种URL有两个参数,diffoldid

从wiki外部链接到差异可以用完整的URL完成,例如:

  • https://mediawiki.org/w/index.php?diff=1242287

借助特殊页面中的Special:Diff可以更容易地创建一个链接到差异的短链。

在wiki中,这些链接可以有以下形式:

这些链接可以在编辑摘要中使用,也可以像任何其他内部链接一样进行调整。例如 [[Special:Diff/1242286/1242287|查看差异]]查看差异

例如完整的URL [https://mediawiki.org/w/index.php?diff=1242287 1242287] 也可以写成 [[Special:Diff/1242287|1242287]]

默认情况下,修订后的页面将完整地显示在差异下方——可以设置首选项(“不在差异下面显示页面内容”)或在URL中设置 diffonly=1 来关闭。 可以创建不带页面内容的差异的链接:

行内差异

MediaWiki版本:
1.35

从 MediaWiki 1.35 开始,可以使用行内格式(也称unified diff)。 As of 2022 this is only available with the wikidiff2 engine. 行内差异可以在URL中传递 diff-type=inline 参数来访问(示例)。

MediaWiki版本:
1.41

从 MediaWiki 1.41 开始,差异页面上添加了一个开关,允许用户在用户界面(T336716)上在行内格式和双列格式之间切换。

Content added Content deleted
Edit summaries in diffs are great)
(correction, + MediaWiki User's Guide
 

For sysops and those with the rollback flag, a revert button is shown allowing them to revert from the new version to the old one.

This is only shown when viewing the diff between the current version and the one of a page and the last version by an author other than the one of the most current version.. This example shows the top of the diff page, with the links described above.

</table>

[[MediaWiki User's Guide]]

↲ newline

在行内格式引入了以下更改:

  • 说明示例和工具提示的蓝色和黄色高亮。 (T324759)
  • 表示何时添加或删除一行或多行的注释。 (T330247)

如何报告问题?

Bug 应该标记 #MediaWiki-Page-diffs 标签并报告给Phabricator

用户参数

The following user preferences are available in the "差异" section of the "外观" preferences tab:

不在差异下面显示页面内容
是否让页面文本在差异下面显示。 内容是该页两次修订中较晚的版本。
执行回退后不显示差异
回退后是否显示与回退版本的差异。

一些扩展还添加了它们自己与差异相关的首选项。 有一个叫扩展:修订滑块 的扩展,可以在首选项中的“不显示修订滑块”选项禁用。


參見