CLaRK System Online User Manual

Main Editor Components

Back to Contents

This is a description of the most important components of the editor of the CLaRK System. The picture above is one example configuration of the system with one opened (work) document. The red labels point to the corresponding components, which are described below:

• Tree Panel

This panel shows the tree structure of the current document. When a new document is opened the tree structure is folded to its root node. The user then can expand it by clicking on the branches of the tree. The nodes in the tree are painted in two different styles depending on the type of the corresponding document nodes: for Element nodes - a folder looking icons (the yellow ones above) and black dot icons for the Text nodes. The names of the Element nodes are drawn in two colors, depending on their validity, that is, when a node contains an error which makes it non valid - it is colored in red. Otherwise it is blue. When pointing a red node, its corresponding error message appears in the Error Message Panel window. The list of all validation errors can be seen here.

Basic tree restructuring operations can be applied here by making right-clicks on the tree. Right-clicks over selected node(s) make a menu window to appear on the screen. A description of all  menu items can be seen here.

When a node is selected in the tree panel, its corresponding tag (or text node) in the Text area is selected too. A multiple selection of nodes in the tree can be made by pressing and holding the <Ctrl> key and pointing with the mouse the nodes to select.

• Text Area

This area shows the current document in XML format. By default, the tags are drawn in blue and the text is black. These colors can be changed by using menu Options/Visuals. In this area some of the tags and/or their content can be hidden or shown, new lines and line offsets can be inserted. For details see Document Layout.

Here, the user also can use a right mouse click for editing the structure of the document. After right clicking on a tag, a menu window appears with the same functions as in this in the Tree Panel. If the selection in the area is within a single text node, a list of tags appears and the user is asked to choose one of them to be put around the selected text.

When a tag is selected in the area, its corresponding node in the tree is selected too.

The system has the ability to show more than one Text Area for a document. Each area has its own layout which can be modified independently from the others. In this way, each area forms one view for the document. The different views are synchronized in a way that when a node is selected in one of them, the corresponding node in the others is also selected.

• Attribute Table

This table contains the attributes of the currently selected element node in the editor. The first column contains the attribute names. In the second one, the corresponding values are written. The second column is editable, that is the user can modify the values of the attributes. By using right mouse click the user can add and remove attributes for the current element node.

• Error Message Panel

This is a list, containing all the errors for the current document (if any). A full list of all error messages can be seen here.

By performing a double click on a certain error message, the node containing the corresponding error is selected in the Tree Panel and in the Text Area.

• Status Bar

This component shows system messages of  the system. When an operation is being performed, the color of the text is red. Otherwise it is black. While editing the document this bar shows the path from the root node to the current one using an abbreviated XPath expression.

• Keyboard Indicator

This button-indicator is used to show which keyboard-set is active in the system. There are two states of it: normal (in green) and auxiliary (in red). For more details about using keyboard-sets see Keyboard. By clicking on the indicator it changes its state alternatively (normal/auxiliary).

• Main Menu

A detailed description of the main menu can be found in this documentation.

• Toolbar

This toolbar is used for placing shortcuts to most frequently used functions from the Main Menu. Here is the list of all shortcuts and their target items in the menu:

Icon	Target Menu Item
	File / New
	File / Open
	File / Save
	File / Import
	File / Export
	Document / Validate
	Document / New View
	Options / Simple Tags
	Options / Show Attributes In Area
	Edit / Search
	Edit / Next
	Edit / Previous




• Scroll Buttons

These four buttons are used for scrolling the text area. The first two are used for scrolling line by line. The next two are for scrolling page by page.

The reason for creating these four buttons is that the Text Area does not contain the whole opened document, but only a fragment of it. The reason for this fragmentation is that showing a large document takes a huge amount of operating memory. Therefore the system tries to visualize as less as possible from it. So when the user navigates through the document, the Text Area dynamically changes its content. This text content generation can not be controlled by a default scroller. That is the reason for using these special scroll buttons.

• Text Processing Buttons

The first three buttons are used for shortcuts to Copy (Ctrl+C), Cut (Ctrl+X) and Paste (Ctrl+V) operations applied ONLY for text data. If the selection contains not only text, but also tags, the operation is not executed.

The last button: is a shortcut to menu Edit / Text Replace.




Back to Contents