Working with Branches

In Allegra, each workspace has a main branch. You can branch from the main branch or any any other branch. In each branch, there is a HEAD version for each document it contains.

Create a Branch

To create a branch in a workspace in the Wiki Navigator, click on the workspace to open the context menu. Select “Create Branch.” You can choose between inheritance mode and copy mode.

Inheritance mode implies that elements in the target branch are bound to the HEAD versions of the source branch as long as a document in the target branch is not changed. Changes in the source branch are therefore immediately visible in the target branch.

In copy mode, documents in the target branch are bound to the version of the source branch, which was the HEAD version when the target version was created. If documents are edited in the source branch, this has no effect on the corresponding documents in the target branch.

Viewing a Branch

You can view a branch by switching to the branch from the context menu of the Wiki Navigator.

Merging Branches

This function is not yet supported.

Compare Branches

Select “Compare Branches” in the context menu. In the next popup box, select the two branches/bases to be compared. You will get a view similar to the following figure. If you double-click on a document, a new screen is displayed describing the differences between the two document variants.

Viewing Branch Relationships

For each document that originates from a different branch, you have a “Toolbar” button that takes you to the original source document. The tooltip shows you where this document is located.

If a document is a member of one or more baselines, another Toolbar button opens a list of reference baselines. On the other hand, if a document is the source for a document in other branches, the same Toolbar button also displays a list of those documents in the target branches.

Delete Branches

You can delete a branch from the context menu of the Wiki Navigator.