Section Editor

Section Editor

Screenshot: Section Editor

A section in docendo is a set of physical pages consisting of blocks. A page by definition is a unit that can be displayed as a whole by your browser (it corresponds to a HTML page) whereas blocks can best be compared to a paragraph - they are a combination of formatted text and media resources.

In most cases, a single page is sufficient for one section, but you may add new pages using the icon in the toolbar. You can switch between the pages with the links “Page 1-n” in the area labeled with ”Pages in this section:”.

The Section Editor always displays all blocks of the currently selected page. New blocks can be added with the icon. The sequence of blocks on a page can be modified by moving up a block (), moving down a block () or cutting () and then pasting ().

Adding resources to a block

Resources can be added to a block with the button, which gives you the option to:

Search for an existing resource and adding it
Upload a new resource and adding it
Create a new table and adding it afterwards
Create a new formula and adding it afterwards

All resources that have been assigned to a block are displayed by either a thumbnail version or their resource type icon. Next to that display, you can see the icon, which lets you define a popup resource. When previewing the section, you will see that the popup resource will be opened in a new window when clicking on the resource it has been assigned to, or on the icon.

Each resource can have a subtitle which you can edit with the icon next to it.

If you have more than one resource assigned to a block, you can modify the order in which they get displayed using the and icons.

The block editor

docendo utilizes a rich-text editor component called TinyMCE to let you format the text of a block. Most of the buttons in the block editor's toolbar are for creating formatted text, e.g. marking text as bold, italic, sub-script, super-script or creating ordered and unordered lists. Some other buttons have a specific function to docendo, which are:

: Mark selected text as a block heading. All block headings will be listed on top of the page when previewing/exporting it and link to the corresponding block.
: Mark selected text as link to a popup resource. This resource will be openened in a new window when the link is clicked.
: Insert a resource at the current text cursor position.
: Mark the selected text as a glossary entry and open the glossary entry editor to create/edit it. For further information, see the documentation on glossary entries.
: Mark the selected text as a glossary entry and open a search dialog to look for an existing glossary entry to link. For further information, see the documentation on glossary entries.
: Insert a bibliographical reference at the current text cursor position. See the documentation on bibliographical references for further information.
Screenshot: Special characters

: Add a special character at the current text cursor position. See the screenshot to the right for an illustration of possible special characters.