[BACK]Return to tutorial.lyx CVS log [TXT] [DIR] Up to [LON-CAPA] / doc / tutorial

Diff for /doc/tutorial/Attic/tutorial.lyx between versions 1.1 and 1.2

version 1.1, 2002/05/29 16:44:43 version 1.2, 2002/05/31 13:51:31
Line 6 Line 6
 \end_preamble  \end_preamble
 \language english  \language english
 \inputencoding auto  \inputencoding auto
 \fontscheme newcent  \fontscheme default
 \graphics default  \graphics default
 \paperfontsize default  \paperfontsize 12
 \spacing single   \spacing single 
 \papersize Default  \papersize Default
 \paperpackage a4  \paperpackage a4
 \use_geometry 1  \use_geometry 1
 \use_amsmath 0  \use_amsmath 0
 \paperorientation portrait  \paperorientation portrait
 \leftmargin 0.5in  \leftmargin 1in
 \topmargin 1.25in  \topmargin 1.25in
 \rightmargin 0.5in  \rightmargin 1in
 \bottommargin 0.5in  \bottommargin 1in
 \secnumdepth 3  \secnumdepth 3
 \tocdepth 3  \tocdepth 3
 \paragraph_separation indent  \paragraph_separation indent
Line 37  Online Line 37  Online
 \emph default   \emph default 
  Network with CAPA   Network with CAPA
 \layout Standard  \layout Standard
 \added_space_top vfill \pagebreak_bottom \align center   \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  Laboratory for Instructional Technology in Education
 \newline   \newline 
 and the  and the
Line 131  http://s10.lite.msu.edu/ Line 153  http://s10.lite.msu.edu/
 .  .
     
 \begin_float fig   \begin_float fig 
 \layout Caption  
   
   
 \begin_inset LatexCommand \label{LON-CAPA Log in screen}  
   
 \end_inset   
   
 LON-CAPA Log in screen   
 \layout Standard  \layout Standard
 \align center   \align center 
   
Line 150  flags 11 Line 164  flags 11
 \end_inset   \end_inset 
   
   
   \layout Caption
   
   
   \begin_inset LatexCommand \label{LON-CAPA Log in screen}
   
   \end_inset 
   
   LON-CAPA Log in screen 
 \end_float   \end_float 
 \layout Standard  \layout Standard
   
Line 392  The Author Remote Control, show in figur Line 414  The Author Remote Control, show in figur
  may position it on the screen where you can make the best use of it.   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   The Remote Control is a tool that allows you to switch between functions
  and roles within LON-CAPA.   and roles within LON-CAPA.
    
 \begin_float fig   \begin_float fig 
 \layout Caption  \layout Standard
   \align center 
   
 Author Remote Control  \begin_inset Figure size 177 420
 \begin_inset LatexCommand \label{Author Remote Control Figure}  file authorRemote.eps
   height 3 50
   flags 9
   
 \end_inset   \end_inset 
   
   
 \layout Standard  \layout Caption
   
   
 \begin_inset Figure size 164 387  Author Remote Control
 file authorRemote.eps  \begin_inset LatexCommand \label{Author Remote Control Figure}
 flags 8  
   
 \end_inset   \end_inset 
   
   
 \end_float   \end_float 
   \layout Comment
   
 Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any*  Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any*
  sort of sense on a first glance.   sort of sense on a first glance.
  Abbreviations are evil in this sort of application and should be used as   Abbreviations are evil in this sort of application and should be used as
Line 607  Description of the Construction Space Line 633  Description of the Construction Space
 \layout Standard  \layout Standard
   
 \begin_float fig   \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  \layout Caption
   
 Construction Space  Construction Space
Line 668  Publish this Resource Line 705  Publish this Resource
   
 \layout Standard  \layout Standard
   
 Publishes the current resource.  Opens the Resource Publishing window.
  This presents a publishing window where you can provide information for  
  metadata, keywords, language, etc.  
 \end_inset   \end_inset 
 </cell>  </cell>
 </row>  </row>
Line 724  Browse Line 759  Browse
   
 \layout Standard  \layout Standard
   
 Opens a file/directory browser for your local computer.  Helps you select a file to upload
  Use this to select a file to upload.  
 \end_inset   \end_inset 
 </cell>  </cell>
 </row>  </row>
Line 827  Type a name in the entry box to create a Line 861  Type a name in the entry box to create a
 \layout Subsection  \layout Subsection
   
 How to Create New Content Pages  How to Create New Content Pages
   \begin_inset LatexCommand \label{Creating New Content Pages}
   
   \end_inset 
   
   
 \layout Standard  \layout Standard
   
   
Line 865  In Location bar of your browser, type in Line 904  In Location bar of your browser, type in
   
 , for example,   , for example, 
 \emph on   \emph on 
 http://www.s10.lite.msu.edu/priv/directory/new_resource.html  http://www.s10.lite.msu.edu/priv/\SpecialChar \-
   directory/new_resource.html
 \emph default   \emph default 
 .  .
  Press the Return or Enter key.   Press the Return or Enter key.
