Using the WYSIWYG editor in Sakai

General

Many Sakai@UD tools deploy a web-based html editor known as the FCKeditor. For general help using this tool, refer to the FCKeditor User's Guide.

Sakai-Specific Information

Migrating content created or maintained with the WYSIWYG editor

When copying content from one Sakai course into another, you should be sure to check for broken links to Resource files. For more information, see Copying Tools from an Existing Sakai Course.

Maintaining content created using a non-Sakai web editor

You should not attempt to maintain any html pages created outside Sakai using the WYSIWYG editor. For instance, if you upload content originally created in Dreamweaver, you should continue to maintain this content outside of Sakai, and use the Resources' update option to overwrite the older versions. Editing non-Sakai html can interfere with any javascript or stylesheet information located in the head of the page. Also, once you have saved changes using the Sakai WYSIWYG editor the first time, you will be unable to open it in the editor again. The page will appear empty in the editor, in both the design window and the source view.

Special characters (html entities) on the Sakai Home Page.

Some common text characters, such as <, >, &, are represented in html with special text strings. The WYSIWYG editor creates these strings automatically, so in most cases, there is no need to understand how or why this works. However, in some cases, especially when re-editing HTML in the Sakai Home Page, special characters are replaced with unwanted content (such as a broken image icon) each time you re-open the page in the WYSIWYG editor. This seems to be an issue only in the Home page, and can be corrected by deleting the non-desired content and re-entering the desired characters. You will have to repeat this process each time you edit the page.

Browser considerations

To ensure that the WYSIWYG editor appears and functions properly, you must use a supported browser; see Which browser should I use?

However, Internet Explorer is currently the only browser that supports the paste function within the editor. If you're using Firefox, see Problems pasting text into FCKeditor in Firefox.

Also, Internet Explorer is currently the only browser that supports the spellcheck feature. To use spellcheck, you must first download and install the ieSpell extension from the ieSpell download page.

If you are using...

Firefox If you use the Paste from Word button with a MS Word 2003 or 2007 file (.doc or .docx), the text may include formatting codes which are not visible until the entry is published. The problem is especially noticeable with Word 2003 .doc files.
Use the Paste as Plain Text button instead and copy the text from MS Word into the pop-up window. Reapply formatting as needed.
Internet Explorer Click the Paste from Word button and use CTRL-V to copy text from .doc or .docx files (MS Word 2003 or 2007) into the pop-up window. There may be minor formatting issues.

Additional Notes

Style menu screenshotRemoving text formats created with the Style menu.

Text formats created using the Style menu (shown at right) can not be removed in the WYSIWYG design view. To remove unwanted Styles, switch to Source view, or completely delete the styled text and re-create it.

Tab key: Avoid using the Tab key when editing html in the WYSIWYG editor. Doing so will cause your cursor to leave the Editing Textfield, which means that subsequent key strokes will not be entered into your html, and may cause unexpected results. For example, entering Tab followed by Enter or Space Bar often causes a button push outside the WYSIWYG editor. This can lead to inadvertant submission of Assignments, opening of a new interface, such as the Attachment interface, or the loading of a new web page entirely. Should you inadvertently strike the Tab key, you can re-enter the Editor Textfield by clicking inside it with your mouse.