Page Editing

Last modified by adminhebat on 2013/07/11 14:59

Simple and Advanced editing modes

Since this Wiki is an application wiki, not all users will need to use the same features. This is why XWiki comes with a Simple and an Advanced editing mode. Users can easily choose which editing mode they prefer on their profile (available at the top right of the page when you are logged in). This way, standard users do not have to choose between editing modes they may not be familiar with. By default new users are given the Simple editing mode but they can switch to the Advanced mode as described below.

Simple Mode

After clicking on the "Edit" button in Simple mode, Wiki will automatically edit the page in the Basic mode (WYSIWYG or Wiki) for standard pages and in Form mode for pages which include Forms (i.e. pages using the #includeForm() macro). The two editing modes available in Simple mode are:

  • Wiki Editing Mode
  • WYSIWYG Editing Mode

Advanced Mode

Experienced Wiki users will want to use all the editing choices (particularly those who want to use Wiki 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 on any page will display the full editing menu, letting the user choose which mode he wants to use ("Wiki", "Inline form", "Objects"...).

Once you have switched to advanced mode, the "Edit" menu will look like this on mouse over:

  • Form Editing Mode
  • Object Editing Mode
  • Class Editing Mode
  • Access Rights Editing Mode

Common edit actions

All edit modes have some or all of the elements in the following image :

The minor edit checkbox is meant to mark the fact that superficial changes were made to the document. Such changes may include, but are not restricted to: spelling error corrections, text rearrangements, formatting. It is the editor's responsibility to distinguish between major and minor changes.

By default, minor edits do not appear in the "What's New" page and in the document history. The option "Show minor edits" will list all the versions, including minor ones.

The comment field allows entering a short description of the changes made to the document in the version that is being saved. It is displayed in the history page and it is meant to increase comprehensibility of the content's evolution.

The Cancel button causes the changes to be discarded and forwards to the document view mode.

The Preview button shows the document as it would look with the current changes saved, but does not actually change the document. From the preview mode, the user will be able to cancel the changes, return to edit mode or save the changes. This button is not available in all edit modes.

The Save & Continue button submits the current changes and returns to the current edit mode.

The Save & View button submits the current changes and returns to the document view mode.

Wiki Editing Mode

This is a 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. Note that the Help Application provides help on the syntax when editing a page.

This is how the wiki edit mode looks like with the Colibri skin:

Choosing a Syntax

Starting with XWiki Enterprise 1.7 you now have the option to choose what syntax you want to use for writing the content of the page (see the XWiki Syntax Guide for more details). To choose one of the configured syntaxes go in wiki edit mode and in the Information Panel select the syntax to use. For example using the Colibri Skin:

WYSIWYG editing mode

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.

Setting the page parent

In order to have an organized structure of your page, when you create a new page in a space, its parent will be automatically set to be the WebHome page of the space in which you create the page.

If you want to change the parent of the page, you have to edit the page with wiki or wysiwyg editors.

Click on the small pencil above the page title in order to edit the page parent.

If the page has no parent set, the breadcrumbs feature will not show the path to navigate from the Main.WebHome to the page. These pages are called orphan pages.

Created by adminhebat on 2013/07/04 10:24

Start Here

Welcome to the UNIMAS WIKI.
To start, use search function by entering keywords in the search box below :

Quick Navigation


Course Registration Guidelines

HOW-TO, Tutorial & User Manual

HOW-TO, Tutorial & User Manual




Semester Registration

Semester Registration Guidelines

Student Quick Guide


Recently Created

81502 | 81673 | 81971 | 80997 | 71606

Recently Modified

My Recent Modifications

This wiki is licensed under a Creative Commons 2.0 license
XWiki Enterprise 5.0.3 - Documentation