--- doc/tutorial/Attic/tutorial.lyx 2002/06/04 21:07:28 1.5 +++ doc/tutorial/Attic/tutorial.lyx 2002/07/05 16:12:31 1.8 @@ -1,5 +1,5 @@ -#LyX 1.1 created this file. For more info see http://www.lyx.org/ -\lyxformat 218 +#LyX 1.2 created this file. For more info see http://www.lyx.org/ +\lyxformat 220 \textclass article \begin_preamble \usepackage{floatflt} @@ -14,6 +14,8 @@ \paperpackage a4 \use_geometry 1 \use_amsmath 0 +\use_natbib 0 +\use_numerical_citations 0 \paperorientation portrait \leftmargin 1in \topmargin 1.25in @@ -51,18 +53,7 @@ Author's Tutorial And Manual \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. +John Williamson, Felicia Berryman, Jeremy Bowers \layout Standard \SpecialChar ~ @@ -111,8 +102,8 @@ IMHO LON-CAPA is a web-based interface that helps to organize and present your course website, deliver and manage problems, and manage student enrollment. - All author functions are done using a web browser (Netscape 4.x or higher, - a recent Mozilla, or IE 5+ required) and the LON-CAPA Author Interface. + All author functions are done through a web browser (Netscape 4.x or higher, + a recent Mozilla, or IE 5+ required). \layout Standard At this time, you should have: @@ -122,7 +113,8 @@ developed your objectives for your cours \layout Itemize -developed your problems for testing and identified the question formats. +developed your problems for input into LON-CAPA and determined the appropriate + question formats. \layout Subsection About This Manual @@ -157,13 +149,11 @@ Much of this document can be used as a t with no previous LON-CAPA experience. \layout Standard -For more information, see the website at +For additional help, visit our FAQ at \family typewriter http://help.loncapa.org/ \family default -, where you can get help. - If you cannot find an answer for your question, please email us and let - us know, so we can put the solution to your problem online for everyone. +. \layout Section The LON-CAPA Author Interface @@ -191,15 +181,23 @@ To begin using LON-CAPA, you first need . -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 297 234 -file login.eps -width 3 50 -flags 11 - +\begin_inset Graphics FormatVersion 1 + filename login.eps + display color + size_type 1 + width 50page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 297pt + lyxheight 234pt \end_inset @@ -211,7 +209,9 @@ flags 11 \end_inset LON-CAPA Log in screen -\end_float +\end_inset + + \layout Standard Fill in the Username and Password boxes with your information. @@ -230,171 +230,6 @@ or. \end_inset Author Remote Control -\layout Comment - -Comment on the remote controls: I'll only mention this once, but imagine - this comment exists everywhere a remote control image is used. - The whole -\begin_inset Quotes eld -\end_inset - -remote control -\begin_inset Quotes erd -\end_inset - - metaphor is fundamentally flawed and probably can't be salvaged. - Why is it flawed? -\layout Comment - -\SpecialChar ~ - -\layout Comment - -1. - The remote control invokes a metaphor, that of remote controls. - However, remote controls are useful in the real world, despite the overwhelming - complexity of modern remotes, for three major reasons: One, they never, - ever, ever change. - Two, they provide immense amounts of tactile feedback, allowing one to - overcome the complexity of using one by putting the knowledge into motor - memory. - (There are equivalent usability principles in usability, as well; look - up Fitt's Law, for instance.) Three, they all basically do the same thing; - pick up an unfamiliar TV control and you at least know in advance there - will be numbers for channel changing, vol up and down, chan up and down, - mute, etc. - The remotes used in this system do not have any of these properties. - Remotes are actually horrid UI, because they are very, very difficult to - learn; they make up for it by being useful and persistent. -\layout Comment - -Further, remotes should *do* things. - This remote is like a remote that no matter what button you push, it invokes - a menu. - Most remotes have -\series bold -one -\series default - explicit -\begin_inset Quotes eld -\end_inset - -menu -\begin_inset Quotes erd -\end_inset - - button to invoke a menu that has all the feature that aren't worth valuable - remote control space. -\layout Comment - -In fact, the metaphor is so unsuccessful that any moderately savvy Internet - user will almost immediately come to conceptualize the remote as just another - list of links, albeit a clumsy and inconvenient one. - Why not give them that in the first place? -\layout Comment - -\SpecialChar ~ - -\layout Comment - -2. - Even the simplest -\begin_inset Quotes eld -\end_inset - -remote -\begin_inset Quotes erd -\end_inset - - I see in the tutorial has eight buttons, which nearly immediately becomes - seventeen (!) buttons, all incomprehensible, and I didn't get a chance - to count during the interview, but I saw a remote flash by (student remote? - admin remote? that wouldn't matter as much) that had at least twenty, probably - 24 buttons, again, all or nearly all incomprehensible. - This is needlessly intimidating. -\layout Comment - -\SpecialChar ~ - -\layout Comment - -3. - By committing to this -\begin_inset Quotes eld -\end_inset - -remote control -\begin_inset Quotes erd -\end_inset - - layout, you commit to a remote control's layout limitations, except that - an actual remote control can get away with a 6pt or smaller font, or weird - specialized symbols, or whatnot. - I'm looking at a (real) remote control right now that manages to get -\begin_inset Quotes eld -\end_inset - -channel return -\begin_inset Quotes erd -\end_inset - - onto one button. - That whole phrase fits *twice* into the space the -\begin_inset Quotes eld -\end_inset - -ROLES -\begin_inset Quotes erd -\end_inset - - button takes up on my printout! So in actuality, you're committing to something - no sane remote control designer could deal with. -\layout Comment - -\SpecialChar ~ - -\layout Comment - -4. - Requiring the user to mouse over something to see what it does is not a - solution. - Limiting yourself to an 8 by 2 array of characters to explain yourself - compounds the problem even more. - (Another over-literal extension of the remote control metaphor.) Also, as - you may have observed, the accessibility of this is nil. - -\layout Comment - -\SpecialChar ~ - -\layout Comment - -The upshot is that the only upside to the remote control is a moderately - pleasing graphic; the downsides are pretty much everything, up to and including - possible illegality under accessibility laws. - Unfortunately, I do not see any way to salvage any aspect of the remote - control; it's going to suck until it's replaced. - Pleasing graphics are relatively easy to come by nowadays; it should not - drive the design. - I'll admit (freely!) I'm not a graphics designer... - graphics designers aren't web developers (designers), either. -\layout Comment - -\SpecialChar ~ - -\layout Comment - -We're data-mining the web logs to see what people actually use. - This is good. - We may need to do some really simple stuff before he finishes. - Raw statistics on what buttons are pressed most often can probably be interpret -ed easily enough for our purposes. - No matter what the final design is, it should emphasize the two or three - commands used day in and day out, as determined by empirical analysis, - and shuffle the other commands onto another sub menu or sub menus. - Then, use the additional space you'll have (even if you keep the same size - window) and actually *spell out* the options. - \layout Standard The Author Remote Control, show in figure @@ -404,20 +239,28 @@ The Author Remote Control, show in figur , will automatically load whenever you log in to LON-CAPA as the course instructor. - The Author Remote Control is a separate window in your browser, so you - may position it on the screen where you can make the best use of it. + The Author Remote Control is a separate window in your browser, and is + automatically sized and placed in the upper left of the screen. The Remote Control is a tool that allows you to switch between functions and roles within LON-CAPA. -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 177 420 -file authorRemote.eps -height 3 50 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename authorRemote.eps + display color + size_type 1 + height 50page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 180pt + lyxheight 420pt \end_inset @@ -429,13 +272,9 @@ Author Remote Control \end_inset -\end_float -\layout Comment +\end_inset + -Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any* - sort of sense on a first glance. - Abbreviations are evil in this sort of application and should be used as - a truly last resort. \layout Standard When you move your mouse over the buttons in the remote, the sixteen gray @@ -479,22 +318,22 @@ RES (RESOURCE SPACE) \series bold -EGRD (ENTER GRADES) +SRC (SEARCH LIBRARY) \series default - is used to enter grades for students enrolled in your course. + brings up a screen that lets you search the LON-CAPA resources using multiple + criteria. \layout Itemize \series bold -SRC (SEARCH LIBRARY) +PREF (PREFERENCES) \series default - brings up a screen that lets you search the LON-CAPA resources using multiple - criteria. + brings up a screen that allows you to change some preferences. \layout Itemize \series bold -LOGOUT (LOGOUT) +EXIT (LOGOUT) \series default will log you out of the LON-CAPA system. \layout Section @@ -555,26 +394,26 @@ Problem A \series bold -Map +Sequence \series default -\begin_inset LatexCommand \index{Map} +\begin_inset LatexCommand \index{Sequence} \end_inset - resource of the + is a type of \series bold -Sequence -\begin_inset LatexCommand \index{Sequence} +Map +\series default -\end_inset +\begin_inset LatexCommand \index{Map} +\end_inset -\series default - type represents a programmed series of events. + which is used to link other resources together. The users of this resource can use directional buttons on their remote or the NAV button to follow the sequence. - These resources are stored in files that must use the extension + Sequences are stored in files that must use the extension \begin_inset Quotes eld \end_inset @@ -583,27 +422,28 @@ Sequence \end_inset . + Sequences can contain other sequences and pages. \layout Itemize A \series bold -Map +Page \series default -\begin_inset LatexCommand \index{Map} +\begin_inset LatexCommand \index{Page} \end_inset - resource of the + is a type of \series bold -Page -\series default - -\begin_inset LatexCommand \index{Page} +Map +\begin_inset LatexCommand \index{Map} \end_inset - type display multiple resources together. + +\series default + which is used to join other resources together into one HTML page. For example, a page of problems will appears as a problem set. These resources are stored in files that must use the extension \begin_inset Quotes eld @@ -619,15 +459,24 @@ Page Description of the Construction Space \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 42 -file constructionSpace.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename constructionSpace.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 42pt \end_inset @@ -646,12 +495,12 @@ Contents of the Construction Space: \begin_inset Tabular - - - - - - + + + + + + \begin_inset Text \layout Standard @@ -661,7 +510,7 @@ Contents of the Construction Space: Button Name \end_inset - + \begin_inset Text \layout Standard @@ -672,8 +521,8 @@ Description \end_inset - - + + \begin_inset Text \layout Standard @@ -681,7 +530,7 @@ Description Publish this Resource \end_inset - + \begin_inset Text \layout Standard @@ -690,8 +539,8 @@ Opens the Resource Publishing window. \end_inset - - + + \begin_inset Text \layout Standard @@ -699,7 +548,7 @@ Opens the Resource Publishing window. List Directory \end_inset - + \begin_inset Text \layout Standard @@ -708,8 +557,8 @@ Lists the contents of the current workin \end_inset - - + + \begin_inset Text \layout Standard @@ -717,7 +566,7 @@ Lists the contents of the current workin Copy \end_inset - + \begin_inset Text \layout Standard @@ -726,8 +575,8 @@ Type a new name in the entry box to make \end_inset - - + + \begin_inset Text \layout Standard @@ -735,7 +584,7 @@ Type a new name in the entry box to make Browse \end_inset - + \begin_inset Text \layout Standard @@ -744,8 +593,8 @@ Helps you select a file to upload \end_inset - - + + \begin_inset Text \layout Standard @@ -753,7 +602,7 @@ Helps you select a file to upload Upload File \end_inset - + \begin_inset Text \layout Standard @@ -762,8 +611,8 @@ Uploads the selected file to your Constr \end_inset - - + + \begin_inset Text \layout Standard @@ -771,7 +620,7 @@ Uploads the selected file to your Constr Retrieve Old Version \end_inset - + \begin_inset Text \layout Standard @@ -780,8 +629,8 @@ Load an older version of a resource if y \end_inset - - + + \begin_inset Text \layout Standard @@ -789,7 +638,7 @@ Load an older version of a resource if y Delete \end_inset - + \begin_inset Text \layout Standard @@ -798,8 +647,8 @@ Deletes the current resource \end_inset - - + + \begin_inset Text \layout Standard @@ -807,7 +656,7 @@ Deletes the current resource Rename \end_inset - + \begin_inset Text \layout Standard @@ -816,8 +665,8 @@ Type a new name in the associated entry \end_inset - - + + \begin_inset Text \layout Standard @@ -825,7 +674,7 @@ Type a new name in the associated entry New Subdirectory \end_inset - + \begin_inset Text \layout Standard @@ -839,7 +688,8 @@ Type a name in the entry box to create a \end_inset -\end_float +\end_inset + The Construction Space, as seen in figure \begin_inset LatexCommand \ref{Construction Space Figure} @@ -862,7 +712,23 @@ How to Create New Content Pages Content Pages \series default are HTML documents that display the course information you are presenting. - To create new Content Pages, do the following: + +\layout Standard + +Many users use tools such as Dreamweaver to create web pages. + To upload HTML files generated with such tools, you can use the +\series bold +Browse +\series default + button in the Construction Space, locate your HTML file, and use the +\series bold +Upload File +\series default + button to create a content page in LON-CAPA. + Remember to upload any graphics your generated web pages may have included. +\layout Standard + +To create new Content Pages, do the following: \layout Enumerate Click the @@ -870,10 +736,11 @@ Click the CSTR \series default button on the LON-CAPA remote. - You web page will change to your Construction Space. + Your web page will change to your Construction Space. \layout Enumerate -In Location bar of your browser, type in full URL of the new Content Page. +In the Location bar of your browser, type in the full URL of the new Content + Page. Make sure the last part of the URL ends with \begin_inset Quotes eld \end_inset @@ -883,22 +750,14 @@ In Location bar of your browser, type in \end_inset , for example, +\newline + \emph on -http://www.s10.lite.msu.edu/priv/\SpecialChar \- -directory/new_resource.html +http://www.s10.lite.msu.edu/priv/username/new_resource.html \emph default -. - Press the Return or Enter key. -\layout Enumerate - -You should see something like the following message: File not found: /home/wmson -j/priv/\SpecialChar \- -directory/new_resource.html, and an Edit button. - Click the -\series bold -Edit -\series default - button, and an HTML editor will open with a simple page template. + . +\newline +Press the Return or Enter key. \layout Enumerate Type the content into the editor, @@ -937,12 +796,33 @@ Repeat this process as many times as nec If you're following this as a tutorial, create at least one content page, which we'll use later as raw material. +\begin_inset Foot +collapsed true + +\layout Standard + +Visit the FAQ at +\family typewriter +http://help.lon-capa.org/ +\family default + if you get +\begin_inset Quotes eld +\end_inset + +unmatched tag +\begin_inset Quotes erd +\end_inset + + warnings. +\end_inset + + \layout Subsection How to Edit Existing Content Pages \layout Standard -You may edit any any Content Pages that have been created. +You may edit any Content Pages that have been created. \layout Standard To edit Content Pages: @@ -961,15 +841,12 @@ Click on the link for the name of the Co Content Page. \layout Enumerate -Press the Edit button. - Edit the HTML code, or copy and paste HTML source code into the editor. -\layout Enumerate - -Optionally, click the +Press the \series bold -View +Edit \series default - button to preview your Content Page. + button. + Edit the HTML code, or copy and paste HTML source code into the editor. \layout Enumerate Finally, click the @@ -986,6 +863,13 @@ Save and then attempt to clean HTML \series default button. If you do not do this, your work will not be saved. +\layout Standard + +Once you've saved your page, you can click the +\series bold +View +\series default + button to preview your Content Page. \layout Subsection Creating Online Problems Using LON-CAPA @@ -1012,11 +896,29 @@ EditXML Problems Types \layout Standard -There are five types of problems that can be created with the LON-CAPA system: - Radio Response, Option Response, String Response, Numerical Response, and - Formula Response. +In this manual we will cover five basic types of problems: Radio Response, + Option Response, String Response, Numerical Response, and Formula Response. You will need to identify which types of problem you want to use and create appropriate questions for your course. +\layout Standard + +The problem editor gives you a testing area where you can try your problems + out, with several different randomizations by varying the +\series bold +Random Seed +\series default +. + If you answer a problem correctly and can no longer enter new answers, + you can get the answer field back by hitting the +\series bold +Reset Submissions +\begin_inset LatexCommand \index{Reset Submissions} + +\end_inset + + +\series default + button. \layout Subsubsection Foils @@ -1031,9 +933,8 @@ Foil \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. + is the statement after the drop-down box or radio button in a Radio Response + or Option Response problem. Foils do not need to be text; they can be images or other resources. \layout Subsubsection @@ -1049,18 +950,12 @@ Radio Response \series bold Radio Response \series default - problems represent multiple choice questions. - A True/False problem is a special case of Radio Response problem with two - foils, True or False. -\layout Standard - -Multiple choice problems contain between 3 to 10 foils. - You may display from three to five foils for each problem and the system - randomly picks the choices that are presented to the student. -\layout Comment - -Eh? If this means what I think it means, clarify. - Is the system really incapable of showing eight choices all at once? + problems present a list of foils, with buttons in front. + The student can select +\emph on +one +\emph default + of these statements by clicking the appropriate radio button. \layout Subsubsection Option Response @@ -1071,11 +966,15 @@ Option Response Problems \layout Standard -Option Response problems present foils to the student with drop-down boxes. - A group of foils is created for each concept group, and the system will - pick one to present to the student from each group. - The student must match each of his or her questions correctly to the possible - answers before receiving credit for the problem. + +\series bold +Option Response +\series default + problems present foils to the student with drop-down boxes. + The student can select the matching choice for the foils from a list of + choices. + Optionally, the foils may be bundled into Concept Groups, and the system + will select one foil from each displayed group to display to the student. For more details, see Create Option Response in section \begin_inset LatexCommand \ref{Create Option Response Problem} @@ -1163,10 +1062,13 @@ Numerical Response Formula Response Problems \layout Standard -Formula Response problems are questions in which the student types in a - math formula for the answer. + +\series bold +Formula Response +\series default + problems ask the student to type in a math formula for the answer. If the answer is -\begin_inset Formula \( x^{2}-11 \) +\begin_inset Formula $x^{2}-11$ \end_inset , the student can enter "x^2 - 11", "x*x - 11", "x^2 + 21 - 10", etc. @@ -1177,15 +1079,24 @@ Formula Response problems are questions Creating Radio Response Problems \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 201 -file creatingNewProblemResource.eps -width 3 80 -flags 13 - +\begin_inset Graphics FormatVersion 1 + filename creatingNewProblemResource.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 202pt \end_inset @@ -1197,8 +1108,9 @@ Creating A New Problem Resource \end_inset -\end_float -To create an Radio Response +\end_inset + +To create a Radio Response \begin_inset LatexCommand \index{Radio Response} \end_inset @@ -1232,15 +1144,23 @@ problem \end_inset . -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 283 -file radioResponse2.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename radioResponse2.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 283pt \end_inset @@ -1252,11 +1172,12 @@ Radio Response Creation Form \end_inset -\end_float - You will need to create the possible answers and the questions. +\end_inset + + You will need to specify the question text and foil statements. \layout Enumerate -In the drop-down option box as seen in +In the drop-down option box as seen in figure \begin_inset LatexCommand \ref{Creating a new problem resource} \end_inset @@ -1311,18 +1232,7 @@ Response: One of N statements \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. + text box, place the number of foils you wish to display to the student. \layout Enumerate Locate @@ -1347,7 +1257,15 @@ Four. \begin_inset Quotes erd \end_inset - + Make sure this is set to +\series bold +true +\series default + in the +\series bold +Correct Option +\series default + field. \layout Enumerate Below it, you will see @@ -1368,7 +1286,15 @@ Purple. \begin_inset Quotes erd \end_inset - + Make sure this is set to +\series bold +false +\series default + in the +\series bold +Correct Option +\series default + field. \layout Enumerate Repeat the previous step until you've filled in all of the other incorrect @@ -1386,15 +1312,24 @@ Unused . \layout Enumerate -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 92 -file radioResponseHint.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename radioResponseHint.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 92pt \end_inset @@ -1406,7 +1341,8 @@ Hint Element \end_inset -\end_float +\end_inset + Scroll down to the Hint element, as shown in Figure \begin_inset LatexCommand \ref{Radio Response Hint Element Figure} @@ -1414,6 +1350,15 @@ Scroll down to the Hint element, as show . Type some text that will help students when they answer incorrectly. + You may delete the hint by selecting +\series bold +Yes +\series default + from the +\series bold +Delete +\series default + drop-down box. \layout Enumerate Click the @@ -1439,7 +1384,7 @@ true \series bold true \series default -, so you can have questions with multiple correct answers. +, but only one will be shown to any given student. If it is set to \series bold false @@ -1469,9 +1414,9 @@ Maximum Number of Shown Foils 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 + created them in, type the tag \series bold - + \series default into your problem text. This can be useful with the ever-popular @@ -1484,56 +1429,6 @@ All of the above 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 - -Napoleon 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 @@ -1552,15 +1447,24 @@ Option Response Option Response problems with Concept Groups \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 280 -file optionResponseProblem.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename optionResponseProblem.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 134pt \end_inset @@ -1572,7 +1476,8 @@ Option Response Problem \end_inset -\end_float +\end_inset + Each Option Response problem can have three parts: \layout Enumerate @@ -1612,12 +1517,12 @@ 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. + Option Response Problem Templates are available for 4 and 8 Concept Groups. 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. + In order to receive credit for the problem, the student must select the + corresponding option from the drop-down box for each given foil. \layout Subsubsection Example: Concept Group @@ -1672,10 +1577,13 @@ For each foil, the author marks it True Example: Matching Problem \layout Standard -You might want to ask the student to match musical compositions with their - composers. +Option Response problems can be used as matching problems as well. +\layout Standard + +For example, 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: + place the following four foil groups each in its own concept group: \layout Itemize Claire de Lune @@ -1683,36 +1591,52 @@ Claire de Lune \end_inset +, Ballade +\begin_inset Foot +collapsed true -\begin_float footnote \layout Standard Debussy. -\end_float +\end_inset + + \layout Itemize -The Pastoral Symphony -\begin_float footnote +The Pastoral Symphony, The Ninth Symphony +\begin_inset Foot +collapsed true + \layout Standard -Beethoven's Sixth Symphony. -\end_float +Beethoven. +\end_inset + + \layout Itemize -Sleeping Beauty Suite -\begin_float footnote +Sleeping Beauty Suite, The Dance of the Sugar Plum Fairies +\begin_inset Foot +collapsed true + \layout Standard Tchaikovsky. -\end_float +\end_inset + + \layout Itemize -The Dance of the Sugar Plum Fairies -\begin_float footnote +Slavonic Dances, New World Symphony +\begin_inset Foot +collapsed true + \layout Standard -Also Tchaikovsky, from The Nutcracker. -\end_float +Dvorak. +\end_inset + + \layout Standard You could then add the following options to the option list: @@ -1730,7 +1654,7 @@ Schubert Tchaikovsky \layout Itemize -Bach +Dvorak \layout Standard The same answers can be used more then once, or not at all, as you see fit. @@ -1776,7 +1700,7 @@ problem . \layout Enumerate -In the drop-down option box as seen in +In the drop-down option box as seen in figure \begin_inset LatexCommand \ref{Creating a new problem resource} \end_inset @@ -1808,15 +1732,23 @@ Click the Edit \series default button above the sample problem to enter edit mode. -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 276 -file optionResponseEditing.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename optionResponseEditing.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 276pt \end_inset @@ -1828,7 +1760,8 @@ Option Response Editor \end_inset -\end_float +\end_inset + 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} @@ -1850,8 +1783,8 @@ Locate the 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 + You cannot display more than one foil from each concept group, so this + option will only reduce the number of foils displayed, if it is less than the number of concept groups in your Option Response problem. \layout Enumerate @@ -1875,15 +1808,7 @@ Save Changes 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 - drop down, and hit the Save Changes button. - Do that for each option you wish to remove. + (You will delete unwanted options in the last step.) \layout Enumerate Now, you need to define the question foils. @@ -1934,6 +1859,46 @@ In the Hint area, provide a helpful hint Save Changes \series default button. +\layout Enumerate + +Make sure all the options you want to delete are not used for any of your + foils +\begin_inset Foot +collapsed true + +\layout Standard + +If a deleted option is used in a foil, it will appear in a text box in the + +\series bold +Correct Option +\series default + area for that foil. + To make the drop-down box reappear, type an option already defined in the + +\series bold +Select Options +\series default + field, and hit +\series bold +Submit Changes +\series default +. + A drop-down box will reappear. +\end_inset + +. + To delete the irrelevant options from the Option Response question, select + that option from the +\series bold +Delete an Option +\series default + drop down, and hit the +\series bold +Save Changes +\series default + button. + Do that for each option you wish to remove. \layout Subsubsection Simple Option Response: No Concept Groups @@ -1944,15 +1909,19 @@ If you select Simple Option Response \series default from the drop-down box, you get a template that will allow you to enter - up to eight foils, and the system will randomly select from these foils, - with no grouping. - Otherwise, it's identical to Option Response problems. + up to eight foils with no grouping. + The system will randomly mix these foils when presenting them to the student. + You can have more foils then the +\series bold +Max Num of Shown Foils +\series default + so that each student will not have the identical foils. \layout Subsection Creating a String Response Problem \layout Standard -To create an String Response problem, create a new resource as described +To create a String Response problem, create a new resource as described in section \begin_inset LatexCommand \ref{Creating New Content Pages} @@ -1984,14 +1953,14 @@ problem . \layout Enumerate -In the drop-down option box as seen in +In the drop-down option box as seen in figure \begin_inset LatexCommand \ref{Creating a new problem resource} \end_inset -, select +, select \series bold -Simple String Response Problem + String Response Problem \series default , and click the \series bold @@ -2005,15 +1974,23 @@ Click the Edit \series default button above the sample problem to enter edit mode. -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 320 -file stringResponseEditor.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename stringResponseEditor.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 320pt \end_inset @@ -2025,7 +2002,8 @@ String Response Editor \end_inset -\end_float +\end_inset + 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} @@ -2035,8 +2013,11 @@ String Response Editor . \layout Enumerate -Clear the text from the Text Block at the top of the problem, and type in - your problem's question. +Clear the text from the +\series bold +Text Block +\series default + at the top of the problem, and type in your problem. \layout Enumerate In the @@ -2046,7 +2027,7 @@ Answer Box , type the correct answer. \layout Enumerate -Select the answer condition from the drop down box. +Select the answer condition from the drop-down. There are three cases to choose from: \begin_deeper \layout Enumerate @@ -2064,10 +2045,11 @@ Case Sensitive \end_inset . - For example, this is useful in Chemistry, where HO and Ho are completely + For example, this is useful in chemistry, where HO and Ho are completely different answers -\begin_float footnote -\end_deeper +\begin_inset Foot +collapsed true + \layout Standard @@ -2080,10 +2062,10 @@ HO Ho \series default is the element 67, Holmium, in the Lanthanides. -\end_float +\end_inset + . The student must match the case of the answer. -\begin_deeper \layout Enumerate @@ -2230,11 +2212,27 @@ Single Line Text Entry Area box size to 2, the student can still enter 3 or more letters in their answer. \layout Enumerate -Scroll down to the Hint element, and type some text that will help students - when they answer incorrectly. +Scroll down to the +\series bold +Hint +\series default + element, and type some text that will help students when they answer incorrectl +y, or delete the hint by setting the +\series bold +Delete +\series default + field to +\series bold +Yes +\series default +. \layout Enumerate -Click the Submit Changes button. +Click the +\series bold +Submit Changes +\series default + button. \layout Subsection Creating Numerical Response And Formula Response Problems @@ -2243,30 +2241,30 @@ Creating Numerical Response And Formula 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} \) +\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 \) +\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 \) +\begin_inset Formula $x^{2}+11$ \end_inset -, the system will accept -\begin_inset Formula \( x*x-11 \) +, the system will also accept +\begin_inset Formula $x*x+11$ \end_inset or -\begin_inset Formula \( x^{2}+21-10 \) +\begin_inset Formula $x^{2}+21-10$ \end_inset - as well. +. \layout Standard Creating Numerical Response and Formula Response problems starts the same @@ -2289,7 +2287,7 @@ Creating Numerical Response and Formula Publishing Your Resources \layout Standard -In order to make the content you've created available for courses to use, +In order to make the content you've created available for use in courses, you must publish your content. LON-CAPA provides an easy interface for publishing your content pages, problem resources, and sequences. @@ -2327,16 +2325,17 @@ data about data 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. + which is much more difficult than 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 web page, - which usually shows up in the title bar of the browser. +One example of metadata is the <title> of a web page, which usually shows + up in the title bar of the browser. That's information about the web page itself, not actually part of the web page. - People use it when they bookmark a page, so they know what the page is. + People use the title information 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 @@ -2353,15 +2352,24 @@ Publishing A Resource \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 168 -file constructionSpaceForPublishing.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename constructionSpaceForPublishing.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 168pt \end_inset @@ -2373,7 +2381,8 @@ Construction Space for Publishing \end_inset -\end_float +\end_inset + To publish a resource, log in and choose your role to be an Author. Then click \series bold @@ -2391,15 +2400,23 @@ CSTR Publish \series default button for the resource you wish to publish. -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 338 -file publishMetadata.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename publishMetadata.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 338pt \end_inset @@ -2411,7 +2428,8 @@ Publishing Metadata Screen \end_inset -\end_float +\end_inset + You'll get a metadata screen that should look something like figure \begin_inset LatexCommand \ref{Publishing Metadata Screen Figure} @@ -2425,12 +2443,16 @@ Publishing Metadata Screen \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. +The +\series bold +Language +\series default + is the language the problem is written in. + The +\series bold +Publisher/Owner +\series default + is the LON-CAPA user who owns the problem. \layout Standard The @@ -2456,8 +2478,8 @@ pulley \end_inset as a key word. - LON-CAPA pulls out likely-looking keywords for you so you can just click - on their check boxes to make them keywords. + LON-CAPA pulls out words used in the text of the resource for you so you + can just click on their check boxes to make them keywords. \series bold Additional keywords @@ -2474,11 +2496,20 @@ statics , even though it doesn't appear in the original problem, because Physics uses that as a classification of problem type. + +\series bold +Additional Keywords +\series default + are also useful when publishing graphics. \layout Standard -Finally, you need to set the copyright and distribution notice. - This setting controls who is allowed to use your resource. +Finally, you need to set the copyright and distribution permissions in the +\series bold +COPYRIGHT/DISTRIBUTION +\series default + drop-down. + This setting controls who is allowed to use your resource as follows: \layout Itemize @@ -2544,23 +2575,44 @@ In order to create a useful course, we n so that students can use them. \layout Subsection -Binding Together Resources In One Map: Page -\begin_inset LatexCommand \index{Page} +Creating Sequences +\begin_inset LatexCommand \index{Sequence} \end_inset \layout Standard -\begin_float fig +A +\series bold +Sequence +\series default + is a series of resources that can be navigated using the +\series bold +NAV +\series default + remote control button, or by using the arrow keys on the remote control. + +\layout Standard + + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 238 83 -file mapEditorSelection.eps -width 3 40 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename mapEditorSelection.eps + display color + size_type 1 + width 40page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 238pt + lyxheight 83pt \end_inset @@ -2572,17 +2624,9 @@ Map Editor Selection \end_inset -\end_float -To join several resources into one web 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 +\end_inset + +To create a Sequence resource, create a new resource as described in section \begin_inset LatexCommand \ref{Creating New Content Pages} @@ -2593,7 +2637,7 @@ Page \begin_inset Quotes eld \end_inset -page +sequence \begin_inset Quotes erd \end_inset @@ -2601,7 +2645,7 @@ page \begin_inset Quotes eld \end_inset -.page +.sequence \begin_inset Quotes erd \end_inset @@ -2610,7 +2654,7 @@ page \begin_inset Quotes eld \end_inset -.page +.sequence \begin_inset Quotes erd \end_inset @@ -2621,78 +2665,29 @@ page . You can use either the advanced editor or the simplified editor. - -\layout Comment - -The following is a commented-out section of the manual, likely to not be - useful. -\layout Comment - -About The Editor -\layout Comment - -\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, going 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 which will provide more help for the student. - -\layout Comment - -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 Comment - -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 .page With The Simple Editor +Creating a Simple .sequence With The Simple Editor \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 250 -file mapSimpleEditor.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename mapSimpleEditor.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 250pt \end_inset @@ -2704,9 +2699,10 @@ Simple Map Editor \end_inset -\end_float -After creating a new .page resource and getting the editor selection prompt - (figure +\end_inset + +After creating a new .sequence resource and getting the editor selection + prompt (figure \begin_inset LatexCommand \ref{Map Editor Selection Figure} \end_inset @@ -2715,7 +2711,7 @@ After creating a new .page resource and \series bold Simple Edit \series default - button to get to the simple sequence editor, which appears in figure + button to get to the simple map editor, which appears in figure \begin_inset LatexCommand \ref{Simple Map Editor} \end_inset @@ -2749,7 +2745,8 @@ On both sides of the screen, you can do from that search into either directly into your Map, or into your Import space. Checkboxes will appear next to the results in the Group Search, and you - can click the resource you wish to add to your map. + can click the resource you wish to add to your map in the order that you + want them added. After you select the resource, you will be presented with a screen that allows you to change the order of the selected resources, then you will be able to import the selected resources and work with them. @@ -2770,11 +2767,11 @@ Both list boxes support standard multi-s OS. \layout Subsection -Creating a Simple .page With The Advanced Editor +Creating a Simple .sequence With The Advanced Editor \layout Standard -After creating a new .page resource and getting the editor selection prompt - (figure +After creating a new .sequence resource and getting the editor selection + prompt (figure \begin_inset LatexCommand \ref{Map Editor Selection Figure} \end_inset @@ -2783,17 +2780,25 @@ After creating a new .page resource and \series bold Advanced Edit \series default - button to get to the advanced sequence editor. + button to get to the advanced map editor. -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 205 -file mapAdvancedEditorNew.eps -width 3 80 -flags 11 - +\begin_inset Graphics FormatVersion 1 + filename mapAdvancedEditorNew.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 205pt \end_inset @@ -2805,40 +2810,58 @@ Initial Map Editor \end_inset -\end_float -You should the initial map editor as seen in figure +\end_inset + +You should see the initial map editor as shown in figure \begin_inset LatexCommand \ref{Initial Map Editor FIgure} \end_inset . - Note there are two windows. - One is the workspace, and one is a secondary window which will contain - information as you add resources. + Note there are two windows: One is the workspace, and one is a secondary + window which will contain information as you add resources. \layout Enumerate -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 221 -file mapClickedStart.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename mapClickedStart.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 221pt \end_inset \layout Caption -Clicked Start in the Map Constructor +After clicking +\series bold +Start +\series default + in the Map Constructor \begin_inset LatexCommand \label{Clicked Start Figure} \end_inset -\end_float -Click the Start box. +\end_inset + +Click the +\series bold +Start +\series default + box. You'll see what you see in figure \begin_inset LatexCommand \ref{Clicked Start Figure} @@ -2846,23 +2869,31 @@ Click the Start box. . Click -\begin_inset Quotes eld -\end_inset - +\series bold Link Resource -\begin_inset Quotes erd -\end_inset +\series default + in the secondary window, then click on the +\series bold +Finish +\series default + box. +\begin_inset Float figure +placement htbp +wide false +collapsed false - in the secondary window, then click on the Finish box. -\begin_float fig \layout Standard \align center -\begin_inset Figure size 70 210 -file mapStraightened.eps -height 3 25 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename mapStraightened.eps + display color + size_type 1 + height 25page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 70pt + lyxheight 210pt \end_inset @@ -2874,15 +2905,12 @@ Straightened Map \end_inset -\end_float - After that, click -\begin_inset Quotes eld -\end_inset - -straighten -\begin_inset Quotes erd \end_inset + After that, click +\series bold +Straighten +\series default . You should see something like figure \begin_inset LatexCommand \ref{Striaghtened map} @@ -2893,15 +2921,24 @@ straighten This creates a simple map that flows from beginning to end. \layout Enumerate -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 271 252 -file mapInsertResource.eps -height 3 30 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename mapInsertResource.eps + display color + size_type 1 + height 30page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 271pt + lyxheight 252pt \end_inset @@ -2913,8 +2950,23 @@ Inserting a Resource \end_inset -\end_float -To insert a resource into the flow, click the black line with two arrows. +\end_inset + +To insert a resource into the flow, click the black line with two arrows, + seen between the +\series bold +Start +\series default + and +\series bold +Finish +\series default + boxes in figure +\begin_inset LatexCommand \ref{Striaghtened map} + +\end_inset + +. In the secondary window, you'll see something like figure \begin_inset LatexCommand \ref{Inserting a Resource Figure} @@ -2926,8 +2978,12 @@ To insert a resource into the flow, clic Insert Resource Into Link \series default . - A new resource will appear in the link. - Click the resource. + A new resource box will appear in the link. + Click the resource, which will have the label +\series bold +Res +\series default +. \layout Enumerate Click @@ -2939,15 +2995,23 @@ Browse Network Directory Browser \series default will appear, -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 357 162 -file mapEditorDirectoryBrowser.eps -width 3 60 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename mapEditorDirectoryBrowser.eps + display color + size_type 1 + width 60page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 357pt + lyxheight 162pt \end_inset @@ -2959,23 +3023,37 @@ Network Directory Browser \end_inset -\end_float +\end_inset + 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 + Press the +\series bold +SELECT +\series default + button that is next to the resource you want to place in the chosen resource + box. +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 42 252 -file mapEditorResourceChosen.eps -height 3 30 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename mapEditorResourceChosen.eps + display color + size_type 1 + height 30page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 42pt + lyxheight 252pt \end_inset @@ -2987,7 +3065,8 @@ Resource Chosen \end_inset -\end_float +\end_inset + Once you've done that, if you look back at the window that popped up when you clicked on \series bold @@ -3008,13 +3087,13 @@ URL Title \series default into the secondary window, if you prefer, following the format you see - above. + when you've successfully browsed to a resource. After you click \series bold Save Changes \series default -, your changes will be saved, and the icons for the resource will appear - in the +, your changes will be set, and the icons for the resource will appear in + the \series bold Res \series default @@ -3024,6 +3103,11 @@ Res \end_inset . + Click +\series bold +Save Map +\series default + in the bar above your map to save the map. \begin_deeper \layout Standard @@ -3055,21 +3139,23 @@ In addition to manually adding in resour The advanced editor has many more capabilities which you can explore. \layout Subsection -Creating Sequences -\begin_inset LatexCommand \index{Sequence} +Page Maps +\layout Standard +Creating a .page map is the same as creating a sequence map, except that + when choosing the name of the resource, the URL will end with +\begin_inset Quotes eld \end_inset +.page +\begin_inset Quotes erd +\end_inset +. + Then all resources you add in the map editor will appear on one page together. \layout Standard -Sequences are a series of resources that can be navigated using the -\series bold -NAV -\series default - remote control button, or by using the arrow keys on the remote control. - Sequence maps are created identically to page maps. - The only difference is how they are displayed. +Pages are often used to connect problems in a homework set. \layout Subsection Creating a Course: Top-level Sequence @@ -3080,15 +3166,23 @@ In order to view sequences, they need to course \series default . -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 238 231 -file creatingANewCourse.eps -width 3 40 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename creatingANewCourse.eps + display color + size_type 1 + width 40page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 238pt + lyxheight 231pt \end_inset @@ -3100,13 +3194,14 @@ Creating a New Course \end_inset -\end_float +\end_inset + Courses have a Top-level Map which defines the whole course. This top-level map will often itself contain maps corresponding to homework - assignments or weekly sequences. + assignments, chapters, or units. To view your maps, you will need to make them part of a course. - Only Domain Administrators can make courses and set their Top-level maps, - so coordinate with your Domain Administrator if you need to view your maps. + Only Domain Coordinators can make courses and set their Top-level maps, + so work with your Domain Coordinator if you need to view your maps. \layout Section Numerical Response @@ -3125,34 +3220,12 @@ Numerical Response 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 + This chapter will focus on getting you started with Numerical Response problems, and showing you some of the possibilities, with no prerequisite knowledge 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} @@ -3177,15 +3250,24 @@ Simple Numerical Response The Parts of a Numerical Response Problem \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 356 -file numericalResponse1.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename numericalResponse1.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 356pt \end_inset @@ -3197,7 +3279,8 @@ Numerical Response editor \end_inset -\end_float +\end_inset + A Numerical Response problem has seven major parts by default, as seen in figure \begin_inset LatexCommand \ref{Numerical Response Editor Figure} @@ -3218,15 +3301,14 @@ Script 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 +\series default . - 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. + You do not need to know Perl to use the +\series bold +Script +\series default +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 @@ -3234,7 +3316,7 @@ Like other problem types, the Text Block \series default is used to display the problem the student will see. - In addition, you can place things in the + In addition, you can place variables in the \series bold Text Block \series default @@ -3266,16 +3348,18 @@ tolerance \series default - parameter, which determines how closely the system will require the student + parameter, which determines how closely the system will require the student's 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 +\begin_inset Foot +collapsed true + \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} \) +\begin_inset Formula $\frac{1}{3}$ \end_inset is @@ -3308,15 +3392,16 @@ 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 +\end_inset + , 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 \) + For some answer +\begin_inset Formula $a$ \end_inset and a tolerance -\begin_inset Formula \( t \) +\begin_inset Formula $t$ \end_inset , @@ -3338,21 +3423,22 @@ Absolute \end_inset will take anything in the range -\begin_inset Formula \( a\pm t \) +\begin_inset Formula $a\pm t$ \end_inset . So if -\begin_inset Formula \( a=10 \) +\begin_inset Formula $a=10$ \end_inset and -\begin_inset Formula \( t=2 \) +\begin_inset Formula $t=2$ \end_inset , then anything between 8 and 12 is acceptable -\begin_float footnote -\end_deeper +\begin_inset Foot +collapsed true + \layout Standard For much the same reasons a tolerance is almost always a good idea, it's @@ -3361,7 +3447,7 @@ For much the same reasons a tolerance is exactly \emph default -\begin_inset Formula \( a\pm t \) +\begin_inset Formula $a\pm t$ \end_inset will be accepted by the computer. @@ -3384,7 +3470,8 @@ exactly is OK. (Don't use too many more zeros, though you can use less if you like.) -\end_float +\end_inset + . Any number in the tolerance field \emph on @@ -3395,7 +3482,6 @@ without % \series default symbol is an absolute tolerance. -\begin_deeper \layout Enumerate a @@ -3413,7 +3499,7 @@ Relative \end_inset will take anything in the range -\begin_inset Formula \( a\pm at \) +\begin_inset Formula $a\pm at$ \end_inset , where @@ -3431,11 +3517,11 @@ followed by \series default symbol is a relative tolerance. For example, -\begin_inset Formula \( a=10 \) +\begin_inset Formula $a=10$ \end_inset and -\begin_inset Formula \( t=10\% \) +\begin_inset Formula $t=10\%$ \end_inset will accept anything between 9 and 11. @@ -3498,11 +3584,31 @@ min,max \end_inset are the same. -\begin_deeper -\layout Comment + A significant figure specification of +\begin_inset Quotes eld +\end_inset -Confirm this. -\end_deeper +3,4 +\begin_inset Quotes erd +\end_inset + + means both +\begin_inset Quotes eld +\end_inset + +1.30 +\begin_inset Quotes erd +\end_inset + + and +\begin_inset Quotes eld +\end_inset + +1.300 +\begin_inset Quotes erd +\end_inset + + are acceptable. \layout Enumerate The @@ -3517,8 +3623,7 @@ Finally, the \series bold Hint \series default - provides a place to help students who get the problem incorrect the first - time. + should contain text which will help the students when they answer incorrectly. \layout Subsection Simple Numerical Response Answer @@ -3560,8 +3665,7 @@ Answer \series bold Hint \series default - has been set to something appropriate for this problem (unless this problem - is being given to very young children). + has been set to something appropriate for this problem. Everything else has the default values from when the problem was created. \layout Standard @@ -3577,7 +3681,12 @@ View 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. + accept and the number of significant digits the computer requires when + viewed by an +\series bold +Author +\series default +. \layout Standard As you're playing with the problem, if you use up all your tries or get @@ -3628,7 +3737,7 @@ statement \series default - is the smallest kind of instruction to the computer you can give. + is the smallest kind of instruction to the computer. Most problems will be built from several statements. \layout Standard @@ -3666,7 +3775,7 @@ variable assignment variable \series default can hold any value in it. - Simple values, such as a number or a string of text, start with a + The variable name must start with a \series bold $ \series default @@ -3676,32 +3785,18 @@ $ 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 + Put this program into the \series bold Script \series default - field of the Numerical Response. - This creates a simple variable named + field of the Numerical Response: +\begin_deeper +\layout LyX-Code + +$variable = 3; +\layout Standard + +This creates a variable named \series bold variable \series default @@ -3715,6 +3810,7 @@ variable . That's one statement. +\end_deeper \layout Standard Variable names are @@ -3727,16 +3823,11 @@ case sensitive \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 used in control flow statements, which - are not covered in this manual. -\layout Standard - There are many variable naming conventions, covering both how to name and how to capitalize variables -\begin_float footnote +\begin_inset Foot +collapsed true + \layout Standard The author favors @@ -3746,7 +3837,7 @@ capsOnNewWords . Some people use \family typewriter -underscore_to_seperate_words +underscore_to_separate_words \family default . Many use uppercase letters to specify constants like @@ -3763,7 +3854,7 @@ GOLDEN_MEAN StartWithCapatalization \family default . - What's really importent is to be consistent, so you don't have to guess + What's really important is to be consistent, so you don't have to guess whether the variable you're thinking of is \family typewriter coefFriction @@ -3777,7 +3868,8 @@ CoefFriction COEF_FRICTION \family default , or something else. -\end_float +\end_inset + . 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 @@ -3875,7 +3967,11 @@ stringVar \layout Standard If you are following this chapter as a tutorial, add the previous two lines - and save the problem. + to your +\series bold +Script +\series default + and submit the changes for the problem. There's no need to view it; there's still no visible change. \layout Subsubsection @@ -3905,14 +4001,23 @@ See the 3: $variable<br /> See the string: <b>$stringVar</b><br /> \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 353 99 -file numericalResponseVarInText.eps -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename numericalResponseVarInText.eps + display color + size_type 0 + rotateOrigin center + lyxsize_type 1 + lyxwidth 353pt + lyxheight 99pt \end_inset @@ -3924,7 +4029,8 @@ Result of Variables in the Text Block \end_inset -\end_float +\end_inset + If you save that and hit \series bold View @@ -3973,14 +4079,10 @@ Answer 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 - +\series bold $variable -\begin_inset Quotes erd -\end_inset - - (without the quotes), +\series default +, \series bold Save Changes \series default @@ -3992,7 +4094,7 @@ View \begin_inset Quotes eld \end_inset -3 +3.0 \begin_inset Quotes erd \end_inset @@ -4016,16 +4118,21 @@ ework5.html. For now, let's just look at some simple examples. \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout LyX-Code -$a = 3; +$a = -3.0; \layout LyX-Code $b = &sin($a); \layout LyX-Code -$c = &pow(3, &floor($a)); +$c = &pow(3.0, &abs($a)); \layout Caption Some Function Calls @@ -4034,7 +4141,8 @@ Some Function Calls \end_inset -\end_float +\end_inset + In the \series bold Script @@ -4054,20 +4162,19 @@ Script of other function calls as parameters. The \family typewriter -sin +&sin \family default function returns the sine of an angle expressed in radians. \family typewriter -pow +&pow \family default raises the first parameter to the power of the second parameter. \family typewriter -floor +&abs \family default - returns the nearest integer below the parameter, which since 3 is already - an integer is 3. + returns the absolute value of the argument. \layout Subsubsection Randomization @@ -4083,7 +4190,7 @@ For LON-CAPA, one of the most important random \family default function. - Random takes three parameters, a + Random takes three parameters: a \emph on lower limit \emph default @@ -4098,7 +4205,7 @@ interval . The \family typewriter -random +&random \family default function returns a random value between the upper and lower limit, some integer number of @@ -4113,20 +4220,25 @@ interval might return 1, 1.2, 1.4, 1.6, 1.8, or 2. \family typewriter -random +&random \family default uses a uniform distribution. Other distributions are available in LON-CAPA, and can be found by consulting the function list. \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout LyX-Code -$a = &random(1,10,1); +$a = &random(1.0,10.0,1.0); \layout LyX-Code -$b = &random(-10, -3, 1); +$b = &random(-10.0, -3.0, 1.0); \layout LyX-Code $answer = $a+$b; @@ -4142,7 +4254,8 @@ random \end_inset -\end_float +\end_inset + If you put the script in figure \begin_inset LatexCommand \ref{Sample Random Calls figure} @@ -4240,15 +4353,23 @@ Dynamic, Randomized Problems: Putting It Now you have all the tools to create those wonderful dynamic, randomized problems that you've seen in LON-CAPA. -\begin_float fig +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 197 -file numericalResponseSlopeProblem.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename numericalResponseSlopeProblem.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 197pt \end_inset @@ -4260,7 +4381,8 @@ Slope Problem Parameters \end_inset -\end_float +\end_inset + For example, try filling out your problem with the parameters shown in figure \begin_inset LatexCommand \ref{Slope Problem Parameters Figure} @@ -4279,7 +4401,7 @@ both \emph default with the expression \family typewriter -&rand(-1,1,.2) +&random(-1.0,1.0,.2) \family default . One out of ten students would get a problem where both slopes were equal, @@ -4344,7 +4466,7 @@ Format \begin_inset Quotes eld \end_inset -2e +2E \begin_inset Quotes erd \end_inset @@ -4358,50 +4480,29 @@ Format \begin_inset Quotes erd \end_inset - will display three significant digit in traditional notation if possible, - and scientific notation if the number is too large or too small. - You can use any small number that you want instead of -\begin_inset Quotes eld -\end_inset - -2 -\begin_inset Quotes erd -\end_inset - -. + will display two digits after the decimal point. \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. - You may also find new ideas you can use and elaborate on 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. - Looking in the function list at http://mileva.lite.msu.edu/loncapadocs/homework/ho -mework5.html can give you some ideas. +The full power of Perl is well outside the scope of this document. + Looking in the function list at +\newline +http://mileva.lite.msu.edu/loncapadocs/homework/homework5.html +\newline +can give you some ideas. O'Reilly has some good Perl books. - The Perl 5 Pocket Reference will contain more then what you need to know - to use LON-CAPA, available at http://www.oreilly.com/catalog/perlpr3/ . + The Perl 5 Pocket Reference will contain more than what you need to know + to use LON-CAPA, available at +\newline +http://www.oreilly.com/catalog/perlpr3/ . \layout Standard If you have any problems, consult http://help.loncapa.org/fom/cache/5.html . If you don't find the answer to your problem, please help us expand the - FAQ by emailing us your question so we can answer it. + FAQ by submitting a new pending question. \layout Standard Our advanced users often come to prefer the XML interface for the problems, @@ -4428,25 +4529,35 @@ Formula Response Problems \layout Standard -\begin_float fig + +\begin_inset Float figure +placement htbp +wide false +collapsed false + \layout Standard \align center -\begin_inset Figure size 476 262 -file formulaResponse.eps -width 3 80 -flags 9 - +\begin_inset Graphics FormatVersion 1 + filename formulaResponse.eps + display color + size_type 1 + width 80page% + rotateOrigin center + lyxsize_type 1 + lyxwidth 476pt + lyxheight 262pt \end_inset \layout Caption Formula Response Problem -\end_float +\end_inset + Formula response problems asks the student to type in a formula as an answer. If the answer is -\begin_inset Formula \( 2x^{2}+4 \) +\begin_inset Formula $2x^{2}+4$ \end_inset , the student is allowed to type @@ -4483,7 +4594,7 @@ x*x + x*x + 4 As you may know, it is extremely difficult to determine whether a given expression is exactly equal to another expression in general. For example, is -\begin_inset Formula \( \sin 2x=2\sin x\cos x \) +\begin_inset Formula $\sin 2x=2\sin x\cos x$ \end_inset ? Symbolically proving it one way or another is impossible in general. @@ -4496,7 +4607,7 @@ As you may know, it is extremely difficu Sampling Specifications \layout Standard -To specify where to sample the formulas to determine whether the student's +To specify where to sample the formulas for determining whether the student's answer is correct, you need to put a sampling specification in the \series bold Sample Points @@ -4508,10 +4619,10 @@ Sample Points field. The sampling specifications takes the following format: -\layout Itemize +\layout Enumerate -A comma seperated list of the variables you wish to interpret, -\layout Itemize +A comma separated list of the variables you wish to interpret, +\layout Enumerate followed by \begin_inset Quotes eld @@ -4522,7 +4633,7 @@ followed by \end_inset (not in quotes), -\layout Itemize +\layout Enumerate followed by any number of the following two things, separated by semi-colons: \begin_deeper @@ -4533,8 +4644,8 @@ a comma separated list of as many number \layout Enumerate a comma separated list of as many numbers as there are variables, followed - a colon, followed by another list of as many numbers as there are variables, - followed by #, followed by an integer. + by a colon, followed by another list of as many numbers as there are variables, + followed by a #, followed by an integer. \end_deeper \layout Standard @@ -4544,7 +4655,7 @@ The first form specifies one point to sa \layout Standard For -\begin_inset Formula \( 2x^{2}+4 \) +\begin_inset Formula $2x^{2}+4$ \end_inset , with one variable @@ -4575,16 +4686,27 @@ x@2 \begin_inset Quotes eld \end_inset +x@1:5#4 +\begin_inset Quotes erd +\end_inset + + will takes 4 samples from somewhere between 1 and 5. +\layout Itemize + + +\begin_inset Quotes eld +\end_inset + x@1:5#4;10 \begin_inset Quotes erd \end_inset - will take 4 samples from somewhere between 1 and 5, and also sample at + will takes 4 samples from somewhere between 1 and 5, and also sample at 10. \layout Standard For -\begin_inset Formula \( 2x^{2}+3y^{3} \) +\begin_inset Formula $2x^{2}+3y^{3}$ \end_inset , which has two variables, one could specify @@ -4652,58 +4774,46 @@ Script , place the following: \layout LyX-Code -$slope = random(-5,5,.5); +$slope = &random(-5.0,5.0,.5); \layout LyX-Code -$yint = random(-5,5,.5); -\layout Itemize +$yint = &random(-5.0,5.0,.5); +\layout LyX-Code -In the -\series bold -Text Block -\series default -, place the following: +$answer = \begin_inset Quotes eld \end_inset -For a line with slope $slope and y-intercept $yint, what is y equal to? +$slope*x + ($yint) \begin_inset Quotes erd \end_inset - +; \layout Itemize In the \series bold -Answer +Text Block \series default , place the following: \begin_inset Quotes eld \end_inset -$slope*x + ($yint) +For a line with slope $slope and y-intercept $yint, what is y equal to? \begin_inset Quotes erd \end_inset \layout Itemize -Set the Tolerance to .000001. -\layout Itemize - -Set the +In the \series bold Answer \series default - to -\begin_inset Quotes eld -\end_inset - -$slope * x + $yint -\begin_inset Quotes erd -\end_inset +, place the following: $answer +\layout Itemize -. +Set the Tolerance to .000001. \layout Itemize Set the @@ -4711,107 +4821,4 @@ Set the Sample Points \series default to x@0,1,2,3 . -\layout Comment - -TODO: -\layout Comment - -* Get sampling problem figured out -\layout Comment - -\SpecialChar ~ - -\layout Comment - -\SpecialChar ~ - -\newline -\SpecialChar ~ - -\layout Comment - -Appendix A: Student Interface -\layout Comment - -\begin_float fig -\layout Standard -\align center - -\begin_inset Figure size 152 353 -file studentInterface.eps -flags 9 - -\end_inset - - -\layout Caption - -Student Remote Control -\begin_inset LatexCommand \label{Student Remote Control} - -\end_inset - - -\end_float -The Student Remote Control will automatically load whenever you log in to - a LON-CAPA course as a student. - The Student Remote Control contains most of the functions of the Author - Remote Control and the following additional functions. -\layout Comment - - -\series bold -NAV (NAVIGATE CONTENTS) -\series default - allows you to directly access resources from the course outline. -\layout Comment - - -\series bold -ARROWS (LEFT and RIGHT) -\series default - allows you to move to the backward or forward through the course. -\layout Comment - - -\series bold -GRDS (MY GRADES) -\series default - allows you to check your grades in the courses you are taking. -\layout Comment - - -\series bold -SBKM (SET BOOKMARK) -\series default - allows you to bookmark pages for easy access. -\layout Comment - - -\series bold -VBKM (VIEW BOOKMARK) -\series default - displays your bookmarks for easy access to bookmarked resources. -\layout Comment - - -\series bold -ANOT (ANOTATE) -\series default - allows you to create personal notes. -\layout Comment - - -\series bold -LOGOUT (LOGOUT) -\series default - will log you out of the LON-CAPA system. -\layout Standard - - -\begin_inset LatexCommand \printindex{} - -\end_inset - - \the_end