Project

General

Profile

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