Web Map

User Guide

1 Introduction

2 The Map and it's Items

2.1 Reading a Map

2.2 Navigate a Map

2.3 Add a New Item

2.4 Relate Two Items

2.5 Reorder Relations

2.6 Delete a Relation

2.7 Delete an Item

3 Edit

3.1 Add Content

3.2 Edit an Item

3.3 Edit a Relation

3.4 Edit the Content

4 Cut&Paste

4.1 Move/Copy an Item

4.2 Move/Copy a Relation

4.3 Cut&Paste Content

5 Multiple Maps

5.1 Namespace for Item Labels

6 External Helpers

6.1 Bookmark a Web Browser page

1 Introduction

This user guide explains how to use the major features of the Web Map user interface.

2 The Map and it's Items

How to handle a Web Map and it's items.

2.1 Reading a Map

You can read a map by focusing on a specific item of that map.

The Web Map about the Web Map, focusing on the initial item.

In the middle, white column you can see the label and the content of the item currently in focus. On both sides you find the labels of related items and their related ones as well.

When you hover over a label of a related item, you'll see it's first content (note, link,...) as a tooltip. A commented relation will show it's comment instead.

2.2 Navigate a Map

With a simple click on a relation box on eigther side of the current map item, will navigate to the related item and puts it into focus.

With a double-click you can shortcut to the first link in the content of the related item. If the item does not contain a link, the double-click equals a single click.

You can also use the cursor keys to select a relation (see it highlighted) and press Enter to navigate to the according, related item.

In the edit mode, the edit selection (Ctrl-cursors) on the relation boxes can also be navigated by pressing the Enter key.

2.3 Add a New Item

Simply press the Insert key to open an input box for the label of the new item.

In the edit mode you can "Insert" an item by mouse via the context menu of the currently focused item.

While entering the label, you can see the labels of the existing items of the map in an auto-complete list. If you choose to enter the label of an existing item, no new item will be created. In eighter way, new label or existing one, you will add a relation to connect the current item with the new/existing one.

If the label of the current item matches the input or an according relation to the input item already exists, the map will not be modified.

2.4 Relate Two Items

To relate the current item in focus with another existing item, you can "add an item" with the corresponding label of the existing item. This will not actually add a new item, but it will build the relation to the existing one.

2.5 Reorder Relations

Organize your map by changing the order of the relations or by moving them to the other side.

Simply drag a relation with the mouse to it's intended destination.

2.6 Delete a Relation

To remove a relation you have to switch into the edit mode.

In edit mode you select the relation, you'd like to remove, right-click for the context menu and choose the delete menu or simply press the Delete key.

2.7 Delete an Item

To delete a map item you have to switch into the edit mode.

In edit mode you select the item, in focus, right-click for the context menu and choose the delete menu or simply press the Delete key. The relations from and to the item (as far as known) will be deleted as well.

3 Edit

To be able to edit labels and content, you have to switch into the edit mode.

3.1 Add Content

With the context menu you can add notes, links and images to the content of a map item.

Right-click for the context menu and choose the "Add Note/Link/Image" menu. To add a note (in a document called "paragraph") simply press the Ctrl-Shift-P key combination.

It the item is still empty you can double-click on a special shortcut (shown only in the edit mode). Entering some text will create a corresponding note, when you leave the inline edit.

3.2 Edit an Item

Once create you can always change the label of an item.

The context menu "Edit" opens an editor panel allowing you to modify the item's attributes.

3.3 Edit a Relation

Even though a relation is shown only with the label of the related item, you can still edit it's attributes.

In the editor panel (again opened via the "Edit" context menu of the relation) you can comment the relation or even change it's target.

3.4 Edit the Content

The content of a map item is similar to the one of a chapter in a document. Accordingly you can edit the paragraphs, links and images in a similar way (see Web GUI Manual for documents).

4 Cut&Paste

Via the clipboard you can move and copy items and relations within the map and across other maps as well.

In the edit mode you can select an item or a relation and access the clipboard via the context menu or the Ctrl-C (copy), Ctrl-X (cut), Ctrl-V (paste), Ctrl-Shift-V (paste into) key combinations.

Remember, the LivCos clipboard is different from the system clipboard (cut&paste in external applications and in richtext edits).

4.1 Move/Copy an Item

When you move or copy a map item, you also take it's relations with it. If such a relation has a bidirectional counterpart, this counterpart is updated as well (relates to the new destination after a move or copied to relate it's item to the new copy).

Items relating to the moved/copied item, without this item knowing about the relation (unidirectional), will not be affected by the action. So after a move, other items could point to void or some new item with the same ID.

TODO:

Maybe we need a placeholder to reserve the item ID.

TODO:

We could, at least, redirect all the relations within the same map.

Often relations to the copy might not relevant, but it should be easier to delete generated relations, than to define new ones.

4.2 Move/Copy a Relation

When you move or copy a relation and it has a bidirectional counterpart, this counterpart is updated as well (relates to the new destination after a move or copied to relate it's item to the new copy).

A relation can also be move or copied via drag&drop. On dropping hold down the Ctrl key to copy the dragged relation into the related item hovered over. Hold down the Shift key to move the relation.

Moving a relation within it's item is seen as a reorder, rather than a content move.

TODO:

Allow to reorder relations with Cut&Paste.

TODO:

We could, at least, redirect the relations within the same map.

4.3 Cut&Paste Content

Handling entites within an item's content (paragraphs, links, images,...) via the clipboard is similar to the handling of these entites in a document (see the Web GUI Manual for documents).

5 Multiple Maps

Items of different maps can still relate to each other.

In addition to the item label you can also specify the map object URI.

5.1 Namespace for Item Labels

The label of an item helps to identify and relate mulitple item with one another. So an item label should be (but does not needs to be) unique within one map. So the map forms a kind of namespace for the item labels.

6 External Helpers

Some of the features need the help of an external application or an add-on.

6.1 Bookmark a Web Browser page

  1. Drag this '+' link to the browser's bookmark or favorites area.

  2. Navigate your map to the item, you want to connect with the bookmark.

  3. Browse the Web for the page, you want to bookmark.

  4. Optionally select some text on the page to put as a note into the new map item.

  5. Click the previously added '+' bookmark in your browser.

  6. Observe the new map item in the window opened.