This chapter provides you a guide to use all Wiki features and configure the Wiki portlet to make it work in your desired way. Before going further, you should know some basic concepts about Wiki. Once you have logged in Wiki, the Wiki homepage will appear automatically as below.

Details:

The Breadcrumb which shows the page hierarchy.
The Search box.
The Page Control area which helps users take actions with the current page.
The pages tree view.
The defaul content. The small page could be a Wiki quick guide that explains how to create a page, switch between each different edit modes, or create a page, and more.
The page information. Click "view change" to redirect to the Page History page for comparing changes between various versions. Click "attachments" and "revisions" links to open the Attachments details pane and the Revisions pane respectively right under the Page information bar. These two panes can be collapsed by clicking the relevant links again.

Pages are sites where information in Wiki is stored and shared. Pages are stored within a Space. To do or view actions on a specific Wiki page, you should contact the administrator to get the appropriate permissions. See the Page Permissions for detailed permissions.

In a page, you can:

There are two ways to create a page:

The first way: Using the toolbar.

1. Go to a Wiki space in which you want to create a page.

2. Click Add Page and select Blank Page or From Template... from the drop-down menu if you want to use an available template.

If you select From Template..., a list of available templates appears:

You can:

i. Click Preview corresponding to the template you want to see.

ii. Click Select corresponding to the template you want to select for your new page.

The template for your page is displayed:

3. Enter the title for your page. The page title must be unique.

4. Enter the content for your page by using Wiki Markup or the Rich Text editor.

5. Click Preview to see how your page looks like (optional); or click Save to finish.

The second way: Using the undefined link in a page.

In the Wiki application of eXo Knowledge, you can add a link pointing to a page which you are going to create later. Such links are called undefined links. These links are often used to remind other Wiki users to create the page.

To add an undefined link for creating a page later:

1. Add a link by typing the page title between square brackets '[[...]]' or '[.... ]' (depending on your selected syntax) into your page body.

For example:

SyntaxWhat you type What you get
Xwiki 2.0 [[eXo User Guide]]
Confluence 1.0[eXo User Guide]

2. Click Save to save the page containing the link. The undefined link is colored in red with the underline.

3. Click the created red link to open the 'Add page' form.

4. Follow the steps stated above to enter the page title, content, and save the page.

You can edit a page at any time provided that you have the edit permission on that page.

To edit a page, click Edit in the Page control area. Your page will switch to the edit mode.

Now, you can rename the page and edit the page contents. The toolbar in the edit mode will be changed to activate the following actions:

Details:

Save the current page and go back to the view mode.
Save the current page without sending notification to the watcher.
Display the preview mode of the currently edited content. Previewing a page helps you verify the result of rendering the markup you just entered without saving.
Open the Wiki syntax help page.
Switch to the Rich Text (WYSIWYG) editor.
Discard the current changes and go back to the view mode.

Attachments are any files enclosed with your pages. The attachments may be images, documents, presentation or multimedia files.

In this section, you will know how to:

There are two ways to add an attachment to a page:

The first way: Use the attachment pane at the bottom of the page.

1. Click the Upload field. The upload window will appear.

2. Select a file from your local device and click the Open button. The File will be uploaded automatically then.

The second way: Use the WYSIWYG editor (Rich Text editor).

1. Select a page to which you want to add an attachment.

2. Select Edit at the Page Control area. For more details, see Edit a page.

3. Select the Rich Text editor on the page toolbar.

4. Click on the toolbar of Rich Text editor, then select Attached File... from the drop-down menu.

The Link form is displayed:

5. Select Current page, then double-click Upload new file.

6. Click Browse to select a file from your local device.

7. Click Upload. The form to edit the link parameters appears:

8. Edit the link parameters by typing the label and the tooltip for the link.

9. Click Create link to commit.

Note

You can add an attachment to all pages by selecting All pages, then clicking Upload file....

1. Open the Link form as described above.

2. Click the attachment name in the attachments list of the current page or the other page (by selecting the All pages tab), then click Select.

3. Edit the link parameters.

4. Click Create Link to commit.

Link to an inserted image:

1. Click on the text editor, then click Insert Image...

2. Select an inserted image of the current page or click the All Pages tab to select an image attached to another page in the space.

3. Click Insert Image.

