Template:Diff
This template is used on many pages, and changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in a user subpage, and consider discussing changes at the talk page before implementing them. |
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 timestamp link for the edit. The timestamp link is in this form:Template:Brk
http[s]://en.WikiDevi.org/w/index.php?title=SomePageName&oldid=442212827
Template:Brk
The number after oldid=
is the revision ID.
Given one or two revision IDs, you can construct links to several types of diffs.
Usage
{{Diff|title|diff|oldid|label|diffonly=yes}}
title
Template:SndsThe title of the page (optional in most cases).diff
Template:SndsThe ID or keyword that is used against the base ID. Possible keywords are:cur
Template:Sndscompare with the current version of a page.prev
Template:Sndscompare with the previous version of a page.next
Template:Sndscompare with the next version of a page.- idTemplate:SndsThis should be larger than
oldid
.
oldid
Template:SndsThe base ID onto which the diff is generated.label
Template:SndsText to display as link (optional)Template:Nsmdnsno label will generate a numbered link as the label.|diffonly=yes
Template:SndsDisplays the page comparisons only (optional)Template:Nsmdnsparameter name required if used.
Only the diff parameter is required; all other parameters are optional. Omitted parameters must be empty (by using a double pipe). You can also use the named parameters title
, 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 Template:Uu
. When a parameter is left blank, the resulting two adjacent pipes are underlined (but not bolded): ||
.
Code | Output |
---|---|
{{Template:Uu|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.
|
{{Template:Uu|Main Page|204901573|202506579|Diff between two numbered versions of a page}}
|
Diff between two numbered versions of a page
|
{{Template:Uu|WikiDevi:Pagediff|204934693|204901573|Diff between two numbered versions of a page in WikiDevi namespace}}
|
Diff between two numbered versions of a page in WikiDevi namespace
|
{{Template:Uu|Main Page|next|204901573|Diff between a numbered version and the subsequent version}}
|
Diff between a numbered version and the subsequent version
|
{{Template:Uu|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
|
{{Template:Uu|Main Page|cur||Diff showing the most recent change to a page}}
|
Diff showing the most recent change to a page
|
{{Template:Uu|Main Page||204901573|A link to a numbered version of a page}}
|
A link to a numbered version of a page
|
{{Template:Uu|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
|
TemplateData
See also
- {{Oldid}} – simplifies the case for linking to a known old version
- {{Diff2}} – same as {{Diff}}, but assumes a diff between the given revision and the one immediately before
- {{Diff3}}
- {{Diff4}}
- {{Url to diff}} - takes a diff URL and makes a {{Diff}} template
- {{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.
The above documentation is transcluded from Template:Diff/doc. (edit | history) Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages. Please add categories to the /doc subpage. Subpages of this template. |