2.8 Version history

No edit summary
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
<bookshelf src="Book:User manual" />
<bookshelf src="Book:User manual" />
== Introduction ==
 
The wiki shows a list of all versions of a page that were created each time the page was saved. These versions are listed in the ''Version history'' and can be compared with each other. Another important feature is that users can easily restore any version if needed. The version history is also referred to as the page's "revision history" or "edit history."
The wiki shows a list of all versions of a page that were created each time the page was saved. These versions are listed in the ''Version history'' and can be compared with each other. Another important feature is that users can easily restore any version if needed. The version history is also referred to as the page's "revision history" or "edit history."


Line 87: Line 87:
*Edits that undo the changes of '''one specific previous version via the undo icon.'''
*Edits that undo the changes of '''one specific previous version via the undo icon.'''
*The tag is '''not assigned if''' manual changes need to be made during the undo action.
*The tag is '''not assigned if''' manual changes need to be made during the undo action.
*The '''version ID''' whose changes were undone is indicated in the summary.
*The '''version ID''' whose changes were undone is indicated in the '''summary'''.
|}
|}


Line 93: Line 93:
Users with admin rights also see a trash can symbol at the end of each line.
Users with admin rights also see a trash can symbol at the end of each line.


[[File:Version history - hide version.png|center|thumb|450x450px|alt=hiding a version|Hiding version info]]
[[File:Version history - hide version.png|center|thumb|750x750px|alt=hiding a version|Hiding version info]]


You can use this to hide the following properties of a version (also called “delete”) (1):
You can use this to hide the following properties of a version (also called “delete”) (1):
Line 106: Line 106:
==Showing or hiding columns==
==Showing or hiding columns==
In some cases, you may want to customize the column view, for example to show the "Tags" column. Click on the gear icon at the end of the version history. In addition to the standard columns, the "Size" (page size) and [[mediawikiwiki:Manual:Tags|"Tags"]] columns can also be displayed.
In some cases, you may want to customize the column view, for example to show the "Tags" column. Click on the gear icon at the end of the version history. In addition to the standard columns, the "Size" (page size) and [[mediawikiwiki:Manual:Tags|"Tags"]] columns can also be displayed.
[[File:Version history settings.png|alt=Last rows of the version history with the column menu open|center|thumb|550x550px|Hide columns]]
[[File:Version history settings.png|alt=Last rows of the version history with the column menu open|center|thumb|250x250px|Hide columns]]


==Changes to embedded resources==
==Changes to embedded resources==

Latest revision as of 16:03, 13 February 2024

The wiki shows a list of all versions of a page that were created each time the page was saved. These versions are listed in the Version history and can be compared with each other. Another important feature is that users can easily restore any version if needed. The version history is also referred to as the page's "revision history" or "edit history."

Display of the version information

Starting with BlueSpice 4.4, the version history is shown in a user-friendly column layout.


version history of the page der Seite " Electirc Pallet Truck Alligator"
Actions in the version history (from BlueSpice 4.4)

The following information is included:

  • Version: Timestamp of the saved version
  • Changed by: Username with a link to the profile page
  • Difference: Size difference from the previous version. The size of embedded resources is not taken into account here.
  • Summary: The summary provided by the editor when the page was saved. Automatic comments are also displayed during page creation and when programmatic changes are made (e.g., via workflows, import actions or reverts).

There are some interactive functions in the version history that allow to compare (1), restore (2), revert or hide (3) versions.

Comparing versions

To compare the differences between two versions, activate the associated checkboxes in the first column. Then click the Compare versions button.

Version history with two selected versions that should be compared
Comparing two versions

Wikitext

Every paragraph that was changed is shown in Wikitext mode (1). The older version is in the left column and the newer version is in the right column. If something has been deleted or replaced since the older version, it is highlighted in yellow and marked with a minus sign. If content was added in the newer version, it is shown in blue in the right column and marked with a plus sign.

The wikitext view is useful when comparing versions, because some changes are only visible in source view. Changes that cannot be marked in the visual comparison mode are added categories or page settings (behavior switches, display titles, etc.). The older version can be restored by clicking on its date stamp (2).

Comparison of changed sections of two versions in wikitext view.
Version comparison in wikitext

Visual

