Using the Document view

The Storyboard supports different editing stories in different representations to support different use cases. The Document view is useful for creating many subsequent blocks by aligning all blocks in a story in one document, similar to those seen in Microsoft Word, Google Docs, and Notion.

In the Document view, blocks are indicated by a vertical bar on the left side of the block’s content. A black, thicker vertical bar indicates a selected block.

The Document view

The Document view

The Just continue action will not show anything on the block in the Document view to maintain brevity. As you’re building your story in the Document view, you may wish to open the Inspector pane to get access more options for the currently selected block.

You can see how other actions look in the students’ chat room in the Document view. Clicking on it will immediately bring you to the Inspector where you can modify it.

You can open the Inspector pane by clicking on this icon in the pane switcher at the top-right corner of the Storyboard page.

You can open the Inspector pane by clicking on this icon in the pane switcher at the top-right corner of the Storyboard page.

Working with blocks

To split a block, press Ctrl+Enter (on Windows) or ⌘ Enter (on macOS). This command is similar to a section break in most word processing software. The new block will carry over the split content and maintain the linear relationship between the blocks.

To create a new block between two blocks, use the same shortcut on either the end of the to-be-proceeding block or start of the to-be-preceding block.

You can combine a block to the block above it by pressing Backspace (on most keyboards) or Delete (on Apple keyboards) at the start of said block.

Similarly, you can combine a block to the block below it by pressing Delete (on most keyboards) or fn+Delete (forward delete, on Apple keyboards) at the start of said block.

To split a block into disconnected blocks, press Ctrl+Shift+Enter (on Windows) or ⌘⇧ Enter (on macOS). This command is similar to a page break in most word processing software. A section indicator between two blocks indicates that they are disconnected.

A section indicator between two disconnected blocks. The block below shows a chip that shows the block that comes before itself. You can hover on the section indicator to see its description, and the source block chip for a preview.

A section indicator between two disconnected blocks. The block below shows a chip that shows the block that comes before itself. You can hover on the section indicator to see its description, and the source block chip for a preview.

Sections

<aside> 💡

A section in the Document view refers to a sequence of uninterrupted connected blocks. Section indicators demarcate sections in the Document view.

Notably, a story in Cikgo is a graph, so the notion of “section” is pedantically meaningless. However, when flattened linearly into something that looks like the Document view, branches in the story can make the visualisation hard to understand. Hence, think about sections in the Document view as paths in the story.

</aside>

You can select multiple blocks by clicking on the empty side of the Document view, dragging until a blue rectangle appears, and selecting the blocks you wish to select. This is known as rectangle selection, similar to what you’ve probably seen in file managers or photo-editing software.

Selected blocks have a blue tint. The selection indicator will appear at the top of the Document view when at least one block is selected.

Selected blocks have a blue tint. The selection indicator will appear at the top of the Document view when at least one block is selected.

A blue selection indicator will appear at the top of the Document view indicating the number of selected blocks. Click it and you’ll find several useful commands and their shortcuts, if available.

The selection menu

The selection menu

Reordering blocks

If you wish to reorder some blocks, select the blocks you wish to reorder and click the squeeze bar where you wish the selected blocks to be inserted into.

Squeezing preserves the connections between the selected blocks and will add connections to the blocks between the squeeze point, if available.

You can only squeeze blocks that are in the same section, though you can squeeze blocks into other sections. Squeeze bars will appear if squeezing is available for the currently selected blocks, at squeeze points that can be squeezed into.