Using a macro, you can apply extra formatting, functionality and customization to your content. You can easily add macro tags by using the Rich Text editor.

To insert a macro:

1. Click Rich Text to open the rich text editor.

2. Click Macros, then select Add Macros... from the drop-down menu.

The Insert Macros form appears:

The macros are classified into different categories: Content, Formatting, Navigation.

3. Select a macro category.

4. Select your desired macro from the selected categories list and then click the Select button; or double-click it. For example, if you select the Box macro, you are redirected to the Macro Parameters form.

5. Enter parameters into the corresponding fields for your selected macro. Click Insert Macro to perform your macro insertion; Or, click Previous to return to initial Insert Macro form.

The following table describes specific functions of common macros.

MacroFunction
Excerpt Create additional information for the current page and it can be set to "hidden" in the current page, but displayed to add more information as the summary about the page when it is used with the Page Tree macro.
Include Page Include the content of another page in the current page.
Box Draw a box around the provided content.
Color

Change the text color.

Code

Highlight code snippets of various programming languages.

Error Message Display an error message note.
Float

Allow a content to 'float' on the left or the right.

Info Message

Display an info message.

NoFormat

Keep the content displayed when you type.

Note Message

Display a note message.

Panel

Embrace a block of text within a fully customizable panel.

Table

Table cell

Table row

Inset a table.

Insert a table cell.

Insert a table row.

Tip Message

Display a tip message block.

Warning Message

Display a warning message block.

Anchor Create an anchor for the selected contents.
Children

Display the children and descendants of a specific page in the current page.

Page Tree

Display the hierarchy of a page in the current page.

Related Pages Render the related pages of the current page.
Table of Content Generate a table of content for the current page.
Section & Column

Using the Section and Column macros allows you to write the content in the columns in the section.

When editing page contents, Wiki will automatically create a version of that page after you have saved. Thanks to the page version, you can make changes to the page safely and rollback to earlier version without worrying about messing things up.

The Page History will give all versions of a page. To display the Page History, move your cursor to the bottom of the page, and select the view change in the page info bar.

The Page History page is displayed as below:

Click View page history to go inside the Page History as below:

Each version includes the following information:

In the Page History page, you can:

To view a specific version of a page, just click a version number in the Page History page. The selected version of that page will be displayed:

At a version of the page, you can do the following actions:

Compare the current version with the selected one.
Replace the current version with the selected version.
Go to the Page History page.
View content of the previous version.
View content of the next version.

Wiki provides permanent bookmarkable URLs to all wiki pages. Wiki will resolve wiki pages by inspecting the URL used to call it and outputting links as clean URLs in the following form:

$CONTAINER$ The portal container.
$ACCESS 'private' or 'public'.
$SITE The portal site (e.g,'classic').
$NAV_URI The URI of navigation bound to a page containing the Wiki portlet.
$OWNER_TYPE May be 'group' or 'user'.
$OWNER The wiki owner which can be name of user or of group.
$WIKI_PAGE_URI The URI inferred automatically from the wiki page name.

Any wiki page should be accessed by a friendly URL, for example:

The Administrator has the highest right in Wiki. The Administrator can delete a page, change the space settings, set the edit permission for users, and more.

For each space, you can manage page templates and change the syntax used.

To access the Space Settings:

1. Open a Wiki space.

2. Click Browse, then select Space Settings:

The Space Settings form will help you configure the syntax, template of pages and manage permissions for pages and spaces.

When adding a new page, you are not required to write the content from scratch. You can start by selecting a page template which is actually a Wiki page with predefined contents.

In the Space Settings form, select the Template tab, and the form to manage templates appears:

Now you can:

Wiki gives you the choice to make a space or an individual page to be open or restricted to specific users, groups or memberships. There are two levels of permissions in Wiki: Space permissions and Page permissions.

Each space may has its own permissions. Space permissions determine what actions a user can do within the space. A permission can be assigned to any users, groups or memberships.

To change the space permission, open a space, click Browse and select Space Settings:

The Permissions page appears:

There are some permissions to a space as follows:

View Pages Specify who can view and watch pages of this space, its attachments and history.
Edit Pages Specify who can edit pages of this space.
Admin Pages Specify who have the Administrator rights on this space.
Admin Space Specify who can manage the space permissions and settings

In the Space Permissions form, you can add or remove the space permissions of the users, groups and membership.