--- doc/tutorial/Attic/tutorial.lyx 2002/05/29 16:44:43 1.1 +++ doc/tutorial/Attic/tutorial.lyx 2002/05/31 13:51:31 1.2 @@ -6,19 +6,19 @@ \end_preamble \language english \inputencoding auto -\fontscheme newcent +\fontscheme default \graphics default -\paperfontsize default +\paperfontsize 12 \spacing single \papersize Default \paperpackage a4 \use_geometry 1 \use_amsmath 0 \paperorientation portrait -\leftmargin 0.5in +\leftmargin 1in \topmargin 1.25in -\rightmargin 0.5in -\bottommargin 0.5in +\rightmargin 1in +\bottommargin 1in \secnumdepth 3 \tocdepth 3 \paragraph_separation indent @@ -37,7 +37,29 @@ Online \emph default Network with CAPA \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 \newline and the @@ -131,14 +153,6 @@ http://s10.lite.msu.edu/ . \begin_float fig -\layout Caption - - -\begin_inset LatexCommand \label{LON-CAPA Log in screen} - -\end_inset - -LON-CAPA Log in screen \layout Standard \align center @@ -150,6 +164,14 @@ flags 11 \end_inset +\layout Caption + + +\begin_inset LatexCommand \label{LON-CAPA Log in screen} + +\end_inset + +LON-CAPA Log in screen \end_float \layout Standard @@ -392,26 +414,30 @@ The Author Remote Control, show in figur may position it on the screen where you can make the best use of it. The Remote Control is a tool that allows you to switch between functions and roles within LON-CAPA. + \begin_float fig -\layout Caption +\layout Standard +\align center -Author Remote Control -\begin_inset LatexCommand \label{Author Remote Control Figure} +\begin_inset Figure size 177 420 +file authorRemote.eps +height 3 50 +flags 9 \end_inset -\layout Standard - +\layout Caption -\begin_inset Figure size 164 387 -file authorRemote.eps -flags 8 +Author Remote Control +\begin_inset LatexCommand \label{Author Remote Control Figure} \end_inset \end_float +\layout Comment + Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any* sort of sense on a first glance. Abbreviations are evil in this sort of application and should be used as @@ -607,6 +633,17 @@ Description of the Construction Space \layout Standard \begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 42 +file constructionSpace.eps +width 3 80 +flags 9 + +\end_inset + + \layout Caption Construction Space @@ -668,9 +705,7 @@ Publish this Resource \layout Standard -Publishes the current resource. - This presents a publishing window where you can provide information for - metadata, keywords, language, etc. +Opens the Resource Publishing window. \end_inset @@ -724,8 +759,7 @@ Browse \layout Standard -Opens a file/directory browser for your local computer. - Use this to select a file to upload. +Helps you select a file to upload \end_inset @@ -827,6 +861,11 @@ Type a name in the entry box to create a \layout Subsection How to Create New Content Pages +\begin_inset LatexCommand \label{Creating New Content Pages} + +\end_inset + + \layout Standard @@ -865,7 +904,8 @@ In Location bar of your browser, type in , for example, \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 . Press the Return or Enter key. @@ -873,16 +913,25 @@ http://www.s10.lite.msu.edu/priv/directo You should see something like the following message: \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 , 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 Type the content into the editor, -\series bold +\emph on OR -\series default +\emph default copy and paste HTML source code into the editor. \layout Enumerate @@ -898,9 +947,9 @@ Finally, click the Save this \series default button -\series bold +\emph on OR -\series default +\emph default click the \series bold Save and then attempt to clean HTML @@ -949,9 +998,9 @@ Finally, click the Save this \series default button -\series bold +\emph on OR -\series default +\emph default click the \series bold Save and then attempt to clean HTML @@ -973,6 +1022,24 @@ There are five types of problems that ca appropriate questions for your course. \layout Subsubsection +Foils +\layout Standard + +In the LON-CAPA system, a +\series bold +Foil +\begin_inset LatexCommand \index{Foil} + +\end_inset + + +\series default + is a choice in a Radio Response or Option Response problem. + For instance, True/False problems have two foils, one for True, and one + for False. + Foils do not need to be text; they can be images or other resources. +\layout Subsubsection + Radio Response \begin_inset LatexCommand \index{Radio Response} @@ -981,54 +1048,1722 @@ Radio Response Problems \layout Standard -Radio Response problems represent multiple choice questions. -\layout Standard -True/False problems present the student with one question that can be answered - true or false. +\series bold +Radio Response +\series default + problems represent multiple choice questions. + A True/False problem is a special case of Radio Response problem with two + foils, True or False. \layout Standard -Multiple choice problems are created almost identically to True/False problems. - Multiple choice problems contain 3-10 foils. - You may display 3-5 foils for each problem and the system randomly picks - the choices that are presented to the student. -\layout Standard +Multiple choice problems contain between 3 and 10 foils. + You may display from three to five foils for each problem and the system + randomly picks the choices that are presented to the student. +\layout Comment -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 Option Response problems present foils to the student with drop-down boxes. - Option response questions may be presented as a collection of True/False - type questions or as a matching type question. - The student must choose the correct answer for each part of the question. -\layout Standard + A group of foils is created for each concept group, and the system will + pick one to present to the student from each group. + The student must match each of his or her questions correctly to the possible + answers before receiving credit for the problem. + For more details, see the Create Option Response ( +\begin_inset LatexCommand \ref{Create Option Response Problem} + +\end_inset + +). +\layout Subsubsection String Response Problems \layout Standard -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 and entering chemical formulas. +\layout Comment + +Case sensitivity? \layout Standard +Note that it is easy to abuse String Response problems. + For instance, consider the question +\begin_inset Quotes eld +\end_inset + +Who wrote 'Huckleberry Finn'? +\begin_inset Quotes erd +\end_inset + + If you tell the system the answer is +\begin_inset Quotes eld +\end_inset + +Mark Twain +\begin_inset Quotes erd +\end_inset + +, and a student answers +\begin_inset Quotes eld +\end_inset + +Twain +\begin_inset Quotes erd +\end_inset + +, the system will mark it wrong. + If they answer +\begin_inset Quotes eld +\end_inset + +Samuel Clements +\begin_inset Quotes erd +\end_inset + +, then the student will definately get it wrong. + There is some room for flexibility in the string processing, but it can + be difficult to get it all right. + Before you use a String Response problem, be sure you can easily characterize + correct answers. +\layout Comment + +Check this stuff. +\layout Subsubsection + Numerical Response Problems \layout Standard -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. -\layout Standard +\layout Subsubsection Formula Response Problems \layout Standard Formula Response problems are questions in which the student types in a math formula for the answer. - If the answer is "x^2 - 11", the student can enter "x^2 - 11", "x*x - 11", - "x^2 + 21 - 10", etc. + If the answer is +\begin_inset Formula \( x^{2}-11 \) +\end_inset + +, the student can enter "x^2 - 11", "x*x - 11", "x^2 + 21 - 10", etc. Functions such as cos, sin, and exp are accepted as well as the operators (), +, -, *, and /. +\layout Subsection + +Creating Radio Response Problems +\layout Standard + +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 201 +file creatingNewProblemResource.eps +width 3 80 +flags 13 + +\end_inset + + +\layout Caption + +Creating A New Problem Resource +\begin_inset LatexCommand \label{Creating a new problem resource} + +\end_inset + + +\end_float +To create an Radio Response +\begin_inset LatexCommand \index{Radio Response} + +\end_inset + + problem, create a new resource as described in section +\begin_inset LatexCommand \ref{Creating New Content Pages} + +\end_inset + +. + This is a +\begin_inset Quotes eld +\end_inset + +problem +\begin_inset Quotes erd +\end_inset + + resource so the URL must end in +\begin_inset Quotes eld +\end_inset + +.problem +\begin_inset Quotes erd +\end_inset + +. + You should see a screen as in figure +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +. +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 283 +file radioResponse2.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +Radio Response Creation Form +\begin_inset LatexCommand \label{Radio Response Creation Form} + +\end_inset + + +\end_float + You will need to create the posible answers and the questions. +\layout Enumerate + +In the drop-down option box as seen in +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +, select +\series bold +Radio Response Problem +\series default +, and click the +\series bold +New Problem +\series default + button. +\layout Enumerate + +Click the +\series bold +Edit +\series default + button above the sample problem to enter edit mode. +\layout Enumerate + +In the +\series bold +Text Block +\series default + at the top of the problem, remove the sample text and type the question + for your problem. + For example, +\begin_inset Quotes eld +\end_inset + +What is two plus two? +\begin_inset Quotes erd +\end_inset + + +\layout Enumerate + +Locate the +\series bold +Response: One of N statements +\series default + element. + In the +\series bold +Max Number of Shown Foils +\series default + text box, place the number of wrong answers you wish to supply to each + student, in addition to the correct one. + For instance, if you want to display four choices, where one is correct + and three are incorrect, enter +\begin_inset Quotes eld +\end_inset + +3 +\begin_inset Quotes erd +\end_inset + + into this box. +\layout Enumerate + +Locate +\series bold +Foil 1 +\series default +. + Remove the text that is in the text box and put the +\emph on +correct answer +\emph default + for the problem in the +\series bold +Text Block +\series default +. + For example, +\begin_inset Quotes eld +\end_inset + +Four. +\begin_inset Quotes erd +\end_inset + + +\layout Enumerate + +Below it, you will see +\series bold +Foil 2 +\series default +. + Remove the text in the text box and put an +\emph on +incorrect answer +\emph default + for the problem. + For instance, +\begin_inset Quotes eld +\end_inset + +Purple. +\begin_inset Quotes erd +\end_inset + + +\layout Enumerate + +Repeat the previous step until you've filled in all of the other incorrect + answers you wish to offer the students. +\layout Enumerate + +Once you've filled in all the incorrect answers, change the +\series bold +Correct Option +\series default +s on the other foils to +\series bold +Unused +\series default +. +\layout Enumerate + +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 92 +file radioResponseHint.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +Hint Element +\begin_inset LatexCommand \label{Radio Response Hint Element Figure} + +\end_inset + + +\end_float +Scroll down to the Hint element, as shown in Figure +\begin_inset LatexCommand \ref{Radio Response Hint Element Figure} + +\end_inset + +. + Type some text that will help students when they answer incorrectly. +\layout Enumerate + +Click the +\series bold +Submit Changes +\series default + button located at the top of the frame. + If you do not do this, none of your changes will be saved. +\layout Standard + +The +\series bold +Correct Option +\series default + drop down box controls whether or not a given answer will be accepted as + a correct answer. + If it is set to +\series bold +true +\series default +, that answer will be considered a correct answer. + Any number of foils can be marked +\series bold +true +\series default +, so you can have questions with multiple correct answers. + If it is set to +\series bold +false +\series default +, it will be considered an incorrect answer. + If it is set to +\series bold +Unused +\series default +, the system will not use that foil. +\layout Paragraph + +Randomization +\begin_inset LatexCommand \index{Randomization} + +\end_inset + + +\layout Standard + +LON-CAPA will randomize what choices are presented to each student, and + randomize the order they are presented in. + If you wish to present each student the same choices, make sure the +\series bold +Maximum Number of Shown Foils +\series default + box contains the number of incorrect answers, which will force them to + all be displayed. + If you wish to force the system to display the foils in the order you have + created them in, type the HTML tag +\series bold + +\series default + into your problem text. + This can be useful with the ever-popular +\begin_inset Quotes eld +\end_inset + +All of the above +\begin_inset Quotes erd +\end_inset + + choice, which must be displayed in the correct place or its meaning will + change. +\layout Subsubsection + +True/False +\begin_inset LatexCommand \index{True/False Problem} + +\end_inset + + Problem +\layout Standard + +A True/False problem is a Radio Response problem with two choices, True + and False. + set the +\series bold +Maximum Number of Shown Foils +\series default + to +\begin_inset Quotes eld +\end_inset + +1 +\begin_inset Quotes erd +\end_inset + +, and mark the correct answer +\series bold +true +\series default +. + For example, for the True/False question +\begin_inset Quotes eld +\end_inset + +Napolean conquered Japan in the year 189 A.D. +\begin_inset Quotes erd +\end_inset + +, mark the foil containing the answer +\begin_inset Quotes eld +\end_inset + +False +\begin_inset Quotes erd +\end_inset + + as +\series bold +true +\series default +, because it is the correct answer. +\layout Subsection + +Option Response +\begin_inset LatexCommand \index{Option Response} + +\end_inset + + +\begin_inset LatexCommand \label{Create Option Response Problem} + +\end_inset + + Problems +\layout Standard + +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 280 +file optionResponseProblem.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +Option Response Problem +\begin_inset LatexCommand \label{Option Response Problem Figure} + +\end_inset + + +\end_float +Each Option Response problem has three parts: +\layout Enumerate + +The Concept Groups +\begin_inset LatexCommand \index{Concept Groups} + +\end_inset + + +\layout Enumerate + +The options for the students to select, by default +\begin_inset Quotes eld +\end_inset + +True +\begin_inset Quotes erd +\end_inset + + and +\begin_inset Quotes eld +\end_inset + +False +\begin_inset Quotes erd +\end_inset + + +\layout Enumerate + +The hint for the student +\layout Standard + +Each +\series bold +Concept Group +\series default + has some number of foils representing questions which are conceptually + related. + Option Response Problems can have between 4 and 8 Concept Groups in a problem. + When the Option Response problem is presented to a student, the LON-CAPA + system will randomly select one foil from each Concept Group and present + it to the student. + In order to receive credit for the problem, the student must answer all + of the Concept Group foils correctly. +\layout Subsubsection + +Example: Concept Group +\layout Standard + +For example, a Concept Group may contain the following True/False questions: +\layout Itemize + + +\begin_inset Quotes eld +\end_inset + +Mark Twain +\begin_inset Quotes erd +\end_inset + + is the pen name of Samuel Clemens. +\layout Itemize + +Mark Twain wrote +\begin_inset Quotes eld +\end_inset + +The Call of the Wild +\begin_inset Quotes erd +\end_inset + +. +\layout Itemize + +Mark Twain wrote +\begin_inset Quotes eld +\end_inset + +Huckleberry Finn +\begin_inset Quotes erd +\end_inset + +. +\layout Itemize + +Mark Twain spent most of his life in the Congo. +\layout Standard + +For each foil, the author marks it True or False. + When the student logs on and attempts to answer this question, the student + will see only one of the four choices for that concept group. + They then go on to do the remaining three to seven Concept Groups in this + question before submitting their answer. +\layout Subsubsection + +Example: Matching Problem +\layout Standard + +You might want to ask the student to match musical compositions with their + composers. + You could create an Option Response problem with 4 Concept Groups, and + place the following four things each in one concept group: +\layout Itemize + +Claire de Lune +\begin_float footnote +\layout Standard + +Debussy. +\end_float +\layout Itemize + +The Pastoral Symphony +\begin_float footnote +\layout Standard + +Beethoven's Sixth Symphony. +\end_float +\layout Itemize + +Sleeping Beauty Suite +\begin_float footnote +\layout Standard + +Tchaikovsky. +\end_float +\layout Itemize + +The Dance of the Sugar Plum Fairies +\begin_float footnote +\layout Standard + +Also Tchaikovsky, from The Nutcracker. +\end_float +\layout Standard + +You could then add the following options to the option list: +\layout Itemize + +Debussy +\layout Itemize + +Beethoven +\layout Itemize + +Schubert +\layout Itemize + +Tchaikovsky +\layout Itemize + +Bach +\layout Standard + +The same answers can be used more then once, or not at all, as you see fit. + It is conventional to place such a warning in the +\series bold +Text Block +\series default + describing the problem to the students. +\layout Subsubsection + +Creating Option Response Problems +\layout Standard + +To create an Option Response problem, create a new resource as described + in section +\begin_inset LatexCommand \ref{Creating New Content Pages} + +\end_inset + +. + This is a +\begin_inset Quotes eld +\end_inset + +problem +\begin_inset Quotes erd +\end_inset + + resource so the URL must end in +\begin_inset Quotes eld +\end_inset + +.problem +\begin_inset Quotes erd +\end_inset + +. + You should see a screen as in figure +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +. +\layout Enumerate + +In the drop-down option box as seen in +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +, select +\series bold +Option Response Problem with +\emph on +N +\emph default + Concept Groups +\series default +, where +\series bold +\emph on +N +\series default +\emph default + is the number of Concept Groups you wish the problem to have, and click + the +\series bold +New Problem +\series default + button. +\layout Enumerate + +Click the +\series bold +Edit +\series default + button above the sample problem to enter edit mode. +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 276 +file optionResponseEditing.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +Option Response Editor +\begin_inset LatexCommand \label{Option Response Editor Figure} + +\end_inset + + +\end_float + You should see the Option Response page open up, which should look something + like what you see in figure +\begin_inset LatexCommand \ref{Option Response Editor Figure} + +\end_inset + +. +\layout Enumerate + +Replace the text in the +\series bold +Text Block +\series default + with text that explains the conditions for your problem. +\layout Enumerate + +Locate the +\series bold +Max Number of Shown Foils +\series default + element and type a number from 1 to 8 to display that number of questions. + You cannot display more then one foil from each concept group, so this + option will only reduce the number of foils displayed, if it is less then + the number of concept groups in your Option Response problem. +\layout Enumerate + +Now you must define the options the students can select. + For each option you wish to add to the Option Response question, type the + option into the +\series bold +Add new Option +\series default + box in the +\series bold +Select Options +\series default + section, then hit the +\series bold +Save Changes +\series default + button. + If you do not hit the +\series bold +Save Changes +\series default + button, your option will not be selectable below. +\layout Enumerate + +To delete the irrelevant options from the Option Response question, select + that option from the +\series bold +Delete Option +\series default + dropdown, and hit the Save Changes button. + Do that for each option you wish to remove. +\layout Enumerate + +Now, you need to define the question foils. + Look for the foil with the name +\begin_inset Quotes eld +\end_inset + +One +\begin_inset Quotes erd +\end_inset + +. + Type the question into the text box, and select the correct option for + that question from the +\series bold +Correct Option +\series default + drop-down menu. + Click +\series bold +Submit Changes +\series default + to save this question foil. + Repeat this step for all remaining foils. +\layout Enumerate + +Locate the foils that are not being used. + In their +\series bold +Delete +\series default + menus, set the value to +\series bold +Yes +\series default +. + Once you've set the Delete menu value correctly for all the foils, click + the +\series bold +Save Changes +\series default + button. +\layout Enumerate + +In the Hint area, provide a helpful hint for users who get the problem incorrect +, and click the +\series bold +Save Changes +\series default + button. +\layout Subsection + +Creating a String Response Problem +\layout Standard + +To create an String Response problem, create a new resource as described + in section +\begin_inset LatexCommand \ref{Creating New Content Pages} + +\end_inset + +. + This is a +\begin_inset Quotes eld +\end_inset + +problem +\begin_inset Quotes erd +\end_inset + + resource so the URL must end in +\begin_inset Quotes eld +\end_inset + +.problem +\begin_inset Quotes erd +\end_inset + +. + You should see a screen as in figure +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +. +\layout Enumerate + +In the drop-down option box as seen in +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +, select +\series bold +Simple String Response Problem +\series default +, and click the +\series bold +New Problem +\series default + button. +\layout Enumerate + +Click the +\series bold +Edit +\series default + button above the sample problem to enter edit mode. +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 320 +file stringResponseEditor.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +String Response Editor +\begin_inset LatexCommand \label{String Response Editor Figure} + +\end_inset + + +\end_float + You should see the String Response editor page open up, which should look + something like what you see in figure +\begin_inset LatexCommand \ref{String Response Editor Figure} + +\end_inset + +. +\layout Enumerate + +Clear the text from the Text Block at the top of the problem, and type in + your problem's question. +\layout Enumerate + +In the +\series bold +Answer Box +\series default +, type the correct answer. +\layout Enumerate + +Select the answer condition from the drop down box. + There are three cases to choose from: +\begin_deeper +\layout Enumerate + + +\series bold +cs +\series default +: This means +\begin_inset Quotes eld +\end_inset + +Case Sensitive +\begin_inset Quotes erd +\end_inset + +. + For example, this is useful in Chemistry, where HO and Ho are completely + different answers +\begin_float footnote +\end_deeper +\layout Standard + + +\series bold +HO +\series default + is hydrogen monoxide, a colorless, odorless, poisonous gas. + +\series bold +Ho +\series default + is the element 67, Holmium, in the Lanthanides. +\end_float +. + The student must match the case of the answer. +\begin_deeper +\layout Enumerate + + +\series bold +ci +\series default +: This means +\begin_inset Quotes eld +\end_inset + +Case Insenstive +\begin_inset Quotes erd +\end_inset + +. + The system does not use the case of the letters to determine the correctness + of the answer. + If the correct answer is +\begin_inset Quotes eld +\end_inset + +car +\begin_inset Quotes erd +\end_inset + +, the system will accept +\begin_inset Quotes eld +\end_inset + +car +\begin_inset Quotes erd +\end_inset + +, +\begin_inset Quotes eld +\end_inset + +CAR +\begin_inset Quotes erd +\end_inset + +, +\begin_inset Quotes eld +\end_inset + +Car +\begin_inset Quotes erd +\end_inset + +, +\begin_inset Quotes eld +\end_inset + +caR +\begin_inset Quotes erd +\end_inset + +, etc. +\layout Enumerate + + +\series bold +mc +\series default +: This means +\begin_inset Quotes eld +\end_inset + +Multiple Choice +\begin_inset Quotes erd +\end_inset + +. + The student's answers must contain the same letters as the question author's, + but order is unimportent. + This is usually used to give a multiple choice question in the question's + +\series bold +Text Block +\series default +, which may have several correct parts. + If the author sets the correct answer as +\begin_inset Quotes eld +\end_inset + +bcg +\begin_inset Quotes erd +\end_inset + +, the system will accept +\begin_inset Quotes eld +\end_inset + +bcg +\begin_inset Quotes erd +\end_inset + +, +\begin_inset Quotes eld +\end_inset + +cbg +\begin_inset Quotes erd +\end_inset + +, +\begin_inset Quotes eld +\end_inset + +gcb +\begin_inset Quotes erd +\end_inset + +, etc., but not +\begin_inset Quotes eld +\end_inset + +bc +\begin_inset Quotes erd +\end_inset + + or +\begin_inset Quotes eld +\end_inset + +abcg +\begin_inset Quotes erd +\end_inset + +. +\layout Standard + +It is conventional to tell the students whether the question is case sensitive + or not. +\end_deeper +\layout Enumerate + +Optionally, locate the +\series bold +Single Line Text Entry Area +\series default + block and set a length in the Size box. + This will only affect the size of the box on the screen; if you set the + box size to 2, the student can still enter 3 or more letters in their answer. +\begin_deeper +\layout Comment + +This seems like a great feature to either eliminate, or make useful. + Allowing the teacher to limit it to 3, and then not letting the student + type more then 3 chars might be a way of giving the student a hint. + Probably not worth it, as the problem text can always just say +\begin_inset Quotes eld +\end_inset + +Pick two of the following +\begin_inset Quotes erd +\end_inset + +. + This is probably not a useful feature. +\end_deeper +\layout Enumerate + +Scroll down to the Hint element, and type some text that will help students + when they answer incorrectly. +\layout Enumerate + +Click the Submit Changes button. +\layout Subsection + +Creating Numerical Response +\begin_inset LatexCommand \index{Numerical Response} + +\end_inset + + +\begin_inset LatexCommand \label{Numerical Response} + +\end_inset + + Problems +\layout Standard + +Numerical Response problems are answered by entering a number and an optional + unit. + For instance, a numerical response problem might have an answer of +\begin_inset Formula \( 2m/s^{2} \) +\end_inset + +. +\layout Standard + +To create an Numerical Response problem, create a new resource as described + in section +\begin_inset LatexCommand \ref{Creating New Content Pages} + +\end_inset + +. + This is a +\begin_inset Quotes eld +\end_inset + +problem +\begin_inset Quotes erd +\end_inset + + resource so the URL must end in +\begin_inset Quotes eld +\end_inset + +.problem +\begin_inset Quotes erd +\end_inset + +. + You should see a screen as in figure +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +. +\layout Enumerate + +In the drop-down option box as seen in +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +, select +\series bold +Simple Numerical Response Problem +\series default +, and click the +\series bold +New Problem +\series default + button. +\layout Enumerate + +Click the +\series bold +Edit +\series default + button above the sample problem to enter edit mode. +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 302 +file numericalResponseEditor.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +Numerical Response Editor +\begin_inset LatexCommand \label{Numerical Response Editor Figure} + +\end_inset + + +\end_float + You should see the String Response editor page open up, which should look + something like what you see in figure +\begin_inset LatexCommand \ref{Numerical Response Editor Figure} + +\end_inset + +. +\layout Enumerate + +Please refer to the CAPA manual for help with Numerical Response Problems. +\layout Comment + +Copout. + I need this info. +\layout Subsection + +Creating Formula Response +\begin_inset LatexCommand \index{Formula Response} + +\end_inset + + +\begin_inset LatexCommand \label{Formula Response} + +\end_inset + + Problems +\layout Standard + +Formula Response problems are answered by entering a mathematical formula. + For instance, a numerical response problem might have an answer of +\begin_inset Formula \( x^{2}+11 \) +\end_inset + +. + The answer may be in any equivalent format. + For instance, for +\begin_inset Formula \( x^{2}+11 \) +\end_inset + +, the system will accept +\begin_inset Formula \( x*x-11 \) +\end_inset + + or +\begin_inset Formula \( x^{2}+21-10 \) +\end_inset + + as well. +\layout Standard + +To create an Formula Response problem, create a new resource as described + in section +\begin_inset LatexCommand \ref{Creating New Content Pages} + +\end_inset + +. + This is a +\begin_inset Quotes eld +\end_inset + +problem +\begin_inset Quotes erd +\end_inset + + resource so the URL must end in +\begin_inset Quotes eld +\end_inset + +.problem +\begin_inset Quotes erd +\end_inset + +. + You should see a screen as in figure +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +. +\layout Enumerate + +In the drop-down option box as seen in +\begin_inset LatexCommand \ref{Creating a new problem resource} + +\end_inset + +, select +\series bold +Simple Formula Problem +\series default +, and click the +\series bold +New Problem +\series default + button. +\layout Enumerate + +Click the +\series bold +Edit +\series default + button above the sample problem to enter edit mode. +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 302 +file numericalResponseEditor.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +Numerical Response Editor +\begin_inset LatexCommand \label{Numerical Response Editor Figure} + +\end_inset + + +\end_float + You should see the Formula Response editor page open up, which should look + something like what you see in figure +\begin_inset LatexCommand \ref{Numerical Response Editor Figure} + +\end_inset + +. +\layout Enumerate + +Please refer to the CAPA manual for help with Numerical Response Problems. +\layout Comment + +Copout. + I need this info. +\layout Section + +Publishing Your Course +\layout Standard + +In order to make the content you've created available for courses to use, + you must publish your content. + LON-CAPA provides an easy interface for publishing your content pages, + problem resources, and sequences. + A common interface allows you to specify title, author information, keywords, + and other metadata. + LON-CAPA uses this metadata for many things, and it's importent to fill + the metadata out as accurately as possible. +\layout Subsection + +What is Metadata? +\begin_inset LatexCommand \index{Metadata} + +\end_inset + + +\begin_inset LatexCommand \label{What Is Metadata?} + +\end_inset + + +\layout Standard + + +\emph on +Metadata +\emph default + is +\emph on +data about data +\emph default +. + Metadata can often be thought of as a label on some bit of information + that can be useful to people or computer programs trying to use the data. + Without metadata, the person or computer trying to use the original information + would have to just guess what the original data is about. + For instance, if you create a problem and neglect to say in the title or + subject of the problem what it is about, then a human who wants to use + that problem would have to read the problem itself to see what it was about, + which is much more difficult then just reading a title. + A computer trying to do the same thing would just be out of luck; it is + too stupid to understand the problem statement at all. +\layout Standard + +One example of metadata you use all the time is the of a webpage, + which usually shows up in the title bar of the browser. + That's information about the webpage itself, not actually part of the web + page. + People use it when they bookmark a page, so they know what the page is. + Search engines use it as a clue about the content of the web page. +\layout Subsection + +Publishing A Resource +\begin_inset LatexCommand \index{Resource, Publishing} + +\end_inset + + +\begin_inset LatexCommand \index{Publishing Resource} + +\end_inset + + +\layout Standard + +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 168 +file constructionSpaceForPublishing.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +Construction Space for Publishing +\begin_inset LatexCommand \label{Construction Space for Publishing Figure} + +\end_inset + + +\end_float +To publish a resource, log in and choose your role to be an Author. + Then click +\series bold +CSTR +\series default + to go to your construction space. + You should see something like figure +\begin_inset LatexCommand \ref{Construction Space for Publishing Figure} + +\end_inset + +. + Click on the +\series bold +Publish +\series default + button for the resource you wish to publish. +\begin_float fig +\layout Standard +\align center + +\begin_inset Figure size 476 338 +file publishMetadata.eps +width 3 80 +flags 9 + +\end_inset + + +\layout Caption + +Publishing Metadata Screen +\begin_inset LatexCommand \label{Publishing Metadata Screen Figure} + +\end_inset + + +\end_float + You'll get a metadata screen that should look something like figure +\begin_inset LatexCommand \ref{Publishing Metadata Screen Figure} + +\end_inset + +. + Fill out the form. + If you are creating resources that may be used in several courses, you + should talk with the other authors and establish some sort of standard + title and subject scheme in advance. + +\layout Standard + +The language is the language the problem is written in. + The Publisher/Owner is the person who owns the problem; it should be the + email address where anybody with questions about the resource can contact + someone who can help them. + In smaller environments, this is likely to be the author. + In larger environments, it may be a coordinator or manager. +\layout Standard + +The +\series bold +Keywords +\series default + and the +\series bold +Abstract +\series default + are more information about the problem. + The +\series bold +Keywords +\series default + are words that are strongly connected to your problem; for instance a physics + problem about a pulley might include +\begin_inset Quotes eld +\end_inset + +pulley +\begin_inset Quotes erd +\end_inset + + as a key word. + LON-CAPA pulls out likely-looking keywords for you so you can just click + on them to make them keywords. + +\series bold +Additional keywords +\series default + allows you to add any keyword to your problem that are not actually in + the problem. + For instance, on that same problem a physicist might add the keyword +\begin_inset Quotes eld +\end_inset + +statics +\begin_inset Quotes erd +\end_inset + +, even though it doesn't appear in the original problem, because Physics + uses that as a classification of problem type. + +\layout Standard + +Finally, you need to set the copyright and distribution notice. + This setting controls who is allowed to use your resource. + +\layout Itemize + + +\series bold +Limited to courses in the domain published +\series default + means that only courses running in the same domain as you can use your + content. + Talk to your LON-CAPA administrator if you want more information about + your domain. +\layout Itemize + + +\series bold +Free +\series default + means that anyone can find and use the resource. +\layout Itemize + + +\series bold +Private - visible to author only +\series default + means that it can't be used for any course. +\layout Itemize + + +\series bold +Public - no authentication required +\series default + means anyone can find and use the resource. +\layout Standard + +Now when you click +\series bold +Finalize Publication +\series default +, your resource will be published and usable (unless you set the distribution + to +\begin_inset Quotes eld +\end_inset + +private +\begin_inset Quotes erd +\end_inset + +). +\layout Section + +Things That Need To Be Added +\layout Subsection + +LON-CAPA and Units +\layout Subsection + +Creating a default metadata file +\layout Subsection + +Detailed number problem info +\layout Subsection + +Detailed formula problem info +\layout Subsection + +My questions\SpecialChar \ldots{} + +\layout Itemize + +How do I do the things above? +\layout Itemize + +Is there any pre-existing documentation for number or formula problems? +\layout Itemize + +Is there any pre-existing documentation for maps et al? I seem to have exhausted + the documentation. +\layout Itemize + +What is the LON-CAPA default resource? If it's free, can just anyone +\begin_inset Quotes eld +\end_inset + +find and use it +\begin_inset Quotes erd +\end_inset + +, or just +\begin_inset Quotes eld +\end_inset + +use it if they already know where it is +\begin_inset Quotes erd +\end_inset + +? (In other words, how powerful is the search feature?) What's the difference + between free and public? \layout Section Appendix A: Student Interface @@ -1097,4 +2832,12 @@ ANOT (ANOTATE) LOGOUT (LOGOUT) \series default will log you out of the LON-CAPA system. +\layout Standard + + +\begin_inset LatexCommand \printindex{} + +\end_inset + + \the_end