Wiki source code of PageEditing
Version 7.1 by Vincent Massol on 2007/12/04
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.73 | 1 | 1 Page Editing |
| 2 | |||
| 3 | #startfloatingbox() | ||
| 4 | *Contents* | ||
| 5 | #toc ("2" "3" "") | ||
| 6 | #endfloatingbox() | ||
| 7 | |||
| 8 | In XWiki all pages are editable (provided you are logged in and/or have the edit rights). To edit a page, all you have have to do is to click the "Edit" button which is usually located at the top left of the page you're viewing (please note however that the location of the "Edit" button varies depending on the skin your wiki is using). For instance using the new skin you should see what is on the image below. | ||
| 9 | |||
| 10 | {image:EditionSimpleMode.JPG} | ||
| 11 | |||
| 12 | 1.1 Simple and Advanced edition modes | ||
| 13 | |||
| 14 | Since XWiki is an [application wiki>Main.SecondGenerationWiki], all users will not need to use the same features. This is why XWiki comes with a simple and an advanced edition mode. Users can easily choose which edition mode they prefer on their profile (available at the top right of the page when you are logged in). This way, standard user do not have to choose between edition modes they may not be familiar with. By default new users are given the Simple edition mode but they can switch to the Advanced mode as described below. | ||
| 15 | |||
| 16 | 1.1.1 Simple Mode | ||
| 17 | |||
| 18 | After clicking on the "Edit" button in simple mode, XWiki will automatically edit the page in the basic mode (WYSIWYG or Wiki) for standard pages and in Form mode for pages which include Forms (ie pages using the \#\includeForm() macro). The two edition mode available in simple mode are: | ||
| 19 | |||
| 20 | * [Wiki Edition Mode>UserGuide.PageEditing#HWikieditingmode] | ||
| 21 | * [WYSIWYG Edition Mode>UserGuide.PageEditing#HWYSIWYGeditingmode] | ||
| 22 | |||
| 23 | 1.1.1 Advanced Mode | ||
| 24 | |||
| 25 | Experienced XWiki users will want to use all the edition choices (particularly those who want to use XWiki programming features). They can choose to switch to advanced mode on their user profile page. (see image below). Following this, clicking on the "edit" button will display the full edition menu, letting the user choose which mode he wants to use (Wiki, Form ,Objects...). Under the "show" tab, the "code" option is displayed too. | ||
| 26 | |||
| 27 | {image:AdvancedMode.JPG} | ||
| 28 | |||
| 29 | Once you have switched to advanced mode, the Edit menu will look like this when the mouse is over: | ||
| 30 | |||
| 31 | {image:EditionAdvancedMode.JPG} | ||
| 32 | |||
| 33 | This will give you access to the following edition modes: | ||
| 34 | |||
| 35 | * [Form Edition Mode>UserGuide.PageEditing#HFormeditingmode28akainlinemode29] | ||
| 36 | * [Object Edition Mode>UserGuide.PageEditing#HObjectseditingmode] | ||
| 37 | * [Class Edition Mode>UserGuide.PageEditing#HClasseseditingmode] | ||
| 38 | * [Access Rights Edition Mode>UserGuide.PageEditing#HPageAccessRightseditingmode] | ||
| 39 | |||
| 40 | 1.1 Wiki editing mode | ||
| 41 | |||
| 42 | This is the default mode and the mode you should be familiar with if you're already a wiki user. In this mode you can enter text using a simple [Wiki Syntax>UserGuide.XWikiSyntax]. Note that the syntax documentation help is displayed in a menu on the right when you edit a page in this mode. | ||
| 43 | |||
| 44 | This is what the wiki edition mode looks like with the 1.0 XWiki skin: | ||
| 45 | |||
| 46 | {image:WIKIEdition.JPG} | ||
| 47 | |||
 |
1.80 | 48 | In Wiki and WYSIWYG mode, the user can maximize the edit area to occupy as much as possible of the full window. For this, there is a double-arrow blue button on the top-right corner of the editor, which launches the fullscreen editing mode. In order to save or to preview the document, the user can press the "Back" button or the 'X' to close the window and restore the original dimensions of the editor. |
| |
1.81 | 49 | The Fullscreen mode will be improved, so the user will be able to save, preview or continue working without closing the fullscreen window. |
 |
1.86 | 50 | 1.1 WYSIWYG editing mode |
| |
1.73 | 51 | |
| |
1.86 | 52 | This mode is ideal for first time users or people who do not want to use the Wiki Syntax. It's a mode similar to the one used by your favorite word processor in which you see how what you type is rendered. There's a toolbar available to add special effects to your text, add images, insert links, add macros, etc. |
| |
1.73 | 53 | |
| |
1.86 | 54 | This is what the WYSIWYG edition mode looks like with the 1.0 XWiki skin: |
| 55 | |||
| 56 | {image:WYSIWYGEdition.JPG} | ||
| 57 | |||
| 58 | The user can edit in fullscreen mode as explained above, at WIKI editing mode. | ||
| 59 | |||
| |
1.73 | 60 | 1.1 Form editing mode (aka inline mode) |
| 61 | |||
| 62 | Inline mode, or Form mode, is a special feature of XWiki, that allows administrators to define patterns of structured information (like a blog entry, or a standard tax form). Pages containing such structured information can be edited and re-edited as simple HTML Forms, which have (almost) the same structure as the displayed page. Thus, when clicking the edit button, it seems that the page content can be edited in-place, or inline. | ||
| 63 | |||
| 64 | You can only use this edit mode for pages having such structured content. | ||
| 65 | |||
| 66 | Technically this mode is used to edit pages that use the \#\includeForm() macro to display Forms objects attached to the page. It is beyond the scope of this simple guide to explain the programming technique supporting this feature. Please check the [Developer's Guide>DevGuide.WebHome] to find out more about programming with Objects/Classes and Forms. | ||
| 67 | |||
| |
1.87 | 68 | |
| |
1.73 | 69 | 1.1 Objects editing mode |
| 70 | |||
| 71 | In XWiki it's possible to attach Objects to pages. Objects are simply sets of properties with values that adds additional information about a page. For example a security right can be added to a page to control its rights, a blog object is attached to a page representig a blog entry, etc. Again it's beyond this simple guide to explain this programming technique. Please check the [Developer's Guide>DevGuide.WebHome] to know more about programming with Objects/Classes. | ||
| 72 | |||
| 73 | 1.1 Classes editing mode | ||
| 74 | |||
| 75 | We've seen that some pages can have Objects attached to them. Some pages can also be Object definitions, a.k.a Classes. The Classes editing mode calls the class editor on the current page, allowing to edit the Classes attached to the document. Again it's beyond this simple guide to explain this programming technique. Please check the [Developer's Guide>DevGuide.WebHome] to know more about programming with Objects/Classes. | ||
| 76 | |||
| 77 | 1.1 Page Access Rights editing mode | ||
| 78 | |||
| 79 | This mode allows you to control the access rights for the page you're viewing (you need to have the correct access rights to modify a page's rights of course!). See the [Rights Management>UserGuide.RightsManagement] topic for more information. | ||
| |
1.75 | 80 | |
| 81 | 1.1 Full Screen Mode | ||
| 82 | |||
| |
1.86 | 83 | From version 1.1 onwards, a full-screen mode is available in XWiki. When editing a page either in Wiki or WYSIWYG mode, clicking on the blue button at the top right of the edition box will send the editor in full-screen mode. You can then edit your page as usual and click on the "back" button to return to the usual interface when you are finished. |
| |
1.75 | 84 | |
| |
1.79 | 85 | ~~The button you need to click to go in full-screen mode~~ \\ |
| |
1.77 | 86 | {image:FullScreenButton.png} |
| 87 | |||
| |
1.79 | 88 | ~~Edition while in full-screen mode~~ \\ |
| |
1.75 | 89 | {image:FullScreen.png} |
