--Welcome to this sample quiz! Here you will learn some advanced techniques of writing questions, as well as some sophisticated ways of giving and explaining points. By the end, you’ll know how to give points, how to add images and hyperlinks, how to redirect users to different parts of the program, and how to customize the user experience with the *if keyword.
--To see what this program looks live, click here: http://www.guidedtrack.com/programs/wbis0sv/run
--To start, we’ll quickly remind you of the 3 most basic rules of GuidedTrack language:
--1) Two dashes precede anything that is a comment. Only the people editing the survey can see comments. You’re reading a comment right now.
--2) Asterisks* precede GuidedTrack keywords. Keywords are used to build the design and functionality of the program.
--3) Indentations are important in GuidedTrack. They are used to indicate relationships between two or more lines of keywords or text.
*header: Welcome to the Geography Quiz!
--A *header keyword enlarges the text. In this example, users will see "Welcome to the Geography Quiz!" in large text.
Let’s get started.
--This is a standard text sentence. It looks just like normal text.
*button: Begin
--You can have a button that says anything you want on it. This examples shows the user a button with the word “Begin” on it. When pressed, users move to the next screen. Buttons are useful for ending a page and requiring a click to go to the next page.
*question: How large is the world’s smallest country?
0.2 square miles
*points: 10
0.7 square miles
*points: -2
8.5 square miles
*points: -2
9 square miles
*points: -2
Vatican City is considered to be the world’s smallest country, at 0.2 square miles.
--This is a multiple choice question. The multiple choice answers must always be indented beneath the question they relate to.
--This is also the standard way to assign point values to each possible answer choice. The *points keyword must always be indented beneath the multiple choice answer it refers to. Points will be tallied on the user's screen in the upper right corner as they progress in the quiz.
--In this example, the user sees the question and four different possible answer choices. After the user selects an answer, they are awarded the indicated number of points, which will appear on the corner of their screen. Following that, users are taken to the next screen, where they see the text that begins "Vatican City is considered to be. . .."
*question: In which U.S. state can you see the sun rise first?
*type: text
Maine
*points: 10
ME
*points: 10
*other
*points: -2
The correct answer is Maine, the easternmost state.
--This is a special type of text question in which users are presented with the question and a small box in which to write their answer. You can predict the answer that your user might write (e.g. “Maine” or “ME”). If the user writes the predicted answer (which is not case-sensitive), you can then specify what happens next (e.g. the user gets 10 points). If you include the *other keyword, then you can also specify what happens if the user writes anything other than one of your predicted answers (e.g. the user loses 2 points).
--If you choose to predict the answer your users will give, then you must indent the “*type: text” keyword beneath your question, as well as the answers you predict they’ll write. Then, write what should happen next one indentation further beneath the answer the next action relates to.
--In this example, users who type in the word “Maine” (or “maine,” “MAINE,” etc.) will receive 10 points. Users who type something other than “Maine” or “ME” (e.g. “Florida”) will receive -2 points.
*image: http://i.imgur.com/3xfCdvf.jpg
--The *image keyword displays an image on the screen. You must use a link to an image in order to display it. If the image is quite large, it will shrink to the horizontal size of the user's window.
*question: At what famous hot springs was the above image taken?
Jigokudani Monkey Park in Japan
*points: 10
You’re right!
Yellowstone in the United States
*points: -2
Not quite. The correct answer was Jigokudani Monkey Park.
Pamukkale in Turkey
*points: -2
Not quite. The correct answer was Jigokudani Monkey Park.
Huanglong in China
*points: -2
Not quite. The correct answer was Jigokudani Monkey Park.
--You can provide text tailored to the answer choice users select. The tailored text must be indented beneath the answer choice it relates to.
--In this example, users who select "Jigodudani Monkey Park in Japan" will be awarded 10 points and will see the words "You're right!"
*question: Where is the world’s largest volcano?
In Hawaii, Mauna Loa
*points: -2
*label: wrongvolcano
Not quite. There’s a volcano that’s much larger.
In Hawaii, Mauna Kea
*points: -2
*goto: wrongvolcano
In the Argentina-Chile border, Nevado Ojos del Salado
*points: -2
*goto: wrongvolcano
On the ocean floor off the coast of Japan, Tamu Massif
*points: 10
That’s right!
--You can redirect users to any part of the program. The *label keyword will bookmark a place in the program. Whenever the user comes to a *goto keyword, their place in the program will jump to the *label keyword of the same name (e.g. wrongvolcano).
--In this example, you’ll notice that there is a *label keyword called "wrongvolcano" above the text “Not quite….” Users who select "In Hawaii, Mauna Loa" are shown the text "Not quite . . .." Users who select the two other incorrect answers reach a *goto keyword and therefore jump slightly backwards in the program to the "wrongvolcano" *label keyword.They subsequently also see the text "Not quite . . .."
--Using the *label and *goto keywords prevented the need to write the same thing out multiple times, making later editing of the text a breeze.
Scientists just discovered Tamu Massif on the ocean floor and estimate it to be about 60 times larger than Mauna Loa in Hawaii, the volcano that was formerly considered largest. Read more about it [at this link|http://n.pr/1axCTkX].
--A link has been inserted into the end of this sentence. The linked text and the URL are surrounded by [brackets]. The linked text and the URL are separated by a pipe: |
--In this example, users will be able to click the phrase "at this link". Clicking "at this link" opens the URL given. URLs always open in a new browser tab or window.
*header: Bonus Question
This question is worth 20 bonus points!
*question: Māori are the indigenous people of what country?
Australia
*points: -2 bonus
New Zealand
*points: 20 bonus
Papua New Guinea
*points: -2 bonus
Peru
*points: -2 bonus
--It's easy to create a special type of point that is not added to the tally of points at the corner of the user’s screen. You simply assign points to each answer choice, then write a unique name (e.g. "bonus") to indicate what type of point it is. You can have as many point types in your quiz as you like. Users will not know how many points of a special type they got unless you tell them explicitly, (only points not given a name are shown to the screen automatically).
--In this example, users who select "New Zealand" will be awarded 20 bonus points. However, they won't see these points in the point tally at the corner of their screen.
Congratulations! You’ve finished the quiz. You have {points} points plus {bonus} bonus points, for a total of {points + bonus}. That means that you got {100*(points+bonus)/60}% of the maximum possible points.
--You can tell users how many points they have by putting the type of point in {braces}. By default, points that were assigned the standard way and without a codename (e.g. without "bonus") can simply be written out as {points}. That is, by entering "{points}" you will show users the exact same number of points that they can already see in the point tally at the corner of their screen.
--Points of a particular code name (e.g. "bonus") can be shown to the users by placing that codename in {braces}.
--You can also use math functions to tally different types of points (e.g. "points + bonus"). You can add, subtract, multiply, or divide different types of points. You can also use more complex math, for example, by using parentheses and writing multiple equations.
--In the above example, users who scored 20 points on the standard questions and got the bonus question correct would see the following statement: "You have 20 points plus 20 bonus points, for a total of 40 points. That means that you got 80% of the maximum possible points.
*if: (points + bonus) = 60
You did an excellent job!
*if: (points + bonus) >= 20 and (points + bonus) < 60
You did a really good job!
*if: (points + bonus) < 20
You may want to take the quiz again to see if you can increase your score.
--You can use the *if keyword to create a tailored message to users who meet certain qualifications. You can also use mathematical expressions including less than (<), equal to (=), and more than (>). You can also use expressions like "and" as well as "or" as this example shows. Please note, there are parentheses used instead of braces. Braces are not used inside of *if statements. As in regular math equations, parentheses serve to indicate the first mathematical operation that should take place.
--In the above example, users who meet the qualifications of the first *if statement will see the message “You did an excellent job!” That is, users whose points on the standard questions and points on the bonus questions added up to 60 total points will see the message indented beneath that *if keyword.
--Users whose total points added up to greater than or equal to 20, and less than 60 (i.e. between 20-59 points) will see the message “You did a really good job!”
--Users whose total points added up to less than 20 will see the third message.