Wiki source code of Document Lifecycle

Version 96.1 by Raluca Moisa on 2010/12/15

Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 XWiki offers to perform several actions on a document (a.k.a a page).
6
7 = Create =
8
9 There are four ways to create new pages:
10
11 * You can **edit an existing page and create a link to your new page** (either in Wiki mode or in WYSIWYG mode). The resulting link will show up with a question mark next to it, showing it as a nonexistent page. Simply click on the link to create the page.(((
12 [[image:CreateInWYSIWYG.PNG||style="border: 1px solid black;"]]
13
14 This will take you to a page with a message to create the missing page (as presented above).**This is the recommended approach** as it'll allow you to create a navigation while you create new pages.
15 )))
16 * Starting with the [[Colibri skin>>extensions:Extension.Colibri Skin]] you can create a new page straight from the menu at the top of the page.(((
17 [[image:CreateMenu.PNG||style="border: 1px solid black;"]]
18 If you hover over the "Main" menu and click on "Create Page" the following will appear:
19
20 [[image:CreateInMenu.PNG||style="border: 1px solid black;"]]
21 Make sure you type the Space name in the first field, then add the Page name in the second field. Click the "Create" button and you will be able to edit your newly created page right away.
22 )))
23 * Starting with [[XWiki 2.6>>http://www.xwiki.org/xwiki/bin/view/Main/Download]] you can create a new page using the add menu:(((
24 [[image:AddPage.png||height="183" width="650"]]
25 )))Choose the page name and the space you want to create it into and click the "**Create**" button:
26
27 [[image:CreatePage.png||height="202" width="650"]]
28
29 * You can also **enter the new page name directly in the URL of your browser**. For example http://locahost:8080/xwiki/bin/view/SpaceName/PageName. If the space (##SpaceName## here) or page (##PageName## here) don't exist then you'll get an empty page with a message saying that the page doesn't exist and there'll be a link to create it :(((
30 [[image:CreateInURL.PNG||style="border: 1px solid black;"]]
31 )))
32
33 Starting with XWiki Enterprise 2.4 M2 users and applications can provide documents that can be used as template when creating new pages. The new document content (content, objects and other metadata) will be replicated from the template.
34
35 * After you have [[created the template and the template provider>>extensions:Extension.Administration Application]] you can go then start creating pages from this template:(((
36 [[image:1gcreatedocument.jpg||style="border: 1px solid black;"]]
37 )))
38
39 * This example shows that "Wanted Links" also offers the choice to create the new document from the available template ("My Template" template in the image below):(((
40 [[image:1ipopup.jpg||style="border: 1px solid black;"]]
41
42 = Edit =
43
44 This allows the editing of a page. See the [[page editing>>Features.PageEditing]] tutorial for more details.
45
46 = Show =
47
48 Whenever you click on a link to a page XWiki automatically shows the page in view mode. This is the default mode. XWiki also supports displaying the page in other formats that may be more adapted to specific circumstances:
49
50 {{toc start="2" depth="2" numbered="false" scope="page"/}}
51
52 == Code ==
53
54 You can view the content of a page without having to edit it (and thus you don't need edit rights). This option is shown only for users in [[Advanced Mode>>Features.PageEditing#HAdvancedMode]].
55
56 To see the code when using the Colibri skin, you have to go to the More Actions menu, and click on the View Source.
57
58 [[image:WikiCodeColibri.png||style="border: 1px solid black;"]]
59 [[image:WikiCodeResultColibri.png||style="border: 1px solid black;"]]
60
61 When using the Toucan skin, you do this by moving the mouse over the View Source button under View menu.
62
63 [[image:WikiCode.PNG||style="border: 1px solid black;"]]
64 [[image:WikiCodeResult.PNG||style="border: 1px solid black;"]]
65
66 == XML ==
67
68 XWiki allows exposing a page in XML. This is not ordinarily useful, but it can prove useful for example if you want to write a tool that automatically parses the content of a page. As the XML format is well-defined for all pages, this is much easier than doing screen-scrapping for example. In addition this XML format is used internally by XWiki for performing imports/exports of pages and whole wikis.
69
70 == Comments ==
71
72 Users with the comment right can leave comments on pages. This allows them to provide feedback without requiring edit rights.
73
74 Starting with XWiki 2.6 you can add a comment using the add menu:
75
76 [[image:AddComment.png||height="196" width="650"]]
77
78 On Colibri skin
79 [[image:CommentsColibri.PNG||style="border: 1px solid black;"]]
80
81 On Toucan skin
82 [[image:CommentsToucan.PNG||style="border: 1px solid black;"]]
83
84 == Attachments ==
85
86 A page can contain attachments. See [[Attachments>>Features.Attachments]] for more details.
87
88 == History ==
89
90 Displays the version history of the page. See [[Version Control>>Features.VersionControl]] for more details.
91
92 == Attributes ==
93
94 Displays a page's properties.
95
96 {{warning}}
97 The Attributes view is a work in progress
98 {{/warning}}
99
100 = Print =
101
102 There are several possible printing options (what you see may vary depending on the Skin used).
103
104 When using the Colibri Skin, you will find the Print Preview button on the top menu by hovering over More Actions:
105
106 * Print Preview: Generates a page which is formatted so that it can be easily printed using your browser's Print feature.(((
107 [[image:NewColibriPrintPreview.png||height="150" width="650"]]
108 )))
109
110 Under the Toucan skin the following options are found in the Print menu at the top:
111
112 * Print: Calls you're browser's Print feature to print the current page
113 * Print Preview: Generates a page which is formatted so that it can be easily printed using your browser's Print feature.(((
114 [[image:PrintToucan.PNG||style="border: 1px solid black;"]]
115 )))
116
117 = Export =
118
119 There are several possible exporting formats that XWiki supports : PDF, RTF, XAR, HTML exports: See the [[Export feature>>Features.Exports]] for more information.
120
121 On Colibri skin:
122 [[image:NewColibriExport.png||height="153" width="650"]]
123
124 On Toucan skin:
125 [[image:PrintToucan.PNG||style="border: 1px solid black;"]]
126
127 = Delete =
128
129 Removes a page. A confirmation is asked before the removal is done.
130 To restore a deleted document, go to Quick Links panel on the right side and click Document Index. Click on the Deleted Documents tab then click restore to the corresponding document you want to restore.
131
132 On Colibri skin:
133 [[image:NewDeleteColibri.png||height="170" width="650"]]
134 [[image:DeleteConfirmColibri.png||style="border: 1px solid black;" width="648"]]
135 [[image:NewDeleteColibriConfirm.png||height="256" width="650"]]
136
137
138
139 On Toucan skin:
140 [[image:DeleteToucan.PNG||style="border: 1px solid black;"]]
141 [[image:DeleteConfirmToucan.png||style="border: 1px solid black;"]]
142 [[image:RestoreDocumentToucan.png||style="border: 1px solid black;"]]
143
144 = Copy =
145
146 {{warning}}
147 This feature currently requires for an user to have Programming Rights in order to function. See [[XSCOLIBRI-209>>http://jira.xwiki.org/jira/browse/XSCOLIBRI-209]] and [[XWiki-508>>http://jira.xwiki.org/jira/browse/XWIKI-5081]]
148 {{/warning}}
149
150 It is possible to create a copy of an existing page. To do so, you need to do a [[search>>extensions:Extension.Search Application]] with Admin Rights using the title of the page you want to copy. You will then see a "copy" next to the page you want to copy.
151
152 After clicking on it you will be prompted to enter the location of the page you want to copy (that is, "where should the page be copied?"). Click on "copy" and you're done!
153
154 On Colibri skin
155 [[image:NewCopyPageColibri.png||height="198" width="650"]]
156
157 Choose the language and the target page then click the "**Copy**" button:
158
159 [[image:NewCopyPageConfirmColibri.png||height="218" width="650"]]
160
161 On Toucan skin
162 [[image:NewCopyPageToucan.png||height="162" width="650"]]
163
164 = Move/Rename =
165
166 A rename feature is available in XWiki. Its effect is to change the page name (that is, you get http:~/~/<server>/xwiki/bin/View/NewSpace/NewPageName instead of http:~/~/<server>/xwiki/bin/View/OldSpace/OldPageName) and all the backlinks linking to it. This means that you can easily move a page from one space to another, as well as keep them evolving with your wiki.
167 The rename will perform 2 refactoring:
168 - update backlinks
169 - update parent information
170
171 In colibri, you can access the rename feature for a page by clicking on Rename under the More Actions in the top menu bar:
172
173 [[image:NewRenameColibri.png||height="180" width="650"]]
174 [[image:NewRenameConfirmColibri.png||height="275" width="650"]]
175
176
177 When using the Toucan skin, the Rename function can be found under the Action menu in the top menu bar:
178
179 [[image:TopBarRenameToucan.PNG||style="border: 1px solid black;"]]
180 [[image:RenameInputToucan.PNG||style="border: 1px solid black;"]]
181
182 Once this is done, you will be prompted to input the new Space and Page name you want your document to take:
183
184 Now you can link to the page using its new name.
185
186 == Limitations ==
187
188 There are still some limitations on renaming:
189
190 * backlinks have to be turned on (they are turned on by default but if you have turned them off, rename will not rename backlinks and you'll have to turn them on again to benefit from this feature)
191 * backlinks in objects attached to pages are not currently renamed. You can track issue [[XWIKI-981>>http://jira.xwiki.org/jira/browse/XWIKI-981]] to follow the progress.
192 * backlinks are saved when a page is saved thus it may happen with a clean XWiki database that backlinks are not saved. In this special case, you can call the following in a page to refresh all links (you'll need to be admin to do this):(((
193 {{code language="none"}}
194 $xwiki.refreshLinks()
195 {{/code}}
196 )))
197
198 = Share Page by Mail =
199
200 [[image:share1.png||style="border: 1px solid rgb(0, 0, 0);"]]
201
202 [[image:share2.png||style="border: 1px solid rgb(0, 0, 0);"]]
203
204 [[image:share3.png||style="border: 1px solid rgb(0, 0, 0);"]]
205 )))

Get Connected