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

version 1.1, 2002/05/29 16:44:43 version 1.3, 2002/06/03 05:15:59
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 31 Line 31
   
 \layout Title  \layout Title
   
 Introduction to the Learning   Learning 
 \emph on   \emph on 
 Online  Online
 \emph default   \emph default 
  Network with CAPA   Network with CAPA
   \newline 
   
   \emph on 
   \SpecialChar ~
   
   \newline 
   
   \size larger 
   Author's Tutorial And Manual
   \layout Standard
   \added_space_top vfill \align center 
   \SpecialChar ~
   
 \layout Standard  \layout Standard
 \added_space_top vfill \pagebreak_bottom \align center   \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 98  developed your objectives for your cours Line 129  developed your objectives for your cours
 \layout Itemize  \layout Itemize
   
 developed your problems for testing and identified the question formats.  developed your problems for testing and identified the question formats.
  The Template for Mapping Website to LON-CAPA that you filled in will assist  \layout Subsection
  you in the process of creating your course website structure in LON-CAPA.  
   About This Manual
   \layout Standard
   
   Throughout this manual, keywords and phrases literally present on the computer
    screen will be referred to in 
   \series bold 
   bold type
   \series default 
   .
   \layout Standard
   
   Chapters 
   \begin_inset LatexCommand \ref{Author Interface}
   
   \end_inset 
   
    through 
   \begin_inset LatexCommand \ref{Creating a Course}
   
   \end_inset 
   
    comprise a tutorial that will introduce you to the authoring system.
    After that, this document is a reference manual for authoring course materials.
 \layout Standard  \layout Standard
   
 This tutorial describes how to use the various author functions available  For more information, see the website at http://help.loncapa.org/, where you
  in LON-CAPA.   can get help and information.
    If you cannot find an answer for your question, please email us and let
    us know, so we put the solution to your problem online.
 \layout Section  \layout Section
   
 The LON-CAPA Author Interface  The LON-CAPA Author Interface
   \begin_inset LatexCommand \label{Author Interface}
   
   \end_inset 
   
   
 \layout Subsection  \layout Subsection
   
 Login as Course Author  Login as Course Author
Line 131  http://s10.lite.msu.edu/ Line 192  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 203  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 158  Fill in the Username and Password boxes Line 219  Fill in the Username and Password boxes
  This will take you to your LON-CAPA User Roles menu.   This will take you to your LON-CAPA User Roles menu.
 \layout Description  \layout Description
   
 Note: Your Username is your PILOT ID, which is the part of your PILOT email  Note: Your Username and Password will be given to you by your system administrat
  address to the left of the @.  or.
  Your password is your PILOT email password.   Both are case sensitive, so make sure you type them with the correct case.
  Both the PILOT ID and the password are case sensitive, so make sure you  
  type upper- and lower-case letters correctly.  
 \layout Subsection  \layout Subsection
   
   
Line 290  ROLES Line 349  ROLES
   
  button takes up on my printout! So in actuality, you're commiting to something   button takes up on my printout! So in actuality, you're commiting to something
  no sane remote control designer could deal with.   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  \layout Comment
   
 \SpecialChar ~  \SpecialChar ~
Line 367  The upshot is that the only upside to th Line 384  The upshot is that the only upside to th
   
 \layout Comment  \layout Comment
   
 Also, based on my relatively little info, I think you're data-mining the  We're data-mining the web logs to see what people actually use.
  web logs to see what people actually use.  
  This is good.   This is good.
  We may need to do some really simple stuff before he finishes.   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   Raw statistics on what buttons are pressed most often can probably be interpret
Line 392  The Author Remote Control, show in figur Line 408  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 499  Content Page Line 519  Content Page
 \end_inset   \end_inset 
   
  displays course content.   displays course content.
  It is mostly a conventional HTML page.   It is essentially a conventional HTML page.
     
 \layout Comment  \layout Comment
   
Line 547  Sequence Line 567  Sequence
   
 \series default   \series default 
  type represents a programmed series of events.   type represents a programmed series of events.
  The users of this resource can use array keys or NAV buttons to follow   The users of this resource can use buttons on their remote or the NAV button
  the sequence.   to follow the sequence.
  These resources are stored in files that must use the extension    These resources are stored in files that must use the extension 
 \begin_inset Quotes eld  \begin_inset Quotes eld
 \end_inset   \end_inset 
Line 607  Description of the Construction Space Line 627  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 699  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 753  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 855  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 834  How to Create New Content Pages Line 867  How to Create New Content Pages
 Content Pages  Content Pages
 \series default   \series default 
  are HTML documents that display the course information you are presenting.   are HTML documents that display the course information you are presenting.
  These documents can be created in any order.   To create new Content Pages, do the following:
 \layout Comment  
   
 Is this worth mentioning?  
 \layout Standard  
   
 To create new Content Pages, do the following:  
 \layout Comment  \layout Comment
   
 Is step one necessary? I don't see how it could be.  Is step one necessary? I don't see how it could be.
