Annotation of loncom/publisher/lonpublisher.pm, revision 1.77
1.1 www 1: # The LearningOnline Network with CAPA
2: # Publication Handler
1.54 albertel 3: #
1.77 ! matthew 4: # $Id: lonpublisher.pm,v 1.76 2002/04/10 15:28:45 albertel Exp $
1.54 albertel 5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
1.1 www 28: #
29: # (TeX Content Handler
30: #
31: # 05/29/00,05/30,10/11 Gerd Kortemeyer)
32: #
1.15 www 33: # 11/28,11/29,11/30,12/01,12/02,12/04,12/23 Gerd Kortemeyer
1.20 www 34: # 03/23 Guy Albertelli
1.23 www 35: # 03/24,03/29,04/03 Gerd Kortemeyer
1.24 harris41 36: # 04/16/2001 Scott Harrison
1.27 www 37: # 05/03,05/05,05/07 Gerd Kortemeyer
1.30 harris41 38: # 05/28/2001 Scott Harrison
1.51 www 39: # 06/23,08/07,08/11,8/13,8/17,8/18,8/24,9/26,10/16 Gerd Kortemeyer
1.58 www 40: # 12/04,12/05 Guy Albertelli
41: # 12/05 Gerd Kortemeyer
1.62 www 42: # 12/05 Guy Albertelli
1.64 www 43: # 12/06,12/07 Gerd Kortemeyer
1.66 harris41 44: # 12/15,12/16 Scott Harrison
1.67 www 45: # 12/25 Gerd Kortemeyer
1.71 www 46: # YEAR=2002
47: # 1/16,1/17 Scott Harrison
48: # 1/17 Gerd Kortemeyer
1.65 harris41 49: #
50: ###
51:
52: ###############################################################################
53: ## ##
54: ## ORGANIZATION OF THIS PERL MODULE ##
55: ## ##
56: ## 1. Modules used by this module ##
57: ## 2. Various subroutines ##
58: ## 3. Publication Step One ##
59: ## 4. Phase Two ##
60: ## 5. Main Handler ##
61: ## ##
62: ###############################################################################
1.1 www 63:
64: package Apache::lonpublisher;
65:
1.65 harris41 66: # ------------------------------------------------- modules used by this module
1.1 www 67: use strict;
68: use Apache::File;
1.13 www 69: use File::Copy;
1.2 www 70: use Apache::Constants qw(:common :http :methods);
1.76 albertel 71: use HTML::LCParser;
1.4 www 72: use Apache::lonxml;
1.17 albertel 73: use Apache::lonhomework;
1.27 www 74: use Apache::loncacc;
1.24 harris41 75: use DBI;
1.65 harris41 76: use Apache::lonnet();
77: use Apache::loncommon();
1.2 www 78:
1.3 www 79: my %addid;
1.5 www 80: my %nokey;
1.10 www 81:
1.7 www 82: my %metadatafields;
83: my %metadatakeys;
84:
1.12 www 85: my $docroot;
86:
1.27 www 87: my $cuname;
88: my $cudom;
89:
1.12 www 90: # ----------------------------------------------- Evaluate string with metadata
1.7 www 91: sub metaeval {
92: my $metastring=shift;
93:
1.76 albertel 94: my $parser=HTML::LCParser->new(\$metastring);
1.7 www 95: my $token;
96: while ($token=$parser->get_token) {
97: if ($token->[0] eq 'S') {
98: my $entry=$token->[1];
99: my $unikey=$entry;
1.32 www 100: if (defined($token->[2]->{'package'})) {
101: $unikey.='_package_'.$token->[2]->{'package'};
102: }
1.7 www 103: if (defined($token->[2]->{'part'})) {
104: $unikey.='_'.$token->[2]->{'part'};
105: }
1.32 www 106: if (defined($token->[2]->{'id'})) {
1.49 www 107: $unikey.='_'.$token->[2]->{'id'};
1.32 www 108: }
1.7 www 109: if (defined($token->[2]->{'name'})) {
110: $unikey.='_'.$token->[2]->{'name'};
111: }
1.65 harris41 112: foreach (@{$token->[3]}) {
1.7 www 113: $metadatafields{$unikey.'.'.$_}=$token->[2]->{$_};
114: if ($metadatakeys{$unikey}) {
115: $metadatakeys{$unikey}.=','.$_;
116: } else {
117: $metadatakeys{$unikey}=$_;
118: }
1.65 harris41 119: }
1.7 www 120: if ($metadatafields{$unikey}) {
1.8 www 121: my $newentry=$parser->get_text('/'.$entry);
1.41 www 122: unless (($metadatafields{$unikey}=~/$newentry/) ||
123: ($newentry eq '')) {
1.8 www 124: $metadatafields{$unikey}.=', '.$newentry;
125: }
1.7 www 126: } else {
127: $metadatafields{$unikey}=$parser->get_text('/'.$entry);
128: }
129: }
130: }
131: }
132:
1.12 www 133: # -------------------------------------------------------- Read a metadata file
1.7 www 134: sub metaread {
135: my ($logfile,$fn)=@_;
136: unless (-e $fn) {
137: print $logfile 'No file '.$fn."\n";
138: return '<br><b>No file:</b> <tt>'.$fn.'</tt>';
139: }
140: print $logfile 'Processing '.$fn."\n";
141: my $metastring;
142: {
143: my $metafh=Apache::File->new($fn);
144: $metastring=join('',<$metafh>);
145: }
146: &metaeval($metastring);
147: return '<br><b>Processed file:</b> <tt>'.$fn.'</tt>';
148: }
149:
1.25 harris41 150: # ---------------------------- convert 'time' format into a datetime sql format
151: sub sqltime {
1.70 harris41 152: my $timef=shift @_;
1.25 harris41 153: my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) =
1.70 harris41 154: localtime($timef);
1.25 harris41 155: $mon++; $year+=1900;
156: return "$year-$mon-$mday $hour:$min:$sec";
157: }
158:
1.12 www 159: # --------------------------------------------------------- Various form fields
160:
1.8 www 161: sub textfield {
1.10 www 162: my ($title,$name,$value)=@_;
1.8 www 163: return "\n<p><b>$title:</b><br>".
1.11 www 164: '<input type=text name="'.$name.'" size=80 value="'.$value.'">';
165: }
166:
167: sub hiddenfield {
168: my ($name,$value)=@_;
169: return "\n".'<input type=hidden name="'.$name.'" value="'.$value.'">';
1.8 www 170: }
171:
1.9 www 172: sub selectbox {
1.65 harris41 173: my ($title,$name,$value,$functionref,@idlist)=@_;
174: my $uctitle=uc($title);
175: my $selout="\n<p><font color=\"#800000\" face=\"helvetica\"><b>$uctitle:".
176: "</b></font><br />".'<select name="'.$name.'">';
177: foreach (@idlist) {
178: $selout.='<option value=\''.$_.'\'';
179: if ($_ eq $value) {
180: $selout.=' selected>'.&{$functionref}($_).'</option>';
181: }
182: else {$selout.='>'.&{$functionref}($_).'</option>';}
183: }
1.10 www 184: return $selout.'</select>';
1.9 www 185: }
186:
1.12 www 187: # -------------------------------------------------------- Publication Step One
188:
1.34 www 189: sub urlfixup {
1.35 www 190: my ($url,$target)=@_;
1.39 www 191: unless ($url) { return ''; }
1.68 albertel 192: #javascript code needs no fixing
193: if ($url =~ /^javascript:/i) { return $url; }
1.69 albertel 194: if ($url =~ /^mailto:/i) { return $url; }
1.68 albertel 195: #internal document links need no fixing
196: if ($url =~ /^\#/) { return $url; }
1.35 www 197: my ($host)=($url=~/(?:http\:\/\/)*([^\/]+)/);
1.65 harris41 198: foreach (values %Apache::lonnet::hostname) {
1.35 www 199: if ($_ eq $host) {
200: $url=~s/^http\:\/\///;
201: $url=~s/^$host//;
202: }
1.65 harris41 203: }
1.40 www 204: if ($url=~/^http\:\/\//) { return $url; }
1.35 www 205: $url=~s/\~$cuname/res\/$cudom\/$cuname/;
1.71 www 206: return $url;
207: }
208:
209:
210: sub absoluteurl {
211: my ($url,$target)=@_;
212: unless ($url) { return ''; }
1.35 www 213: if ($target) {
214: $target=~s/\/[^\/]+$//;
215: $url=&Apache::lonnet::hreflocation($target,$url);
216: }
217: return $url;
1.34 www 218: }
219:
1.2 www 220: sub publish {
1.50 www 221:
1.2 www 222: my ($source,$target,$style)=@_;
223: my $logfile;
1.4 www 224: my $scrout='';
1.23 www 225: my $allmeta='';
226: my $content='';
1.36 www 227: my %allow=();
228: undef %allow;
1.4 www 229:
1.2 www 230: unless ($logfile=Apache::File->new('>>'.$source.'.log')) {
1.7 www 231: return
232: '<font color=red>No write permission to user directory, FAIL</font>';
1.2 www 233: }
234: print $logfile
1.11 www 235: "\n\n================= Publish ".localtime()." Phase One ================\n";
1.2 www 236:
1.3 www 237: if (($style eq 'ssi') || ($style eq 'rat')) {
238: # ------------------------------------------------------- This needs processing
1.4 www 239:
240: # ----------------------------------------------------------------- Backup Copy
1.3 www 241: my $copyfile=$source.'.save';
1.13 www 242: if (copy($source,$copyfile)) {
1.3 www 243: print $logfile "Copied original file to ".$copyfile."\n";
244: } else {
1.13 www 245: print $logfile "Unable to write backup ".$copyfile.':'.$!."\n";
246: return "<font color=red>Failed to write backup copy, $!,FAIL</font>";
1.3 www 247: }
1.4 www 248: # ------------------------------------------------------------- IDs and indices
249:
250: my $maxindex=10;
251: my $maxid=10;
1.23 www 252:
1.4 www 253: my $needsfixup=0;
254:
255: {
256: my $org=Apache::File->new($source);
257: $content=join('',<$org>);
258: }
259: {
1.76 albertel 260: my $parser=HTML::LCParser->new(\$content);
1.4 www 261: my $token;
262: while ($token=$parser->get_token) {
263: if ($token->[0] eq 'S') {
264: my $counter;
265: if ($counter=$addid{$token->[1]}) {
266: if ($counter eq 'id') {
267: if (defined($token->[2]->{'id'})) {
268: $maxid=
269: ($token->[2]->{'id'}>$maxid)?$token->[2]->{'id'}:$maxid;
270: } else {
271: $needsfixup=1;
272: }
273: } else {
274: if (defined($token->[2]->{'index'})) {
275: $maxindex=
276: ($token->[2]->{'index'}>$maxindex)?$token->[2]->{'index'}:$maxindex;
277: } else {
278: $needsfixup=1;
279: }
280: }
281: }
282: }
283: }
284: }
285: if ($needsfixup) {
286: print $logfile "Needs ID and/or index fixup\n".
287: "Max ID : $maxid (min 10)\n".
288: "Max Index: $maxindex (min 10)\n";
1.34 www 289: }
1.4 www 290: my $outstring='';
1.76 albertel 291: my $parser=HTML::LCParser->new(\$content);
1.53 albertel 292: $parser->xml_mode(1);
1.4 www 293: my $token;
294: while ($token=$parser->get_token) {
295: if ($token->[0] eq 'S') {
1.34 www 296: my $counter;
297: my $tag=$token->[1];
1.56 albertel 298: my $lctag=lc($tag);
1.53 albertel 299: unless ($lctag eq 'allow') {
1.34 www 300: my %parms=%{$token->[2]};
1.53 albertel 301: $counter=$addid{$tag};
302: if (!$counter) { $counter=$addid{$lctag}; }
303: if ($counter) {
1.4 www 304: if ($counter eq 'id') {
1.34 www 305: unless (defined($parms{'id'})) {
1.4 www 306: $maxid++;
1.34 www 307: $parms{'id'}=$maxid;
308: print $logfile 'ID: '.$tag.':'.$maxid."\n";
1.4 www 309: }
1.34 www 310: } elsif ($counter eq 'index') {
311: unless (defined($parms{'index'})) {
1.4 www 312: $maxindex++;
1.34 www 313: $parms{'index'}=$maxindex;
314: print $logfile 'Index: '.$tag.':'.$maxindex."\n";
1.4 www 315: }
316: }
1.72 albertel 317: }
318:
319: foreach my $type ('src','href','background','bgimg') {
320: foreach my $key (keys(%parms)) {
321: if ($key =~ /^$type$/i) {
322: my $oldurl=$parms{$key};
323: my $newurl=&urlfixup($oldurl,$target);
324: if ($newurl ne $oldurl) {
325: $parms{$key}=$newurl;
326: print $logfile 'URL: '.$tag.':'.$oldurl.' - '.
327: $newurl."\n";
328: }
1.74 albertel 329: if (($newurl !~ /^javascript:/i) &&
330: ($newurl !~ /^mailto:/i) &&
331: ($newurl !~ /^http:/i) &&
332: ($newurl !~ /^\#/)) {
333: $allow{&absoluteurl($newurl,$target)}=1;
334: }
1.34 www 335: }
1.72 albertel 336: last;
337: }
1.65 harris41 338: }
1.38 www 339:
1.53 albertel 340: if ($lctag eq 'applet') {
1.38 www 341: my $codebase='';
342: if (defined($parms{'codebase'})) {
343: my $oldcodebase=$parms{'codebase'};
344: unless ($oldcodebase=~/\/$/) {
345: $oldcodebase.='/';
346: }
347: $codebase=&urlfixup($oldcodebase,$target);
348: $codebase=~s/\/$//;
349: if ($codebase ne $oldcodebase) {
350: $parms{'codebase'}=$codebase;
351: print $logfile 'URL codebase: '.$tag.':'.
352: $oldcodebase.' - '.
353: $codebase."\n";
354: }
1.71 www 355: $allow{&absoluteurl($codebase,$target).'/*'}=1;
1.38 www 356: } else {
1.65 harris41 357: foreach ('archive','code','object') {
1.38 www 358: if (defined($parms{$_})) {
359: my $oldurl=$parms{$_};
360: my $newurl=&urlfixup($oldurl,$target);
361: $newurl=~s/\/[^\/]+$/\/\*/;
362: print $logfile 'Allow: applet '.$_.':'.
363: $oldurl.' allows '.
364: $newurl."\n";
1.71 www 365: $allow{&absoluteurl($newurl,$target)}=1;
1.38 www 366: }
1.65 harris41 367: }
1.38 www 368: }
369: }
1.34 www 370:
371: my $newparmstring='';
372: my $endtag='';
1.65 harris41 373: foreach (keys %parms) {
1.34 www 374: if ($_ eq '/') {
375: $endtag=' /';
376: } else {
377: my $quote=($parms{$_}=~/\"/?"'":'"');
378: $newparmstring.=' '.$_.'='.$quote.$parms{$_}.$quote;
379: }
1.65 harris41 380: }
1.57 albertel 381: if (!$endtag) { if ($token->[4]=~m:/>$:) { $endtag=' /'; }; }
1.34 www 382: $outstring.='<'.$tag.$newparmstring.$endtag.'>';
1.36 www 383: } else {
384: $allow{$token->[2]->{'src'}}=1;
385: }
1.4 www 386: } elsif ($token->[0] eq 'E') {
1.57 albertel 387: if ($token->[2]) {
1.34 www 388: unless ($token->[1] eq 'allow') {
1.41 www 389: $outstring.='</'.$token->[1].'>';
1.34 www 390: }
1.57 albertel 391: }
1.4 www 392: } else {
393: $outstring.=$token->[1];
394: }
395: }
1.36 www 396: # ------------------------------------------------------------ Construct Allows
1.62 www 397:
1.44 www 398: $scrout.='<h3>Dependencies</h3>';
1.62 www 399: my $allowstr='';
1.73 albertel 400: foreach (sort(keys(%allow))) {
1.59 www 401: my $thisdep=$_;
1.73 albertel 402: if ($thisdep !~ /[^\s]/) { next; }
1.62 www 403: unless ($style eq 'rat') {
404: $allowstr.="\n".'<allow src="'.$thisdep.'" />';
405: }
1.44 www 406: $scrout.='<br>';
1.59 www 407: unless ($thisdep=~/\*/) {
408: $scrout.='<a href="'.$thisdep.'">';
1.44 www 409: }
1.59 www 410: $scrout.='<tt>'.$thisdep.'</tt>';
411: unless ($thisdep=~/\*/) {
1.44 www 412: $scrout.='</a>';
1.59 www 413: if (
414: &Apache::lonnet::getfile($Apache::lonnet::perlvar{'lonDocRoot'}.'/'.
415: $thisdep.'.meta') eq '-1') {
1.58 www 416: $scrout.=
417: ' - <font color=red>Currently not available</font>';
1.59 www 418: } else {
419: my %temphash=(&Apache::lonnet::declutter($target).'___'.
420: &Apache::lonnet::declutter($thisdep).'___usage'
421: => time);
422: $thisdep=~/^\/res\/(\w+)\/(\w+)\//;
423: if ((defined($1)) && (defined($2))) {
424: &Apache::lonnet::put('resevaldata',\%temphash,$1,$2);
425: }
426: }
1.44 www 427: }
1.65 harris41 428: }
1.71 www 429: $allowstr=~s/\n+/\n/g;
1.36 www 430: $outstring=~s/(\<\/[^\>]+\>\s*)$/$allowstr$1/s;
1.62 www 431:
1.76 albertel 432: #Encode any High ASCII characters
433: $outstring=&HTML::Entities::encode($outstring,"\200-\377");
1.37 www 434: # ------------------------------------------------------------- Write modified
435:
1.4 www 436: {
437: my $org;
438: unless ($org=Apache::File->new('>'.$source)) {
439: print $logfile "No write permit to $source\n";
1.7 www 440: return
441: "<font color=red>No write permission to $source, FAIL</font>";
1.4 www 442: }
443: print $org $outstring;
444: }
445: $content=$outstring;
1.34 www 446:
447: if ($needsfixup) {
1.4 www 448: print $logfile "End of ID and/or index fixup\n".
449: "Max ID : $maxid (min 10)\n".
450: "Max Index: $maxindex (min 10)\n";
451: } else {
452: print $logfile "Does not need ID and/or index fixup\n";
453: }
1.37 www 454: }
1.7 www 455: # --------------------------------------------- Initial step done, now metadata
456:
457: # ---------------------------------------- Storage for metadata keys and fields
458:
1.8 www 459: %metadatafields=();
460: %metadatakeys=();
461:
462: my %oldparmstores=();
1.44 www 463:
464: $scrout.='<h3>Metadata Information</h3>';
1.7 www 465:
466: # ------------------------------------------------ First, check out environment
1.8 www 467: unless (-e $source.'.meta') {
1.7 www 468: $metadatafields{'author'}=$ENV{'environment.firstname'}.' '.
469: $ENV{'environment.middlename'}.' '.
470: $ENV{'environment.lastname'}.' '.
471: $ENV{'environment.generation'};
1.8 www 472: $metadatafields{'author'}=~s/\s+/ /g;
473: $metadatafields{'author'}=~s/\s+$//;
1.27 www 474: $metadatafields{'owner'}=$cuname.'@'.$cudom;
1.7 www 475:
476: # ------------------------------------------------ Check out directory hierachy
477:
478: my $thisdisfn=$source;
1.27 www 479: $thisdisfn=~s/^\/home\/$cuname\///;
1.7 www 480:
481: my @urlparts=split(/\//,$thisdisfn);
482: $#urlparts--;
483:
1.27 www 484: my $currentpath='/home/'.$cuname.'/';
1.7 www 485:
1.65 harris41 486: foreach (@urlparts) {
1.7 www 487: $currentpath.=$_.'/';
488: $scrout.=&metaread($logfile,$currentpath.'default.meta');
1.65 harris41 489: }
1.7 www 490:
491: # ------------------- Clear out parameters and stores (there should not be any)
492:
1.65 harris41 493: foreach (keys %metadatafields) {
1.7 www 494: if (($_=~/^parameter/) || ($_=~/^stores/)) {
495: delete $metadatafields{$_};
496: }
1.65 harris41 497: }
1.7 www 498:
1.8 www 499: } else {
1.7 www 500: # ---------------------- Read previous metafile, remember parameters and stores
501:
502: $scrout.=&metaread($logfile,$source.'.meta');
503:
1.65 harris41 504: foreach (keys %metadatafields) {
1.7 www 505: if (($_=~/^parameter/) || ($_=~/^stores/)) {
506: $oldparmstores{$_}=1;
507: delete $metadatafields{$_};
508: }
1.65 harris41 509: }
1.7 www 510:
1.8 www 511: }
1.7 www 512:
1.4 www 513: # -------------------------------------------------- Parse content for metadata
1.37 www 514: if ($style eq 'ssi') {
1.42 www 515: my $oldenv=$ENV{'request.uri'};
516:
517: $ENV{'request.uri'}=$target;
1.23 www 518: $allmeta=Apache::lonxml::xmlparse('meta',$content);
1.42 www 519: $ENV{'request.uri'}=$oldenv;
1.32 www 520:
1.19 albertel 521: &metaeval($allmeta);
1.37 www 522: }
1.7 www 523: # ---------------- Find and document discrepancies in the parameters and stores
524:
525: my $chparms='';
1.65 harris41 526: foreach (sort keys %metadatafields) {
1.7 www 527: if (($_=~/^parameter/) || ($_=~/^stores/)) {
528: unless ($_=~/\.\w+$/) {
529: unless ($oldparmstores{$_}) {
530: print $logfile 'New: '.$_."\n";
531: $chparms.=$_.' ';
532: }
533: }
534: }
1.65 harris41 535: }
1.7 www 536: if ($chparms) {
537: $scrout.='<p><b>New parameters or stored values:</b> '.
538: $chparms;
539: }
540:
1.70 harris41 541: $chparms='';
1.65 harris41 542: foreach (sort keys %oldparmstores) {
1.7 www 543: if (($_=~/^parameter/) || ($_=~/^stores/)) {
1.33 www 544: unless (($metadatafields{$_.'.name'}) ||
545: ($metadatafields{$_.'.package'}) || ($_=~/\.\w+$/)) {
1.7 www 546: print $logfile 'Obsolete: '.$_."\n";
547: $chparms.=$_.' ';
548: }
549: }
1.65 harris41 550: }
1.7 www 551: if ($chparms) {
552: $scrout.='<p><b>Obsolete parameters or stored values:</b> '.
553: $chparms;
554: }
1.37 www 555:
1.8 www 556: # ------------------------------------------------------- Now have all metadata
1.5 www 557:
1.8 www 558: $scrout.=
1.77 ! matthew 559: '<form name="pubform" action="/adm/publish" method="post">'.
1.63 albertel 560: '<p><input type="submit" value="Finalize Publication" /></p>'.
1.11 www 561: &hiddenfield('phase','two').
562: &hiddenfield('filename',$ENV{'form.filename'}).
563: &hiddenfield('allmeta',&Apache::lonnet::escape($allmeta)).
1.58 www 564: &hiddenfield('dependencies',join(',',keys %allow)).
1.10 www 565: &textfield('Title','title',$metadatafields{'title'}).
566: &textfield('Author(s)','author',$metadatafields{'author'}).
567: &textfield('Subject','subject',$metadatafields{'subject'});
1.5 www 568:
569: # --------------------------------------------------- Scan content for keywords
1.7 www 570:
1.77 ! matthew 571: my $keywordout=<<"END";
! 572: <script>
! 573: function checkAll(field)
! 574: {
! 575: for (i = 0; i < field.length; i++)
! 576: field[i].checked = true ;
! 577: }
! 578:
! 579: function uncheckAll(field)
! 580: {
! 581: for (i = 0; i < field.length; i++)
! 582: field[i].checked = false ;
! 583: }
! 584: </script>
! 585: <p><b>Keywords:</b>
! 586: <input type="button" value="check all" onclick="javascript:checkAll(document.pubform.keywords)">
! 587: <input type="button" value="uncheck all" onclick="javascript:uncheckAll(document.pubform.keywords)">
! 588: <br />
! 589: END
! 590: $keywordout.='<table border=2><tr>';
1.7 www 591: my $colcount=0;
1.67 www 592: my %keywords=();
1.7 www 593:
1.52 albertel 594: if (length($content)<500000) {
1.5 www 595: my $textonly=$content;
596: $textonly=~s/\<script[^\<]+\<\/script\>//g;
597: $textonly=~s/\<m\>[^\<]+\<\/m\>//g;
598: $textonly=~s/\<[^\>]*\>//g;
599: $textonly=~tr/A-Z/a-z/;
600: $textonly=~s/[\$\&][a-z]\w*//g;
601: $textonly=~s/[^a-z\s]//g;
602:
1.65 harris41 603: foreach ($textonly=~m/(\w+)/g) {
1.50 www 604: unless ($nokey{$_}) {
605: $keywords{$_}=1;
606: }
1.65 harris41 607: }
1.67 www 608: }
1.5 www 609:
1.67 www 610:
1.65 harris41 611: foreach (split(/\W+/,$metadatafields{'keywords'})) {
1.12 www 612: $keywords{$_}=1;
1.65 harris41 613: }
1.5 www 614:
1.65 harris41 615: foreach (sort keys %keywords) {
1.77 ! matthew 616: $keywordout.='<td><input type=checkbox name="keywords" value="'.$_.'"';
1.67 www 617: if ($metadatafields{'keywords'}) {
618: if ($metadatafields{'keywords'}=~/$_/) {
619: $keywordout.=' checked';
620: }
621: } elsif (&Apache::loncommon::keyword($_)) {
1.73 albertel 622: $keywordout.=' checked';
1.67 www 623: }
1.8 www 624: $keywordout.='>'.$_.'</td>';
1.7 www 625: if ($colcount>10) {
626: $keywordout.="</tr><tr>\n";
627: $colcount=0;
628: }
1.50 www 629: $colcount++;
1.65 harris41 630: }
1.50 www 631:
1.51 www 632: $keywordout.='</tr></table>';
633:
634: $scrout.=$keywordout;
1.9 www 635:
1.12 www 636: $scrout.=&textfield('Additional Keywords','addkey','');
637:
1.10 www 638: $scrout.=&textfield('Notes','notes',$metadatafields{'notes'});
1.9 www 639:
640: $scrout.=
641: '<p><b>Abstract:</b><br><textarea cols=80 rows=5 name=abstract>'.
642: $metadatafields{'abstract'}.'</textarea>';
643:
1.11 www 644: $source=~/\.(\w+)$/;
645:
646: $scrout.=&hiddenfield('mime',$1);
647:
1.10 www 648: $scrout.=&selectbox('Language','language',
1.65 harris41 649: $metadatafields{'language'},
1.70 harris41 650: \&Apache::loncommon::languagedescription,
1.65 harris41 651: (&Apache::loncommon::languageids),
652: );
1.11 www 653:
654: unless ($metadatafields{'creationdate'}) {
655: $metadatafields{'creationdate'}=time;
656: }
657: $scrout.=&hiddenfield('creationdate',$metadatafields{'creationdate'});
658:
659: $scrout.=&hiddenfield('lastrevisiondate',time);
660:
1.9 www 661:
1.10 www 662: $scrout.=&textfield('Publisher/Owner','owner',
663: $metadatafields{'owner'});
1.45 www 664: # --------------------------------------------------- Correct copyright for rat
665: if ($style eq 'rat') {
1.65 harris41 666: if ($metadatafields{'copyright'} eq 'public') {
667: delete $metadatafields{'copyright'};
668: }
669: $scrout.=&selectbox('Copyright/Distribution','copyright',
670: $metadatafields{'copyright'},
1.70 harris41 671: \&Apache::loncommon::copyrightdescription,
1.65 harris41 672: (grep !/^public$/,(&Apache::loncommon::copyrightids)));
673: }
674: else {
1.10 www 675: $scrout.=&selectbox('Copyright/Distribution','copyright',
1.65 harris41 676: $metadatafields{'copyright'},
1.70 harris41 677: \&Apache::loncommon::copyrightdescription,
1.65 harris41 678: (&Apache::loncommon::copyrightids));
679: }
1.8 www 680: return $scrout.
1.63 albertel 681: '<p><input type="submit" value="Finalize Publication" /></p></form>';
1.2 www 682: }
1.1 www 683:
1.12 www 684: # -------------------------------------------------------- Publication Step Two
685:
1.11 www 686: sub phasetwo {
687:
1.24 harris41 688: my ($source,$target,$style,$distarget)=@_;
1.11 www 689: my $logfile;
690: my $scrout='';
691: unless ($logfile=Apache::File->new('>>'.$source.'.log')) {
692: return
693: '<font color=red>No write permission to user directory, FAIL</font>';
694: }
695: print $logfile
696: "\n================= Publish ".localtime()." Phase Two ================\n";
697:
698: %metadatafields=();
699: %metadatakeys=();
700:
701: &metaeval(&Apache::lonnet::unescape($ENV{'form.allmeta'}));
702:
703: $metadatafields{'title'}=$ENV{'form.title'};
704: $metadatafields{'author'}=$ENV{'form.author'};
705: $metadatafields{'subject'}=$ENV{'form.subject'};
706: $metadatafields{'notes'}=$ENV{'form.notes'};
707: $metadatafields{'abstract'}=$ENV{'form.abstract'};
708: $metadatafields{'mime'}=$ENV{'form.mime'};
709: $metadatafields{'language'}=$ENV{'form.language'};
710: $metadatafields{'creationdate'}=$ENV{'form.creationdate'};
711: $metadatafields{'lastrevisiondate'}=$ENV{'form.lastrevisiondate'};
712: $metadatafields{'owner'}=$ENV{'form.owner'};
713: $metadatafields{'copyright'}=$ENV{'form.copyright'};
1.60 www 714: $metadatafields{'dependencies'}=$ENV{'form.dependencies'};
1.12 www 715:
716: my $allkeywords=$ENV{'form.addkey'};
1.77 ! matthew 717: my @Keywords = @{$ENV{'form.keywords'}};
! 718: foreach (@Keywords) {
! 719: $allkeywords.=','.$_;
1.65 harris41 720: }
1.12 www 721: $allkeywords=~s/\W+/\,/;
722: $allkeywords=~s/^\,//;
723: $metadatafields{'keywords'}=$allkeywords;
724:
725: {
726: print $logfile "\nWrite metadata file for ".$source;
727: my $mfh;
728: unless ($mfh=Apache::File->new('>'.$source.'.meta')) {
729: return
730: '<font color=red>Could not write metadata, FAIL</font>';
1.65 harris41 731: }
732: foreach (sort keys %metadatafields) {
1.12 www 733: unless ($_=~/\./) {
734: my $unikey=$_;
735: $unikey=~/^([A-Za-z]+)/;
736: my $tag=$1;
737: $tag=~tr/A-Z/a-z/;
738: print $mfh "\n\<$tag";
1.65 harris41 739: foreach (split(/\,/,$metadatakeys{$unikey})) {
1.12 www 740: my $value=$metadatafields{$unikey.'.'.$_};
741: $value=~s/\"/\'\'/g;
742: print $mfh ' '.$_.'="'.$value.'"';
1.65 harris41 743: }
1.76 albertel 744: print $mfh '>'.
745: &HTML::Entities::encode($metadatafields{$unikey})
746: .'</'.$tag.'>';
1.12 www 747: }
1.65 harris41 748: }
1.12 www 749: $scrout.='<p>Wrote Metadata';
750: print $logfile "\nWrote metadata";
751: }
752:
1.24 harris41 753: # -------------------------------- Synchronize entry with SQL metadata database
1.64 www 754: my $warning;
755:
756: unless ($metadatafields{'copyright'} eq 'priv') {
1.25 harris41 757:
1.24 harris41 758: my $dbh;
759: {
760: unless (
1.64 www 761: $dbh = DBI->connect("DBI:mysql:loncapa","www",
762: $Apache::lonnet::perlvar{'lonSqlAccess'},{ RaiseError =>0,PrintError=>0})
1.24 harris41 763: ) {
1.29 harris41 764: $warning='<font color=red>WARNING: Cannot connect to '.
765: 'database!</font>';
766: }
767: else {
768: my %sqldatafields;
769: $sqldatafields{'url'}=$distarget;
770: my $sth=$dbh->prepare(
771: 'delete from metadata where url like binary'.
772: '"'.$sqldatafields{'url'}.'"');
773: $sth->execute();
1.65 harris41 774: foreach ('title','author','subject','keywords','notes','abstract',
1.29 harris41 775: 'mime','language','creationdate','lastrevisiondate','owner',
1.65 harris41 776: 'copyright') {
777: my $field=$metadatafields{$_}; $field=~s/\"/\'\'/g;
778: $sqldatafields{$_}=$field;
779: }
1.29 harris41 780:
781: $sth=$dbh->prepare('insert into metadata values ('.
782: '"'.delete($sqldatafields{'title'}).'"'.','.
783: '"'.delete($sqldatafields{'author'}).'"'.','.
784: '"'.delete($sqldatafields{'subject'}).'"'.','.
785: '"'.delete($sqldatafields{'url'}).'"'.','.
786: '"'.delete($sqldatafields{'keywords'}).'"'.','.
787: '"'.'current'.'"'.','.
788: '"'.delete($sqldatafields{'notes'}).'"'.','.
789: '"'.delete($sqldatafields{'abstract'}).'"'.','.
790: '"'.delete($sqldatafields{'mime'}).'"'.','.
791: '"'.delete($sqldatafields{'language'}).'"'.','.
792: '"'.
793: sqltime(delete($sqldatafields{'creationdate'}))
794: .'"'.','.
795: '"'.
796: sqltime(delete(
797: $sqldatafields{'lastrevisiondate'})).'"'.','.
798: '"'.delete($sqldatafields{'owner'}).'"'.','.
799: '"'.delete(
800: $sqldatafields{'copyright'}).'"'.')');
801: $sth->execute();
802: $dbh->disconnect;
803: $scrout.='<p>Synchronized SQL metadata database';
804: print $logfile "\nSynchronized SQL metadata database";
1.24 harris41 805: }
806: }
807:
1.64 www 808: } else {
809: $scrout.='<p>Private Publication - did not synchronize database';
1.66 harris41 810: print $logfile "\nPrivate: Did not synchronize data into ".
811: "SQL metadata database";
1.64 www 812: }
1.12 www 813: # ----------------------------------------------------------- Copy old versions
814:
815: if (-e $target) {
816: my $filename;
817: my $maxversion=0;
818: $target=~/(.*)\/([^\/]+)\.(\w+)$/;
819: my $srcf=$2;
820: my $srct=$3;
821: my $srcd=$1;
822: unless ($srcd=~/^\/home\/httpd\/html\/res/) {
823: print $logfile "\nPANIC: Target dir is ".$srcd;
824: return "<font color=red>Invalid target directory, FAIL</font>";
825: }
826: opendir(DIR,$srcd);
827: while ($filename=readdir(DIR)) {
828: if ($filename=~/$srcf\.(\d+)\.$srct$/) {
829: $maxversion=($1>$maxversion)?$1:$maxversion;
830: }
831: }
832: closedir(DIR);
833: $maxversion++;
834: $scrout.='<p>Creating old version '.$maxversion;
835: print $logfile "\nCreating old version ".$maxversion;
836:
837: my $copyfile=$srcd.'/'.$srcf.'.'.$maxversion.'.'.$srct;
838:
1.13 www 839: if (copy($target,$copyfile)) {
1.12 www 840: print $logfile "Copied old target to ".$copyfile."\n";
841: $scrout.='<p>Copied old target file';
842: } else {
1.13 www 843: print $logfile "Unable to write ".$copyfile.':'.$!."\n";
844: return "<font color=red>Failed to copy old target, $!, FAIL</font>";
1.12 www 845: }
846:
847: # --------------------------------------------------------------- Copy Metadata
848:
849: $copyfile=$copyfile.'.meta';
1.13 www 850:
851: if (copy($target.'.meta',$copyfile)) {
1.14 www 852: print $logfile "Copied old target metadata to ".$copyfile."\n";
1.12 www 853: $scrout.='<p>Copied old metadata';
854: } else {
1.13 www 855: print $logfile "Unable to write metadata ".$copyfile.':'.$!."\n";
1.14 www 856: if (-e $target.'.meta') {
857: return
1.13 www 858: "<font color=red>Failed to write old metadata copy, $!, FAIL</font>";
1.14 www 859: }
1.12 www 860: }
1.11 www 861:
862:
1.12 www 863: } else {
864: $scrout.='<p>Initial version';
865: print $logfile "\nInitial version";
866: }
867:
868: # ---------------------------------------------------------------- Write Source
869: my $copyfile=$target;
870:
871: my @parts=split(/\//,$copyfile);
872: my $path="/$parts[1]/$parts[2]/$parts[3]/$parts[4]";
873:
874: my $count;
875: for ($count=5;$count<$#parts;$count++) {
876: $path.="/$parts[$count]";
877: if ((-e $path)!=1) {
878: print $logfile "\nCreating directory ".$path;
879: $scrout.='<p>Created directory '.$parts[$count];
880: mkdir($path,0777);
881: }
882: }
883:
1.13 www 884: if (copy($source,$copyfile)) {
1.12 www 885: print $logfile "Copied original source to ".$copyfile."\n";
886: $scrout.='<p>Copied source file';
887: } else {
1.13 www 888: print $logfile "Unable to write ".$copyfile.':'.$!."\n";
889: return "<font color=red>Failed to copy source, $!, FAIL</font>";
1.12 www 890: }
891:
892: # --------------------------------------------------------------- Copy Metadata
893:
1.13 www 894: $copyfile=$copyfile.'.meta';
895:
896: if (copy($source.'.meta',$copyfile)) {
1.12 www 897: print $logfile "Copied original metadata to ".$copyfile."\n";
898: $scrout.='<p>Copied metadata';
899: } else {
1.13 www 900: print $logfile "Unable to write metadata ".$copyfile.':'.$!."\n";
1.12 www 901: return
1.13 www 902: "<font color=red>Failed to write metadata copy, $!, FAIL</font>";
1.12 www 903: }
904:
905: # --------------------------------------------------- Send update notifications
906:
907: {
908:
909: my $filename;
910:
911: $target=~/(.*)\/([^\/]+)$/;
912: my $srcf=$2;
913: opendir(DIR,$1);
914: while ($filename=readdir(DIR)) {
915: if ($filename=~/$srcf\.(\w+)$/) {
916: my $subhost=$1;
917: if ($subhost ne 'meta') {
918: $scrout.='<p>Notifying host '.$subhost.':';
919: print $logfile "\nNotifying host '.$subhost.':'";
920: my $reply=&Apache::lonnet::critical('update:'.$target,$subhost);
1.20 www 921: $scrout.=$reply;
922: print $logfile $reply;
923: }
924: }
925: }
926: closedir(DIR);
927:
928: }
929:
930: # ---------------------------------------- Send update notifications, meta only
931:
932: {
933:
934: my $filename;
935:
936: $target=~/(.*)\/([^\/]+)$/;
937: my $srcf=$2.'.meta';
938: opendir(DIR,$1);
939: while ($filename=readdir(DIR)) {
940: if ($filename=~/$srcf\.(\w+)$/) {
941: my $subhost=$1;
942: if ($subhost ne 'meta') {
943: $scrout.=
944: '<p>Notifying host for metadata only '.$subhost.':';
945: print $logfile
946: "\nNotifying host for metadata only '.$subhost.':'";
947: my $reply=&Apache::lonnet::critical(
948: 'update:'.$target.'.meta',$subhost);
1.12 www 949: $scrout.=$reply;
950: print $logfile $reply;
951: }
952: }
953: }
954: closedir(DIR);
955:
956: }
957:
958: # ------------------------------------------------ Provide link to new resource
959:
960: my $thisdistarget=$target;
961: $thisdistarget=~s/^$docroot//;
962:
1.22 www 963: my $thissrc=$source;
964: $thissrc=~s/^\/home\/(\w+)\/public_html/\/priv\/$1/;
965:
966: my $thissrcdir=$thissrc;
967: $thissrcdir=~s/\/[^\/]+$/\//;
968:
969:
1.29 harris41 970: return $warning.$scrout.
1.75 matthew 971: '<hr><a href="'.$thisdistarget.'"><font size=+2>View Published Version</font></a>'.
1.22 www 972: '<p><a href="'.$thissrc.'"><font size=+2>Back to Source</font></a>'.
973: '<p><a href="'.$thissrcdir.
974: '"><font size=+2>Back to Source Directory</font></a>';
975:
1.11 www 976: }
977:
1.1 www 978: # ================================================================ Main Handler
979:
980: sub handler {
981: my $r=shift;
1.2 www 982:
983: if ($r->header_only) {
984: $r->content_type('text/html');
985: $r->send_http_header;
986: return OK;
987: }
988:
1.43 www 989: # Get query string for limited number of parameters
990:
1.65 harris41 991: foreach (split(/&/,$ENV{'QUERY_STRING'})) {
1.43 www 992: my ($name, $value) = split(/=/,$_);
993: $value =~ tr/+/ /;
994: $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
995: if ($name eq 'filename') {
996: unless ($ENV{'form.'.$name}) {
997: $ENV{'form.'.$name}=$value;
998: }
999: }
1.65 harris41 1000: }
1.43 www 1001:
1002:
1.2 www 1003: # -------------------------------------------------------------- Check filename
1004:
1005: my $fn=$ENV{'form.filename'};
1006:
1.27 www 1007:
1.2 www 1008: unless ($fn) {
1.27 www 1009: $r->log_reason($cuname.' at '.$cudom.
1.2 www 1010: ' trying to publish empty filename', $r->filename);
1011: return HTTP_NOT_FOUND;
1012: }
1.4 www 1013:
1.31 www 1014: ($cuname,$cudom)=
1015: &Apache::loncacc::constructaccess($fn,$r->dir_config('lonDefDomain'));
1016: unless (($cuname) && ($cudom)) {
1.27 www 1017: $r->log_reason($cuname.' at '.$cudom.
1.4 www 1018: ' trying to publish file '.$ENV{'form.filename'}.
1.27 www 1019: ' ('.$fn.') - not authorized',
1020: $r->filename);
1021: return HTTP_NOT_ACCEPTABLE;
1022: }
1023:
1024: unless (&Apache::lonnet::homeserver($cuname,$cudom)
1025: eq $r->dir_config('lonHostID')) {
1026: $r->log_reason($cuname.' at '.$cudom.
1027: ' trying to publish file '.$ENV{'form.filename'}.
1028: ' ('.$fn.') - not homeserver ('.
1029: &Apache::lonnet::homeserver($cuname,$cudom).')',
1.4 www 1030: $r->filename);
1031: return HTTP_NOT_ACCEPTABLE;
1032: }
1.2 www 1033:
1.43 www 1034: $fn=~s/^http\:\/\/[^\/]+//;
1035: $fn=~s/^\/\~(\w+)/\/home\/$1\/public_html/;
1.2 www 1036:
1037: my $targetdir='';
1.12 www 1038: $docroot=$r->dir_config('lonDocRoot');
1.27 www 1039: if ($1 ne $cuname) {
1040: $r->log_reason($cuname.' at '.$cudom.
1.2 www 1041: ' trying to publish unowned file '.$ENV{'form.filename'}.
1042: ' ('.$fn.')',
1043: $r->filename);
1044: return HTTP_NOT_ACCEPTABLE;
1045: } else {
1.27 www 1046: $targetdir=$docroot.'/res/'.$cudom;
1.2 www 1047: }
1048:
1049:
1050: unless (-e $fn) {
1.27 www 1051: $r->log_reason($cuname.' at '.$cudom.
1.2 www 1052: ' trying to publish non-existing file '.$ENV{'form.filename'}.
1053: ' ('.$fn.')',
1054: $r->filename);
1055: return HTTP_NOT_FOUND;
1056: }
1057:
1.11 www 1058: unless ($ENV{'form.phase'} eq 'two') {
1059:
1.2 www 1060: # --------------------------------- File is there and owned, init lookup tables
1061:
1.3 www 1062: %addid=();
1063:
1064: {
1065: my $fh=Apache::File->new($r->dir_config('lonTabDir').'/addid.tab');
1066: while (<$fh>=~/(\w+)\s+(\w+)/) {
1067: $addid{$1}=$2;
1068: }
1.5 www 1069: }
1070:
1071: %nokey=();
1072:
1073: {
1074: my $fh=Apache::File->new($r->dir_config('lonIncludes').'/un_keyword.tab');
1.65 harris41 1075: while (<$fh>) {
1.5 www 1076: my $word=$_;
1077: chomp($word);
1078: $nokey{$word}=1;
1.65 harris41 1079: }
1.3 www 1080: }
1.11 www 1081:
1082: }
1083:
1.2 www 1084: # ----------------------------------------------------------- Start page output
1085:
1.1 www 1086: $r->content_type('text/html');
1087: $r->send_http_header;
1088:
1089: $r->print('<html><head><title>LON-CAPA Publishing</title></head>');
1.15 www 1090: $r->print(
1091: '<body bgcolor="#FFFFFF"><img align=right src=/adm/lonIcons/lonlogos.gif>');
1.2 www 1092: my $thisfn=$fn;
1093:
1094: # ------------------------------------------------------------- Individual file
1095: {
1096: $thisfn=~/\.(\w+)$/;
1097: my $thistype=$1;
1.65 harris41 1098: my $thisembstyle=&Apache::loncommon::fileembstyle($thistype);
1.2 www 1099:
1100: my $thistarget=$thisfn;
1101:
1102: $thistarget=~s/^\/home/$targetdir/;
1103: $thistarget=~s/\/public\_html//;
1104:
1105: my $thisdistarget=$thistarget;
1106: $thisdistarget=~s/^$docroot//;
1107:
1108: my $thisdisfn=$thisfn;
1.27 www 1109: $thisdisfn=~s/^\/home\/$cuname\/public_html\///;
1.2 www 1110:
1111: $r->print('<h2>Publishing '.
1.66 harris41 1112: &Apache::loncommon::filedescription($thistype).' <tt>'.
1.2 www 1113: $thisdisfn.'</tt></h2><b>Target:</b> <tt>'.$thisdistarget.'</tt><p>');
1.27 www 1114:
1115: if (($cuname ne $ENV{'user.name'}) || ($cudom ne $ENV{'user.domain'})) {
1116: $r->print('<h3><font color=red>Co-Author: '.$cuname.' at '.$cudom.
1117: '</font></h3>');
1118: }
1.26 www 1119:
1.65 harris41 1120: if (&Apache::loncommon::fileembstyle($thistype) eq 'ssi') {
1.28 www 1121: $r->print('<br><a href="/adm/diff?filename=/~'.$cuname.'/'.
1122: $thisdisfn.
1.26 www 1123: '&versionone=priv" target=cat>Diffs with Current Version</a><p>');
1124: }
1.11 www 1125:
1.2 www 1126: # ------------ We are publishing from $thisfn to $thistarget with $thisembstyle
1127:
1.11 www 1128: unless ($ENV{'form.phase'} eq 'two') {
1.27 www 1129: $r->print(
1130: '<hr>'.&publish($thisfn,$thistarget,$thisembstyle));
1.11 www 1131: } else {
1.27 www 1132: $r->print(
1133: '<hr>'.&phasetwo($thisfn,$thistarget,$thisembstyle,$thisdistarget));
1.11 www 1134: }
1.2 www 1135:
1.11 www 1136: }
1.1 www 1137: $r->print('</body></html>');
1.15 www 1138:
1.1 www 1139: return OK;
1140: }
1141:
1142: 1;
1143: __END__
1144:
1.66 harris41 1145: =head1 NAME
1.1 www 1146:
1.66 harris41 1147: Apache::lonpublisher - Publication Handler
1.1 www 1148:
1.66 harris41 1149: =head1 SYNOPSIS
1.1 www 1150:
1.66 harris41 1151: Invoked by /etc/httpd/conf/srm.conf:
1.1 www 1152:
1.66 harris41 1153: <Location /adm/publish>
1154: PerlAccessHandler Apache::lonacc
1155: SetHandler perl-script
1156: PerlHandler Apache::lonpublisher
1157: ErrorDocument 403 /adm/login
1158: ErrorDocument 404 /adm/notfound.html
1159: ErrorDocument 406 /adm/unauthorized.html
1160: ErrorDocument 500 /adm/errorhandler
1161: </Location>
1.1 www 1162:
1.66 harris41 1163: =head1 INTRODUCTION
1.1 www 1164:
1.66 harris41 1165: This module publishes a file. This involves gathering metadata,
1166: versioning the file, copying file from construction space to
1167: publication space, and copying metadata from construction space
1168: to publication space.
1169:
1170: This is part of the LearningOnline Network with CAPA project
1171: described at http://www.lon-capa.org.
1172:
1173: =head1 HANDLER SUBROUTINE
1174:
1175: This routine is called by Apache and mod_perl.
1176:
1177: =over 4
1178:
1179: =item *
1180:
1181: Get query string for limited number of parameters
1182:
1183: =item *
1184:
1185: Check filename
1186:
1187: =item *
1188:
1189: File is there and owned, init lookup tables
1190:
1191: =item *
1192:
1193: Start page output
1194:
1195: =item *
1196:
1197: Individual file
1198:
1199: =item *
1200:
1201: publish from $thisfn to $thistarget with $thisembstyle
1202:
1203: =back
1204:
1205: =head1 OTHER SUBROUTINES
1206:
1207: =over 4
1208:
1209: =item *
1210:
1211: metaeval() : Evaluate string with metadata
1212:
1213: =item *
1214:
1215: metaread() : Read a metadata file
1216:
1217: =item *
1218:
1219: sqltime() : convert 'time' format into a datetime sql format
1220:
1221: =item *
1222:
1223: textfield() : form field
1224:
1225: =item *
1226:
1227: hiddenfield() : form field
1228:
1229: =item *
1230:
1231: selectbox() : form field
1232:
1233: =item *
1234:
1235: urlfixup() : fixup URL (Publication Step One)
1236:
1237: =item *
1238:
1239: publish() : publish (Publication Step One)
1240:
1241: =item *
1242:
1243: phasetwo() : render second interface showing status of publication steps
1244: (Publication Step Two)
1245:
1246: =back
1247:
1248: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>