Line 873  http://www.s10.lite.msu.edu/priv/directo Line 913  http://www.s10.lite.msu.edu/priv/directo
   
 You should see something like the following message:   You should see something like the following message: 
 \series bold   \series bold 
 File not found: /home/wmsonj/priv/directory/new_resource.html  File not found: /home/wmsonj/priv/\SpecialChar \-
   directory/new_resource.html
 \series default   \series default 
 , and an Edit button.  , and an Edit button.
  An HTML editor opens with a simple page template.   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  \layout Enumerate
   
 Type the content into the editor,   Type the content into the editor, 
 \series bold   \emph on 
 OR  OR
 \series default   \emph default 
  copy and paste HTML source code into the editor.   copy and paste HTML source code into the editor.
 \layout Enumerate  \layout Enumerate
   
Line 898  Finally, click the Line 947  Finally, click the
 Save this  Save this
 \series default   \series default 
  button    button 
 \series bold   \emph on 
 OR  OR
 \series default   \emph default 
  click the    click the 
 \series bold   \series bold 
 Save and then attempt to clean HTML  Save and then attempt to clean HTML
Line 949  Finally, click the Line 998  Finally, click the
 Save this  Save this
 \series default   \series default 
  button    button 
 \series bold   \emph on 
 OR  OR
 \series default   \emph default 
  click the    click the 
 \series bold   \series bold 
 Save and then attempt to clean HTML  Save and then attempt to clean HTML
Line 973  There are five types of problems that ca Line 1022  There are five types of problems that ca
  appropriate questions for your course.   appropriate questions for your course.
 \layout Subsubsection  \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  Radio Response
 \begin_inset LatexCommand \index{Radio Response}  \begin_inset LatexCommand \index{Radio Response}
   
Line 981  Radio Response Line 1048  Radio Response
  Problems   Problems
 \layout Standard  \layout Standard
   
 Radio Response problems represent multiple choice questions.  
 \layout Standard  
   
 True/False problems present the student with one question that can be answered  \series bold 
  true or false.  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  \layout Standard
   
 Multiple choice problems are created almost identically to True/False problems.  Multiple choice problems contain between 3 and 10 foils.
  Multiple choice problems contain 3-10 foils.   You may display from three to five foils for each problem and the system
  You may display 3-5 foils for each problem and the system randomly picks   randomly picks the choices that are presented to the student.
  the choices that are presented to the student.  \layout Comment
 \layout Standard  
   
 Option Response Problems  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  \layout Standard
   
 Option Response problems present foils to the student with drop-down boxes.  Option Response problems present foils to the student with drop-down boxes.
  Option response questions may be presented as a collection of True/False   A group of foils is created for each concept group, and the system will
  type questions or as a matching type question.   pick one to present to the student from each group.
  The student must choose the correct answer for each part of the question.   The student must match each of his or her questions correctly to the possible
 \layout Standard   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  String Response Problems
 \layout Standard  \layout Standard
   
 String Response problems are problems in which the student submits a string  
  of characters for the answer.  \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   Examples of string response questions are vocabulary tests, short answer
  and entering chemical formulas.   and entering chemical formulas.
   \layout Comment
   
   Case sensitivity?
 \layout Standard  \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  Numerical Response Problems
 \layout Standard  \layout Standard
   
 Numerical Response problems are answered by entering a number and (optionally)  
  a unit, such as 2.5 m/s^2.  \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.   Tolerance and significant digits can be specified as well.
 \layout Standard  \layout Subsubsection
   
 Formula Response Problems  Formula Response Problems
 \layout Standard  \layout Standard
   
 Formula Response problems are questions in which the student types in a  Formula Response problems are questions in which the student types in a
  math formula for the answer.   math formula for the answer.
  If the answer is "x^2 - 11", the student can enter "x^2 - 11", "x*x - 11",   If the answer is 
  "x^2 + 21 - 10", etc.  \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   Functions such as cos, sin, and exp are accepted as well as the operators
  (), +, -, *, and /.   (), +, -, *, 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 
   <norandom>
   \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 <TITLE> 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  \layout Section
   
 Appendix A: Student Interface  Appendix A: Student Interface
Line 1097  ANOT (ANOTATE) Line 2832  ANOT (ANOTATE)
 LOGOUT (LOGOUT)  LOGOUT (LOGOUT)
 \series default   \series default 
  will log you out of the LON-CAPA system.   will log you out of the LON-CAPA system.
   \layout Standard
   
   
   \begin_inset LatexCommand \printindex{}
   
   \end_inset 
   
   
 \the_end  \the_end
Removed from v.1.1  
changed lines
  Added in v.1.2

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>