--- doc/loncapafiles/Attic/loncapafiles.html 2000/12/26 17:25:41 1.45 +++ doc/loncapafiles/Attic/loncapafiles.html 2001/06/27 15:48:15 1.110 @@ -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 @@ -207,27 +218,79 @@ 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). @@ -382,6 +461,12 @@ resources, directories and underlying su + + +Interface file for responding to improper page flipping. + + + The relevant conditions and metadata to attach to LectureOnline-specific tags. @@ -414,6 +499,218 @@ Table which has hash data necessary for + + +Provides web-based functionality for file copy, rename, mkdir, etc, in the +construction space menu. + +works/unverified + + + + +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. + + + + + +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 +767,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 +805,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 +879,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 +894,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 +933,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 +951,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. @@ -810,25 +1140,122 @@ 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 + + logos +cab.gif +cab_big.gif +class.gif +class_big.gif +dvi.gif +dvi_big.gif +eps.gif +eps_big.gif +exam.gif +exam_big.gif +folder_closed.gif +folder_opened.gif +folder_pointer_closed.gif +folder_pointer_opened.gif +form.gif +form_big.gif +gif.gif +gif_big.gif +htm.gif +html.gif +html_big.gif +jpg.gif +jpg_big.gif liteani.gif lonlogo.gif lonlogos.gif +meta.gif +meta_big.gif +mov.gif +mov_big.gif +page.gif +page_big.gif +pdf.gif +pdf_big.gif +problem.gif +problem_big.gif +ps.gif +ps_big.gif +quill.gif +quiz.gif +quiz_big.gif +select.gif +sequence.gif +sequence_big.gif +server.gif +server_big.gif +survey.gif +survey_big.gif +tex.gif +tex_big.gif +txt.gif +txt_big.gif +user.gif +user_big.gif +wav.gif +wav_big.gif +white_space_20_22.gif +whitespace1.gif +whitespace10.gif +whitespace2.gif +whitespace3.gif +whitespace4.gif +whitespace5.gif +whitespace6.gif +whitespace7.gif +whitespace8.gif +whitespace9.gif +xml.gif +xml_big.gif +zip.gif +zip_big.gif + + + + + +miscellaneous resources + + +cat_button.gif - + perl module for invoking functions specific to Tex-to-HTML conversion @@ -839,12 +1266,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 @@ -938,6 +1365,12 @@ 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() @@ -956,16 +1389,31 @@ icons used for the entire LON-CAPA user a.gif +anot.gif b.gif +back.gif +bkm.gif +brws.gif c.gif +ccrs.gif chat.gif +chrt.gif +com.gif +courses.gif +cprv.gif +cstr.gif d.gif +dempty.gif e.gif -endmenu.gif +empty.gif +enrl.gif +eval.gif f.gif +fdbk.gif feedback.gif -fnkmenu.gif +forw.gif g.gif +grds.gif group.gif h.gif help.gif @@ -976,27 +1424,43 @@ j.gif k.gif l.gif ledblink.gif +ledgreen.gif ledoff.gif ledon.gif ledsend.gif +logout.gif m.gif +mrk.gif n.gif -navmenu.gif +nav.gif next.gif o.gif p.gif +parm.gif +pgrd.gif +pparm.gif prev.gif +prt.gif q.gif +qempty.gif r.gif reload.gif remotebg.gif +res.gif +roles.gif s.gif +sbkm.gif space.gif spacer.gif +sprs.gif +src.gif +stat.gif +subm.gif t.gif title.gif u.gif v.gif +vbkm.gif w.gif x.gif y.gif @@ -1022,7 +1486,7 @@ renders the HTML (including image maps) - + icons used for the bookmark portion of the LON-CAPA user interface @@ -1104,6 +1568,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 @@ -1114,24 +1588,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 @@ -1145,22 +1619,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