Rich-text editor

Brightspot's rich-text editor provides tools for formatting text (such as boldface or italics), inserting images, videos, and hyperlinks, and many other features available in traditional word processors.

As the width of the rich-text editor decreases, many of the options are nested under . The width may change due to preview being open, screen resolution, screen size, etc.

Note

Brightspot provides full support for the UTF-8 encoding standard. If you are publishing in a character set that conforms to this standard, editors can work natively in Brightspot, and visitors interact naturally with your published pages.

Formatting text

Brightspot's rich-text editor carries a number of formatting options that editors may use in their content.

To format text:

1. Enter or select the text to be formatted.

2. Click desired formatting from the toolbar:

   • Bold
   • Italic
   • Underline
   • Strikethrough
   • Superscript
   • Subscript
   • Clear Formatting

Aligning text

You can choose simple text alignment in the rich-text editor.

To align text:

1. Enter or select the text to be aligned.

2. Click desired alignment from the toolbar:

   • Left
   • Center
   • Right

Adding lists

You can add bulleted or numbered lists in the rich-text editor.

To add lists:

1. Enter or select the text to be set in a list.

2. Click desired list type from the toolbar:

   • Bulleted list
   • Numbered list

For numbered lists, you can reset the numbering if needed.

To reset numbering:

1. Double-click any list item's number in the list.
2. In the Reset Numbering popup, enter a number in the text field. Brightspot resets the list number to the number you enter.
3. Click Save.

Indenting text

You can increase or decrease indentation in the rich-text editor.

To indent text:

1. Enter or select the text to be set in a list.

2. Click desired indentation from the toolbar:

   • Add indent
   • Remove indent

Adding hyperlinks

You can add hyperlinks to the rich-text editor.

To add a hyperlink:

1. Enter or select the text you want to hyperlink.

2. Click .

3. Under Link, do one of the following:

   • Internal–Search for and link to an existing asset. Under the Advanced tab, select the link target and add an anchor link if desired.
   • External–Add an external URL. Under the Advanced tab, select the link target.
   • Site Search–Search for and link to an existing site search.

4. Click Save & Close.

Embedding enhancements

Note

Enhancements are content types you can insert into the rich-text editor. Because they are content types, you can learn more about out-of-the-box enhancement options in the Content Types guide; however, this topic does cover enhancement controls, like moving enhancements around and aligning them.

You can embed a variety of enhancements into the rich-text editor, from images, to videos, to entire modules.

Inline vs. shared enhancements

Similar to other inline (one-off) and shared assets in Brightspot, you can choose to build an enhancement from scratch (inline) or pull in an existing one (shared).

Type	Description
Inline	You build the enhancement from scratch in the rich-text editor. Once built, it only exists in this asset and cannot be shared to other assets. Because it lives in this asset, the asset itself needs to be saved for your work to be preserved.
Shared	You pull in an existing enhancement (either an asset or a module) to use as an enhancement. The enhancement is already built and does not require additional changes before adding it to the rich-text editor.

Moving enhancements around

At times, you may need to re-position enhancements. You can move enhancements around in two ways:

• Cut and paste the enhancement.
• Click the enhancement to display the editing toolbar, and then click one of the buttons described in the following table.

Button	Description
	Moves the enhancement up one paragraph.
	Moves the enhancement down one paragraph.
	Turns on drag-and-drop. After clicking the button, move the mouse to the new position, and then click to place the enhancement.

Enhancement alignment

At the bottom of its configuration popup, each enhancement contains alignment options. The table below shows a sample of where the enhancement is placed within the text based on the alignment option chosen.

Alignment	Example
Left Alignment
Center Alignment - Contained
Right Alignment

Dragging and dropping enhancements

You can upload new shared media into the rich-text editor by dragging and dropping.

Adding inline code

You can add inline code in the rich-text editor.

To add inline code:

1. Enter or select the text to be set in inline code.
2. Click in the toolbar.

Adding headers

You can add headers of various sizes in the rich-text editor:

To add headers:

1. Enter or select the text to be set as a header.
2. Click Format , then select a heading size (H2, H3, H4, H5). You may also add a horizontal divider by selecting HR.

Adding HTML or iframe embeds

You can add HTML or iframe embeds in the rich-text editor.

To add HTML or iframe embeds:

1. Click inside of the rich-text editor where you want to add the HTML or iframe embed.

2. Click , and then select either HTML or Iframe.

3. In the Shared field, do one of the following:

   • Search for and select an existing HTML or iframe embed.

   • Click Create New to add a new one.

     • HTML–Add an Internal Name and then insert your code into the Raw HTML field.
     • Iframe–Add an Internal Name and a URL, then define the iframe's height and width in pixels.

4. Click Save & Close.

Adding quotes