Switching to the visual comparison mode by clicking the Visual button can also provide a good overview of text changes, but is sometimes difficult to interpret. The canges are often displayed incompletely, e.g. in the case of changes to tables or other special content. Content that has been removed is highlighted in red and content that has been added since the comparison version is highlighted in turquoise.

Visual version comparison of two versions of the page "Electric Pallet Truck Alligator"
Visual version comparison

Interactive

There is also an interactive “revision slider” that allows you to quickly switch between different version comparisons. The functionality is documented on MediaWiki.

view of the open revision slider
revision slider

Restoring a version

To restore a specific version of the page, click that version's date stamp.

Focus on the date stamp of a version in the version history
Restoring a version

Open the page in edit mode.

View of the selected version with editing icon highlighted
Editing an old version

You will see a notice that you are editing an outdated page. You can now continue working on this version or save the page without further editing. The version has now been restored and the most recent version has been "pushed down".

The version indicates in the summary column which page ID has been restored.

Row in the version history that displays the undo comment.
Restore comment

Reverting a version (undo)

It is possible to undo a single edit (= single version) from the history of a page without simultaneously undoing all the constructive changes made since then.

To do this, click on the Undo icon at the end of the line of the version that contains the wanted content.

Left-pointing arrow icon for the "undo" action
"Undo"

If the affected change can be reverted without affecting other changes made in the meantime, this will be indicated accordingly at the beginning of the page (1). The affected sections are compared in two columns (diff view) (2). On the left is the current version whose edit is to be removed and on the right is the older version whose edit is to be restored. Additionally, further changes can be made via an editing window at the bottom of the page (3).

Highlighted diff view of the current version with the change that should be undone
Reverting only the changes of a specific version (undo)

This feature eliminates the need to manually redo useful changes made after the undone edit.

However, this will fail if undoing the edit would conflict with subsequent edits. For example, if Edit 1000 adds a paragraph and Edit 1005 changes that paragraph, it is not possible to automatically undo Edit 1000. In this case, you will need to determine how to fix the problem manually.

Tracking restored and reverted versions

The Tags column (see Showing or hiding columns) shows how a reversion was carried out. Different combinations are possible here.

Marked variations of reverted versions
Marking of different reversions

The individual tags are listed on the page Special:Tags. Click on any of the tags to load the page. Here, the respective changes for the last 90 days can be accessed via the “Tagged changes” column.

Meaning of the revision tags
Tag Appearance on change lists Description
mw-reverted Reverted
  • Tag for all versions that were later reverted by mw-manual-revert or mw-undo.
mw-manual-revert Manual revert
  • An exact older version is opened and saved again (e.g., by opening it from its timestamp in the version history).
  • The tag is not assigned if manual changes need to be made during the revert action.
  • The wiki will sometimes indicate in the summary which version was restored. However, since this is often not possible, a comment with the restored version ID should be provided as a summary when saving.
mw-undo Undo
  • Edits that undo the changes of one specific previous version via the undo icon.
  • The tag is not assigned if manual changes need to be made during the undo action.
  • The version ID whose changes were undone is indicated in the summary.

Hiding a version

Users with admin rights also see a trash can symbol at the end of each line.

hiding a version
Hiding version info

You can use this to hide the following properties of a version (also called “delete”) (1):

  • Text of the version: When you click on the date stamp of the version, a message appears stating that the version has been deleted.
  • Edit summary: The edit summary is hidden.
  • Username/IP address of the editor: The username is hidden.

Admins can restore this hidden information at any time via the deletion log (2) or via the "deleted versions" link (3).


Showing or hiding columns

In some cases, you may want to customize the column view, for example to show the "Tags" column. Click on the gear icon at the end of the version history. In addition to the standard columns, the "Size" (page size) and "Tags" columns can also be displayed.

Last rows of the version history with the column menu open
Hide columns

Changes to embedded resources

Changes to embedded resources (e.g., newer versions of images or templates) cannot be displayed via the page's version comparison because resources have their own versioning page.

Special considerations for pages with approval feature

If the approval feature is activated in a namespace, it is possible to indicate at the beginning of an approved page if an embedded resource has a newer version. This depends on the configuration for changes to embedded resources.

Related info




To submit feedback about this documentation, visit our community forum.