WebCenter Portal: Spaces enables you to create wiki documents, which multiple users can use to create and edit content that is relevant, useful, and up-to-date.
This chapter describes how to create and manage wiki documents. It includes the following sections:
Section 47.1, "Prerequisites for Enabling Wiki Functionality"
Section 47.3, "Permissions Required for Working with Wiki Documents"
Note:
The tasks described in this chapter are available only if Content Server 11g is configured as the content repository.
This chapter is intended for Spaces users interested in creating and managing wiki documents. To perform the tasks described in this chapter, users need to be assigned a role that includes the Edit Pages
and Create and Edit Documents
(which includes delete permissions on wiki documents that you create).
To delete wiki documents that are not your own, you must have Delete Documents
permission. To configure workflows or access control settings, you must have Document Administration
permission. For information about roles and permissions, see Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space."
To support wiki functionality, the Documents service relies on Content Server, the content repository that stores the wiki documents. For wiki functionality to be available in Spaces, the following prerequisites must be met:
Content Server 11g must be configured as the default content repository for Spaces. The wiki functionality is not available with Content Server 10g. For information about installing and configuring Content Server 11g, see the "Managing Content Repositories" chapter in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.
A connection to Content Server 11g must be established, as described in "Configuring Content Repository Connections" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter Portal
The Documents service must be enabled for the space in which you plan to create wiki documents. For information, see Section 51.10.1, "Enabling and Disabling Services Available to a Space."
Wiki documents epitomize the concepts of community and collaboration by allowing all authorized community members to contribute their information to a body of knowledge. Wiki documents are web pages that offer in-place editing using HTML or a simple mark-up language called wiki mark-up. Users with sufficient permissions on a wiki document can add, revise, or delete content. Wikipedia (http://www.wikipedia.com
) is a widely-known example of the use of wiki documents. Users from all over the world collaborate to create and edit Wikipedia pages, resulting in a rich, dynamic knowledge base for everyone's benefit.
In Spaces, you can create a wiki document using either of the following two methods:
New Wiki Document action, available on the Documents page and Documents service task flows.
Wiki page syle, to create a dedicated wiki page with a default wiki document that offers a simplified user interface and a dedicated wiki experience.
Anyone with appropriate permissions on the wiki page can create additional wiki documents using the New Wiki Document action. These wiki documents are siblings of the default wiki document, and are all stored in the dedicated folder that is automatically created for the wiki page.
Wiki documents created using either of the two methods offer the same in-place editing features thorugh the Rich Text Editor (RTE).
The method you choose for creating wiki documents really depends on your preferences. If you want to expose a wiki document as a separate page in your Spaces application, and want users to feel that there is a dedicated area for wikis, use the Wiki page style method. If you do not require these features, and just want to create a wiki document (among other types of documents) in your space's document hierarchy, use the New Wiki Document action.
Table 47-1 summarizes the differences between the two methods of creating wiki documents:
Table 47-1 Distinguishing Features Between Methods of Creating Wikis
Feature | New Wiki Document Action (Section 47.4.1, "Creating a Wiki Document Using the New Wiki Document Action") |
Wiki Page Style (Section 47.4.2, "Creating a Wiki Document Using the Wiki Page Style") |
---|---|---|
Exposure |
In the default side navigation page template, does not display wiki documents as a separate page in the space navigation area. A wiki document is exposed as a file in the folder where it was created on the Documents page of the space, just like any other file. |
Exposes wiki documents within a dedicated page in the navigation area of a space (the location depends on the page template used). The screenshot shows an example of navigation to a wiki page in a space using the default side navigation page template. A wiki page is exposed as a folder on the Documents page of the space, just like any other page. ![]() |
Document storage |
Does not create a separate folder to store a wiki document, and the navigation is not constrained. The screenshot shows |
Automatically creates a new folder (with the same name as the wiki page) under the root folder in the document hierarchy, and creates a default wiki document in the folder, with the same name as the page name. This method restricts navigation to start at this folder. The screenshot shows the folder named ![]() |
Permissions inherited by a wiki document |
Inherits permissions from the folder in which it is created. |
In a space, the newly created wiki page inherits space permissions (where In the Home space, a newly created wiki page inherits the same permissions as a public folder; the owner is granted the Administer, Read, Write, and Delete permissions, and public users are granted only the Read access. |
Permissions required to create wiki documents See also Section 47.3, "Permissions Required for Working with Wiki Documents" |
|
To create a page based on the Wiki page style and then be able to create wiki documents within the page, users require:
|
Note:
The root folder where Content Server stores a space is /spaces/
space_name
; a Home space is stored in /spaces/
user_name
.
The following sections discuss the permissions required to create and manage wiki documents:
To create a wiki document using the New Wiki Document action and edit the document, you must be granted the Create and Edit Documents
permission (Figure 47-1). To delete wiki documents, you require the Delete Documents
permission. These permissions are available to the Moderator
and Participant
roles by default.
Figure 47-1 Documents Service Permissions for Working with Wiki Documents
Note:
By default the authenticated-role
role is granted View
permission on wiki pages. This means that all authenticated users logged into Spaces can view a wiki page in the Home Space, or any space to which they have access. Additional permissions on the page are determined by the security set on the page, as described in Section 23.1, "Setting Access on a Page."
To create and edit wiki documents using the Wiki page style, you must be granted Page service permissions in addition to the Documents service permissions:
Standard permission model: If this permission model is used, creating and editing wiki documents requires:
Create and Edit Documents
permission for the Documents service (Figure 47-1).
Edit Page Access, Structure, and Content
permission for Basic Services (Figure 47-2).
Figure 47-2 Basic Services Permission for Working with Wiki Documents
Advanced permission model: If this permission model is used, creating and editing wiki documents requires:
Create and Edit Documents
permission for the Documents service (Figure 47-1).
Create Pages
or Create, Edit, and Delete Pages
permission for the Pages service (Figure 47-3).
Figure 47-3 Page Service Permissions for Working with Wiki Documents
The following sections describe how to create a wiki document in a Spaces application:
Section 47.4.1, "Creating a Wiki Document Using the New Wiki Document Action"
Section 47.4.2, "Creating a Wiki Document Using the Wiki Page Style"
Section 47.4.3, "Creating a Wiki Document Within a Wiki Page"
To understand the differences between the two methods of creating a wiki document, see Section 47.2, "What You Should Know About Wiki Documents."
To create a wiki document using the New Wiki Document action on the Documents page or in a Documents service task flow:
Navigate to the Documents page or the page that contains a Document Explorer, Document Viewer, Document Manager, or Folder Viewer task flow. Browse to the folder where you want to create a wiki document.
Click New Wiki Document (Figure 47-4).
The Rich Text Editor (RTE) opens (Figure 47-5), displaying a blank wiki document.
In the Title field, enter a display name for the wiki document.
Note:
When naming wiki documents, the following characters are not allowed:
\ / : [ ] * ' " | ?
Letters, numbers, spaces, and periods (.) are allowed.
Add and preview the text, formatting, styling, and links in the Rich Text, HTML, Wiki Markup, and/or Preview tabbed panes. For information about RTE toolbar icons and controls, see Section 41.11, "Using the Rich Text Editor (RTE)."
Click Create to save your changes and exit the editor.
The new wiki document displays in the Document Viewer, ready to be edited by other space members (Figure 47-12).
On the Documents page in the space, the new wiki document (Release Schedule
) is saved as a document in the current folder, as shown in Figure 47-13.
To understand the differences between the two methods of creating a wiki document, see Section 47.2, "What You Should Know About Wiki Documents."
To create a wiki document using the Wiki page style:
Navigate to the space in which you want to create a wiki document and open the Create dialog.
In the Page Name field, enter a display name for the dedicated wiki page.
The name that you enter here is also shown as the name of dedicated folder that is created, and the name of the first, default wiki document created within the folder.
Note:
While there are restrictions on naming wiki documents, there are no naming restrictions for page names. However, while any of the following characters can be used to name the wiki page, the page title will include the character(s) but the associated wiki document will replace the illegal character with "_
".
\ / : [ ] * ' " | ?
For example, if you create a wiki page named "What's In a Name?
", the page will have this title, but the associated wiki document will be named "What_s In a Name_
".
From the Page Style options, select Wiki (Figure 47-8).
Figure 47-8 Creating a Wiki Document Using the Wiki Page Style
Note:
The Wiki page style becomes available in the Create dialog in a space only if Spaces is integrated with Content Server 11g, and the Documents service is enabled for the space.
For information about setting up a connection to Content Server, see "Registering Content Repositories" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal. For information about enabling the Documents service, see Section 51.10.1, "Enabling and Disabling Services Available to a Space."
Click Create.
The newly created wiki displays as a separate page, containing a default wiki document with default text (Figure 47-9). The breadcrumbs at the top display the path where the wiki document is created in the document hierarchy. In the wiki document, you can replace the default text with the desired content. For information, see Section 47.5, "Editing a Wiki Document."
Figure 47-9 Default Wiki Document Created Using the Wiki Page Style
On the Documents page, you can find the newly created wiki document stored in a separate folder for the wiki page under the root folder, as shown in Figure 47-10. Both the folder and the default wiki document share the same name.
Figure 47-10 Default Wiki Document for a Wiki Page in the Document Hierarchy
A page based on the Wiki page style contains a default wiki document. Anyone with appropriate permissions on the wiki page can create additional wiki documents using the New Wiki Document action. These wiki documents are siblings of the default wiki document, and are all stored in the dedicated folder that is automatically created for the wiki page.
You can create an additional wiki document within a wiki page in either of the following ways:
Navigate to the folder for the page, and create a new wiki document as described in Section 47.4.1, "Creating a Wiki Document Using the New Wiki Document Action."
Navigate to the wiki page and select the New Wiki Document action, as described in the following steps:
In the wiki page, select the New Wiki Document action.
The way you select this action depends on the page template used in your space.
Figure 47-11 shows a wiki page open in a space that uses a side navigation page template. Clicking the page name in the breadcrumbs or the dropdown arrow next to the page name displays a menu that contains the New Wiki Document action.
Figure 47-11 The New Wiki Document Option Available for a Wiki Page
In the Rich Text Editor (RTE), in the Title field, enter a name for the new wiki document (for example, Project Plan
).
Add, revise, and preview text, formatting, styling, and links in the Rich Text, HTML, Wiki Markup, and/or Preview tabbed panes. For information about working with the RTE, see Section 41.11, "Using the Rich Text Editor (RTE).".
Click Create to save your changes and exit the editor.
The new wiki document displays in the Document Viewer, ready to be edited by other space members (Figure 47-12).
On the Documents page in the space, the new wiki document (Project Plan
) is saved as a document under its parent wiki folder (ProjectWiki
), along with the wiki document created as the default wiki page document (ProjectWiki
) , as shown in Figure 47-13.
Figure 47-13 Wiki Document Created Within a Wiki Page
In the wiki page, the dropdown arrow next to the page name in the breadcrumbs displays a menu that includes the wiki documents created within the page (in this example, Project Plan
) (Figure 47-14).
Figure 47-14 List of Wiki Documents Associated with Wiki Page
You use the Rich Text Editor (RTE) to add or revise the content of your wiki documents.
When you open a wiki document for editing, Spaces automatically checks the file out. If another user is already editing a wiki document when you try to open it, the Documents service displays a message that the wiki document has already been checked out. On the Documents page or in a Documents service task flow, a lock icon displays alongside a wiki document that is checked out. When you hover the mouse cursor over the lock icon, the name of the user who has checked out the wiki document displays.
Whenever you save changes to a wiki document, Spaces automatically checks the file in and creates a new version of the wiki document. This means that the last saved version of a wiki document appears as the current version.
To edit a wiki document:
Open your wiki document in edit mode in any of the following ways, depending on your view:
On the Documents page or in a Documents service task flow, click in the row of the wiki document you want to edit. From the File menu, choose Edit, or right-click the file and choose Edit from the context menu to open the wiki document in the RTE.
In the Document Viewer preview pane, click the Edit action (Figure 47-15).
In a wiki page, click the Edit action to edit the default wiki document.
In a wiki page, click the dropdown arrow next to the page name in the breadcrumbs to select and open a wiki document created within the page.(Figure 47-16), then click the Edit action.
Figure 47-16 List of Wiki Documents Associated with Wiki Page
In the RTE, add, revise, and preview text, formatting, styling, and links in the Rich Text, HTML, Wiki Markup, and/or Preview tabbed panes. For information about working with the RTE, see Section 41.11, "Using the Rich Text Editor (RTE).".
Select the Minor Edit? checkbox if you do not want to notify space members about your changes.
Leaving this checkbox cleared updates the Activity Stream and sends notifications after you save your changes.
Click Save to save your changes and continue editing, or click Save and Close to save your changes and exit the editor.
This section includes the following sections:
Section 47.6.1, "Exposing an Existing Wiki Document as a Wiki Page"
Section 47.6.2, "Exposing an Existing Wiki Document Using Content Presenter"
When you create a wiki page using the Wiki page style, it is listed in the document hierarchy, and is exposed as a separate page in the navigation area in your space. However, when you create a wiki document using the New Wiki Document action, the wiki document is listed in only in the document hierarchy. For easy access to such a wiki document, you can publish it to appear as a page in the navigation area.
To publish an existing wiki document as a page in the navigation area:
On the Documents page, create a folder with the same name as the existing wiki document at the root level of the space (see Section 41.7, "Creating a Folder"). For example, if the existing wiki document is named Project Plan
, create a folder named Project Plan
(Figure 47-17).
Figure 47-17 Folder Created at the Space Root Level
Move the existing wiki document to the newly created folder (see Section 41.15, "Moving Folders and Files").
Note:
The wiki document must have been originally created using the New Wiki Document action, as described in Section 47.4.1, "Creating a Wiki Document Using the New Wiki Document Action."
Open the Create dialog to create a new page in the space.
In the Page Name field, enter the display name of the existing wiki document that you want to expose; for example, Project Plan
.
Note:
When naming wiki documents, the following characters are not allowed:
\ / : [ ] * ' " | ?
Letters, numbers, spaces, and periods (.) are allowed.
From the Page Style options, select Wiki.
Click Create.
The wiki document is now exposed as a separate page in the navigation area. The location depends on the page template used in your space. Figure 47-18 shows the Project Plan
wiki document eposed as a page in the navigation area in a space, under Wikis.
Figure 47-18 A Wiki Document Exposed as a Page
The Content Presenter task flow allows you to select a wiki document, and render its content in a specific template on a page. For information, see Section 40, "Publishing Content Using Content Presenter."
Table 47-2 lists the tasks that you can perform to manage wiki documents, with links to the steps that describe how to perform each task for any kind of file.
Table 47-2 Managing Wiki Documents
Task | Description | For more information, see... |
---|---|---|
You can open a wiki document on the Documents page or in a Documents service task flow. If your wiki document is exposed through a wiki page, you can open the wiki page, then access the wiki document from the wiki page's dropdown menu, as shown in Figure 47-14. |
||
You can download a wiki document from the content repository to your local file system. You can access the Download action from the Documents page, Documents service task flows, or the Document Viewer preview pane. Note: Spaces does not support uploading a new wiki document or a new version of a wiki document from the file system. If you upload an HTML file, you cannot convert it to a wiki document due to differences in underlying metadata. |
||
You can rename a wiki document as desired. |
||
You can delete a wiki document if it is no longer required. |
||
You can associate comments with a wiki document to provide additional information that you may want to convey to other users about it. |
Section 41.19, "Viewing, Entering, and Deleting Comments on a File" |
|
You can add tags to a wiki document to specify keywords related to the content of the post to make it more widely discoverable in search results. |
||
Every time you save a wiki document, Spaces saves a new version of the post and maintains the version history. You can view and delete the various versions. However, you cannot restore an older version of a wiki document. |
||
You can view the basic and advanced properties associated with a wiki document. However, you can modify only the name and description of a wiki document. |
||
Using the Select Resource and New Resource icons in the RTE, you can add links from a wiki document to existing resources, or create and link to new resources. Note that these inline links are not added to the Links tab associated with the details of the wiki document. |
Table 41-6, "Rich Text Editor Toolbar Icons and Controls on Rich Text Tab" (Select Resource and New Resource icons) |
|
You can open or save the PDF version of the currently open wiki document. This choice is available if Content Server is configured to convert wiki documents to PDF format, and your application administrator must configure the WebCenter Conversion component, as described in "Enabling the Conversion of Wikis and Blogs into PDFs" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal. |
||
You can directly access a wiki document using its URL. You can share the link by publishing it to the Activity Stream or sending the link in a mail message. |
||
You can secure a wiki document by setting custom access permissions or choosing to inherit the permissions of the parent folder. The option to set security for wiki documents is available if item level security has been enabled on Content Server. |
Section 41.27, "Setting Security Options on a Folder or File" |
|
You can subscribe to a wiki document to receive notifications for activities such as when it gets updated or when a user posts comments or likes it. You are notified through your selected messaging channel. |
||
To indicate that a wiki document is of particular interest to you, you can "like" it. If a wiki document is already liked, you can "unlike" it if you no longer wish to highlight your preference. |