# The LearningOnline Network with CAPA
# Publication Handler
#
# $Id: lonpublisher.pm,v 1.126 2003/07/23 19:17:27 bowersj2 Exp $
#
# Copyright Michigan State University Board of Trustees
#
# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
#
# LON-CAPA is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# LON-CAPA is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with LON-CAPA; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
# /home/httpd/html/adm/gpl.txt
#
# http://www.lon-capa.org/
#
# 
# (TeX Content Handler
#
# 05/29/00,05/30,10/11 Gerd Kortemeyer)
#
# 11/28,11/29,11/30,12/01,12/02,12/04,12/23 Gerd Kortemeyer
# 03/23 Guy Albertelli
# 03/24,03/29,04/03 Gerd Kortemeyer
# 05/03,05/05,05/07 Gerd Kortemeyer
# 06/23,08/07,08/11,8/13,8/17,8/18,8/24,9/26,10/16 Gerd Kortemeyer
# 12/04,12/05 Guy Albertelli
# 12/05 Gerd Kortemeyer
# 12/05 Guy Albertelli
# 12/06,12/07 Gerd Kortemeyer
# 12/25 Gerd Kortemeyer
# YEAR=2002
# 1/17 Gerd Kortemeyer
#
###

###############################################################################
##                                                                           ##
## ORGANIZATION OF THIS PERL MODULE                                          ##
##                                                                           ##
## 1. Modules used by this module                                            ##
## 2. Various subroutines                                                    ##
## 3. Publication Step One                                                   ##
## 4. Phase Two                                                              ##
## 5. Main Handler                                                           ##
##                                                                           ##
###############################################################################


######################################################################
######################################################################

=pod 

=head1 NAME

lonpublisher - LON-CAPA publishing handler

=head1 SYNOPSIS

B<lonpublisher> is used by B<mod_perl> inside B<Apache>.  This is the
invocation by F<loncapa_apache.conf>:

  <Location /adm/publish>
  PerlAccessHandler       Apache::lonacc
  SetHandler perl-script
  PerlHandler Apache::lonpublisher
  ErrorDocument     403 /adm/login
  ErrorDocument     404 /adm/notfound.html
  ErrorDocument     406 /adm/unauthorized.html
  ErrorDocument     500 /adm/errorhandler
  </Location>

=head1 DESCRIPTION

B<lonpublisher> takes the proper steps to add resources to the LON-CAPA
digital library.  This includes updating the metadata table in the
LON-CAPA database.

B<lonpublisher> is many things to many people.  

This module publishes a file.  This involves gathering metadata,
versioning the file, copying file from construction space to
publication space, and copying metadata from construction space
to publication space.

=head2 SUBROUTINES

Many of the undocumented subroutines implement various magical
parsing shortcuts.

=over 4

=cut

######################################################################
######################################################################


package Apache::lonpublisher;

# ------------------------------------------------- modules used by this module
use strict;
use Apache::File;
use File::Copy;
use Apache::Constants qw(:common :http :methods);
use HTML::LCParser;
use Apache::lonxml;
use Apache::loncacc;
use DBI;
use Apache::lonnet();
use Apache::loncommon();
use Apache::lonmysql;
use vars qw(%metadatafields %metadatakeys);

my %addid;
my %nokey;

my $docroot;

my $cuname;
my $cudom;

=pod

=item B<metaeval>

Evaluates a string that contains metadata.  This subroutine
stores values inside I<%metadatafields> and I<%metadatakeys>.
The hash key is a I<$unikey> corresponding to a unique id
that is descriptive of the parser location inside the XML tree.

Parameters:

=over 4

=item I<$metastring>

A string that contains metadata.

=back

Returns:

nothing

=cut

#########################################
#########################################
sub metaeval {
    my $metastring=shift;
   
        my $parser=HTML::LCParser->new(\$metastring);
        my $token;
        while ($token=$parser->get_token) {
           if ($token->[0] eq 'S') {
	      my $entry=$token->[1];
              my $unikey=$entry;
              if (defined($token->[2]->{'package'})) { 
                  $unikey.='_package_'.$token->[2]->{'package'};
              } 
              if (defined($token->[2]->{'part'})) { 
                 $unikey.='_'.$token->[2]->{'part'}; 
	      }
              if (defined($token->[2]->{'id'})) { 
                  $unikey.='_'.$token->[2]->{'id'};
              } 
              if (defined($token->[2]->{'name'})) { 
                 $unikey.='_'.$token->[2]->{'name'}; 
	      }
              foreach (@{$token->[3]}) {
		  $metadatafields{$unikey.'.'.$_}=$token->[2]->{$_};
                  if ($metadatakeys{$unikey}) {
		      $metadatakeys{$unikey}.=','.$_;
                  } else {
                      $metadatakeys{$unikey}=$_;
                  }
              }
              if ($metadatafields{$unikey}) {
		  my $newentry=$parser->get_text('/'.$entry);
                  unless (($metadatafields{$unikey}=~/\Q$newentry\E/) ||
                          ($newentry eq '')) {
                     $metadatafields{$unikey}.=', '.$newentry;
		  }
	      } else {
                 $metadatafields{$unikey}=$parser->get_text('/'.$entry);
              }
          }
       }
}

#########################################
#########################################

=pod

=item B<metaread>

Read a metadata file

Parameters:

=over

=item I<$logfile>

File output stream to output errors and warnings to.

=item I<$fn>

File name (including path).

=back

Returns:

=over 4

=item Scalar string (if successful)

XHTML text that indicates successful reading of the metadata.

=back

=cut

#########################################
#########################################
sub metaread {
    my ($logfile,$fn)=@_;
    unless (-e $fn) {
	print($logfile 'No file '.$fn."\n");
        return '<br /><b>No file:</b> <tt>'.$fn.'</tt>';
    }
    print($logfile 'Processing '.$fn."\n");
    my $metastring;
    {
     my $metafh=Apache::File->new($fn);
     $metastring=join('',<$metafh>);
    }
    &metaeval($metastring);
    return '<br /><b>Processed file:</b> <tt>'.$fn.'</tt>';
}

#########################################
#########################################

