Help:Diff

From The Sims Wiki, a collaborative database for The Sims series
Jump to navigation Jump to search
Information.svg
This page is a help page
It is meant to detail processes or procedures of some aspect or aspects of The Sims Wiki's norms and practices. It is not a policy page.

A diff shows the differences between two versions of a page. They allow readers and editors to see the changes made in an edit, or the cumulative changes of multiple edits to a page. Diffs can be accessed through the page history, user contributions, recent changes, and watchlists. You can also view a diff of the changes you've made while editing by clicking on the 'Show changes' button.

Accessing diffs[edit source]

  • From the page history: To view the changes made in a single edit, click on the prev button next to that edit. This will show you the changes made in that edit in comparison to the one immediately before it. To view all cumulative changes made between an older edit and the current revision of the page, click on the cur button next to the older edit. To view the cumulative changes made between any two revisions, first click on the radio button on the left column next to the older edit you want to compare, and then click on the radio button in the second column next to the newer edit. Then, click on Compare selected revisions.
  • From user contributions, watchlists and recent changes: Click on the diff button next to the edit you want to view. This will show you the changes made in that edit in comparison to the one immediately before it. The button will be greyed out if there is no previous edit to compare the edit with.

How it looks[edit source]

When you view a diff, the older version is shown on the left, while the newer version is shown on the right. The time, date, and editor of each version is shown above the diff.

(Edit summaries in diffs are great)
m (correction, + MediaWiki User's Guide)
 
Line 8: Line 8:
  For sysops and those with the rollback flag, a [[Help:Rollback|rollback]] button is shown allowing them to revert from the new version to the old one.   For sysops and those with the rollback flag, a [[Help:Rollback|rollback]] button is shown allowing them to revert from the new version to the old one.
This is only shown when viewing the diff between the current version and the one immediately preceding it. + This is only shown when viewing the diff between the recent version of a page and the last version by an author other than the one of the most current version.
  This example shows the top of the diff page, with the links described above.   This example shows the top of the diff page, with the links described above.
Line 25: Line 25:
  </table>   </table>
+ [[MediaWiki User's Guide]]
+

Explanation of colors[edit source]

Paragraphs that have changed will have a colored border, with the older revision having an orange border and the newer revision having a blue border. Inserted, modified, and removed text is highlighted with the border color and bolded. If entire paragraphs were inserted or removed, no highlighting or bolding will be applied and the other side will appear blank. Unchanged text will have a grey background. To avoid redundancy, only the unchanged text before and after the changed text will be shown.

Color key
Old version New version
unchanged unchanged
paragraph changed paragraph changed
paragraph removed  
  paragraph added
removed text added text

Controls and links[edit source]

First row[edit source]

By default, the most recent revision (the one on the right) is rendered and shown below the diff. To view the older revision (the one on the left), click on the "Revision as of date" link above the diff on the left. This will provide you with a permanent link to that revision of the page.

Clicking "edit" will take you to the editing window with the contents of that particular revision. You may be warned that you are editing an out-of-date revision. If you save your edits here, you will revert all the changes made since that revision (they will still appear in the page history if you do this).

Clicking "undo" will undo that specific edit. This will revert the changes made in that edit without affecting the changes done in other edits, if possible.

The "thank" button will only appear if you are logged in and the other user is a registered user. This sends them a short "Thank you" notification as an appreciation for their work.

Second row[edit source]

The username or IP address of the editor will be shown, along with a "talk" and "contribs" link. If the editor is a registered user, clicking on their username will take you to their userpage, and clicking on the "talk" and "contribs" links will take you to their user talk page and user contributions, respectively. If the editor is not registered, their IP address will be displayed, and clicking on their IP address will take you to their user contributions.

Third row[edit source]

If the editor left an edit summary with their edit, this will be shown here in parenthesis. If the editor marked their edit as a minor edit, a bolded m will appear here as well.

Fourth row[edit source]

Clicking on the "Previous edit" link will take you to the next older diff in the page history, while clicking "Next edit" will take you to the next newer diff. If you are viewing the diff of multiple consecutive edits, a "x intermediate revisions by y users not shown" will also be shown here.

Linking to diffs[edit source]

The URL of a diff contains two parameters, each formatted in the form &parameter=value. The URL of a diff will look something like this:

www.thesimswiki.com/w/index.php?title=Pagename&diff=number&oldid=number

The &diff= parameter shows the revision ID for the later revision (shown on the right). The &oldid= parameter shows the revision ID for the earlier revision (shown on the left). If diff is set to cur, the revision specified in oldid will be compared to the most recent revision of the page, and if diff is set to prev, the revision in oldid will be compared to the revision preceding it. If diff is set to any revision ID and oldid is excluded, the revision specified in diff will be compared to the revision preceding it.

The easiest way to link to a diff is to copy and paste the full URL. However, this can be lengthy and doesn't work in edit summaries. A better alternative is to use regular wikilinks by linking to [[Special:Diff/diff]], replacing diff with the revision ID specified after the diff URL parameter. For example, typing in [[Special:Diff/1234]] will provide a link to the diff page comparing revision 1234 with the preceding revision on the same page. You can also link to diffs that use the oldid parameter by linking to [[Special:Diff/oldid/diff]]. Doing this, typing [[Special:Diff/1234/4567]] will provide a link comparing revision 1234 (shown on the left) with revision 4567 (shown on the right).

Examples[edit source]

  • www.thesimswiki.com/w/index.php?title=Foo&diff=1001&oldid=998
    • Shows a diff comparing revision 998, shown on the left, with revision 1001, shown on the right.
  • www.thesimswiki.com/w/index.php?diff=1001&oldid=998
    • Same as above (title is not a required parameter for links to diffs to work).
  • [[Special:Diff/998/1001]]
    • Same as above.
  • www.thesimswiki.com/w/index.php?diff=2315
    • Shows a diff comparing revision 2315, shown on the right, with the revision preceding it, shown on the left.
  • [[Special:Diff/2315]]
    • Same as above.
  • www.thesimswiki.com/w/index.php?oldid=3214
  • [[Special:PermanentLink/3214]]
    • Same as above.

Deleted revisions[edit source]

Sometimes, administrators may need to hide the contents of certain revisions from view using revision deletion. Only administrators can view a diff if it contains a revision that has been hidden from public view.

If a page gets deleted, all revisions will be removed from public view, and as such, all diffs relating to revisions in that page will no longer be publicly accessible.

Both revision deletion and page deletion can be reversed at any time.

See also[edit source]