--- 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 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN"> <html><head> <title>500 Internal Server Error

Internal Server Error

The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator at root@localhost to inform them of the time this error occurred, and the actions you performed just before this error.

More information about this error may be available in the server error log.