You can add quotes to better display and highlight them in the rich-text editor.

To add quotes:

1. Enter or select the text to be set in a quote.
2. Click .
3. Attribute the quote in the Attribution field.
4. Click Save & Close.

Adding snippets

You can add snippets–small pieces of modular content–in the rich-text editor.

To add snippets:

1. Click inside of the rich-text editor where you want to add the snippet.
2. Click .
3. Search for and select the desired snippet, or create a new one. See Snippet.
4. From the Variant list, select a variant if desired.
5. Click Save & Close.

Adding tables

You can add tables in the rich-text editor.

Action	Instructions
Add table	1. Click inside of the rich-text editor where you want the table to appear. 2. Click , and draw a table on the model.
Add row	1. Place the cursor inside the table where you want to add a row. 2. Click , and select Add Row Above or Add Row Below.
Delete row	1. Place the cursor inside the row you want to delete. 2. Click , and select Delete Row.
Add column	1. Place the cursor inside the table where you want to add a column. 2. Click , and select Add Column Left or Add Column Right.
Delete column	1. Place the cursor inside the column you want to delete. 2. Click , and select Delete Column.
Merge cells	1. Click and drag to select the cells you want to merge. 2. Click , and select Merge Cells.
Split cells	1. Click in the cell you want to split. (The cell must be one that you previously merged.) 2. Click , and select Split Cell.

Custom keyboard

You can insert unicode characters using a virtual keyboard in the rich-text editor.

To use the custom keyboard:

1. Click inside of the rich-text editor where you want the unicode character to appear.
2. Click .
3. Select a character from the keyboard.

To add characters to the custom keyboard, see Adding characters to the rich-text editor's virtual keyboard.

Track changes

The rich-text editor provides tools for managing changes and comments.

To toggle on track changes:

• On the toolbar, toggle on Track Changes to see the track-changes toolbar. The toolbar includes the following options:

  • Accept Changes—Accepts the change your cursor is on.
  • Reject Changes—Rejects the change your cursor is on.
  • Accept All—Accepts all changes.
  • Reject All—Rejects all changes.
  • Preview—Previews the text with all changes accepted.

These controls are also available in full-screen editing mode.

Commenting

You may leave comments inside of the rich-text editor to add additional context or direction.

Adding comments

1. Position the cursor where you want to place the comment. Ensure no text is selected.
2. On the toolbar, click .
3. Begin typing your comment.
4. Click again to exit commenting mode.

tip

You can configure the rich-text editor to create comments from selected text. For details, see Enabling conversion from text to in-line comments.

Deleting comments

1. Click inside the comment.
2. On the toolbar, click .

Showing or hiding comments

• On the toolbar, click .

Responding to comments

You can respond to an editor's comments in full-screen mode.

1. Enter full-screen mode by clicking . All comments and tracked changes appear in the right rail.
2. Click for the comment you want to respond to.
3. Delete a response by clicking .

AI features

If you have the AI plugin, you can use Create with AI to generate content. See Using Create with AI

Find and replace

You can find and replace specific terms.

To find and replace:

1. In the rich-text editor toolbar, click .

2. Enter the term you want to find.

   • The term is highlighted throughout the rich-text editor.
   • The number of times that term is present is noted to the right of the search field. Click and to toggle through instances of the term. The currently selected instance is highlighted.

3. Click to show the replace functionality.

4. To add additional logic to what Brightspot finds, do the following:

   • Click Case Sensitive if you want Brightspot to only find case sensitive matches with the text you entered in the search field. For example, if you click Case Sensitive and enter graph in the search field, Brightspot only finds instances of graph (which might include polygraph and graphs, but not Graph).
   • Click Whole Word if you want Brightspot to only find the exact text you enter into the search field. For example, if you click Whole Word and enter graph in the search field, Brightspot only finds instances of graph (and not polygraph or graphs).

5. To replace the selected term with another, enter a new term in the Replace with field. Once you enter a term in this field, the Replace and Replace All buttons become available.

6. To replace the currently highlighted term, click Replace. To replace all occurrences of the original term, click Replace All.

Full-screen editing

You can expand the rich-text editor to your entire browser window.

To enter full-screen editing mode:

• On the toolbar, click .

Keyboard shortcuts

The following table lists some of the keyboard shortcuts available in the editing area. (Your version of Brightspot may have different keyboard shortcuts.)

