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
9: \fontscheme default
10: \graphics default
11: \paperfontsize 12
12: \spacing single
13: \papersize Default
14: \paperpackage a4
15: \use_geometry 1
16: \use_amsmath 0
17: \paperorientation portrait
18: \leftmargin 1in
19: \topmargin 1.25in
20: \rightmargin 1in
21: \bottommargin 1in
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:
34: Learning
35: \emph on
36: Online
37: \emph default
38: Network with CAPA
39: \newline
40:
41: \emph on
42: \SpecialChar ~
43:
44: \newline
45:
46: \size larger
47: Author's Tutorial And Manual
48: \layout Standard
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
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.
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.
157: \layout Standard
158:
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.
163: \layout Section
164:
165: The LON-CAPA Author Interface
166: \begin_inset LatexCommand \label{Author Interface}
167:
168: \end_inset
169:
170:
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:
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
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:
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.
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:
387: We're data-mining the web logs to see what people actually use.
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.
411:
412: \begin_float fig
413: \layout Standard
414: \align center
415:
416: \begin_inset Figure size 177 420
417: file authorRemote.eps
418: height 3 50
419: flags 9
420:
421: \end_inset
422:
423:
424: \layout Caption
425:
426: Author Remote Control
427: \begin_inset LatexCommand \label{Author Remote Control Figure}
428:
429: \end_inset
430:
431:
432: \end_float
433: \layout Comment
434:
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.
522: It is essentially a conventional HTML page.
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.
570: The users of this resource can use buttons on their remote or the NAV button
571: to follow the sequence.
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
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:
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:
702: Opens the Resource Publishing window.
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:
756: Helps you select a file to upload
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
858: \begin_inset LatexCommand \label{Creating New Content Pages}
859:
860: \end_inset
861:
862:
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.
870: To create new Content Pages, do the following:
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
895: http://www.s10.lite.msu.edu/priv/\SpecialChar \-
896: directory/new_resource.html
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
904: File not found: /home/wmsonj/priv/\SpecialChar \-
905: directory/new_resource.html
906: \series default
907: , and an Edit button.
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.
917: \layout Enumerate
918:
919: Type the content into the editor,
920: \emph on
921: OR
922: \emph default
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
938: \emph on
939: OR
940: \emph default
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.
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.
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
994: \emph on
995: OR
996: \emph default
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
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.
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:
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:
1041: Radio Response
1042: \begin_inset LatexCommand \index{Radio Response}
1043:
1044: \end_inset
1045:
1046: Problems
1047: \layout Standard
1048:
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.
1056: \layout Standard
1057:
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}
1069:
1070: \end_inset
1071:
1072: Problems
1073: \layout Standard
1074:
1075: Option Response problems present foils to the student with drop-down boxes.
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
1087:
1088: String Response Problems
1089: \layout Standard
1090:
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.
1102: Examples of string response questions are vocabulary tests, short answer
1103: and entering chemical formulas.
1104: \layout Standard
1105:
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:
1147: Numerical Response Problems
1148: \layout Standard
1149:
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.
1161: Tolerance and significant digits can be specified as well.
1162: \layout Subsubsection
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.
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.
1174: Functions such as cos, sin, and exp are accepted as well as the operators
1175: (), +, -, *, and /.
1176: \layout Subsection
1177:
1178: Creating Radio Response Problems
1179: \layout Standard
1180:
1181: \begin_float fig
1182: \layout Standard
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
1234:
1235: .
1236: \begin_float fig
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:
1248: \layout Caption
1249:
1250: Radio Response Creation Form
1251: \begin_inset LatexCommand \label{Radio Response Creation Form}
1252:
1253: \end_inset
1254:
1255:
1256: \end_float
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}
1262:
1263: \end_inset
1264:
1265: , select
1266: \series bold
1267: Radio Response Problem
1268: \series default
1269: , and click the
1270: \series bold
1271: New Problem
1272: \series default
1273: button.
1274: \layout Enumerate
1275:
1276: Click the
1277: \series bold
1278: Edit
1279: \series default
1280: button above the sample problem to enter edit mode.
1281: \layout Enumerate
1282:
1283: In the
1284: \series bold
1285: Text Block
1286: \series default
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
1292:
1293: What is two plus two?
1294: \begin_inset Quotes erd
1295: \end_inset
1296:
1297:
1298: \layout Enumerate
1299:
1300: Locate the
1301: \series bold
1302: Response: One of N statements
1303: \series default
1304: element.
1305: In the
1306: \series bold
1307: Max Number of Shown Foils
1308: \series default
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
1319:
1320: into this box.
1321: \layout Enumerate
1322:
1323: Locate
1324: \series bold
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
1670: place the following four things each in their own concept group:
1671: \layout Itemize
1672:
1673: Claire de Lune
1674: \begin_inset LatexCommand \index{Clair de Lune}
1675:
1676: \end_inset
1677:
1678:
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:
2236: Creating Numerical Response And Formula Response Problems
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: .
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 \)
2249: \end_inset
2250:
2251: .
2252: The answer may be in any equivalent format.
2253: For instance, for
2254: \begin_inset Formula \( x^{2}+11 \)
2255: \end_inset
2256:
2257: , the system will accept
2258: \begin_inset Formula \( x*x-11 \)
2259: \end_inset
2260:
2261: or
2262: \begin_inset Formula \( x^{2}+21-10 \)
2263: \end_inset
2264:
2265: as well.
2266: \layout Standard
2267:
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}
2274:
2275: \end_inset
2276:
2277: for Numerical Response problems and section
2278: \begin_inset LatexCommand \ref{Formula Response}
2279:
2280: \end_inset
2281:
2282: for Formula Response problems.
2283: \layout Section
2284:
2285: Publishing Your Resources
2286: \layout Standard
2287:
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}
2300:
2301: \end_inset
2302:
2303:
2304: \begin_inset LatexCommand \label{What Is Metadata?}
2305:
2306: \end_inset
2307:
2308:
2309: \layout Standard
2310:
2311:
2312: \emph on
2313: Metadata
2314: \emph default
2315: is
2316: \emph on
2317: data about data
2318: \emph default
2319: .
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
2331:
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.
2338: \layout Subsection
2339:
2340: Publishing A Resource
2341: \begin_inset LatexCommand \index{Resource, Publishing}
2342:
2343: \end_inset
2344:
2345:
2346: \begin_inset LatexCommand \index{Publishing Resource}
2347:
2348: \end_inset
2349:
2350:
2351: \layout Standard
2352:
2353: \begin_float fig
2354: \layout Standard
2355: \align center
2356:
2357: \begin_inset Figure size 476 168
2358: file constructionSpaceForPublishing.eps
2359: width 3 80
2360: flags 9
2361:
2362: \end_inset
2363:
2364:
2365: \layout Caption
2366:
2367: Construction Space for Publishing
2368: \begin_inset LatexCommand \label{Construction Space for Publishing Figure}
2369:
2370: \end_inset
2371:
2372:
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}
2382:
2383: \end_inset
2384:
2385: .
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
2394:
2395: \begin_inset Figure size 476 338
2396: file publishMetadata.eps
2397: width 3 80
2398: flags 9
2399:
2400: \end_inset
2401:
2402:
2403: \layout Caption
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: ).
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.
2531: \layout Section
2532:
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.
2543: \layout Subsection
2544:
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}
2616:
2617: \end_inset
2618:
2619: .
2620: Click the button to get to the sequence editor.
2621:
2622: \begin_float fig
2623: \layout Standard
2624: \align center
2625:
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
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)
4110: \series default
4111: will log you out of the LON-CAPA system.
4112: \layout Standard
4113:
4114:
4115: \begin_inset LatexCommand \printindex{}
4116:
4117: \end_inset
4118:
4119:
4120: \the_end
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>