--- doc/loncapafiles/Attic/loncapafiles.html 2000/12/10 17:27:56 1.33 +++ doc/loncapafiles/Attic/loncapafiles.html 2001/03/08 19:00:23 1.71 @@ -160,7 +160,9 @@ browser and can only be seen be examinin - + + @@ -180,6 +182,7 @@ browser and can only be seen be examinin + @@ -189,7 +192,16 @@ browser and can only be seen be examinin -define handlers, set parameters +This file has two major functions. +For the Apache web server, it defines a global +access configuration which defines what server options (Indexes", "Includes", +"FollowSymLinks", "ExecCGI", or "MultiViews") are associated +with specific directories ("/", "/home/httpd/html", "/home/httpd/cgi-bin", +and "/usr/doc"). For the LON-CAPA network server and perl module +handlers, it defines machine specific settings (lonHostID, lonRole, +lonAdmEMail, lonDefDomain, lonLoadLim, lonExpire, and lonReceipt) +and internal machine settings for specific directories, socket ports, +and browser detection logic. configure @@ -207,19 +219,41 @@ define handlers, set parameters -main server configuration file +This is the main server configuration file. The settings here are +more or less standard for the Apache web server. Most notably (and +importantly!), perl handling and mod_perl are enabled in this configuration +file. -name space configuration +

+This file configures the "name space" of the Apache web server. +srm.conf +defines when specific perl modules should be called to handle a given +request. This definition is a function of both the name of the perl module, +and a specific regular expression associated with the URL, such as +"^/res/.*\.page". +

+

+Here is an example entry: +

+<LocationMatch "^/res/.*\.page$>
+SetHandler perl-script
+PerlHandler Apache::lonpage
+</LocationMatch>
+
+

 -set paths to modules; invoked by access.conf +This file provides initializations for perl handlers. It adjusts what +the module path space is (so as to include /home/httpd/lib/perl/Apache) as +well as causing the Apache module to be used for every perl handler. +startup.pl is invoked by access.conf. @@ -327,7 +361,17 @@ proxy server -remote command interpreter +This is a remote command interpreter on a TCP LON-CAPA network layer. +It accepts and processes incoming requests from other LON-CAPA machines +on the network. lond's functionality is self-contained in the sense +that it does not reference (import, require, use) any other file +described in this document. There are only 15 subroutines in this +script, however the make_new_child subroutine is quite +complex since it parses and responds about 29 different types of +network requests (i.e. enc, ping, pong, ekey, load, auth, passwd, +makeuser, home, update, unsub, sub, log, put, rolesput, get, eget, +del, keys, dump, store, restore, querysend, queryreply, idput, idget, +tmpput, tmpget, and ls). @@ -380,6 +424,12 @@ resources, directories and underlying su + + +The relevant conditions and metadata to attach to LectureOnline-specific tags. + + + File which contains words which should not be keywords used to specify resource @@ -406,6 +456,186 @@ Table which has hash data necessary for + + +Metadata display handler. + +works/unverified + + + + +Handler to resolve ambiguous file locations. + +works/unverified + + + + +Handler to set resource parameters inside of the RAT based on metadata. + +works/unverified + + + + +Handler for showing sequence objects of educational resources. + +works/unverified + + + + +Creates a new course and assigns course coordinator. + +works/unverified + + + + +Creates a new user and/or changes user privileges + +works/unverified + + + + +Produces simple LectureOnline-like student assessment performance chart + +works/unverified + + + + +Makes a table out of the previous attempts. Inputs result_from_symbread, +user, domain, home_server, course_id + +works/unverified + + + + +Handles the viewing of grades. + + + + + +Coordinates the response to clicking an image. + + + + + +Handles tags associated with showing a list of options. + + + + + +Handles tags associated with output. Seems to relate to due dates of the +assignment. + + + + + +Used for debugging and testing the LON-CAPA system. + + + + + +Handles multiple-choice style responses. + + + + + +Handles processing of assignments. + + + + + +Handles communication. + + + + + +Handles errors. + + + + + +Handles evaluation. + + + + + +Handles feedback from students to instructors and system administrators. + + + + + +Unknown function. + + + + + +Handles navigational maps. + + + + + +Handles user preferences associated with customizing the online LON-CAPA +educational environment. + + + + + +Handles the production of printable files and resources. + + + + + +Handles a searchable catalogue. + + + + + +Handler to drop and add students in courses. + + + + + +Routines for messaging. + + + + + +This handler coordinates the delivery of hints to students working on LON-CAPA +problems and assignments. + + + + + +Spreadsheet/Grades Display Handler + + + Handler to resolve ambiguous file locations @@ -443,6 +673,12 @@ Builds up frame set and loads in the rig + + +Homework remote control. + + + This will take annotations and then plug them into a page @@ -549,7 +785,10 @@ handles request to the CAPA homework pro -access to for a LON-CAPA user session +(This module, like loncacc.pm also authenticates with cookies.) +lonacc.pm coordinates access to a wide range of administrative-type +functions (e.g. roles, logout, annotations, and bookmarks) as well +as coordinating access to educational resources. @@ -561,7 +800,16 @@ access handler for file transfers -access to construction area +This module provides access to an educational resource construction area. +This module is invoked by the URL-related pattern syntax +LocationMatch "^/priv.*" or LocationMatch "^/\~.*". +Authentication of user identity +is coordinated through cookies. The abbreviation "cacc" corresponds +to "construction-space access"). If the cookie handle is invalid, then +this module returns a forbidden status and makes appropriate log entries. +If the cookie handle is valid, status is determined to be okay (and, +for the "priv"-type access, the resource is delivered by the +lonconstruct module). @@ -591,9 +839,15 @@ replication -roles picking +This perl handling module reads in the available roles available +for a LON-CAPA user (different courses, different privileges, etc) +and produces a form-element HTML page which allows the user to select +which role he wishes to exercise in the LON-CAPA system. For instance, +a user may want to select between being a student in a thermodynamics +physics course or a teaching assistant for an introductory calculus +class. - + @@ -603,7 +857,16 @@ cross server filesystem browser -interface to lonc +This file is an interface to the lonc processes of the LON-CAPA network +as well as set of elaborated functions for handling information necessary +for navigating through a given cluster of LON-CAPA machines within a domain. +There are over 40 specialized functions in this module which handle +the reading and transmission of metadata, user information +(ids, names, environments, roles, logs), file information (storage, reading, +directories, extensions, replication, embedded styles and descriptors), +educational resources (course descriptions, section names and numbers), +url hashing (to assign roles on a url basis), and translating abbreviated +symbols to and from more descriptive phrases or explanations. @@ -644,6 +907,12 @@ frameset + + +Parameter input window. + + + javascript @@ -655,6 +924,12 @@ javascript bumper + + + +A blank page with very minimal HTML structural elements. + + @@ -769,6 +1044,16 @@ sutd.gif + + +icons to indicate an unexpected result + + +lonconstruct.gif +lonlogo_broken.gif + + + logos @@ -784,6 +1069,11 @@ lonlogos.gif perl module for invoking functions specific to Tex-to-HTML conversion + +Has the same dependencies and build process as tth.so. +Currently, only the tth.so file specifications invoke +the build process however. + @@ -803,12 +1093,22 @@ loncom/modules/TexConvert/tthperl/comman perl module for invoking functions specific to CAPA + +Has the same dependencies and build process as capa.so. +Currently, only the capa.so file specifications invoke +the build process however. + bootstrap file associated with dynamic loading of this module on multiple architectures + +Has the same dependencies and build process as capa.so. +Currently, only the capa.so file specifications invoke +the build process however. + @@ -819,9 +1119,9 @@ shared library file for dynamic loading loncom/homework/caparesponse/commands -capa_wrap.c caparesponse.c -capa.pm +caparesponse.pm +[ALWAYS_RUN_BUILD_COMMAND] @@ -852,7 +1152,6 @@ isomscr.ent isonum.ent isopub.ent isotech.ent -mathml.dtd mmlalias.ent mmlextra.ent @@ -881,6 +1180,12 @@ Encryption Routines according to Data En used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() + + + +Define unit prefixing and conversion for CAPA problem handling. + + @@ -942,23 +1247,110 @@ image maps for the LON-CAPA remote contr - + welcoming page to the LON-CAPA system upon login - + renders the HTML (including image maps) for the LON-CAPA remote control - + icons used for the bookmark portion of the LON-CAPA user interface +a.gif +alert.black.gif +alert.red.gif +back.gif +ball.gray.gif +ball.red.gif +binary.gif +binhex.gif +blank.gif +bomb.gif +box1.gif +box2.gif +broken.gif +burst.gif +c.gif +comp.blue.gif +comp.gray.gif +compressed.gif +continued.gif +course.gif +dir.gif +down.gif +dvi.gif +f.gif +folder.gif +folder.open.gif +folder.sec.gif +folder_closed.gif +folder_closed_pressed.gif +folder_new.gif +folder_opened.gif +folder_opened_pressed.gif +folder_pointer_closed.gif +folder_pointer_opened.gif +folder_spacer.gif +folder_trash.gif +forward.gif +generic.gif +generic.red.gif +generic.sec.gif +hand.right.gif +hand.up.gif +html.gif +image1.gif +image2.gif +image3.gif +index.gif +layout.gif +left.gif +link.gif +mov.gif +movie1.gif +p.gif +patch.gif +pdf.gif +portal.gif +problem.gif +ps.gif +quill.gif +right.gif +screw1.gif +screw2.gif +script.gif +sound1.gif +sound2.gif +sphere1.gif +sphere2.gif +tar.gif +tex.gif +text.gif +transfer.gif +unknown.gif +up.gif +uu.gif +uuencoded.gif +white_space_20_22.gif +white_space_22_22.gif +world1.gif +world2.gif + + + + + +icons used for directory indexing and login screen + + button_close.gif button_edit.gif button_preview.gif @@ -972,9 +1364,6 @@ folder_pointer_opened.gif folder_spacer.gif folder_trash.gif left_bar.gif -line_l_shape.gif -line_side_T.gif -line_vertical.gif link.gif link_pressed.gif ll_corner.gif @@ -994,15 +1383,15 @@ associated with the frameset scheme of d aaloader.html -annotator_bb.html -annotator_left.html -annotator_ll.html -annotator_lr.html -annotator_right.html -annotator_toolbar.html -annotator_ul.html -annotator_ur.html -annotator_uu.html +bookmarkmenu_bb.html +bookmarkmenu_left.html +bookmarkmenu_ll.html +bookmarkmenu_lr.html +bookmarkmenu_right.html +bookmarkmenu_toolbar.html +bookmarkmenu_ul.html +bookmarkmenu_ur.html +bookmarkmenu_uu.html bookmarkpal.html bookmarkpal_old.html bookmarkpal_v2.html @@ -1049,7 +1438,7 @@ makes verification report using loncapav - + file that specifies periodic processes to run for the LON-CAPA machine