Changes for page History

Last modified by Thomas Mortagne on 2023/10/10

<
From version < 61.1 >
edited by Sakthivel Muthu
on 2017/12/31
To version < 62.1 >
edited by Vincent Massol
on 2018/01/02
>
Change comment: Fix screenshots, rewrite portions, replace Document -> Page

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Sakthivel
1 +XWiki.VincentMassol
Content
... ... @@ -6,52 +6,53 @@
6 6  
7 7  = History View =
8 8  
9 -You can see the version of a document by looking at "History" tab the bottom of the document. For example, on the following document the version is 3.1 and has last been modified by "Administrator". You can also see who last modified the document and the time the change was performed at the top of the page:
9 +When looking at a page you can see who last modified it and the time the change was performed:
10 10  
11 11  {{image reference="versioncontrol1.png"/}}
12 12  
13 -{{image reference="versioncontrol2.png"/}}
13 +You can see the versions of a page by looking at the "History" tab at the bottom. For example, on the following screenshot the last version is 8.1 and has been modified by "Administrator".
14 +
15 +{{image reference="extensionhistory-list.png"/}}
14 14  //"History" as it appears using the Flamingo Skin//
15 15  
16 -As the image shows, the document version consists of two numbers, separated by a dot: ##<Major>.<Minor>##. The XWiki versioning system allows the distinction between major and minor edits. When [[editing a page>>platform:Features.PageEditing]], the user has the option to decide whether his edit brings major or minor changes to the document. Saving a major version will increase the first component and reset the second to "1", while a minor version will just increase the second component.
18 +The page version consists of two numbers, separated by a dot: ##<Major>.<Minor>##. The XWiki versioning system allows the distinction between major and minor edits. When [[editing a page>>platform:Features.PageEditing]], the user has the option to decide whether his/her edit brings major or minor changes to the page. Saving a major version will increase the first component and reset the second to "1", while a minor version will just increase the second component.
17 17  
18 18  Clicking on the "History" button when viewing a page displays all the versions that were previously saved:
19 19  
20 -Besides listing the document versions, the history page can be used to perform other actions as well:
22 +Besides listing the page versions, the history page can be used to perform other actions as well:
21 21  
22 -* view a previous version of the document
23 -* compare any two versions
24 -* set an older version as the current version (rollback); available only if the user has edit rights on the document
25 -* delete a version completely from the history (useful for removing spam, for example); available only if the user has administration rights
26 -* delete an entire version range from the history; also available only if the user has administration rights
24 +* View a previous version of the page
25 +* Compare any two versions
26 +* Set an older version as the current version (rollback); available only if the user has edit rights on the page
27 +* Delete a version completely from the history (useful for removing spam, for example); available only if the user has administration rights
28 +* Delete an entire version range from the history; also available only if the user has administration rights
27 27  
28 -By default, minor edits do not appear in the document history. The option "Show minor edits" will list all the versions, including minor ones.
30 +By default, minor edits do not appear in the page history. The option "Show minor edits" will list all the versions, including minor ones.
29 29  
30 -Since 9.4, the history also displays the standard version of the document, as defined by the installed extension (if the document come from an extension):
31 -{{image reference="extensionhistory-list.png"/}}
32 +Since 9.4, the history also displays, on the first line, the standard version of the page, as defined by the installed Extension (if the page comes from an extension).
32 32  
33 33  = Comparing Versions =
34 34  
35 -The comparison between two document versions highlights the differences between document properties (title, content, parent, syntax, etc.), attachments, objects and class properties.
36 +The comparison between two page versions highlights the differences between page properties (title, content, parent, syntax, etc.), attachments, objects and class properties.
36 36  
37 37  In order to compare 2 versions you need to select one of the radio buttons corresponding to the version from which you want to start the comparison. These are the buttons located in the "From" column. You will then need to select the button corresponding to the version you want to compare the previously selected version against. These buttons are located in the "To" column. You may choose to include minor edits in the comparison. After selecting the 2 versions you wish to compare you will need to click on "Compare selected versions". Depending on the changes you have made you will get a result similar to this:
38 38  
39 39  {{image reference="versioncontrol3.png"/}}
40 -//"Changes for document" as they appear using the Flamingo Skin //
41 +//"Changes for page" as they appear using the Flamingo Skin //
41 41  
42 42  Note that the comparison starts with a Summary (7.0RC1+) that groups the changes in 4 categories: Page Properties, Attachments, Objects and Class Properties. A category is displayed only if there are related changes. Except for 'Page properties', the rest of the categories can be expanded to see which items have been added, deleted or modified. Each item provides a link to the details that are listed below the Summary.
43 43  
44 44  The comparison details lists all the items (page properties, attachments, objects, class properties) that have been added, deleted or modified. For each item you can see what properties have been modified and the exact modifications. For text attachments you can even see the changes made to the attachment content between two versions of the attachment (7.0RC1+). The changes made to the object properties of type Password and Email are obfuscated for privacy reasons.
45 45  
46 -Clicking on either one of the 2 compared version numbers will display that version of the document.
47 +Clicking on either one of the 2 compared version numbers will display that version of the page.
47 47  
48 48  = Viewing Previous Versions =
49 49  
50 -By clicking on a version from the ##Version## column of a document's ##History## tab you will be able to view that document's content, as it was in the selected version:
51 +By clicking on a version from the ##Version## column of a page's ##History## tab you will be able to view that page's content, as it was in the selected version:
51 51  
52 52  {{image reference="view-version.png"/}}
53 53  
54 -In this view, most actions on the page will actually affect the latest version of the page. However, the following actions (under the "More Actions" menu) will target the current version of the document you are viewing:
55 +In this view, most actions on the page will actually affect the latest version of the page. However, the following actions (under the "More Actions" menu) will target the current version of the page you are viewing:
55 55  
56 56  * Export
57 57  * Print Preview
... ... @@ -59,7 +59,7 @@
59 59  
60 60  = Blame View =
61 61  
62 -{{info}}Since 9.7RC1{{/info}}, when viewing the source of a document (by going to ##More Actions > View Source## on a document), you can enable the blame view by clicking on ##Show last authors## button. In this mode, each line of the document's content is annotated with the last author that modified it and the revision in which this modification was introduced. The blame view also works when viewing the source of a document revision (other than the latest one) so it can be accessed at any point in the history of a document.
63 +{{info}}Since 9.7RC1{{/info}}, when viewing the source of a page (by going to ##More Actions > View Source## on a page), you can enable the blame view by clicking on ##Show last authors## button. In this mode, each line of the page's content is annotated with the last author that modified it and the revision in which this modification was introduced. The blame view also works when viewing the source of a page revision (other than the latest one) so it can be accessed at any point in the history of a page.
63 63  
64 64  {{image reference="codeViewer-blameView.png"/}}
65 65  

Get Connected