Back to Socialtext Documentation

Introduction

Rich Text mode lets you edit much as you would in a word processor, and hides the fancy punctuation that is visible in Wiki Text mode. You can switch between edit modes at any time by clicking a link that appears above the toolbar while editing a page:

Note to Macintosh users: Rich Text mode is not available in the Safari browser.

Toolbar

The toolbar above the editing window features buttons that will apply formatting to selected text or insert new elements.

	Makes plain text bold, or reverses bold text to normal text.
	Italicizes text, or reverses italicized text to normal text.
	Applies strikethrough to text, or reverses struckthrough text to normal text.
	Applies headings to selected lines in different sizes, descending from H1. Note that as headings, the lines will be included in any Table of Contents on this page.
	Turns headings back into normal text.
	Starts numbered lists Turns a selection into a list Reverses already numbered lines to normal text
	Starts bulleted lists Turns a selection into a list Reverses already bulleted lines to normal text
	Shifts paragraphs or bullets left.
	Shifts paragraphs or bullets right.
	Brings up the "Add a Link" dialog box to make wiki links, web links, or internal section links. See Create Link .
	Brings up the "Attached Image" dialog box to let you add an image. See Include an Image .
	Lets you add a table. See Create Table .
	Activates the "Insert" drop down menu. See Insert Menu .
	Lets you upload files so that you may attach them to a page. See Upload files .
	Lets you add tags to a page. See Add tags

Create Link

The button activates the "Add a Link" dialog box.

If you have text selected when you activate the button, the box will attempt to populate its fields based on the text.

To make an internal link (to a page within the same workspace), simply type in the name of the page, select it, and press the link button. When the Link dialog pops up, make any changes like adding link text, and Save.

To make an external link (to a page outside of the workspace), select the text you would like to turn into a link and press the link button. When the Link dialog appears, choose Web Link and type in the URL for the external link.

To make a link to a section within a page, also press the link button, select Section Link, and type the name of the section to which you wish to link.

Here's a detailed walkthrough of this feature: Using the Link button .

Include an Image

Clicking the button activates the "Attached Image" dialog box allowing you to display an attached image on your page.

This feature is explained in depth here .

Any image you choose to attach must first be uploaded to this or another page.

"More options" allows you to use an image attached to another page or another workspace. If you provide Link text, your page will contain a link to the image rather than the image itself.

Create Table

Creating a table will insert a grid of rows and columns at your cursor position.

When you click the button, you will first see this prompt box:

Enter the number of rows you wish to have for your table and click OK. Immediately the next prompt box will appear:

Enter the number of columns you need and click OK.

A small, empty table will then appear at the cursor position. Although it looks small the cells expand when you enter text or images.

Use Wiki Text mode to change the number of rows and columns in a table, or the nifty native table editor in Firefox in Rich Text mode.

Insert Menu

The Insert pulldown menu contains elements that you can add to a page, including Links and WikiWidgets.

To use the Insert menu, put the insertion point where you want the new element to appear; be sure the insertion point is surrounded by whitespace, pull down the menu and choose an element to pop up a dialog box. Fill in the text fields in the box and Save the information to insert the element into the page. Many of these dialog boxes have advanced options available if you click "More options".

For a complete description of all the items in this drop-down menu, visit Insert Menu Catalog.

Some WikiWidgets can only be edited in Wiki Text mode. Mouseover tooltips will tell you when that is needed.

Upload files

If you wish to add files to your page, you need to upload them first. The button allows you to do this by activating the "Upload files" dialog box.

The process for uploading files is explained in detail here: Attach a file or image

Add tags

The button allows you to add a tag to this page. It opens the following dialog box:

As you begin typing, the dialog box will provide suggestions based on the tags that already exist in the workspace.

Clicking a suggested tag will add that tag. To save your newly entered tag, press Enter or click the Save tag button.

NOTE: All workspace weblog names are also tag names. Assigning a weblog as a tag (e.g. assigning the tag My Weblog) publishes the page to that weblog.

More information on tags can be found here.

Keyboard Shortcuts

• Ctrl-B makes text bold.

• Ctrl-I makes text italic.

• Ctrl-D (for "deleted") makes text strikethrough.

• Ctrl-Z is used to undo actions.

• Most of the special punctuation available in Wiki Text mode (see Edit tips ) will work. For instance, enclosing a phrase between asterisks (*) will turn it bold upon saving.

Copying and Pasting from Web Pages or Microsoft Word

You can copy text from a browser window or from Word and paste it into Rich Text mode. Most of the formatting will be preserved.

Preview Mode

WikiWidgets makes the old Gray Dashed Boxes obsolete. All elements will appear as WikiWidgets in Rich Text mode.

A few WikiWidgets cannot be edited in Rich Text mode. In order to edit those, it is necessary to switch to Wiki Text mode. A mouseover tooltip will tell you when that is needed.

By clicking the Preview button (between Save and Cancel ), you can see exactly what the page will look like when you save it. While in Preview mode, click the Edit More button to return to editing.

Rich Text Mode Editing

Rich Text mode editing is not intended to be a complete word processor or HTML editor. It allows you to use basic formatting, and shows you formatting changes as you make them.

Here are some hints and tips for Rich Text mode users:

• Use the Preview button before saving, and Edit More if you need to. Switch to Wiki Text mode when Rich Text mode doesn't do what you need. Click the Edit tips link to get a list of formatting punctuation for Wiki Text mode.
• Some things your browser will let you do in Rich Text mode won't "take" when you Save. Examples are interactively resizing a table or an image, deleting an image, or indenting a list. A few other things, such as deleting an entire table, you may not be able to do at all.
• Copy and paste from a web page or a word processor will preserve some, but not all, of the appearance of the page once it is saved in the workspace.
• Avoid frustration: save early; save often. The workspace maintains a complete revision history, so you can always revert to your last good page if needed.

If you find bugs or problems, please let us know at support@socialtext.com

Wikiwyg (Simple Editing) Open Source Project

Rich Text mode is based on the Wikiwyg editing tool. Wikiwyg is an open source project led by Socialtext.

Back to Socialtext Documentation