Annotation of doc/tutorial/tutorial.lyx, revision 1.2
1.1 bowersj2 1: #LyX 1.1 created this file. For more info see http://www.lyx.org/
2: \lyxformat 218
3: \textclass article
4: \begin_preamble
5: \usepackage{floatflt}
6: \end_preamble
7: \language english
8: \inputencoding auto
1.2 ! bowersj2 9: \fontscheme default
1.1 bowersj2 10: \graphics default
1.2 ! bowersj2 11: \paperfontsize 12
1.1 bowersj2 12: \spacing single
13: \papersize Default
14: \paperpackage a4
15: \use_geometry 1
16: \use_amsmath 0
17: \paperorientation portrait
1.2 ! bowersj2 18: \leftmargin 1in
1.1 bowersj2 19: \topmargin 1.25in
1.2 ! bowersj2 20: \rightmargin 1in
! 21: \bottommargin 1in
1.1 bowersj2 22: \secnumdepth 3
23: \tocdepth 3
24: \paragraph_separation indent
25: \defskip medskip
26: \quotes_language english
27: \quotes_times 2
28: \papercolumns 1
29: \papersides 1
30: \paperpagestyle fancy
31:
32: \layout Title
33:
34: Introduction to the Learning
35: \emph on
36: Online
37: \emph default
38: Network with CAPA
39: \layout Standard
1.2 ! bowersj2 40: \added_space_top vfill \align center
! 41: \SpecialChar ~
! 42:
! 43: \layout Standard
! 44: \align center
! 45: This manual was developed by John Williamson in the Office of Medical Education
! 46: Research and Development.
! 47: Some information in thie manual is adapted from the
! 48: \begin_inset Quotes eld
! 49: \end_inset
! 50:
! 51: LON-CAPA Workshop Demo
! 52: \begin_inset Quotes erd
! 53: \end_inset
! 54:
! 55: developed by Felicia Berryman in the Laboratory for Instructional Technology
! 56: in Education.
! 57: \layout Standard
! 58:
! 59: \SpecialChar ~
! 60:
! 61: \layout Standard
! 62: \pagebreak_bottom \align center
1.1 bowersj2 63: Laboratory for Instructional Technology in Education
64: \newline
65: and the
66: \newline
67: Office of Medical Education Research and Development
68: \newline
69: Michigan State University
70: \newline
71:
72: \layout Standard
73: \pagebreak_bottom
74:
75: \begin_inset LatexCommand \tableofcontents{}
76:
77: \end_inset
78:
79:
80: \layout Section
81:
82: Introduction to LON-CAPA
83: \layout Comment
84:
85: This is a comment which will not show in any other rendering of this document.
86: I will use them to document my observations as I work through this tutorial.
87: \layout Comment
88:
89: Imagine a big
90: \begin_inset Quotes eld
91: \end_inset
92:
93: IMHO
94: \begin_inset Quotes erd
95: \end_inset
96:
97: on all of these comments; I'm just going to give you my comments straight
98: out.
99: I'm not attached to them and won't be offended by anything you say or do
100: about them.
101: \layout Standard
102:
103: LON-CAPA is a web-based interface that helps to organize and present your
104: course website, deliver and manage problem problems, and manage student
105: enrollment.
106: All author functions are done using a web browser (Netscape 4.x or higher
107: is recommended) and the LON-CAPA Author Interface.
108: The URL for LON-CAPA is
109: \family typewriter
110: http://s10.lite.msu.edu
111: \family default
112: .
113: \layout Standard
114:
115: At this time, you should have:
116: \layout Itemize
117:
118: developed your objectives for your course.
119:
120: \layout Itemize
121:
122: developed your problems for testing and identified the question formats.
123: The Template for Mapping Website to LON-CAPA that you filled in will assist
124: you in the process of creating your course website structure in LON-CAPA.
125: \layout Standard
126:
127: This tutorial describes how to use the various author functions available
128: in LON-CAPA.
129: \layout Section
130:
131: The LON-CAPA Author Interface
132: \layout Subsection
133:
134: Login as Course Author
135: \begin_inset LatexCommand \index{Course Author}
136:
137: \end_inset
138:
139:
140: \layout Standard
141:
142: To begin using LON-CAPA, you first need to log in to your account on LON-CAPA.
143: Open your web browser and navigate to the LON-CAPA URL:
144: \family typewriter
145: http://s10.lite.msu.edu/
146: \family default
147: .
148: You will be presented with a log in screen as in figure
149: \begin_inset LatexCommand \ref{LON-CAPA Log in screen}
150:
151: \end_inset
152:
153: .
154:
155: \begin_float fig
156: \layout Standard
157: \align center
158:
159: \begin_inset Figure size 297 234
160: file login.eps
161: width 3 50
162: flags 11
163:
164: \end_inset
165:
166:
1.2 ! bowersj2 167: \layout Caption
! 168:
! 169:
! 170: \begin_inset LatexCommand \label{LON-CAPA Log in screen}
! 171:
! 172: \end_inset
! 173:
! 174: LON-CAPA Log in screen
1.1 bowersj2 175: \end_float
176: \layout Standard
177:
178: Fill in the Username and Password boxes with your information.
179: Then press the Login button.
180: This will take you to your LON-CAPA User Roles menu.
181: \layout Description
182:
183: Note: Your Username is your PILOT ID, which is the part of your PILOT email
184: address to the left of the @.
185: Your password is your PILOT email password.
186: Both the PILOT ID and the password are case sensitive, so make sure you
187: type upper- and lower-case letters correctly.
188: \layout Subsection
189:
190:
191: \begin_inset LatexCommand \index{Author Remote Control}
192:
193: \end_inset
194:
195: Author Remote Control
196: \layout Comment
197:
198: Comment on the remote controls: I'll only mention this once, but imagine
199: this comment exists everywhere a remote control image is used.
200: The whole
201: \begin_inset Quotes eld
202: \end_inset
203:
204: remote control
205: \begin_inset Quotes erd
206: \end_inset
207:
208: metaphor is fundamentally flawed and probably can't be salvaged.
209: Why is it flawed?
210: \layout Comment
211:
212: \SpecialChar ~
213:
214: \layout Comment
215:
216: 1.
217: The remote control invokes a metaphor, that of remote controls.
218: However, remote controls are useful in the real world, despite the overwhelming
219: complexity of modern remotes, for three major reasons: One, they never,
220: ever, ever change.
221: Two, they provide immense amounts of tactile feedback, allowing one to
222: overcome the complexity of using one by putting the knowlege into motor
223: memory.
224: (There are equivalent usability principles in usability, as well; look
225: up Fitt's Law, for instance.) Three, they all basically do the same thing;
226: pick up an unfamiliar TV control and you at least know in advance there
227: will be numbers for channel changing, vol up and down, chan up and down,
228: mute, etc.
229: The remotes used in this system do not have any of these properties.
230: Remotes are actually horrid UI, because they are very, very difficult to
231: learn; they make up for it by being useful and persistent.
232: \layout Comment
233:
234: Further, remotes should *do* things.
235: This remote is like a remote that no matter what button you push, it invokes
236: a menu.
237: Most remotes have
238: \series bold
239: one
240: \series default
241: explicit
242: \begin_inset Quotes eld
243: \end_inset
244:
245: menu
246: \begin_inset Quotes erd
247: \end_inset
248:
249: button to invoke a menu that has all the feature that aren't worth valuable
250: remote control space.
251: \layout Comment
252:
253: In fact, the metaphor is so unsuccessful that any moderately savvy internet
254: user will almost immediately come to conceptualize the remote as just another
255: list of links, albiet a clumsy and inconvenient one.
256: Why not give them that in the first place?
257: \layout Comment
258:
259: \SpecialChar ~
260:
261: \layout Comment
262:
263: 2.
264: Even the simplest
265: \begin_inset Quotes eld
266: \end_inset
267:
268: remote
269: \begin_inset Quotes erd
270: \end_inset
271:
272: I see in the tutorial has eight buttons, which nearly immediately becomes
273: seventeen (!) buttons, all incomprehensible, and I didn't get a chance
274: to count during the interview, but I saw a remote flash by (student remote?
275: admin remote? that wouldn't matter as much) that had at least twenty, probably
276: 24 buttons, again, all or nearly all incomprehensible.
277: This is needlessly intimidating.
278: \layout Comment
279:
280: \SpecialChar ~
281:
282: \layout Comment
283:
284: 3.
285: By commiting to this
286: \begin_inset Quotes eld
287: \end_inset
288:
289: remote control
290: \begin_inset Quotes erd
291: \end_inset
292:
293: layout, you commit to a remote control's layout limitations, except that
294: an actual remote control can get away with a 6pt or smaller font, or wierd
295: specialized symbols, or whatnot.
296: I'm looking at a (real) remote control right now that manages to get
297: \begin_inset Quotes eld
298: \end_inset
299:
300: channel return
301: \begin_inset Quotes erd
302: \end_inset
303:
304: onto one button.
305: That whole phrase fits *twice* into the space the
306: \begin_inset Quotes eld
307: \end_inset
308:
309: ROLES
310: \begin_inset Quotes erd
311: \end_inset
312:
313: button takes up on my printout! So in actuality, you're commiting to something
314: no sane remote control designer could deal with.
315: Moreover, I observe that on a real remote, the vast majority of buttons
316: are labelled with one conceptual entity (i.e.,
317: \begin_inset Quotes eld
318: \end_inset
319:
320: 1
321: \begin_inset Quotes erd
322: \end_inset
323:
324: ,
325: \begin_inset Quotes eld
326: \end_inset
327:
328: 5
329: \begin_inset Quotes erd
330: \end_inset
331:
332: ,
333: \begin_inset Quotes eld
334: \end_inset
335:
336: FF
337: \begin_inset Quotes erd
338: \end_inset
339:
340: ,
341: \begin_inset Quotes eld
342: \end_inset
343:
344: [the pause symbol]
345: \begin_inset Quotes erd
346: \end_inset
347:
348: , etc)., not
349: \begin_inset Quotes eld
350: \end_inset
351:
352: Change User
353: \begin_inset Quotes erd
354: \end_inset
355:
356: which is two entities by my count, at least for an initial user.
357: \layout Comment
358:
359: \SpecialChar ~
360:
361: \layout Comment
362:
363: 4.
364: Requiring the user to mouse over something to see what it does is not a
365: solution.
366: Limiting yourself to an 8 by 2 array of characters to explain yourself
367: compounds the problem even more.
368: (Another over-literal extension of the remote control metaphor.) Also, as
369: you may have observed, the accessibility of this is nil.
370:
371: \layout Comment
372:
373: \SpecialChar ~
374:
375: \layout Comment
376:
377: The upshot is that the only upside to the remote control is a moderately
378: pleasing graphic; the downsides are pretty much everything, up to and including
379: possible illegality under accessability laws.
380: Unfortunately, I do not see any way to salvage any aspect of the remote
381: control; it's going to suck until it's replaced.
382: Pleasing graphics are relatively easy to come by nowadays; it should not
383: drive the design.
384: I'll admit (freely!) I'm not a graphics designer...
385: graphics designers aren't web developers (designers), either.
386: \layout Comment
387:
388: \SpecialChar ~
389:
390: \layout Comment
391:
392: Also, based on my relatively little info, I think you're data-mining the
393: web logs to see what people actually use.
394: This is good.
395: We may need to do some really simple stuff before he finishes.
396: Raw statistics on what buttons are pressed most often can probably be interpret
397: ed easily enough for our purposes.
398: No matter what the final design is, it should emphasize the two or three
399: commands used day in and day out, as determined by empirical analysis,
400: and shuffle the other commands onto another sub menu or sub menus.
401: Then, use the additional space you'll have (even if you keep the same size
402: window) and actually *spell out* the options.
403:
404: \layout Standard
405:
406: The Author Remote Control, show in figure
407: \begin_inset LatexCommand \ref{Author Remote Control Figure}
408:
409: \end_inset
410:
411: , will automatically load whenever you log in to LON-CAPA as the course
412: instructor.
413: The Author Remote Control is a separate window in your browser, so you
414: may position it on the screen where you can make the best use of it.
415: The Remote Control is a tool that allows you to switch between functions
416: and roles within LON-CAPA.
1.2 ! bowersj2 417:
1.1 bowersj2 418: \begin_float fig
1.2 ! bowersj2 419: \layout Standard
! 420: \align center
1.1 bowersj2 421:
1.2 ! bowersj2 422: \begin_inset Figure size 177 420
! 423: file authorRemote.eps
! 424: height 3 50
! 425: flags 9
1.1 bowersj2 426:
427: \end_inset
428:
429:
1.2 ! bowersj2 430: \layout Caption
1.1 bowersj2 431:
1.2 ! bowersj2 432: Author Remote Control
! 433: \begin_inset LatexCommand \label{Author Remote Control Figure}
1.1 bowersj2 434:
435: \end_inset
436:
437:
438: \end_float
1.2 ! bowersj2 439: \layout Comment
! 440:
1.1 bowersj2 441: Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any*
442: sort of sense on a first glance.
443: Abbreviations are evil in this sort of application and should be used as
444: a truly last resort.
445: \layout Standard
446:
447: When you move your mouse over the buttons in the remote, the sixteen gray
448: boxes will show a reminder of what that button does.
449: \layout Itemize
450:
451:
452: \series bold
453: ROLES (CHOOSE ROLE)
454: \series default
455: allows you to select which user role to assume for this session.
456: \layout Itemize
457:
458:
459: \series bold
460: COM (COMMUNICATION)
461: \series default
462: allows you to access the communication functions in the system.
463: \layout Itemize
464:
465:
466: \series bold
467: CUSR (USER ROLES)
468: \series default
469: brings up a page that allows you to create new users and change user privileges.
470: \layout Itemize
471:
472:
473: \series bold
474: CSTR (CONSTRUCT)
475: \series default
476: displays the construction space for your account.
477: \layout Itemize
478:
479:
480: \series bold
481: RES (RESOURCE SPACE)
482: \series default
483: allows you to browse the LON-CAPA network directory.
484: \layout Itemize
485:
486:
487: \series bold
488: EGRD (ENTER GRADES)
489: \series default
490: is used to enter grades for students enrolled in your course.
491: \layout Itemize
492:
493:
494: \series bold
495: SRC (SEARCH LIBRARY)
496: \series default
497: brings up a screen that lets you search the LON-CAPA resources using multiple
498: criteria.
499: \layout Itemize
500:
501:
502: \series bold
503: LOGOUT (LOGOUT)
504: \series default
505: will log you out of the LON-CAPA system.
506: \layout Section
507:
508: Creating Content Using LON-CAPA
509: \layout Standard
510:
511: LON-CAPA provides three types of resources for organizing your course website.
512: LON-CAPA refers to these resources as Content Pages, Problems, and Maps.
513: Maps may be either of two types: Sequences or Pages.
514: You will use these LON-CAPA resources to build the outline, or structure,
515: for the presentation of your course to your students.
516: \layout Itemize
517:
518: A
519: \series bold
520: Content Page
521: \series default
522:
523: \begin_inset LatexCommand \index{Content Page}
524:
525: \end_inset
526:
527: displays course content.
528: It is mostly a conventional HTML page.
529:
530: \layout Comment
531:
532: Check this; is it exactly like HTML pages?
533: \layout Itemize
534:
535: A
536: \series bold
537: Problem
538: \series default
539:
540: \begin_inset LatexCommand \index{Problem}
541:
542: \end_inset
543:
544: resource represents problems for the students to solve, with answers stored
545: in the system.
546: These resources are stored in files that must use the extension
547: \begin_inset Quotes eld
548: \end_inset
549:
550: .problem
551: \begin_inset Quotes erd
552: \end_inset
553:
554: .
555: \layout Itemize
556:
557: A
558: \series bold
559: Map
560: \series default
561:
562: \begin_inset LatexCommand \index{Map}
563:
564: \end_inset
565:
566: resource of the
567: \series bold
568: Sequence
569: \begin_inset LatexCommand \index{Sequence}
570:
571: \end_inset
572:
573:
574: \series default
575: type represents a programmed series of events.
576: The users of this resource can use array keys or NAV buttons to follow
577: the sequence.
578: These resources are stored in files that must use the extension
579: \begin_inset Quotes eld
580: \end_inset
581:
582: .sequence
583: \begin_inset Quotes erd
584: \end_inset
585:
586: .
587: \layout Comment
588:
589: What
590: \begin_inset Quotes eld
591: \end_inset
592:
593: arrow keys
594: \begin_inset Quotes erd
595: \end_inset
596:
597: ? Surely not the ones on the keyboard\SpecialChar \ldots{}
598:
599: \layout Itemize
600:
601: A
602: \series bold
603: Map
604: \series default
605:
606: \begin_inset LatexCommand \index{Map}
607:
608: \end_inset
609:
610: resource of the
611: \series bold
612: Page
613: \series default
614:
615: \begin_inset LatexCommand \index{Page}
616:
617: \end_inset
618:
619: type display multiple resources together.
620: For example, a page of problems will appears as a problem set.
621: These resources are stored in files that must use the extension
622: \begin_inset Quotes eld
623: \end_inset
624:
625: .page
626: \begin_inset Quotes erd
627: \end_inset
628:
629: .
630: \layout Subsection
631:
632: Description of the Construction Space
633: \layout Standard
634:
635: \begin_float fig
1.2 ! bowersj2 636: \layout Standard
! 637: \align center
! 638:
! 639: \begin_inset Figure size 476 42
! 640: file constructionSpace.eps
! 641: width 3 80
! 642: flags 9
! 643:
! 644: \end_inset
! 645:
! 646:
1.1 bowersj2 647: \layout Caption
648:
649: Construction Space
650: \begin_inset LatexCommand \label{Construction Space Figure}
651:
652: \end_inset
653:
654:
655: \end_float
656: The Construction Space, as seen in figure
657: \begin_inset LatexCommand \ref{Construction Space Figure}
658:
659: \end_inset
660:
661: , is the section of LON-CAPA where you create and manage your course resources.
662: The Construction Space consists of a green tool bar at the top of the page
663: and a list of all directories and resources below.
664: \layout Standard
665:
666:
667: \begin_inset Tabular
668: <lyxtabular version="2" rows="10" columns="2">
669: <features rotate="false" islongtable="true" endhead="0" endfirsthead="0" endfoot="0" endlastfoot="0">
670: <column alignment="center" valignment="top" leftline="true" rightline="false" width="" special="">
671: <column alignment="left" valignment="top" leftline="true" rightline="true" width="5in" special="">
672: <row topline="true" bottomline="true" newpage="false">
673: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
674: \begin_inset Text
675:
676: \layout Standard
677:
678:
679: \series bold
680: Button Name
681: \end_inset
682: </cell>
683: <cell multicolumn="0" alignment="left" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
684: \begin_inset Text
685:
686: \layout Standard
687:
688:
689: \series bold
690: Description
691: \end_inset
692: </cell>
693: </row>
694: <row topline="true" bottomline="false" newpage="false">
695: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
696: \begin_inset Text
697:
698: \layout Standard
699:
700: Publish this Resource
701: \end_inset
702: </cell>
703: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
704: \begin_inset Text
705:
706: \layout Standard
707:
1.2 ! bowersj2 708: Opens the Resource Publishing window.
1.1 bowersj2 709: \end_inset
710: </cell>
711: </row>
712: <row topline="true" bottomline="false" newpage="false">
713: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
714: \begin_inset Text
715:
716: \layout Standard
717:
718: List Directory
719: \end_inset
720: </cell>
721: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
722: \begin_inset Text
723:
724: \layout Standard
725:
726: Lists the contents of the current working directory
727: \end_inset
728: </cell>
729: </row>
730: <row topline="true" bottomline="false" newpage="false">
731: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
732: \begin_inset Text
733:
734: \layout Standard
735:
736: Copy
737: \end_inset
738: </cell>
739: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
740: \begin_inset Text
741:
742: \layout Standard
743:
744: Type a new name in the entry box to make a copy the current resource
745: \end_inset
746: </cell>
747: </row>
748: <row topline="true" bottomline="false" newpage="false">
749: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
750: \begin_inset Text
751:
752: \layout Standard
753:
754: Browse
755: \end_inset
756: </cell>
757: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
758: \begin_inset Text
759:
760: \layout Standard
761:
1.2 ! bowersj2 762: Helps you select a file to upload
1.1 bowersj2 763: \end_inset
764: </cell>
765: </row>
766: <row topline="true" bottomline="false" newpage="false">
767: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
768: \begin_inset Text
769:
770: \layout Standard
771:
772: Upload File
773: \end_inset
774: </cell>
775: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
776: \begin_inset Text
777:
778: \layout Standard
779:
780: Uploads the selected file to your Construction Space
781: \end_inset
782: </cell>
783: </row>
784: <row topline="true" bottomline="false" newpage="false">
785: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
786: \begin_inset Text
787:
788: \layout Standard
789:
790: Retrieve Old Version
791: \end_inset
792: </cell>
793: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
794: \begin_inset Text
795:
796: \layout Standard
797:
798: Load an older version of a resource if you have multiple versions
799: \end_inset
800: </cell>
801: </row>
802: <row topline="true" bottomline="false" newpage="false">
803: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
804: \begin_inset Text
805:
806: \layout Standard
807:
808: Delete
809: \end_inset
810: </cell>
811: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
812: \begin_inset Text
813:
814: \layout Standard
815:
816: Deletes the current resource
817: \end_inset
818: </cell>
819: </row>
820: <row topline="true" bottomline="false" newpage="false">
821: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
822: \begin_inset Text
823:
824: \layout Standard
825:
826: Rename
827: \end_inset
828: </cell>
829: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
830: \begin_inset Text
831:
832: \layout Standard
833:
834: Type a new name in the associated entry box to rename a resource
835: \end_inset
836: </cell>
837: </row>
838: <row topline="true" bottomline="true" newpage="false">
839: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">
840: \begin_inset Text
841:
842: \layout Standard
843:
844: New Subdirectory
845: \end_inset
846: </cell>
847: <cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">
848: \begin_inset Text
849:
850: \layout Standard
851:
852: Type a name in the entry box to create a new directory
853: \end_inset
854: </cell>
855: </row>
856: </lyxtabular>
857:
858: \end_inset
859:
860:
861: \layout Subsection
862:
863: How to Create New Content Pages
1.2 ! bowersj2 864: \begin_inset LatexCommand \label{Creating New Content Pages}
! 865:
! 866: \end_inset
! 867:
! 868:
1.1 bowersj2 869: \layout Standard
870:
871:
872: \series bold
873: Content Pages
874: \series default
875: are HTML documents that display the course information you are presenting.
876: These documents can be created in any order.
877: \layout Comment
878:
879: Is this worth mentioning?
880: \layout Standard
881:
882: To create new Content Pages, do the following:
883: \layout Comment
884:
885: Is step one necessary? I don't see how it could be.
886: \layout Enumerate
887:
888: Click the
889: \series bold
890: CSTR
891: \series default
892: button on the LON-CAPA remote.
893: You web page will change to your Construction Space.
894: \layout Enumerate
895:
896: In Location bar of your browser, type in full URL of the new Content Page.
897: Make sure the last part of the URL ends with
898: \begin_inset Quotes eld
899: \end_inset
900:
901: .html
902: \begin_inset Quotes erd
903: \end_inset
904:
905: , for example,
906: \emph on
1.2 ! bowersj2 907: http://www.s10.lite.msu.edu/priv/\SpecialChar \-
! 908: directory/new_resource.html
1.1 bowersj2 909: \emph default
910: .
911: Press the Return or Enter key.
912: \layout Enumerate
913:
914: You should see something like the following message:
915: \series bold
1.2 ! bowersj2 916: File not found: /home/wmsonj/priv/\SpecialChar \-
! 917: directory/new_resource.html
1.1 bowersj2 918: \series default
919: , and an Edit button.
1.2 ! bowersj2 920: Click the
! 921: \begin_inset Quotes eld
! 922: \end_inset
! 923:
! 924: Edit
! 925: \begin_inset Quotes erd
! 926: \end_inset
! 927:
! 928: button, and an HTML editor will open with a simple page template.
1.1 bowersj2 929: \layout Enumerate
930:
931: Type the content into the editor,
1.2 ! bowersj2 932: \emph on
1.1 bowersj2 933: OR
1.2 ! bowersj2 934: \emph default
1.1 bowersj2 935: copy and paste HTML source code into the editor.
936: \layout Enumerate
937:
938: Optionally, click the
939: \series bold
940: View
941: \series default
942: button to preview your Content Page.
943: \layout Enumerate
944:
945: Finally, click the
946: \series bold
947: Save this
948: \series default
949: button
1.2 ! bowersj2 950: \emph on
1.1 bowersj2 951: OR
1.2 ! bowersj2 952: \emph default
1.1 bowersj2 953: click the
954: \series bold
955: Save and then attempt to clean HTML
956: \series default
957: button.
958: \layout Standard
959:
960: Repeat this process as many times as necessary to create your Content Pages.
961: \layout Subsection
962:
963: How to Edit Existing Content Pages
964: \layout Standard
965:
966: You may edit any any Content Pages that have been created.
967: \layout Standard
968:
969: To edit Content Pages:
970: \layout Enumerate
971:
972: Click the
973: \series bold
974: CSTR
975: \series default
976: button on the LON-CAPA Remote.
977: Your web page will change to your Construction Space.
978: \layout Enumerate
979:
980: Click on the link for the name of the Content Page to edit.
981: The Content Page editor will load and display the current edition of the
982: Content Page.
983: \layout Enumerate
984:
985: Press the Edit button.
986: Edit the HTML code, or copy and paste HTML source code into the editor.
987: \layout Enumerate
988:
989: Optionally, click the
990: \series bold
991: View
992: \series default
993: button to preview your Content Page.
994: \layout Enumerate
995:
996: Finally, click the
997: \series bold
998: Save this
999: \series default
1000: button
1.2 ! bowersj2 1001: \emph on
1.1 bowersj2 1002: OR
1.2 ! bowersj2 1003: \emph default
1.1 bowersj2 1004: click the
1005: \series bold
1006: Save and then attempt to clean HTML
1007: \series default
1008: button.
1009: If you do not do this, your work will not be saved.
1010: \layout Subsection
1011:
1012: Creating Online Problems Using LON-CAPA
1013: \layout Subsubsection
1014:
1015: Problems Types
1016: \layout Standard
1017:
1018: There are five types of problems that can be created with the LON-CAPA system:
1019: Radio Response, Option Response, String Response, Numerical Response, and
1020: Formula Response.
1021: You will need to identify which types of problem you want to use and create
1022: appropriate questions for your course.
1023: \layout Subsubsection
1024:
1.2 ! bowersj2 1025: Foils
! 1026: \layout Standard
! 1027:
! 1028: In the LON-CAPA system, a
! 1029: \series bold
! 1030: Foil
! 1031: \begin_inset LatexCommand \index{Foil}
! 1032:
! 1033: \end_inset
! 1034:
! 1035:
! 1036: \series default
! 1037: is a choice in a Radio Response or Option Response problem.
! 1038: For instance, True/False problems have two foils, one for True, and one
! 1039: for False.
! 1040: Foils do not need to be text; they can be images or other resources.
! 1041: \layout Subsubsection
! 1042:
1.1 bowersj2 1043: Radio Response
1044: \begin_inset LatexCommand \index{Radio Response}
1045:
1046: \end_inset
1047:
1048: Problems
1049: \layout Standard
1050:
1.2 ! bowersj2 1051:
! 1052: \series bold
! 1053: Radio Response
! 1054: \series default
! 1055: problems represent multiple choice questions.
! 1056: A True/False problem is a special case of Radio Response problem with two
! 1057: foils, True or False.
1.1 bowersj2 1058: \layout Standard
1059:
1.2 ! bowersj2 1060: Multiple choice problems contain between 3 and 10 foils.
! 1061: You may display from three to five foils for each problem and the system
! 1062: randomly picks the choices that are presented to the student.
! 1063: \layout Comment
! 1064:
! 1065: Eh? If this means what I think it means, clarify.
! 1066: Is the system really incapable of showing eight choices all at once?
! 1067: \layout Subsubsection
! 1068:
! 1069: Option Response
! 1070: \begin_inset LatexCommand \index{Option Response}
1.1 bowersj2 1071:
1.2 ! bowersj2 1072: \end_inset
1.1 bowersj2 1073:
1.2 ! bowersj2 1074: Problems
1.1 bowersj2 1075: \layout Standard
1076:
1077: Option Response problems present foils to the student with drop-down boxes.
1.2 ! bowersj2 1078: A group of foils is created for each concept group, and the system will
! 1079: pick one to present to the student from each group.
! 1080: The student must match each of his or her questions correctly to the possible
! 1081: answers before receiving credit for the problem.
! 1082: For more details, see the Create Option Response (
! 1083: \begin_inset LatexCommand \ref{Create Option Response Problem}
! 1084:
! 1085: \end_inset
! 1086:
! 1087: ).
! 1088: \layout Subsubsection
1.1 bowersj2 1089:
1090: String Response Problems
1091: \layout Standard
1092:
1.2 ! bowersj2 1093:
! 1094: \series bold
! 1095:
! 1096: \begin_inset LatexCommand \index{String Response}
! 1097:
! 1098: \end_inset
! 1099:
! 1100: String Response
! 1101: \series default
! 1102: problems are problems in which the student submits a string of characters
! 1103: for the answer.
1.1 bowersj2 1104: Examples of string response questions are vocabulary tests, short answer
1105: and entering chemical formulas.
1.2 ! bowersj2 1106: \layout Comment
! 1107:
! 1108: Case sensitivity?
1.1 bowersj2 1109: \layout Standard
1110:
1.2 ! bowersj2 1111: Note that it is easy to abuse String Response problems.
! 1112: For instance, consider the question
! 1113: \begin_inset Quotes eld
! 1114: \end_inset
! 1115:
! 1116: Who wrote 'Huckleberry Finn'?
! 1117: \begin_inset Quotes erd
! 1118: \end_inset
! 1119:
! 1120: If you tell the system the answer is
! 1121: \begin_inset Quotes eld
! 1122: \end_inset
! 1123:
! 1124: Mark Twain
! 1125: \begin_inset Quotes erd
! 1126: \end_inset
! 1127:
! 1128: , and a student answers
! 1129: \begin_inset Quotes eld
! 1130: \end_inset
! 1131:
! 1132: Twain
! 1133: \begin_inset Quotes erd
! 1134: \end_inset
! 1135:
! 1136: , the system will mark it wrong.
! 1137: If they answer
! 1138: \begin_inset Quotes eld
! 1139: \end_inset
! 1140:
! 1141: Samuel Clements
! 1142: \begin_inset Quotes erd
! 1143: \end_inset
! 1144:
! 1145: , then the student will definately get it wrong.
! 1146: There is some room for flexibility in the string processing, but it can
! 1147: be difficult to get it all right.
! 1148: Before you use a String Response problem, be sure you can easily characterize
! 1149: correct answers.
! 1150: \layout Comment
! 1151:
! 1152: Check this stuff.
! 1153: \layout Subsubsection
! 1154:
1.1 bowersj2 1155: Numerical Response Problems
1156: \layout Standard
1157:
1.2 ! bowersj2 1158:
! 1159: \series bold
! 1160: Numerical Response
! 1161: \begin_inset LatexCommand \index{Numerical Response}
! 1162:
! 1163: \end_inset
! 1164:
! 1165:
! 1166: \series default
! 1167: problems are answered by entering a number and (optionally) a unit, such
! 1168: as 2.5 m/s^2.
1.1 bowersj2 1169: Tolerance and significant digits can be specified as well.
1.2 ! bowersj2 1170: \layout Subsubsection
1.1 bowersj2 1171:
1172: Formula Response Problems
1173: \layout Standard
1174:
1175: Formula Response problems are questions in which the student types in a
1176: math formula for the answer.
1.2 ! bowersj2 1177: If the answer is
! 1178: \begin_inset Formula \( x^{2}-11 \)
! 1179: \end_inset
! 1180:
! 1181: , the student can enter "x^2 - 11", "x*x - 11", "x^2 + 21 - 10", etc.
1.1 bowersj2 1182: Functions such as cos, sin, and exp are accepted as well as the operators
1183: (), +, -, *, and /.
1.2 ! bowersj2 1184: \layout Subsection
! 1185:
! 1186: Creating Radio Response Problems
! 1187: \layout Standard
1.1 bowersj2 1188:
1.2 ! bowersj2 1189: \begin_float fig
1.1 bowersj2 1190: \layout Standard
1.2 ! bowersj2 1191: \align center
! 1192:
! 1193: \begin_inset Figure size 476 201
! 1194: file creatingNewProblemResource.eps
! 1195: width 3 80
! 1196: flags 13
! 1197:
! 1198: \end_inset
! 1199:
! 1200:
! 1201: \layout Caption
! 1202:
! 1203: Creating A New Problem Resource
! 1204: \begin_inset LatexCommand \label{Creating a new problem resource}
! 1205:
! 1206: \end_inset
! 1207:
! 1208:
! 1209: \end_float
! 1210: To create an Radio Response
! 1211: \begin_inset LatexCommand \index{Radio Response}
! 1212:
! 1213: \end_inset
! 1214:
! 1215: problem, create a new resource as described in section
! 1216: \begin_inset LatexCommand \ref{Creating New Content Pages}
! 1217:
! 1218: \end_inset
! 1219:
! 1220: .
! 1221: This is a
! 1222: \begin_inset Quotes eld
! 1223: \end_inset
! 1224:
! 1225: problem
! 1226: \begin_inset Quotes erd
! 1227: \end_inset
! 1228:
! 1229: resource so the URL must end in
! 1230: \begin_inset Quotes eld
! 1231: \end_inset
! 1232:
! 1233: .problem
! 1234: \begin_inset Quotes erd
! 1235: \end_inset
! 1236:
! 1237: .
! 1238: You should see a screen as in figure
! 1239: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 1240:
! 1241: \end_inset
1.1 bowersj2 1242:
1.2 ! bowersj2 1243: .
1.1 bowersj2 1244: \begin_float fig
1.2 ! bowersj2 1245: \layout Standard
! 1246: \align center
! 1247:
! 1248: \begin_inset Figure size 476 283
! 1249: file radioResponse2.eps
! 1250: width 3 80
! 1251: flags 9
! 1252:
! 1253: \end_inset
! 1254:
! 1255:
1.1 bowersj2 1256: \layout Caption
1257:
1.2 ! bowersj2 1258: Radio Response Creation Form
! 1259: \begin_inset LatexCommand \label{Radio Response Creation Form}
1.1 bowersj2 1260:
1261: \end_inset
1262:
1263:
1264: \end_float
1.2 ! bowersj2 1265: You will need to create the posible answers and the questions.
! 1266: \layout Enumerate
! 1267:
! 1268: In the drop-down option box as seen in
! 1269: \begin_inset LatexCommand \ref{Creating a new problem resource}
1.1 bowersj2 1270:
1.2 ! bowersj2 1271: \end_inset
1.1 bowersj2 1272:
1.2 ! bowersj2 1273: , select
! 1274: \series bold
! 1275: Radio Response Problem
! 1276: \series default
! 1277: , and click the
1.1 bowersj2 1278: \series bold
1.2 ! bowersj2 1279: New Problem
1.1 bowersj2 1280: \series default
1.2 ! bowersj2 1281: button.
! 1282: \layout Enumerate
1.1 bowersj2 1283:
1.2 ! bowersj2 1284: Click the
1.1 bowersj2 1285: \series bold
1.2 ! bowersj2 1286: Edit
1.1 bowersj2 1287: \series default
1.2 ! bowersj2 1288: button above the sample problem to enter edit mode.
! 1289: \layout Enumerate
1.1 bowersj2 1290:
1.2 ! bowersj2 1291: In the
1.1 bowersj2 1292: \series bold
1.2 ! bowersj2 1293: Text Block
1.1 bowersj2 1294: \series default
1.2 ! bowersj2 1295: at the top of the problem, remove the sample text and type the question
! 1296: for your problem.
! 1297: For example,
! 1298: \begin_inset Quotes eld
! 1299: \end_inset
1.1 bowersj2 1300:
1.2 ! bowersj2 1301: What is two plus two?
! 1302: \begin_inset Quotes erd
! 1303: \end_inset
1.1 bowersj2 1304:
1305:
1.2 ! bowersj2 1306: \layout Enumerate
1.1 bowersj2 1307:
1.2 ! bowersj2 1308: Locate the
1.1 bowersj2 1309: \series bold
1.2 ! bowersj2 1310: Response: One of N statements
1.1 bowersj2 1311: \series default
1.2 ! bowersj2 1312: element.
! 1313: In the
1.1 bowersj2 1314: \series bold
1.2 ! bowersj2 1315: Max Number of Shown Foils
1.1 bowersj2 1316: \series default
1.2 ! bowersj2 1317: text box, place the number of wrong answers you wish to supply to each
! 1318: student, in addition to the correct one.
! 1319: For instance, if you want to display four choices, where one is correct
! 1320: and three are incorrect, enter
! 1321: \begin_inset Quotes eld
! 1322: \end_inset
! 1323:
! 1324: 3
! 1325: \begin_inset Quotes erd
! 1326: \end_inset
1.1 bowersj2 1327:
1.2 ! bowersj2 1328: into this box.
! 1329: \layout Enumerate
1.1 bowersj2 1330:
1.2 ! bowersj2 1331: Locate
1.1 bowersj2 1332: \series bold
1.2 ! bowersj2 1333: Foil 1
! 1334: \series default
! 1335: .
! 1336: Remove the text that is in the text box and put the
! 1337: \emph on
! 1338: correct answer
! 1339: \emph default
! 1340: for the problem in the
! 1341: \series bold
! 1342: Text Block
! 1343: \series default
! 1344: .
! 1345: For example,
! 1346: \begin_inset Quotes eld
! 1347: \end_inset
! 1348:
! 1349: Four.
! 1350: \begin_inset Quotes erd
! 1351: \end_inset
! 1352:
! 1353:
! 1354: \layout Enumerate
! 1355:
! 1356: Below it, you will see
! 1357: \series bold
! 1358: Foil 2
! 1359: \series default
! 1360: .
! 1361: Remove the text in the text box and put an
! 1362: \emph on
! 1363: incorrect answer
! 1364: \emph default
! 1365: for the problem.
! 1366: For instance,
! 1367: \begin_inset Quotes eld
! 1368: \end_inset
! 1369:
! 1370: Purple.
! 1371: \begin_inset Quotes erd
! 1372: \end_inset
! 1373:
! 1374:
! 1375: \layout Enumerate
! 1376:
! 1377: Repeat the previous step until you've filled in all of the other incorrect
! 1378: answers you wish to offer the students.
! 1379: \layout Enumerate
! 1380:
! 1381: Once you've filled in all the incorrect answers, change the
! 1382: \series bold
! 1383: Correct Option
! 1384: \series default
! 1385: s on the other foils to
! 1386: \series bold
! 1387: Unused
! 1388: \series default
! 1389: .
! 1390: \layout Enumerate
! 1391:
! 1392: \begin_float fig
! 1393: \layout Standard
! 1394: \align center
! 1395:
! 1396: \begin_inset Figure size 476 92
! 1397: file radioResponseHint.eps
! 1398: width 3 80
! 1399: flags 9
! 1400:
! 1401: \end_inset
! 1402:
! 1403:
! 1404: \layout Caption
! 1405:
! 1406: Hint Element
! 1407: \begin_inset LatexCommand \label{Radio Response Hint Element Figure}
! 1408:
! 1409: \end_inset
! 1410:
! 1411:
! 1412: \end_float
! 1413: Scroll down to the Hint element, as shown in Figure
! 1414: \begin_inset LatexCommand \ref{Radio Response Hint Element Figure}
! 1415:
! 1416: \end_inset
! 1417:
! 1418: .
! 1419: Type some text that will help students when they answer incorrectly.
! 1420: \layout Enumerate
! 1421:
! 1422: Click the
! 1423: \series bold
! 1424: Submit Changes
! 1425: \series default
! 1426: button located at the top of the frame.
! 1427: If you do not do this, none of your changes will be saved.
! 1428: \layout Standard
! 1429:
! 1430: The
! 1431: \series bold
! 1432: Correct Option
! 1433: \series default
! 1434: drop down box controls whether or not a given answer will be accepted as
! 1435: a correct answer.
! 1436: If it is set to
! 1437: \series bold
! 1438: true
! 1439: \series default
! 1440: , that answer will be considered a correct answer.
! 1441: Any number of foils can be marked
! 1442: \series bold
! 1443: true
! 1444: \series default
! 1445: , so you can have questions with multiple correct answers.
! 1446: If it is set to
! 1447: \series bold
! 1448: false
! 1449: \series default
! 1450: , it will be considered an incorrect answer.
! 1451: If it is set to
! 1452: \series bold
! 1453: Unused
! 1454: \series default
! 1455: , the system will not use that foil.
! 1456: \layout Paragraph
! 1457:
! 1458: Randomization
! 1459: \begin_inset LatexCommand \index{Randomization}
! 1460:
! 1461: \end_inset
! 1462:
! 1463:
! 1464: \layout Standard
! 1465:
! 1466: LON-CAPA will randomize what choices are presented to each student, and
! 1467: randomize the order they are presented in.
! 1468: If you wish to present each student the same choices, make sure the
! 1469: \series bold
! 1470: Maximum Number of Shown Foils
! 1471: \series default
! 1472: box contains the number of incorrect answers, which will force them to
! 1473: all be displayed.
! 1474: If you wish to force the system to display the foils in the order you have
! 1475: created them in, type the HTML tag
! 1476: \series bold
! 1477: <norandom>
! 1478: \series default
! 1479: into your problem text.
! 1480: This can be useful with the ever-popular
! 1481: \begin_inset Quotes eld
! 1482: \end_inset
! 1483:
! 1484: All of the above
! 1485: \begin_inset Quotes erd
! 1486: \end_inset
! 1487:
! 1488: choice, which must be displayed in the correct place or its meaning will
! 1489: change.
! 1490: \layout Subsubsection
! 1491:
! 1492: True/False
! 1493: \begin_inset LatexCommand \index{True/False Problem}
! 1494:
! 1495: \end_inset
! 1496:
! 1497: Problem
! 1498: \layout Standard
! 1499:
! 1500: A True/False problem is a Radio Response problem with two choices, True
! 1501: and False.
! 1502: set the
! 1503: \series bold
! 1504: Maximum Number of Shown Foils
! 1505: \series default
! 1506: to
! 1507: \begin_inset Quotes eld
! 1508: \end_inset
! 1509:
! 1510: 1
! 1511: \begin_inset Quotes erd
! 1512: \end_inset
! 1513:
! 1514: , and mark the correct answer
! 1515: \series bold
! 1516: true
! 1517: \series default
! 1518: .
! 1519: For example, for the True/False question
! 1520: \begin_inset Quotes eld
! 1521: \end_inset
! 1522:
! 1523: Napolean conquered Japan in the year 189 A.D.
! 1524: \begin_inset Quotes erd
! 1525: \end_inset
! 1526:
! 1527: , mark the foil containing the answer
! 1528: \begin_inset Quotes eld
! 1529: \end_inset
! 1530:
! 1531: False
! 1532: \begin_inset Quotes erd
! 1533: \end_inset
! 1534:
! 1535: as
! 1536: \series bold
! 1537: true
! 1538: \series default
! 1539: , because it is the correct answer.
! 1540: \layout Subsection
! 1541:
! 1542: Option Response
! 1543: \begin_inset LatexCommand \index{Option Response}
! 1544:
! 1545: \end_inset
! 1546:
! 1547:
! 1548: \begin_inset LatexCommand \label{Create Option Response Problem}
! 1549:
! 1550: \end_inset
! 1551:
! 1552: Problems
! 1553: \layout Standard
! 1554:
! 1555: \begin_float fig
! 1556: \layout Standard
! 1557: \align center
! 1558:
! 1559: \begin_inset Figure size 476 280
! 1560: file optionResponseProblem.eps
! 1561: width 3 80
! 1562: flags 9
! 1563:
! 1564: \end_inset
! 1565:
! 1566:
! 1567: \layout Caption
! 1568:
! 1569: Option Response Problem
! 1570: \begin_inset LatexCommand \label{Option Response Problem Figure}
! 1571:
! 1572: \end_inset
! 1573:
! 1574:
! 1575: \end_float
! 1576: Each Option Response problem has three parts:
! 1577: \layout Enumerate
! 1578:
! 1579: The Concept Groups
! 1580: \begin_inset LatexCommand \index{Concept Groups}
! 1581:
! 1582: \end_inset
! 1583:
! 1584:
! 1585: \layout Enumerate
! 1586:
! 1587: The options for the students to select, by default
! 1588: \begin_inset Quotes eld
! 1589: \end_inset
! 1590:
! 1591: True
! 1592: \begin_inset Quotes erd
! 1593: \end_inset
! 1594:
! 1595: and
! 1596: \begin_inset Quotes eld
! 1597: \end_inset
! 1598:
! 1599: False
! 1600: \begin_inset Quotes erd
! 1601: \end_inset
! 1602:
! 1603:
! 1604: \layout Enumerate
! 1605:
! 1606: The hint for the student
! 1607: \layout Standard
! 1608:
! 1609: Each
! 1610: \series bold
! 1611: Concept Group
! 1612: \series default
! 1613: has some number of foils representing questions which are conceptually
! 1614: related.
! 1615: Option Response Problems can have between 4 and 8 Concept Groups in a problem.
! 1616: When the Option Response problem is presented to a student, the LON-CAPA
! 1617: system will randomly select one foil from each Concept Group and present
! 1618: it to the student.
! 1619: In order to receive credit for the problem, the student must answer all
! 1620: of the Concept Group foils correctly.
! 1621: \layout Subsubsection
! 1622:
! 1623: Example: Concept Group
! 1624: \layout Standard
! 1625:
! 1626: For example, a Concept Group may contain the following True/False questions:
! 1627: \layout Itemize
! 1628:
! 1629:
! 1630: \begin_inset Quotes eld
! 1631: \end_inset
! 1632:
! 1633: Mark Twain
! 1634: \begin_inset Quotes erd
! 1635: \end_inset
! 1636:
! 1637: is the pen name of Samuel Clemens.
! 1638: \layout Itemize
! 1639:
! 1640: Mark Twain wrote
! 1641: \begin_inset Quotes eld
! 1642: \end_inset
! 1643:
! 1644: The Call of the Wild
! 1645: \begin_inset Quotes erd
! 1646: \end_inset
! 1647:
! 1648: .
! 1649: \layout Itemize
! 1650:
! 1651: Mark Twain wrote
! 1652: \begin_inset Quotes eld
! 1653: \end_inset
! 1654:
! 1655: Huckleberry Finn
! 1656: \begin_inset Quotes erd
! 1657: \end_inset
! 1658:
! 1659: .
! 1660: \layout Itemize
! 1661:
! 1662: Mark Twain spent most of his life in the Congo.
! 1663: \layout Standard
! 1664:
! 1665: For each foil, the author marks it True or False.
! 1666: When the student logs on and attempts to answer this question, the student
! 1667: will see only one of the four choices for that concept group.
! 1668: They then go on to do the remaining three to seven Concept Groups in this
! 1669: question before submitting their answer.
! 1670: \layout Subsubsection
! 1671:
! 1672: Example: Matching Problem
! 1673: \layout Standard
! 1674:
! 1675: You might want to ask the student to match musical compositions with their
! 1676: composers.
! 1677: You could create an Option Response problem with 4 Concept Groups, and
! 1678: place the following four things each in one concept group:
! 1679: \layout Itemize
! 1680:
! 1681: Claire de Lune
! 1682: \begin_float footnote
! 1683: \layout Standard
! 1684:
! 1685: Debussy.
! 1686: \end_float
! 1687: \layout Itemize
! 1688:
! 1689: The Pastoral Symphony
! 1690: \begin_float footnote
! 1691: \layout Standard
! 1692:
! 1693: Beethoven's Sixth Symphony.
! 1694: \end_float
! 1695: \layout Itemize
! 1696:
! 1697: Sleeping Beauty Suite
! 1698: \begin_float footnote
! 1699: \layout Standard
! 1700:
! 1701: Tchaikovsky.
! 1702: \end_float
! 1703: \layout Itemize
! 1704:
! 1705: The Dance of the Sugar Plum Fairies
! 1706: \begin_float footnote
! 1707: \layout Standard
! 1708:
! 1709: Also Tchaikovsky, from The Nutcracker.
! 1710: \end_float
! 1711: \layout Standard
! 1712:
! 1713: You could then add the following options to the option list:
! 1714: \layout Itemize
! 1715:
! 1716: Debussy
! 1717: \layout Itemize
! 1718:
! 1719: Beethoven
! 1720: \layout Itemize
! 1721:
! 1722: Schubert
! 1723: \layout Itemize
! 1724:
! 1725: Tchaikovsky
! 1726: \layout Itemize
! 1727:
! 1728: Bach
! 1729: \layout Standard
! 1730:
! 1731: The same answers can be used more then once, or not at all, as you see fit.
! 1732: It is conventional to place such a warning in the
! 1733: \series bold
! 1734: Text Block
! 1735: \series default
! 1736: describing the problem to the students.
! 1737: \layout Subsubsection
! 1738:
! 1739: Creating Option Response Problems
! 1740: \layout Standard
! 1741:
! 1742: To create an Option Response problem, create a new resource as described
! 1743: in section
! 1744: \begin_inset LatexCommand \ref{Creating New Content Pages}
! 1745:
! 1746: \end_inset
! 1747:
! 1748: .
! 1749: This is a
! 1750: \begin_inset Quotes eld
! 1751: \end_inset
! 1752:
! 1753: problem
! 1754: \begin_inset Quotes erd
! 1755: \end_inset
! 1756:
! 1757: resource so the URL must end in
! 1758: \begin_inset Quotes eld
! 1759: \end_inset
! 1760:
! 1761: .problem
! 1762: \begin_inset Quotes erd
! 1763: \end_inset
! 1764:
! 1765: .
! 1766: You should see a screen as in figure
! 1767: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 1768:
! 1769: \end_inset
! 1770:
! 1771: .
! 1772: \layout Enumerate
! 1773:
! 1774: In the drop-down option box as seen in
! 1775: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 1776:
! 1777: \end_inset
! 1778:
! 1779: , select
! 1780: \series bold
! 1781: Option Response Problem with
! 1782: \emph on
! 1783: N
! 1784: \emph default
! 1785: Concept Groups
! 1786: \series default
! 1787: , where
! 1788: \series bold
! 1789: \emph on
! 1790: N
! 1791: \series default
! 1792: \emph default
! 1793: is the number of Concept Groups you wish the problem to have, and click
! 1794: the
! 1795: \series bold
! 1796: New Problem
! 1797: \series default
! 1798: button.
! 1799: \layout Enumerate
! 1800:
! 1801: Click the
! 1802: \series bold
! 1803: Edit
! 1804: \series default
! 1805: button above the sample problem to enter edit mode.
! 1806: \begin_float fig
! 1807: \layout Standard
! 1808: \align center
! 1809:
! 1810: \begin_inset Figure size 476 276
! 1811: file optionResponseEditing.eps
! 1812: width 3 80
! 1813: flags 9
! 1814:
! 1815: \end_inset
! 1816:
! 1817:
! 1818: \layout Caption
! 1819:
! 1820: Option Response Editor
! 1821: \begin_inset LatexCommand \label{Option Response Editor Figure}
! 1822:
! 1823: \end_inset
! 1824:
! 1825:
! 1826: \end_float
! 1827: You should see the Option Response page open up, which should look something
! 1828: like what you see in figure
! 1829: \begin_inset LatexCommand \ref{Option Response Editor Figure}
! 1830:
! 1831: \end_inset
! 1832:
! 1833: .
! 1834: \layout Enumerate
! 1835:
! 1836: Replace the text in the
! 1837: \series bold
! 1838: Text Block
! 1839: \series default
! 1840: with text that explains the conditions for your problem.
! 1841: \layout Enumerate
! 1842:
! 1843: Locate the
! 1844: \series bold
! 1845: Max Number of Shown Foils
! 1846: \series default
! 1847: element and type a number from 1 to 8 to display that number of questions.
! 1848: You cannot display more then one foil from each concept group, so this
! 1849: option will only reduce the number of foils displayed, if it is less then
! 1850: the number of concept groups in your Option Response problem.
! 1851: \layout Enumerate
! 1852:
! 1853: Now you must define the options the students can select.
! 1854: For each option you wish to add to the Option Response question, type the
! 1855: option into the
! 1856: \series bold
! 1857: Add new Option
! 1858: \series default
! 1859: box in the
! 1860: \series bold
! 1861: Select Options
! 1862: \series default
! 1863: section, then hit the
! 1864: \series bold
! 1865: Save Changes
! 1866: \series default
! 1867: button.
! 1868: If you do not hit the
! 1869: \series bold
! 1870: Save Changes
! 1871: \series default
! 1872: button, your option will not be selectable below.
! 1873: \layout Enumerate
! 1874:
! 1875: To delete the irrelevant options from the Option Response question, select
! 1876: that option from the
! 1877: \series bold
! 1878: Delete Option
! 1879: \series default
! 1880: dropdown, and hit the Save Changes button.
! 1881: Do that for each option you wish to remove.
! 1882: \layout Enumerate
! 1883:
! 1884: Now, you need to define the question foils.
! 1885: Look for the foil with the name
! 1886: \begin_inset Quotes eld
! 1887: \end_inset
! 1888:
! 1889: One
! 1890: \begin_inset Quotes erd
! 1891: \end_inset
! 1892:
! 1893: .
! 1894: Type the question into the text box, and select the correct option for
! 1895: that question from the
! 1896: \series bold
! 1897: Correct Option
! 1898: \series default
! 1899: drop-down menu.
! 1900: Click
! 1901: \series bold
! 1902: Submit Changes
! 1903: \series default
! 1904: to save this question foil.
! 1905: Repeat this step for all remaining foils.
! 1906: \layout Enumerate
! 1907:
! 1908: Locate the foils that are not being used.
! 1909: In their
! 1910: \series bold
! 1911: Delete
! 1912: \series default
! 1913: menus, set the value to
! 1914: \series bold
! 1915: Yes
! 1916: \series default
! 1917: .
! 1918: Once you've set the Delete menu value correctly for all the foils, click
! 1919: the
! 1920: \series bold
! 1921: Save Changes
! 1922: \series default
! 1923: button.
! 1924: \layout Enumerate
! 1925:
! 1926: In the Hint area, provide a helpful hint for users who get the problem incorrect
! 1927: , and click the
! 1928: \series bold
! 1929: Save Changes
! 1930: \series default
! 1931: button.
! 1932: \layout Subsection
! 1933:
! 1934: Creating a String Response Problem
! 1935: \layout Standard
! 1936:
! 1937: To create an String Response problem, create a new resource as described
! 1938: in section
! 1939: \begin_inset LatexCommand \ref{Creating New Content Pages}
! 1940:
! 1941: \end_inset
! 1942:
! 1943: .
! 1944: This is a
! 1945: \begin_inset Quotes eld
! 1946: \end_inset
! 1947:
! 1948: problem
! 1949: \begin_inset Quotes erd
! 1950: \end_inset
! 1951:
! 1952: resource so the URL must end in
! 1953: \begin_inset Quotes eld
! 1954: \end_inset
! 1955:
! 1956: .problem
! 1957: \begin_inset Quotes erd
! 1958: \end_inset
! 1959:
! 1960: .
! 1961: You should see a screen as in figure
! 1962: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 1963:
! 1964: \end_inset
! 1965:
! 1966: .
! 1967: \layout Enumerate
! 1968:
! 1969: In the drop-down option box as seen in
! 1970: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 1971:
! 1972: \end_inset
! 1973:
! 1974: , select
! 1975: \series bold
! 1976: Simple String Response Problem
! 1977: \series default
! 1978: , and click the
! 1979: \series bold
! 1980: New Problem
! 1981: \series default
! 1982: button.
! 1983: \layout Enumerate
! 1984:
! 1985: Click the
! 1986: \series bold
! 1987: Edit
! 1988: \series default
! 1989: button above the sample problem to enter edit mode.
! 1990: \begin_float fig
! 1991: \layout Standard
! 1992: \align center
! 1993:
! 1994: \begin_inset Figure size 476 320
! 1995: file stringResponseEditor.eps
! 1996: width 3 80
! 1997: flags 9
! 1998:
! 1999: \end_inset
! 2000:
! 2001:
! 2002: \layout Caption
! 2003:
! 2004: String Response Editor
! 2005: \begin_inset LatexCommand \label{String Response Editor Figure}
! 2006:
! 2007: \end_inset
! 2008:
! 2009:
! 2010: \end_float
! 2011: You should see the String Response editor page open up, which should look
! 2012: something like what you see in figure
! 2013: \begin_inset LatexCommand \ref{String Response Editor Figure}
! 2014:
! 2015: \end_inset
! 2016:
! 2017: .
! 2018: \layout Enumerate
! 2019:
! 2020: Clear the text from the Text Block at the top of the problem, and type in
! 2021: your problem's question.
! 2022: \layout Enumerate
! 2023:
! 2024: In the
! 2025: \series bold
! 2026: Answer Box
! 2027: \series default
! 2028: , type the correct answer.
! 2029: \layout Enumerate
! 2030:
! 2031: Select the answer condition from the drop down box.
! 2032: There are three cases to choose from:
! 2033: \begin_deeper
! 2034: \layout Enumerate
! 2035:
! 2036:
! 2037: \series bold
! 2038: cs
! 2039: \series default
! 2040: : This means
! 2041: \begin_inset Quotes eld
! 2042: \end_inset
! 2043:
! 2044: Case Sensitive
! 2045: \begin_inset Quotes erd
! 2046: \end_inset
! 2047:
! 2048: .
! 2049: For example, this is useful in Chemistry, where HO and Ho are completely
! 2050: different answers
! 2051: \begin_float footnote
! 2052: \end_deeper
! 2053: \layout Standard
! 2054:
! 2055:
! 2056: \series bold
! 2057: HO
! 2058: \series default
! 2059: is hydrogen monoxide, a colorless, odorless, poisonous gas.
! 2060:
! 2061: \series bold
! 2062: Ho
! 2063: \series default
! 2064: is the element 67, Holmium, in the Lanthanides.
! 2065: \end_float
! 2066: .
! 2067: The student must match the case of the answer.
! 2068: \begin_deeper
! 2069: \layout Enumerate
! 2070:
! 2071:
! 2072: \series bold
! 2073: ci
! 2074: \series default
! 2075: : This means
! 2076: \begin_inset Quotes eld
! 2077: \end_inset
! 2078:
! 2079: Case Insenstive
! 2080: \begin_inset Quotes erd
! 2081: \end_inset
! 2082:
! 2083: .
! 2084: The system does not use the case of the letters to determine the correctness
! 2085: of the answer.
! 2086: If the correct answer is
! 2087: \begin_inset Quotes eld
! 2088: \end_inset
! 2089:
! 2090: car
! 2091: \begin_inset Quotes erd
! 2092: \end_inset
! 2093:
! 2094: , the system will accept
! 2095: \begin_inset Quotes eld
! 2096: \end_inset
! 2097:
! 2098: car
! 2099: \begin_inset Quotes erd
! 2100: \end_inset
! 2101:
! 2102: ,
! 2103: \begin_inset Quotes eld
! 2104: \end_inset
! 2105:
! 2106: CAR
! 2107: \begin_inset Quotes erd
! 2108: \end_inset
! 2109:
! 2110: ,
! 2111: \begin_inset Quotes eld
! 2112: \end_inset
! 2113:
! 2114: Car
! 2115: \begin_inset Quotes erd
! 2116: \end_inset
! 2117:
! 2118: ,
! 2119: \begin_inset Quotes eld
! 2120: \end_inset
! 2121:
! 2122: caR
! 2123: \begin_inset Quotes erd
! 2124: \end_inset
! 2125:
! 2126: , etc.
! 2127: \layout Enumerate
! 2128:
! 2129:
! 2130: \series bold
! 2131: mc
! 2132: \series default
! 2133: : This means
! 2134: \begin_inset Quotes eld
! 2135: \end_inset
! 2136:
! 2137: Multiple Choice
! 2138: \begin_inset Quotes erd
! 2139: \end_inset
! 2140:
! 2141: .
! 2142: The student's answers must contain the same letters as the question author's,
! 2143: but order is unimportent.
! 2144: This is usually used to give a multiple choice question in the question's
! 2145:
! 2146: \series bold
! 2147: Text Block
! 2148: \series default
! 2149: , which may have several correct parts.
! 2150: If the author sets the correct answer as
! 2151: \begin_inset Quotes eld
! 2152: \end_inset
! 2153:
! 2154: bcg
! 2155: \begin_inset Quotes erd
! 2156: \end_inset
! 2157:
! 2158: , the system will accept
! 2159: \begin_inset Quotes eld
! 2160: \end_inset
! 2161:
! 2162: bcg
! 2163: \begin_inset Quotes erd
! 2164: \end_inset
! 2165:
! 2166: ,
! 2167: \begin_inset Quotes eld
! 2168: \end_inset
! 2169:
! 2170: cbg
! 2171: \begin_inset Quotes erd
! 2172: \end_inset
! 2173:
! 2174: ,
! 2175: \begin_inset Quotes eld
! 2176: \end_inset
! 2177:
! 2178: gcb
! 2179: \begin_inset Quotes erd
! 2180: \end_inset
! 2181:
! 2182: , etc., but not
! 2183: \begin_inset Quotes eld
! 2184: \end_inset
! 2185:
! 2186: bc
! 2187: \begin_inset Quotes erd
! 2188: \end_inset
! 2189:
! 2190: or
! 2191: \begin_inset Quotes eld
! 2192: \end_inset
! 2193:
! 2194: abcg
! 2195: \begin_inset Quotes erd
! 2196: \end_inset
! 2197:
! 2198: .
! 2199: \layout Standard
! 2200:
! 2201: It is conventional to tell the students whether the question is case sensitive
! 2202: or not.
! 2203: \end_deeper
! 2204: \layout Enumerate
! 2205:
! 2206: Optionally, locate the
! 2207: \series bold
! 2208: Single Line Text Entry Area
! 2209: \series default
! 2210: block and set a length in the Size box.
! 2211: This will only affect the size of the box on the screen; if you set the
! 2212: box size to 2, the student can still enter 3 or more letters in their answer.
! 2213: \begin_deeper
! 2214: \layout Comment
! 2215:
! 2216: This seems like a great feature to either eliminate, or make useful.
! 2217: Allowing the teacher to limit it to 3, and then not letting the student
! 2218: type more then 3 chars might be a way of giving the student a hint.
! 2219: Probably not worth it, as the problem text can always just say
! 2220: \begin_inset Quotes eld
! 2221: \end_inset
! 2222:
! 2223: Pick two of the following
! 2224: \begin_inset Quotes erd
! 2225: \end_inset
! 2226:
! 2227: .
! 2228: This is probably not a useful feature.
! 2229: \end_deeper
! 2230: \layout Enumerate
! 2231:
! 2232: Scroll down to the Hint element, and type some text that will help students
! 2233: when they answer incorrectly.
! 2234: \layout Enumerate
! 2235:
! 2236: Click the Submit Changes button.
! 2237: \layout Subsection
! 2238:
! 2239: Creating Numerical Response
! 2240: \begin_inset LatexCommand \index{Numerical Response}
! 2241:
! 2242: \end_inset
! 2243:
! 2244:
! 2245: \begin_inset LatexCommand \label{Numerical Response}
! 2246:
! 2247: \end_inset
! 2248:
! 2249: Problems
! 2250: \layout Standard
! 2251:
! 2252: Numerical Response problems are answered by entering a number and an optional
! 2253: unit.
! 2254: For instance, a numerical response problem might have an answer of
! 2255: \begin_inset Formula \( 2m/s^{2} \)
! 2256: \end_inset
! 2257:
! 2258: .
! 2259: \layout Standard
! 2260:
! 2261: To create an Numerical Response problem, create a new resource as described
! 2262: in section
! 2263: \begin_inset LatexCommand \ref{Creating New Content Pages}
! 2264:
! 2265: \end_inset
! 2266:
! 2267: .
! 2268: This is a
! 2269: \begin_inset Quotes eld
! 2270: \end_inset
! 2271:
! 2272: problem
! 2273: \begin_inset Quotes erd
! 2274: \end_inset
! 2275:
! 2276: resource so the URL must end in
! 2277: \begin_inset Quotes eld
! 2278: \end_inset
! 2279:
! 2280: .problem
! 2281: \begin_inset Quotes erd
! 2282: \end_inset
! 2283:
! 2284: .
! 2285: You should see a screen as in figure
! 2286: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 2287:
! 2288: \end_inset
! 2289:
! 2290: .
! 2291: \layout Enumerate
! 2292:
! 2293: In the drop-down option box as seen in
! 2294: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 2295:
! 2296: \end_inset
! 2297:
! 2298: , select
! 2299: \series bold
! 2300: Simple Numerical Response Problem
! 2301: \series default
! 2302: , and click the
! 2303: \series bold
! 2304: New Problem
! 2305: \series default
! 2306: button.
! 2307: \layout Enumerate
! 2308:
! 2309: Click the
! 2310: \series bold
! 2311: Edit
! 2312: \series default
! 2313: button above the sample problem to enter edit mode.
! 2314: \begin_float fig
! 2315: \layout Standard
! 2316: \align center
! 2317:
! 2318: \begin_inset Figure size 476 302
! 2319: file numericalResponseEditor.eps
! 2320: width 3 80
! 2321: flags 9
! 2322:
! 2323: \end_inset
! 2324:
! 2325:
! 2326: \layout Caption
! 2327:
! 2328: Numerical Response Editor
! 2329: \begin_inset LatexCommand \label{Numerical Response Editor Figure}
! 2330:
! 2331: \end_inset
! 2332:
! 2333:
! 2334: \end_float
! 2335: You should see the String Response editor page open up, which should look
! 2336: something like what you see in figure
! 2337: \begin_inset LatexCommand \ref{Numerical Response Editor Figure}
! 2338:
! 2339: \end_inset
! 2340:
! 2341: .
! 2342: \layout Enumerate
! 2343:
! 2344: Please refer to the CAPA manual for help with Numerical Response Problems.
! 2345: \layout Comment
! 2346:
! 2347: Copout.
! 2348: I need this info.
! 2349: \layout Subsection
! 2350:
! 2351: Creating Formula Response
! 2352: \begin_inset LatexCommand \index{Formula Response}
! 2353:
! 2354: \end_inset
! 2355:
! 2356:
! 2357: \begin_inset LatexCommand \label{Formula Response}
! 2358:
! 2359: \end_inset
! 2360:
! 2361: Problems
! 2362: \layout Standard
! 2363:
! 2364: Formula Response problems are answered by entering a mathematical formula.
! 2365: For instance, a numerical response problem might have an answer of
! 2366: \begin_inset Formula \( x^{2}+11 \)
! 2367: \end_inset
! 2368:
! 2369: .
! 2370: The answer may be in any equivalent format.
! 2371: For instance, for
! 2372: \begin_inset Formula \( x^{2}+11 \)
! 2373: \end_inset
! 2374:
! 2375: , the system will accept
! 2376: \begin_inset Formula \( x*x-11 \)
! 2377: \end_inset
! 2378:
! 2379: or
! 2380: \begin_inset Formula \( x^{2}+21-10 \)
! 2381: \end_inset
! 2382:
! 2383: as well.
! 2384: \layout Standard
! 2385:
! 2386: To create an Formula Response problem, create a new resource as described
! 2387: in section
! 2388: \begin_inset LatexCommand \ref{Creating New Content Pages}
! 2389:
! 2390: \end_inset
! 2391:
! 2392: .
! 2393: This is a
! 2394: \begin_inset Quotes eld
! 2395: \end_inset
! 2396:
! 2397: problem
! 2398: \begin_inset Quotes erd
! 2399: \end_inset
! 2400:
! 2401: resource so the URL must end in
! 2402: \begin_inset Quotes eld
! 2403: \end_inset
! 2404:
! 2405: .problem
! 2406: \begin_inset Quotes erd
! 2407: \end_inset
! 2408:
! 2409: .
! 2410: You should see a screen as in figure
! 2411: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 2412:
! 2413: \end_inset
! 2414:
! 2415: .
! 2416: \layout Enumerate
! 2417:
! 2418: In the drop-down option box as seen in
! 2419: \begin_inset LatexCommand \ref{Creating a new problem resource}
! 2420:
! 2421: \end_inset
! 2422:
! 2423: , select
! 2424: \series bold
! 2425: Simple Formula Problem
! 2426: \series default
! 2427: , and click the
! 2428: \series bold
! 2429: New Problem
! 2430: \series default
! 2431: button.
! 2432: \layout Enumerate
! 2433:
! 2434: Click the
! 2435: \series bold
! 2436: Edit
! 2437: \series default
! 2438: button above the sample problem to enter edit mode.
! 2439: \begin_float fig
! 2440: \layout Standard
! 2441: \align center
! 2442:
! 2443: \begin_inset Figure size 476 302
! 2444: file numericalResponseEditor.eps
! 2445: width 3 80
! 2446: flags 9
! 2447:
! 2448: \end_inset
! 2449:
! 2450:
! 2451: \layout Caption
! 2452:
! 2453: Numerical Response Editor
! 2454: \begin_inset LatexCommand \label{Numerical Response Editor Figure}
! 2455:
! 2456: \end_inset
! 2457:
! 2458:
! 2459: \end_float
! 2460: You should see the Formula Response editor page open up, which should look
! 2461: something like what you see in figure
! 2462: \begin_inset LatexCommand \ref{Numerical Response Editor Figure}
! 2463:
! 2464: \end_inset
! 2465:
! 2466: .
! 2467: \layout Enumerate
! 2468:
! 2469: Please refer to the CAPA manual for help with Numerical Response Problems.
! 2470: \layout Comment
! 2471:
! 2472: Copout.
! 2473: I need this info.
! 2474: \layout Section
! 2475:
! 2476: Publishing Your Course
! 2477: \layout Standard
! 2478:
! 2479: In order to make the content you've created available for courses to use,
! 2480: you must publish your content.
! 2481: LON-CAPA provides an easy interface for publishing your content pages,
! 2482: problem resources, and sequences.
! 2483: A common interface allows you to specify title, author information, keywords,
! 2484: and other metadata.
! 2485: LON-CAPA uses this metadata for many things, and it's importent to fill
! 2486: the metadata out as accurately as possible.
! 2487: \layout Subsection
! 2488:
! 2489: What is Metadata?
! 2490: \begin_inset LatexCommand \index{Metadata}
! 2491:
! 2492: \end_inset
! 2493:
! 2494:
! 2495: \begin_inset LatexCommand \label{What Is Metadata?}
! 2496:
! 2497: \end_inset
! 2498:
! 2499:
! 2500: \layout Standard
! 2501:
! 2502:
! 2503: \emph on
! 2504: Metadata
! 2505: \emph default
! 2506: is
! 2507: \emph on
! 2508: data about data
! 2509: \emph default
! 2510: .
! 2511: Metadata can often be thought of as a label on some bit of information
! 2512: that can be useful to people or computer programs trying to use the data.
! 2513: Without metadata, the person or computer trying to use the original information
! 2514: would have to just guess what the original data is about.
! 2515: For instance, if you create a problem and neglect to say in the title or
! 2516: subject of the problem what it is about, then a human who wants to use
! 2517: that problem would have to read the problem itself to see what it was about,
! 2518: which is much more difficult then just reading a title.
! 2519: A computer trying to do the same thing would just be out of luck; it is
! 2520: too stupid to understand the problem statement at all.
! 2521: \layout Standard
! 2522:
! 2523: One example of metadata you use all the time is the <TITLE> of a webpage,
! 2524: which usually shows up in the title bar of the browser.
! 2525: That's information about the webpage itself, not actually part of the web
! 2526: page.
! 2527: People use it when they bookmark a page, so they know what the page is.
! 2528: Search engines use it as a clue about the content of the web page.
! 2529: \layout Subsection
! 2530:
! 2531: Publishing A Resource
! 2532: \begin_inset LatexCommand \index{Resource, Publishing}
! 2533:
! 2534: \end_inset
! 2535:
! 2536:
! 2537: \begin_inset LatexCommand \index{Publishing Resource}
! 2538:
! 2539: \end_inset
! 2540:
! 2541:
! 2542: \layout Standard
! 2543:
! 2544: \begin_float fig
! 2545: \layout Standard
! 2546: \align center
! 2547:
! 2548: \begin_inset Figure size 476 168
! 2549: file constructionSpaceForPublishing.eps
! 2550: width 3 80
! 2551: flags 9
! 2552:
! 2553: \end_inset
! 2554:
! 2555:
! 2556: \layout Caption
! 2557:
! 2558: Construction Space for Publishing
! 2559: \begin_inset LatexCommand \label{Construction Space for Publishing Figure}
! 2560:
! 2561: \end_inset
! 2562:
! 2563:
! 2564: \end_float
! 2565: To publish a resource, log in and choose your role to be an Author.
! 2566: Then click
! 2567: \series bold
! 2568: CSTR
! 2569: \series default
! 2570: to go to your construction space.
! 2571: You should see something like figure
! 2572: \begin_inset LatexCommand \ref{Construction Space for Publishing Figure}
! 2573:
! 2574: \end_inset
! 2575:
! 2576: .
! 2577: Click on the
! 2578: \series bold
! 2579: Publish
! 2580: \series default
! 2581: button for the resource you wish to publish.
! 2582: \begin_float fig
! 2583: \layout Standard
! 2584: \align center
! 2585:
! 2586: \begin_inset Figure size 476 338
! 2587: file publishMetadata.eps
! 2588: width 3 80
! 2589: flags 9
! 2590:
! 2591: \end_inset
! 2592:
! 2593:
! 2594: \layout Caption
! 2595:
! 2596: Publishing Metadata Screen
! 2597: \begin_inset LatexCommand \label{Publishing Metadata Screen Figure}
! 2598:
! 2599: \end_inset
! 2600:
! 2601:
! 2602: \end_float
! 2603: You'll get a metadata screen that should look something like figure
! 2604: \begin_inset LatexCommand \ref{Publishing Metadata Screen Figure}
! 2605:
! 2606: \end_inset
! 2607:
! 2608: .
! 2609: Fill out the form.
! 2610: If you are creating resources that may be used in several courses, you
! 2611: should talk with the other authors and establish some sort of standard
! 2612: title and subject scheme in advance.
! 2613:
! 2614: \layout Standard
! 2615:
! 2616: The language is the language the problem is written in.
! 2617: The Publisher/Owner is the person who owns the problem; it should be the
! 2618: email address where anybody with questions about the resource can contact
! 2619: someone who can help them.
! 2620: In smaller environments, this is likely to be the author.
! 2621: In larger environments, it may be a coordinator or manager.
! 2622: \layout Standard
! 2623:
! 2624: The
! 2625: \series bold
! 2626: Keywords
! 2627: \series default
! 2628: and the
! 2629: \series bold
! 2630: Abstract
! 2631: \series default
! 2632: are more information about the problem.
! 2633: The
! 2634: \series bold
! 2635: Keywords
! 2636: \series default
! 2637: are words that are strongly connected to your problem; for instance a physics
! 2638: problem about a pulley might include
! 2639: \begin_inset Quotes eld
! 2640: \end_inset
! 2641:
! 2642: pulley
! 2643: \begin_inset Quotes erd
! 2644: \end_inset
! 2645:
! 2646: as a key word.
! 2647: LON-CAPA pulls out likely-looking keywords for you so you can just click
! 2648: on them to make them keywords.
! 2649:
! 2650: \series bold
! 2651: Additional keywords
! 2652: \series default
! 2653: allows you to add any keyword to your problem that are not actually in
! 2654: the problem.
! 2655: For instance, on that same problem a physicist might add the keyword
! 2656: \begin_inset Quotes eld
! 2657: \end_inset
! 2658:
! 2659: statics
! 2660: \begin_inset Quotes erd
! 2661: \end_inset
! 2662:
! 2663: , even though it doesn't appear in the original problem, because Physics
! 2664: uses that as a classification of problem type.
! 2665:
! 2666: \layout Standard
! 2667:
! 2668: Finally, you need to set the copyright and distribution notice.
! 2669: This setting controls who is allowed to use your resource.
! 2670:
! 2671: \layout Itemize
! 2672:
! 2673:
! 2674: \series bold
! 2675: Limited to courses in the domain published
! 2676: \series default
! 2677: means that only courses running in the same domain as you can use your
! 2678: content.
! 2679: Talk to your LON-CAPA administrator if you want more information about
! 2680: your domain.
! 2681: \layout Itemize
! 2682:
! 2683:
! 2684: \series bold
! 2685: Free
! 2686: \series default
! 2687: means that anyone can find and use the resource.
! 2688: \layout Itemize
! 2689:
! 2690:
! 2691: \series bold
! 2692: Private - visible to author only
! 2693: \series default
! 2694: means that it can't be used for any course.
! 2695: \layout Itemize
! 2696:
! 2697:
! 2698: \series bold
! 2699: Public - no authentication required
! 2700: \series default
! 2701: means anyone can find and use the resource.
! 2702: \layout Standard
! 2703:
! 2704: Now when you click
! 2705: \series bold
! 2706: Finalize Publication
! 2707: \series default
! 2708: , your resource will be published and usable (unless you set the distribution
! 2709: to
! 2710: \begin_inset Quotes eld
! 2711: \end_inset
! 2712:
! 2713: private
! 2714: \begin_inset Quotes erd
! 2715: \end_inset
! 2716:
! 2717: ).
! 2718: \layout Section
! 2719:
! 2720: Things That Need To Be Added
! 2721: \layout Subsection
! 2722:
! 2723: LON-CAPA and Units
! 2724: \layout Subsection
! 2725:
! 2726: Creating a default metadata file
! 2727: \layout Subsection
! 2728:
! 2729: Detailed number problem info
! 2730: \layout Subsection
! 2731:
! 2732: Detailed formula problem info
! 2733: \layout Subsection
! 2734:
! 2735: My questions\SpecialChar \ldots{}
! 2736:
! 2737: \layout Itemize
! 2738:
! 2739: How do I do the things above?
! 2740: \layout Itemize
! 2741:
! 2742: Is there any pre-existing documentation for number or formula problems?
! 2743: \layout Itemize
! 2744:
! 2745: Is there any pre-existing documentation for maps et al? I seem to have exhausted
! 2746: the documentation.
! 2747: \layout Itemize
! 2748:
! 2749: What is the LON-CAPA default resource? If it's free, can just anyone
! 2750: \begin_inset Quotes eld
! 2751: \end_inset
! 2752:
! 2753: find and use it
! 2754: \begin_inset Quotes erd
! 2755: \end_inset
! 2756:
! 2757: , or just
! 2758: \begin_inset Quotes eld
! 2759: \end_inset
! 2760:
! 2761: use it if they already know where it is
! 2762: \begin_inset Quotes erd
! 2763: \end_inset
! 2764:
! 2765: ? (In other words, how powerful is the search feature?) What's the difference
! 2766: between free and public?
! 2767: \layout Section
! 2768:
! 2769: Appendix A: Student Interface
! 2770: \layout Standard
! 2771:
! 2772: \begin_float fig
! 2773: \layout Caption
! 2774:
! 2775: Student Remote Control
! 2776: \begin_inset LatexCommand \label{Student Remote Control}
! 2777:
! 2778: \end_inset
! 2779:
! 2780:
! 2781: \end_float
! 2782: The Student Remote Control will automatically load whenever you log in to
! 2783: a LON-CAPA course as a student.
! 2784: The Student Remote Control contains most of the functions of the Author
! 2785: Remote Control and the following additional functions.
! 2786: \layout Itemize
! 2787:
! 2788:
! 2789: \series bold
! 2790: NAV (NAVIGATE CONTENTS)
! 2791: \series default
! 2792: allows you to directly access resources from the course outline.
! 2793: \layout Itemize
! 2794:
! 2795:
! 2796: \series bold
! 2797: ARROWS (LEFT and RIGHT)
! 2798: \series default
! 2799: allows you to move to the backward or forward through the course.
! 2800: \layout Itemize
! 2801:
! 2802:
! 2803: \series bold
! 2804: GRDS (MY GRADES)
! 2805: \series default
! 2806: allows you to check your grades in the courses you are taking.
! 2807: \layout Itemize
! 2808:
! 2809:
! 2810: \series bold
! 2811: SBKM (SET BOOKMARK)
! 2812: \series default
! 2813: allows you to bookmark pages for easy access.
! 2814: \layout Itemize
! 2815:
! 2816:
! 2817: \series bold
! 2818: VBKM (VIEW BOOKMARK)
! 2819: \series default
! 2820: displays your bookmarks for easy access to bookmarked resources.
! 2821: \layout Itemize
! 2822:
! 2823:
! 2824: \series bold
! 2825: ANOT (ANOTATE)
! 2826: \series default
! 2827: allows you to create personal notes.
! 2828: \layout Itemize
! 2829:
! 2830:
! 2831: \series bold
! 2832: LOGOUT (LOGOUT)
1.1 bowersj2 2833: \series default
2834: will log you out of the LON-CAPA system.
1.2 ! bowersj2 2835: \layout Standard
! 2836:
! 2837:
! 2838: \begin_inset LatexCommand \printindex{}
! 2839:
! 2840: \end_inset
! 2841:
! 2842:
1.1 bowersj2 2843: \the_end
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>