Template:Diff

From imedwiki
Jump to navigation Jump to search

[1]

Template documentation[view] [edit] [history] [purge]

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[s]://en.wikipedia.org/w/index.php?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
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
The title of the page (optional in most cases).
  • diff
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
The ID or keyword that is used against the base ID. Possible keywords are:
  • cur
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
compare with the current version of a page.
  • prev
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
compare with the previous version of a page.
  • next
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
compare with the next version of a page.
  • id
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
This should be larger than oldid.
  • oldid
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
The base ID onto which the diff is generated.
  • label
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
Text to display as link (optional)
  1. REDIRECT Template:Zero width joiner em dash zero width non joiner
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
no label will generate a numbered link as the label.
  • |diffonly=yes
  1. REDIRECT Template:Spaced en dash space
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
Displays the page comparisons only (optional)
  1. REDIRECT Template:Zero width joiner em dash zero width non joiner
  • From a shortcut: This is a redirect from a shortcut in any namespace to a page in any namespace except template namespace.
    • Shortcuts are wikilinked on community pages, talk pages, and edit summaries, but not in mainspace articles.
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.

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

  1. REDIRECT Template:Underline. When a parameter is left blank, the resulting two adjacent pipes are underlined (but not bolded): ||.
Code Output
{{
  1. REDIRECT Template:Underline|Main Page|prev|204901573|Diff between a numbered version and the previous version}}
{{'
  1. REDIRECT Template:Underline'|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.
{{
  1. REDIRECT Template:Underline|Foobar|616706711|616706707|Diff between two numbered versions of a page}}
{{'
  1. REDIRECT Template:Underline'|page title|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 Foobar.
  • The diff= parameter (parameter number 2) should be the larger revision number.
  • The oldid= parameter (parameter number 3) should be the smaller revision number.
{{
  1. REDIRECT Template:Underline||616706711|616706707|Diff between two numbered versions of a page without title parameter}}
{{'
  1. REDIRECT Template:Underline'||diff|oldid|label}}
Diff between two numbered versions of a page without title parameter
  • The title= parameter (parameter number 1) may be left blank, thereby leaving a double pipe.
  • The diff= parameter (parameter number 2) should be the larger revision number.
  • The oldid= parameter (parameter number 3) should be the smaller revision number.
{{
  1. REDIRECT Template:Underline|Wikipedia:Pagediff|204934693|204901573|Diff between two numbered versions of a page in Wikipedia namespace}}
{{'
  1. REDIRECT Template:Underline'|page|diff|oldid|label}}
Diff between two numbered versions of a page in Wikipedia namespace
  • The title= 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).
{{
  1. REDIRECT Template:Underline|Main Page|next|204901573|Diff between a numbered version and the subsequent version}}
{{'
  1. REDIRECT Template:Underline'|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.
{{
  1. REDIRECT Template:Underline|Main Page|cur|204901573|Diff between a numbered version and the current version of a page}}
{{'
  1. REDIRECT Template:Underline'|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.
{{
  1. REDIRECT Template:Underline|Main Page|cur||Diff showing the most recent change to a page}}
{{'
  1. REDIRECT Template:Underline'|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.
{{
  1. REDIRECT Template:Underline|Main Page||204901573|A link to a numbered version of a page}}
{{'
  1. REDIRECT Template:Underline|page
  2. REDIRECT Template:Underlineoldid|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.
{{
  1. REDIRECT Template:Underline|Main Page|204901573|202506579|Comparison display without page display of two numbered versions of a page |diffonly=yes}}
{{'
  1. REDIRECT Template:Underline'|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

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for Diff

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

ParameterDescriptionTypeStatus
titletitle page 1

The title of the page.

Pageoptional
Diffdiff 2

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.
  • <var>id</var> – compare against this revision ID; should be <em>larger</em> than <code>oldid</code>.

Linerequired
Oldidoldid 3

The base ID onto which the diff is generated. Some number like "442212827" (without the quotes).

Numberoptional
Labellabel 4

Text to display as link. No label will give a numbered link.

Lineoptional
Diffonlydiffonly

Displays the page comparisons only. If you use this, the value should be "yes" (without the quotes).

Lineoptional

See also

This template is based (in parts) on the Template:Diff from the free encyclopedia wikipedia and is licensed under GNU license for free documentation and the Creative Commons Attribution/Share Alike. On wikipedia there is a List of authors accessible. More about importing from wikipedia on page Imedwiki:Importing from wikipedia.