Adding a content page: Difference between revisions

Latest revision as of 09:46, 4 November 2011

This page really needs improving. Please see the page comments for suggestions of what to include, then remove this template when you're done.

A Lesson module content page is one of two page types a student sees in a Lesson. The student sees page's title, some information and then one or more buttons at the bottom to select. There is a jump feature, a type of link associated with every description button. When a student selects a button, their choice is not scored and they go to another page.

Simple content page

Building a content page

Title

The title in a content page is similar to other pages but has some special uses. The title is the identifier in collapse edit mode and appears on the pulldown jump list. The title in a content page is also used with the "display left menu" setting.

Content

The content area in a content (branch table) has the standard Moodle HTML editor. This robust editor features are described elsewhere.

Description

A content page description appears to the student as a button. The button width fits the text and the height is fixed. The student selects the button which is associated with a jump. These buttons may be arranged vertically or horizontally. Vertical buttons are centered. Horizon buttons appear in a row, and a second row will appear if needed. The arrangement of buttons is the only thing a teacher can change and this is done in the Lesson settings.

TIP: The "Description" box does not work like the "Answer" box in a question, no mater what it looks like. The "use editor" check box is there and the familiar HTML editor will appear. They do not work. For example, you will see the text in a description field in bold, but the student will not see it.

The "Maximum number of answers/branches" in Lesson settings ("Update this Lesson" button) determines how many blank descriptions the teacher will see in edit mode.

The Jump link

Each Description in a Content page has a jump associated with it. When a Description button is chosen, the student is sent to the page defined in the Jump associated with the button. In edit mode the teacher can see all the possible jumps by a pull down menu.

Please refer to the Jumps page for a more detailed description of jumps.

Standard jumps: Relative jumps - "This page" (go back to the same page for another attempt), "Next page" (move to next page in the edit order), "Previous page" and "End of Lesson" (leave the lesson). The default jump is usually the "Next page" jump

Absolute jumps - A page link to a specific page's title. This can be a question or content page.

Note: that when a page is moved, its relative (for example, "Next page") Jump link will show the student a different page than before. Whereas a Jump link that uses an absolute (For example, a page title) always show the same page after the page has been moved.

Special jumps:

Unseen Question within a cluster - This will link to a randomly unseen (by the student in this attempt) question between in a "Cluster of pages.

Not supported in 2.1 are "Random Questions within a branch" or "Random content pages" within a branch.

General features and uses

Content pages are pages which have a set of links to other pages in the lesson. Typically a lesson may start with a Content page which acts as a table of contents.
Each link in a Content page has two components, a "jump" and a "description" that the student sees as a button.
A Content page 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 with any page, the "return" jump in an End of Branch page can be changed, 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.
Content pages 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.

@@ Line 1: / Line 1: @@
-{{Lessons}}
+{{Lesson}}{{Improve}}
-'''NOTE: A Content page was called a Branch Table page prior to Moodle 2.0'''
-A Content Page is one of two page types a student sees in a Lesson. The other is a [[Adding a question page|Question page]].
+A [[Lesson module]] content page is one of two page types a student sees in a Lesson.  The student sees page's title, some information and then one or more buttons at the bottom to select.  There is a [[Jumps|jump]] feature, a type of link associated with every description button.  When a student selects a button, their choice is not scored and they go to another page.
+[[File:Lesson Content page.png|thumb|center|Simple content page]]
-== Content pages and branches in a nutshell ==
+==Building a content page==
-# Content pages (Branch Tables) are pages which have a set of links to other pages in the lesson. Typically a lesson may start with a Content page which acts as a table of contents.
+=== Title ===
-# Each link in a Content page has two components, a "jump" and a "description" that the student sees as a button.
+The title in a content page is similar to other pages but has some special uses.  The title is the identifier in collapse edit mode and appears on the pulldown jump list.  The title in a content page is also used with the "display left menu" setting.
-# A Content page 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 with any page, the "return" jump in an End of Branch page can be changed, 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.
-# Content pages 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.
-== Title ==
-The title in a content page is similar to other pages but has some special uses.  The title is the identifier in collapse edit mode and appears on the pulldown jumpto list.  The title in a content page is also used with the "display left menu" setting.
-== Content==
+=== Content===
 The content area in a content (branch table) has the standard Moodle [[HTML editor]]. This robust editor features are described elsewhere.
