This template is intended to be useful for creating links to "diffs"; that is, links to pages that show the differences between two versions of a wiki page.
Every version of a page has a revision ID, which you can find from the history of the page by looking at the link for the timestamp, which is of the form:
http[s]://en.wikipedia.org/w/index.php?title=SomePageName&oldid=442212827
The number after oldid= is the revision ID.
Given a page name and one or two revision IDs, you can construct links to several types of diffs.
Contents
Usage
{{Diff|page|diff|oldid|label|diffonly=yes}}
- page – The title of the page.
- diff – The ID or keyword that is used against the base ID. Possible keywords are:
- cur – compare with the current version of a page.
- prev – compare with the previous version of a page.
- next – compare with the next version of a page.
- id – This should be larger than oldid.
- oldid – The base ID onto which the diff is generated.
- label – Text to display as link. No label will give a numbered link.
|diffonly=yes
– Displays the page comparisons only. Parameter name required.
All parameters other than page and diff are optional. Omitted parameters must be empty (by using a double pipe). You can also use the named parameters page, diff, oldid, and label.
Examples
Below each example in the left-hand column is the pseudocode for that example in brown italics
and indented. Elements that should be entered literally are in brown bold underlined italics
. When a parameter is left blank, the resulting two adjacent pipes are underlined (but not bolded): ||
.
Code | Output |
---|---|
{{Diff|Main Page|prev|204901573|Diff between a numbered version and the previous version}}
|
Diff between a numbered version and the previous version
This is the form that would be used most often.
|
{{Diff|Main Page|204901573|202506579|Diff between two numbered versions of a page}}
|
Diff between two numbered versions of a page
|
{{Diff|Wikipedia:Pagediff|204934693|204901573|Diff between two numbered versions of a page in Wikipedia namespace}}
|
Diff between two numbered versions of a page in Wikipedia namespace
|
{{Diff|Main Page|next|204901573|Diff between a numbered version and the subsequent version}}
|
Diff between a numbered version and the subsequent version
|
{{Diff|Main Page|cur|204901573|Diff between a numbered version and the current version of a page}}
|
Diff between a numbered version and the current version of a page
|
{{Diff|Main Page|cur||Diff showing the most recent change to a page}}
|
Diff showing the most recent change to a page
|
{{Diff|Main Page||204901573|A link to a numbered version of a page}}
|
A link to a numbered version of a page
|
{{Diff|Main Page|204901573|202506579|Comparison display without page display of two numbered versions of a page |diffonly=yes}}
|
Comparison display without page display of two numbered versions of a page
|
See also
- {{oldid}} – simplifies the case for linking to a known old version
- {{diff2}} – same as {{diff}}, but assumes the current page
- {{diffsandbox}} – compares a given page with the sandbox version
- {{Querylink}} – generic template to construct query strings
- diff utility – syntax highlight on wiki pages with mw:Extension:SyntaxHighlight GeSHi
- User:Scottywong/diffconverter, a tool for converting from raw form
- The special page
[[Special:Diff/ ...]]
serves a similar purpose; see Help:Wiki markup#Linking to old revisions of pages, diffs, and specific history pages.
TemplateData
A template that is intended to be useful for creating links to diffs; that is, links to pages that show the differences between two versions of a wiki page.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Page | page 1 |
The title of the page.
|
wiki-page-name |
required |
Diff | diff 2 |
The ID or keyword that is used against the base ID. Possible keywords are:
|
line |
required |
Oldid | oldid 3 |
The base ID onto which the diff is generated. Some number like "442212827" (without the quotes).
|
number |
optional |
Label | label 4 |
Text to display as link. No label will give a numbered link.
|
line |
optional |
Diffonly | diffonly |
Displays the page comparisons only. If you use this, the value should be "yes" (without the quotes).
|
line |
optional |