Misplaced Pages

Revision as of 15:25, 30 July 2011

This template is used on approximately 31,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Any breaking changes to this template, including moving it or nominating it for deletion, must be communicated in advance to Twinkle's users and maintainers at Misplaced Pages talk:Twinkle. The standard installation of Twinkle relies on this template. Thank you.

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:
http://en.wikipedia.org/search/?title=SomePageName&oldid=442212827
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 – The title of the page (optional in most cases)
• 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 (optional)‍—‌no label will generate a numbered link as the label.
• |diffonly=yes – Displays the page comparisons only (optional)‍—‌parameter 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.

Helper subtemplate

In order to make this template simpler to use the helper subtemplate {{Diff/translator}} is available, to be used only in the preview window.

Syntax

{{Diff/translator|label|url=diff URL}}

For instance, imagine you want to refer to the following diff URL: https://en.wikipedia.org/search/?title=Main_Page&diff=139993&oldid=139992&diffonly=1; you only need to transcribe that URL in the {{Diff/translator}} subtemplate and produce a preview, without saving the page:

{{Diff/translator|Sic exorsi sumus|url=https://en.wikipedia.org/search/?title=Main_Page&diff=139993&oldid=139992&diffonly=1}}

↳ {{Diff|Main Page|139993|139992|Sic exorsi sumus|diffonly=yes}}

Now copy the code generated ({{Diff|Main Page|139993|139992|Sic exorsi sumus|diffonly=yes}}) into the edit window where {{Diff/translator}} was and publish the page.

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): ||.

TemplateData

TemplateData for Diff

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}} – same as {{Diff2}}, but does not support section links
• {{Diff4}}
• {{URL to diff}} – takes a diff URL and makes a {{Diff}} template
• {{Diffsandbox}} – compares a given page with the sandbox version
• {{DiffPages}} – accepts two pagenames (no id's needed)
• {{Querylink}} – generic template to construct query strings
• diff utility – syntax highlight on wiki pages with mw:Extension:SyntaxHighlight GeSHi
• Special:Diff serves a similar purpose; see Help:Wiki markup#Linking to old revisions of pages, diffs, and specific history pages.
• {{TextDiff}}
• {{Url to title}}

• Templates used by Twinkle
• Diff templates
• Special page templates