Template: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 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=442212827Template: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}}

• titleTemplate:SndsThe title of the page (optional in most cases).
• diffTemplate:SndsThe ID or keyword that is used against the base ID. Possible keywords are:

  curTemplate:Sndscompare with the current version of a page.

  prevTemplate:Sndscompare with the previous version of a page.

  nextTemplate:Sndscompare with the next version of a page.

  idTemplate:SndsThis should be larger than oldid.

• oldidTemplate:SndsThe base ID onto which the diff is generated.
• labelTemplate:SndsText to display as link (optional)Template:Nsmdnsno label will generate a numbered link as the label.
• |diffonly=yesTemplate: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}} {{Template:Uu|page|prev|oldid|label}}	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.
{{Template:Uu|Main Page|204901573|202506579|Diff between two numbered versions of a page}} {{Template:Uu|page|diff|oldid|label}}	Diff between two numbered versions of a page The title= 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.
{{Template:Uu|WikiDevi:Pagediff|204934693|204901573|Diff between two numbered versions of a page in WikiDevi namespace}} {{Template:Uu|page|diff|oldid|label}}	Diff between two numbered versions of a page in WikiDevi namespace The title= parameter (parameter number 1) should be a name of a page, for instance WikiDevi: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).
{{Template:Uu|Main Page|next|204901573|Diff between a numbered version and the subsequent version}} {{Template:Uu|page|next|oldid|label}}	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.
{{Template:Uu|Main Page|cur|204901573|Diff between a numbered version and the current version of a page}} {{Template:Uu|page|cur|oldid|label}}	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.
{{Template:Uu|Main Page|cur||Diff showing the most recent change to a page}} {{Template:Uu|page|cur||label}}	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.
{{Template:Uu|Main Page||204901573|A link to a numbered version of a page}} {{Template:Uu|pageTemplate:Uuoldid|label}}	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.
{{Template:Uu|Main Page|204901573|202506579|Comparison display without page display of two numbered versions of a page |diffonly=yes}} {{Template:Uu|page|diff|oldid|label|diffonly=yes}}	Comparison display without page display of two numbered versions of a page The title= 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 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.