--- doc/loncapafiles/Attic/loncapafiles.html 2000/12/21 14:27:07 1.41 +++ doc/loncapafiles/Attic/loncapafiles.html 2001/05/21 18:14:19 1.98 @@ -27,7 +27,7 @@ The format of these tags is:

Here are examples of all the different types of LONCAPA make/build tags. -
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler"> +
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
<LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/lib/perl/Apache" CATEGORY="writeable by server">
<LONCAPA TYPE=OWNERSHIP DIST="redhat6.2" CATEGORY="setuid" CHMOD="6755" CHOWN="root:root">
<LONCAPA TYPE=RPM NAME="Vendor" VALUE="Laboratory for Instructional Technology Education, Division of Science and Mathematics Education, Michigan State University."> @@ -52,19 +52,19 @@ The NAME tags associated with TYPE=RPM a

Data can also be attached to any LON-CAPA tag. This is especially important for files. This is shown by these three examples:
<METAGROUP> -
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler"> +
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
<DESCRIPTION>
Handler for TeX files
</DESCRIPTION>
</METAGROUP>
 
<METAGROUP> -
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/tth.so" TARGET="usr/lib/perl5/site_perl/5.005/tth.so" CATEGORY="system file"> +
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/tth.so" TARGET="usr/lib/perl5/site_perl/5.005/tth.so" CATEGORY="system file">
<DESCRIPTION>
shared library file for dynamic loading and unloading of TeX-to-HTML functionality
</DESCRIPTION>
<BUILD> -
loncom/modules/TexConvert/tthperl/commands +
modules/TexConvert/tthperl/commands
</BUILD>
<DEPENDENCIES>
../tthdynamic/tthfunc.c @@ -160,8 +160,10 @@ browser and can only be seen be examinin + - + @@ -191,7 +193,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 @@ -209,25 +220,77 @@ 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. + + + + + +Config file for "My Desk" -Descriptive list of file extensions, and extension groupings +Descriptive list of file extensions, and extension groupings. + + + + + +Describes what tags are allowed inside other tags. + + + + + +Default spreadsheet for individual assessment. + + + + + +Default spreadsheet for assessment of students. + + + + + +Default spreadsheet for assessment of a class. @@ -269,7 +332,7 @@ each list element consists of only one v - + Basic auth password to access /lon-status and /server-status @@ -321,6 +384,12 @@ Example:
server ntp.msu.edu + + +Batch script for updating SQL metadata database. + + + proxy server @@ -329,7 +398,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). @@ -414,7 +493,217 @@ Table which has hash data necessary for - + + +Handler to show statistics on solving LON-CAPA problems. + +works/unverified + + + + +Handler to show difference between two files. + +works/unverified + + + + +Handler to upload files through browser into construction space. + +works/unverified + + + + +Handler to evaluate essay (ungraded) style responses. + +works/unverified + + + + +Handler to publish directories. + +works/unverified + + + + +Handler to retrieve old versions from resource space. + +works/unverified + + + + +Helper functions when in homework edit mode. + +works/unverified + + + + +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. @@ -470,6 +759,12 @@ Builds up frame set and loads in the rig + + +Homework remote control. + + + This will take annotations and then plug them into a page @@ -502,13 +797,13 @@ compile course into binary data structur - + -Handler for tex files (somewhere in loncom/modules) +Handler for tex files (somewhere in modules) - + Access to tth/ttm @@ -576,7 +871,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. @@ -588,7 +886,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). @@ -618,9 +925,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. - + @@ -630,7 +943,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. @@ -688,6 +1010,12 @@ javascript bumper + + + +A blank page with very minimal HTML structural elements. + + @@ -804,12 +1132,32 @@ sutd.gif -"something bad happened" icon +icons to indicate an unexpected result +lonconstruct.gif lonlogo_broken.gif +lonlogo_broken_tsp.gif + + + +icon to indicate an unexpected result + + + + + +icon to indicate an unexpected result + + + + + +icon to indicate an unexpected result + + @@ -821,8 +1169,17 @@ lonlogo.gif lonlogos.gif + + + +miscellaneous resources + + +cat_button.gif + + - + perl module for invoking functions specific to Tex-to-HTML conversion @@ -833,12 +1190,12 @@ the build process however. - + shared library file for dynamic loading and unloading -loncom/modules/TexConvert/tthperl/commands +modules/TexConvert/tthperl/commands ../tthdynamic/tthfunc.c @@ -932,11 +1289,23 @@ Encryption Routines according to Data En + + +used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() + + + used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() + + + +Define unit prefixing and conversion for CAPA problem handling. + + @@ -964,6 +1333,7 @@ j.gif k.gif l.gif ledblink.gif +ledgreen.gif ledoff.gif ledon.gif ledsend.gif @@ -998,7 +1368,7 @@ image maps for the LON-CAPA remote contr - + welcoming page to the LON-CAPA system upon login @@ -1010,7 +1380,7 @@ renders the HTML (including image maps) - + icons used for the bookmark portion of the LON-CAPA user interface @@ -1092,6 +1462,16 @@ uu.gif uuencoded.gif white_space_20_22.gif white_space_22_22.gif +whitespace1.gif +whitespace10.gif +whitespace2.gif +whitespace3.gif +whitespace4.gif +whitespace5.gif +whitespace6.gif +whitespace7.gif +whitespace8.gif +whitespace9.gif world1.gif world2.gif @@ -1102,24 +1482,24 @@ world2.gif icons used for directory indexing and login screen -button_close.gif -button_edit.gif -button_preview.gif -folder_closed.gif -folder_closed_pressed.gif +folder_anim.gif +folder_close.gif +folder_drag.gif folder_new.gif -folder_opened.gif -folder_opened_pressed.gif +folder_open.gif folder_pointer_closed.gif folder_pointer_opened.gif -folder_spacer.gif +folder_static.gif folder_trash.gif +folder_trash_hover.gif left_bar.gif link.gif -link_pressed.gif +link_anim.gif +link_drag.gif ll_corner.gif lower_bar.gif lr_corner.gif +pix.gif right_bar.gif toolbar_bg.gif ul_corner.gif @@ -1133,22 +1513,9 @@ ur_corner.gif associated with the frameset scheme of displaying bookmarks -aaloader.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 -bookmarkpal_v2_backup.html -index.html -loading_bookmarks.html +blank.html +closechildren.html @@ -1189,7 +1556,7 @@ makes verification report using loncapav - + file that specifies periodic processes to run for the LON-CAPA machine 500 Internal Server Error

Internal Server Error

The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator at root@localhost to inform them of the time this error occurred, and the actions you performed just before this error.

More information about this error may be available in the server error log.