|
|
| Line 1: |
Line 1: |
| <bookshelf src="Book:User manual" />
| | The wiki provides a few input fields that help users to locate pages in the wiki. There are two types of these fields: '''Search''' fields '''and filter''' fields. They behave differently and it is useful to know their differences. |
| == 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 often also referred to as the page's "revision history" or "edit history." | |
|
| |
|
| == Display of the version information == | | == Title search == |
| Starting with BlueSpice 4.4, the version history is shown in a user-friendly column layout.[[Datei:Versionsgeschichte.png|alt=version history of the page der Seite " Electirc Pallet Truck Alligator"|center|thumb|750x750px|Actions in the version history (from BlueSpice 4.4)]]The following information is included:
| | {{#dpl: title=Manual:Extension/BlueSpiceExtendedSearch|include=#Title search}} |
| * '''Version:''' Speicherdatum und -uhrzeit der Version
| |
|
| |
|
| * '''Geändert von:''' Benutzername mit Link zur Profilseite
| | == Droplet == |
| * '''Differenz:''' Größenunterschied zur vorhergehenden Version. Die Größe eingebetteter Ressourcen wird hier nicht mit eingerechnet.
| |
| * '''Zusammenfassung:''' Die Zusammenfassung, die beim Speichern der Seite vom Bearbeiter angegeben wurde. Beim Anlegen der Seite sowie bei Ausführung von programmatischen Änderungen (z.B. über Workflows, Import-Aktionen oder Rücksetzungen) werden hier auch automatische Kommentare angezeigt.
| |
|
| |
|
| * '''Version:''' Timestamp of the saved version | | * '''not case-sensitive''', but search term needs to be at the beginning of a word. |
| * '''Changed by:''' Username with a link to the profile page
| | <bs:tagsearch type="wikipage" operator="AND" /> |
| * '''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 [[#Comparing versions|compare]] (1), [[#Restoring a version|restore]]] (2), [[#Reverting a version (undo)| revert]] or [[#Hiding a version|hide]] (3) versions.
| | == Content filter == |
|
| |
|
| == Comparing versions ==
| | * '''not case-sensitive,''' search term can be anywhere (also within words) |
| Um die Unterschiede von zwei Versionen zu vergleichen, werden diese über die Auswahlkästchen der ersten Spalte ausgewählt. Anschließend klicken Sie auf die Schaltfläche <code>Versionen vergleichen</code>.
| | * filter term needs to have '''at least 3 letters'''<containerfilter> |
|
| |
|
| To compare the differences between two versions, activate the associated checkboxes in the first column. Then click the <code>Compare versions</code> button.
| | </containerfilter> |
| | |
| [[Datei:Versionsgeschichte - vergleichen.png|alt=Version history with two selected versions that should be compared|center|thumb|750x750px|Comparing two versions ]]
| |
| | |
| === Wikitext ===
| |
| Hier wird anschließend jeder geänderte Absatz im [[Handbuch:Wikitext|Wikitext]]-Modus angezeigt (1). In der linken Spalte ist die ältere Version, in der rechten Spalte die neuere Version. Wenn seit der älteren Version etwas gelöscht oder ersetzt wurde, wird dies gelb und mit einem Minuszeichen markiert. Wenn in der neueren Version Inhalt hinzugefügt wurde, wird dies in der rechten Spalte blau angezeigt und mit einem Pluszeichen markiert.
| |
| | |
| Every paragraph that was changed is shown in [[Manual:Wikitext|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 but cannot be marked in the visual comparison mode (e.g., added categories). The older version can be [[#Restoring a version|restored]] by clicking on its date stamp (2).
| |
| [[File:Version history wikitext.png|alt=Comparison of changed sections of two versions in wikitext view.|center|thumb|750x750px|Version comparison in wikitext]]
| |
| | |
| === Visual ===
| |
| Switching to the visual comparison mode by clicking the <code>Visual</code> button can also provide a good overview of text changes, but is sometimes difficult to interpret or is 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.
| |
| [[File:Version history - visual comparison.png|alt=Visual version comparison of two versions of the page "Electric Pallet Truck Alligator"|center|thumb|750x750px|Visual version comparison]]
| |
| | |
| === Interactive ===
| |
| There is also an interactive “revision slider” that allows you to quickly switch between different version comparisons. The functionality is [[mediawikiwiki:Extension:RevisionSlider#Usage|documented on MediaWiki]].
| |
| [[File:Reference:revisionslider.png|alt=view of the open revision slider|center|thumb|650x650px|revision slider]]
| |
| | |
| == Restoring a version ==
| |
| To restore a specific version of the page, click that version's date stamp.
| |
| [[File:Version history - restore.png|alt=Focus on the date stamp of a version in the version history|center|thumb|500x500px|Restoring a version]]
| |
| | |
| Open the page in edit mode.
| |
| [[File:Version history - edit old version.png|alt=View of the selected version with editing icon highlighted|center|thumb|750x750px|Editing an old version]]
| |
| | |
| Sie sehen einen Hinweis, dass Sie eine veraltete Seite bearbeiten. Sie können nun an dieser Version weiterarbeiten oder die Seite ohne weitere Bearbeitung speichern. Die Version ist wiederhergestellt und die zuvor aktuelle Version ist nun nach unten "gerutscht".
| |
| | |
| Das Wiki zeigt in der Versionsgeschichte nach dem Speichern in der Zusammenfassung an, welche Version wiederhergestellt wurde.
| |
| [[Datei:Versionsgeschichte - wiederherstellung kommentar.png|alt=Reihe in der Versionsgeschichte, die den Wiederherstellungskommentar anzeigt.|center|thumb|650x650px|Wiederherstellungskommentar]]
| |
| | |
| 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 previously latest version has been "pushed down".
| |
| | |
| The version indicates in the summary column which page ID has been restored.
| |
| [[File:Version history - restore comment.png|alt=Row in the version history that displays the restore comment.|center|thumb|650x650px|Restore comment]]
| |
| | |
| | |
| == Reverting a version (undo) ==
| |
| Es ist möglich eine '''einzelne Bearbeitung''' aus dem Verlauf einer Seite rückgängig machen, ohne gleichzeitig alle seitdem vorgenommenen konstruktiven Änderungen rückgängig zu machen.
| |
| | |
| Klicken Sie dazu auf das Symbol ''Rückgängig machen'' am Zeilenende der Version, die den gewünschten Inhalt enthält.
| |
| | |
| 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 <code>Undo</code> icon at the end of the line of the version that contains the wanted content.
| |
| [[File:Versionsgeschichte - Undo-Symbol.png|alt=Left-pointing arrow icon for the "undo" action|center|thumb|180x180px|"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).
| |
| [[File:Version history undo .png|alt=Highlighted diff view of the current version with the change that should be undone|center|thumb|750x750px|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 ==
| |
| In der Spalte ''Tags'' (siehe Spalten ein- und ausblenden) ist ersichtlich, wie eine Rücksetzung vorgenommen wurde. Hier gibt es unterschiedliche Kombinationen.
| |
| [[Datei:Versionsgeschichte - Arten der Wiederherstellung.png|alt=Farblich hervorgehobene Variationen von zurückgesetzten Versionen|center|thumb|750x750px|Markierung der unterschiedlichen Rücksetzungen]]Die einzelnen Markierungen werden auf der Seite ''Spezial:Markierungen'' für das gesamte Wiki zusammengefasst. Diese Spezialseite ist über das Anklicken eines Tags aufrufbar. Auf der Spezialseite können über die Spalte "Markierte Änderungen" die jeweiligen Änderungen der letzten 90 Tage aufgerufen werden.
| |
| | |
| The ''Tags'' column (see [[#Showing or hiding columns|Showing or hiding columns]]) shows how a reversion was carried out. Different combinations are possible here.
| |
| [[File:Version History - Types of Restore.png|alt=Marked variations of reverted versions|center|thumb|750x750px|Marking of different reversions]]. The individual markings 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.
| |
| {| class="wikitable" | | {| class="wikitable" |
| |+ | | |+ |
| !Tag | | !Sun |
| !Appearance on change lists | | !Mon |
| !Description | | !Tue |
| |- | | |- |
| !mw-reverted
| | |Meat |
| |Reverted | | |Lentils |
| |Tag for all versions that were later reverted by manually saving an older version (<code>mw-manual-revert</code>) | | |Salad |
| |- | | |- |
| !mw-manual-revert
| | |Potatoes |
| |Manual revert | | |Salad |
| |An exact older version is opened and saved again (e.g., by opening it from its timestamp in the version history) | | |Meat |
| Additionally, all versions whose changes have been removed through the manual revert, are marked with the tag <code>mw-reverted</code>.
| |
| | |
| 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
| | |Soup |
| |Undo | | |Refreshment |
| |Edits that undo the changes of '''one specific previous version'''. | | |Spaghetti |
| 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 == | | == SMW datatables filter == |
| 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]]
| |
| | |
| 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 [[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]]
| |
| | |
| == 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 ===
| |
| Wenn in einem Namensraum die [[Handbuch:Erweiterung/ContentStabilization|Seitenfreigabe]] aktiviert ist, kann am Beginn der Seite angezeigt werden, wenn eine eingebundene Ressource eine neuere Version besitzt. Dies ist abhängig von den Einstellungen zu [[Handbuch:Erweiterung/ContentStabilization#Konfiguration|Änderungen an eingebundenen Ressourcen]].
| |
| | |
| If the [[Manual:Extension/ContentStabilization|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 [[Manual:Extension/ContentStabilization#Configuration|changes to embedded resources]].
| |
|
| |
|
| {{Box Links_en|Topic1=https://www.mediawiki.org/wiki/Manual:Reverts}} | | * Page titles need to be filtered with uppercase to be found. ("me" does not find page "Mention") |
| [[Category:Editing]] | | * Page titles are found even if they are preceded by a special character ("Zwei" finds "-Zwei") |
| [[de:Handbuch:Versionsgeschichte]] | | * Lowercase filter considers letters within words and at the beginning of words except for the first letter of the title ("me" finds "Book a meeting" and "Ideenmanagement", but not "Mention") |
| | * Uppercase filter considers letters at the beginning and within words ("Me" finds "Mention", "SMW Media query" and "TestMedium") |
| | {{#ask: [[Modification date::+]] [[:+]] |
| | |format=datatables |
| | }} |
Discussions