Annotation of doc/tutorial/tutorial.lyx, revision 1.3
1.1 bowersj2 1: #LyX 1.1 created this file. For more info see http://www.lyx.org/
2: \lyxformat 218
3: \textclass article
4: \begin_preamble
5: \usepackage{floatflt}
6: \end_preamble
7: \language english
8: \inputencoding auto
1.2 bowersj2 9: \fontscheme default
1.1 bowersj2 10: \graphics default
1.2 bowersj2 11: \paperfontsize 12
1.1 bowersj2 12: \spacing single
13: \papersize Default
14: \paperpackage a4
15: \use_geometry 1
16: \use_amsmath 0
17: \paperorientation portrait
1.2 bowersj2 18: \leftmargin 1in
1.1 bowersj2 19: \topmargin 1.25in
1.2 bowersj2 20: \rightmargin 1in
21: \bottommargin 1in
1.1 bowersj2 22: \secnumdepth 3
23: \tocdepth 3
24: \paragraph_separation indent
25: \defskip medskip
26: \quotes_language english
27: \quotes_times 2
28: \papercolumns 1
29: \papersides 1
30: \paperpagestyle fancy
31:
32: \layout Title
33:
1.3 ! bowersj2 34: Learning
1.1 bowersj2 35: \emph on
36: Online
37: \emph default
38: Network with CAPA
1.3 ! bowersj2 39: \newline
! 40:
! 41: \emph on
! 42: \SpecialChar ~
! 43:
! 44: \newline
! 45:
! 46: \size larger
! 47: Author's Tutorial And Manual
1.1 bowersj2 48: \layout Standard
1.2 bowersj2 49: \added_space_top vfill \align center
50: \SpecialChar ~
51:
52: \layout Standard
53: \align center
54: This manual was developed by John Williamson in the Office of Medical Education
55: Research and Development.
56: Some information in thie manual is adapted from the
57: \begin_inset Quotes eld
58: \end_inset
59:
60: LON-CAPA Workshop Demo
61: \begin_inset Quotes erd
62: \end_inset
63:
64: developed by Felicia Berryman in the Laboratory for Instructional Technology
65: in Education.
66: \layout Standard
67:
68: \SpecialChar ~
69:
70: \layout Standard
71: \pagebreak_bottom \align center
1.1 bowersj2 72: Laboratory for Instructional Technology in Education
73: \newline
74: and the
75: \newline
76: Office of Medical Education Research and Development
77: \newline
78: Michigan State University
79: \newline
80:
81: \layout Standard
82: \pagebreak_bottom
83:
84: \begin_inset LatexCommand \tableofcontents{}
85:
86: \end_inset
87:
88:
89: \layout Section
90:
91: Introduction to LON-CAPA
92: \layout Comment
93:
94: This is a comment which will not show in any other rendering of this document.
95: I will use them to document my observations as I work through this tutorial.
96: \layout Comment
97:
98: Imagine a big
99: \begin_inset Quotes eld
100: \end_inset
101:
102: IMHO
103: \begin_inset Quotes erd
104: \end_inset
105:
106: on all of these comments; I'm just going to give you my comments straight
107: out.
108: I'm not attached to them and won't be offended by anything you say or do
109: about them.
110: \layout Standard
111:
112: LON-CAPA is a web-based interface that helps to organize and present your
113: course website, deliver and manage problem problems, and manage student
114: enrollment.
115: All author functions are done using a web browser (Netscape 4.x or higher
116: is recommended) and the LON-CAPA Author Interface.
117: The URL for LON-CAPA is
118: \family typewriter
119: http://s10.lite.msu.edu
120: \family default
121: .
122: \layout Standard
123:
124: At this time, you should have:
125: \layout Itemize
126:
127: developed your objectives for your course.
128:
129: \layout Itemize
130:
131: developed your problems for testing and identified the question formats.
1.3 ! bowersj2 132: \layout Subsection
! 133:
! 134: About This Manual
! 135: \layout Standard
! 136:
! 137: Throughout this manual, keywords and phrases literally present on the computer
! 138: screen will be referred to in
! 139: \series bold
! 140: bold type
! 141: \series default
! 142: .
! 143: \layout Standard
! 144:
! 145: Chapters
! 146: \begin_inset LatexCommand \ref{Author Interface}
! 147:
! 148: \end_inset
! 149:
! 150: through
! 151: \begin_inset LatexCommand \ref{Creating a Course}
! 152:
! 153: \end_inset
! 154:
! 155: comprise a tutorial that will introduce you to the authoring system.
! 156: After that, this document is a reference manual for authoring course materials.
1.1 bowersj2 157: \layout Standard
158:
1.3 ! bowersj2 159: For more information, see the website at http://help.loncapa.org/, where you
! 160: can get help and information.
! 161: If you cannot find an answer for your question, please email us and let
! 162: us know, so we put the solution to your problem online.
1.1 bowersj2 163: \layout Section
164:
165: The LON-CAPA Author Interface
1.3 ! bowersj2 166: \begin_inset LatexCommand \label{Author Interface}
! 167:
! 168: \end_inset
! 169:
! 170:
1.1 bowersj2 171: \layout Subsection
172:
173: Login as Course Author
174: \begin_inset LatexCommand \index{Course Author}
175:
176: \end_inset
177:
178:
179: \layout Standard
180:
181: To begin using LON-CAPA, you first need to log in to your account on LON-CAPA.
182: Open your web browser and navigate to the LON-CAPA URL:
183: \family typewriter
184: http://s10.lite.msu.edu/
185: \family default
186: .
187: You will be presented with a log in screen as in figure
188: \begin_inset LatexCommand \ref{LON-CAPA Log in screen}
189:
190: \end_inset
191:
192: .
193:
194: \begin_float fig
195: \layout Standard
196: \align center
197:
198: \begin_inset Figure size 297 234
199: file login.eps
200: width 3 50
201: flags 11
202:
203: \end_inset
204:
205:
1.2 bowersj2 206: \layout Caption
207:
208:
209: \begin_inset LatexCommand \label{LON-CAPA Log in screen}
210:
211: \end_inset
212:
213: LON-CAPA Log in screen
1.1 bowersj2 214: \end_float
215: \layout Standard
216:
217: Fill in the Username and Password boxes with your information.
218: Then press the Login button.
219: This will take you to your LON-CAPA User Roles menu.
220: \layout Description
221:
1.3 ! bowersj2 222: Note: Your Username and Password will be given to you by your system administrat
! 223: or.
! 224: Both are case sensitive, so make sure you type them with the correct case.
1.1 bowersj2 225: \layout Subsection
226:
227:
228: \begin_inset LatexCommand \index{Author Remote Control}
229:
230: \end_inset
231:
232: Author Remote Control
233: \layout Comment
234:
235: Comment on the remote controls: I'll only mention this once, but imagine
236: this comment exists everywhere a remote control image is used.
237: The whole
238: \begin_inset Quotes eld
239: \end_inset
240:
241: remote control
242: \begin_inset Quotes erd
243: \end_inset
244:
245: metaphor is fundamentally flawed and probably can't be salvaged.
246: Why is it flawed?
247: \layout Comment
248:
249: \SpecialChar ~
250:
251: \layout Comment
252:
253: 1.
254: The remote control invokes a metaphor, that of remote controls.
255: However, remote controls are useful in the real world, despite the overwhelming
256: complexity of modern remotes, for three major reasons: One, they never,
257: ever, ever change.
258: Two, they provide immense amounts of tactile feedback, allowing one to
259: overcome the complexity of using one by putting the knowlege into motor
260: memory.
261: (There are equivalent usability principles in usability, as well; look
262: up Fitt's Law, for instance.) Three, they all basically do the same thing;
263: pick up an unfamiliar TV control and you at least know in advance there
264: will be numbers for channel changing, vol up and down, chan up and down,
265: mute, etc.
266: The remotes used in this system do not have any of these properties.
267: Remotes are actually horrid UI, because they are very, very difficult to
268: learn; they make up for it by being useful and persistent.
269: \layout Comment
270:
271: Further, remotes should *do* things.
272: This remote is like a remote that no matter what button you push, it invokes
273: a menu.
274: Most remotes have
275: \series bold
276: one
277: \series default
278: explicit
279: \begin_inset Quotes eld
280: \end_inset
281:
282: menu
283: \begin_inset Quotes erd
284: \end_inset
285:
286: button to invoke a menu that has all the feature that aren't worth valuable
287: remote control space.
288: \layout Comment
289:
290: In fact, the metaphor is so unsuccessful that any moderately savvy internet
291: user will almost immediately come to conceptualize the remote as just another
292: list of links, albiet a clumsy and inconvenient one.
293: Why not give them that in the first place?
294: \layout Comment
295:
296: \SpecialChar ~
297:
298: \layout Comment
299:
300: 2.
301: Even the simplest
302: \begin_inset Quotes eld
303: \end_inset
304:
305: remote
306: \begin_inset Quotes erd
307: \end_inset
308:
309: I see in the tutorial has eight buttons, which nearly immediately becomes
310: seventeen (!) buttons, all incomprehensible, and I didn't get a chance
311: to count during the interview, but I saw a remote flash by (student remote?
312: admin remote? that wouldn't matter as much) that had at least twenty, probably
313: 24 buttons, again, all or nearly all incomprehensible.
314: This is needlessly intimidating.
315: \layout Comment
316:
317: \SpecialChar ~
318:
319: \layout Comment
320:
321: 3.
322: By commiting to this
323: \begin_inset Quotes eld
324: \end_inset
325:
326: remote control
327: \begin_inset Quotes erd
328: \end_inset
329:
330: layout, you commit to a remote control's layout limitations, except that
331: an actual remote control can get away with a 6pt or smaller font, or wierd
332: specialized symbols, or whatnot.
333: I'm looking at a (real) remote control right now that manages to get
334: \begin_inset Quotes eld
335: \end_inset
336:
337: channel return
338: \begin_inset Quotes erd
339: \end_inset
340:
341: onto one button.
342: That whole phrase fits *twice* into the space the
343: \begin_inset Quotes eld
344: \end_inset
345:
346: ROLES
347: \begin_inset Quotes erd
348: \end_inset
349:
350: button takes up on my printout! So in actuality, you're commiting to something
351: no sane remote control designer could deal with.
352: \layout Comment
353:
354: \SpecialChar ~
355:
356: \layout Comment
357:
358: 4.
359: Requiring the user to mouse over something to see what it does is not a
360: solution.
361: Limiting yourself to an 8 by 2 array of characters to explain yourself
362: compounds the problem even more.
363: (Another over-literal extension of the remote control metaphor.) Also, as
364: you may have observed, the accessibility of this is nil.
365:
366: \layout Comment
367:
368: \SpecialChar ~
369:
370: \layout Comment
371:
372: The upshot is that the only upside to the remote control is a moderately
373: pleasing graphic; the downsides are pretty much everything, up to and including
374: possible illegality under accessability laws.
375: Unfortunately, I do not see any way to salvage any aspect of the remote
376: control; it's going to suck until it's replaced.
377: Pleasing graphics are relatively easy to come by nowadays; it should not
378: drive the design.
379: I'll admit (freely!) I'm not a graphics designer...
380: graphics designers aren't web developers (designers), either.
381: \layout Comment
382:
383: \SpecialChar ~
384:
385: \layout Comment
386:
1.3 ! bowersj2 387: We're data-mining the web logs to see what people actually use.
1.1 bowersj2 388: This is good.
389: We may need to do some really simple stuff before he finishes.
390: Raw statistics on what buttons are pressed most often can probably be interpret
391: ed easily enough for our purposes.
392: No matter what the final design is, it should emphasize the two or three
393: commands used day in and day out, as determined by empirical analysis,
394: and shuffle the other commands onto another sub menu or sub menus.
395: Then, use the additional space you'll have (even if you keep the same size
396: window) and actually *spell out* the options.
397:
398: \layout Standard
399:
400: The Author Remote Control, show in figure
401: \begin_inset LatexCommand \ref{Author Remote Control Figure}
402:
403: \end_inset
404:
405: , will automatically load whenever you log in to LON-CAPA as the course
406: instructor.
407: The Author Remote Control is a separate window in your browser, so you
408: may position it on the screen where you can make the best use of it.
409: The Remote Control is a tool that allows you to switch between functions
410: and roles within LON-CAPA.
1.2 bowersj2 411:
1.1 bowersj2 412: \begin_float fig
1.2 bowersj2 413: \layout Standard
414: \align center
1.1 bowersj2 415:
1.2 bowersj2 416: \begin_inset Figure size 177 420
417: file authorRemote.eps
418: height 3 50
419: flags 9
1.1 bowersj2 420:
421: \end_inset
422:
423:
1.2 bowersj2 424: \layout Caption
1.1 bowersj2 425:
1.2 bowersj2 426: Author Remote Control
427: \begin_inset LatexCommand \label{Author Remote Control Figure}
1.1 bowersj2 428:
429: \end_inset
430:
431:
432: \end_float
1.2 bowersj2 433: \layout Comment
434:
1.1 bowersj2 435: Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any*
436: sort of sense on a first glance.
437: Abbreviations are evil in this sort of application and should be used as
438: a truly last resort.
439: \layout Standard
440:
441: When you move your mouse over the buttons in the remote, the sixteen gray
442: boxes will show a reminder of what that button does.
443: \layout Itemize
444:
445:
446: \series bold
447: ROLES (CHOOSE ROLE)
448: \series default
449: allows you to select which user role to assume for this session.
450: \layout Itemize
451:
452:
453: \series bold
454: COM (COMMUNICATION)
455: \series default
456: allows you to access the communication functions in the system.
457: \layout Itemize
458:
459:
460: \series bold
461: CUSR (USER ROLES)
462: \series default
463: brings up a page that allows you to create new users and change user privileges.
464: \layout Itemize
465:
466:
467: \series bold
468: CSTR (CONSTRUCT)
469: \series default
470: displays the construction space for your account.
471: \layout Itemize
472:
473:
474: \series bold
475: RES (RESOURCE SPACE)
476: \series default
477: allows you to browse the LON-CAPA network directory.
478: \layout Itemize
479:
480:
481: \series bold
482: EGRD (ENTER GRADES)
483: \series default
484: is used to enter grades for students enrolled in your course.
485: \layout Itemize
486:
487:
488: \series bold
489: SRC (SEARCH LIBRARY)
490: \series default
491: brings up a screen that lets you search the LON-CAPA resources using multiple
492: criteria.
493: \layout Itemize
494:
495:
496: \series bold
497: LOGOUT (LOGOUT)
498: \series default
499: will log you out of the LON-CAPA system.
500: \layout Section
501:
502: Creating Content Using LON-CAPA
503: \layout Standard
504:
505: LON-CAPA provides three types of resources for organizing your course website.
506: LON-CAPA refers to these resources as Content Pages, Problems, and Maps.
507: Maps may be either of two types: Sequences or Pages.
508: You will use these LON-CAPA resources to build the outline, or structure,
509: for the presentation of your course to your students.
510: \layout Itemize
511:
512: A
513: \series bold
514: Content Page
515: \series default
516:
517: \begin_inset LatexCommand \index{Content Page}
518:
519: \end_inset
520:
521: displays course content.
1.3 ! bowersj2 522: It is essentially a conventional HTML page.
1.1 bowersj2 523:
524: \layout Comment
525:
526: Check this; is it exactly like HTML pages?
527: \layout Itemize
528:
529: A
530: \series bold
531: Problem
532: \series default
533:
534: \begin_inset LatexCommand \index{Problem}
535:
536: \end_inset
537:
538: resource represents problems for the students to solve, with answers stored
539: in the system.
540: These resources are stored in files that must use the extension
541: \begin_inset Quotes eld
542: \end_inset
543:
544: .problem
545: \begin_inset Quotes erd
546: \end_inset
547:
548: .
549: \layout Itemize
550:
551: A
552: \series bold
553: Map
554: \series default
555:
556: \begin_inset LatexCommand \index{Map}
557:
558: \end_inset
559:
560: resource of the
561: \series bold
562: Sequence
563: \begin_inset LatexCommand \index{Sequence}
564:
565: \end_inset
566:
567:
568: \series default
569: type represents a programmed series of events.
1.3 ! bowersj2 570: The users of this resource can use buttons on their remote or the NAV button
! 571: to follow the sequence.
1.1 bowersj2 572: These resources are stored in files that must use the extension
573: \begin_inset Quotes eld
574: \end_inset
575:
576: .sequence
577: \begin_inset Quotes erd
578: \end_inset
579:
580: .
581: \layout Comment
582:
583: What
584: \begin_inset Quotes eld
585: \end_inset
586:
587: arrow keys
588: \begin_inset Quotes erd
589: \end_inset
590:
591: ? Surely not the ones on the keyboard\SpecialChar \ldots{}
592:
593: \layout Itemize
594:
595: A
596: \series bold
597: Map
598: \series default
599:
600: \begin_inset LatexCommand \index{Map}
601:
602: \end_inset
603:
604: resource of the
605: \series bold
606: Page
607: \series default
608:
609: \begin_inset LatexCommand \index{Page}
610:
611: \end_inset
612:
613: type display multiple resources together.
614: For example, a page of problems will appears as a problem set.
615: These resources are stored in files that must use the extension
616: \begin_inset Quotes eld
617: \end_inset
618:
619: .page
620: \begin_inset Quotes erd
621: \end_inset
622:
623: .
624: \layout Subsection
625:
626: Description of the Construction Space
627: \layout Standard
628:
629: \begin_float fig
1.2 bowersj2 630: \layout Standard
631: \align center
632:
633: \begin_inset Figure size 476 42
634: file constructionSpace.eps
635: width 3 80
636: flags 9
637:
638: \end_inset
639:
640:
1.1 bowersj2 641: \layout Caption
642:
643: Construction Space
644: \begin_inset LatexCommand \label{Construction Space Figure}
645:
646: \end_inset
647:
648:
649: \end_float
650: The Construction Space, as seen in figure
651: \begin_inset LatexCommand \ref{Construction Space Figure}
652:
653: \end_inset
654:
655: , is the section of LON-CAPA where you create and manage your course resources.
656: The Construction Space consists of a green tool bar at the top of the page
657: and a list of all directories and resources below.
658: \layout Standard
659:
660:
661: \begin_inset Tabular
662: <lyxtabular version="2" rows="10" columns="2">
663: <features rotate="false" islongtable="true" endhead="0" endfirsthead="0" endfoot="0" endlastfoot="0">
664: <column alignment="center" valignment="top" leftline="true" rightline="false" width="" special="">
665: <column alignment="left" valignment="top" leftline="true" rightline="true" width="5in" special="">
666: <row topline="true" bottomline="true" newpage="false">
667: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
668: \begin_inset Text
669:
670: \layout Standard
671:
672:
673: \series bold
674: Button Name
675: \end_inset
676: </cell>
677: <cell multicolumn="0" alignment="left" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
678: \begin_inset Text
679:
680: \layout Standard
681:
682:
683: \series bold
684: Description
685: \end_inset
686: </cell>
687: </row>
688: <row topline="true" bottomline="false" newpage="false">
689: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
690: \begin_inset Text
691:
692: \layout Standard
693:
694: Publish this Resource
695: \end_inset
696: </cell>
697: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
698: \begin_inset Text
699:
700: \layout Standard
701:
1.2 bowersj2 702: Opens the Resource Publishing window.
1.1 bowersj2 703: \end_inset
704: </cell>
705: </row>
706: <row topline="true" bottomline="false" newpage="false">
707: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
708: \begin_inset Text
709:
710: \layout Standard
711:
712: List Directory
713: \end_inset
714: </cell>
715: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
716: \begin_inset Text
717:
718: \layout Standard
719:
720: Lists the contents of the current working directory
721: \end_inset
722: </cell>
723: </row>
724: <row topline="true" bottomline="false" newpage="false">
725: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
726: \begin_inset Text
727:
728: \layout Standard
729:
730: Copy
731: \end_inset
732: </cell>
733: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
734: \begin_inset Text
735:
736: \layout Standard
737:
738: Type a new name in the entry box to make a copy the current resource
739: \end_inset
740: </cell>
741: </row>
742: <row topline="true" bottomline="false" newpage="false">
743: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
744: \begin_inset Text
745:
746: \layout Standard
747:
748: Browse
749: \end_inset
750: </cell>
751: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
752: \begin_inset Text
753:
754: \layout Standard
755:
1.2 bowersj2 756: Helps you select a file to upload
1.1 bowersj2 757: \end_inset
758: </cell>
759: </row>
760: <row topline="true" bottomline="false" newpage="false">
761: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
762: \begin_inset Text
763:
764: \layout Standard
765:
766: Upload File
767: \end_inset
768: </cell>
769: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
770: \begin_inset Text
771:
772: \layout Standard
773:
774: Uploads the selected file to your Construction Space
775: \end_inset
776: </cell>
777: </row>
778: <row topline="true" bottomline="false" newpage="false">
779: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
780: \begin_inset Text
781:
782: \layout Standard
783:
784: Retrieve Old Version
785: \end_inset
786: </cell>
787: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
788: \begin_inset Text
789:
790: \layout Standard
791:
792: Load an older version of a resource if you have multiple versions
793: \end_inset
794: </cell>
795: </row>
796: <row topline="true" bottomline="false" newpage="false">
797: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
798: \begin_inset Text
799:
800: \layout Standard
801:
802: Delete
803: \end_inset
804: </cell>
805: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
806: \begin_inset Text
807:
808: \layout Standard
809:
810: Deletes the current resource
811: \end_inset
812: </cell>
813: </row>
814: <row topline="true" bottomline="false" newpage="false">
815: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
816: \begin_inset Text
817:
818: \layout Standard
819:
820: Rename
821: \end_inset
822: </cell>
823: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
824: \begin_inset Text
825:
826: \layout Standard
827:
828: Type a new name in the associated entry box to rename a resource
829: \end_inset
830: </cell>
831: </row>
832: <row topline="true" bottomline="true" newpage="false">
833: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
834: \begin_inset Text
835:
836: \layout Standard
837:
838: New Subdirectory
839: \end_inset
840: </cell>
841: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
842: \begin_inset Text
843:
844: \layout Standard
845:
846: Type a name in the entry box to create a new directory
847: \end_inset
848: </cell>
849: </row>
850: </lyxtabular>
851:
852: \end_inset
853:
854:
855: \layout Subsection
856:
857: How to Create New Content Pages
1.2 bowersj2 858: \begin_inset LatexCommand \label{Creating New Content Pages}
859:
860: \end_inset
861:
862:
1.1 bowersj2 863: \layout Standard
864:
865:
866: \series bold
867: Content Pages
868: \series default
869: are HTML documents that display the course information you are presenting.
1.3 ! bowersj2 870: To create new Content Pages, do the following:
1.1 bowersj2 871: \layout Comment
872:
873: Is step one necessary? I don't see how it could be.
874: \layout Enumerate
875:
876: Click the
877: \series bold
878: CSTR
879: \series default
880: button on the LON-CAPA remote.
881: You web page will change to your Construction Space.
882: \layout Enumerate
883:
884: In Location bar of your browser, type in full URL of the new Content Page.
885: Make sure the last part of the URL ends with
886: \begin_inset Quotes eld
887: \end_inset
888:
889: .html
890: \begin_inset Quotes erd
891: \end_inset
892:
893: , for example,
894: \emph on
1.2 bowersj2 895: http://www.s10.lite.msu.edu/priv/\SpecialChar \-
896: directory/new_resource.html
1.1 bowersj2 897: \emph default
898: .
899: Press the Return or Enter key.
900: \layout Enumerate
901:
902: You should see something like the following message:
903: \series bold
1.2 bowersj2 904: File not found: /home/wmsonj/priv/\SpecialChar \-
905: directory/new_resource.html
1.1 bowersj2 906: \series default
907: , and an Edit button.
1.2 bowersj2 908: Click the
909: \begin_inset Quotes eld
910: \end_inset
911:
912: Edit
913: \begin_inset Quotes erd
914: \end_inset
915:
916: button, and an HTML editor will open with a simple page template.
1.1 bowersj2 917: \layout Enumerate
918:
919: Type the content into the editor,
1.2 bowersj2 920: \emph on
1.1 bowersj2 921: OR
1.2 bowersj2 922: \emph default
1.1 bowersj2 923: copy and paste HTML source code into the editor.
924: \layout Enumerate
925:
926: Optionally, click the
927: \series bold
928: View
929: \series default
930: button to preview your Content Page.
931: \layout Enumerate
932:
933: Finally, click the
934: \series bold
935: Save this
936: \series default
937: button
1.2 bowersj2 938: \emph on
1.1 bowersj2 939: OR
1.2 bowersj2 940: \emph default
1.1 bowersj2 941: click the
942: \series bold
943: Save and then attempt to clean HTML
944: \series default
945: button.
946: \layout Standard
947:
948: Repeat this process as many times as necessary to create your Content Pages.
1.3 ! bowersj2 949:
! 950: \layout Standard
! 951:
! 952: If you're following this as a tutorial, create at least one content page,
! 953: which we'll use later as raw material.
1.1 bowersj2 954: \layout Subsection
955:
956: How to Edit Existing Content Pages
957: \layout Standard
958:
959: You may edit any any Content Pages that have been created.
960: \layout Standard
961:
962: To edit Content Pages:
963: \layout Enumerate
964:
965: Click the
966: \series bold
967: CSTR
968: \series default
969: button on the LON-CAPA Remote.
970: Your web page will change to your Construction Space.
971: \layout Enumerate
972:
973: Click on the link for the name of the Content Page to edit.
974: The Content Page editor will load and display the current edition of the
975: Content Page.
976: \layout Enumerate
977:
978: Press the Edit button.
979: Edit the HTML code, or copy and paste HTML source code into the editor.
980: \layout Enumerate
981:
982: Optionally, click the
983: \series bold
984: View
985: \series default
986: button to preview your Content Page.
987: \layout Enumerate
988:
989: Finally, click the
990: \series bold
991: Save this
992: \series default
993: button
1.2 bowersj2 994: \emph on
1.1 bowersj2 995: OR
1.2 bowersj2 996: \emph default
1.1 bowersj2 997: click the
998: \series bold
999: Save and then attempt to clean HTML
1000: \series default
1001: button.
1002: If you do not do this, your work will not be saved.
1003: \layout Subsection
1004:
1005: Creating Online Problems Using LON-CAPA
1.3 ! bowersj2 1006: \layout Standard
! 1007:
! 1008: If you're following this as a tutorial, go ahead and make one of each of
! 1009: these problem types now.
! 1010: We'll be using them later as raw material to assemble maps and sequences.
1.1 bowersj2 1011: \layout Subsubsection
1012:
1013: Problems Types
1014: \layout Standard
1015:
1016: There are five types of problems that can be created with the LON-CAPA system:
1017: Radio Response, Option Response, String Response, Numerical Response, and
1018: Formula Response.
1019: You will need to identify which types of problem you want to use and create
1020: appropriate questions for your course.
1021: \layout Subsubsection
1022:
1.2 bowersj2 1023: Foils
1024: \layout Standard
1025:
1026: In the LON-CAPA system, a
1027: \series bold
1028: Foil
1029: \begin_inset LatexCommand \index{Foil}
1030:
1031: \end_inset
1032:
1033:
1034: \series default
1035: is a choice in a Radio Response or Option Response problem.
1036: For instance, True/False problems have two foils, one for True, and one
1037: for False.
1038: Foils do not need to be text; they can be images or other resources.
1039: \layout Subsubsection
1040:
1.1 bowersj2 1041: Radio Response
1042: \begin_inset LatexCommand \index{Radio Response}
1043:
1044: \end_inset
1045:
1046: Problems
1047: \layout Standard
1048:
1.2 bowersj2 1049:
1050: \series bold
1051: Radio Response
1052: \series default
1053: problems represent multiple choice questions.
1054: A True/False problem is a special case of Radio Response problem with two
1055: foils, True or False.
1.1 bowersj2 1056: \layout Standard
1057:
1.2 bowersj2 1058: Multiple choice problems contain between 3 and 10 foils.
1059: You may display from three to five foils for each problem and the system
1060: randomly picks the choices that are presented to the student.
1061: \layout Comment
1062:
1063: Eh? If this means what I think it means, clarify.
1064: Is the system really incapable of showing eight choices all at once?
1065: \layout Subsubsection
1066:
1067: Option Response
1068: \begin_inset LatexCommand \index{Option Response}
1.1 bowersj2 1069:
1.2 bowersj2 1070: \end_inset
1.1 bowersj2 1071:
1.2 bowersj2 1072: Problems
1.1 bowersj2 1073: \layout Standard
1074:
1075: Option Response problems present foils to the student with drop-down boxes.
1.2 bowersj2 1076: A group of foils is created for each concept group, and the system will
1077: pick one to present to the student from each group.
1078: The student must match each of his or her questions correctly to the possible
1079: answers before receiving credit for the problem.
1080: For more details, see the Create Option Response (
1081: \begin_inset LatexCommand \ref{Create Option Response Problem}
1082:
1083: \end_inset
1084:
1085: ).
1086: \layout Subsubsection
1.1 bowersj2 1087:
1088: String Response Problems
1089: \layout Standard
1090:
1.2 bowersj2 1091:
1092: \series bold
1093:
1094: \begin_inset LatexCommand \index{String Response}
1095:
1096: \end_inset
1097:
1098: String Response
1099: \series default
1100: problems are problems in which the student submits a string of characters
1101: for the answer.
1.1 bowersj2 1102: Examples of string response questions are vocabulary tests, short answer
1103: and entering chemical formulas.
1104: \layout Standard
1105:
1.2 bowersj2 1106: Note that it is easy to abuse String Response problems.
1107: For instance, consider the question
1108: \begin_inset Quotes eld
1109: \end_inset
1110:
1111: Who wrote 'Huckleberry Finn'?
1112: \begin_inset Quotes erd
1113: \end_inset
1114:
1115: If you tell the system the answer is
1116: \begin_inset Quotes eld
1117: \end_inset
1118:
1119: Mark Twain
1120: \begin_inset Quotes erd
1121: \end_inset
1122:
1123: , and a student answers
1124: \begin_inset Quotes eld
1125: \end_inset
1126:
1127: Twain
1128: \begin_inset Quotes erd
1129: \end_inset
1130:
1131: , the system will mark it wrong.
1132: If they answer
1133: \begin_inset Quotes eld
1134: \end_inset
1135:
1136: Samuel Clements
1137: \begin_inset Quotes erd
1138: \end_inset
1139:
1140: , then the student will definately get it wrong.
1141: There is some room for flexibility in the string processing, but it can
1142: be difficult to get it all right.
1143: Before you use a String Response problem, be sure you can easily characterize
1144: correct answers.
1145: \layout Subsubsection
1146:
1.1 bowersj2 1147: Numerical Response Problems
1148: \layout Standard
1149:
1.2 bowersj2 1150:
1151: \series bold
1152: Numerical Response
1153: \begin_inset LatexCommand \index{Numerical Response}
1154:
1155: \end_inset
1156:
1157:
1158: \series default
1159: problems are answered by entering a number and (optionally) a unit, such
1160: as 2.5 m/s^2.
1.1 bowersj2 1161: Tolerance and significant digits can be specified as well.
1.2 bowersj2 1162: \layout Subsubsection
1.1 bowersj2 1163:
1164: Formula Response Problems
1165: \layout Standard
1166:
1167: Formula Response problems are questions in which the student types in a
1168: math formula for the answer.
1.2 bowersj2 1169: If the answer is
1170: \begin_inset Formula \( x^{2}-11 \)
1171: \end_inset
1172:
1173: , the student can enter "x^2 - 11", "x*x - 11", "x^2 + 21 - 10", etc.
1.1 bowersj2 1174: Functions such as cos, sin, and exp are accepted as well as the operators
1175: (), +, -, *, and /.
1.2 bowersj2 1176: \layout Subsection
1177:
1178: Creating Radio Response Problems
1179: \layout Standard
1.1 bowersj2 1180:
1.2 bowersj2 1181: \begin_float fig
1.1 bowersj2 1182: \layout Standard
1.2 bowersj2 1183: \align center
1184:
1185: \begin_inset Figure size 476 201
1186: file creatingNewProblemResource.eps
1187: width 3 80
1188: flags 13
1189:
1190: \end_inset
1191:
1192:
1193: \layout Caption
1194:
1195: Creating A New Problem Resource
1196: \begin_inset LatexCommand \label{Creating a new problem resource}
1197:
1198: \end_inset
1199:
1200:
1201: \end_float
1202: To create an Radio Response
1203: \begin_inset LatexCommand \index{Radio Response}
1204:
1205: \end_inset
1206:
1207: problem, create a new resource as described in section
1208: \begin_inset LatexCommand \ref{Creating New Content Pages}
1209:
1210: \end_inset
1211:
1212: .
1213: This is a
1214: \begin_inset Quotes eld
1215: \end_inset
1216:
1217: problem
1218: \begin_inset Quotes erd
1219: \end_inset
1220:
1221: resource so the URL must end in
1222: \begin_inset Quotes eld
1223: \end_inset
1224:
1225: .problem
1226: \begin_inset Quotes erd
1227: \end_inset
1228:
1229: .
1230: You should see a screen as in figure
1231: \begin_inset LatexCommand \ref{Creating a new problem resource}
1232:
1233: \end_inset
1.1 bowersj2 1234:
1.2 bowersj2 1235: .
1.1 bowersj2 1236: \begin_float fig
1.2 bowersj2 1237: \layout Standard
1238: \align center
1239:
1240: \begin_inset Figure size 476 283
1241: file radioResponse2.eps
1242: width 3 80
1243: flags 9
1244:
1245: \end_inset
1246:
1247:
1.1 bowersj2 1248: \layout Caption
1249:
1.2 bowersj2 1250: Radio Response Creation Form
1251: \begin_inset LatexCommand \label{Radio Response Creation Form}
1.1 bowersj2 1252:
1253: \end_inset
1254:
1255:
1256: \end_float
1.2 bowersj2 1257: You will need to create the posible answers and the questions.
1258: \layout Enumerate
1259:
1260: In the drop-down option box as seen in
1261: \begin_inset LatexCommand \ref{Creating a new problem resource}
1.1 bowersj2 1262:
1.2 bowersj2 1263: \end_inset
1.1 bowersj2 1264:
1.2 bowersj2 1265: , select
1266: \series bold
1267: Radio Response Problem
1268: \series default
1269: , and click the
1.1 bowersj2 1270: \series bold
1.2 bowersj2 1271: New Problem
1.1 bowersj2 1272: \series default
1.2 bowersj2 1273: button.
1274: \layout Enumerate
1.1 bowersj2 1275:
1.2 bowersj2 1276: Click the
1.1 bowersj2 1277: \series bold
1.2 bowersj2 1278: Edit
1.1 bowersj2 1279: \series default
1.2 bowersj2 1280: button above the sample problem to enter edit mode.
1281: \layout Enumerate
1.1 bowersj2 1282:
1.2 bowersj2 1283: In the
1.1 bowersj2 1284: \series bold
1.2 bowersj2 1285: Text Block
1.1 bowersj2 1286: \series default
1.2 bowersj2 1287: at the top of the problem, remove the sample text and type the question
1288: for your problem.
1289: For example,
1290: \begin_inset Quotes eld
1291: \end_inset
1.1 bowersj2 1292:
1.2 bowersj2 1293: What is two plus two?
1294: \begin_inset Quotes erd
1295: \end_inset
1.1 bowersj2 1296:
1297:
1.2 bowersj2 1298: \layout Enumerate
1.1 bowersj2 1299:
1.2 bowersj2 1300: Locate the
1.1 bowersj2 1301: \series bold
1.2 bowersj2 1302: Response: One of N statements
1.1 bowersj2 1303: \series default
1.2 bowersj2 1304: element.
1305: In the
1.1 bowersj2 1306: \series bold
1.2 bowersj2 1307: Max Number of Shown Foils
1.1 bowersj2 1308: \series default
1.2 bowersj2 1309: text box, place the number of wrong answers you wish to supply to each
1310: student, in addition to the correct one.
1311: For instance, if you want to display four choices, where one is correct
1312: and three are incorrect, enter
1313: \begin_inset Quotes eld
1314: \end_inset
1315:
1316: 3
1317: \begin_inset Quotes erd
1318: \end_inset
1.1 bowersj2 1319:
1.2 bowersj2 1320: into this box.
1321: \layout Enumerate
1.1 bowersj2 1322:
1.2 bowersj2 1323: Locate
1.1 bowersj2 1324: \series bold
1.2 bowersj2 1325: Foil 1
1326: \series default
1327: .
1328: Remove the text that is in the text box and put the
1329: \emph on
1330: correct answer
1331: \emph default
1332: for the problem in the
1333: \series bold
1334: Text Block
1335: \series default
1336: .
1337: For example,
1338: \begin_inset Quotes eld
1339: \end_inset
1340:
1341: Four.
1342: \begin_inset Quotes erd
1343: \end_inset
1344:
1345:
1346: \layout Enumerate
1347:
1348: Below it, you will see
1349: \series bold
1350: Foil 2
1351: \series default
1352: .
1353: Remove the text in the text box and put an
1354: \emph on
1355: incorrect answer
1356: \emph default
1357: for the problem.
1358: For instance,
1359: \begin_inset Quotes eld
1360: \end_inset
1361:
1362: Purple.
1363: \begin_inset Quotes erd
1364: \end_inset
1365:
1366:
1367: \layout Enumerate
1368:
1369: Repeat the previous step until you've filled in all of the other incorrect
1370: answers you wish to offer the students.
1371: \layout Enumerate
1372:
1373: Once you've filled in all the incorrect answers, change the
1374: \series bold
1375: Correct Option
1376: \series default
1377: s on the other foils to
1378: \series bold
1379: Unused
1380: \series default
1381: .
1382: \layout Enumerate
1383:
1384: \begin_float fig
1385: \layout Standard
1386: \align center
1387:
1388: \begin_inset Figure size 476 92
1389: file radioResponseHint.eps
1390: width 3 80
1391: flags 9
1392:
1393: \end_inset
1394:
1395:
1396: \layout Caption
1397:
1398: Hint Element
1399: \begin_inset LatexCommand \label{Radio Response Hint Element Figure}
1400:
1401: \end_inset
1402:
1403:
1404: \end_float
1405: Scroll down to the Hint element, as shown in Figure
1406: \begin_inset LatexCommand \ref{Radio Response Hint Element Figure}
1407:
1408: \end_inset
1409:
1410: .
1411: Type some text that will help students when they answer incorrectly.
1412: \layout Enumerate
1413:
1414: Click the
1415: \series bold
1416: Submit Changes
1417: \series default
1418: button located at the top of the frame.
1419: If you do not do this, none of your changes will be saved.
1420: \layout Standard
1421:
1422: The
1423: \series bold
1424: Correct Option
1425: \series default
1426: drop down box controls whether or not a given answer will be accepted as
1427: a correct answer.
1428: If it is set to
1429: \series bold
1430: true
1431: \series default
1432: , that answer will be considered a correct answer.
1433: Any number of foils can be marked
1434: \series bold
1435: true
1436: \series default
1437: , so you can have questions with multiple correct answers.
1438: If it is set to
1439: \series bold
1440: false
1441: \series default
1442: , it will be considered an incorrect answer.
1443: If it is set to
1444: \series bold
1445: Unused
1446: \series default
1447: , the system will not use that foil.
1448: \layout Paragraph
1449:
1450: Randomization
1451: \begin_inset LatexCommand \index{Randomization}
1452:
1453: \end_inset
1454:
1455:
1456: \layout Standard
1457:
1458: LON-CAPA will randomize what choices are presented to each student, and
1459: randomize the order they are presented in.
1460: If you wish to present each student the same choices, make sure the
1461: \series bold
1462: Maximum Number of Shown Foils
1463: \series default
1464: box contains the number of incorrect answers, which will force them to
1465: all be displayed.
1466: If you wish to force the system to display the foils in the order you have
1467: created them in, type the HTML tag
1468: \series bold
1469: <norandom>
1470: \series default
1471: into your problem text.
1472: This can be useful with the ever-popular
1473: \begin_inset Quotes eld
1474: \end_inset
1475:
1476: All of the above
1477: \begin_inset Quotes erd
1478: \end_inset
1479:
1480: choice, which must be displayed in the correct place or its meaning will
1481: change.
1482: \layout Subsubsection
1483:
1484: True/False
1485: \begin_inset LatexCommand \index{True/False Problem}
1486:
1487: \end_inset
1488:
1489: Problem
1490: \layout Standard
1491:
1492: A True/False problem is a Radio Response problem with two choices, True
1493: and False.
1494: set the
1495: \series bold
1496: Maximum Number of Shown Foils
1497: \series default
1498: to
1499: \begin_inset Quotes eld
1500: \end_inset
1501:
1502: 1
1503: \begin_inset Quotes erd
1504: \end_inset
1505:
1506: , and mark the correct answer
1507: \series bold
1508: true
1509: \series default
1510: .
1511: For example, for the True/False question
1512: \begin_inset Quotes eld
1513: \end_inset
1514:
1515: Napolean conquered Japan in the year 189 A.D.
1516: \begin_inset Quotes erd
1517: \end_inset
1518:
1519: , mark the foil containing the answer
1520: \begin_inset Quotes eld
1521: \end_inset
1522:
1523: False
1524: \begin_inset Quotes erd
1525: \end_inset
1526:
1527: as
1528: \series bold
1529: true
1530: \series default
1531: , because it is the correct answer.
1532: \layout Subsection
1533:
1534: Option Response
1535: \begin_inset LatexCommand \index{Option Response}
1536:
1537: \end_inset
1538:
1539:
1540: \begin_inset LatexCommand \label{Create Option Response Problem}
1541:
1542: \end_inset
1543:
1544: Problems
1545: \layout Standard
1546:
1547: \begin_float fig
1548: \layout Standard
1549: \align center
1550:
1551: \begin_inset Figure size 476 280
1552: file optionResponseProblem.eps
1553: width 3 80
1554: flags 9
1555:
1556: \end_inset
1557:
1558:
1559: \layout Caption
1560:
1561: Option Response Problem
1562: \begin_inset LatexCommand \label{Option Response Problem Figure}
1563:
1564: \end_inset
1565:
1566:
1567: \end_float
1568: Each Option Response problem has three parts:
1569: \layout Enumerate
1570:
1571: The Concept Groups
1572: \begin_inset LatexCommand \index{Concept Groups}
1573:
1574: \end_inset
1575:
1576:
1577: \layout Enumerate
1578:
1579: The options for the students to select, by default
1580: \begin_inset Quotes eld
1581: \end_inset
1582:
1583: True
1584: \begin_inset Quotes erd
1585: \end_inset
1586:
1587: and
1588: \begin_inset Quotes eld
1589: \end_inset
1590:
1591: False
1592: \begin_inset Quotes erd
1593: \end_inset
1594:
1595:
1596: \layout Enumerate
1597:
1598: The hint for the student
1599: \layout Standard
1600:
1601: Each
1602: \series bold
1603: Concept Group
1604: \series default
1605: has some number of foils representing questions which are conceptually
1606: related.
1607: Option Response Problems can have between 4 and 8 Concept Groups in a problem.
1608: When the Option Response problem is presented to a student, the LON-CAPA
1609: system will randomly select one foil from each Concept Group and present
1610: it to the student.
1611: In order to receive credit for the problem, the student must answer all
1612: of the Concept Group foils correctly.
1613: \layout Subsubsection
1614:
1615: Example: Concept Group
1616: \layout Standard
1617:
1618: For example, a Concept Group may contain the following True/False questions:
1619: \layout Itemize
1620:
1621:
1622: \begin_inset Quotes eld
1623: \end_inset
1624:
1625: Mark Twain
1626: \begin_inset Quotes erd
1627: \end_inset
1628:
1629: is the pen name of Samuel Clemens.
1630: \layout Itemize
1631:
1632: Mark Twain wrote
1633: \begin_inset Quotes eld
1634: \end_inset
1635:
1636: The Call of the Wild
1637: \begin_inset Quotes erd
1638: \end_inset
1639:
1640: .
1641: \layout Itemize
1642:
1643: Mark Twain wrote
1644: \begin_inset Quotes eld
1645: \end_inset
1646:
1647: Huckleberry Finn
1648: \begin_inset Quotes erd
1649: \end_inset
1650:
1651: .
1652: \layout Itemize
1653:
1654: Mark Twain spent most of his life in the Congo.
1655: \layout Standard
1656:
1657: For each foil, the author marks it True or False.
1658: When the student logs on and attempts to answer this question, the student
1659: will see only one of the four choices for that concept group.
1660: They then go on to do the remaining three to seven Concept Groups in this
1661: question before submitting their answer.
1662: \layout Subsubsection
1663:
1664: Example: Matching Problem
1665: \layout Standard
1666:
1667: You might want to ask the student to match musical compositions with their
1668: composers.
1669: You could create an Option Response problem with 4 Concept Groups, and
1.3 ! bowersj2 1670: place the following four things each in their own concept group:
1.2 bowersj2 1671: \layout Itemize
1672:
1673: Claire de Lune
1.3 ! bowersj2 1674: \begin_inset LatexCommand \index{Clair de Lune}
! 1675:
! 1676: \end_inset
! 1677:
! 1678:
1.2 bowersj2 1679: \begin_float footnote
1680: \layout Standard
1681:
1682: Debussy.
1683: \end_float
1684: \layout Itemize
1685:
1686: The Pastoral Symphony
1687: \begin_float footnote
1688: \layout Standard
1689:
1690: Beethoven's Sixth Symphony.
1691: \end_float
1692: \layout Itemize
1693:
1694: Sleeping Beauty Suite
1695: \begin_float footnote
1696: \layout Standard
1697:
1698: Tchaikovsky.
1699: \end_float
1700: \layout Itemize
1701:
1702: The Dance of the Sugar Plum Fairies
1703: \begin_float footnote
1704: \layout Standard
1705:
1706: Also Tchaikovsky, from The Nutcracker.
1707: \end_float
1708: \layout Standard
1709:
1710: You could then add the following options to the option list:
1711: \layout Itemize
1712:
1713: Debussy
1714: \layout Itemize
1715:
1716: Beethoven
1717: \layout Itemize
1718:
1719: Schubert
1720: \layout Itemize
1721:
1722: Tchaikovsky
1723: \layout Itemize
1724:
1725: Bach
1726: \layout Standard
1727:
1728: The same answers can be used more then once, or not at all, as you see fit.
1729: It is conventional to place such a warning in the
1730: \series bold
1731: Text Block
1732: \series default
1733: describing the problem to the students.
1734: \layout Subsubsection
1735:
1736: Creating Option Response Problems
1737: \layout Standard
1738:
1739: To create an Option Response problem, create a new resource as described
1740: in section
1741: \begin_inset LatexCommand \ref{Creating New Content Pages}
1742:
1743: \end_inset
1744:
1745: .
1746: This is a
1747: \begin_inset Quotes eld
1748: \end_inset
1749:
1750: problem
1751: \begin_inset Quotes erd
1752: \end_inset
1753:
1754: resource so the URL must end in
1755: \begin_inset Quotes eld
1756: \end_inset
1757:
1758: .problem
1759: \begin_inset Quotes erd
1760: \end_inset
1761:
1762: .
1763: You should see a screen as in figure
1764: \begin_inset LatexCommand \ref{Creating a new problem resource}
1765:
1766: \end_inset
1767:
1768: .
1769: \layout Enumerate
1770:
1771: In the drop-down option box as seen in
1772: \begin_inset LatexCommand \ref{Creating a new problem resource}
1773:
1774: \end_inset
1775:
1776: , select
1777: \series bold
1778: Option Response Problem with
1779: \emph on
1780: N
1781: \emph default
1782: Concept Groups
1783: \series default
1784: , where
1785: \series bold
1786: \emph on
1787: N
1788: \series default
1789: \emph default
1790: is the number of Concept Groups you wish the problem to have, and click
1791: the
1792: \series bold
1793: New Problem
1794: \series default
1795: button.
1796: \layout Enumerate
1797:
1798: Click the
1799: \series bold
1800: Edit
1801: \series default
1802: button above the sample problem to enter edit mode.
1803: \begin_float fig
1804: \layout Standard
1805: \align center
1806:
1807: \begin_inset Figure size 476 276
1808: file optionResponseEditing.eps
1809: width 3 80
1810: flags 9
1811:
1812: \end_inset
1813:
1814:
1815: \layout Caption
1816:
1817: Option Response Editor
1818: \begin_inset LatexCommand \label{Option Response Editor Figure}
1819:
1820: \end_inset
1821:
1822:
1823: \end_float
1824: You should see the Option Response page open up, which should look something
1825: like what you see in figure
1826: \begin_inset LatexCommand \ref{Option Response Editor Figure}
1827:
1828: \end_inset
1829:
1830: .
1831: \layout Enumerate
1832:
1833: Replace the text in the
1834: \series bold
1835: Text Block
1836: \series default
1837: with text that explains the conditions for your problem.
1838: \layout Enumerate
1839:
1840: Locate the
1841: \series bold
1842: Max Number of Shown Foils
1843: \series default
1844: element and type a number from 1 to 8 to display that number of questions.
1845: You cannot display more then one foil from each concept group, so this
1846: option will only reduce the number of foils displayed, if it is less then
1847: the number of concept groups in your Option Response problem.
1848: \layout Enumerate
1849:
1850: Now you must define the options the students can select.
1851: For each option you wish to add to the Option Response question, type the
1852: option into the
1853: \series bold
1854: Add new Option
1855: \series default
1856: box in the
1857: \series bold
1858: Select Options
1859: \series default
1860: section, then hit the
1861: \series bold
1862: Save Changes
1863: \series default
1864: button.
1865: If you do not hit the
1866: \series bold
1867: Save Changes
1868: \series default
1869: button, your option will not be selectable below.
1870: \layout Enumerate
1871:
1872: To delete the irrelevant options from the Option Response question, select
1873: that option from the
1874: \series bold
1875: Delete Option
1876: \series default
1877: dropdown, and hit the Save Changes button.
1878: Do that for each option you wish to remove.
1879: \layout Enumerate
1880:
1881: Now, you need to define the question foils.
1882: Look for the foil with the name
1883: \begin_inset Quotes eld
1884: \end_inset
1885:
1886: One
1887: \begin_inset Quotes erd
1888: \end_inset
1889:
1890: .
1891: Type the question into the text box, and select the correct option for
1892: that question from the
1893: \series bold
1894: Correct Option
1895: \series default
1896: drop-down menu.
1897: Click
1898: \series bold
1899: Submit Changes
1900: \series default
1901: to save this question foil.
1902: Repeat this step for all remaining foils.
1903: \layout Enumerate
1904:
1905: Locate the foils that are not being used.
1906: In their
1907: \series bold
1908: Delete
1909: \series default
1910: menus, set the value to
1911: \series bold
1912: Yes
1913: \series default
1914: .
1915: Once you've set the Delete menu value correctly for all the foils, click
1916: the
1917: \series bold
1918: Save Changes
1919: \series default
1920: button.
1921: \layout Enumerate
1922:
1923: In the Hint area, provide a helpful hint for users who get the problem incorrect
1924: , and click the
1925: \series bold
1926: Save Changes
1927: \series default
1928: button.
1929: \layout Subsection
1930:
1931: Creating a String Response Problem
1932: \layout Standard
1933:
1934: To create an String Response problem, create a new resource as described
1935: in section
1936: \begin_inset LatexCommand \ref{Creating New Content Pages}
1937:
1938: \end_inset
1939:
1940: .
1941: This is a
1942: \begin_inset Quotes eld
1943: \end_inset
1944:
1945: problem
1946: \begin_inset Quotes erd
1947: \end_inset
1948:
1949: resource so the URL must end in
1950: \begin_inset Quotes eld
1951: \end_inset
1952:
1953: .problem
1954: \begin_inset Quotes erd
1955: \end_inset
1956:
1957: .
1958: You should see a screen as in figure
1959: \begin_inset LatexCommand \ref{Creating a new problem resource}
1960:
1961: \end_inset
1962:
1963: .
1964: \layout Enumerate
1965:
1966: In the drop-down option box as seen in
1967: \begin_inset LatexCommand \ref{Creating a new problem resource}
1968:
1969: \end_inset
1970:
1971: , select
1972: \series bold
1973: Simple String Response Problem
1974: \series default
1975: , and click the
1976: \series bold
1977: New Problem
1978: \series default
1979: button.
1980: \layout Enumerate
1981:
1982: Click the
1983: \series bold
1984: Edit
1985: \series default
1986: button above the sample problem to enter edit mode.
1987: \begin_float fig
1988: \layout Standard
1989: \align center
1990:
1991: \begin_inset Figure size 476 320
1992: file stringResponseEditor.eps
1993: width 3 80
1994: flags 9
1995:
1996: \end_inset
1997:
1998:
1999: \layout Caption
2000:
2001: String Response Editor
2002: \begin_inset LatexCommand \label{String Response Editor Figure}
2003:
2004: \end_inset
2005:
2006:
2007: \end_float
2008: You should see the String Response editor page open up, which should look
2009: something like what you see in figure
2010: \begin_inset LatexCommand \ref{String Response Editor Figure}
2011:
2012: \end_inset
2013:
2014: .
2015: \layout Enumerate
2016:
2017: Clear the text from the Text Block at the top of the problem, and type in
2018: your problem's question.
2019: \layout Enumerate
2020:
2021: In the
2022: \series bold
2023: Answer Box
2024: \series default
2025: , type the correct answer.
2026: \layout Enumerate
2027:
2028: Select the answer condition from the drop down box.
2029: There are three cases to choose from:
2030: \begin_deeper
2031: \layout Enumerate
2032:
2033:
2034: \series bold
2035: cs
2036: \series default
2037: : This means
2038: \begin_inset Quotes eld
2039: \end_inset
2040:
2041: Case Sensitive
2042: \begin_inset Quotes erd
2043: \end_inset
2044:
2045: .
2046: For example, this is useful in Chemistry, where HO and Ho are completely
2047: different answers
2048: \begin_float footnote
2049: \end_deeper
2050: \layout Standard
2051:
2052:
2053: \series bold
2054: HO
2055: \series default
2056: is hydrogen monoxide, a colorless, odorless, poisonous gas.
2057:
2058: \series bold
2059: Ho
2060: \series default
2061: is the element 67, Holmium, in the Lanthanides.
2062: \end_float
2063: .
2064: The student must match the case of the answer.
2065: \begin_deeper
2066: \layout Enumerate
2067:
2068:
2069: \series bold
2070: ci
2071: \series default
2072: : This means
2073: \begin_inset Quotes eld
2074: \end_inset
2075:
2076: Case Insenstive
2077: \begin_inset Quotes erd
2078: \end_inset
2079:
2080: .
2081: The system does not use the case of the letters to determine the correctness
2082: of the answer.
2083: If the correct answer is
2084: \begin_inset Quotes eld
2085: \end_inset
2086:
2087: car
2088: \begin_inset Quotes erd
2089: \end_inset
2090:
2091: , the system will accept
2092: \begin_inset Quotes eld
2093: \end_inset
2094:
2095: car
2096: \begin_inset Quotes erd
2097: \end_inset
2098:
2099: ,
2100: \begin_inset Quotes eld
2101: \end_inset
2102:
2103: CAR
2104: \begin_inset Quotes erd
2105: \end_inset
2106:
2107: ,
2108: \begin_inset Quotes eld
2109: \end_inset
2110:
2111: Car
2112: \begin_inset Quotes erd
2113: \end_inset
2114:
2115: ,
2116: \begin_inset Quotes eld
2117: \end_inset
2118:
2119: caR
2120: \begin_inset Quotes erd
2121: \end_inset
2122:
2123: , etc.
2124: \layout Enumerate
2125:
2126:
2127: \series bold
2128: mc
2129: \series default
2130: : This means
2131: \begin_inset Quotes eld
2132: \end_inset
2133:
2134: Multiple Choice
2135: \begin_inset Quotes erd
2136: \end_inset
2137:
2138: .
2139: The student's answers must contain the same letters as the question author's,
2140: but order is unimportent.
2141: This is usually used to give a multiple choice question in the question's
2142:
2143: \series bold
2144: Text Block
2145: \series default
2146: , which may have several correct parts.
2147: If the author sets the correct answer as
2148: \begin_inset Quotes eld
2149: \end_inset
2150:
2151: bcg
2152: \begin_inset Quotes erd
2153: \end_inset
2154:
2155: , the system will accept
2156: \begin_inset Quotes eld
2157: \end_inset
2158:
2159: bcg
2160: \begin_inset Quotes erd
2161: \end_inset
2162:
2163: ,
2164: \begin_inset Quotes eld
2165: \end_inset
2166:
2167: cbg
2168: \begin_inset Quotes erd
2169: \end_inset
2170:
2171: ,
2172: \begin_inset Quotes eld
2173: \end_inset
2174:
2175: gcb
2176: \begin_inset Quotes erd
2177: \end_inset
2178:
2179: , etc., but not
2180: \begin_inset Quotes eld
2181: \end_inset
2182:
2183: bc
2184: \begin_inset Quotes erd
2185: \end_inset
2186:
2187: or
2188: \begin_inset Quotes eld
2189: \end_inset
2190:
2191: abcg
2192: \begin_inset Quotes erd
2193: \end_inset
2194:
2195: .
2196: \layout Standard
2197:
2198: It is conventional to tell the students whether the question is case sensitive
2199: or not.
2200: \end_deeper
2201: \layout Enumerate
2202:
2203: Optionally, locate the
2204: \series bold
2205: Single Line Text Entry Area
2206: \series default
2207: block and set a length in the Size box.
2208: This will only affect the size of the box on the screen; if you set the
2209: box size to 2, the student can still enter 3 or more letters in their answer.
2210: \begin_deeper
2211: \layout Comment
2212:
2213: This seems like a great feature to either eliminate, or make useful.
2214: Allowing the teacher to limit it to 3, and then not letting the student
2215: type more then 3 chars might be a way of giving the student a hint.
2216: Probably not worth it, as the problem text can always just say
2217: \begin_inset Quotes eld
2218: \end_inset
2219:
2220: Pick two of the following
2221: \begin_inset Quotes erd
2222: \end_inset
2223:
2224: .
2225: This is probably not a useful feature.
2226: \end_deeper
2227: \layout Enumerate
2228:
2229: Scroll down to the Hint element, and type some text that will help students
2230: when they answer incorrectly.
2231: \layout Enumerate
2232:
2233: Click the Submit Changes button.
2234: \layout Subsection
2235:
1.3 ! bowersj2 2236: Creating Numerical Response And Formula Response Problems
1.2 bowersj2 2237: \layout Standard
2238:
2239: Numerical Response problems are answered by entering a number and an optional
2240: unit.
2241: For instance, a numerical response problem might have an answer of
2242: \begin_inset Formula \( 2m/s^{2} \)
2243: \end_inset
2244:
2245: .
1.3 ! bowersj2 2246: Formula Response problems are answered by entering a mathematical formula.
! 2247: For instance, a numerical response problem might have an answer of
! 2248: \begin_inset Formula \( x^{2}+11 \)
1.2 bowersj2 2249: \end_inset
2250:
2251: .
1.3 ! bowersj2 2252: The answer may be in any equivalent format.
! 2253: For instance, for
! 2254: \begin_inset Formula \( x^{2}+11 \)
1.2 bowersj2 2255: \end_inset
2256:
1.3 ! bowersj2 2257: , the system will accept
! 2258: \begin_inset Formula \( x*x-11 \)
1.2 bowersj2 2259: \end_inset
2260:
1.3 ! bowersj2 2261: or
! 2262: \begin_inset Formula \( x^{2}+21-10 \)
1.2 bowersj2 2263: \end_inset
2264:
1.3 ! bowersj2 2265: as well.
! 2266: \layout Standard
1.2 bowersj2 2267:
1.3 ! bowersj2 2268: Creating Numerical Response and Formula Response problems starts the same
! 2269: as the other problem types, but because of the power of Numerical Response
! 2270: and Formula Response problems, it is too difficult to cover them in this
! 2271: tutorial.
! 2272: For more information about these problem types, please see section
! 2273: \begin_inset LatexCommand \ref{Numerical Response}
1.2 bowersj2 2274:
2275: \end_inset
2276:
1.3 ! bowersj2 2277: for Numerical Response problems and section
! 2278: \begin_inset LatexCommand \ref{Formula Response}
1.2 bowersj2 2279:
2280: \end_inset
2281:
1.3 ! bowersj2 2282: for Formula Response problems.
! 2283: \layout Section
1.2 bowersj2 2284:
1.3 ! bowersj2 2285: Publishing Your Resources
1.2 bowersj2 2286: \layout Standard
2287:
1.3 ! bowersj2 2288: In order to make the content you've created available for courses to use,
! 2289: you must publish your content.
! 2290: LON-CAPA provides an easy interface for publishing your content pages,
! 2291: problem resources, and sequences.
! 2292: A common interface allows you to specify title, author information, keywords,
! 2293: and other metadata.
! 2294: LON-CAPA uses this metadata for many things, and it's importent to fill
! 2295: the metadata out as accurately as possible.
! 2296: \layout Subsection
! 2297:
! 2298: What is Metadata?
! 2299: \begin_inset LatexCommand \index{Metadata}
1.2 bowersj2 2300:
2301: \end_inset
2302:
2303:
1.3 ! bowersj2 2304: \begin_inset LatexCommand \label{What Is Metadata?}
1.2 bowersj2 2305:
2306: \end_inset
2307:
2308:
1.3 ! bowersj2 2309: \layout Standard
1.2 bowersj2 2310:
2311:
1.3 ! bowersj2 2312: \emph on
! 2313: Metadata
! 2314: \emph default
! 2315: is
! 2316: \emph on
! 2317: data about data
! 2318: \emph default
1.2 bowersj2 2319: .
1.3 ! bowersj2 2320: Metadata can often be thought of as a label on some bit of information
! 2321: that can be useful to people or computer programs trying to use the data.
! 2322: Without metadata, the person or computer trying to use the original information
! 2323: would have to just guess what the original data is about.
! 2324: For instance, if you create a problem and neglect to say in the title or
! 2325: subject of the problem what it is about, then a human who wants to use
! 2326: that problem would have to read the problem itself to see what it was about,
! 2327: which is much more difficult then just reading a title.
! 2328: A computer trying to do the same thing would just be out of luck; it is
! 2329: too stupid to understand the problem statement at all.
! 2330: \layout Standard
1.2 bowersj2 2331:
1.3 ! bowersj2 2332: One example of metadata you use all the time is the <TITLE> of a webpage,
! 2333: which usually shows up in the title bar of the browser.
! 2334: That's information about the webpage itself, not actually part of the web
! 2335: page.
! 2336: People use it when they bookmark a page, so they know what the page is.
! 2337: Search engines use it as a clue about the content of the web page.
1.2 bowersj2 2338: \layout Subsection
2339:
1.3 ! bowersj2 2340: Publishing A Resource
! 2341: \begin_inset LatexCommand \index{Resource, Publishing}
1.2 bowersj2 2342:
2343: \end_inset
2344:
2345:
1.3 ! bowersj2 2346: \begin_inset LatexCommand \index{Publishing Resource}
1.2 bowersj2 2347:
2348: \end_inset
2349:
1.3 ! bowersj2 2350:
! 2351: \layout Standard
! 2352:
! 2353: \begin_float fig
1.2 bowersj2 2354: \layout Standard
1.3 ! bowersj2 2355: \align center
! 2356:
! 2357: \begin_inset Figure size 476 168
! 2358: file constructionSpaceForPublishing.eps
! 2359: width 3 80
! 2360: flags 9
1.2 bowersj2 2361:
2362: \end_inset
2363:
2364:
1.3 ! bowersj2 2365: \layout Caption
! 2366:
! 2367: Construction Space for Publishing
! 2368: \begin_inset LatexCommand \label{Construction Space for Publishing Figure}
1.2 bowersj2 2369:
2370: \end_inset
2371:
2372:
1.3 ! bowersj2 2373: \end_float
! 2374: To publish a resource, log in and choose your role to be an Author.
! 2375: Then click
! 2376: \series bold
! 2377: CSTR
! 2378: \series default
! 2379: to go to your construction space.
! 2380: You should see something like figure
! 2381: \begin_inset LatexCommand \ref{Construction Space for Publishing Figure}
1.2 bowersj2 2382:
2383: \end_inset
2384:
2385: .
1.3 ! bowersj2 2386: Click on the
! 2387: \series bold
! 2388: Publish
! 2389: \series default
! 2390: button for the resource you wish to publish.
! 2391: \begin_float fig
! 2392: \layout Standard
! 2393: \align center
1.2 bowersj2 2394:
1.3 ! bowersj2 2395: \begin_inset Figure size 476 338
! 2396: file publishMetadata.eps
! 2397: width 3 80
! 2398: flags 9
1.2 bowersj2 2399:
2400: \end_inset
2401:
2402:
1.3 ! bowersj2 2403: \layout Caption
1.2 bowersj2 2404:
2405: Publishing Metadata Screen
2406: \begin_inset LatexCommand \label{Publishing Metadata Screen Figure}
2407:
2408: \end_inset
2409:
2410:
2411: \end_float
2412: You'll get a metadata screen that should look something like figure
2413: \begin_inset LatexCommand \ref{Publishing Metadata Screen Figure}
2414:
2415: \end_inset
2416:
2417: .
2418: Fill out the form.
2419: If you are creating resources that may be used in several courses, you
2420: should talk with the other authors and establish some sort of standard
2421: title and subject scheme in advance.
2422:
2423: \layout Standard
2424:
2425: The language is the language the problem is written in.
2426: The Publisher/Owner is the person who owns the problem; it should be the
2427: email address where anybody with questions about the resource can contact
2428: someone who can help them.
2429: In smaller environments, this is likely to be the author.
2430: In larger environments, it may be a coordinator or manager.
2431: \layout Standard
2432:
2433: The
2434: \series bold
2435: Keywords
2436: \series default
2437: and the
2438: \series bold
2439: Abstract
2440: \series default
2441: are more information about the problem.
2442: The
2443: \series bold
2444: Keywords
2445: \series default
2446: are words that are strongly connected to your problem; for instance a physics
2447: problem about a pulley might include
2448: \begin_inset Quotes eld
2449: \end_inset
2450:
2451: pulley
2452: \begin_inset Quotes erd
2453: \end_inset
2454:
2455: as a key word.
2456: LON-CAPA pulls out likely-looking keywords for you so you can just click
2457: on them to make them keywords.
2458:
2459: \series bold
2460: Additional keywords
2461: \series default
2462: allows you to add any keyword to your problem that are not actually in
2463: the problem.
2464: For instance, on that same problem a physicist might add the keyword
2465: \begin_inset Quotes eld
2466: \end_inset
2467:
2468: statics
2469: \begin_inset Quotes erd
2470: \end_inset
2471:
2472: , even though it doesn't appear in the original problem, because Physics
2473: uses that as a classification of problem type.
2474:
2475: \layout Standard
2476:
2477: Finally, you need to set the copyright and distribution notice.
2478: This setting controls who is allowed to use your resource.
2479:
2480: \layout Itemize
2481:
2482:
2483: \series bold
2484: Limited to courses in the domain published
2485: \series default
2486: means that only courses running in the same domain as you can use your
2487: content.
2488: Talk to your LON-CAPA administrator if you want more information about
2489: your domain.
2490: \layout Itemize
2491:
2492:
2493: \series bold
2494: Free
2495: \series default
2496: means that anyone can find and use the resource.
2497: \layout Itemize
2498:
2499:
2500: \series bold
2501: Private - visible to author only
2502: \series default
2503: means that it can't be used for any course.
2504: \layout Itemize
2505:
2506:
2507: \series bold
2508: Public - no authentication required
2509: \series default
2510: means anyone can find and use the resource.
2511: \layout Standard
2512:
2513: Now when you click
2514: \series bold
2515: Finalize Publication
2516: \series default
2517: , your resource will be published and usable (unless you set the distribution
2518: to
2519: \begin_inset Quotes eld
2520: \end_inset
2521:
2522: private
2523: \begin_inset Quotes erd
2524: \end_inset
2525:
2526: ).
1.3 ! bowersj2 2527: \layout Standard
! 2528:
! 2529: If you're following this as a tutorial, publish your resources so we can
! 2530: use them in the next section.
1.2 bowersj2 2531: \layout Section
2532:
1.3 ! bowersj2 2533: Creating A Course
! 2534: \begin_inset LatexCommand \label{Creating a Course}
! 2535:
! 2536: \end_inset
! 2537:
! 2538: : Maps and Sequences
! 2539: \layout Standard
! 2540:
! 2541: In order to create a useful course, we need to arrange our raw materials
! 2542: so that students can use them.
1.2 bowersj2 2543: \layout Subsection
2544:
1.3 ! bowersj2 2545: Binding Together Resources In One Map: Page
! 2546: \begin_inset LatexCommand \index{Page}
! 2547:
! 2548: \end_inset
! 2549:
! 2550:
! 2551: \layout Standard
! 2552:
! 2553: \begin_float fig
! 2554: \layout Standard
! 2555: \align center
! 2556:
! 2557: \begin_inset Figure size 429 66
! 2558: file mapEditingButton.eps
! 2559: flags 9
! 2560:
! 2561: \end_inset
! 2562:
! 2563:
! 2564: \layout Caption
! 2565:
! 2566: Map Editing Button
! 2567: \begin_inset LatexCommand \label{Map Editing Button Figure}
! 2568:
! 2569: \end_inset
! 2570:
! 2571:
! 2572: \end_float
! 2573: To join several resources into one page, you need to create a
! 2574: \series bold
! 2575: Map
! 2576: \series default
! 2577: of type
! 2578: \series bold
! 2579: Page
! 2580: \series default
! 2581: .
! 2582: To create Page resource, create a new resource as described in section
! 2583:
! 2584: \begin_inset LatexCommand \ref{Creating New Content Pages}
! 2585:
! 2586: \end_inset
! 2587:
! 2588: .
! 2589: This is a
! 2590: \begin_inset Quotes eld
! 2591: \end_inset
! 2592:
! 2593: page
! 2594: \begin_inset Quotes erd
! 2595: \end_inset
! 2596:
! 2597: resource so the URL must end in
! 2598: \begin_inset Quotes eld
! 2599: \end_inset
! 2600:
! 2601: .page
! 2602: \begin_inset Quotes erd
! 2603: \end_inset
! 2604:
! 2605: .
! 2606: After you enter in the URL ending in
! 2607: \begin_inset Quotes eld
! 2608: \end_inset
! 2609:
! 2610: .page
! 2611: \begin_inset Quotes erd
! 2612: \end_inset
! 2613:
! 2614: , you should see a screen as in figure
! 2615: \begin_inset LatexCommand \ref{Map Editing Button Figure}
1.2 bowersj2 2616:
1.3 ! bowersj2 2617: \end_inset
1.2 bowersj2 2618:
1.3 ! bowersj2 2619: .
! 2620: Click the button to get to the sequence editor.
! 2621:
! 2622: \begin_float fig
! 2623: \layout Standard
! 2624: \align center
1.2 bowersj2 2625:
1.3 ! bowersj2 2626: \begin_inset Figure size 476 226
! 2627: file mapEditInitial.eps
! 2628: width 3 80
! 2629: flags 11
! 2630:
! 2631: \end_inset
! 2632:
! 2633:
! 2634: \layout Caption
! 2635:
! 2636: Initial Map Editor
! 2637: \begin_inset LatexCommand \label{Initial Map Editor FIgure}
! 2638:
! 2639: \end_inset
! 2640:
! 2641:
! 2642: \end_float
! 2643: After the system notices the map does not yet exist and creates it for you.
! 2644: You should the initial map editor as seen in figure
! 2645: \begin_inset LatexCommand \ref{Initial Map Editor FIgure}
! 2646:
! 2647: \end_inset
! 2648:
! 2649: .
! 2650: Note there are two windows.
! 2651: One is the workspace, and one is the window which will contain information
! 2652: as you add resources.
! 2653: \layout Subsection
! 2654:
! 2655: About The Editor
! 2656: \layout Standard
! 2657:
! 2658: \begin_float fig
! 2659: \layout Caption
! 2660:
! 2661: Example of the Map Editor
! 2662: \begin_inset LatexCommand \label{Map Editor Example Figure}
! 2663:
! 2664: \end_inset
! 2665:
! 2666:
! 2667: \end_float
! 2668: Maps are very powerful and can do a lot.
! 2669: They can make decisions as the user progresses, and go down different paths
! 2670: under different circumstances.
! 2671: For instance, a map can go down one path if the user gets a problem right,
! 2672: and another path if they don't.
! 2673:
! 2674: \layout Standard
! 2675:
! 2676: To facilitate editing these powerful entities, LON-CAPA has a map editor
! 2677: that helps you take advantage of this power, as seen in figure
! 2678: \begin_inset LatexCommand \ref{Map Editor Example Figure}
! 2679:
! 2680: \end_inset
! 2681:
! 2682: .
! 2683: The map editor can display the different paths in your browser, and allow
! 2684: you to edit, insert, and delete resources from your map.
! 2685: The editor has a
! 2686: \series bold
! 2687: Start
! 2688: \series default
! 2689: area and a
! 2690: \series bold
! 2691: Finish
! 2692: \series default
! 2693: area.
! 2694: The students in the course will progress along on path or another, depending
! 2695: on decisions made at each resource, as explained later.
! 2696: Different paths are represented with different lines in the map editor.
! 2697: In the example figure, there are two paths the student can go down, depending
! 2698: on whether or not they get the problem at the branch point correct.
! 2699: By the end of this section, we'll create the map represented in this figure.
! 2700: \layout Standard
! 2701:
! 2702: The branching ability can obviously be used to help the student understand
! 2703: the concept in the problem by having them go through some extra material
! 2704: based on their performance, but the total uses of this feature are limited
! 2705: only by your imagination.
! 2706: \layout Subsection
! 2707:
! 2708: Creating a Simple Map: Page
! 2709: \layout Standard
! 2710:
! 2711: To add a resource to the map:
! 2712: \layout Enumerate
! 2713:
! 2714: Click on an unused light gray area.
! 2715: \begin_float fig
! 2716: \layout Standard
! 2717: \align center
! 2718:
! 2719: \begin_inset Figure size 476 242
! 2720: file mapEditFirstClick.eps
! 2721: width 3 80
! 2722: flags 9
! 2723:
! 2724: \end_inset
! 2725:
! 2726:
! 2727: \layout Caption
! 2728:
! 2729: Map Editor after clicking on the box labelled
! 2730: \begin_inset Quotes eld
! 2731: \end_inset
! 2732:
! 2733: here
! 2734: \begin_inset Quotes erd
! 2735: \end_inset
! 2736:
! 2737: .
! 2738:
! 2739: \begin_inset LatexCommand \label{Map Editor First Click Figure}
! 2740:
! 2741: \end_inset
! 2742:
! 2743:
! 2744: \end_float
! 2745: In figure
! 2746: \begin_inset LatexCommand \ref{Map Editor First Click Figure}
! 2747:
! 2748: \end_inset
! 2749:
! 2750: , the map editor after clicking on the area labelled
! 2751: \begin_inset Quotes eld
! 2752: \end_inset
! 2753:
! 2754: here
! 2755: \begin_inset Quotes erd
! 2756: \end_inset
! 2757:
! 2758: is shown.
! 2759: In that figure, lines have been added to show where the box boundaries
! 2760: are for the purposes of demonstration.
! 2761: This is to allow you to stay in sync with this tutorial; normally this
! 2762: doesn't matter.
! 2763:
! 2764: \begin_deeper
! 2765: \layout Standard
! 2766:
! 2767: Note that the contents of the seperate window have changed.
! 2768: \end_deeper
! 2769: \layout Enumerate
! 2770:
! 2771: \begin_float fig
! 2772: \layout Standard
! 2773: \align center
! 2774:
! 2775: \begin_inset Figure size 476 218
! 2776: file mapNewResource.eps
! 2777: width 3 80
! 2778: flags 9
! 2779:
! 2780: \end_inset
! 2781:
! 2782:
! 2783: \layout Caption
! 2784:
! 2785: Map Resource Editor
! 2786: \begin_inset LatexCommand \label{Map Resource Editor Figure}
! 2787:
! 2788: \end_inset
! 2789:
! 2790:
! 2791: \end_float
! 2792: Click on
! 2793: \series bold
! 2794: Insert Resource
! 2795: \series default
! 2796: in the secondary window.
! 2797: A
! 2798: \series bold
! 2799: Resource
! 2800: \series default
! 2801: will appear in the map editor.
! 2802: Click on the new Resource, and you'll get something like Figure
! 2803: \begin_inset LatexCommand \ref{Map Resource Editor Figure}
! 2804:
! 2805: \end_inset
! 2806:
! 2807: will show appear.
! 2808: Click
! 2809: \series bold
! 2810: Browse
! 2811: \series default
! 2812: , and the
! 2813: \series bold
! 2814: Network Directory Browser
! 2815: \series default
! 2816: will appear,
! 2817: \begin_float fig
! 2818: \layout Standard
! 2819: \align center
! 2820:
! 2821: \begin_inset Figure size 476 216
! 2822: file mapEditorDirectoryBrowser.eps
! 2823: width 3 80
! 2824: flags 9
! 2825:
! 2826: \end_inset
! 2827:
! 2828:
! 2829: \layout Caption
! 2830:
! 2831: Network Directory Browser
! 2832: \begin_inset LatexCommand \label{Map Editor Network Directory Browser Figure}
! 2833:
! 2834: \end_inset
! 2835:
! 2836:
! 2837: \end_float
! 2838: looking something like figure
! 2839: \begin_inset LatexCommand \ref{Map Editor Network Directory Browser Figure}
! 2840:
! 2841: \end_inset
! 2842:
! 2843: .
! 2844: Press the select button that is next to the resource you want to include.
! 2845: \begin_float fig
! 2846: \layout Standard
! 2847: \align center
! 2848:
! 2849: \begin_inset Figure size 476 213
! 2850: file mapEditorResourceChosen.eps
! 2851: width 3 80
! 2852: flags 9
! 2853:
! 2854: \end_inset
! 2855:
! 2856:
! 2857: \layout Caption
! 2858:
! 2859: Resource Chosen
! 2860: \begin_inset LatexCommand \label{Map Resource Chosen Figure}
! 2861:
! 2862: \end_inset
! 2863:
! 2864: (HTML page)
! 2865: \end_float
! 2866: Once you've done that, if you look back at the window that popped up when
! 2867: you clicked on
! 2868: \series bold
! 2869: New Resource
! 2870: \series default
! 2871: , you'll see something like figure
! 2872: \begin_inset LatexCommand \ref{Map Resource Chosen Figure}
! 2873:
! 2874: \end_inset
! 2875:
! 2876: .
! 2877: You can type the
! 2878: \series bold
! 2879: URL
! 2880: \series default
! 2881: and
! 2882: \series bold
! 2883: Title
! 2884: \series default
! 2885: if you prefer, following the format you see above.
! 2886: After you click
! 2887: \series bold
! 2888: Save Changes
! 2889: \series default
! 2890: , your changes will be saved, and the icons for the resource will appear
! 2891: in the
! 2892: \series bold
! 2893: Res
! 2894: \series default
! 2895: box, as shown in figure
! 2896: \begin_inset LatexCommand \ref{Map Resource Chosen Figure}
! 2897:
! 2898: \end_inset
! 2899:
! 2900: .
! 2901: \begin_deeper
! 2902: \layout Standard
! 2903:
! 2904: Clicking on the left icon for a resource will open a new browser window
! 2905: with an informational page about that resource.
! 2906: Clicking on the right icon for a resource will open a new browser window
! 2907: taking you to the rendering of that resource.
! 2908: \end_deeper
! 2909: \layout Enumerate
! 2910:
! 2911: Let's give practice giving ourselves a bit more space.
! 2912: Click on the grey space just left of your resource, and select
! 2913: \series bold
! 2914: Insert Column Right
! 2915: \series default
! 2916: .
! 2917: This will add a column to the right of that space.
! 2918: Now, click on the bottom row in the grey area, and select
! 2919: \series bold
! 2920: Insert Row Above
! 2921: \series default
! 2922: .
! 2923: This gives us enough space to work with.
! 2924: \layout Enumerate
! 2925:
! 2926: Now, in the map editor window, click just to the left of the
! 2927: \series bold
! 2928: Res
! 2929: \series default
! 2930: box.
! 2931: \begin_float fig
! 2932: \layout Standard
! 2933: \align center
! 2934:
! 2935: \begin_inset Figure size 357 190
! 2936: file mapSecondWindowSecondResource.eps
! 2937: flags 9
! 2938:
! 2939: \end_inset
! 2940:
! 2941:
! 2942: \layout Caption
! 2943:
! 2944: Choosing your second resource
! 2945: \begin_inset LatexCommand \label{Map Second Resource Figure}
! 2946:
! 2947: \end_inset
! 2948:
! 2949:
! 2950: \end_float
! 2951: The secondary window will appear as it does in figure
! 2952: \begin_inset LatexCommand \ref{Map Second Resource Figure}
! 2953:
! 2954: \end_inset
! 2955:
! 2956: , but for now just choose
! 2957: \series bold
! 2958: Insert Resource
! 2959: \series default
! 2960: again, not the new options.
! 2961: Insert a resource in the same manner as before.
! 2962: \begin_float fig
! 2963: \layout Standard
! 2964: \align center
! 2965:
! 2966: \begin_inset Figure size 476 243
! 2967: file mapTwoResources.eps
! 2968: width 3 80
! 2969: flags 11
! 2970:
! 2971: \end_inset
! 2972:
! 2973:
! 2974: \layout Caption
! 2975:
! 2976: Two Resource in the Map Editor
! 2977: \begin_inset LatexCommand \label{Two Resources in the Map Editor Figure}
! 2978:
! 2979: \end_inset
! 2980:
! 2981:
! 2982: \end_float
! 2983: You should have something that looks like figure
! 2984: \begin_inset LatexCommand \ref{Two Resources in the Map Editor Figure}
! 2985:
! 2986: \end_inset
! 2987:
! 2988: , though the exact placement may differ.
! 2989: Now we need to link them together.
! 2990: \layout Enumerate
! 2991:
! 2992: Click the Start box.
! 2993: In the secondary window, select
! 2994: \series bold
! 2995: Link Resource
! 2996: \series default
! 2997: .
! 2998: The secondary window will prompt you to click on the resource you want
! 2999: to link it to.
! 3000: Click the first resource you added to the map.
! 3001: A new link is created.
! 3002: \layout Enumerate
! 3003:
! 3004: Repeat the last step, linking the first resource to the second resource,
! 3005: and the second resource to
! 3006: \series bold
! 3007: Finish
! 3008: \series default
! 3009: .
! 3010: \layout Enumerate
! 3011:
! 3012: Now, in the editor window, click
! 3013: \series bold
! 3014: Save Map
! 3015: \series default
! 3016: .
! 3017: A dialog box will pop up, telling you the map has been saved.
! 3018: \layout Standard
! 3019:
! 3020: Now that you
! 3021: \layout Section
! 3022:
! 3023: Numerical Response
! 3024: \begin_inset LatexCommand \index{Numerical Response}
! 3025:
! 3026: \end_inset
! 3027:
! 3028:
! 3029: \begin_inset LatexCommand \label{Numerical Response}
! 3030:
! 3031: \end_inset
! 3032:
! 3033: Problems
! 3034: \layout Standard
! 3035:
! 3036: Numerical Response problems are very powerful.
! 3037: In fact, they are so powerful it would be impossible to fully explain what
! 3038: is possible in a document like this.
! 3039: This chapter will focus on just getting you started with Numerical Response
! 3040: problems, and showing you some of the possibilities, with no prerequisite
! 3041: knowlege necessary.
! 3042: The more you learn, the more you will find you can do.
! 3043: \layout Standard
! 3044:
! 3045: In this chapter and the next, I will use the terms
! 3046: \series bold
! 3047: static
! 3048: \series default
! 3049: and
! 3050: \series bold
! 3051: dynamic
! 3052: \series default
! 3053: .
! 3054:
! 3055: \series bold
! 3056: Static
! 3057: \series default
! 3058: means the object never changes, and is the same for each student.
! 3059: By contrast,
! 3060: \series bold
! 3061: dynamic
! 3062: \series default
! 3063: means the value can change, because there is some script that computes
! 3064: it for each student.
! 3065: \layout Standard
! 3066:
! 3067: If you like, you can follow this chapter along as its own tutorial.
! 3068: Create a Numerical Response problem using the instructions in section
! 3069: \begin_inset LatexCommand \ref{Creating New Content Pages}
! 3070:
! 3071: \end_inset
! 3072:
! 3073: , ending your resource name with
! 3074: \begin_inset Quotes eld
! 3075: \end_inset
! 3076:
! 3077: .problem
! 3078: \begin_inset Quotes erd
! 3079: \end_inset
! 3080:
! 3081: , and create a new
! 3082: \series bold
! 3083: Simple Numerical Response
! 3084: \series default
! 3085: problem.
! 3086: \layout Subsection
! 3087:
! 3088: The Parts of a Numerical Response Problem
! 3089: \layout Standard
! 3090:
! 3091: \begin_float fig
! 3092: \layout Standard
! 3093: \align center
! 3094:
! 3095: \begin_inset Figure size 476 356
! 3096: file numericalResponse1.eps
! 3097: width 3 80
! 3098: flags 9
! 3099:
! 3100: \end_inset
! 3101:
! 3102:
! 3103: \layout Caption
! 3104:
! 3105: Numerical Response editor
! 3106: \begin_inset LatexCommand \label{Numerical Response Editor Figure}
! 3107:
! 3108: \end_inset
! 3109:
! 3110:
! 3111: \end_float
! 3112: A Numerical Response problem has seven major parts by default, as seen in
! 3113: figure
! 3114: \begin_inset LatexCommand \ref{Numerical Response Editor Figure}
! 3115:
! 3116: \end_inset
! 3117:
! 3118: :
! 3119: \layout Enumerate
! 3120:
! 3121: The
! 3122: \series bold
! 3123: Script
! 3124: \series default
! 3125: .
! 3126: The script is the heart of advanced Numerical Response problems.
! 3127: It can be used to decide some of the parameters of the problem, compute
! 3128: the answer to the problem, and do just about anything else you can imagine.
! 3129: The Script language is
! 3130: \series bold
! 3131: Perl
! 3132: \begin_float footnote
! 3133: \layout Standard
! 3134:
! 3135: For lots and lots more information about Perl, see the Perl website at http://ww
! 3136: w.perl.org/ .
! 3137: \end_float
! 3138: .
! 3139: You do not need to know Perl to use the Script block, as we will be stepping
! 3140: through some advanced examples in this chapter, but knowing Perl can help.
! 3141: \layout Enumerate
! 3142:
! 3143: Like other problem types, the
! 3144: \series bold
! 3145: Text Block
! 3146: \series default
! 3147: is used to display the problem the student will see.
! 3148: In addition, you can place things in the
! 3149: \series bold
! 3150: Text Block
! 3151: \series default
! 3152: based on computations done in the
! 3153: \series bold
! 3154: Script
! 3155: \series default
! 3156: .
! 3157: \layout Enumerate
! 3158:
! 3159: The
! 3160: \series bold
! 3161: Answer
! 3162: \series default
! 3163: is the answer the system is looking for.
! 3164: This can also use parameters from the
! 3165: \series bold
! 3166: Script
! 3167: \series default
! 3168: block, allowing the answer to be computed dynamically.
! 3169: \layout Enumerate
! 3170:
! 3171: A
! 3172: \series bold
! 3173: tolerance
! 3174: \begin_inset LatexCommand \index{tolerance}
! 3175:
! 3176: \end_inset
! 3177:
! 3178:
! 3179: \series default
! 3180: parameter, which determines how closely the system will require the student
! 3181: answer to be in order to count it correct.
! 3182: For technical reasons, it is almost never a good idea to set this parameter
! 3183: to zero
! 3184: \begin_float footnote
! 3185: \layout Standard
! 3186:
! 3187: Computers can only approximate computations involving real numbers.
! 3188: For instance, a computer's [decimal] answer to the simple problem
! 3189: \begin_inset Formula \( \frac{1}{3} \)
! 3190: \end_inset
! 3191:
! 3192: is
! 3193: \begin_inset Quotes eld
! 3194: \end_inset
! 3195:
! 3196: 0.33333333333333331
! 3197: \begin_inset Quotes erd
! 3198: \end_inset
! 3199:
! 3200: .
! 3201: It
! 3202: \emph on
! 3203: should
! 3204: \emph default
! 3205: be an infinite series of 3's, and there certainly shouldn't be a
! 3206: \begin_inset Quotes eld
! 3207: \end_inset
! 3208:
! 3209: 1
! 3210: \begin_inset Quotes erd
! 3211: \end_inset
! 3212:
! 3213: in the answer, but no computer can represent an infinitely long, infinitely
! 3214: detailed real number.
! 3215: Therefore, for any problem where the answer is not a small integer, you
! 3216:
! 3217: \emph on
! 3218: need
! 3219: \emph default
! 3220: to allow a tolerance factor, or the students will find it nearly impossible
! 3221: to exactly match the computers idea of the answer.
! 3222: \end_float
! 3223: , though you may find the default too large for some problems.
! 3224: There are two kinds of tolerance.
! 3225: If there is some answer
! 3226: \begin_inset Formula \( a \)
! 3227: \end_inset
! 3228:
! 3229: and a tolerance
! 3230: \begin_inset Formula \( t \)
! 3231: \end_inset
! 3232:
! 3233: ,
! 3234: \begin_deeper
! 3235: \layout Enumerate
! 3236:
! 3237: an
! 3238: \series bold
! 3239: Absolute
! 3240: \series default
! 3241: tolerance
! 3242: \begin_inset LatexCommand \index{absolute tolerance}
! 3243:
! 3244: \end_inset
! 3245:
! 3246:
! 3247: \begin_inset LatexCommand \index{tolerance, absolute}
! 3248:
! 3249: \end_inset
! 3250:
! 3251: will take anything in the range
! 3252: \begin_inset Formula \( a\pm t \)
! 3253: \end_inset
! 3254:
! 3255: .
! 3256: So if
! 3257: \begin_inset Formula \( a=10 \)
! 3258: \end_inset
! 3259:
! 3260: and
! 3261: \begin_inset Formula \( t=2 \)
! 3262: \end_inset
! 3263:
! 3264: , then anything between 8 and 12 is acceptable
! 3265: \begin_float footnote
! 3266: \end_deeper
! 3267: \layout Standard
! 3268:
! 3269: For much the same reasons a tolerance is almost always a good idea, it's
! 3270: almost impossible to say whether an answer that is
! 3271: \emph on
! 3272: exactly
! 3273: \emph default
! 3274:
! 3275: \begin_inset Formula \( a\pm t \)
! 3276: \end_inset
! 3277:
! 3278: will be accepted by the computer.
! 3279: But the computer does use many decimal places of accuracy; if you want
! 3280: to have the student answer exactly
! 3281: \begin_inset Quotes eld
! 3282: \end_inset
! 3283:
! 3284: 2
! 3285: \begin_inset Quotes erd
! 3286: \end_inset
! 3287:
! 3288: , then specifying a tolerance of
! 3289: \begin_inset Quotes eld
! 3290: \end_inset
! 3291:
! 3292: .0000001
! 3293: \begin_inset Quotes erd
! 3294: \end_inset
! 3295:
! 3296: is OK.
! 3297: (Don't use too many more zeros, though you can use less if you like.)
! 3298: \end_float
! 3299: .
! 3300: Any number in the tolerance field
! 3301: \emph on
! 3302: without
! 3303: \emph default
! 3304: a
! 3305: \series bold
! 3306: %
! 3307: \series default
! 3308: symbol is an absolute tolerance.
! 3309: \begin_deeper
! 3310: \layout Enumerate
! 3311:
! 3312: a
! 3313: \series bold
! 3314: Relative
! 3315: \series default
! 3316: tolerance
! 3317: \begin_inset LatexCommand \index{relative tolerance}
! 3318:
! 3319: \end_inset
! 3320:
! 3321:
! 3322: \begin_inset LatexCommand \index{tolerance, relative}
! 3323:
! 3324: \end_inset
! 3325:
! 3326: will take anything in the range
! 3327: \begin_inset Formula \( a\pm at \)
! 3328: \end_inset
! 3329:
! 3330: , where
! 3331: \emph on
! 3332: t
! 3333: \emph default
! 3334: is interpreted as a percentage.
! 3335: Any number in the tolerance field
! 3336: \emph on
! 3337: with
! 3338: \emph default
! 3339: a
! 3340: \series bold
! 3341: %
! 3342: \series default
! 3343: symbol is a relative tolerance.
! 3344: For example,
! 3345: \begin_inset Formula \( a=10 \)
! 3346: \end_inset
! 3347:
! 3348: and
! 3349: \begin_inset Formula \( t=10\% \)
! 3350: \end_inset
! 3351:
! 3352: will accept anything between 9 and 11.
! 3353:
! 3354: \end_deeper
! 3355: \layout Enumerate
! 3356:
! 3357: A
! 3358: \series bold
! 3359: significant figures
! 3360: \series default
! 3361: specification tells the system how many significant figures there are in
! 3362: the problem, as either a single number or a range of acceptable values,
! 3363: expressed as
! 3364: \series bold
! 3365: min,max
! 3366: \series default
! 3367: .
! 3368: The system will check to make sure that the student's answer contains this
! 3369: many significant digits, useful in many scientific calculations.
! 3370: For example, if the problem has three significant digits, the significant
! 3371: digit specification is
! 3372: \begin_inset Quotes eld
! 3373: \end_inset
! 3374:
! 3375: 3
! 3376: \begin_inset Quotes erd
! 3377: \end_inset
! 3378:
! 3379: , and the answer is
! 3380: \begin_inset Quotes eld
! 3381: \end_inset
! 3382:
! 3383: 1.3
! 3384: \begin_inset Quotes erd
! 3385: \end_inset
! 3386:
! 3387: , the system will require the students to type
! 3388: \begin_inset Quotes eld
! 3389: \end_inset
! 3390:
! 3391: 1.30
! 3392: \begin_inset Quotes erd
! 3393: \end_inset
! 3394:
! 3395: , even though numerically,
! 3396: \begin_inset Quotes eld
! 3397: \end_inset
! 3398:
! 3399: 1.3
! 3400: \begin_inset Quotes erd
! 3401: \end_inset
! 3402:
! 3403: and
! 3404: \begin_inset Quotes eld
! 3405: \end_inset
! 3406:
! 3407: 1.30
! 3408: \begin_inset Quotes erd
! 3409: \end_inset
! 3410:
! 3411: are the same.
! 3412: \begin_deeper
! 3413: \layout Comment
! 3414:
! 3415: Confirm this.
! 3416: \end_deeper
! 3417: \layout Enumerate
! 3418:
! 3419: The
! 3420: \series bold
! 3421: Single Line Text Entry
! 3422: \series default
! 3423: area, as in other problems, allow you to manipulate the text entry area
! 3424: the student will see.
! 3425: \layout Enumerate
! 3426:
! 3427: Finally, the
! 3428: \series bold
! 3429: Hint
! 3430: \series default
! 3431: provides a place to help students who get the problem incorrect the first
! 3432: time.
! 3433: \layout Subsection
! 3434:
! 3435: Simple Numerical Response Answer
! 3436: \layout Standard
! 3437:
! 3438: Along with showing the Numerical Response editor, figure
! 3439: \begin_inset LatexCommand \ref{Numerical Response Editor Figure}
! 3440:
! 3441: \end_inset
! 3442:
! 3443: also shows the parameters for one of the simplest possible types of numerical
! 3444: response.
! 3445: The
! 3446: \series bold
! 3447: Text Block
! 3448: \series default
! 3449: has the problem's question, which is the static text
! 3450: \begin_inset Quotes eld
! 3451: \end_inset
! 3452:
! 3453: What is 2 + 2?
! 3454: \begin_inset Quotes erd
! 3455: \end_inset
! 3456:
! 3457: The
! 3458: \series bold
! 3459: Answer
! 3460: \series default
! 3461: is
! 3462: \begin_inset Quotes eld
! 3463: \end_inset
! 3464:
! 3465: 4
! 3466: \begin_inset Quotes erd
! 3467: \end_inset
! 3468:
! 3469: .
! 3470: The
! 3471: \series bold
! 3472: Hint
! 3473: \series default
! 3474: has been set to something appropriate for this problem (unless this problem
! 3475: is being given to very young children).
! 3476: Everything else has the default values from when the problem was created.
! 3477: \layout Standard
! 3478:
! 3479: If you create a problem like this, hit
! 3480: \series bold
! 3481: Submit Changes
! 3482: \series default
! 3483: , then hit
! 3484: \series bold
! 3485: View
! 3486: \series default
! 3487: after the changes have been submitted, you can try the problem out for
! 3488: yourself.
! 3489: Note the last box in the HTML page has the answer LON-CAPA is looking for
! 3490: conveniently displayed for you, along with the range the computer will
! 3491: accept and the number of significant digits the computer requires.
! 3492: \layout Standard
! 3493:
! 3494: As you're playing with the problem, if you use up all your tries or get
! 3495: the answer correct but wish to continue playing with the problem, use the
! 3496:
! 3497: \series bold
! 3498: Reset Submissions
! 3499: \series default
! 3500: button to clear your answer attempts.
! 3501:
! 3502: \layout Subsection
! 3503:
! 3504: Simple Script Usage
! 3505: \layout Standard
! 3506:
! 3507: Totally static problems only scratch the surface of the Numerical Response
! 3508: capabilities.
! 3509: To really explore the power of LON-CAPA, we need to start creating dynamic
! 3510: problems.
! 3511: But before we can get to truly dynamic problems, we need to learn how to
! 3512: work with the
! 3513: \series bold
! 3514: Script
! 3515: \begin_inset LatexCommand \index{Script}
! 3516:
! 3517: \end_inset
! 3518:
! 3519:
! 3520: \series default
! 3521: window.
! 3522: \layout Standard
! 3523:
! 3524: A script consists of several
! 3525: \series bold
! 3526: statements
! 3527: \series default
! 3528: , seperated by
! 3529: \series bold
! 3530: semi-colons
! 3531: \series default
! 3532: .
! 3533: A
! 3534: \series bold
! 3535: statement
! 3536: \begin_inset LatexCommand \index{statement}
! 3537:
! 3538: \end_inset
! 3539:
! 3540:
! 3541: \series default
! 3542: is the smallest kind of instruction to the computer you can give.
! 3543: Most problems will be built from several statements.
! 3544:
! 3545: \layout Standard
! 3546:
! 3547: A script can contain
! 3548: \series bold
! 3549: comments
! 3550: \series default
! 3551: , which are not interpreted as statements by the computer.
! 3552: Comments start with
! 3553: \series bold
! 3554: #
! 3555: \series default
! 3556: , and go to the end of that line.
! 3557: Thus, if a line starts with #, the whole line is ignored.
! 3558: Comments can also begin in the middle of a line.
! 3559: It is a good idea to comment more complicated scripts, as it can be very
! 3560: difficult to read a large script and figure out what it does.
! 3561: It is a
! 3562: \emph on
! 3563: very
! 3564: \emph default
! 3565: good idea to adopt some sort of commenting standard, especially if you
! 3566: are working in a group or others may use your problems in the future.
! 3567: \layout Standard
! 3568:
! 3569: One of the simplest statements in LON-CAPA is a
! 3570: \series bold
! 3571: variable assignment
! 3572: \series default
! 3573: .
! 3574: A
! 3575: \series bold
! 3576: variable
! 3577: \series default
! 3578: can hold any value in it.
! 3579: Simple values, such as a number or a string of text, start with a
! 3580: \series bold
! 3581: $
! 3582: \series default
! 3583: .
! 3584: In the
! 3585: \series bold
! 3586: Script
! 3587: \series default
! 3588: , you need to assign to variables before you use them.
! 3589: Put the program in Figure
! 3590: \begin_float fig
! 3591: \layout LyX-Code
! 3592: \align center
! 3593: $variable = 3;
! 3594: \layout Caption
! 3595: \pextra_type 3 \pextra_widthp 40
! 3596:
! 3597: A simple script with a variable
! 3598: \begin_inset LatexCommand \label{A simple script with a variable}
! 3599:
! 3600: \end_inset
! 3601:
! 3602:
! 3603: \end_float
! 3604:
! 3605: \begin_inset LatexCommand \ref{A simple script with a variable}
! 3606:
! 3607: \end_inset
! 3608:
! 3609: into the
! 3610: \series bold
! 3611: Script
! 3612: \series default
! 3613: field of the Numerical Response.
! 3614: This creates a simple variable named
! 3615: \series bold
! 3616: variable
! 3617: \series default
! 3618: and assigns it the value of
! 3619: \begin_inset Quotes eld
! 3620: \end_inset
! 3621:
! 3622: 3
! 3623: \begin_inset Quotes erd
! 3624: \end_inset
! 3625:
! 3626: .
! 3627: That's one statement.
! 3628: \layout Standard
! 3629:
! 3630: Variable names are
! 3631: \emph on
! 3632: case sensitive
! 3633: \emph default
! 3634: , must start with a letter, and can only consist of letters, numbers, and
! 3635: underscores.
! 3636: Variable names can be as long as you want.
! 3637:
! 3638: \layout Standard
! 3639:
! 3640: Getting variable names right is a skill.
! 3641: Variable names should not be too long, because they become easy to mistype.
! 3642: Variable names should also not be too short, with the exception of some
! 3643: conventionally short variable names we'll talk about later.
! 3644: \layout Standard
! 3645:
! 3646: There are many variable naming conventions, covering both how to name and
! 3647: how to capatalize variables
! 3648: \begin_float footnote
! 3649: \layout Standard
! 3650:
! 3651: The author favors
! 3652: \family typewriter
! 3653: capsOnNewWords
! 3654: \family default
! 3655: .
! 3656: Some people use
! 3657: \family typewriter
! 3658: underscore_to_seperate_words
! 3659: \family default
! 3660: .
! 3661: Many use uppercase letters to specify constants like
! 3662: \family typewriter
! 3663: PI
! 3664: \family default
! 3665: or
! 3666: \family typewriter
! 3667: GOLDEN_MEAN
! 3668: \family default
! 3669: .
! 3670: Some people always
! 3671: \family typewriter
! 3672: StartWithCapatalization
! 3673: \family default
! 3674: .
! 3675: What's really importent is to be consistent, so you don't have to guess
! 3676: whether the variable you're thinking of is
! 3677: \family typewriter
! 3678: coefFriction
! 3679: \family default
! 3680: ,
! 3681: \family typewriter
! 3682: CoefFriction
! 3683: \family default
! 3684: ,
! 3685: \family typewriter
! 3686: COEF_FRICTION
! 3687: \family default
! 3688: , or something else.
! 3689: \end_float
! 3690: .
! 3691: It is a good idea to adopt a standard.
! 3692: If you are working with a group, you may wish to discuss it in your group
! 3693: and agree on a convention.
! 3694:
! 3695: \layout Standard
! 3696:
! 3697: If you
! 3698: \series bold
! 3699: Submit Changes
! 3700: \series default
! 3701: and
! 3702: \series bold
! 3703: View
! 3704: \series default
! 3705: the problem, you'll see nothing has changed.
! 3706: That's because in order for a variable to be useful, it must be used.
! 3707: The variable can be used in several places.
! 3708: \layout Subsubsection
! 3709:
! 3710: Variables in Scripts
! 3711: \layout Standard
! 3712:
! 3713: Variables can be used later in the same script.
! 3714: For instance, we can add another line below the
! 3715: \family typewriter
! 3716: $variable
! 3717: \family default
! 3718: line as such:
! 3719: \layout LyX-Code
! 3720:
! 3721: $variable2 = $variable + 2;
! 3722: \layout Standard
! 3723:
! 3724: Now there's a variable called
! 3725: \family typewriter
! 3726: $variable2
! 3727: \family default
! 3728: with the value
! 3729: \begin_inset Quotes eld
! 3730: \end_inset
! 3731:
! 3732: 5
! 3733: \begin_inset Quotes erd
! 3734: \end_inset
! 3735:
! 3736: .
! 3737:
! 3738: \layout Standard
! 3739:
! 3740: Variables can also be used in
! 3741: \emph on
! 3742: strings
! 3743: \emph default
! 3744:
! 3745: \begin_inset LatexCommand \index{strings}
! 3746:
! 3747: \end_inset
! 3748:
! 3749: , which are a sequence of letters.
! 3750: The underlying language of the script, Perl, has a very large number of
! 3751: ways of using variables in strings, but the easiest and most common way
! 3752: is to use normal double-quotes and just spell out the name of the variable
! 3753: you want to use in the string, like this:
! 3754: \layout LyX-Code
! 3755:
! 3756: $stringVar =
! 3757: \begin_inset Quotes eld
! 3758: \end_inset
! 3759:
! 3760: I have a variable with the value $variable.
! 3761: \begin_inset Quotes erd
! 3762: \end_inset
! 3763:
! 3764:
! 3765: \layout Standard
! 3766:
! 3767: This will put the string
! 3768: \begin_inset Quotes eld
! 3769: \end_inset
! 3770:
! 3771: I have a variable with the value 3.
! 3772: \begin_inset Quotes erd
! 3773: \end_inset
! 3774:
! 3775: into the variable named
! 3776: \begin_inset Quotes eld
! 3777: \end_inset
! 3778:
! 3779: stringVar
! 3780: \begin_inset Quotes erd
! 3781: \end_inset
! 3782:
! 3783: .
! 3784: \layout Standard
! 3785:
! 3786: If you are following this chapter as a tutorial, add the previous two lines
! 3787: and save the problem.
! 3788: There's no need to view it; there's still no visible change.
! 3789: \layout Subsubsection
! 3790:
! 3791: Variables in the Text Block
! 3792: \layout Standard
! 3793:
! 3794: Once you've defined variables in the
! 3795: \series bold
! 3796: Script
! 3797: \series default
! 3798: , you can use them in the
! 3799: \series bold
! 3800: Text Block
! 3801: \series default
! 3802: .
! 3803: For example, using the previous three-line script we've created so far,
! 3804: you can place the following in the
! 3805: \series bold
! 3806: Text Block
! 3807: \series default
! 3808: :
! 3809: \layout LyX-Code
! 3810:
! 3811: See the 3: $variable<br />
! 3812: \layout LyX-Code
! 3813:
! 3814: See the string: <b>$stringVar</b><br />
! 3815: \layout Standard
! 3816:
! 3817: \begin_float fig
! 3818: \layout Standard
! 3819: \align center
! 3820:
! 3821: \begin_inset Figure size 353 99
! 3822: file numericalResponseVarInText.eps
! 3823: flags 9
! 3824:
! 3825: \end_inset
! 3826:
! 3827:
! 3828: \layout Caption
! 3829:
! 3830: Result of Variables in the Text Block
! 3831: \begin_inset LatexCommand \label{Result of Variables in the Text Block Figure}
! 3832:
! 3833: \end_inset
! 3834:
! 3835:
! 3836: \end_float
! 3837: If you save that and hit
! 3838: \series bold
! 3839: View
! 3840: \series default
! 3841: , you should get what you see in figure
! 3842: \begin_inset LatexCommand \ref{Result of Variables in the Text Block Figure}
! 3843:
! 3844: \end_inset
! 3845:
! 3846: .
! 3847: Note how the
! 3848: \begin_inset Quotes eld
! 3849: \end_inset
! 3850:
! 3851: $variable
! 3852: \begin_inset Quotes erd
! 3853: \end_inset
! 3854:
! 3855: was turned into a 3, and the
! 3856: \begin_inset Quotes eld
! 3857: \end_inset
! 3858:
! 3859: $stringVar
! 3860: \begin_inset Quotes erd
! 3861: \end_inset
! 3862:
! 3863: was turned into
! 3864: \begin_inset Quotes eld
! 3865: \end_inset
! 3866:
! 3867: I have a variable with the value 3.
! 3868: \begin_inset Quotes erd
! 3869: \end_inset
! 3870:
! 3871:
! 3872: \layout Subsubsection
! 3873:
! 3874: Variables in the Answer Block
! 3875: \layout Standard
! 3876:
! 3877: You can use variables in the
! 3878: \series bold
! 3879: Answer
! 3880: \series default
! 3881: part of the question, too.
! 3882: This means you can compute an answer to a question, which we'll see in
! 3883: a bit.
! 3884: If you set the answer of the question to be
! 3885: \begin_inset Quotes eld
! 3886: \end_inset
! 3887:
! 3888: $variable
! 3889: \begin_inset Quotes erd
! 3890: \end_inset
! 3891:
! 3892: (without the quotes),
! 3893: \series bold
! 3894: Save Changes
! 3895: \series default
! 3896: and
! 3897: \series bold
! 3898: View
! 3899: \series default
! 3900: it, you'll see that LON-CAPA is now expecting
! 3901: \begin_inset Quotes eld
! 3902: \end_inset
! 3903:
! 3904: 3
! 3905: \begin_inset Quotes erd
! 3906: \end_inset
! 3907:
! 3908: as the answer, plus or minus 5%.
! 3909: \layout Subsection
! 3910:
! 3911: Calling Functions
! 3912: \layout Standard
! 3913:
! 3914: Now you've seen how to use variables and stuff, see how to call functions.
! 3915: \layout Subsubsection
! 3916:
! 3917: Randomization
! 3918: \begin_inset LatexCommand \index{Randomization}
! 3919:
! 3920: \end_inset
! 3921:
! 3922:
! 3923: \layout Standard
! 3924:
! 3925: One of the most importent functions for LON-CAPA is the RANDOM function.
! 3926: \layout Subsection
! 3927:
! 3928: Dynamic, Randomized Problems: Putting It All Together
! 3929: \layout Standard
! 3930:
! 3931: placeholder
! 3932: \layout Subsection
! 3933:
! 3934: For More Information
! 3935: \layout Standard
! 3936:
! 3937: It's always a good idea to look at other people's LON-CAPA problems, especially
! 3938: those from the same discipline as your problems, and see what they are
! 3939: doing.
! 3940:
! 3941: \series bold
! 3942: Very often, the easiest way to create a new problem is to copy it and modify
! 3943: the copy until it does what you need.
! 3944:
! 3945: \series default
! 3946: The more complicated a problem is, the more time you'll save by doing this.
! 3947: Also, you may find new ideas you can use and elaborate in your problems.
! 3948: \layout Comment
! 3949:
! 3950: Is there UI for this? Check.
! 3951: \layout Standard
! 3952:
! 3953: The full power of the Perl is well outside the scope of this document.
! 3954: Without going into the same level of detail as the previous examples, here's
! 3955: some ideas to stimulate your imagination:
! 3956: \layout Itemize
! 3957:
! 3958: Variable text.
! 3959:
! 3960: \layout Itemize
! 3961:
! 3962: Perl has several other data structures which might be of use.
! 3963: You may wish to do one of the many simple Perl tutorials on the Web.
! 3964: I recommend searching Google for
! 3965: \begin_inset Quotes eld
! 3966: \end_inset
! 3967:
! 3968: perl tutorial
! 3969: \begin_inset Quotes erd
! 3970: \end_inset
! 3971:
! 3972: .
! 3973: \layout Section
! 3974:
! 3975: Formula Response
! 3976: \begin_inset LatexCommand \index{Formula Response}
! 3977:
! 3978: \end_inset
! 3979:
! 3980:
! 3981: \begin_inset LatexCommand \label{Formula Response}
! 3982:
! 3983: \end_inset
! 3984:
! 3985: Problems
! 3986: \layout Section
! 3987:
! 3988: Additional Problem Components
! 3989: \layout Standard
! 3990:
! 3991: Using the
! 3992: \begin_inset Quotes eld
! 3993: \end_inset
! 3994:
! 3995: Insert
! 3996: \begin_inset Quotes erd
! 3997: \end_inset
! 3998:
! 3999: menu that appears in many of the problem editors, a wide variety of different
! 4000: things can be added to the problems.
! 4001: \layout Section
! 4002:
! 4003: Things That Need To Be Added
! 4004: \layout Subsection
! 4005:
! 4006: LON-CAPA and Units
! 4007: \layout Subsection
! 4008:
! 4009: Creating a default metadata file
1.2 bowersj2 4010: \layout Subsection
4011:
4012: My questions\SpecialChar \ldots{}
4013:
4014: \layout Itemize
4015:
4016: How do I do the things above?
4017: \layout Itemize
4018:
4019: Is there any pre-existing documentation for number or formula problems?
4020: \layout Itemize
4021:
4022: Is there any pre-existing documentation for maps et al? I seem to have exhausted
4023: the documentation.
4024: \layout Itemize
4025:
4026: What is the LON-CAPA default resource? If it's free, can just anyone
4027: \begin_inset Quotes eld
4028: \end_inset
4029:
4030: find and use it
4031: \begin_inset Quotes erd
4032: \end_inset
4033:
4034: , or just
4035: \begin_inset Quotes eld
4036: \end_inset
4037:
4038: use it if they already know where it is
4039: \begin_inset Quotes erd
4040: \end_inset
4041:
4042: ? (In other words, how powerful is the search feature?) What's the difference
4043: between free and public?
4044: \layout Section
4045:
4046: Appendix A: Student Interface
4047: \layout Standard
4048:
4049: \begin_float fig
4050: \layout Caption
4051:
4052: Student Remote Control
4053: \begin_inset LatexCommand \label{Student Remote Control}
4054:
4055: \end_inset
4056:
4057:
4058: \end_float
4059: The Student Remote Control will automatically load whenever you log in to
4060: a LON-CAPA course as a student.
4061: The Student Remote Control contains most of the functions of the Author
4062: Remote Control and the following additional functions.
4063: \layout Itemize
4064:
4065:
4066: \series bold
4067: NAV (NAVIGATE CONTENTS)
4068: \series default
4069: allows you to directly access resources from the course outline.
4070: \layout Itemize
4071:
4072:
4073: \series bold
4074: ARROWS (LEFT and RIGHT)
4075: \series default
4076: allows you to move to the backward or forward through the course.
4077: \layout Itemize
4078:
4079:
4080: \series bold
4081: GRDS (MY GRADES)
4082: \series default
4083: allows you to check your grades in the courses you are taking.
4084: \layout Itemize
4085:
4086:
4087: \series bold
4088: SBKM (SET BOOKMARK)
4089: \series default
4090: allows you to bookmark pages for easy access.
4091: \layout Itemize
4092:
4093:
4094: \series bold
4095: VBKM (VIEW BOOKMARK)
4096: \series default
4097: displays your bookmarks for easy access to bookmarked resources.
4098: \layout Itemize
4099:
4100:
4101: \series bold
4102: ANOT (ANOTATE)
4103: \series default
4104: allows you to create personal notes.
4105: \layout Itemize
4106:
4107:
4108: \series bold
4109: LOGOUT (LOGOUT)
1.1 bowersj2 4110: \series default
4111: will log you out of the LON-CAPA system.
1.2 bowersj2 4112: \layout Standard
4113:
4114:
4115: \begin_inset LatexCommand \printindex{}
4116:
4117: \end_inset
4118:
4119:
1.1 bowersj2 4120: \the_end
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to tutorial.lyx CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / tutorial