Navigation

The Editor

Last update: November 3rd 2024

The Editor facilitates the organization and detailed editing of your Module's content. It consists of three main components: the Editable Page, the Node Tree, and the Node Details Panel. Use this interface to arrange Nodes, edit their rich-text content, and prepare your Module for in-game access, for printing or for sharing.

Screenshot of the Board

Editable Page

This area displays the contents of the Module’s Nodes, or only the contents of the ones you selected. Here, you can modify any Node’s content with standard word processing tools. You can also add images.

Screenshot of the Editor's Page

A vertical dotted line on the left is a selection indicator. When a Node is selected, certain functions are accessible, such as rolling the random table when one is connected to the Node, or displaying or hiding the notes block .

Screenshot of the Editor's Page

The toolbar includes the following functions:

The button can be used to switch the Editable Page between the available visual themes. Three themes are available at the moment: Standard, Fantasy and Cyberpunk. Other themes, and additional customization options, will be available in the future.

The button will toggle the 'reader mode'. In reader mode, the overlay buttons in the Editable Page are hidden.

The , , , , , and buttons provide classic formatting functions.

The link button lets you insert or modify a link. Only secured https links are supported.

The mention lets you reference another Node inline. More information about this in the dedicated Mentions section.

The sticky note button lets you wrap some content in a sticky note style. This can be useful to highlight a description, a GM note, or anything that needs standing out.

The first image button lets you insert an image at the position of the cursor. You can select the image from the Library.

The second image button is a handy shortcut that lets you insert the Node's featured image in your content.

Selecting an image by clicking on it displays a toolbar dedicated to that image.

The and buttons can be used to change the size of the image, while the alignment buttons lets you position the image on the left, right or center of the content.

Finally, the magnifying glass button lets you zoom in on the image, while the trash button lets you delete the image from the content.

Screenshot of the Board's context menu

Mentions

Node Mentions offer a flexible way to reference other Nodes within the text content of a Node, creating a "soft-link" that does not bind Nodes as tightly as the dedicated linking features.

Creating Mentions:

Inline Mention: While typing in the Editor, press the "@" key to trigger the Mention feature. This action opens a floating search window, allowing for immediate searching of Nodes by name. Navigate the search results using the arrow keys and select the desired Node to insert a Mention. After selection, you can continue typing without interruption.

Toolbar Mention Button: To use this feature, first position your text cursor where you wish to insert a Mention or select existing text to be linked. Clicking the button on the toolbar will open a selection window. Here, you can choose the appropriate Node to link to the selected text. If the caret is positioned within a word, the entire word will be automatically selected and linked as a Mention.

Clicking on a Mention in the Editor will highlight the referenced Node in the Node Details Panel of the Editor. If you press the Ctrl key while clicking, the Editor will also scroll to bring the referenced Node into view, allowing for efficient navigation and reference checking within larger Modules.

Other features will be added to leverage the benefits of Mentions in the next releases. We only laid the groundwork for more sophisticated interactions and utilities.


Node Tree

This tree contains the Nodes selected to be open in the Editor. It allows for their reordering via drag-and-drop. The order in the Node Tree will always be mirrored in the Editable Page.

Drag-and-drop is done using the handle icon on the left of each Node item in the tree. Multiple Nodes can be selected using the control key while left-clicking on each Node.

Selecting one Node will display its details in the Node Details Panel.

The button will let you decide whether or not the Node appears in the Editable Page.

The “Search” input field will let you filter the Nodes by name. A filter button on the far right of the search field provides additional filtering options. You can filter Nodes by type or select specific Tags if they are available in the Module. The filter button turns blue to indicate when a filter is active.

The button can be used to activate or deactivate the synchronization between the Node Tree and the Editable Page. When the synchronization is activated, the same Nodes will be displayed in both the Node Tree and the Editable Page.

Screenshot of the Board's context menu

The button at the top right of the Node Tree will let you create a new Node. A dialog window will ask you for the type and the name of the new Node.

Right-clicking on a Node in the tree will display a contextual menu with various actions (or a long press on touch devices). Some of these actions can also be applied to a selection of Nodes. To select multiple Nodes, hold down the Ctrl key while clicking.


Node Details Panel

Provides meta-information and available actions for the currently selected Node. These are divided into three tabs:

Information Tab : features general information about the Node such as its title, type and its Featured Image. It will also display two input fields dedicated to notes:

  • The Tags section contains a Tag Box you can use to manage the Tags associated with this Node. You can find more information about managing a Node's Tags in the dedicated page.
  • The “Node Scratchpad” lets you store any kind of notes you want to associate with this Node.

Linked Nodes Tab : features the list of Nodes connected to the one selected in the Node Details Panel. From this tab you can remove any of the connections, or you can add new ones. Any of the listed Node can also be selected.

Random Tab : this is where you can link the selected Node to a Random Table. When the selected Node is linked to a Random Table, it will be featured here, and you will be able to remove the link or change it for another Random Table. In this tab you also have the possibility to roll the linked Random Table.

Print/PDF Preview

The Print/PDF Preview feature allows you to review how your Module will appear when printed or exported as a PDF. It opens a modal with two panels: the left panel displays the Editor with your Nodes, and the right panel shows the page layout with page breaks.

The right preview panel can be zoomed in or out to adjust the display for your convenience.

  • Preview Panel: When activated, this panel shows a visual representation of your Module’s content divided into pages. The display updates automatically as you modify the content.
  • Page Breaks: You can manually insert page breaks using the dedicated button Page Break in the toolbar or adjust page breaks by dragging them in the left Editor panel.
  • Content Control: Only Nodes visible in the Editable Page will be included in the preview. You can toggle Node visibility using the Node Tree in the Editor.
  • Export Options: Once satisfied with the layout, use the print button to open your browser’s print settings and either print the module or save it as a PDF.

Note: This section of the documentation is currently under development and will be updated with more comprehensive information soon. Check back regularly for the latest updates and enhancements. Thank you for your understanding!