Line 865  In Location bar of your browser, type in Line 892  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 901  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 935  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 909  Save and then attempt to clean HTML Line 946  Save and then attempt to clean HTML
 \layout Standard  \layout Standard
   
 Repeat this process as many times as necessary to create your Content Pages.  Repeat this process as many times as necessary to create your Content Pages.
    
   \layout Standard
   
   If you're following this as a tutorial, create at least one content page,
    which we'll use later as raw material.
 \layout Subsection  \layout Subsection
   
 How to Edit Existing Content Pages  How to Edit Existing Content Pages
Line 949  Finally, click the Line 991  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 961  Save and then attempt to clean HTML Line 1003  Save and then attempt to clean HTML
 \layout Subsection  \layout Subsection
   
 Creating Online Problems Using LON-CAPA  Creating Online Problems Using LON-CAPA
   \layout Standard
   
   If you're following this as a tutorial, go ahead and make one of each of
    these problem types now.
    We'll be using them later as raw material to assemble maps and sequences.
 \layout Subsubsection  \layout Subsubsection
   
 Problems Types  Problems Types
Line 973  There are five types of problems that ca Line 1020  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 1046  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  
   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 Problems  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 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 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 their own concept group:
   \layout Itemize
   
   Claire de Lune
   \begin_inset LatexCommand \index{Clair de Lune}
   
   \end_inset 
   
   
   \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 And Formula Response 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 
   
   .
    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
   
   Creating Numerical Response and Formula Response problems starts the same
    as the other problem types, but because of the power of Numerical Response
    and Formula Response problems, it is too difficult to cover them in this
    tutorial.
    For more information about these problem types, please see section 
   \begin_inset LatexCommand \ref{Numerical Response}
   
   \end_inset 
   
    for Numerical Response problems and section 
   \begin_inset LatexCommand \ref{Formula Response}
   
   \end_inset 
   
    for Formula Response problems.
   \layout Section
   
   Publishing Your Resources
   \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 Standard
   
   If you're following this as a tutorial, publish your resources so we can
    use them in the next section.
   \layout Section
   
   Creating A Course
   \begin_inset LatexCommand \label{Creating a Course}
   
   \end_inset 
   
   : Maps and Sequences
   \layout Standard
   
   In order to create a useful course, we need to arrange our raw materials
    so that students can use them.
   \layout Subsection
   
   Binding Together Resources In One Map: Page
   \begin_inset LatexCommand \index{Page}
   
   \end_inset 
   
   
   \layout Standard
   
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 429 66
   file mapEditingButton.eps
   flags 9
   
   \end_inset 
   
   
   \layout Caption
   
   Map Editing Button
   \begin_inset LatexCommand \label{Map Editing Button Figure}
   
   \end_inset 
   
   
   \end_float 
   To join several resources into one page, you need to create a 
   \series bold 
   Map
   \series default 
    of type 
   \series bold 
   Page
   \series default 
   .
    To create Page resource, 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 
   
   page
   \begin_inset Quotes erd
   \end_inset 
   
    resource so the URL must end in 
   \begin_inset Quotes eld
   \end_inset 
   
   .page
   \begin_inset Quotes erd
   \end_inset 
   
   .
    After you enter in the URL ending in 
   \begin_inset Quotes eld
   \end_inset 
   
   .page
   \begin_inset Quotes erd
   \end_inset 
   
   , you should see a screen as in figure 
   \begin_inset LatexCommand \ref{Map Editing Button Figure}
   
   \end_inset 
   
   .
    Click the button to get to the sequence editor.
    
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 476 226
   file mapEditInitial.eps
   width 3 80
   flags 11
   
   \end_inset 
   
   
   \layout Caption
   
   Initial Map Editor
   \begin_inset LatexCommand \label{Initial Map Editor FIgure}
   
   \end_inset 
   
   
   \end_float 
   After the system notices the map does not yet exist and creates it for you.
    You should the initial map editor as seen in figure 
   \begin_inset LatexCommand \ref{Initial Map Editor FIgure}
   
   \end_inset 
   
   .
    Note there are two windows.
    One is the workspace, and one is the window which will contain information
    as you add resources.
   \layout Subsection
   
   About The Editor
   \layout Standard
   
   \begin_float fig 
   \layout Caption
   
   Example of the Map Editor
   \begin_inset LatexCommand \label{Map Editor Example Figure}
   
   \end_inset 
   
   
   \end_float 
   Maps are very powerful and can do a lot.
    They can make decisions as the user progresses, and go down different paths
    under different circumstances.
    For instance, a map can go down one path if the user gets a problem right,
    and another path if they don't.
    
   \layout Standard
   
   To facilitate editing these powerful entities, LON-CAPA has a map editor
    that helps you take advantage of this power, as seen in figure 
   \begin_inset LatexCommand \ref{Map Editor Example Figure}
   
   \end_inset 
   
   .
    The map editor can display the different paths in your browser, and allow
    you to edit, insert, and delete resources from your map.
    The editor has a 
   \series bold 
   Start
   \series default 
    area and a 
   \series bold 
   Finish
   \series default 
    area.
    The students in the course will progress along on path or another, depending
    on decisions made at each resource, as explained later.
    Different paths are represented with different lines in the map editor.
    In the example figure, there are two paths the student can go down, depending
    on whether or not they get the problem at the branch point correct.
    By the end of this section, we'll create the map represented in this figure.
   \layout Standard
   
   The branching ability can obviously be used to help the student understand
    the concept in the problem by having them go through some extra material
    based on their performance, but the total uses of this feature are limited
    only by your imagination.
   \layout Subsection
   
   Creating a Simple Map: Page
   \layout Standard
   
   To add a resource to the map:
   \layout Enumerate
   
   Click on an unused light gray area.
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 476 242
   file mapEditFirstClick.eps
   width 3 80
   flags 9
   
   \end_inset 
   
   
   \layout Caption
   
   Map Editor after clicking on the box labelled 
   \begin_inset Quotes eld
   \end_inset 
   
   here
   \begin_inset Quotes erd
   \end_inset 
   
   .
    
   \begin_inset LatexCommand \label{Map Editor First Click Figure}
   
   \end_inset 
   
   
   \end_float 
    In figure 
   \begin_inset LatexCommand \ref{Map Editor First Click Figure}
   
   \end_inset 
   
   , the map editor after clicking on the area labelled 
   \begin_inset Quotes eld
   \end_inset 
   
   here
   \begin_inset Quotes erd
   \end_inset 
   
    is shown.
    In that figure, lines have been added to show where the box boundaries
    are for the purposes of demonstration.
    This is to allow you to stay in sync with this tutorial; normally this
    doesn't matter.
    
   \begin_deeper 
   \layout Standard
   
   Note that the contents of the seperate window have changed.
   \end_deeper 
   \layout Enumerate
   
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 476 218
   file mapNewResource.eps
   width 3 80
   flags 9
   
   \end_inset 
   
   
   \layout Caption
   
   Map Resource Editor
   \begin_inset LatexCommand \label{Map Resource Editor Figure}
   
   \end_inset 
   
   
   \end_float 
   Click on 
   \series bold 
   Insert Resource
   \series default 
    in the secondary window.
    A 
   \series bold 
   Resource
   \series default 
    will appear in the map editor.
    Click on the new Resource, and you'll get something like Figure 
   \begin_inset LatexCommand \ref{Map Resource Editor Figure}
   
   \end_inset 
   
    will show appear.
    Click 
   \series bold 
   Browse
   \series default 
   , and the 
   \series bold 
   Network Directory Browser
   \series default 
    will appear,
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 476 216
   file mapEditorDirectoryBrowser.eps
   width 3 80
   flags 9
   
   \end_inset 
   
   
   \layout Caption
   
   Network Directory Browser
   \begin_inset LatexCommand \label{Map Editor Network Directory Browser Figure}
   
   \end_inset 
   
   
   \end_float 
    looking something like figure 
   \begin_inset LatexCommand \ref{Map Editor Network Directory Browser Figure}
   
   \end_inset 
   
   .
    Press the select button that is next to the resource you want to include.
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 476 213
   file mapEditorResourceChosen.eps
   width 3 80
   flags 9
   
   \end_inset 
   
   
   \layout Caption
   
   Resource Chosen
   \begin_inset LatexCommand \label{Map Resource Chosen Figure}
   
   \end_inset 
   
    (HTML page)
   \end_float 
    Once you've done that, if you look back at the window that popped up when
    you clicked on 
   \series bold 
   New Resource
   \series default 
   , you'll see something like figure 
   \begin_inset LatexCommand \ref{Map Resource Chosen Figure}
   
   \end_inset 
   
   .
    You can type the 
   \series bold 
   URL
   \series default 
    and 
   \series bold 
   Title
   \series default 
    if you prefer, following the format you see above.
    After you click 
   \series bold 
   Save Changes
   \series default 
   , your changes will be saved, and the icons for the resource will appear
    in the 
   \series bold 
   Res
   \series default 
    box, as shown in figure 
   \begin_inset LatexCommand \ref{Map Resource Chosen Figure}
   
   \end_inset 
   
   .
   \begin_deeper 
   \layout Standard
   
   Clicking on the left icon for a resource will open a new browser window
    with an informational page about that resource.
    Clicking on the right icon for a resource will open a new browser window
    taking you to the rendering of that resource.
   \end_deeper 
   \layout Enumerate
   
   Let's give practice giving ourselves a bit more space.
    Click on the grey space just left of your resource, and select 
   \series bold 
   Insert Column Right
   \series default 
   .
    This will add a column to the right of that space.
    Now, click on the bottom row in the grey area, and select 
   \series bold 
   Insert Row Above
   \series default 
   .
    This gives us enough space to work with.
   \layout Enumerate
   
   Now, in the map editor window, click just to the left of the 
   \series bold 
   Res
   \series default 
    box.
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 357 190
   file mapSecondWindowSecondResource.eps
   flags 9
   
   \end_inset 
   
   
   \layout Caption
   
   Choosing your second resource
   \begin_inset LatexCommand \label{Map Second Resource Figure}
   
   \end_inset 
   
   
   \end_float 
    The secondary window will appear as it does in figure 
   \begin_inset LatexCommand \ref{Map Second Resource Figure}
   
   \end_inset 
   
   , but for now just choose 
   \series bold 
   Insert Resource
   \series default 
    again, not the new options.
    Insert a resource in the same manner as before.
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 476 243
   file mapTwoResources.eps
   width 3 80
   flags 11
   
   \end_inset 
   
   
   \layout Caption
   
   Two Resource in the Map Editor
   \begin_inset LatexCommand \label{Two Resources in the Map Editor Figure}
   
   \end_inset 
   
   
   \end_float 
    You should have something that looks like figure 
   \begin_inset LatexCommand \ref{Two Resources in the Map Editor Figure}
   
   \end_inset 
   
   , though the exact placement may differ.
    Now we need to link them together.
   \layout Enumerate
   
   Click the Start box.
    In the secondary window, select 
   \series bold 
   Link Resource
   \series default 
   .
    The secondary window will prompt you to click on the resource you want
    to link it to.
    Click the first resource you added to the map.
    A new link is created.
   \layout Enumerate
   
   Repeat the last step, linking the first resource to the second resource,
    and the second resource to 
   \series bold 
   Finish
   \series default 
   .
   \layout Enumerate
   
   Now, in the editor window, click 
   \series bold 
   Save Map
   \series default 
   .
    A dialog box will pop up, telling you the map has been saved.
   \layout Standard
   
   Now that you 
   \layout Section
   
   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 very powerful.
    In fact, they are so powerful it would be impossible to fully explain what
    is possible in a document like this.
    This chapter will focus on just getting you started with Numerical Response
    problems, and showing you some of the possibilities, with no prerequisite
    knowlege necessary.
    The more you learn, the more you will find you can do.
   \layout Standard
   
   In this chapter and the next, I will use the terms 
   \series bold 
   static
   \series default 
    and 
   \series bold 
   dynamic
   \series default 
   .
    
   \series bold 
   Static
   \series default 
    means the object never changes, and is the same for each student.
    By contrast, 
   \series bold 
   dynamic
   \series default 
    means the value can change, because there is some script that computes
    it for each student.
   \layout Standard
   
   If you like, you can follow this chapter along as its own tutorial.
    Create a Numerical Response problem using the instructions in section 
   \begin_inset LatexCommand \ref{Creating New Content Pages}
   
   \end_inset 
   
   , ending your resource name with 
   \begin_inset Quotes eld
   \end_inset 
   
   .problem
   \begin_inset Quotes erd
   \end_inset 
   
   , and create a new 
   \series bold 
   Simple Numerical Response
   \series default 
    problem.
   \layout Subsection
   
   The Parts of a Numerical Response Problem
   \layout Standard
   
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 476 356
   file numericalResponse1.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 
   A Numerical Response problem has seven major parts by default, as seen in
    figure 
   \begin_inset LatexCommand \ref{Numerical Response Editor Figure}
   
   \end_inset 
   
   :
   \layout Enumerate
   
   The 
   \series bold 
   Script
   \series default 
   .
    The script is the heart of advanced Numerical Response problems.
    It can be used to decide some of the parameters of the problem, compute
    the answer to the problem, and do just about anything else you can imagine.
    The Script language is 
   \series bold 
   Perl
   \begin_float footnote 
   \layout Standard
   
   For lots and lots more information about Perl, see the Perl website at http://ww
   w.perl.org/ .
   \end_float 
   .
    You do not need to know Perl to use the Script block, as we will be stepping
    through some advanced examples in this chapter, but knowing Perl can help.
   \layout Enumerate
   
   Like other problem types, the 
   \series bold 
   Text Block
   \series default 
    is used to display the problem the student will see.
    In addition, you can place things in the 
   \series bold 
   Text Block
   \series default 
    based on computations done in the 
   \series bold 
   Script
   \series default 
   .
   \layout Enumerate
   
   The 
   \series bold 
   Answer
   \series default 
    is the answer the system is looking for.
    This can also use parameters from the 
   \series bold 
   Script
   \series default 
    block, allowing the answer to be computed dynamically.
   \layout Enumerate
   
   A 
   \series bold 
   tolerance
   \begin_inset LatexCommand \index{tolerance}
   
   \end_inset 
   
   
   \series default 
    parameter, which determines how closely the system will require the student
    answer to be in order to count it correct.
    For technical reasons, it is almost never a good idea to set this parameter
    to zero
   \begin_float footnote 
   \layout Standard
   
   Computers can only approximate computations involving real numbers.
    For instance, a computer's [decimal] answer to the simple problem 
   \begin_inset Formula \( \frac{1}{3} \)
   \end_inset 
   
    is 
   \begin_inset Quotes eld
   \end_inset 
   
   0.33333333333333331
   \begin_inset Quotes erd
   \end_inset 
   
   .
    It 
   \emph on 
   should
   \emph default 
    be an infinite series of 3's, and there certainly shouldn't be a 
   \begin_inset Quotes eld
   \end_inset 
   
   1
   \begin_inset Quotes erd
   \end_inset 
   
    in the answer, but no computer can represent an infinitely long, infinitely
    detailed real number.
    Therefore, for any problem where the answer is not a small integer, you
    
   \emph on 
   need
   \emph default 
    to allow a tolerance factor, or the students will find it nearly impossible
    to exactly match the computers idea of the answer.
   \end_float 
   , though you may find the default too large for some problems.
    There are two kinds of tolerance.
    If there is some answer 
   \begin_inset Formula \( a \)
   \end_inset 
   
    and a tolerance 
   \begin_inset Formula \( t \)
   \end_inset 
   
   ,
   \begin_deeper 
   \layout Enumerate
   
   an 
   \series bold 
   Absolute
   \series default 
    tolerance
   \begin_inset LatexCommand \index{absolute tolerance}
   
   \end_inset 
   
   
   \begin_inset LatexCommand \index{tolerance, absolute}
   
   \end_inset 
   
    will take anything in the range 
   \begin_inset Formula \( a\pm t \)
   \end_inset 
   
   .
    So if 
   \begin_inset Formula \( a=10 \)
   \end_inset 
   
    and 
   \begin_inset Formula \( t=2 \)
   \end_inset 
   
   , then anything between 8 and 12 is acceptable
   \begin_float footnote 
   \end_deeper 
   \layout Standard
   
   For much the same reasons a tolerance is almost always a good idea, it's
    almost impossible to say whether an answer that is 
   \emph on 
   exactly
   \emph default 
    
   \begin_inset Formula \( a\pm t \)
   \end_inset 
   
    will be accepted by the computer.
    But the computer does use many decimal places of accuracy; if you want
    to have the student answer exactly 
   \begin_inset Quotes eld
   \end_inset 
   
   2
   \begin_inset Quotes erd
   \end_inset 
   
   , then specifying a tolerance of 
   \begin_inset Quotes eld
   \end_inset 
   
   .0000001
   \begin_inset Quotes erd
   \end_inset 
   
    is OK.
    (Don't use too many more zeros, though you can use less if you like.)
   \end_float 
   .
    Any number in the tolerance field 
   \emph on 
   without
   \emph default 
    a 
   \series bold 
   %
   \series default 
    symbol is an absolute tolerance.
   \begin_deeper 
   \layout Enumerate
   
   a 
   \series bold 
   Relative
   \series default 
    tolerance
   \begin_inset LatexCommand \index{relative tolerance}
   
   \end_inset 
   
   
   \begin_inset LatexCommand \index{tolerance, relative}
   
   \end_inset 
   
    will take anything in the range 
   \begin_inset Formula \( a\pm at \)
   \end_inset 
   
   , where 
   \emph on 
   t
   \emph default 
    is interpreted as a percentage.
    Any number in the tolerance field 
   \emph on 
   with
   \emph default 
    a 
   \series bold 
   %
   \series default 
    symbol is a relative tolerance.
    For example, 
   \begin_inset Formula \( a=10 \)
   \end_inset 
   
    and 
   \begin_inset Formula \( t=10\% \)
   \end_inset 
   
    will accept anything between 9 and 11.
    
   \end_deeper 
   \layout Enumerate
   
   A 
   \series bold 
   significant figures
   \series default 
    specification tells the system how many significant figures there are in
    the problem, as either a single number or a range of acceptable values,
    expressed as 
   \series bold 
   min,max
   \series default 
   .
    The system will check to make sure that the student's answer contains this
    many significant digits, useful in many scientific calculations.
    For example, if the problem has three significant digits, the significant
    digit specification is 
   \begin_inset Quotes eld
   \end_inset 
   
   3
   \begin_inset Quotes erd
   \end_inset 
   
   , and the answer is 
   \begin_inset Quotes eld
   \end_inset 
   
   1.3
   \begin_inset Quotes erd
   \end_inset 
   
   , the system will require the students to type 
   \begin_inset Quotes eld
   \end_inset 
   
   1.30
   \begin_inset Quotes erd
   \end_inset 
   
   , even though numerically, 
   \begin_inset Quotes eld
   \end_inset 
   
   1.3
   \begin_inset Quotes erd
   \end_inset 
   
    and 
   \begin_inset Quotes eld
   \end_inset 
   
   1.30
   \begin_inset Quotes erd
   \end_inset 
   
    are the same.
   \begin_deeper 
   \layout Comment
   
   Confirm this.
   \end_deeper 
   \layout Enumerate
   
   The 
   \series bold 
   Single Line Text Entry
   \series default 
    area, as in other problems, allow you to manipulate the text entry area
    the student will see.
   \layout Enumerate
   
   Finally, the 
   \series bold 
   Hint
   \series default 
    provides a place to help students who get the problem incorrect the first
    time.
   \layout Subsection
   
   Simple Numerical Response Answer
   \layout Standard
   
   Along with showing the Numerical Response editor, figure 
   \begin_inset LatexCommand \ref{Numerical Response Editor Figure}
   
   \end_inset 
   
    also shows the parameters for one of the simplest possible types of numerical
    response.
    The 
   \series bold 
   Text Block
   \series default 
    has the problem's question, which is the static text 
   \begin_inset Quotes eld
   \end_inset 
   
   What is 2 + 2?
   \begin_inset Quotes erd
   \end_inset 
   
    The 
   \series bold 
   Answer
   \series default 
    is 
   \begin_inset Quotes eld
   \end_inset 
   
   4
   \begin_inset Quotes erd
   \end_inset 
   
   .
    The 
   \series bold 
   Hint
   \series default 
    has been set to something appropriate for this problem (unless this problem
    is being given to very young children).
    Everything else has the default values from when the problem was created.
   \layout Standard
   
   If you create a problem like this, hit 
   \series bold 
   Submit Changes
   \series default 
   , then hit 
   \series bold 
   View
   \series default 
    after the changes have been submitted, you can try the problem out for
    yourself.
    Note the last box in the HTML page has the answer LON-CAPA is looking for
    conveniently displayed for you, along with the range the computer will
    accept and the number of significant digits the computer requires.
   \layout Standard
   
   As you're playing with the problem, if you use up all your tries or get
    the answer correct but wish to continue playing with the problem, use the
    
   \series bold 
   Reset Submissions
   \series default 
    button to clear your answer attempts.
    
   \layout Subsection
   
   Simple Script Usage
   \layout Standard
   
   Totally static problems only scratch the surface of the Numerical Response
    capabilities.
    To really explore the power of LON-CAPA, we need to start creating dynamic
    problems.
    But before we can get to truly dynamic problems, we need to learn how to
    work with the 
   \series bold 
   Script
   \begin_inset LatexCommand \index{Script}
   
   \end_inset 
   
   
   \series default 
    window.
   \layout Standard
   
   A script consists of several 
   \series bold 
   statements
   \series default 
   , seperated by 
   \series bold 
   semi-colons
   \series default 
   .
    A 
   \series bold 
   statement
   \begin_inset LatexCommand \index{statement}
   
   \end_inset 
   
   
   \series default 
    is the smallest kind of instruction to the computer you can give.
    Most problems will be built from several statements.
    
   \layout Standard
   
   A script can contain 
   \series bold 
   comments
   \series default 
   , which are not interpreted as statements by the computer.
    Comments start with 
   \series bold 
   #
   \series default 
   , and go to the end of that line.
    Thus, if a line starts with #, the whole line is ignored.
    Comments can also begin in the middle of a line.
    It is a good idea to comment more complicated scripts, as it can be very
    difficult to read a large script and figure out what it does.
    It is a 
   \emph on 
   very
   \emph default 
    good idea to adopt some sort of commenting standard, especially if you
    are working in a group or others may use your problems in the future.
   \layout Standard
   
   One of the simplest statements in LON-CAPA is a 
   \series bold 
   variable assignment
   \series default 
   .
    A 
   \series bold 
   variable
   \series default 
    can hold any value in it.
    Simple values, such as a number or a string of text, start with a 
   \series bold 
   $
   \series default 
   .
    In the 
   \series bold 
   Script
   \series default 
   , you need to assign to variables before you use them.
    Put the program in Figure
   \begin_float fig 
   \layout LyX-Code
   \align center 
   $variable = 3;
   \layout Caption
   \pextra_type 3 \pextra_widthp 40
   
   A simple script with a variable 
   \begin_inset LatexCommand \label{A simple script with a variable}
   
   \end_inset 
   
   
   \end_float 
    
   \begin_inset LatexCommand \ref{A simple script with a variable}
   
   \end_inset 
   
    into the 
   \series bold 
   Script
   \series default 
    field of the Numerical Response.
    This creates a simple variable named 
   \series bold 
   variable
   \series default 
    and assigns it the value of 
   \begin_inset Quotes eld
   \end_inset 
   
   3
   \begin_inset Quotes erd
   \end_inset 
   
   .
    That's one statement.
   \layout Standard
   
   Variable names are 
   \emph on 
   case sensitive
   \emph default 
   , must start with a letter, and can only consist of letters, numbers, and
    underscores.
    Variable names can be as long as you want.
    
   \layout Standard
   
   Getting variable names right is a skill.
    Variable names should not be too long, because they become easy to mistype.
    Variable names should also not be too short, with the exception of some
    conventionally short variable names we'll talk about later.
   \layout Standard
   
   There are many variable naming conventions, covering both how to name and
    how to capatalize variables
   \begin_float footnote 
   \layout Standard
   
   The author favors 
   \family typewriter 
   capsOnNewWords
   \family default 
   .
    Some people use 
   \family typewriter 
   underscore_to_seperate_words
   \family default 
   .
    Many use uppercase letters to specify constants like 
   \family typewriter 
   PI
   \family default 
    or 
   \family typewriter 
   GOLDEN_MEAN
   \family default 
   .
    Some people always 
   \family typewriter 
   StartWithCapatalization
   \family default 
   .
    What's really importent is to be consistent, so you don't have to guess
    whether the variable you're thinking of is 
   \family typewriter 
   coefFriction
   \family default 
   , 
   \family typewriter 
   CoefFriction
   \family default 
   , 
   \family typewriter 
   COEF_FRICTION
   \family default 
   , or something else.
   \end_float 
   .
    It is a good idea to adopt a standard.
    If you are working with a group, you may wish to discuss it in your group
    and agree on a convention.
    
   \layout Standard
   
   If you 
   \series bold 
   Submit Changes
   \series default 
    and 
   \series bold 
   View
   \series default 
    the problem, you'll see nothing has changed.
    That's because in order for a variable to be useful, it must be used.
    The variable can be used in several places.
   \layout Subsubsection
   
   Variables in Scripts
   \layout Standard
   
   Variables can be used later in the same script.
    For instance, we can add another line below the 
   \family typewriter 
   $variable
   \family default 
    line as such:
   \layout LyX-Code
   
   $variable2 = $variable + 2;
   \layout Standard
   
   Now there's a variable called 
   \family typewriter 
   $variable2
   \family default 
    with the value 
   \begin_inset Quotes eld
   \end_inset 
   
   5
   \begin_inset Quotes erd
   \end_inset 
   
   .
    
   \layout Standard
   
   Variables can also be used in 
   \emph on 
   strings
   \emph default 
   
   \begin_inset LatexCommand \index{strings}
   
   \end_inset 
   
   , which are a sequence of letters.
    The underlying language of the script, Perl, has a very large number of
    ways of using variables in strings, but the easiest and most common way
    is to use normal double-quotes and just spell out the name of the variable
    you want to use in the string, like this:
   \layout LyX-Code
   
   $stringVar = 
   \begin_inset Quotes eld
   \end_inset 
   
   I have a variable with the value $variable.
   \begin_inset Quotes erd
   \end_inset 
   
   
   \layout Standard
   
   This will put the string 
   \begin_inset Quotes eld
   \end_inset 
   
   I have a variable with the value 3.
   \begin_inset Quotes erd
   \end_inset 
   
    into the variable named 
   \begin_inset Quotes eld
   \end_inset 
   
   stringVar
   \begin_inset Quotes erd
   \end_inset 
   
   .
   \layout Standard
   
   If you are following this chapter as a tutorial, add the previous two lines
    and save the problem.
    There's no need to view it; there's still no visible change.
   \layout Subsubsection
   
   Variables in the Text Block
   \layout Standard
   
   Once you've defined variables in the 
   \series bold 
   Script
   \series default 
   , you can use them in the 
   \series bold 
   Text Block
   \series default 
   .
    For example, using the previous three-line script we've created so far,
    you can place the following in the 
   \series bold 
   Text Block
   \series default 
   :
   \layout LyX-Code
   
   See the 3: $variable<br />
   \layout LyX-Code
   
   See the string: <b>$stringVar</b><br />
   \layout Standard
   
   \begin_float fig 
   \layout Standard
   \align center 
   
   \begin_inset Figure size 353 99
   file numericalResponseVarInText.eps
   flags 9
   
   \end_inset 
   
   
   \layout Caption
   
   Result of Variables in the Text Block
   \begin_inset LatexCommand \label{Result of Variables in the Text Block Figure}
   
   \end_inset 
   
   
   \end_float 
   If you save that and hit 
   \series bold 
   View
   \series default 
   , you should get what you see in figure 
   \begin_inset LatexCommand \ref{Result of Variables in the Text Block Figure}
   
   \end_inset 
   
   .
    Note how the 
   \begin_inset Quotes eld
   \end_inset 
   
   $variable
   \begin_inset Quotes erd
   \end_inset 
   
    was turned into a 3, and the 
   \begin_inset Quotes eld
   \end_inset 
   
   $stringVar
   \begin_inset Quotes erd
   \end_inset 
   
    was turned into 
   \begin_inset Quotes eld
   \end_inset 
   
   I have a variable with the value 3.
   \begin_inset Quotes erd
   \end_inset 
   
   
   \layout Subsubsection
   
   Variables in the Answer Block
   \layout Standard
   
   You can use variables in the 
   \series bold 
   Answer
   \series default 
    part of the question, too.
    This means you can compute an answer to a question, which we'll see in
    a bit.
    If you set the answer of the question to be 
   \begin_inset Quotes eld
   \end_inset 
   
   $variable
   \begin_inset Quotes erd
   \end_inset 
   
    (without the quotes), 
   \series bold 
   Save Changes
   \series default 
    and 
   \series bold 
   View
   \series default 
    it, you'll see that LON-CAPA is now expecting 
   \begin_inset Quotes eld
   \end_inset 
   
   3
   \begin_inset Quotes erd
   \end_inset 
   
    as the answer, plus or minus 5%.
   \layout Subsection
   
   Calling Functions
   \layout Standard
   
   Now you've seen how to use variables and stuff, see how to call functions.
   \layout Subsubsection
   
   Randomization
   \begin_inset LatexCommand \index{Randomization}
   
   \end_inset 
   
   
   \layout Standard
   
   One of the most importent functions for LON-CAPA is the RANDOM function.
   \layout Subsection
   
   Dynamic, Randomized Problems: Putting It All Together
   \layout Standard
   
   placeholder
   \layout Subsection
   
   For More Information
   \layout Standard
   
   It's always a good idea to look at other people's LON-CAPA problems, especially
    those from the same discipline as your problems, and see what they are
    doing.
    
   \series bold 
   Very often, the easiest way to create a new problem is to copy it and modify
    the copy until it does what you need.
   
   \series default 
    The more complicated a problem is, the more time you'll save by doing this.
    Also, you may find new ideas you can use and elaborate in your problems.
   \layout Comment
   
   Is there UI for this? Check.
   \layout Standard
   
   The full power of the Perl is well outside the scope of this document.
    Without going into the same level of detail as the previous examples, here's
    some ideas to stimulate your imagination:
   \layout Itemize
   
   Variable text.
    
   \layout Itemize
   
   Perl has several other data structures which might be of use.
    You may wish to do one of the many simple Perl tutorials on the Web.
    I recommend searching Google for 
   \begin_inset Quotes eld
   \end_inset 
   
   perl tutorial
   \begin_inset Quotes erd
   \end_inset 
   
   .
   \layout Section
   
   Formula Response
   \begin_inset LatexCommand \index{Formula Response}
   
   \end_inset 
   
   
   \begin_inset LatexCommand \label{Formula Response}
   
   \end_inset 
   
    Problems
   \layout Section
   
   Additional Problem Components
   \layout Standard
   
   Using the 
   \begin_inset Quotes eld
   \end_inset 
   
   Insert
   \begin_inset Quotes erd
   \end_inset 
   
    menu that appears in many of the problem editors, a wide variety of different
    things can be added to the problems.
   \layout Section
   
   Things That Need To Be Added
   \layout Subsection
   
   LON-CAPA and Units
   \layout Subsection
   
   Creating a default metadata file
   \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 4109  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.3


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