en>Shirayuki: simplify translation units

2026-01-17T05:46:17Z

simplify translation units

New page

<templatestyles src="Help:Diff/styles.css" />
<languages/>
{{PD Help Page}}
{{Special page}}
<translate> A '''[[w:Diff|diff]]''' (short for difference) displays the changes between two revisions of a page.</translate>
<translate> Diffs are a fundamental component of navigation and content moderation on MediaWiki wikis.</translate>

<translate>

The platforms in the wiki ecosystem have several versions of a diff depending on which device and installation of MediaWiki is being used.

== When and why to use a diff? == 
</translate>
<translate> The main reason to use a diff is to review a specific change to a page made by yourself or someone else.</translate>
<translate> There are many possible reasons to do this:</translate>

* <translate> To help find instances of vandalism</translate>
* <translate> To determine when a section, sentence, or word was added or removed</translate>
* <translate> To determine which editor made a given change</translate>
* <translate> As a starting point to further actions as the diff contains <tvar name=1>[[Special:MyLanguage/Help:Editing pages|{{int|editold}}]]</tvar>, <tvar name=2>[[Special:MyLanguage/Manual:Reverts#Undo|{{int|editundo}}]]</tvar>, and other actions as well as links to the editor's user and talk pages.</translate>

<translate>
== How to navigate to view a diff? == 
</translate>

<translate> The most common way to view a diff is through the "[[<tvar name=1>Special:MyLanguage/Help:History</tvar>|Revision history]]".</translate>
<translate> This is accessible via the <tvar name=1><code>{{int|skin-view-history}}</code></tvar> tab.</translate>
<translate> From there, you can use <tvar name=1><code>{{int|last}}</code></tvar> to view diffs of single revisions, or use the radio buttons and the <tvar name=2><code>{{int|compareselectedversions}}</code></tvar> button to view diffs across multiple revisions.</translate>

<translate>

Most [[<tvar name=1>Special:MyLanguage/Help:Special pages</tvar>|special pages]] that list changes will usually include links to diffs, such as:
</translate>

* [[Special:RecentChanges]]
* [[Special:Watchlist]]
* [[Special:Contributions]]
* [[Special:Relatedchanges]]

<translate> Another way to view a diff is with the <tvar name=1>[[Special:Diff]]</tvar> page.</translate>
<translate> To use this, you must know the IDs of the revisions you want to compare.</translate>
<translate> Revision IDs can be retrieved by looking at the <tvar name=1><code>diff=123</code></tvar> portion of a diff URL, where <tvar name=2><code>123</code></tvar> is the diff ID.</translate>
<translate> Additionally, you can use the value of the <tvar name=1><code>oldid</code></tvar> parameter to get the diff of that revision against the previous one.</translate>

<translate>
== Components to a diff == 


Below is a visual representation of the important components of a diff page which you will see when viewing the difference between two versions.
</translate>

[[File:Diff-components.svg|thumb|<translate> Components of a diff</translate>|none|600px]]

<translate> This interactive example shows the top of the diff page (some of the links are dummy links).</translate>
<translate> The older revision is shown on the left, the newer revision on the right.</translate>

<blockquote style="border:1px solid; padding:1em;">
{| class="diff diff-contentalign-{{dir|{{pagelang2}}|right|left}} diff-editfont-monospace" border="0" style="border-spacing:4px; table-layout:fixed; width:98%"
|- style="height:1px" 
| style="width:2%" |
| style="width:48%" |
| style="width:2%" |
| style="width:48%" |
|- class="diff-title"
| colspan="2" class="diff-otitle diff-side-deleted" | <div class="mw-diff-otitle1"><strong>[[Special:MyLanguage/Help:Page history|{{int|revisionasof|22:32, 3 {{int|august}} 2003}}]] {{int|parentheses|[[Special:MyLanguage/Help:Editing|{{int|editold}}]]}}</strong></div>
<div class="mw-diff-otitle2">[[User:Tim Starling|Tim Starling]] {{int|parentheses|[[User talk:Tim Starling|{{int|talkpagelinktext}}]] {{int|pipe-separator}} [[Special:MyLanguage/Help:User contributions|{{int|contribslink}}]]}}</div>
<div class="mw-diff-otitle3"><span class="comment">{{int|parentheses|[[Special:MyLanguage/Help:Edit summary|Edit summaries]] in diffs are great}}</span></div>
<div class="mw-diff-otitle4">[[Special:MyLanguage/Help:Page history|{{int|previousdiff}}]]</div>
| colspan="2" class="diff-otitle diff-side-added" |<div class="mw-diff-otitle1"><strong>[[Special:MyLanguage/Help:Page history|{{int|revisionasof|00:10, 18 {{int|august}} 2003}}]] {{int|parentheses|[[Special:MyLanguage/Help:Editing|{{int|editold}}]]}} {{int|parentheses|[[Special:MyLanguage/Manual:Reverts|{{int|editundo}}]]}} {{int|parentheses|[[Special:MyLanguage/Extension:Thanks|{{int|thanks-thank}}]]}}</strong></div>
<div class="mw-diff-otitle2">[[User:Angela|Angela]] {{int|parentheses|[[User_talk:Angela|{{int|talkpagelinktext}}]] | [[Special:MyLanguage/Help:User contributions|{{int|contribslink}}]]}}    <span class="mw-rollback-link">[[Special:MyLanguage/Manual:Rollback|{{int|rollbacklinkcount|1}}]]</span></div>
<div class="mw-diff-otitle3"><abbr class="minoredit" title="{{int|recentchanges-label-minor}}">{{int|minoreditletter}}</abbr> <span class="comment">{{int|parentheses|correction, + [[MediaWiki User's Guide]]}}</span></div>
<div class="mw-diff-otitle4"> </div>
|-
| colspan="2" class="diff-lineno" | {{int|lineno|{{formatnum:8}}}}
| colspan="2" class="diff-lineno" | {{int|lineno|{{formatnum:8}}}}
|-
| class="diff-marker" |  
| class="diff-context diff-side-deleted" | 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.
| class="diff-marker" |  
| class="diff-context diff-side-deleted" | 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.
|-
| class="diff-marker" | −
| class="diff-deletedline diff-side-deleted" | This is only shown when viewing the diff between the <del style="color: black" class="diffchange diffchange-inline">current</del> version and the one <del style="color: black" class="diffchange diffchange-inline">immediately preceding it</del>.
| class="diff-marker" | +
| class="diff-addedline diff-side-added" | This is only shown when viewing the diff between the <ins style="color: black" class="diffchange diffchange-inline">recent</ins> version<ins style="color: black" class="diffchange diffchange-inline"> of a page</ins> and<ins style="color:black" class="diffchange diffchange-inline"> the last version by an author other than</ins> the one <ins style="color: black" class="diffchange diffchange-inline">of the most current version</ins>.
|-
| class="diff-marker" |  
| class="diff-context diff-side-deleted" | This example shows the top of the diff page, with the links described above.
| class="diff-marker" |  
| class="diff-context diff-side-deleted" | This example shows the top of the diff page, with the links described above.
|-
| colspan="2" class="diff-lineno" | {{int|lineno|{{formatnum:25}}}}
| colspan="2" class="diff-lineno" | {{int|lineno|{{formatnum:25}}}}
|-
| class="diff-marker" |  
| class="diff-context diff-side-deleted" | <nowiki></table></nowiki>
| class="diff-marker" |  
| class="diff-context diff-side-deleted" | <nowiki></table></nowiki>
|-
|colspan="2" |
| class="diff-marker" | +
| class="diff-addedline diff-side-added" | <nowiki>[[MediaWiki User's Guide]]</nowiki>
|-
|colspan="2" |
| class="diff-marker" | +
| class="diff-addedline diff-side-added" |
|}
</blockquote>

<translate>
=== Unchanged text === 


Unchanged text is dark grey on light grey (only parts before and after changed text are shown).
</translate>

{| class="diff diff-contentalign-{{dir|{{pagelang2}}|right|left}} diff-editfont-monospace" style="border-collapse:separate"
|+ <translate> Colour key</translate>
! align="center" width="200" | <translate> Previous diff</translate>
! align="center" width="200" | <translate> Newer diff</translate>
|-
| class="diff-context diff-side-deleted" | <translate> Unchanged</translate>
| class="diff-context diff-side-added" | <translate> Unchanged</translate>
|}

<translate>
=== Moved text === 
</translate>
<translate> Identical text that has moved from one place to another is usually represented as added and removed text.</translate>
<translate> On MediaWiki installations using <tvar name=1>{{ll|Wikidiff2}}</tvar>, there may be an arrow icon more clearly indicating where the moved text went to.</translate>

<translate>
=== Added text === 
</translate>
<translate> Lines containing added text have a plus icon (<tvar name=1>'''+'''</tvar>) before them.</translate>
<translate> The added words and characters are highlighted and in bold.</translate>

<translate>
=== Removed text === 
</translate>
<translate> Lines containing removed text have a minus icon (<tvar name=1>'''−'''</tvar>) before them.</translate>
<translate> The removed words and characters are highlighted and in bold.</translate>

<translate>
=== Replaced text === 


We can see what has been replaced with new content when there's a <tvar name=1>+</tvar> icon and a <tvar name=2>−</tvar> icon next to the phrase where the change happened.


Paragraphs which have changed are black on white, with an orange border on the old revision side and a blue border on the new version side.
</translate>

<translate> Inserted and removed text is highlighted with the border color and in bold.</translate>
<translate> Where whole paragraphs have been removed or inserted, no highlighting or bolding is applied and the other side is blank.</translate>

{| class="diff diff-contentalign-{{dir|{{pagelang2}}|right|left}} diff-editfont-monospace" style="border-collapse:separate"
|+<translate> Colour key</translate>
!align="center" width="200"| <translate> Old revision</translate>
!align="center" width="200"| <translate> New revision</translate>
|-
| class="diff-deletedline diff-side-deleted" | <translate> Paragraph changed</translate>
| class="diff-addedline diff-side-added" | <translate> Paragraph changed</translate>
|}

{| class="diff diff-contentalign-{{dir|{{pagelang2}}|right|left}} diff-editfont-monospace" style="border-collapse:separate"
|+<translate> Colour key</translate>
!align="center" width="200"| <translate> Old revision</translate>
!align="center" width="200"| <translate> New revision</translate>
|-
| class="diff-deletedline diff-side-deleted" | <translate> Paragraph removed</translate>
| class="diff-empty diff-side-delete" |  
|-
| class="diff-empty diff-side-added" |  
| class="diff-addedline diff-side-added" | <translate> Paragraph added</translate>
|}

{| class="diff diff-contentalign-{{dir|{{pagelang2}}|right|left}} diff-editfont-monospace" style="border-collapse:separate"
|+<translate> Colour key</translate>
!align="center" width="200"| <translate> Old revision</translate>
!align="center" width="200"| <translate> New revision</translate>
|-
| class="diff-deletedline diff-side-deleted" | <del class="diffchange diffchange-inline" style="color:black"><translate> Removed characters</translate></del>
| class="diff-addedline diff-side-added" | <ins class="diffchange diffchange-inline" style="color:black"><translate> Added characters</translate></ins>
|}

<translate>
== Linking to a diff == 


Diffs can be linked to by copying the URL while viewing the diff — this URL has two parameters, <tvar name=1><code>diff</code></tvar> and <tvar name=2><code>oldid</code></tvar>.


Linking to a diff from outside a wiki can be done by using the full URL, for example:
</translate>

* <code><nowiki>https://mediawiki.org/w/index.php?diff=1242287</nowiki></code>

<translate>

The diff [[<tvar name=1>Special:MyLanguage/Help:Special pages</tvar>|special page]] at <tvar name=2>[[Special:Diff]]</tvar> makes it easier to create shorter URLs which redirect to diffs.


From within a wiki, these links can take the following forms:
</translate>

* <code><nowiki>[[Special:Diff/1242287]]</nowiki></code> → [[Special:Diff/1242287]] – <translate> Shows the diff to the previous revision of the same page.</translate>
* <code><nowiki>[[Special:Diff/1242287/prev]]</nowiki></code> → [[Special:Diff/1242287/prev]] – <translate> Shows the diff to the previous revision of the same page.</translate>
* <code><nowiki>[[Special:Diff/1242287/next]]</nowiki></code> → [[Special:Diff/1242287/next]] – <translate> Shows the diff to the next revision of the same page.</translate>
* <code><nowiki>[[Special:Diff/1242287/cur]]</nowiki></code> → [[Special:Diff/1242287/cur]] – <translate> Shows the diff to the current revision of the same page.</translate>
* <code><nowiki>[[Special:Diff/1242286/1242287]]</nowiki></code> → [[Special:Diff/1242286/1242287]] – <translate> Shows the diff between the specified revisions of the same page which may also be reversed, e.g. <tvar name=1><code><nowiki>[[Special:Diff/1242287/1242286]]</nowiki></code> → [[Special:Diff/1242287/1242286]]</tvar>, though one should avoid this.</translate>

<translate>

These links may be used in the [[<tvar name=1>Special:MyLanguage/Help:Edit summary</tvar>|edit summary]] as well as being adapted like any other internal links, e.g. {{<tvar name=2>tmpl|0=<code><nowiki>[[</nowiki>Special:Diff/1242286/1242287{{!}}$1<nowiki>]]</nowiki></code> → [[Special:Diff/1242286/1242287|$1]]</tvar>|see this diff}}.


For example, the full URL <tvar name=1><code><nowiki>[https://mediawiki.org/w/index.php?diff=1242287 1242287]</nowiki></code></tvar> could also be written as <tvar name=2><code><nowiki>[[Special:Diff/1242287|1242287]]</nowiki></code></tvar>.
</translate>

<translate> By default, the later revision of the page is displayed in full below the diff — this can be turned off via a [[<tvar name=1>Special:MyLanguage/Help:Preferences</tvar>|preference]] (<tvar name=2><code>{{int|tog-diffonly}}</code></tvar>) or by setting <tvar name=3><code>diffonly=1</code></tvar> in the URL.</translate>
<translate> Links to diffs without the page text can be created:</translate>

* <code><nowiki>{{canonicalurl:Special:Diff/1242287|diffonly=1}}</nowiki></code> → {{canonicalurl:Special:Diff/1242287|diffonly=1}}

<translate>
== Inline diffs == 
</translate>
{{MW 1.35|and later}}
<translate> Since MediaWiki 1.35, an inline diff (also known as a [[w:unified diff|unified diff]]) is available.</translate>
<translate> As of 2022 this is only available with the <tvar name=1>{{ll|wikidiff2}}</tvar> engine.</translate>
<translate> Inline diffs can be accessed by passing the <tvar name=1><code>diff-type=inline</code></tvar> parameter in the URL ([<tvar name=url>https://www.mediawiki.org/w/index.php?diff=1242287&diffmode=source&diff-type=inline</tvar> example]).</translate>

{{MW 1.41|and later}}
<translate> As of MediaWiki 1.41, a toggle was added to diff pages that allows users to switch between inline and two-column in the user interface.</translate> [[phab:T336716|T336716]]

<blockquote style="border:1px solid; padding:1em;">


<div class="mw-diff-table-prefix" dir="ltr" lang="en">
<div style="color: black" class="mw-diff-inline-legend"><span class="mw-diff-inline-legend-ins">Content added</span> <span class="mw-diff-inline-legend-del">Content deleted</span></div>
</div>

{| class="diff diff-contentalign-{{dir|{{pagelang2}}|right|left}} diff-editfont-monospace" border="0" style="border-spacing:4px; table-layout:fixed; width:98%"
|- style="height:1px" 
| style="width:2%" |
| style="width:48%" |
| style="width:2%" |
| style="width:48%" |
|- class="diff-title"
| colspan="2" class="diff-otitle diff-side-deleted" | <div class="mw-diff-otitle1"><strong>[[Special:MyLanguage/Help:Page history|{{int|revisionasof|22:32, 3 {{int|august}} 2003}}]] {{int|parentheses|[[Special:MyLanguage/Help:Editing|{{int|editold}}]]}}</strong></div>
<div class="mw-diff-otitle2">[[User:Tim Starling|Tim Starling]] {{int|parentheses|[[User talk:Tim Starling|{{int|talkpagelinktext}}]] {{int|pipe-separator}} [[Special:MyLanguage/Help:User contributions|{{int|contribslink}}]]}}</div>
<div class="mw-diff-otitle3"><span class="comment">{{int|parentheses|[[Special:MyLanguage/Help:Edit summary|Edit summaries]] in diffs are great}}</span></div>
<div class="mw-diff-otitle4">[[Special:MyLanguage/Help:Page history|{{int|previousdiff}}]]</div>
| colspan="2" class="diff-otitle diff-side-added" |<div class="mw-diff-otitle1"><strong>[[Special:MyLanguage/Help:Page history|{{int|revisionasof|00:10, 18 {{int|august}} 2003}}]] {{int|parentheses|[[Special:MyLanguage/Help:Editing|{{int|editold}}]]}} {{int|parentheses|[[Special:MyLanguage/Manual:Reverts|{{int|editundo}}]]}} {{int|parentheses|[[Special:MyLanguage/Extension:Thanks|{{int|thanks-thank}}]]}}</strong></div>
<div class="mw-diff-otitle2">[[User:Angela|Angela]] {{int|parentheses|[[User_talk:Angela|{{int|talkpagelinktext}}]] | [[Special:MyLanguage/Help:User contributions|{{int|contribslink}}]]}}    <span class="mw-rollback-link">[[Special:MyLanguage/Manual:Rollback|{{int|rollbacklinkcount|1}}]]</span></div>
<div class="mw-diff-otitle3"><abbr class="minoredit" title="{{int|recentchanges-label-minor}}">{{int|minoreditletter}}</abbr> <span class="comment">{{int|parentheses|correction, + [[MediaWiki User's Guide]]}}</span></div>
<div class="mw-diff-otitle4"> </div>
|}

<div class="mw-diff-inline-moved mw-diff-inline-moved-destination mw-diff-inline-moved-upwards">
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 <del style="color:black" class="mw-diff-inline-moved">current</del> version and the one <ins style="color: black">of a page and the last version by an author other than the one of the most current version.</ins>.
This example shows the top of the diff page, with the links described above.

<nowiki></table></nowiki>

<ins style="color: black">
<nowiki>[[MediaWiki User's Guide]]</nowiki>
</ins>
<div><ins style="color: black; font-family: 'Menlo','Consolas','Liberation Mono','Fira Code','Courier New',monospace;
font-size: 87.5%;" title="Content added">↲ newline</ins></div>
</div>
</blockquote>

<translate>

The following changes were introduced for inline diff:
</translate>

* <translate> Legends and tooltips that explain the blue and yellow highlights.</translate> ([[phab:T324759|T324759]])
* <translate> Annotation that represent when one or more lines are added or deleted.</translate> ([[phab:T330247|T330247]])

<translate>
== How to report bugs? == 


Bugs should be [[<tvar name=1>Special:MyLanguage/How to report a bug</tvar>|reported on Phabricator]] under the <tvar name=2>{{phabricator inline tag|MediaWiki-Page-diffs}}</tvar> tag.

== User Preferences == 


The following user [[<tvar name=1>Special:MyLanguage/Help:Preferences</tvar>|preferences]] are available in the <tvar name=2><code>{{int|prefs-diffs}}</code></tvar> section of the <tvar name=3><code>{{int|prefs-rendering}}</code></tvar> preferences tab:
</translate>
<section begin="prefs" />
; {{int|tog-diffonly}}
: <translate> Toggle the display of the page text below the diff.</translate> <translate> This text is the later of the two revisions of the page.</translate>
; {{int|tog-norollbackdiff}}
: <translate> Whether to show the diff of the rolled back revision after a rollback.</translate>

<translate> Some extensions also add their own preferences related to diffs.</translate>
<translate> One such extension is <tvar name=1>{{ll|Extension:RevisionSlider}}</tvar>, which can be disabled in preferences using the <tvar name=2><code>{{int|revisionslider-preference-disable}}</code></tvar> preference in that section.</translate>
<section end="prefs" />

<translate>
== See also == 
</translate>
* {{ll|Help:History}} – <translate> Navigating and understanding page history.</translate>
* {{ll|Visual diffs}} – <translate> Diffs in the VisualEditor and VisualDiff extensions.</translate>
{{Help}}

Help:Diff - Revision history

Majestix: 1 revision imported: Initial Setup

en>Shirayuki: simplify translation units

← Older revision		Revision as of 11:17, 17 April 2026
(No difference)