Adding a branch table

Branches in a nutshell

Branch tables are simply pages which have a set of links to other pages in the lesson. Typically a lesson may start with a branch table which acts as a Table of Contents.
Each link in a branch table has two components, a description and the title of the page to jump to.
A branch table can effectively divide the lesson into a number of branches (or sections). Each branch can contain a number of pages (probably all related to the same topic). The end of a branch is usually marked by an End of Branch page. This is a special page which, by default, returns the student back to the preceding branch table. As any page, "return" jump in an End of Branch page can be changed, if required, by editing the page. In some versions, using a "this page" jump in an End of Branch, will send the student to the first page in the lesson.
Branches can be nested within each other. For example, a lesson might usefully be structured so that specialist points are sub-branches within the main subject branches. Working on nested sub branches can get complicated without a plan.
Branch tables can also be used to hold content in the lesson as a simple page. As such they are really non-graded content pages. With no description, their jump-link will automatically go to the next page if that is the default in the lesson setting.

The Jump-to Link

Each Answer (for questions) or Description (for Branch pages) has a Jump-to link. When this answer is chosen, the answer's response is shown to the student. After that the student sees the page given in the Jump-to link. This link can be either relative or absolute. Relative links are This page and Next page. This page means that the student sees the current page again. Next page shows the page which follows in the logical order of pages. An absolute page link is specified by choosing a page's title.

Note that a (relative) Next page Jump-to link may show a different page after pages have been moved. Whereas Jump-to links which use (absolute) page titles always show the same page after pages have been moved.

Special Jumps

Unseen Question within a Branch

This will link to a randomly chosen unseen (by the student in this attempt) question between this branch table and the End of the Lesson or the next End of Branch.

Random Question within a Branch

This will link to a randomly chosen question between the current branch table and the End of Lesson or the next End of Branch. If the student has already seen the question and attempts are greater than 1, they will get another chance to earn the point(s) for that question. If attempts are set to 1, the question will be skipped and another random question shown.

Random Branch Table

This will jump to a random Branch Table between the current Branch Table and the End of Lesson or the next End of Branch.

Creating a branch structure in a lesson

It is best to create a branching structure in a lesson after you have created content pages in your lesson in some sort of logical order. Here is a simple example of creating branches that students can navigate to from a page at the start of a lesson.

Go to All-Pages View or Expanded View of your lesson. Above each page of your lesson you will see a link: Add a Branch Table. Decide where you want to create a branch table and click on the Add Branch Table link. You will need to specify the name of your branch table (for example: Contents) and then write a few words introducing the topic/ topics covered in your branches.

Next, the name of each button link in the description and the page to which each button link will jump. This jump should be the start of each navigational branch section. Be sure to add a button for End of Lesson in at least this branch table.

Finally you will insert End of Branch pages where each navigational branch section ends. All the jumps in this page should be set to the Content page we created in this example.

Documentation