#LyX 1.1 created this file. For more info see http://www.lyx.org/
\lyxformat 218
\textclass article
\begin_preamble
\usepackage{floatflt}
\end_preamble
\language english
\inputencoding auto
\fontscheme default
\graphics default
\paperfontsize 12
\spacing single
\papersize Default
\paperpackage a4
\use_geometry 1
\use_amsmath 0
\paperorientation portrait
\leftmargin 1in
\topmargin 1.25in
\rightmargin 1in
\bottommargin 1in
\secnumdepth 3
\tocdepth 3
\paragraph_separation indent
\defskip medskip
\quotes_language english
\quotes_times 2
\papercolumns 1
\papersides 1
\paperpagestyle fancy
\layout Title
Introduction to the Learning
\emph on
Online
\emph default
Network with CAPA
\layout Standard
\added_space_top vfill \align center
\SpecialChar ~
\layout Standard
\align center
This manual was developed by John Williamson in the Office of Medical Education
Research and Development.
Some information in thie manual is adapted from the
\begin_inset Quotes eld
\end_inset
LON-CAPA Workshop Demo
\begin_inset Quotes erd
\end_inset
developed by Felicia Berryman in the Laboratory for Instructional Technology
in Education.
\layout Standard
\SpecialChar ~
\layout Standard
\pagebreak_bottom \align center
Laboratory for Instructional Technology in Education
\newline
and the
\newline
Office of Medical Education Research and Development
\newline
Michigan State University
\newline
\layout Standard
\pagebreak_bottom
\begin_inset LatexCommand \tableofcontents{}
\end_inset
\layout Section
Introduction to LON-CAPA
\layout Comment
This is a comment which will not show in any other rendering of this document.
I will use them to document my observations as I work through this tutorial.
\layout Comment
Imagine a big
\begin_inset Quotes eld
\end_inset
IMHO
\begin_inset Quotes erd
\end_inset
on all of these comments; I'm just going to give you my comments straight
out.
I'm not attached to them and won't be offended by anything you say or do
about them.
\layout Standard
LON-CAPA is a web-based interface that helps to organize and present your
course website, deliver and manage problem problems, and manage student
enrollment.
All author functions are done using a web browser (Netscape 4.x or higher
is recommended) and the LON-CAPA Author Interface.
The URL for LON-CAPA is
\family typewriter
http://s10.lite.msu.edu
\family default
.
\layout Standard
At this time, you should have:
\layout Itemize
developed your objectives for your course.
\layout Itemize
developed your problems for testing and identified the question formats.
The Template for Mapping Website to LON-CAPA that you filled in will assist
you in the process of creating your course website structure in LON-CAPA.
\layout Standard
This tutorial describes how to use the various author functions available
in LON-CAPA.
\layout Section
The LON-CAPA Author Interface
\layout Subsection
Login as Course Author
\begin_inset LatexCommand \index{Course Author}
\end_inset
\layout Standard
To begin using LON-CAPA, you first need to log in to your account on LON-CAPA.
Open your web browser and navigate to the LON-CAPA URL:
\family typewriter
http://s10.lite.msu.edu/
\family default
.
You will be presented with a log in screen as in figure
\begin_inset LatexCommand \ref{LON-CAPA Log in screen}
\end_inset
.
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 297 234
file login.eps
width 3 50
flags 11
\end_inset
\layout Caption
\begin_inset LatexCommand \label{LON-CAPA Log in screen}
\end_inset
LON-CAPA Log in screen
\end_float
\layout Standard
Fill in the Username and Password boxes with your information.
Then press the Login button.
This will take you to your LON-CAPA User Roles menu.
\layout Description
Note: Your Username is your PILOT ID, which is the part of your PILOT email
address to the left of the @.
Your password is your PILOT email password.
Both the PILOT ID and the password are case sensitive, so make sure you
type upper- and lower-case letters correctly.
\layout Subsection
\begin_inset LatexCommand \index{Author Remote Control}
\end_inset
Author Remote Control
\layout Comment
Comment on the remote controls: I'll only mention this once, but imagine
this comment exists everywhere a remote control image is used.
The whole
\begin_inset Quotes eld
\end_inset
remote control
\begin_inset Quotes erd
\end_inset
metaphor is fundamentally flawed and probably can't be salvaged.
Why is it flawed?
\layout Comment
\SpecialChar ~
\layout Comment
1.
The remote control invokes a metaphor, that of remote controls.
However, remote controls are useful in the real world, despite the overwhelming
complexity of modern remotes, for three major reasons: One, they never,
ever, ever change.
Two, they provide immense amounts of tactile feedback, allowing one to
overcome the complexity of using one by putting the knowlege into motor
memory.
(There are equivalent usability principles in usability, as well; look
up Fitt's Law, for instance.) Three, they all basically do the same thing;
pick up an unfamiliar TV control and you at least know in advance there
will be numbers for channel changing, vol up and down, chan up and down,
mute, etc.
The remotes used in this system do not have any of these properties.
Remotes are actually horrid UI, because they are very, very difficult to
learn; they make up for it by being useful and persistent.
\layout Comment
Further, remotes should *do* things.
This remote is like a remote that no matter what button you push, it invokes
a menu.
Most remotes have
\series bold
one
\series default
explicit
\begin_inset Quotes eld
\end_inset
menu
\begin_inset Quotes erd
\end_inset
button to invoke a menu that has all the feature that aren't worth valuable
remote control space.
\layout Comment
In fact, the metaphor is so unsuccessful that any moderately savvy internet
user will almost immediately come to conceptualize the remote as just another
list of links, albiet a clumsy and inconvenient one.
Why not give them that in the first place?
\layout Comment
\SpecialChar ~
\layout Comment
2.
Even the simplest
\begin_inset Quotes eld
\end_inset
remote
\begin_inset Quotes erd
\end_inset
I see in the tutorial has eight buttons, which nearly immediately becomes
seventeen (!) buttons, all incomprehensible, and I didn't get a chance
to count during the interview, but I saw a remote flash by (student remote?
admin remote? that wouldn't matter as much) that had at least twenty, probably
24 buttons, again, all or nearly all incomprehensible.
This is needlessly intimidating.
\layout Comment
\SpecialChar ~
\layout Comment
3.
By commiting to this
\begin_inset Quotes eld
\end_inset
remote control
\begin_inset Quotes erd
\end_inset
layout, you commit to a remote control's layout limitations, except that
an actual remote control can get away with a 6pt or smaller font, or wierd
specialized symbols, or whatnot.
I'm looking at a (real) remote control right now that manages to get
\begin_inset Quotes eld
\end_inset
channel return
\begin_inset Quotes erd
\end_inset
onto one button.
That whole phrase fits *twice* into the space the
\begin_inset Quotes eld
\end_inset
ROLES
\begin_inset Quotes erd
\end_inset
button takes up on my printout! So in actuality, you're commiting to something
no sane remote control designer could deal with.
Moreover, I observe that on a real remote, the vast majority of buttons
are labelled with one conceptual entity (i.e.,
\begin_inset Quotes eld
\end_inset
1
\begin_inset Quotes erd
\end_inset
,
\begin_inset Quotes eld
\end_inset
5
\begin_inset Quotes erd
\end_inset
,
\begin_inset Quotes eld
\end_inset
FF
\begin_inset Quotes erd
\end_inset
,
\begin_inset Quotes eld
\end_inset
[the pause symbol]
\begin_inset Quotes erd
\end_inset
, etc)., not
\begin_inset Quotes eld
\end_inset
Change User
\begin_inset Quotes erd
\end_inset
which is two entities by my count, at least for an initial user.
\layout Comment
\SpecialChar ~
\layout Comment
4.
Requiring the user to mouse over something to see what it does is not a
solution.
Limiting yourself to an 8 by 2 array of characters to explain yourself
compounds the problem even more.
(Another over-literal extension of the remote control metaphor.) Also, as
you may have observed, the accessibility of this is nil.
\layout Comment
\SpecialChar ~
\layout Comment
The upshot is that the only upside to the remote control is a moderately
pleasing graphic; the downsides are pretty much everything, up to and including
possible illegality under accessability laws.
Unfortunately, I do not see any way to salvage any aspect of the remote
control; it's going to suck until it's replaced.
Pleasing graphics are relatively easy to come by nowadays; it should not
drive the design.
I'll admit (freely!) I'm not a graphics designer...
graphics designers aren't web developers (designers), either.
\layout Comment
\SpecialChar ~
\layout Comment
Also, based on my relatively little info, I think you're data-mining the
web logs to see what people actually use.
This is good.
We may need to do some really simple stuff before he finishes.
Raw statistics on what buttons are pressed most often can probably be interpret
ed easily enough for our purposes.
No matter what the final design is, it should emphasize the two or three
commands used day in and day out, as determined by empirical analysis,
and shuffle the other commands onto another sub menu or sub menus.
Then, use the additional space you'll have (even if you keep the same size
window) and actually *spell out* the options.
\layout Standard
The Author Remote Control, show in figure
\begin_inset LatexCommand \ref{Author Remote Control Figure}
\end_inset
, will automatically load whenever you log in to LON-CAPA as the course
instructor.
The Author Remote Control is a separate window in your browser, so you
may position it on the screen where you can make the best use of it.
The Remote Control is a tool that allows you to switch between functions
and roles within LON-CAPA.
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 177 420
file authorRemote.eps
height 3 50
flags 9
\end_inset
\layout Caption
Author Remote Control
\begin_inset LatexCommand \label{Author Remote Control Figure}
\end_inset
\end_float
\layout Comment
Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any*
sort of sense on a first glance.
Abbreviations are evil in this sort of application and should be used as
a truly last resort.
\layout Standard
When you move your mouse over the buttons in the remote, the sixteen gray
boxes will show a reminder of what that button does.
\layout Itemize
\series bold
ROLES (CHOOSE ROLE)
\series default
allows you to select which user role to assume for this session.
\layout Itemize
\series bold
COM (COMMUNICATION)
\series default
allows you to access the communication functions in the system.
\layout Itemize
\series bold
CUSR (USER ROLES)
\series default
brings up a page that allows you to create new users and change user privileges.
\layout Itemize
\series bold
CSTR (CONSTRUCT)
\series default
displays the construction space for your account.
\layout Itemize
\series bold
RES (RESOURCE SPACE)
\series default
allows you to browse the LON-CAPA network directory.
\layout Itemize
\series bold
EGRD (ENTER GRADES)
\series default
is used to enter grades for students enrolled in your course.
\layout Itemize
\series bold
SRC (SEARCH LIBRARY)
\series default
brings up a screen that lets you search the LON-CAPA resources using multiple
criteria.
\layout Itemize
\series bold
LOGOUT (LOGOUT)
\series default
will log you out of the LON-CAPA system.
\layout Section
Creating Content Using LON-CAPA
\layout Standard
LON-CAPA provides three types of resources for organizing your course website.
LON-CAPA refers to these resources as Content Pages, Problems, and Maps.
Maps may be either of two types: Sequences or Pages.
You will use these LON-CAPA resources to build the outline, or structure,
for the presentation of your course to your students.
\layout Itemize
A
\series bold
Content Page
\series default
\begin_inset LatexCommand \index{Content Page}
\end_inset
displays course content.
It is mostly a conventional HTML page.
\layout Comment
Check this; is it exactly like HTML pages?
\layout Itemize
A
\series bold
Problem
\series default
\begin_inset LatexCommand \index{Problem}
\end_inset
resource represents problems for the students to solve, with answers stored
in the system.
These resources are stored in files that must use the extension
\begin_inset Quotes eld
\end_inset
.problem
\begin_inset Quotes erd
\end_inset
.
\layout Itemize
A
\series bold
Map
\series default
\begin_inset LatexCommand \index{Map}
\end_inset
resource of the
\series bold
Sequence
\begin_inset LatexCommand \index{Sequence}
\end_inset
\series default
type represents a programmed series of events.
The users of this resource can use array keys or NAV buttons to follow
the sequence.
These resources are stored in files that must use the extension
\begin_inset Quotes eld
\end_inset
.sequence
\begin_inset Quotes erd
\end_inset
.
\layout Comment
What
\begin_inset Quotes eld
\end_inset
arrow keys
\begin_inset Quotes erd
\end_inset
? Surely not the ones on the keyboard\SpecialChar \ldots{}
\layout Itemize
A
\series bold
Map
\series default
\begin_inset LatexCommand \index{Map}
\end_inset
resource of the
\series bold
Page
\series default
\begin_inset LatexCommand \index{Page}
\end_inset
type display multiple resources together.
For example, a page of problems will appears as a problem set.
These resources are stored in files that must use the extension
\begin_inset Quotes eld
\end_inset
.page
\begin_inset Quotes erd
\end_inset
.
\layout Subsection
Description of the Construction Space
\layout Standard
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 42
file constructionSpace.eps
width 3 80
flags 9
\end_inset
\layout Caption
Construction Space
\begin_inset LatexCommand \label{Construction Space Figure}
\end_inset
\end_float
The Construction Space, as seen in figure
\begin_inset LatexCommand \ref{Construction Space Figure}
\end_inset
, is the section of LON-CAPA where you create and manage your course resources.
The Construction Space consists of a green tool bar at the top of the page
and a list of all directories and resources below.
\layout Standard
\begin_inset Tabular
|
\begin_inset Text
\layout Standard
\series bold
Button Name
\end_inset
|
\begin_inset Text
\layout Standard
\series bold
Description
\end_inset
|
|
\begin_inset Text
\layout Standard
Publish this Resource
\end_inset
|
\begin_inset Text
\layout Standard
Opens the Resource Publishing window.
\end_inset
|
|
\begin_inset Text
\layout Standard
List Directory
\end_inset
|
\begin_inset Text
\layout Standard
Lists the contents of the current working directory
\end_inset
|
|
\begin_inset Text
\layout Standard
Copy
\end_inset
|
\begin_inset Text
\layout Standard
Type a new name in the entry box to make a copy the current resource
\end_inset
|
|
\begin_inset Text
\layout Standard
Browse
\end_inset
|
\begin_inset Text
\layout Standard
Helps you select a file to upload
\end_inset
|
|
\begin_inset Text
\layout Standard
Upload File
\end_inset
|
\begin_inset Text
\layout Standard
Uploads the selected file to your Construction Space
\end_inset
|
|
\begin_inset Text
\layout Standard
Retrieve Old Version
\end_inset
|
\begin_inset Text
\layout Standard
Load an older version of a resource if you have multiple versions
\end_inset
|
|
\begin_inset Text
\layout Standard
Delete
\end_inset
|
\begin_inset Text
\layout Standard
Deletes the current resource
\end_inset
|
|
\begin_inset Text
\layout Standard
Rename
\end_inset
|
\begin_inset Text
\layout Standard
Type a new name in the associated entry box to rename a resource
\end_inset
|
|
\begin_inset Text
\layout Standard
New Subdirectory
\end_inset
|
\begin_inset Text
\layout Standard
Type a name in the entry box to create a new directory
\end_inset
|
\end_inset
\layout Subsection
How to Create New Content Pages
\begin_inset LatexCommand \label{Creating New Content Pages}
\end_inset
\layout Standard
\series bold
Content Pages
\series default
are HTML documents that display the course information you are presenting.
These documents can be created in any order.
\layout Comment
Is this worth mentioning?
\layout Standard
To create new Content Pages, do the following:
\layout Comment
Is step one necessary? I don't see how it could be.
\layout Enumerate
Click the
\series bold
CSTR
\series default
button on the LON-CAPA remote.
You web page will change to your Construction Space.
\layout Enumerate
In Location bar of your browser, type in full URL of the new Content Page.
Make sure the last part of the URL ends with
\begin_inset Quotes eld
\end_inset
.html
\begin_inset Quotes erd
\end_inset
, for example,
\emph on
http://www.s10.lite.msu.edu/priv/\SpecialChar \-
directory/new_resource.html
\emph default
.
Press the Return or Enter key.
\layout Enumerate
You should see something like the following message:
\series bold
File not found: /home/wmsonj/priv/\SpecialChar \-
directory/new_resource.html
\series default
, and an Edit button.
Click the
\begin_inset Quotes eld
\end_inset
Edit
\begin_inset Quotes erd
\end_inset
button, and an HTML editor will open with a simple page template.
\layout Enumerate
Type the content into the editor,
\emph on
OR
\emph default
copy and paste HTML source code into the editor.
\layout Enumerate
Optionally, click the
\series bold
View
\series default
button to preview your Content Page.
\layout Enumerate
Finally, click the
\series bold
Save this
\series default
button
\emph on
OR
\emph default
click the
\series bold
Save and then attempt to clean HTML
\series default
button.
\layout Standard
Repeat this process as many times as necessary to create your Content Pages.
\layout Subsection
How to Edit Existing Content Pages
\layout Standard
You may edit any any Content Pages that have been created.
\layout Standard
To edit Content Pages:
\layout Enumerate
Click the
\series bold
CSTR
\series default
button on the LON-CAPA Remote.
Your web page will change to your Construction Space.
\layout Enumerate
Click on the link for the name of the Content Page to edit.
The Content Page editor will load and display the current edition of the
Content Page.
\layout Enumerate
Press the Edit button.
Edit the HTML code, or copy and paste HTML source code into the editor.
\layout Enumerate
Optionally, click the
\series bold
View
\series default
button to preview your Content Page.
\layout Enumerate
Finally, click the
\series bold
Save this
\series default
button
\emph on
OR
\emph default
click the
\series bold
Save and then attempt to clean HTML
\series default
button.
If you do not do this, your work will not be saved.
\layout Subsection
Creating Online Problems Using LON-CAPA
\layout Subsubsection
Problems Types
\layout Standard
There are five types of problems that can be created with the LON-CAPA system:
Radio Response, Option Response, String Response, Numerical Response, and
Formula Response.
You will need to identify which types of problem you want to use and create
appropriate questions for your course.
\layout Subsubsection
Foils
\layout Standard
In the LON-CAPA system, a
\series bold
Foil
\begin_inset LatexCommand \index{Foil}
\end_inset
\series default
is a choice in a Radio Response or Option Response problem.
For instance, True/False problems have two foils, one for True, and one
for False.
Foils do not need to be text; they can be images or other resources.
\layout Subsubsection
Radio Response
\begin_inset LatexCommand \index{Radio Response}
\end_inset
Problems
\layout Standard
\series bold
Radio Response
\series default
problems represent multiple choice questions.
A True/False problem is a special case of Radio Response problem with two
foils, True or False.
\layout Standard
Multiple choice problems contain between 3 and 10 foils.
You may display from three to five foils for each problem and the system
randomly picks the choices that are presented to the student.
\layout Comment
Eh? If this means what I think it means, clarify.
Is the system really incapable of showing eight choices all at once?
\layout Subsubsection
Option Response
\begin_inset LatexCommand \index{Option Response}
\end_inset
Problems
\layout Standard
Option Response problems present foils to the student with drop-down boxes.
A group of foils is created for each concept group, and the system will
pick one to present to the student from each group.
The student must match each of his or her questions correctly to the possible
answers before receiving credit for the problem.
For more details, see the Create Option Response (
\begin_inset LatexCommand \ref{Create Option Response Problem}
\end_inset
).
\layout Subsubsection
String Response Problems
\layout Standard
\series bold
\begin_inset LatexCommand \index{String Response}
\end_inset
String Response
\series default
problems are problems in which the student submits a string of characters
for the answer.
Examples of string response questions are vocabulary tests, short answer
and entering chemical formulas.
\layout Comment
Case sensitivity?
\layout Standard
Note that it is easy to abuse String Response problems.
For instance, consider the question
\begin_inset Quotes eld
\end_inset
Who wrote 'Huckleberry Finn'?
\begin_inset Quotes erd
\end_inset
If you tell the system the answer is
\begin_inset Quotes eld
\end_inset
Mark Twain
\begin_inset Quotes erd
\end_inset
, and a student answers
\begin_inset Quotes eld
\end_inset
Twain
\begin_inset Quotes erd
\end_inset
, the system will mark it wrong.
If they answer
\begin_inset Quotes eld
\end_inset
Samuel Clements
\begin_inset Quotes erd
\end_inset
, then the student will definately get it wrong.
There is some room for flexibility in the string processing, but it can
be difficult to get it all right.
Before you use a String Response problem, be sure you can easily characterize
correct answers.
\layout Comment
Check this stuff.
\layout Subsubsection
Numerical Response Problems
\layout Standard
\series bold
Numerical Response
\begin_inset LatexCommand \index{Numerical Response}
\end_inset
\series default
problems are answered by entering a number and (optionally) a unit, such
as 2.5 m/s^2.
Tolerance and significant digits can be specified as well.
\layout Subsubsection
Formula Response Problems
\layout Standard
Formula Response problems are questions in which the student types in a
math formula for the answer.
If the answer is
\begin_inset Formula \( x^{2}-11 \)
\end_inset
, the student can enter "x^2 - 11", "x*x - 11", "x^2 + 21 - 10", etc.
Functions such as cos, sin, and exp are accepted as well as the operators
(), +, -, *, and /.
\layout Subsection
Creating Radio Response Problems
\layout Standard
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 201
file creatingNewProblemResource.eps
width 3 80
flags 13
\end_inset
\layout Caption
Creating A New Problem Resource
\begin_inset LatexCommand \label{Creating a new problem resource}
\end_inset
\end_float
To create an Radio Response
\begin_inset LatexCommand \index{Radio Response}
\end_inset
problem, create a new resource as described in section
\begin_inset LatexCommand \ref{Creating New Content Pages}
\end_inset
.
This is a
\begin_inset Quotes eld
\end_inset
problem
\begin_inset Quotes erd
\end_inset
resource so the URL must end in
\begin_inset Quotes eld
\end_inset
.problem
\begin_inset Quotes erd
\end_inset
.
You should see a screen as in figure
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
.
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 283
file radioResponse2.eps
width 3 80
flags 9
\end_inset
\layout Caption
Radio Response Creation Form
\begin_inset LatexCommand \label{Radio Response Creation Form}
\end_inset
\end_float
You will need to create the posible answers and the questions.
\layout Enumerate
In the drop-down option box as seen in
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
, select
\series bold
Radio Response Problem
\series default
, and click the
\series bold
New Problem
\series default
button.
\layout Enumerate
Click the
\series bold
Edit
\series default
button above the sample problem to enter edit mode.
\layout Enumerate
In the
\series bold
Text Block
\series default
at the top of the problem, remove the sample text and type the question
for your problem.
For example,
\begin_inset Quotes eld
\end_inset
What is two plus two?
\begin_inset Quotes erd
\end_inset
\layout Enumerate
Locate the
\series bold
Response: One of N statements
\series default
element.
In the
\series bold
Max Number of Shown Foils
\series default
text box, place the number of wrong answers you wish to supply to each
student, in addition to the correct one.
For instance, if you want to display four choices, where one is correct
and three are incorrect, enter
\begin_inset Quotes eld
\end_inset
3
\begin_inset Quotes erd
\end_inset
into this box.
\layout Enumerate
Locate
\series bold
Foil 1
\series default
.
Remove the text that is in the text box and put the
\emph on
correct answer
\emph default
for the problem in the
\series bold
Text Block
\series default
.
For example,
\begin_inset Quotes eld
\end_inset
Four.
\begin_inset Quotes erd
\end_inset
\layout Enumerate
Below it, you will see
\series bold
Foil 2
\series default
.
Remove the text in the text box and put an
\emph on
incorrect answer
\emph default
for the problem.
For instance,
\begin_inset Quotes eld
\end_inset
Purple.
\begin_inset Quotes erd
\end_inset
\layout Enumerate
Repeat the previous step until you've filled in all of the other incorrect
answers you wish to offer the students.
\layout Enumerate
Once you've filled in all the incorrect answers, change the
\series bold
Correct Option
\series default
s on the other foils to
\series bold
Unused
\series default
.
\layout Enumerate
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 92
file radioResponseHint.eps
width 3 80
flags 9
\end_inset
\layout Caption
Hint Element
\begin_inset LatexCommand \label{Radio Response Hint Element Figure}
\end_inset
\end_float
Scroll down to the Hint element, as shown in Figure
\begin_inset LatexCommand \ref{Radio Response Hint Element Figure}
\end_inset
.
Type some text that will help students when they answer incorrectly.
\layout Enumerate
Click the
\series bold
Submit Changes
\series default
button located at the top of the frame.
If you do not do this, none of your changes will be saved.
\layout Standard
The
\series bold
Correct Option
\series default
drop down box controls whether or not a given answer will be accepted as
a correct answer.
If it is set to
\series bold
true
\series default
, that answer will be considered a correct answer.
Any number of foils can be marked
\series bold
true
\series default
, so you can have questions with multiple correct answers.
If it is set to
\series bold
false
\series default
, it will be considered an incorrect answer.
If it is set to
\series bold
Unused
\series default
, the system will not use that foil.
\layout Paragraph
Randomization
\begin_inset LatexCommand \index{Randomization}
\end_inset
\layout Standard
LON-CAPA will randomize what choices are presented to each student, and
randomize the order they are presented in.
If you wish to present each student the same choices, make sure the
\series bold
Maximum Number of Shown Foils
\series default
box contains the number of incorrect answers, which will force them to
all be displayed.
If you wish to force the system to display the foils in the order you have
created them in, type the HTML tag
\series bold
\series default
into your problem text.
This can be useful with the ever-popular
\begin_inset Quotes eld
\end_inset
All of the above
\begin_inset Quotes erd
\end_inset
choice, which must be displayed in the correct place or its meaning will
change.
\layout Subsubsection
True/False
\begin_inset LatexCommand \index{True/False Problem}
\end_inset
Problem
\layout Standard
A True/False problem is a Radio Response problem with two choices, True
and False.
set the
\series bold
Maximum Number of Shown Foils
\series default
to
\begin_inset Quotes eld
\end_inset
1
\begin_inset Quotes erd
\end_inset
, and mark the correct answer
\series bold
true
\series default
.
For example, for the True/False question
\begin_inset Quotes eld
\end_inset
Napolean conquered Japan in the year 189 A.D.
\begin_inset Quotes erd
\end_inset
, mark the foil containing the answer
\begin_inset Quotes eld
\end_inset
False
\begin_inset Quotes erd
\end_inset
as
\series bold
true
\series default
, because it is the correct answer.
\layout Subsection
Option Response
\begin_inset LatexCommand \index{Option Response}
\end_inset
\begin_inset LatexCommand \label{Create Option Response Problem}
\end_inset
Problems
\layout Standard
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 280
file optionResponseProblem.eps
width 3 80
flags 9
\end_inset
\layout Caption
Option Response Problem
\begin_inset LatexCommand \label{Option Response Problem Figure}
\end_inset
\end_float
Each Option Response problem has three parts:
\layout Enumerate
The Concept Groups
\begin_inset LatexCommand \index{Concept Groups}
\end_inset
\layout Enumerate
The options for the students to select, by default
\begin_inset Quotes eld
\end_inset
True
\begin_inset Quotes erd
\end_inset
and
\begin_inset Quotes eld
\end_inset
False
\begin_inset Quotes erd
\end_inset
\layout Enumerate
The hint for the student
\layout Standard
Each
\series bold
Concept Group
\series default
has some number of foils representing questions which are conceptually
related.
Option Response Problems can have between 4 and 8 Concept Groups in a problem.
When the Option Response problem is presented to a student, the LON-CAPA
system will randomly select one foil from each Concept Group and present
it to the student.
In order to receive credit for the problem, the student must answer all
of the Concept Group foils correctly.
\layout Subsubsection
Example: Concept Group
\layout Standard
For example, a Concept Group may contain the following True/False questions:
\layout Itemize
\begin_inset Quotes eld
\end_inset
Mark Twain
\begin_inset Quotes erd
\end_inset
is the pen name of Samuel Clemens.
\layout Itemize
Mark Twain wrote
\begin_inset Quotes eld
\end_inset
The Call of the Wild
\begin_inset Quotes erd
\end_inset
.
\layout Itemize
Mark Twain wrote
\begin_inset Quotes eld
\end_inset
Huckleberry Finn
\begin_inset Quotes erd
\end_inset
.
\layout Itemize
Mark Twain spent most of his life in the Congo.
\layout Standard
For each foil, the author marks it True or False.
When the student logs on and attempts to answer this question, the student
will see only one of the four choices for that concept group.
They then go on to do the remaining three to seven Concept Groups in this
question before submitting their answer.
\layout Subsubsection
Example: Matching Problem
\layout Standard
You might want to ask the student to match musical compositions with their
composers.
You could create an Option Response problem with 4 Concept Groups, and
place the following four things each in one concept group:
\layout Itemize
Claire de Lune
\begin_float footnote
\layout Standard
Debussy.
\end_float
\layout Itemize
The Pastoral Symphony
\begin_float footnote
\layout Standard
Beethoven's Sixth Symphony.
\end_float
\layout Itemize
Sleeping Beauty Suite
\begin_float footnote
\layout Standard
Tchaikovsky.
\end_float
\layout Itemize
The Dance of the Sugar Plum Fairies
\begin_float footnote
\layout Standard
Also Tchaikovsky, from The Nutcracker.
\end_float
\layout Standard
You could then add the following options to the option list:
\layout Itemize
Debussy
\layout Itemize
Beethoven
\layout Itemize
Schubert
\layout Itemize
Tchaikovsky
\layout Itemize
Bach
\layout Standard
The same answers can be used more then once, or not at all, as you see fit.
It is conventional to place such a warning in the
\series bold
Text Block
\series default
describing the problem to the students.
\layout Subsubsection
Creating Option Response Problems
\layout Standard
To create an Option Response problem, create a new resource as described
in section
\begin_inset LatexCommand \ref{Creating New Content Pages}
\end_inset
.
This is a
\begin_inset Quotes eld
\end_inset
problem
\begin_inset Quotes erd
\end_inset
resource so the URL must end in
\begin_inset Quotes eld
\end_inset
.problem
\begin_inset Quotes erd
\end_inset
.
You should see a screen as in figure
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
.
\layout Enumerate
In the drop-down option box as seen in
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
, select
\series bold
Option Response Problem with
\emph on
N
\emph default
Concept Groups
\series default
, where
\series bold
\emph on
N
\series default
\emph default
is the number of Concept Groups you wish the problem to have, and click
the
\series bold
New Problem
\series default
button.
\layout Enumerate
Click the
\series bold
Edit
\series default
button above the sample problem to enter edit mode.
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 276
file optionResponseEditing.eps
width 3 80
flags 9
\end_inset
\layout Caption
Option Response Editor
\begin_inset LatexCommand \label{Option Response Editor Figure}
\end_inset
\end_float
You should see the Option Response page open up, which should look something
like what you see in figure
\begin_inset LatexCommand \ref{Option Response Editor Figure}
\end_inset
.
\layout Enumerate
Replace the text in the
\series bold
Text Block
\series default
with text that explains the conditions for your problem.
\layout Enumerate
Locate the
\series bold
Max Number of Shown Foils
\series default
element and type a number from 1 to 8 to display that number of questions.
You cannot display more then one foil from each concept group, so this
option will only reduce the number of foils displayed, if it is less then
the number of concept groups in your Option Response problem.
\layout Enumerate
Now you must define the options the students can select.
For each option you wish to add to the Option Response question, type the
option into the
\series bold
Add new Option
\series default
box in the
\series bold
Select Options
\series default
section, then hit the
\series bold
Save Changes
\series default
button.
If you do not hit the
\series bold
Save Changes
\series default
button, your option will not be selectable below.
\layout Enumerate
To delete the irrelevant options from the Option Response question, select
that option from the
\series bold
Delete Option
\series default
dropdown, and hit the Save Changes button.
Do that for each option you wish to remove.
\layout Enumerate
Now, you need to define the question foils.
Look for the foil with the name
\begin_inset Quotes eld
\end_inset
One
\begin_inset Quotes erd
\end_inset
.
Type the question into the text box, and select the correct option for
that question from the
\series bold
Correct Option
\series default
drop-down menu.
Click
\series bold
Submit Changes
\series default
to save this question foil.
Repeat this step for all remaining foils.
\layout Enumerate
Locate the foils that are not being used.
In their
\series bold
Delete
\series default
menus, set the value to
\series bold
Yes
\series default
.
Once you've set the Delete menu value correctly for all the foils, click
the
\series bold
Save Changes
\series default
button.
\layout Enumerate
In the Hint area, provide a helpful hint for users who get the problem incorrect
, and click the
\series bold
Save Changes
\series default
button.
\layout Subsection
Creating a String Response Problem
\layout Standard
To create an String Response problem, create a new resource as described
in section
\begin_inset LatexCommand \ref{Creating New Content Pages}
\end_inset
.
This is a
\begin_inset Quotes eld
\end_inset
problem
\begin_inset Quotes erd
\end_inset
resource so the URL must end in
\begin_inset Quotes eld
\end_inset
.problem
\begin_inset Quotes erd
\end_inset
.
You should see a screen as in figure
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
.
\layout Enumerate
In the drop-down option box as seen in
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
, select
\series bold
Simple String Response Problem
\series default
, and click the
\series bold
New Problem
\series default
button.
\layout Enumerate
Click the
\series bold
Edit
\series default
button above the sample problem to enter edit mode.
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 320
file stringResponseEditor.eps
width 3 80
flags 9
\end_inset
\layout Caption
String Response Editor
\begin_inset LatexCommand \label{String Response Editor Figure}
\end_inset
\end_float
You should see the String Response editor page open up, which should look
something like what you see in figure
\begin_inset LatexCommand \ref{String Response Editor Figure}
\end_inset
.
\layout Enumerate
Clear the text from the Text Block at the top of the problem, and type in
your problem's question.
\layout Enumerate
In the
\series bold
Answer Box
\series default
, type the correct answer.
\layout Enumerate
Select the answer condition from the drop down box.
There are three cases to choose from:
\begin_deeper
\layout Enumerate
\series bold
cs
\series default
: This means
\begin_inset Quotes eld
\end_inset
Case Sensitive
\begin_inset Quotes erd
\end_inset
.
For example, this is useful in Chemistry, where HO and Ho are completely
different answers
\begin_float footnote
\end_deeper
\layout Standard
\series bold
HO
\series default
is hydrogen monoxide, a colorless, odorless, poisonous gas.
\series bold
Ho
\series default
is the element 67, Holmium, in the Lanthanides.
\end_float
.
The student must match the case of the answer.
\begin_deeper
\layout Enumerate
\series bold
ci
\series default
: This means
\begin_inset Quotes eld
\end_inset
Case Insenstive
\begin_inset Quotes erd
\end_inset
.
The system does not use the case of the letters to determine the correctness
of the answer.
If the correct answer is
\begin_inset Quotes eld
\end_inset
car
\begin_inset Quotes erd
\end_inset
, the system will accept
\begin_inset Quotes eld
\end_inset
car
\begin_inset Quotes erd
\end_inset
,
\begin_inset Quotes eld
\end_inset
CAR
\begin_inset Quotes erd
\end_inset
,
\begin_inset Quotes eld
\end_inset
Car
\begin_inset Quotes erd
\end_inset
,
\begin_inset Quotes eld
\end_inset
caR
\begin_inset Quotes erd
\end_inset
, etc.
\layout Enumerate
\series bold
mc
\series default
: This means
\begin_inset Quotes eld
\end_inset
Multiple Choice
\begin_inset Quotes erd
\end_inset
.
The student's answers must contain the same letters as the question author's,
but order is unimportent.
This is usually used to give a multiple choice question in the question's
\series bold
Text Block
\series default
, which may have several correct parts.
If the author sets the correct answer as
\begin_inset Quotes eld
\end_inset
bcg
\begin_inset Quotes erd
\end_inset
, the system will accept
\begin_inset Quotes eld
\end_inset
bcg
\begin_inset Quotes erd
\end_inset
,
\begin_inset Quotes eld
\end_inset
cbg
\begin_inset Quotes erd
\end_inset
,
\begin_inset Quotes eld
\end_inset
gcb
\begin_inset Quotes erd
\end_inset
, etc., but not
\begin_inset Quotes eld
\end_inset
bc
\begin_inset Quotes erd
\end_inset
or
\begin_inset Quotes eld
\end_inset
abcg
\begin_inset Quotes erd
\end_inset
.
\layout Standard
It is conventional to tell the students whether the question is case sensitive
or not.
\end_deeper
\layout Enumerate
Optionally, locate the
\series bold
Single Line Text Entry Area
\series default
block and set a length in the Size box.
This will only affect the size of the box on the screen; if you set the
box size to 2, the student can still enter 3 or more letters in their answer.
\begin_deeper
\layout Comment
This seems like a great feature to either eliminate, or make useful.
Allowing the teacher to limit it to 3, and then not letting the student
type more then 3 chars might be a way of giving the student a hint.
Probably not worth it, as the problem text can always just say
\begin_inset Quotes eld
\end_inset
Pick two of the following
\begin_inset Quotes erd
\end_inset
.
This is probably not a useful feature.
\end_deeper
\layout Enumerate
Scroll down to the Hint element, and type some text that will help students
when they answer incorrectly.
\layout Enumerate
Click the Submit Changes button.
\layout Subsection
Creating Numerical Response
\begin_inset LatexCommand \index{Numerical Response}
\end_inset
\begin_inset LatexCommand \label{Numerical Response}
\end_inset
Problems
\layout Standard
Numerical Response problems are answered by entering a number and an optional
unit.
For instance, a numerical response problem might have an answer of
\begin_inset Formula \( 2m/s^{2} \)
\end_inset
.
\layout Standard
To create an Numerical Response problem, create a new resource as described
in section
\begin_inset LatexCommand \ref{Creating New Content Pages}
\end_inset
.
This is a
\begin_inset Quotes eld
\end_inset
problem
\begin_inset Quotes erd
\end_inset
resource so the URL must end in
\begin_inset Quotes eld
\end_inset
.problem
\begin_inset Quotes erd
\end_inset
.
You should see a screen as in figure
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
.
\layout Enumerate
In the drop-down option box as seen in
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
, select
\series bold
Simple Numerical Response Problem
\series default
, and click the
\series bold
New Problem
\series default
button.
\layout Enumerate
Click the
\series bold
Edit
\series default
button above the sample problem to enter edit mode.
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 302
file numericalResponseEditor.eps
width 3 80
flags 9
\end_inset
\layout Caption
Numerical Response Editor
\begin_inset LatexCommand \label{Numerical Response Editor Figure}
\end_inset
\end_float
You should see the String Response editor page open up, which should look
something like what you see in figure
\begin_inset LatexCommand \ref{Numerical Response Editor Figure}
\end_inset
.
\layout Enumerate
Please refer to the CAPA manual for help with Numerical Response Problems.
\layout Comment
Copout.
I need this info.
\layout Subsection
Creating Formula Response
\begin_inset LatexCommand \index{Formula Response}
\end_inset
\begin_inset LatexCommand \label{Formula Response}
\end_inset
Problems
\layout Standard
Formula Response problems are answered by entering a mathematical formula.
For instance, a numerical response problem might have an answer of
\begin_inset Formula \( x^{2}+11 \)
\end_inset
.
The answer may be in any equivalent format.
For instance, for
\begin_inset Formula \( x^{2}+11 \)
\end_inset
, the system will accept
\begin_inset Formula \( x*x-11 \)
\end_inset
or
\begin_inset Formula \( x^{2}+21-10 \)
\end_inset
as well.
\layout Standard
To create an Formula Response problem, create a new resource as described
in section
\begin_inset LatexCommand \ref{Creating New Content Pages}
\end_inset
.
This is a
\begin_inset Quotes eld
\end_inset
problem
\begin_inset Quotes erd
\end_inset
resource so the URL must end in
\begin_inset Quotes eld
\end_inset
.problem
\begin_inset Quotes erd
\end_inset
.
You should see a screen as in figure
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
.
\layout Enumerate
In the drop-down option box as seen in
\begin_inset LatexCommand \ref{Creating a new problem resource}
\end_inset
, select
\series bold
Simple Formula Problem
\series default
, and click the
\series bold
New Problem
\series default
button.
\layout Enumerate
Click the
\series bold
Edit
\series default
button above the sample problem to enter edit mode.
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 302
file numericalResponseEditor.eps
width 3 80
flags 9
\end_inset
\layout Caption
Numerical Response Editor
\begin_inset LatexCommand \label{Numerical Response Editor Figure}
\end_inset
\end_float
You should see the Formula Response editor page open up, which should look
something like what you see in figure
\begin_inset LatexCommand \ref{Numerical Response Editor Figure}
\end_inset
.
\layout Enumerate
Please refer to the CAPA manual for help with Numerical Response Problems.
\layout Comment
Copout.
I need this info.
\layout Section
Publishing Your Course
\layout Standard
In order to make the content you've created available for courses to use,
you must publish your content.
LON-CAPA provides an easy interface for publishing your content pages,
problem resources, and sequences.
A common interface allows you to specify title, author information, keywords,
and other metadata.
LON-CAPA uses this metadata for many things, and it's importent to fill
the metadata out as accurately as possible.
\layout Subsection
What is Metadata?
\begin_inset LatexCommand \index{Metadata}
\end_inset
\begin_inset LatexCommand \label{What Is Metadata?}
\end_inset
\layout Standard
\emph on
Metadata
\emph default
is
\emph on
data about data
\emph default
.
Metadata can often be thought of as a label on some bit of information
that can be useful to people or computer programs trying to use the data.
Without metadata, the person or computer trying to use the original information
would have to just guess what the original data is about.
For instance, if you create a problem and neglect to say in the title or
subject of the problem what it is about, then a human who wants to use
that problem would have to read the problem itself to see what it was about,
which is much more difficult then just reading a title.
A computer trying to do the same thing would just be out of luck; it is
too stupid to understand the problem statement at all.
\layout Standard
One example of metadata you use all the time is the of a webpage,
which usually shows up in the title bar of the browser.
That's information about the webpage itself, not actually part of the web
page.
People use it when they bookmark a page, so they know what the page is.
Search engines use it as a clue about the content of the web page.
\layout Subsection
Publishing A Resource
\begin_inset LatexCommand \index{Resource, Publishing}
\end_inset
\begin_inset LatexCommand \index{Publishing Resource}
\end_inset
\layout Standard
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 168
file constructionSpaceForPublishing.eps
width 3 80
flags 9
\end_inset
\layout Caption
Construction Space for Publishing
\begin_inset LatexCommand \label{Construction Space for Publishing Figure}
\end_inset
\end_float
To publish a resource, log in and choose your role to be an Author.
Then click
\series bold
CSTR
\series default
to go to your construction space.
You should see something like figure
\begin_inset LatexCommand \ref{Construction Space for Publishing Figure}
\end_inset
.
Click on the
\series bold
Publish
\series default
button for the resource you wish to publish.
\begin_float fig
\layout Standard
\align center
\begin_inset Figure size 476 338
file publishMetadata.eps
width 3 80
flags 9
\end_inset
\layout Caption
Publishing Metadata Screen
\begin_inset LatexCommand \label{Publishing Metadata Screen Figure}
\end_inset
\end_float
You'll get a metadata screen that should look something like figure
\begin_inset LatexCommand \ref{Publishing Metadata Screen Figure}
\end_inset
.
Fill out the form.
If you are creating resources that may be used in several courses, you
should talk with the other authors and establish some sort of standard
title and subject scheme in advance.
\layout Standard
The language is the language the problem is written in.
The Publisher/Owner is the person who owns the problem; it should be the
email address where anybody with questions about the resource can contact
someone who can help them.
In smaller environments, this is likely to be the author.
In larger environments, it may be a coordinator or manager.
\layout Standard
The
\series bold
Keywords
\series default
and the
\series bold
Abstract
\series default
are more information about the problem.
The
\series bold
Keywords
\series default
are words that are strongly connected to your problem; for instance a physics
problem about a pulley might include
\begin_inset Quotes eld
\end_inset
pulley
\begin_inset Quotes erd
\end_inset
as a key word.
LON-CAPA pulls out likely-looking keywords for you so you can just click
on them to make them keywords.
\series bold
Additional keywords
\series default
allows you to add any keyword to your problem that are not actually in
the problem.
For instance, on that same problem a physicist might add the keyword
\begin_inset Quotes eld
\end_inset
statics
\begin_inset Quotes erd
\end_inset
, even though it doesn't appear in the original problem, because Physics
uses that as a classification of problem type.
\layout Standard
Finally, you need to set the copyright and distribution notice.
This setting controls who is allowed to use your resource.
\layout Itemize
\series bold
Limited to courses in the domain published
\series default
means that only courses running in the same domain as you can use your
content.
Talk to your LON-CAPA administrator if you want more information about
your domain.
\layout Itemize
\series bold
Free
\series default
means that anyone can find and use the resource.
\layout Itemize
\series bold
Private - visible to author only
\series default
means that it can't be used for any course.
\layout Itemize
\series bold
Public - no authentication required
\series default
means anyone can find and use the resource.
\layout Standard
Now when you click
\series bold
Finalize Publication
\series default
, your resource will be published and usable (unless you set the distribution
to
\begin_inset Quotes eld
\end_inset
private
\begin_inset Quotes erd
\end_inset
).
\layout Section
Things That Need To Be Added
\layout Subsection
LON-CAPA and Units
\layout Subsection
Creating a default metadata file
\layout Subsection
Detailed number problem info
\layout Subsection
Detailed formula problem info
\layout Subsection
My questions\SpecialChar \ldots{}
\layout Itemize
How do I do the things above?
\layout Itemize
Is there any pre-existing documentation for number or formula problems?
\layout Itemize
Is there any pre-existing documentation for maps et al? I seem to have exhausted
the documentation.
\layout Itemize
What is the LON-CAPA default resource? If it's free, can just anyone
\begin_inset Quotes eld
\end_inset
find and use it
\begin_inset Quotes erd
\end_inset
, or just
\begin_inset Quotes eld
\end_inset
use it if they already know where it is
\begin_inset Quotes erd
\end_inset
? (In other words, how powerful is the search feature?) What's the difference
between free and public?
\layout Section
Appendix A: Student Interface
\layout Standard
\begin_float fig
\layout Caption
Student Remote Control
\begin_inset LatexCommand \label{Student Remote Control}
\end_inset
\end_float
The Student Remote Control will automatically load whenever you log in to
a LON-CAPA course as a student.
The Student Remote Control contains most of the functions of the Author
Remote Control and the following additional functions.
\layout Itemize
\series bold
NAV (NAVIGATE CONTENTS)
\series default
allows you to directly access resources from the course outline.
\layout Itemize
\series bold
ARROWS (LEFT and RIGHT)
\series default
allows you to move to the backward or forward through the course.
\layout Itemize
\series bold
GRDS (MY GRADES)
\series default
allows you to check your grades in the courses you are taking.
\layout Itemize
\series bold
SBKM (SET BOOKMARK)
\series default
allows you to bookmark pages for easy access.
\layout Itemize
\series bold
VBKM (VIEW BOOKMARK)
\series default
displays your bookmarks for easy access to bookmarked resources.
\layout Itemize
\series bold
ANOT (ANOTATE)
\series default
allows you to create personal notes.
\layout Itemize
\series bold
LOGOUT (LOGOUT)
\series default
will log you out of the LON-CAPA system.
\layout Standard
\begin_inset LatexCommand \printindex{}
\end_inset
\the_end