Fyrimynd:Diff/doc

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.

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

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. The diff= parameter (parameter number 2) should be the word prev. The oldid= parameter (parameter number 3) should be the known revision number.
{{Diff|Main Page|204901573|202506579|Diff between two numbered versions of a page}}	Diff between two numbered versions of a page The page= parameter (parameter number 1) should be a name of a page, for instance Main Page. The diff= parameter (parameter number 2) should be the larger revision number. The oldid= parameter (parameter number 3) should be the smaller revision number.
{{Diff|Wikipedia:Pagediff|204934693|204901573|Diff between two numbered versions of a Pagediff page in Wikipedia namespace}}	Diff between two numbered versions of a Pagediff page in Wikipedia namespace The page= parameter (parameter number 1) should be a name of a page, for instance Wikipedia:Pagediff. The diff= parameter (parameter number 2) should be the page revision to appear on the right (proposed change). The oldid= parameter (parameter number 3) should be the page revision to appear on the left (original).
{{Diff|Main Page|next|204901573|Diff between a numbered version and the subsequent version}}	Diff between a numbered version and the subsequent version The diff= parameter (parameter number 2) should be the word next. The oldid= parameter (parameter number 3) should be the known revision number.
{{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 The diff= parameter (parameter number 2) should be the word cur. The oldid= parameter (parameter number 3) should be the known revision number.
{{Diff|Main Page|cur||Diff showing the most recent change to a page}}	Diff showing the most recent change to a page The diff= parameter (parameter number 2) should be the word cur. The oldid= parameter (parameter number 3) should be empty.
{{Diff|Main Page||204901573|A link to a numbered version of a page}}	A link to a numbered version of a page The diff= parameter (parameter number 2) should be empty. The oldid= parameter (parameter number 3) should be the known revision number. The result is not actually a diff, so this might be considered misuse of the template. See the {{oldid}} template.
{{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 The page= parameter (parameter number 1) should be a name of a page, for instance Main Page. The diff= parameter (parameter number 2) should be the larger revision number. The oldid= parameter (parameter number 3) should be the smaller revision number. The diffonly= parameter, which must include the parameter name, can only be set to yes

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 – 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.

Template parameters

Parameter		Description	Type	Status
Page	page	The title of the page.	Page name	required
Diff	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.	Line	required
Oldid	oldid	The base ID onto which the diff is generated. Some number like "442212827" (without the quotes).	Number	optional
Diffonly	diffonly	Displays the page comparisons only. If you use this, the value should be "yes" (without the quotes).	Line	optional
Label	label	Text to display as link. No label will give a numbered link.	Line	optional
id	id	The ID to be compared with the base oldid. To be included ONLY if the parameter "diff" is NOT specified. This should be *larger* than <tt>oldid</tt>. Some number like "442212827" (without the quotes).	Number	optional