sub coursedependencies {
    my $url=&Apache::lonnet::declutter(shift);
    $url=~s/\.meta$//;
    my ($adomain,$aauthor)=($url=~/^(\w+)\/(\w+)\//);
    my $regexp=$url;
    $regexp=~s/(\W)/\\$1/g;
    $regexp='___'.$regexp.'___course';
    my %evaldata=&Apache::lonnet::dump('nohist_resevaldata',$adomain,
				       $aauthor,$regexp);
    my %courses=();
    foreach (keys %evaldata) {
	if ($_=~/^([a-zA-Z0-9]+_[a-zA-Z0-9]+)___.+___course$/) {
	    $courses{$1}=1;
        }
    }
    return %courses;
}
#########################################
#########################################


=pod

=item Form-field-generating subroutines.

For input parameters, these subroutines take in values
such as I<$name>, I<$value> and other form field metadata.
The output (scalar string that is returned) is an XHTML
string which presents the form field (foreseeably inside
<form></form> tags).

=over 4

=item B<textfield>

=item B<hiddenfield>

=item B<selectbox>

=back

=cut

#########################################
#########################################
sub textfield {
    my ($title,$name,$value)=@_;
    my $uctitle=uc($title);
    return "\n<p><font color=\"#800000\" face=\"helvetica\"><b>$uctitle:".
           "</b></font></p><br />".
           '<input type="text" name="'.$name.'" size=80 value="'.$value.'" />';
}

sub hiddenfield {
    my ($name,$value)=@_;
    return "\n".'<input type="hidden" name="'.$name.'" value="'.$value.'" />';
}

sub selectbox {
    my ($title,$name,$value,$functionref,@idlist)=@_;
    my $uctitle=uc($title);
    $value=(split(/\s*,\s*/,$value))[-1];
    my $selout="\n<p><font color=\"#800000\" face=\"helvetica\"><b>$uctitle:".
	'</b></font></p><br /><select name="'.$name.'">';
    foreach (@idlist) {
        $selout.='<option value=\''.$_.'\'';
        if ($_ eq $value) {
	    $selout.=' selected>'.&{$functionref}($_).'</option>';
	}
        else {$selout.='>'.&{$functionref}($_).'</option>';}
    }
    return $selout.'</select>';
}

#########################################
#########################################

=pod

=item B<urlfixup>

Fix up a url?  First step of publication

=cut

#########################################
#########################################
sub urlfixup {
    my ($url,$target)=@_;
    unless ($url) { return ''; }
    #javascript code needs no fixing
    if ($url =~ /^javascript:/i) { return $url; }
    if ($url =~ /^mailto:/i) { return $url; }
    #internal document links need no fixing
    if ($url =~ /^\#/) { return $url; } 
    my ($host)=($url=~/(?:http\:\/\/)*([^\/]+)/);
    foreach (values %Apache::lonnet::hostname) {
	if ($_ eq $host) {
	    $url=~s/^http\:\/\///;
            $url=~s/^$host//;
        }
    }
    if ($url=~/^http\:\/\//) { return $url; }
    $url=~s/\~$cuname/res\/$cudom\/$cuname/;
    return $url;
}

#########################################
#########################################

=pod

=item B<absoluteurl>

Currently undocumented.

=cut

#########################################
#########################################
sub absoluteurl {
    my ($url,$target)=@_;
    unless ($url) { return ''; }
    if ($target) {
	$target=~s/\/[^\/]+$//;
       $url=&Apache::lonnet::hreflocation($target,$url);
    }
    return $url;
}

#########################################
#########################################

=pod

=item B<set_allow>

Currently undocumented    

=cut

#########################################
#########################################
sub set_allow {
    my ($allow,$logfile,$target,$tag,$oldurl)=@_;
    my $newurl=&urlfixup($oldurl,$target);
    my $return_url=$oldurl;
    print $logfile 'GUYURL: '.$tag.':'.$oldurl.' - '.$newurl."\n";
    if ($newurl ne $oldurl) {
	$return_url=$newurl;
	print $logfile 'URL: '.$tag.':'.$oldurl.' - '.$newurl."\n";
    }
    if (($newurl !~ /^javascript:/i) &&
	($newurl !~ /^mailto:/i) &&
	($newurl !~ /^http:/i) &&
	($newurl !~ /^\#/)) {
	$$allow{&absoluteurl($newurl,$target)}=1;
    }
    return $return_url
}

#########################################
#########################################

=pod

=item B<get_subscribed_hosts>

Currently undocumented    

=cut

#########################################
#########################################
sub get_subscribed_hosts {
    my ($target)=@_;
    my @subscribed;
    my $filename;
    $target=~/(.*)\/([^\/]+)$/;
    my $srcf=$2;
    opendir(DIR,$1);
    while ($filename=readdir(DIR)) {
	if ($filename=~/\Q$srcf\E\.(\w+)$/) {
	    my $subhost=$1;
	    if (($subhost ne 'meta' && $subhost ne 'subscription') &&
                ($subhost ne $Apache::lonnet::perlvar{'lonHostID'})) {
		push(@subscribed,$subhost);
	    }
	}
    }
    closedir(DIR);
    my $sh;
    if ( $sh=Apache::File->new("$target.subscription") ) {
	&Apache::lonnet::logthis("opened $target.subscription");
	while (my $subline=<$sh>) {
	    &Apache::lonnet::logthis("Trying $subline");
	    if ($subline =~ /(^\w+):/) { 
                if ($1 ne $Apache::lonnet::perlvar{'lonHostID'}) { 
                   push(@subscribed,$1);
	        }
            } else {
		&Apache::lonnet::logthis("No Match for $subline");
	    }
	}
    } else {
	&Apache::lonnet::logthis("Unable to open $target.subscription");
    }
    return @subscribed;
}


#########################################
#########################################

=pod

=item B<get_max_ids_indices>

Currently undocumented    

=cut

#########################################
#########################################
sub get_max_ids_indices {
    my ($content)=@_;
    my $maxindex=10;
    my $maxid=10;
    my $needsfixup=0;
    my $duplicateids=0;

    my %allids;
    my %duplicatedids;

    my $parser=HTML::LCParser->new($content);
    my $token;
    while ($token=$parser->get_token) {
	if ($token->[0] eq 'S') {
	    my $counter;
	    if ($counter=$addid{$token->[1]}) {
		if ($counter eq 'id') {
		    if (defined($token->[2]->{'id'})) {
			$maxid=($token->[2]->{'id'}>$maxid)?$token->[2]->{'id'}:$maxid;
			if (exists($allids{$token->[2]->{'id'}})) {
			    $duplicateids=1;
			    $duplicatedids{$token->[2]->{'id'}}=1;
			} else {
			    $allids{$token->[2]->{'id'}}=1;
			}
		    } else {
			$needsfixup=1;
		    }
		} else {
		    if (defined($token->[2]->{'index'})) {
			$maxindex=($token->[2]->{'index'}>$maxindex)?$token->[2]->{'index'}:$maxindex;
		    } else {
			$needsfixup=1;
		    }
		}
	    }
	}
    }
    return ($needsfixup,$maxid,$maxindex,$duplicateids,
	    (keys(%duplicatedids)));
}

#########################################
#########################################

=pod

=item B<get_all_text_unbalanced>

Currently undocumented    

=cut

#########################################
#########################################
sub get_all_text_unbalanced {
    #there is a copy of this in lonxml.pm
    my($tag,$pars)= @_;
    my $token;
    my $result='';
    $tag='<'.$tag.'>';
    while ($token = $$pars[-1]->get_token) {
	if (($token->[0] eq 'T')||($token->[0] eq 'C')||($token->[0] eq 'D')) {
	    $result.=$token->[1];
	} elsif ($token->[0] eq 'PI') {
	    $result.=$token->[2];
	} elsif ($token->[0] eq 'S') {
	    $result.=$token->[4];
	} elsif ($token->[0] eq 'E')  {
	    $result.=$token->[2];
	}
	if ($result =~ /(.*)\Q$tag\E(.*)/s) {
	    #&Apache::lonnet::logthis('Got a winner with leftovers ::'.$2);
	    #&Apache::lonnet::logthis('Result is :'.$1);
	    $result=$1;
	    my $redo=$tag.$2;
	    push (@$pars,HTML::LCParser->new(\$redo));
	    $$pars[-1]->xml_mode('1');
	    last;
	}
    }
    return $result
}

#########################################
#########################################

=pod

=item B<fix_ids_and_indices>

Currently undocumented    

=cut

#########################################
#########################################
#Arguably this should all be done as a lonnet::ssi instead
sub fix_ids_and_indices {
    my ($logfile,$source,$target)=@_;

    my %allow;
    my $content;
    {
	my $org=Apache::File->new($source);
	$content=join('',<$org>);
    }

    my ($needsfixup,$maxid,$maxindex,$duplicateids,@duplicatedids)=
	&get_max_ids_indices(\$content);

    print $logfile ("Got $needsfixup,$maxid,$maxindex,$duplicateids--".
			   join(', ',@duplicatedids));
    if ($duplicateids) {
	print $logfile "Duplicate ID(s) exist, ".join(', ',@duplicatedids)."\n";
	my $outstring='<font color="red">Unable to publish file, it contains duplicated ID(s), ID(s) need to be unique. The duplicated ID(s) are: '.join(', ',@duplicatedids).'</font>';
	return ($outstring,1);
    }
    if ($needsfixup) {
	print $logfile "Needs ID and/or index fixup\n".
	    "Max ID   : $maxid (min 10)\n".
                "Max Index: $maxindex (min 10)\n";
    }
    my $outstring='';
    my @parser;
    $parser[0]=HTML::LCParser->new(\$content);
    $parser[-1]->xml_mode(1);
    my $token;
    while (@parser) {
	while ($token=$parser[-1]->get_token) {
	    if ($token->[0] eq 'S') {
		my $counter;
		my $tag=$token->[1];
		my $lctag=lc($tag);
		if ($lctag eq 'allow') {
		    $allow{$token->[2]->{'src'}}=1;
		    next;
		}
		my %parms=%{$token->[2]};
		$counter=$addid{$tag};
		if (!$counter) { $counter=$addid{$lctag}; }
		if ($counter) {
		    if ($counter eq 'id') {
			unless (defined($parms{'id'})) {
			    $maxid++;
			    $parms{'id'}=$maxid;
			    print $logfile 'ID: '.$tag.':'.$maxid."\n";
			}
		    } elsif ($counter eq 'index') {
			unless (defined($parms{'index'})) {
			    $maxindex++;
			    $parms{'index'}=$maxindex;
			    print $logfile 'Index: '.$tag.':'.$maxindex."\n";
			}
		    }
		}
		foreach my $type ('src','href','background','bgimg') {
		    foreach my $key (keys(%parms)) {
			if ($key =~ /^$type$/i) {
			    $parms{$key}=&set_allow(\%allow,$logfile,
						    $target,$tag,
						    $parms{$key});
			}
		    }
		}
		# probably a <randomlabel> image type <label>
		if ($lctag eq 'label' && defined($parms{'description'})) {
		    my $next_token=$parser[-1]->get_token();
		    if ($next_token->[0] eq 'T') {
			$next_token->[1]=&set_allow(\%allow,$logfile,
						    $target,$tag,
						    $next_token->[1]);
		    }
		    $parser[-1]->unget_token($next_token);
		}
		if ($lctag eq 'applet') {
		    my $codebase='';
		    if (defined($parms{'codebase'})) {
			my $oldcodebase=$parms{'codebase'};
			unless ($oldcodebase=~/\/$/) {
			    $oldcodebase.='/';
			}
			$codebase=&urlfixup($oldcodebase,$target);
			$codebase=~s/\/$//;    
			if ($codebase ne $oldcodebase) {
			    $parms{'codebase'}=$codebase;
			    print $logfile 'URL codebase: '.$tag.':'.
				$oldcodebase.' - '.
				    $codebase."\n";
			}
			$allow{&absoluteurl($codebase,$target).'/*'}=1;
		    } else {
			foreach ('archive','code','object') {
			    if (defined($parms{$_})) {
				my $oldurl=$parms{$_};
				my $newurl=&urlfixup($oldurl,$target);
				$newurl=~s/\/[^\/]+$/\/\*/;
				print $logfile 'Allow: applet '.$_.':'.
				    $oldurl.' allows '.
					$newurl."\n";
				$allow{&absoluteurl($newurl,$target)}=1;
			    }
			}
		    }
		}
		my $newparmstring='';
		my $endtag='';
		foreach (keys %parms) {
		    if ($_ eq '/') {
			$endtag=' /';
		    } else { 
			my $quote=($parms{$_}=~/\"/?"'":'"');
			$newparmstring.=' '.$_.'='.$quote.$parms{$_}.$quote;
		    }
		}
		if (!$endtag) { if ($token->[4]=~m:/>$:) { $endtag=' /'; }; }
		$outstring.='<'.$tag.$newparmstring.$endtag.'>';
		if ($lctag eq 'm') {
		    $outstring.=&get_all_text_unbalanced('/m',\@parser);
		}
	    } elsif ($token->[0] eq 'E') {
		if ($token->[2]) {
		    unless ($token->[1] eq 'allow') {
			$outstring.='</'.$token->[1].'>';
		    }
		}
	    } else {
		$outstring.=$token->[1];
	    }
	}
	pop(@parser);
    }

    if ($needsfixup) {
	print $logfile "End of ID and/or index fixup\n".
	    "Max ID   : $maxid (min 10)\n".
		"Max Index: $maxindex (min 10)\n";
    } else {
	print $logfile "Does not need ID and/or index fixup\n";
    }

    return ($outstring,0,%allow);
}

#########################################
#########################################

=pod

=item B<store_metadata>

Store the metadata in the metadata table in the loncapa database.
Uses lonmysql to access the database.

Inputs: \%metadata

Returns: (error,status).  error is undef on success, status is undef on error.

=cut

#########################################
#########################################
sub store_metadata {
    my %metadata = %{shift()};
    my $error;
    # Determine if the table exists
    my $status = &Apache::lonmysql::check_table('metadata');
    if (! defined($status)) {
        $error='<font color="red">WARNING: Cannot connect to '.
            'database!</font>';
        &Apache::lonnet::logthis($error);
        return ($error,undef);
    }
    if ($status == 0) {
        # It would be nice to actually create the table....
        $error ='<font color="red">WARNING: The metadata table does not '.
            'exist in the LON-CAPA database.</font>';
        &Apache::lonnet::logthis($error);
        return ($error,undef);
    }
    # Remove old value from table
    $status = &Apache::lonmysql::remove_from_table
        ('metadata','url',$metadata{'url'});
    if (! defined($status)) {
        $error = '<font color="red">Error when removing old values from '.
            'metadata table in LON-CAPA database.</font>';
        &Apache::lonnet::logthis($error);
        return ($error,undef);
    }
    # Store data in table.
    $status = &Apache::lonmysql::store_row('metadata',\%metadata);
    if (! defined($status)) {
        $error='<font color="red">Error occured storing new values in '.
            'metadata table in LON-CAPA database</font>';
        &Apache::lonnet::logthis($error);
        return ($error,undef);
    }
    return (undef,$status);
}

#########################################
#########################################

=pod

=item B<publish>

This is the workhorse function of this module.  This subroutine generates
backup copies, performs any automatic processing (prior to publication,
especially for rat and ssi files),

Returns a 2 element array, the first is the string to be shown to the
user, the second is an error code, either 1 (an error occured) or 0
(no error occurred)

I<Additional documentation needed.>

=cut

#########################################
#########################################
sub publish {

    my ($source,$target,$style,$batch)=@_;
    my $logfile;
    my $scrout='';
    my $allmeta='';
    my $content='';
    my %allow=();

    unless ($logfile=Apache::File->new('>>'.$source.'.log')) {
	return ('<font color="red">No write permission to user directory, FAIL</font>',1);
    }
    print $logfile 
"\n\n================= Publish ".localtime()." Phase One  ================\n".$ENV{'user.name'}.'@'.$ENV{'user.domain'}."\n";

    if (($style eq 'ssi') || ($style eq 'rat') || ($style eq 'prv')) {
# ------------------------------------------------------- This needs processing

# ----------------------------------------------------------------- Backup Copy
	my $copyfile=$source.'.save';
        if (copy($source,$copyfile)) {
	    print $logfile "Copied original file to ".$copyfile."\n";
        } else {
	    print $logfile "Unable to write backup ".$copyfile.':'.$!."\n";
	    return ("<font color=\"red\">Failed to write backup copy, $!,FAIL</font>",1);
        }
# ------------------------------------------------------------- IDs and indices
	
	my ($outstring,$error);
	($outstring,$error,%allow)=&fix_ids_and_indices($logfile,$source,
							$target);
	if ($error) { return ($outstring,$error); }
# ------------------------------------------------------------ Construct Allows
    
	$scrout.='<h3>Dependencies</h3>';
        my $allowstr='';
        foreach (sort(keys(%allow))) {
	   my $thisdep=$_;
	   if ($thisdep !~ /[^\s]/) { next; }
           unless ($style eq 'rat') { 
              $allowstr.="\n".'<allow src="'.$thisdep.'" />';
	   }
           $scrout.='<br />';
           unless ($thisdep=~/\*/) {
	       $scrout.='<a href="'.$thisdep.'">';
           }
           $scrout.='<tt>'.$thisdep.'</tt>';
           unless ($thisdep=~/\*/) {
	       $scrout.='</a>';
               if (
       &Apache::lonnet::getfile($Apache::lonnet::perlvar{'lonDocRoot'}.'/'.
                                            $thisdep.'.meta') eq '-1') {
		   $scrout.= ' - <font color="red">Currently not available'.
		       '</font>';
               } else {
                   my %temphash=(&Apache::lonnet::declutter($target).'___'.
                             &Apache::lonnet::declutter($thisdep).'___usage'
                                 => time);
                   $thisdep=~/^\/res\/(\w+)\/(\w+)\//;
                   if ((defined($1)) && (defined($2))) {
                      &Apache::lonnet::put('nohist_resevaldata',\%temphash,
					   $1,$2);
		   }
	       }
           }
        }
        $outstring=~s/\n*(\<\/[^\>]+\>)\s*$/$allowstr\n$1\n/s;

	#Encode any High ASCII characters
	$outstring=&HTML::Entities::encode($outstring,"\200-\377");
# ------------------------------------------------------------- Write modified.

        {
          my $org;
          unless ($org=Apache::File->new('>'.$source)) {
             print $logfile "No write permit to $source\n";
             return ('<font color="red">No write permission to '.$source.
		     ', FAIL</font>',1);
	  }
          print($org $outstring);
        }
	  $content=$outstring;

    }
# -------------------------------------------- Initial step done, now metadata.

# --------------------------------------- Storage for metadata keys and fields.

     %metadatafields=();
     %metadatakeys=();
     
     my %oldparmstores=();
     
    unless ($batch) {
     $scrout.='<h3>Metadata Information ' .
       Apache::loncommon::help_open_topic("Metadata_Description")
       . '</h3>';
    }

# ------------------------------------------------ First, check out environment
     unless (-e $source.'.meta') {
        $metadatafields{'author'}=$ENV{'environment.firstname'}.' '.
	                          $ENV{'environment.middlename'}.' '.
		                  $ENV{'environment.lastname'}.' '.
		                  $ENV{'environment.generation'};
        $metadatafields{'author'}=~s/\s+/ /g;
        $metadatafields{'author'}=~s/\s+$//;
        $metadatafields{'owner'}=$cuname.'@'.$cudom;
	$metadatafields{'modifyinguser'}=$ENV{'user.name'}.'@'.
	                                 $ENV{'user.domain'};
	$metadatafields{'authorspace'}=$cuname.'@'.$cudom;

# ------------------------------------------------ Check out directory hierachy

        my $thisdisfn=$source;
        $thisdisfn=~s/^\/home\/\Q$cuname\E\///;

        my @urlparts=split(/\//,$thisdisfn);
        $#urlparts--;

        my $currentpath='/home/'.$cuname.'/';

        foreach (@urlparts) {
	    $currentpath.=$_.'/';
            $scrout.=&metaread($logfile,$currentpath.'default.meta');
        }

# ------------------- Clear out parameters and stores (there should not be any)

        foreach (keys %metadatafields) {
	    if (($_=~/^parameter/) || ($_=~/^stores/)) {
		delete $metadatafields{$_};
            }
        }

    } else {
# ---------------------- Read previous metafile, remember parameters and stores

        $scrout.=&metaread($logfile,$source.'.meta');

        foreach (keys %metadatafields) {
	    if (($_=~/^parameter/) || ($_=~/^stores/)) {
                $oldparmstores{$_}=1;
		delete $metadatafields{$_};
            }
        }
        
    }

# -------------------------------------------------- Parse content for metadata
    if (($style eq 'ssi') || ($style eq 'prv')) {
        my $oldenv=$ENV{'request.uri'};

        $ENV{'request.uri'}=$target;
        $allmeta=Apache::lonxml::xmlparse(undef,'meta',$content);
        $ENV{'request.uri'}=$oldenv;

        &metaeval($allmeta);
    }
# ---------------- Find and document discrepancies in the parameters and stores

    my $chparms='';
    foreach (sort keys %metadatafields) {
	if (($_=~/^parameter/) || ($_=~/^stores/)) {
	    unless ($_=~/\.\w+$/) { 
		unless ($oldparmstores{$_}) {
		    print $logfile 'New: '.$_."\n";
		    $chparms.=$_.' ';
		}
	    }
	}
    }
    if ($chparms) {
	$scrout.='<p><b>New parameters or stored values:</b> '.$chparms.'</p>';
    }

    $chparms='';
    foreach (sort keys %oldparmstores) {
	if (($_=~/^parameter/) || ($_=~/^stores/)) {
	    unless (($metadatafields{$_.'.name'}) ||
		    ($metadatafields{$_.'.package'}) || ($_=~/\.\w+$/)) {
		print $logfile 'Obsolete: '.$_."\n";
		$chparms.=$_.' ';
	    }
	}
    }
    if ($chparms) {
	$scrout.='<p><b>Obsolete parameters or stored values:</b> '.
	    $chparms.'</p>';
    }

# ------------------------------------------------------- Now have all metadata

    my %keywords=();
        
    if (length($content)<500000) {
	my $textonly=$content;
	$textonly=~s/\<script[^\<]+\<\/script\>//g;
	$textonly=~s/\<m\>[^\<]+\<\/m\>//g;
	$textonly=~s/\<[^\>]*\>//g;
	$textonly=~tr/A-Z/a-z/;
	$textonly=~s/[\$\&][a-z]\w*//g;
	$textonly=~s/[^a-z\s]//g;
	
	foreach ($textonly=~m/(\w+)/g) {
	    unless ($nokey{$_}) {
		$keywords{$_}=1;
	    } 
	}
    }

            
    foreach (split(/\W+/,$metadatafields{'keywords'})) {
	$keywords{$_}=1;
    }
# --------------------------------------------------- Now we also have keywords
# =============================================================================
# INTERACTIVE MODE
#
    unless ($batch) {
        $scrout.=
	    '<form name="pubform" action="/adm/publish" method="post">'.
            '<p><input type="submit" value="Finalize Publication" /></p>'.
            &hiddenfield('phase','two').
            &hiddenfield('filename',$ENV{'form.filename'}).
	    &hiddenfield('allmeta',&Apache::lonnet::escape($allmeta)).
            &hiddenfield('dependencies',join(',',keys %allow)).
            &textfield('Title','title',$metadatafields{'title'}).
            &textfield('Author(s)','author',$metadatafields{'author'}).
	    &textfield('Subject','subject',$metadatafields{'subject'});

# --------------------------------------------------- Scan content for keywords

        my $keywords_help = Apache::loncommon::help_open_topic("Publishing_Keywords");
	my $keywordout=<<"END";
<script>
function checkAll(field) {
    for (i = 0; i < field.length; i++)
        field[i].checked = true ;
}

function uncheckAll(field) {
    for (i = 0; i < field.length; i++)
        field[i].checked = false ;
}
</script>
<p><font color="#800000" face="helvetica"><b>KEYWORDS:</b></font>
 $keywords_help</b>
<input type="button" value="check all" onclick="javascript:checkAll(document.pubform.keywords)" /> 
<input type="button" value="uncheck all" onclick="javascript:uncheckAll(document.pubform.keywords)" /> 
</p>
<br />
END
	$keywordout.='<table border="2"><tr>';
	my $colcount=0;

	foreach (sort keys %keywords) {
	    $keywordout.='<td><input type="checkbox" name="keywords" value="'.$_.'"';
	    if ($metadatafields{'keywords'}) {
		if ($metadatafields{'keywords'}=~/\Q$_\E/) {
		    $keywordout.=' checked="on"';
		}
	    } elsif (&Apache::loncommon::keyword($_)) {
		$keywordout.=' checked="on"';
	    }
	    $keywordout.=' />'.$_.'</td>';
	    if ($colcount>10) {
		$keywordout.="</tr><tr>\n";
		$colcount=0;
	    }
	    $colcount++;
	}

	$keywordout.='</tr></table>';

	$scrout.=$keywordout;

	$scrout.=&textfield('Additional Keywords','addkey','');

	$scrout.=&textfield('Notes','notes',$metadatafields{'notes'});

	$scrout.=
	    "\n<p><font color=\"#800000\" face=\"helvetica\"><b>ABSTRACT:".
	    "</b></font></p><br />".
	    '<textarea cols="80" rows="5" name="abstract">'.
	    $metadatafields{'abstract'}.'</textarea></p>';

	$source=~/\.(\w+)$/;

	$scrout.=&hiddenfield('mime',$1);

	my $defaultlanguage=$metadatafields{'language'};
	$defaultlanguage =~ s/\s*notset\s*//g;
	$defaultlanguage =~ s/^,\s*//g;
	$defaultlanguage =~ s/,\s*$//g;

	$scrout.=&selectbox('Language','language',
			    $defaultlanguage,
			    \&Apache::loncommon::languagedescription,
			    (&Apache::loncommon::languageids),
			   );

	unless ($metadatafields{'creationdate'}) {
	    $metadatafields{'creationdate'}=time;
	}
	$scrout.=&hiddenfield('creationdate',
			      &Apache::loncommon::unsqltime($metadatafields{'creationdate'}));

	$scrout.=&hiddenfield('lastrevisiondate',time);


	$scrout.=&textfield('Publisher/Owner','owner',
			    $metadatafields{'owner'});

# -------------------------------------------------- Correct copyright for rat.
        my $defaultoption=$metadatafields{'copyright'};
        unless ($defaultoption) { $defaultoption='default'; }
	unless ($style eq 'prv') {
	    if ($style eq 'rat') {
		if ($metadatafields{'copyright'} eq 'public') { 
		    delete $metadatafields{'copyright'};
                    $defaultoption='default';
		}
		$scrout.=&selectbox('Copyright/Distribution','copyright',
				    $defaultoption,
				    \&Apache::loncommon::copyrightdescription,
				    (grep !/^public$/,(&Apache::loncommon::copyrightids)));
	    } else {
		$scrout.=&selectbox('Copyright/Distribution','copyright',
				    $defaultoption,
				    \&Apache::loncommon::copyrightdescription,
				    (&Apache::loncommon::copyrightids));
	    }
    
	    my $copyright_help =
		Apache::loncommon::help_open_topic('Publishing_Copyright');
	    $scrout =~ s/DISTRIBUTION:/'DISTRIBUTION: ' . $copyright_help/ge;
	    $scrout.=&textfield('Custom Distribution File','customdistributionfile',
				$metadatafields{'customdistributionfile'}).
				    $copyright_help;
	} else {
	    $scrout.=&hiddenfield('copyright','private');
	}
	return ($scrout.'<p><input type="submit" value="Finalize Publication" /></p></form>',0);
# =============================================================================
# BATCH MODE
#
    } else {
# Transfer metadata directly to environment for stage 2
	foreach (keys %metadatafields) {
	    $ENV{'form.'.$_}=$metadatafields{$_};
	}
	$ENV{'form.addkey'}='';
	$ENV{'form.keywords'}='';
	foreach (keys %keywords) {
	    if ($metadatafields{'keywords'}) {
		if ($metadatafields{'keywords'}=~/\Q$_\E/) { 
		    $ENV{'form.keywords'}.=$_.','; 
		}
	    } elsif (&Apache::loncommon::keyword($_)) {
		$ENV{'form.keywords'}.=$_.',';
	    }
	}
	$ENV{'form.keywords'}=~s/\,$//;
	unless ($ENV{'form.creationdate'}) { $ENV{'form.creationdate'}=time; }
	$ENV{'form.lastrevisiondate'}=time;
	if ((($style eq 'rat') && ($ENV{'form.copyright'} eq 'public')) ||
	    (!$ENV{'form.copyright'})) { 
	    $ENV{'form.copyright'}='default';
	}
	$ENV{'form.allmeta'}=&Apache::lonnet::escape($allmeta);
	return ($scrout,0);
    }
}

#########################################
#########################################

=pod 

=item B<phasetwo>

Render second interface showing status of publication steps.
This is publication step two.

Parameters:

=over 4

=item I<$source>

=item I<$target>

=item I<$style>

=item I<$distarget>

=back

Returns:

=over 4

=item Scalar string

String contains status (errors and warnings) and information associated with
the server's attempts at publication.     

=cut

#'stupid emacs
#########################################
#########################################
sub phasetwo {

    my ($r,$source,$target,$style,$distarget,$batch)=@_;
    $source=~s/\/+/\//g;
    $target=~s/\/+/\//g;

    if ($target=~/\_\_\_/) {
	$r->print(
 '<font color="red">Unsupported character combination "<tt>___</tt>" in filename, FAIL</font>');
        return 0;
    }
    $distarget=~s/\/+/\//g;
    my $logfile;
    unless ($logfile=Apache::File->new('>>'.$source.'.log')) {
	$r->print(
        '<font color="red">No write permission to user directory, FAIL</font>');
        return 0;
    }
    print $logfile 
        "\n================= Publish ".localtime()." Phase Two  ================\n".$ENV{'user.name'}.'@'.$ENV{'user.domain'}."\n";
    
    %metadatafields=();
    %metadatakeys=();
    
    &metaeval(&Apache::lonnet::unescape($ENV{'form.allmeta'}));
    
    $metadatafields{'title'}=$ENV{'form.title'};
    $metadatafields{'author'}=$ENV{'form.author'};
    $metadatafields{'subject'}=$ENV{'form.subject'};
    $metadatafields{'notes'}=$ENV{'form.notes'};
    $metadatafields{'abstract'}=$ENV{'form.abstract'};
    $metadatafields{'mime'}=$ENV{'form.mime'};
    $metadatafields{'language'}=$ENV{'form.language'};
    $metadatafields{'creationdate'}=$ENV{'form.creationdate'};
    $metadatafields{'lastrevisiondate'}=$ENV{'form.lastrevisiondate'};
    $metadatafields{'owner'}=$ENV{'form.owner'};
    $metadatafields{'copyright'}=$ENV{'form.copyright'};
    $metadatafields{'customdistributionfile'}=
                                 $ENV{'form.customdistributionfile'};
    $metadatafields{'dependencies'}=$ENV{'form.dependencies'};
    
    my $allkeywords=$ENV{'form.addkey'};
    if (exists($ENV{'form.keywords'})) {
        if (ref($ENV{'form.keywords'})) {
            $allkeywords .= ','.join(',',@{$ENV{'form.keywords'}});
        } else {
            $allkeywords .= ','.$ENV{'form.keywords'};
        }
    }
    $allkeywords=~s/\W+/\,/;
    $allkeywords=~s/^\,//;
    $metadatafields{'keywords'}=$allkeywords;
    
    {
        print $logfile "\nWrite metadata file for ".$source;
        my $mfh;
        unless ($mfh=Apache::File->new('>'.$source.'.meta')) {
            return 
                '<font color="red">Could not write metadata, FAIL</font>';
        }
        foreach (sort keys %metadatafields) {
            unless ($_=~/\./) {
                my $unikey=$_;
                $unikey=~/^([A-Za-z]+)/;
                my $tag=$1;
                $tag=~tr/A-Z/a-z/;
                print $mfh "\n\<$tag";
                foreach (split(/\,/,$metadatakeys{$unikey})) {
                    my $value=$metadatafields{$unikey.'.'.$_};
                    $value=~s/\"/\'\'/g;
                    print $mfh ' '.$_.'="'.$value.'"';
                }
                print $mfh '>'.
                    &HTML::Entities::encode($metadatafields{$unikey})
                        .'</'.$tag.'>';
            }
        }
        $r->print('<p>Wrote Metadata</p>');
        print $logfile "\nWrote metadata";
    }
    
# -------------------------------- Synchronize entry with SQL metadata database

    $metadatafields{'url'} = $distarget;
    $metadatafields{'version'} = 'current';
    unless ($metadatafields{'copyright'} eq 'priv') {
        my ($error,$success) = &store_metadata(\%metadatafields);
        if ($success) {
            $r->print('<p>Synchronized SQL metadata database</p>');
            print $logfile "\nSynchronized SQL metadata database";
        } else {
            $r->print($error);
            print $logfile "\n".$error;
        }
    } else {
        $r->print('<p>Private Publication - did not synchronize database</p>');
        print $logfile "\nPrivate: Did not synchronize data into ".
            "SQL metadata database";
    }
# ----------------------------------------------------------- Copy old versions
   
    if (-e $target) {
        my $filename;
        my $maxversion=0;
        $target=~/(.*)\/([^\/]+)\.(\w+)$/;
        my $srcf=$2;
        my $srct=$3;
        my $srcd=$1;
        unless ($srcd=~/^\/home\/httpd\/html\/res/) {
            print $logfile "\nPANIC: Target dir is ".$srcd;
            return "<font color=\"red\">Invalid target directory, FAIL</font>";
        }
        opendir(DIR,$srcd);
        while ($filename=readdir(DIR)) {
            if (-l $srcd.'/'.$filename) {
                unlink($srcd.'/'.$filename);
                unlink($srcd.'/'.$filename.'.meta');
            } else {
                if ($filename=~/\Q$srcf\E\.(\d+)\.\Q$srct\E$/) {
                    $maxversion=($1>$maxversion)?$1:$maxversion;
                }
            }
        }
        closedir(DIR);
        $maxversion++;
        $r->print('<p>Creating old version '.$maxversion.'</p>');
        print $logfile "\nCreating old version ".$maxversion."\n";
        
        my $copyfile=$srcd.'/'.$srcf.'.'.$maxversion.'.'.$srct;
        
        if (copy($target,$copyfile)) {
	    print $logfile "Copied old target to ".$copyfile."\n";
            $r->print('<p>Copied old target file</p>');
        } else {
	    print $logfile "Unable to write ".$copyfile.':'.$!."\n";
            return "<font color=\"red\">Failed to copy old target, $!, FAIL</font>";
        }
        
# --------------------------------------------------------------- Copy Metadata

	$copyfile=$copyfile.'.meta';
        
        if (copy($target.'.meta',$copyfile)) {
	    print $logfile "Copied old target metadata to ".$copyfile."\n";
            $r->print('<p>Copied old metadata</p>')
        } else {
	    print $logfile "Unable to write metadata ".$copyfile.':'.$!."\n";
            if (-e $target.'.meta') {
                return 
                    "<font color=\"red\">Failed to write old metadata copy, $!, FAIL</font>";
	    }
        }
        
        
    } else {
        $r->print('<p>Initial version</p>');
        print $logfile "\nInitial version";
    }

# ---------------------------------------------------------------- Write Source
    my $copyfile=$target;
    
    my @parts=split(/\//,$copyfile);
    my $path="/$parts[1]/$parts[2]/$parts[3]/$parts[4]";
    
    my $count;
    for ($count=5;$count<$#parts;$count++) {
        $path.="/$parts[$count]";
        if ((-e $path)!=1) {
            print $logfile "\nCreating directory ".$path;
            $r->print('<p>Created directory '.$parts[$count].'</p>');
            mkdir($path,0777);
        }
    }
    
    if (copy($source,$copyfile)) {
        print $logfile "\nCopied original source to ".$copyfile."\n";
        $r->print('<p>Copied source file</p>');
    } else {
        print $logfile "\nUnable to write ".$copyfile.':'.$!."\n";
        return "<font color=\"red\">Failed to copy source, $!, FAIL</font>";
    }
    
# --------------------------------------------------------------- Copy Metadata

    $copyfile=$copyfile.'.meta';
    
    if (copy($source.'.meta',$copyfile)) {
        print $logfile "\nCopied original metadata to ".$copyfile."\n";
        $r->print('<p>Copied metadata</p>');
    } else {
        print $logfile "\nUnable to write metadata ".$copyfile.':'.$!."\n";
        return 
            "<font color=\"red\">Failed to write metadata copy, $!, FAIL</font>";
    }
    $r->rflush;
# --------------------------------------------------- Send update notifications

    my @subscribed=&get_subscribed_hosts($target);
    foreach my $subhost (@subscribed) {
	$r->print('<p>Notifying host '.$subhost.':');$r->rflush;
	print $logfile "\nNotifying host ".$subhost.':';
	my $reply=&Apache::lonnet::critical('update:'.$target,$subhost);
	$r->print($reply.'</p><br />');$r->rflush;
	print $logfile $reply;
    }
    
# ---------------------------------------- Send update notifications, meta only

    my @subscribedmeta=&get_subscribed_hosts("$target.meta");
    foreach my $subhost (@subscribedmeta) {
	$r->print('<p>Notifying host for metadata only '.$subhost.':');$r->rflush;
	print $logfile "\nNotifying host for metadata only ".$subhost.':';
	my $reply=&Apache::lonnet::critical('update:'.$target.'.meta',
					    $subhost);
	$r->print($reply.'</p><br />');$r->rflush;
	print $logfile $reply;
    }
    
# --------------------------------------------------- Notify subscribed courses
    my %courses=&coursedependencies($target);
    my $now=time;
    foreach (keys %courses) {
	$r->print('<p>Notifying course '.$_.':');$r->rflush;
	print $logfile "\nNotifying host ".$_.':';
        my ($cdom,$cname)=split(/\_/,$_);
	my $reply=&Apache::lonnet::cput
                  ('versionupdate',{$target => $now},$cdom,$cname);
	$r->print($reply.'</p><br />');$r->rflush;
	print $logfile $reply;
    }
# ------------------------------------------------ Provide link to new resource
    unless ($batch) {
        my $thisdistarget=$target;
        $thisdistarget=~s/^\Q$docroot\E//;
        
        my $thissrc=$source;
        $thissrc=~s/^\/home\/(\w+)\/public_html/\/priv\/$1/;
        
        my $thissrcdir=$thissrc;
        $thissrcdir=~s/\/[^\/]+$/\//;
        
        
        $r->print(
           '<hr /><a href="'.$thisdistarget.'"><font size="+2">'.
           'View Published Version</font></a>'.
           '<p><a href="'.$thissrc.'"><font size=+2>Back to Source</font></a></p>'.
           '<p><a href="'.$thissrcdir.
                   '"><font size="+2">Back to Source Directory</font></a></p>');
    }
}

#########################################

sub batchpublish {
    my ($r,$srcfile,$targetfile)=@_;
    $srcfile=~s/\/+/\//g;
    $targetfile=~s/\/+/\//g;
    my $thisdisfn=$srcfile;
    $thisdisfn=~s/\/home\/korte\/public_html\///;
    $srcfile=~s/\/+/\//g;

    my $docroot=$r->dir_config('lonDocRoot');
    my $thisdistarget=$targetfile;
    $thisdistarget=~s/^\Q$docroot\E//;


    undef %metadatafields;
    undef %metadatakeys;
     %metadatafields=();
     %metadatakeys=();
      $srcfile=~/\.(\w+)$/;
      my $thistype=$1;


      my $thisembstyle=&Apache::loncommon::fileembstyle($thistype);
     
    $r->print('<h2>Publishing <tt>'.$thisdisfn.'</tt></h2>');

# phase one takes
#  my ($source,$target,$style,$batch)=@_;
    my ($outstring,$error)=&publish($srcfile,$targetfile,$thisembstyle,1);
    $r->print('<p>'.$outstring.'</p>');
# phase two takes
# my ($source,$target,$style,$distarget,batch)=@_;
# $ENV{'form.allmeta'},$ENV{'form.title'},$ENV{'form.author'},...
    if (!$error) {
	$r->print('<p>');
	&phasetwo($r,$srcfile,$targetfile,$thisembstyle,$thisdistarget,1);
	$r->print('</p>');
    }
    return '';
}

#########################################

sub publishdirectory {
    my ($r,$fn,$thisdisfn)=@_;
    $fn=~s/\/+/\//g;
    $thisdisfn=~s/\/+/\//g;
    my $resdir=
    $Apache::lonnet::perlvar{'lonDocRoot'}.'/res/'.$cudom.'/'.$cuname.'/'.
      $thisdisfn;
      $r->print('<h1>Directory <tt>'.$thisdisfn.'</tt></h1>'.
                'Target: <tt>'.$resdir.'</tt><br />');

      my $dirptr=16384;		# Mask indicating a directory in stat.cmode.

      opendir(DIR,$fn);
      my @files=sort(readdir(DIR));
      foreach my $filename (@files) {
         my ($cdev,$cino,$cmode,$cnlink,
            $cuid,$cgid,$crdev,$csize,
            $catime,$cmtime,$cctime,
            $cblksize,$cblocks)=stat($fn.'/'.$filename);

         my $extension='';
         if ($filename=~/\.(\w+)$/) { $extension=$1; }
         if ($cmode&$dirptr) {
	   if (($filename!~/^\./) && ($ENV{'form.pubrec'})) {
	      &publishdirectory($r,$fn.'/'.$filename,$thisdisfn.'/'.$filename);
	   }
         } elsif ((&Apache::loncommon::fileembstyle($extension) ne 'hdn') &&
                  ($filename!~/^[\#\.]/) && ($filename!~/\~$/)) {
# find out publication status and/or exiting metadata
	     my $publishthis=0;
             if (-e $resdir.'/'.$filename) {
	        my ($rdev,$rino,$rmode,$rnlink,
	        $ruid,$rgid,$rrdev,$rsize,
	        $ratime,$rmtime,$rctime,
	        $rblksize,$rblocks)=stat($resdir.'/'.$filename);
	        if (($rmtime<$cmtime) || ($ENV{'form.forcerepub'})) {
# previously published, modified now
		    $publishthis=1;
                }
	     } else {
# never published
		 $publishthis=1;
	     }
             if ($publishthis) {
                &batchpublish($r,$fn.'/'.$filename,$resdir.'/'.$filename);
	     } else {
                 $r->print('<br />Skipping '.$filename.'<br />');
             }
             $r->rflush();
         }
      }
      closedir(DIR);
}
#########################################

=pod

=item B<handler>

A basic outline of the handler subroutine follows.

=over 4

=item *

Get query string for limited number of parameters.

=item *

Check filename.

=item *

File is there and owned, init lookup tables.

=item *

Start page output.

=item *

Evaluate individual file, and then output information.

=item *

Publishing from $thisfn to $thistarget with $thisembstyle.

=back

=cut

#########################################
#########################################
sub handler {
  my $r=shift;

  if ($r->header_only) {
     $r->content_type('text/html');
     $r->send_http_header;
     return OK;
  }

# Get query string for limited number of parameters

    &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
                                            ['filename']);

# -------------------------------------------------------------- Check filename

  my $fn=&Apache::lonnet::unescape($ENV{'form.filename'});

  
  unless ($fn) { 
     $r->log_reason($cuname.' at '.$cudom.
         ' trying to publish empty filename', $r->filename); 
     return HTTP_NOT_FOUND;
  } 

  ($cuname,$cudom)=
    &Apache::loncacc::constructaccess($fn,$r->dir_config('lonDefDomain'));
  unless (($cuname) && ($cudom)) {
     $r->log_reason($cuname.' at '.$cudom.
         ' trying to publish file '.$ENV{'form.filename'}.
         ' ('.$fn.') - not authorized', 
         $r->filename); 
     return HTTP_NOT_ACCEPTABLE;
  }

  unless (&Apache::lonnet::homeserver($cuname,$cudom) 
          eq $r->dir_config('lonHostID')) {
     $r->log_reason($cuname.' at '.$cudom.
         ' trying to publish file '.$ENV{'form.filename'}.
         ' ('.$fn.') - not homeserver ('.
         &Apache::lonnet::homeserver($cuname,$cudom).')', 
         $r->filename); 
     return HTTP_NOT_ACCEPTABLE;
  }

  $fn=~s/^http\:\/\/[^\/]+//;
  $fn=~s/^\/\~(\w+)/\/home\/$1\/public_html/;

  my $targetdir='';
  $docroot=$r->dir_config('lonDocRoot'); 
  if ($1 ne $cuname) {
     $r->log_reason($cuname.' at '.$cudom.
         ' trying to publish unowned file '.$ENV{'form.filename'}.
         ' ('.$fn.')', 
         $r->filename); 
     return HTTP_NOT_ACCEPTABLE;
  } else {
      $targetdir=$docroot.'/res/'.$cudom;
  }
                                 
  
  unless (-e $fn) { 
     $r->log_reason($cuname.' at '.$cudom.
         ' trying to publish non-existing file '.$ENV{'form.filename'}.
         ' ('.$fn.')', 
         $r->filename); 
     return HTTP_NOT_FOUND;
  } 

unless ($ENV{'form.phase'} eq 'two') {

# -------------------------------- File is there and owned, init lookup tables.

  %addid=();

  {
      my $fh=Apache::File->new($r->dir_config('lonTabDir').'/addid.tab');
      while (<$fh>=~/(\w+)\s+(\w+)/) {
          $addid{$1}=$2;
      }
  }

  %nokey=();

  {
     my $fh=Apache::File->new($r->dir_config('lonIncludes').'/un_keyword.tab');
      while (<$fh>) {
          my $word=$_;
          chomp($word);
          $nokey{$word}=1;
      }
  }

}

# ---------------------------------------------------------- Start page output.

  $r->content_type('text/html');
  $r->send_http_header;

  $r->print('<html><head><title>LON-CAPA Publishing</title></head>');
  $r->print(&Apache::loncommon::bodytag('Resource Publication'));


  my $thisfn=$fn;

  my $thistarget=$thisfn;
      
  $thistarget=~s/^\/home/$targetdir/;
  $thistarget=~s/\/public\_html//;

  my $thisdistarget=$thistarget;
  $thisdistarget=~s/^\Q$docroot\E//;

  my $thisdisfn=$thisfn;
  $thisdisfn=~s/^\/home\/\Q$cuname\E\/public_html\///;

  if ($fn=~/\/$/) {
# -------------------------------------------------------- This is a directory
      &publishdirectory($r,$fn,$thisdisfn);

  } else {
# ---------------------- Evaluate individual file, and then output information.
      $thisfn=~/\.(\w+)$/;
      my $thistype=$1;
      my $thisembstyle=&Apache::loncommon::fileembstyle($thistype);

      $r->print('<h2>Publishing '.
        &Apache::loncommon::filedescription($thistype).' <tt>'.
        '<a href="/~'.$cuname.'/'.$thisdisfn.'" target="cat">'.$thisdisfn.
        '</a></tt></h2><b>Target:</b> <tt>'.$thisdistarget.'</tt><br />');
   
      if (($cuname ne $ENV{'user.name'}) || ($cudom ne $ENV{'user.domain'})) {
          $r->print('<h3><font color="red">Co-Author: '.$cuname.' at '.$cudom.
		    '</font></h3>');
      }

      if (&Apache::loncommon::fileembstyle($thistype) eq 'ssi') {
          $r->print('<br /><a href="/adm/diff?filename=/~'.$cuname.'/'.
                    $thisdisfn.
  	  '&versiontwo=priv" target="cat">Diffs with Current Version</a><br />');
      }
  
# ------------------ Publishing from $thisfn to $thistarget with $thisembstyle.

       unless ($ENV{'form.phase'} eq 'two') {
	   my ($outstring,$error)=&publish($thisfn,$thistarget,$thisembstyle);
	   $r->print('<hr />'.$outstring);
       } else {
           $r->print('<hr />');
           &phasetwo($r,$thisfn,$thistarget,$thisembstyle,$thisdistarget); 
       }
  }
  $r->print('</body></html>');

  return OK;
}

1;
__END__

=pod

=back

=back

=cut