RedmineWikis » History » Version 36
Alex Che, 2023-07-08 11:03
1 | 27 | Ben Blanco | h1. Wikis |
---|---|---|---|
2 | 1 | Thomas Lecavelier | |
3 | 27 | Ben Blanco | {{>toc}} |
4 | |||
5 | 28 | Mikkel Kirkgaard Nielsen | |
6 | 27 | Ben Blanco | h2. Creating a new wiki page |
7 | |||
8 | As in every wiki, just add a link to the page you want to create. |
||
9 | |||
10 | <pre>[[MyNewWikiPage]]</pre> |
||
11 | 1 | Thomas Lecavelier | |
12 | 28 | Mikkel Kirkgaard Nielsen | Save the page and click on that link: you are now editing the new wiki page with the name "MyNewWikiPage". Follow the *Edit* instructions below. |
13 | 1 | Thomas Lecavelier | |
14 | |||
15 | 27 | Ben Blanco | h2. Creating sub-pages (parent/child relationships) |
16 | |||
17 | 28 | Mikkel Kirkgaard Nielsen | It is possible to create parent/child relationships between wiki pages. This has two benefits: |
18 | * On the "[[RedmineWikis#Sidebar|Index by title]]", the page tree is sorted according to the relationships: |
||
19 | 27 | Ben Blanco | > * Guide |
20 | > ** RedmineAccounts |
||
21 | > ** RedmineCustomFields |
||
22 | > ** RedmineInstall |
||
23 | > ** RedmineIssueList |
||
24 | 1 | Thomas Lecavelier | > ** RedmineIssues |
25 | 27 | Ben Blanco | * On each child page a breadcrumb is displayed showing the location of the page within the page tree: |
26 | TODO, add image |
||
27 | |||
28 | These relations can be set by assigning a parent page to a to-be child-page. |
||
29 | 1 | Thomas Lecavelier | |
30 | 28 | Mikkel Kirkgaard Nielsen | h2. Toolbar |
31 | 1 | Thomas Lecavelier | |
32 | 28 | Mikkel Kirkgaard Nielsen | Each wiki page has a toolbar located in the upper right corner with buttons for actions to perform on the page. Depending on the [[RedmineRoles|Roles and permissions]] of the site your user might not have permission to perform some of the actions, in this case the respective button will not be displayed at all. |
33 | 1 | Thomas Lecavelier | |
34 | 28 | Mikkel Kirkgaard Nielsen | p=. !wiki-toolbar.png! |
35 | 1 | Thomas Lecavelier | |
36 | 28 | Mikkel Kirkgaard Nielsen | The actions are explained below. |
37 | 1 | Thomas Lecavelier | |
38 | 28 | Mikkel Kirkgaard Nielsen | h3. Edit |
39 | |||
40 | To edit the current contents of a wiki page click the *Edit* button. See [[RedmineTextFormatting]] for details about text annotation. The pages's parent can be changed by using the drop down box "Parent page". |
||
41 | |||
42 | h3. Watch |
||
43 | |||
44 | Clicking the *Watch* button adds you as a watcher of the page. This means you will be notified of changes to the page by email. |
||
45 | |||
46 | |||
47 | h3. Rename (or move) |
||
48 | |||
49 | To rename a wiki page or move a wiki page and its children to another project, click on the !/images/move.png! *Rename* button. |
||
50 | |||
51 | If 'Redirect existing links' is checked, existing links to the current page are redirected to the new wiki page when renamed or moved. Links to the children-pages move to other project are not redirected. To stop the redirection see a workaround in #6401#note-8. |
||
52 | |||
53 | 1 | Thomas Lecavelier | You can specify a parent page in 'Parent page'. |
54 | 27 | Ben Blanco | |
55 | You can move a page to another project by specifying the destination project in 'Project'. When moving a page, each child page is also moved unless the destination project contains a page with the same name. |
||
56 | |||
57 | 28 | Mikkel Kirkgaard Nielsen | h3. Lock (protect) |
58 | 27 | Ben Blanco | |
59 | 28 | Mikkel Kirkgaard Nielsen | Clicking the !/images/locked.png! *Lock* button locks the page, and transforms the button into !/images/unlock.png! *Unlock*. |
60 | 27 | Ben Blanco | |
61 | 28 | Mikkel Kirkgaard Nielsen | A locked wiki page can only be edited by users who have the permission to protect wiki pages, these users can also unlock it again by clicking *Unlock*. |
62 | 27 | Ben Blanco | |
63 | 28 | Mikkel Kirkgaard Nielsen | h3. Delete |
64 | |||
65 | Click *Delete* to delete the wiki page. A confirmation is needed to perform the action. |
||
66 | |||
67 | |||
68 | h3. History |
||
69 | 27 | Ben Blanco | |
70 | Redmine keeps a record of every change made to a wiki page. You can view the list of these changes by clicking on !/images/history.png! *History*. |
||
71 | |||
72 | p=. !history.png! |
||
73 | |||
74 | To view a specific version of the page click on its number. |
||
75 | |||
76 | p=. !page_version.png! |
||
77 | |||
78 | What is displayed can be misleading: @Version 31/41 (diff)@ means that you are viewing version 31 out of 41, it does not mean that the diff link will show you the differences between 31 and 41. It does show you the differences between version 30 and 31. If you're looking at version 30, you'll see Version 30/41, and the diff will show you the changes in version 30. |
||
79 | |||
80 | If you want to see differences between 40 and 41, go to the revisions list and click 'View changes' (by default, it will show the diff of the last version). |
||
81 | |||
82 | You can revert a page to a previous version by clicking on !/images/cancel.png! *Rollback to this version*, then *Save*. In that case a new page version is created without losing the wiki page history. |
||
83 | |||
84 | If you instead do want to delete all history of a wiki page you have to copy the content of that page to a safe place (copy/paste in edit window), delete the page and re-create it with the same name. Then re-insert the copied content. |
||
85 | |||
86 | h2. Sidebar |
||
87 | |||
88 | The content of the wiki page named '@Sidebar@' is rendered in the wiki sidebar if it exists. Permission to protect wiki pages is required to create this page. |
||
89 | |||
90 | The contextual sidebar on the right of any wiki page provides links to: |
||
91 | * *Start page*: Link to the [[RedmineProjectSettings#Wiki|configured start page]] of the wiki |
||
92 | * *Index by title*: Index of all the wiki pages sorted by name (and, if [[RedmineWikis#Creating-sub-pages-parentchild-relationships|configured]], by parent/child relationships) |
||
93 | |||
94 | p=. TODO, add image |
||
95 | * *Index by date*: Index of all the wiki pages sorted by date of last modification |
||
96 | |||
97 | 1 | Thomas Lecavelier | p=. TODO, add image |