Difference between revisions of "Template:Diff/doc"
imported>Jonesey95 (Undid revision 996287951 by 2804:D55:5247:4400:8449:7D34:5DA0:2A0B (talk). vandalism) |
|||
| (15 intermediate revisions by 15 users not shown) | |||
| Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
| + | {{Twinkle standard installation}} | ||
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. --> | <!-- Categories go at the bottom of this page and interwikis go in Wikidata. --> | ||
| − | {{High-use| | + | {{High-use| 23301 }} |
This template is intended to be useful for creating links to "[[Help:Diff|diffs]]"; that is, links to pages that show the differences between two versions of a wiki page. | This template is intended to be useful for creating links to "[[Help:Diff|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 [[Help:Page history|history]] of the page by looking at the timestamp link for the edit. The timestamp link is in this form: | + | Every version of a page has a revision ID, which you can find from the [[Help:Page history|history]] of the page by looking at the timestamp link for the edit. The timestamp link is in this form:<br /> |
| − | <code>http[s]://en.wikipedia.org/w/index.php?title=SomePageName&oldid=442212827</code> | + | <code>http[s]://en.wikipedia.org/w/index.php?title=SomePageName&oldid=442212827</code><br /> |
The number after <code>oldid=</code> is the revision ID. | The number after <code>oldid=</code> is the revision ID. | ||
| Line 71: | Line 72: | ||
|- | |- | ||
| <code><nowiki>{{</nowiki>'''{{uu|Diff}}'''<nowiki>|</nowiki>''Main Page''<nowiki>|</nowiki>'''<u>cur<nowiki>||</nowiki></u>'''''Diff showing the most recent change to a page''<nowiki>}}</nowiki></code> | | <code><nowiki>{{</nowiki>'''{{uu|Diff}}'''<nowiki>|</nowiki>''Main Page''<nowiki>|</nowiki>'''<u>cur<nowiki>||</nowiki></u>'''''Diff showing the most recent change to a page''<nowiki>}}</nowiki></code> | ||
| − | :: ''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{uu|Diff}}'''<nowiki>|</nowiki>page<nowiki>|</nowiki>''' | + | :: ''<code>{{font color|brown|<nowiki>{{</nowiki>'''{{uu|Diff}}'''<nowiki>|</nowiki>page<nowiki>|</nowiki><u>'''cur'''<nowiki>||</nowiki></u>label<nowiki>}}</nowiki>}}</code>'' |
| {{Diff|Main Page|cur||Diff showing the most recent change to a page}} | | {{Diff|Main Page|cur||Diff showing the most recent change to a page}} | ||
* The '''diff=''' parameter (parameter number 2) should be the word '''cur'''. | * The '''diff=''' parameter (parameter number 2) should be the word '''cur'''. | ||
| Line 139: | Line 140: | ||
"4" | "4" | ||
] | ] | ||
| − | } | + | } |
}, | }, | ||
"description": "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.", | "description": "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.", | ||
| Line 165: | Line 166: | ||
* [[Special:Diff]] serves a similar purpose; see [[Help:Wiki markup#Linking to old revisions of pages, diffs, and specific history pages]]. | * [[Special:Diff]] serves a similar purpose; see [[Help:Wiki markup#Linking to old revisions of pages, diffs, and specific history pages]]. | ||
| − | <includeonly>{{ | + | <includeonly>{{Sandbox other|| |
<!-- Categories go here and interwikis go in Wikidata. --> | <!-- Categories go here and interwikis go in Wikidata. --> | ||
[[Category:Diff templates]] | [[Category:Diff templates]] | ||
[[Category:Special page templates]] | [[Category:Special page templates]] | ||
}}</includeonly> | }}</includeonly> | ||
Latest revision as of 19:59, 25 December 2020
| This is a documentation subpage for Template:Diff. It contains usage information, categories and other content that is not part of the original template page. |
| If you plan to make breaking changes to this template, move it, or nominate it for deletion, please notify Twinkle's users and maintainers at Wikipedia talk:Twinkle as a courtesy, as this template is used in the standard installation of Twinkle. Thank you! |
| This template is used on approximately 27,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.
Transclusion count updated automatically (see documentation). |
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.
Contents
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}}
|
Diff between a numbered version and the previous version
This is the form that would be used most often.
|
{{Template:Uu|Foobar|616706711|616706707|Diff between two numbered versions of a page}}
|
Diff between two numbered versions of a page
|
{{Template:Uu||616706711|616706707|Diff between two numbered versions of a page without title parameter}}
|
Diff between two numbered versions of a page without title parameter
|
{{Template:Uu|Wikipedia:Pagediff|204934693|204901573|Diff between two numbered versions of a page in Wikipedia namespace}}
|
Diff between two numbered versions of a page in Wikipedia 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
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.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| title | title page 1 | The title of the page. | Page | optional |
| Diff | diff 2 | The ID or keyword that is used against the base ID. Possible keywords are:
| Line | required |
| Oldid | oldid 3 | The base ID onto which the diff is generated. Some number like "442212827" (without the quotes). | Number | optional |
| Label | label 4 | Text to display as link. No label will give a numbered link. | Line | optional |
| Diffonly | diffonly | Displays the page comparisons only. If you use this, the value should be "yes" (without the quotes). | Line | optional |
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
- {{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
- User:Scottywong/diffconverter, a tool for converting from raw form
- Special:Diff serves a similar purpose; see Help:Wiki markup#Linking to old revisions of pages, diffs, and specific history pages.