-==Description==
+===Description===
 A content page description appears to the student as a button. The button width fits the text and the height is fixed.  The student selects the button which is associated with a jump.  These buttons may be arranged vertically or horizontally.  Vertical buttons are centered.  Horizon buttons appear in a row, and a second row will appear if needed. The arrangement of buttons is the only thing a teacher can change and this is done in the Lesson settings.
@@ Line 24: / Line 18: @@
 *The "[[Adding/editing_a_lesson#The_Maximum_Number_of_Answers_.2F_Branches_in_a_Lesson|Maximum number of answers/branches]]" in Lesson settings ("Update this Lesson" button) determines how many blank descriptions the teacher will see in edit mode.
-== The Jump link ==
+=== The Jump link ===
+Each Description in a Content page has a [[Jumps|jump]] associated with it. When a Description button is chosen, the student is sent to the page defined in the Jump associated with the button. In edit mode the teacher can see all the possible jumps by a pull down menu.
-Each Description in a Content page has a Jump associated with it. When a Description button is chosen, the student is sent to the page defined in the Jump associated with the button. The jump can direct a student to a relative or absolute page. In edit mode the teacher can see all the possible jumps by a pull down menu. The most common 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.
+Please refer to the [[Jumps]] page for a more detailed description of jumps.
-Note that when a page is moved, its relative (for example, "Next page") Jump link will show the student a different page than before. Whereas a Jump link that uses an absolute (For example, a page title) always show the same page after the page has been moved.
+'''Standard jumps:'''
+Relative jumps - "This page" (go back to the same page for another attempt), "Next page" (move to next page in the edit order), "Previous page" and "End of Lesson" (leave the lesson). The default jump is usually the "Next page" jump
-===Special Jumps===
+Absolute jumps - A page link to a specific page's title. This can be a question or content page.
-====Unseen Question within a branch====
+:'''Note:''' that when a page is moved, its relative (for example, "Next page") Jump link will show the student a different page than before. Whereas a Jump link that uses an absolute (For example, a page title) always show the same page after the page has been moved.
-This will link to a randomly chosen unseen (by the student in this attempt) question between this Content page and the End of the Lesson or the next End of Branch.
-====Random Question within a branch====
+'''Special jumps:'''
+*Unseen Question within a cluster - This will link to a randomly  unseen (by the student in this attempt) question between in a "[[Cluster]] of pages.
-This will link to a randomly chosen question between the current Content page 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.
+: Not supported in 2.1 are "Random Questions within a branch" or "Random content pages" within a branch.
-====Random Content page====
-This will jump to a random Content page between the current Content page 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 Content page.  Decide where you want to create a Content page and click on the Add Content page link.  You will need to specify the name of your Content page (for example: Contents) and then write a few words introducing the topic/ topics covered in your branches.
-Next, enter 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.  As a best practice, add a button for End of Lesson in at least this branch table so the student can exit.
-Finally you will insert End of Branch pages where each navigational branch section ends.  All the jumps your End of Branch pages should be set to the Content page we created in this example.
+==General features and uses ==
+# Content pages are pages which have a set of links to other pages in the lesson. Typically a lesson may start with a Content page which acts as a table of contents.
+# Each link in a Content page has two components, a "jump" and a "description" that the student sees as a button.
+# A Content page 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 with any page, the "return" jump in an End of Branch page can be changed, 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.
+# Content pages 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.
 == See Also ==
-*[http://moodle.org/help.php?file=index.html Index of Help Files] - Very Useful
-[[Lesson_Pages#Branch_.28Branch_Table.29-_Choice_Pages]]
-For more Lesson topics click on Lesson or the Teacher links below
+*[[Lesson_Pages]]
-[[Category:Teacher]]
+*[[Lesson questions]] - the other kind of pages students can see in a Lesson module
-[[Category:Lesson]]
 [[fr:Ajouter une table de branchement]]
 [[de:Verzweigungsseite_einf%C3%BCgen]]

Documentation