Architecture

The Bellshape Assessment Platform is organized around documents. Any entity you see in the folder structure on the left side of the Manager is a document.

Bellshape documents are hierarchically organized. Each can be understood as an (expandable) tree representing the syntactic structure of of the document. A tree is made up of nodes and branches. Each node is either a root node, a branch node or a leaf node. You can also think of the nodes as parent and child nodes. A parent node has at least one other node under it. For more information about parse trees see e.g. Wikipedia.

Another way to understand the hierarchical organization of a Bellshape document is to see it as a book built from chapters, built from paragraphs, built from sentences, built from words, built from letters. And paragraphs may be alternated with pictures, tables, and so on.

The root node (i.e. the first element) of the Bellshape document contains the name of the document. Every document has a name and that name must be unique. Not for the system but for the user. If there are more documents with the same name, endless confusion may arise. In some documents the name is followed by a description. The description gives you room to expand on usage or contents of the document.

This general description applies to all Bellshape documents. To make things a little more tangible see a (simplified) tree for a ContentComponent below.

        ContentComponent
            Name  
             |---Paragraph
             |       |--- Style
             |       |--- Text
             |---Paragraph
             |       |--- Style 
             |       |--- Text
             |       |--- Image
             |---Table
             |       |--- Row
             |       |      |--- Cell
             |       |      |--- Cell
             |       |--- Row
             |              |--- Cell
             |---Paragraph
                     |--- Style
                     |--- Text

Terminlogy

Building an assessment site is a matter of linking documents. As explained on this page a document is built from parts that will be called elements. The elements at the level of a paragraph will be called block elements. Elements at the level of a text element will be called inline elements. See also InlineContentComponent.