Action	Shortcut (Windows)	Shortcut (Mac)	Shortcut (Linux)
Select
Select all.	Ctrl-A	⌘-A	Ctrl-A
Select one character to the right.	Shift-Right	⇧-Right	Shift-Right
Select one character to the left.	Shift-Left	⇧-Left	Shift-Left
Select to the end of line.	Shift-End	⇧-Ctrl-Right	Shift-End
Select to beginning of line.	Shift-Home	⇧-Ctrl-Left	Shift-Home
Select one line down.	Shift-Down	⇧-Down	Shift-Down
Select one line up.	Shift-Up	⇧-Up	Shift-Up
Select to end of editing area.	Shift-Ctrl-End	⇧-⌘-Down	Shift-Ctrl-End
Select to beginning of editing area.	Shift-Ctrl-Home	⇧-⌘-Up	Shift-Ctrl-Home
Select next word.	Shift-Ctrl-Right	⇧-⌥-Right	Shift-Ctrl-Right
Select previous word.	Shift-Ctrl-Left	⇧-⌥-Left	Shift-Ctrl-Left
Select one page down.	Shift-PageDown	⇧-PageDown, ⇧-Fn-Down
Select one page up.	Shift-PageUp	⇧-PageUp, ⇧-Fn-Up
Move
Move cursor up.	Up	Up, Ctrl-P	Up
Move cursor down.	Down	Down, Ctrl-N	Down
Move cursor left.	Left	Left, Ctrl-B	Left
Move cursor right.	Right	Right, Ctrl-F	Right
Move to beginning of paragraph.		Ctrl-A
Move to end of paragraph.		Ctrl-E
Move cursor one word to left.	Ctrl-Left	⌥-Left	Ctrl-Left
Move cursor one word to right.	Ctrl-Right	⌥-Right	Ctrl-Right
Move cursor to beginning of editing area.	Ctrl-Home	⌘-Up	Ctrl-Home
Move cursor to end of editing area.	Ctrl-End	⌘-Down	Ctrl-End
Move cursor to end of line.	End	⌘-Right	End
Move cursor to beginning of line.	Home	⌘-Left	Home
Scroll down one page.	PageDown	PageDown, Fn-Down
Scroll up one page.	PageUp	PageUp, Fn-Up
Delete
Delete beginning of line.		⌘-Delete	Ctrl-Shift-Backspace
Delete to end of line.			Ctrl-Shift-Delete
Delete to the left.	Backspace	Delete	Backspace
Delete to the right.	Delete	Ctrl-D	Delete
Delete word to right.	Ctrl-Delete		Ctrl-Delete
Delete word to left.	Ctrl-Backspace		Ctrl-Backspace
Paragraph alignment
Left	Ctrl-Alt-L	⌘-⇧-L	Ctrl-Alt-L
Center	Ctrl-Alt-E	⌘-⇧-E	Ctrl-Alt-E
Right	Ctrl-Alt-R	⌘-⇧-R	Ctrl-Alt-R
Text Formatting
Bold	Ctrl-B	⌘-B	Ctrl-B
Italic	Ctrl-I	⌘-I	Ctrl-I
Underline	Ctrl-U	⌘-U	Ctrl-U
Strikethrough	Ctrl-Alt-X	⌘-⇧-X	Ctrl-Alt-X
Superscript	Ctrl-Shift--	⌘-.	Ctrl-Shift--
Subscript	Ctrl-=	⌘-,	Ctrl-=
Clear character formatting	Ctrl-Space	⌘-\	Ctrl-Space
Hyperlink	Ctrl-K	⌘-K	Ctrl-K
Lists
Bullets	Ctrl-Shift-8	⌘-⇧-8	Ctrl-Shift-8
Numbers	Ctrl-Shift-7	⌘-⇧-7	Ctrl-Shift-7
Demote list level	Ctrl-]	Ctrl-]
Promote list level	Ctrl-[	Ctrl-[
Line-break inside of list	Shift-Enter	Shift-Return
Find
Finds in editing area	Ctrl-F	⌘-F	Ctrl-F
Special
Type raw HTML	Ctrl-Shift-C	Ctrl-⇧-C	Ctrl-Shift-C
Show keyboard with special characters	Ctrl-Shift-K	⌘-⇧-K	Ctrl-Shift-K
Undo	Ctrl-Z	⌘-Z	Ctrl-Z
Redo	Ctrl-Y	⌘-⇧-Z	Ctrl-Y
Enhancements
Pull quote	Ctrl-Shift-Q		Ctrl-Shift-Q
Image	Ctrl-Shift-I	Ctrl-⇧-I	Ctrl-Shift-I
Gallery	Ctrl-Shift-G	Ctrl-⇧-G	Ctrl-Shift-G
Playlist	Ctrl-Shift-P	Ctrl-⇧-P	Ctrl-Shift-P
Video	Ctrl-Shift-V	Ctrl-⇧-V	Ctrl-Shift-V
Module	Ctrl-Shift-M	Ctrl-⇧-M	Ctrl-Shift-M
Collaboration
Toggle comment insertion	Ctrl-Shift-′	Ctrl-⇧-′	Ctrl-Shift-′