Changes between Version 36 and Version 37 of BoltRef

Timestamp:

Oct 24, 2008, 12:43:41 PM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -56 +56 @@
 == Exercises ==
 
-Exercises are PHP scripts that call Bolt API functions.
-Here's an example consisting of a multiple-choice question:
+Exercises are PHP scripts that call Bolt API functions to create questions.
+The API is:
+{{{
+exclusive_choice(
+    'option1',
+    'option2',
+     ...
+    [ weight(X) ]
+);
+}}}
+This specifies a multiple-choice question where at most one answer can be chosen.
+The correct choice is the first one
+(when the question is shown, the choices are presented in a random order).
+
+An exercise script can contain multiple questions.
+If '''weight()''' is given, it specifies this question's grading weight;
+the default is 1.
+
+{{{
+inclusive_choice(
+    array('option1', true|false),
+    array('option2', true|false),
+    [ weight(X) ]
+);
+}}}
+This specifies a multiple-choice question where any number of answers can be chosen.
+
+{{{
+image_rect(
+   image_filename,
+   array(100, 60, 110, 70)
+);
+?>
+}}}
+This specifies a question where the student clicks on an image;
+a correct answer is a click in the indicated subrectangle.
+
+In addition to calling these functions,
+an exercise script can put text before or after the questions.
+Example:
 {{{
 <?php
 echo 'Conifers are so named because:';
 exclusive_choice(
-   array(
-      'They carry their seeds in cones.'
-      'They are cone-shaped.',
-      'They originated during the Coniceous era.',
-   ),
-);
-?>
-}}}
-The correct choice is the first element of the array.
-Each time the question is shown,
-the choices are presented in a random order.
-
-Here's an example that shows an image;
-a correct answer is a click in the indicated subrectangle.
-{{{
-<?php
-echo "Click on the dog's nose:<p>";
-image_rect(
-   'dog.jpg',
-   array(100, 60, 110, 70)
-);
-?>
-}}}
-
-Bolt supplies functions for other types of questions,
-such as inclusive multiple-choice and fill-in-the-blank.
-An exercise can include multiple questions.
+   'They carry their seeds in cones.'
+   'They are cone-shaped.',
+   'They originated during the Coniceous era.'
+);
+?>
+}}}
+
 
 == Course documents ==