20 Working with Wikis

Create, edit, and manage wikis, which multiple users can use to share content that is relevant, useful, and up-to-date.

See Also:

For an overview of the different options available in WebCenter Portal for working with portal content and adding content to a portal, see Introduction to Adding Content to a Portal.

Note:

To perform the tasks in this chapter, you need the following permissions:

  • To view or post comments on wiki documents, you need only the View Documents permission.

  • To view a wiki page, you need the View Page permission. This permission is granted to all authenticated users by default. To edit a wiki page, you need to be granted Edit permissions on the page.

  • To create a personal page using the Wiki page style, you need the application-level permission Pages: Create. This permission is granted to all authenticated users by default, allowing them to create and manage their personal pages in the Home portal.

  • To use the New Wiki Document action and work with wiki documents, you need the portal-level permission Create 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.

Permissions:

The tasks described in this chapter are available only if the system administrator and portal manager have made wiki functionality available in WebCenter Portal and the current portal, as described in Prerequisites for Enabling Wiki Functionality in Building Portals with Oracle WebCenter Portal.

Topics:

About Wikis

Wikis are web pages that offer in-place editing using HTML or a simple mark-up language called wiki mark-up.

Wikis epitomize the concepts of community and collaboration by allowing all authorized community members to contribute their information to a body of knowledge. Users with sufficient permissions on a wiki can add, revise, or delete content. Wikipedia (http://www.wikipedia.com) is a widely-known example of the use of wikis. 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 WebCenter Portal, you create a wiki page using Wiki page style, which supports a dedicated wiki page with a default wiki document that offers in-place editing features through the Rich Text Editor (RTE).

A wiki page is exposed in the Content Manager task flow as a folder, just like any other page. The folder contains a default wiki document, with the same name as the page name. The wiki page is automatically added to the portal’s navigation.

To create a new wiki page, you must have the following permissions:

  • Create Pages or Create, Edit, Delete Pages

  • Create Documents

In a portal, the newly created wiki page inherits portal permissions (where the Portal Manager role and users with Customize Pages permissions have Create, Edit, and Delete permissions, and users with View Pages and Content permissions have only View permission).

In the Home portal, 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.

Creating a Wiki

This section describes the ways to create a wiki.

This section includes the following topics:

Creating a Wiki Page

You can create a dedicated wiki page using the Wiki page style.  The wiki page will appear in the portal navigation. When you click the wiki page’s name in the navigation, the content of the wiki page gets displayed. 

You can create a dedicated wiki page using the Wiki page style as either:

Tip:

The Wiki page style is available only if the Documents tool is enabled for the portal.

Wikis offer in-place editing features through the Rich Text Editor (RTE), described in Using the Rich Text Editor (RTE).

The initial wiki page, containing a default wiki document with default text, looks similar to Figure 20-1.

Figure 20-1 Default Wiki Document Created Using the Wiki Page Style

Description of Figure 20-1 follows
Description of "Figure 20-1 Default Wiki Document Created Using the Wiki Page Style"

In the wiki document, you can replace the default text with the desired content. For information, see Editing a Wiki.

The breadcrumbs at the top display the path where the wiki document is created in the document hierarchy.

In the Content Manager task flow, 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 20-2. Both the folder and the default wiki document share the same name.

Figure 20-2 Default Wiki Document for a Wiki Page in the Document Hierarchy

Description of Figure 20-2 follows
Description of "Figure 20-2 Default Wiki Document for a Wiki Page in the Document Hierarchy"

Creating a Wiki Document Within a Wiki Page

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. Additional 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. A wiki document is not displayed in portal navigation, but is listed only in the document hierarchy.

To create a wiki document within a wiki page:

  1. Navigate to the wiki page and select the New Wiki Document action (Figure 20-3).

    Figure 20-3 The New Wiki Document Option Available for a Wiki Page

    Description of Figure 20-3 follows
    Description of "Figure 20-3 The New Wiki Document Option Available for a Wiki Page"
  2. In the Rich Text Editor (RTE), in the Title field, enter a name for the new wiki document (for example, Just Lincoln).
  3. Add, revise, and preview text, formatting, styling, and links in the Rich Text, HTML, Wiki Markup (if shown), and Preview tabbed panes.

    Note:

    • For information about using the toolbar and features in the Rich Text pane, see Using the Rich Text Editor (RTE).

    • Apple iPad users cannot make selections from drop-down lists in the RTE. This is a known limitation.

    • By default, the Wiki Markup tab is hidden in the RTE. Your system administrator can change this setting, as described in Showing and Hiding the Wiki Markup Tab in the Rich Text Editor in Administering Oracle WebCenter Portal.

    • If you switch from the Wiki Markup tab to another tab in the RTE, your content might become garbled. As a workaround, if you go to the Wiki Markup tab, click Save and Close or Cancel rather than switching to another tab in the RTE.

  4. Click Create to save your changes and exit the editor.

    The new wiki document displays, ready to be edited by other portal members (Figure 20-4).

    Figure 20-4 New Wiki Document Associated with a Wiki Page

    Description of Figure 20-4 follows
    Description of "Figure 20-4 New Wiki Document Associated with a Wiki Page"

    In the Content Manager task flow, the new wiki document (Lincoln) is saved as a document under its parent wiki folder (Stamp Catalog), along with the wiki document created as the default wiki page document (Stamp Catalog), as shown in Figure 20-5.

    Figure 20-5 Wiki Document Created Within a Wiki Page

    Description of Figure 20-5 follows
    Description of "Figure 20-5 Wiki Document Created Within a Wiki Page"

    In the wiki page, the drop-down arrow next to the page name in the breadcrumbs displays a menu that includes the wiki documents created within the page (in this example, Lincoln) (Figure 20-6).

    Figure 20-6 List of Wiki Documents Associated with Wiki Page

    Description of Figure 20-6 follows
    Description of "Figure 20-6 List of Wiki Documents Associated with Wiki Page"

Creating a Wiki Document Using the Wikis System Page

When you create wiki documents within a wiki page, they are listed under the wiki page’s folder in the document hierarchy. You can choose to create wiki documents using the Wikis system page so that they are listed directly as a top-level folder in the document hierarchy.

To create a wiki document using the Wikis system page:

  1. Ensure the Wikis system page is exposed in your portal navigation. For information, see Adding an Existing Page to the Portal Navigation in Building Portals with Oracle WebCenter Portal.
  2. On the Wikis system page of your portal, select the New Wiki Document action Figure 20-7.

    Figure 20-7 The New Wiki Document Option Available on the Wikis System Page

    Description of Figure 20-7 follows
    Description of "Figure 20-7 The New Wiki Document Option Available on the Wikis System Page"
  3. Add, revise, and preview text, formatting, styling, and links in the Rich Text, HTML, Wiki Markup (if shown), and Preview tabbed panes.

    Note:

    • For information about using the toolbar and features in the Rich Text pane, see Using the Rich Text Editor (RTE).

    • Apple iPad users cannot make selections from drop-down lists in the RTE. This is a known limitation.

    • By default, the Wiki Markup tab is hidden in the RTE. Your system administrator can change this setting, as described in Showing and Hiding the Wiki Markup Tab in the Rich Text Editor in Administering Oracle WebCenter Portal.

    • If you switch from the Wiki Markup tab to another tab in the RTE, your content might become garbled. As a workaround, if you go to the Wiki Markup tab, click Save and Close or Cancel rather than switching to another tab in the RTE.

  4. Click Create to save your changes and exit the editor.

    The new wiki document displays, ready to be edited by other portal members.

    On the Wikis system page, the new wiki document (MyStamps) is shown as a top-level folder in the document hierarchy, as shown in .

    Figure 20-8 A Wiki Document Listed in the Document Hierarchy on the Wikis System Page

    Description of Figure 20-8 follows
    Description of "Figure 20-8 A Wiki Document Listed in the Document Hierarchy on the Wikis System Page"

Editing a Wiki

You use the Rich Text Editor (RTE) to add or revise the content of your wiki documents.

Note:

The Rich Text Editor (RTE) can edit wiki documents up to 1MB in size. For wiki documents larger than 1MB, the Edit action is not active.

When you open a wiki document for editing, WebCenter Portal automatically checks the file out. If another user is already editing a wiki document when you try to open it, you will see a message that the wiki document has already been checked out.

Whenever you save changes to a wiki document, WebCenter Portal 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:

  1. Open the wiki document.

    Tip:

    To open the default wiki document, navigate to the wiki page.

    To open another wiki document created within the wiki page, first click the dropdown arrow next to the page name in the breadcrumbs and select the appropriate document.

  2. Click the Edit action.

    Figure 20-9 Editing a Wiki Page

    Description of Figure 20-9 follows
    Description of "Figure 20-9 Editing a Wiki Page"
  3. In the RTE, add, revise, and preview text, formatting, styling, and links in the Rich Text, HTML, Wiki Markup (if shown), and Preview tabbed panes.

    Note:

    • For information about using the toolbar and features in the Rich Text pane, see Using the Rich Text Editor (RTE).

    • Apple iPad users cannot make selections from drop-down lists in the RTE. This is a known limitation.

    • By default, the Wiki Markup tab is hidden in the RTE. Your system administrator can change this setting, as described in Showing and Hiding the Wiki Markup Tab in the Rich Text Editor in Administering Oracle WebCenter Portal.

    • If you switch from the Wiki Markup tab to another tab in the RTE, your content might become garbled. As a workaround, if you go to the Wiki Markup tab, click Save and Close or Cancel rather than switching to another tab in the RTE.

  4. Select the Minor Edit? check box if you do not want to notify portal members about your changes.

    Leaving this check box deselected updates the Activity Stream and sends notifications after you save your changes.

  5. Click Save to save your changes and continue editing, or click Save and Close to save your changes and exit the editor.

Using the Rich Text Editor (RTE)

The Rich Text Editor (RTE) is a fully-integrated HTML text editor, which you can use to create and edit wiki documents and blog posts.

Figure 20-10 shows create mode, and Figure 20-11 shows edit mode.

Figure 20-10 New Wiki Document in Rich Text Editor

Description of Figure 20-10 follows
Description of "Figure 20-10 New Wiki Document in Rich Text Editor "

Figure 20-11 Editing Wiki Document in Rich Text Editor

Description of Figure 20-11 follows
Description of "Figure 20-11 Editing Wiki Document in Rich Text Editor"

To use the RTE:

  1. Open the RTE either by creating a new wiki document (see Creating a Wiki Page) or blog post (see Creating a Blog Post), or editing a wiki (see Editing a Wiki) or blog post.
  2. Enter a display name in the Title field.
  3. Add, revise, and preview text, formatting, styling, and links in the Rich Text, HTML, Wiki Markup, and Preview tabbed panes.

    Note:

  4. (For wiki documents only) Select the Minor Edit? check box if you do not want to notify portal members about your changes.

    Leaving this check box deselected updates the Activity Stream and sends notifications after you save your changes.

  5. In the tabbed panes along the bottom of the RTE, you can add comments, tags, or links pertinent to the document or post.
  6. Save your changes:
    • To create and save a new wiki document or blog post, click Create.

    • To save updates to an existing wiki document or blog post, click Save. To save updates and exit the RTE, click Save and Close.

About the Rich Text Editor Tabbed Panes

The RTE provides four tabbed panes where you can create and edit your wiki and blog posts.

  • Rich Text. Create and revise content in a WYSIWYG environment using the icons and controls in the RTE toolbar (see About the Rich Text Editor Toolbar).

    Note:

    Apple iPad users cannot make selections from drop-down lists in the RTE. This is a known limitation.

  • HTML. Enter HTML manually. This includes entering source code for HTML not handled by the WYSIWYG icons and controls on the Rich Text tab.

    If you exit the HTML pane, then come back to it again, any HTML that may have been entered on separate lines will reformat to display on a single line, as is customary for most HTML editors.

    Note:

    • The RTE ignores the following types of tags when entered in HTML because they are irrelevant or redundant within the RTE context:

      • script tags

      • form elements, such as input, select, textarea, and form

      • frame/frameset

      • document tags, such as html, head, body, meta, and title

      • unknown tags; for example: <foo></foo>

    • Changes to the behavior of the default CSS selectors in a wiki or blog is not supported.

  • Preview. Shows a preview of your wiki document or blog post as it will appear when published.

  • Wiki Markup (wiki documents only). If shown, use this tab to enter your own wiki markup. For the full set of wiki markup syntax, click Wiki Markup Help. Any formatting not provided by Wiki Markup uses HTML.

    Note:

    • By default, the Wiki Markup tab is hidden in the RTE. Your system administrator can change this setting, as described in Showing and Hiding the Wiki Markup Tab in the Rich Text Editor in Administering Oracle WebCenter Portal.

    • If you switch from the Wiki Markup tab to another tab in the RTE, your content might become garbled. As a workaround, if you go to the Wiki Markup tab, click Save and Close or Cancel rather than switching to another tab in the RTE.

About the Rich Text Editor Toolbar

The Rich Text tab of the Rich Text Editor includes various icons and controls to create and revise content in a WYSIWYG environment.

Table 20-1 describes the RTE toolbar icons and controls.

To perform an operation assigned to an icon, click the icon once to either immediately perform the action or open a dialog with further configuration options.

Table 20-1 Rich Text Editor Toolbar Icons and Controls on Rich Text Tab

Control Description
RTE font style icons

Bold, Italic, Underline, and Strike Through. Select text, and click the desired font style icon; or click an icon, and enter text. Click the icon again to exit the font style.

RTE Paragraph Format drop-down menu

Paragraph Format. Select a format, then enter text; or highlight text, then select a format.

RTE Font Name drop-down menu

Font Name. Select a font, then enter text; or highlight text, then select a font.

RTE Font Size drop-down menu

Font Size. Select a size, then enter text; or highlight text, then select a size.

RTE text color drop-down menu

Text Color or Background Color. Select text, and click the desired text or background color icon, then select a color. Or, click an icon and select a color, then enter text.

RTE justify icons

Left Justify, Center Justify, and Right Justify. Select text, and click to apply the desired text alignment; or click an icon, and enter text.

RTE indent icons

Decrease Indent and Increase Indent. Select text, and click the desired indent icon to move text left or right.

RTE list icons

Numbered List and Bulleted List. Start a new line, click the desired list type icon, and enter text. Or, select lines of text and click an icon. Click the icon again to remove the list formatting. Alternately, end list mode by pressing Enter twice after the last item.

RTE Remove Format icon

Remove Format. Select text, and click this icon to remove all font styling, such as font types, sizes, weights, and colors. Lists and indents are not affected.

RTE Select Resource, New Resource, and Embed Image icons

Select Resource. Select text to link to an existing portal resource, then click this icon to open the Select Resource dialog. Select a resource (for example, a document or an announcement in the current portal, or a URL) to be linked from the selected text. Clicking the linked text in the document opens the selected resource in the Document Viewer preview pane.

New Resource. Select text to link to a new portal resource, then click this icon to open the New Resource dialog. Select a resource to be linked from the selected text, then create the resource (for example, a discussion forum topic or note), specify the external location of the resource (for example, a URL), specify a name for the new resource (for example, a wiki document), or upload the resource from your local file system or a connected network drive (for example, a document).

Note: If you create a new wiki document in this manner, Oracle WebCenter Portal creates a placeholder for the new wiki document in the current folder. To add content to the new wiki document, you must navigate to it and open it in the RTE.

Note: For an external URL to be found valid by WebCenter Portal, the system administrator must add it to the list of valid URLs in the valid-link-url.xml file.  See Adding a List of Valid External URLs in Administering Oracle WebCenter Portal. If an external URL is not listed in the file, the following error message appears:

The URL entered is not available in the list of valid URLs. Contact your system administrator for the list of valid URLs.

The links created using Select Resource and New Resource are created as inline links, and are not added to the Links tab associated with the details of the linking resource.

For information about links to resources in WebCenter Portal, see Linking Information.

Embed Image. Click to open the Embed Image dialog:

  • Click Select Image to select an image in the current portal.

  • Click Upload Image to upload an image from your local file system or a connected network drive.

RTE Table icon

Table. Click to open the Table Properties dialog.

See Working with Tables in the Rich Text Editor.

RTE Insert Horizontal Line icon

Insert Horizontal Line. Click to insert a horizontal line at the current cursor location.

RTE Tools icon, expanded to show options

Tools:

  • Maximize/Minimize. Click to expand the RTE to fill the entire screen, or reduce the RTE to display inside the portal.

  • Select All. Select all content in the body in the text input area.

  • Find or Replace. Click to open the Find and Replace dialog, where you can search for a string, or replace a given string with specified text.

  • Snippet. In a blog post, select a portion of text, then click this icon to display that portion as a summary of the blog post on the blog summary page (or digest page), with a Read More link to allow users to view the full blog. In a wiki document, this functionality is not available.

RTE Cut, Copy, and Paste options on context menu

Cut, Copy, or Paste. Select text, then right-click to display context menu to cut or copy selected text, or paste text in the buffer at the current cursor location.

Note: If a browser security warning displays, you can either use keyboard commands (see Using the Keyboard in the Rich Text Editor) or configure your browser to grant access to the clipboard. For example, for the FireFox browser, see http://kb.mozillazine.org/Granting_JavaScript_access_to_the_clipboard.

Working with Tables in the Rich Text Editor

You can use the Rich Text Editor to create tables in your wiki documents and blog posts.

To create a table in the RTE, click the Table icon in the toolbar (Figure 20-12).

Figure 20-12 Rich Text Editor: Table Icon

RTE Table icon

The Table Properties dialog window opens (Figure 20-13), where you can set basic properties for the table, as described in Table 20-2.

Figure 20-13 Rich Text Editor: Table Properties Dialog (Basic Properties)

Description of Figure 20-13 follows
Description of "Figure 20-13 Rich Text Editor: Table Properties Dialog (Basic Properties)"

Table 20-2 Rich Text Editor: Basic Table Properties

Property Description

Rows

(Required) Enter the number of rows in the table.

Columns

(Required) Enter the number of columns in the table.

Width

Enter the width of the table, selecting either pixels or a percent value. Giving the width as a percent value lets you set the proportion of the editing area that the table will occupy.

Height

Enter the height of the table in pixels.

Headers

Select the table element to format as headers, which applies special formatting to them. You can apply header formatting to First Row, First Column or Both.

Border Size

Enter the width of the table borders.

Alignment

Select the alignment of the table on the page Left, Center, or Right.

Cell padding

Enter the space between the cell border and its contents, in pixels.

Caption

Enter label text to be displayed above the table.

Summary

Enter a summary of the table contents that is available for assistive devices like screen readers. It is good practice to provide tables with meaningful summary text to make them more accessible to users with disabilities.

Click the Advanced tab to expose the advanced table properties (Figure 20-14), which you can set as described in Table 20-3.

Figure 20-14 Rich Text Editor: Table Properties Dialog (Advanced Properties)

Description of Figure 20-14 follows
Description of "Figure 20-14 Rich Text Editor: Table Properties Dialog (Advanced Properties)"

Table 20-3 Rich Text Editor: Advanced Table Properties

Property Description

Id

Enter a unique identifier for a table element in the document (id attribute).

Language Direction

Select the direction of the text in the table: left to right (LTR) or right to left (RTL) (dir attribute).

Style

Enter the CSS style definitions (style attribute). Note that each value must end with a semi-colon and individual properties should be separated with spaces.

Stylesheet Classes

Enter the class of the table element (class attribute). If a table element is assigned more than one class, separate class names with spaces.

With a table inserted into your document, you can enter values directly in the cells. Additional editing is available through the context menu. To open the context menu, right-click the table and choose actions as described in Table 20-4.

Table 20-4 Rich Text Editor: Table Context Menu Selections

Action Description

Paste

Pastes the content on the clipboard at the current cursor location

Cell

See Editing Table Cells in the Rich Text Editor.

Row

See Editing Table Rows in the Rich Text Editor.

Column

See Editing Table Columns in the Rich Text Editor.

Delete Table

Deletes the entire table and its contents.

Table Properties

Opens the Table Properties dialog, where you can modify properties as described in Table 20-2 and Table 20-3, with the exception of the number of rows and columns.

Editing Table Cells in the Rich Text Editor

You can insert, delete, merge cells, or modify cell properties in the Rich Text Editor.

To insert, delete, merge cells, or modify cell properties, right-click a cell (the current cell) to display the context menu, then choose Cell to expand the submenu of cell actions (Figure 20-15), and choose actions as described in Table 20-5.

To select multiple cells, drag the mouse over the cell, then right-click to open the context menu.

Figure 20-15 Rich Text Editor: Table Cell Actions

Description of Figure 20-15 follows
Description of "Figure 20-15 Rich Text Editor: Table Cell Actions"

Table 20-5 Rich Text Editor: Table Cell Menu Selections

Action Description

Insert Cell Before

Inserts a new cell before the current cell(s).

Insert Cell After

Inserts a new cell after the current cell(s).

Delete Cells

Deletes the current cell(s).

Merge Cells

Merges multiple selected cells into one. This option is available only if two or more cells are selected.

Merge Right

Merges the selected cell with a cell on its right. This option is available only if no more than one cell is selected.

Merge Down

Merges the selected cell with a cell located below it. This option is available only if no more than one cell is selected.

Split Cell Horizontally

Splits the selected cell in two, creating a new cell on its right. The content of the cell appears in the original, left cell. This option is available only if no more than one cell is selected.

Split Cell Vertically

Splits the selected cell in two, creating a new cell below it. The content of the cell appears in the original, upper cell. This option is available only if no more than one cell is selected.

Cell Properties

Opens the Cell Properties dialog, where you can configure cell size, type, color, and content alignment, as described in Editing Table Cell Properties in the Rich Text Editor.

Editing Table Cell Properties in the Rich Text Editor

In the Rich Text Editor, table cells can be further customized, creating a unique look and feel.

From the table context menu, select Cell, then Cell Properties to open the Cell Properties dialog (Figure 20-16) where you can set cell properties for the table, as described in Table 20-6.

Figure 20-16 Rich Text Editor: Table Cell Properties Dialog

Description of Figure 20-16 follows
Description of "Figure 20-16 Rich Text Editor: Table Cell Properties Dialog"

Table 20-6 Rich Text Editor: Table Cell Properties

Action Description

Width

Enter the width of the cell, selecting either pixels or a percent value. Giving the width as a percent value lets you set the proportion of the row that the cell (and the column it is located in) will occupy.

Height

Enter the height of the cell in pixels.

Cell Type

Select the type of the table cell — either a normal data cell or a header cell with special formatting.

Word Wrap

Select whether or not to wrap content in the current cell.

Rows Span

Enter a numeric value to specify the number of rows over which to stretch the cell downward. This value sets the rowspan attribute.

Columns Span

Enter a numeric value to specify the number of columns over which to stretch the cell to the right. This value sets the colspan attribute.

Horizontal Alignment

Select the horizontal alignment of table cell contents: Left, Center, or Right.

Vertical Alignment

Select the vertical alignment of table cell contents: Top, Middle, Bottom, or Baseline.

Background Color

Border Color

Enter the color of the cell background and border using any of the following methods:

  • Enter an RGB value in rgb(nn, nn, nn) format, where nn is a numeric value on a scale from 0 to 255 representing the red, green, and blue channel.

  • Enter a hexadecimal RGB value, in #nnnnnn format, where the nnnnnn is the three pairs of hex color values representing the red, green, and blue channel.

  • Click Choose to open the Select color dialog where you can select from the color palette.

Editing Table Rows in the Rich Text Editor

In the Rich Text Editor, you can insert or delete table rows.

To insert or delete rows in a table, right-click a row (the current row) to display the context menu, then choose Row to expand the submenu of row actions (Figure 20-17), and choose actions as described in Table 20-7.

To select multiple rows, drag the mouse over the rows, then right-click to open the context menu.

Figure 20-17 Rich Text Editor: Table Row Actions

Description of Figure 20-17 follows
Description of "Figure 20-17 Rich Text Editor: Table Row Actions"

Table 20-7 Rich Text Editor: Table Row Menu Selections

Action Description

Insert Row Before

Inserts a new row before the current row(s).

Insert Row After

Inserts a new row after the current row(s).

Delete Rows

Deletes the current row(s).

Editing Table Columns in the Rich Text Editor

In the Rich Text Editor, you can insert or delete table columns.

To insert or delete columns in a table, right-click a column (the current column) to display the context menu, then choose Column to expand the submenu of column actions (Figure 20-18), and choose actions as described in Table 20-8.

To select multiple columns, drag the mouse over the columns, then right-click to open the context menu.

Figure 20-18 Rich Text Editor: Table Column Actions

Description of Figure 20-18 follows
Description of "Figure 20-18 Rich Text Editor: Table Column Actions"

Table 20-8 Rich Text Editor: Table Column Menu Selections

Action Description

Insert Column Before

Inserts a new column before the current column(s).

Insert Column After

Inserts a new column after the current column(s).

Delete Columns

Deletes the current column(s).

Using the Keyboard in the Rich Text Editor

The Rich Text Editor is compliant with several accessibility standards, including the Web Content Accessibility Guidelines (WCAG), the US Section 508 Amendment to the Rehabilitation Act of 1973 and the IBM Web Accessibility Checklist. To this end, you can use the RTE with the keyboard as well as a screen reader. The currently supported screen reader solution is JAWS.

For more information about accessibility in Oracle WebCenter Portal, see Setting Your Accessibility Options for WebCenter Portal.

Table 20-9 summarizes the keyboard keys and combinations available to you to navigate and edit text in the RTE.

Table 20-9 Rich Text Editor: Keyboard

Keyboard Keys Description

Alt+F10

Moves to the toolbar.

Tab

In the toolbar, moves to the next button group.

In a dialog, moves to the next element.

Shift+Tab

In the toolbar, moves to the previous button group.

In a dialog, moves to the previous element.

Left Arrow/Right Arrow

In the toolbar, moves between buttons within a button group.

In a dialog, moves within a field.

Enter

In the toolbar, selects the current button or menu item, or expands a drop-down list or menu.

In a dialog, confirms entry at current cursor location.

Down Arrow/ Up Arrow

Moves between selections in a drop-down list.

Esc

Closes a menu without executing any command. When inside a submenu, closes the submenu and returns focus to the parent context menu. Press Esc again to close it. In a dialog, cancels entries and closes dialog (equivalent to clicking Cancel or Close).

In the editing area:

Shift+F10

Opens the context menu of the current element (use down arrow and up arrow to move between selections in the menu, and Enter to select an action).

Alt+F10

Moves to the tab selection in a dialog (use left and right arrow keys to move between tabs, and Enter to move to the fields on a tab).

Ctrl+A

Selects the entire content in the editing area.

Ctrl+B

Changes the formatting of the selected text to bold or remove the bold formatting of the selected text.

Ctrl+C

Copies highlighted selections to the clipboard.

Ctrl+I

Changes the formatting of the selected text to italics or remove the italics from the selected text.

Ctrl+U

Underlines the selected text or remove the underline formatting of the selected text.

Ctrl+V or Shift+Insert

Pastes the content on the clipboard at the current cursor location.

Ctrl+X or Shift+Delete

Cuts highlighted selections to the clipboard.

Ctrl+Y

Performs the redo operation.

Ctrl+Z

Performs the undo operation.

Exposing an Existing Wiki Document in the Portal Navigation

If you have created a wiki document within a wiki page, it is not automatically added to the portal navigation.

This section includes the following topics:

Exposing an Existing Wiki Document as a Wiki Page

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 portal navigation. However, when you create a wiki document using the New Wiki Document action, the wiki document is listed only in the document hierarchy. For easy access to such a wiki document, you can publish it to appear as a page in the portal navigation.

To publish an existing wiki document as a page in the portal navigation:

  1. In the Content Manager task flow, create a folder with the same name as the existing wiki document at the root level of the portal (see Working with Folders and Files). For example, if the existing wiki document is named Member Meeting Schedule, create a folder named Member Meeting Schedule (Figure 20-19).

    Figure 20-19 Folder Created at the Portal Root Level

    Description of Figure 20-19 follows
    Description of "Figure 20-19 Folder Created at the Portal Root Level"
  2. Move the existing wiki document into the newly created folder.

    Note:

    The wiki document must have been originally created using the New Wiki Document action, as described in Creating a Wiki Document Within a Wiki Page.

  3. Create a new page in the portal, selecting the Wiki page style.
  4. In the Title field, enter the display name of the existing wiki document that you want to expose; for example, Member Meeting Schedule.

    Note:

    While there are restrictions on naming files (including wiki documents), there are no naming restrictions for page names. Thus, while any of the following characters can be used to name a 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_.

  5. Click Create.

    The wiki document is now exposed as a separate page in the navigation area. The location depends on the page template used by your portal. Figure 20-20 shows the Member Meeting Schedule wiki document exposed as a page in the navigation area in a portal.

    Figure 20-20 A Wiki Document Exposed as a Page

    Description of Figure 20-20 follows
    Description of "Figure 20-20 A Wiki Document Exposed as a Page"

Exposing an Existing Wiki Document Using Content Presenter

Content Presenter enables you to select a wiki document, and render its content in a specific template on a page.

This is an advanced task, covered in Publishing Content Using Content Presenter in Building Portals with Oracle WebCenter Portal.

Managing Wiki Documents

Managing a wiki document is like managing any file, as described in Working with Folders and Files.