Diff for /loncom/interface/lonprintout.pm between versions 1.20 and 1.628

version 1.20, 2002/04/01 18:23:12 version 1.628, 2012/12/21 18:51:49
Line 22 Line 22
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA  # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 #  #
 # /home/httpd/html/adm/gpl.txt  # /home/httpd/html/adm/gpl.txt
 #  
 # http://www.lon-capa.org/  # http://www.lon-capa.org/
 #  #
 # (Internal Server Error Handler  
 #  
 # (Login Screen  
 # 5/21/99,5/22,5/25,5/26,5/31,6/2,6/10,7/12,7/14,  
 # 1/14/00,5/29,5/30,6/1,6/29,7/1,11/9 Gerd Kortemeyer)  
 #  
 # 3/1/1 Gerd Kortemeyer)  
 #  
 # 3/1 Gerd Kortemeyer  
 #  
 # 9/17 Alex Sakharuk  
 #  #
 package Apache::lonprintout;  package Apache::lonprintout;
   
 use strict;  use strict;
   use POSIX;
 use Apache::Constants qw(:common :http);  use Apache::Constants qw(:common :http);
 use Apache::lonxml;  use Apache::lonxml;
 use Apache::lonnet;  use Apache::lonnet;
   use Apache::loncommon;
 use Apache::inputtags;  use Apache::inputtags;
   use Apache::grades;
 use Apache::edit;  use Apache::edit;
 use Apache::File();  use Apache::File();
   use Apache::lonnavmaps;
   use Apache::admannotations;
   use Apache::lonenc;
   use Apache::entities;
   use Apache::londefdef;
   # use Apache::structurelags; # for language management.
   
   use File::Basename;
   
   use HTTP::Response;
   use LONCAPA::map();
   use POSIX qw(ctime);
   use Apache::lonlocal;
   use Carp;
   use LONCAPA;
   
 sub headerform {  
     my $r = shift;  my %perm;
     $r->print(<<ENDHEADER);  my %parmhash;
 <html>  my $resources_printed;
 <head>  
 <title>LON-CAPA output for printing</title>  # Global variables that describe errors in ssi calls detected  by ssi_with_retries.
 </head>  #
 <body bgcolor="FFFFFF">  
 <form method="post" enctype="multipart/form-data" action="/adm/printout" name="printform">  my $ssi_error; # True if there was an ssi error.
 <h1>What do you want to print? Make a choice.</h1><br />  my $ssi_last_error_resource; # The resource URI that could not be fetched.
 ENDHEADER  my $ssi_last_error; # The error text from the server. (e.g. 500 Server timed out).
   
   #
   #  Our ssi max retry count.
   #
   
   my $ssi_retry_count = 5; # Some arbitrary value.
   
   
   #  Font size:
   
   my $font_size = 'normalsize'; # Default is normalsize...
   
   #----------------------------  Helper helpers. -------------------------
   
   ## 
   # Filter function to determine if a resource is a printable sequence.
   #
   # @param $res -Resource to check.
   #
   # @return 1 - printable and a resource
   #         0 - either notm a sequence or not printable.
   #
   sub printable_sequence {
       my $res = shift;
   
       # Non-sequences are not listed:
   
       if (!$res->is_sequence()) {
    return 0;
       }
   
       # Person with pav or pfo can always print:
   
       if ($perm{'pav'} || $perm{'pfo'}) {
    return 1;
       }
   
       if ($res->is_sequence()) {
    my $symb = $res->symb();
    my $navmap   = $res->{NAV_MAP};
   
    # Find the first resource in the map:
   
    my $iterator = $navmap->getIterator($res, undef, undef, 1, 1);
    my $first    = $iterator->next();
   
    while (1) {
       if ($first == $iterator->END_ITERATOR) { last; }
       if (ref($first) && ! $first->is_sequence()) {last; }
       $first = $iterator->next();
    }
   
   
    # Might be an empty map:
   
    if (!ref($first)) {
       return 0;
    }
    my $partsref = $first->parts();
    my @parts    = @$partsref;
    my ($open, $close) = $navmap->map_printdates($first, $parts[0]);
    return &printable($open, $close);
       }
       return 0;
 }  }
   
   # BZ5209:
   #    Create the states needed to run the helper for incomplete problems from
   #    the current folder for selected students.
   #    This includes:
   #    -  A resource selector limited to problems (incompleteness must be
   #       calculated on a student per student basis.
   #    -  A student selector.
   #    -  Tie in to the FORMAT of the print job.
   #
   # States:
   #   CHOOSE_INCOMPLETE_PEOPLE_SEQ      - Resource selection.
   #   CHOOSE_STUDENTS_INCOMPLETE        - Student selection.
   #   CHOOSE_STUDENTS_INCOMPLETE_FORMAT - Format selection
   # Parameters:
   #    helper - the helper which already contains info about the current folder we can
   #             purloin.
   #    url    - Top url of the sequence
   # Return:
   #     XML that can be parsed by the helper to drive the state machine.
   #
   sub create_incomplete_folder_selstud_helper($helper)
   {
       my ($helper, $map)  = @_;
   
   
 sub menu_for_output {      my $symbFilter = '$res->shown_symb()';
     my $r = shift;      my $selFilter   = '$res->is_problem()';
     $r->print(<<ENDMENUOUT);  
 <input type="hidden" name="phase" value="two">  
 <input type="hidden" name="url" value="$ENV{'form.postdata'}">      my $resource_chooser = &generate_resource_chooser('CHOOSE_INCOMPLETE_PEOPLE_SEQ',
 <input type="radio" name="choice" value="Standard LaTeX output for current document">  Current document        'Select problem(s) to print',
 (you will print what you see on the screen)<br />        'multichoice="1" toponly="1" addstatus="1" closeallpages="1"',
 <input type="radio" name="choice" value="Standard LaTeX output for the primary sequence">  All problems from the primary sequence<br />        'RESOURCES',
 <input type="radio" name="choice" value="Standard LaTeX output for whole primary sequence">  The whole primary sequence (problems plus all html and xml files)<br />        'CHOOSE_STUDENTS_INCOMPLETE',
 <input type="radio" name="choice" value="Standard LaTeX output for the top level sequence">  All problems from the top level sequence<br />        $map,
 <br /><hr /><br />        $selFilter,
 <h1>And what page format do you prefer?</h1>        '',
 <input type="radio" name="layout" value="CBI" checked>  CBI <br />        $symbFilter, 
 <input type="radio" name="layout" value="CAPA"> CAPA <br />        '');
 <input type="submit" value="Submit your choice">  
 </form>      my $student_chooser = &generate_student_chooser('CHOOSE_STUDENTS_INCOMPLETE',
 </body>   'student_sort',
 </html>   'STUDENTS',
 ENDMENUOUT   'CHOOSE_STUDENTS_INCOMPLETE_FORMAT');
   
       my $format_chooser = &generate_format_selector($helper,
    'Format of the print job',
    'CHOOSE_STUDENTS_INCOMPLETE_FORMAT'); # end state.
   
       return $resource_chooser . $student_chooser . $format_chooser;
   }  
   
   
   # BZ 5209
   #     Create the states needed to run the helper for incomplete problems from
   #     the current folder for selected students.
   #     This includes:
   #     - A resource selector limited to problems.  (incompleteness must be calculated
   #       on a student per student basis.
   #     - A student selector.
   #     - Tie in to format for the print job.
   # States:
   #    INCOMPLETE_PROBLEMS_COURSE_RESOURCES - Resource selector.
   #    INCOMPLETE_PROBLEMS_COURSE_STUDENTS  - Student selector.
   #    INCOMPLETE_PROBLEMS_COURSE_FORMAT    - Format selection.
   #
   # Parameters:
   #   helper   - Helper we are creating states for.
   # Returns:
   #   Text that can be parsed by the helper.
   # 
   
   sub create_incomplete_course_helper {
       my $helper = shift;
   
       my $filter = '$res->is_problem() || $res->contains_problem() || $res->is_sequence() || $res->is_practice())';
       my $symbfilter = '$res->shown_symb()';
       
       my $resource_chooser = &generate_resource_chooser('INCOMPLETE_PROBLEMS_COURSE_RESOURCES',
         'Select problem(s) to print',
         'multichoice = "1" suppressEmptySequences="0" addstatus="1" closeallpagtes="1"',
         'RESOURCES',
         'INCOMPLETE_PROBLEMS_COURSE_STUDENTS',
         '',
         $filter,
         '',
         $symbfilter,
         '');
   
       my $people_chooser  = &generate_student_chooser('INCOMPLETE_PROBLEMS_COURSE_STUDENTS',
       'student_sort',
       'STUDENTS',
       'INCOMPLETE_PROBLEMS_COURSE_FORMAT');
   
       my $format = &generate_format_selector($helper,
      'Format of the print job',
      'INCOMPLETE_PROBLEMS_COURSE_FORMAT'); # end state.
   
       return $resource_chooser . $people_chooser . $format;
   
   
   }
   
   # BZ5209 
   #   Creates the states needed to run the print helper for a student
   #   that wants to print his incomplete problems from the current folder.
   # Parameters:
   #   $helper - helper we are generating states for.
   #   $map    - The map for which the student wants incomplete problems.
   # Returns:
   #   XML that defines the helper states being created.
   #
   # States:
   #   CHOOSE_INCOMPLETE_SEQ  - Resource selector.
   #
   sub create_incomplete_folder_helper {
       my ($helper, $map) = @_;
   
       my $filter    = '$res->is_problem()';
       $filter      .= ' && $res->resprintable() ';
       $filter      .= ' && $res->is_incomplete() ';
   
       my $symfilter = '$res->shown_symb()';
   
       my $resource_chooser = &generate_resource_chooser('CHOOSE_INCOMPLETE_SEQ',
         'Select problem(s) to print',
         'multichoice="1", toponly ="1", addstatus="1", closeallpages="1"',
         'RESOURCES',
         'PAGESIZE',
         $map,
         $filter, '', 
         $symfilter,
         '');
   
       return $resource_chooser;
   }
   
   
   #  Returns the text neded for a student chooser.
   #  that text must still be parsed by the helper xml parser.
   # Parameters:
   #   this_state   - State name of the chooser.
   #   sort_choice  - variable to hold the sorting choice.
   #   variable     - Name of variable to hold students.
   #   next_state   - State after chooser.
   
   
   sub generate_student_chooser {
       my ($this_state, 
    $sort_choice, 
    $variable, 
    $next_state) = @_;
       my $result = <<CHOOSE_STUDENTS;
     <state name="$this_state" title="Select Students and Resources">
         <message><b>Select sorting order of printout</b> </message>
   
       <choices variable="$sort_choice">
         <choice computer='0'>Sort by section then student</choice>
         <choice computer='1'>Sort by students across sections.</choice>
       </choices>
   
         <message><br /><hr /><br /> </message>
         <student multichoice='1' 
                  variable="$variable" 
                  nextstate="$next_state" 
                  coursepersonnel="1" />
     </state>
   
   CHOOSE_STUDENTS
   
     return $result;
   }
   
   # Generate the text needed for a resource chooser given the top level of
   # the sequence/page
   #
   # Parameters:
   #     this_state    - State name of the chooser.
   #     prompt_text   - Text to use to prompt user.
   #     resource_options - Resource tag options e.g.
   #                        "multichoice='1', toponly='1', addstatus='1'"
   #                     that control the selection and appearance of the
   #                     resource selector.
   #     variable      - Name of the variable to hold the choice
   #     next_state    - Name of the next state the helper should transition
   #                     to
   #     top_url       - Top level URL within which to make the selector.
   #                     If empty the top level sequence is shown.
   #     filter        - How to filter the resources.
   #     value_func    - <valuefunc> function.
   #     choice_func   - If not empty generates a <choicefunc> with this function.
   #     start_new_option 
   #                   - Fragment appended after valuefunc.
   #
   #
   sub generate_resource_chooser {
       my ($this_state,
    $prompt_text,
    $resource_options,
    $variable,
    $next_state,
    $top_url,
    $filter,
    $choice_func,
    $value_func,
    $start_new_option)  = @_;
   
       my $result = <<CHOOSE_RESOURCES;
   <state name="$this_state" title="$prompt_text">
       <resource variable="$variable" $resource_options
                 closeallpages="1">
         <nextstate>$next_state</nextstate>
         <filterfunc>return $filter;</filterfunc>
   CHOOSE_RESOURCES
       if ($choice_func ne '') {
    $result .= "<choicefunc>return $choice_func;</choicefunc>";
       }
       if ($top_url ne '') {
    $result .=  "<mapurl>$top_url</mapurl>";
       }
       $result .= <<CHOOSE_RESOURCES;
         <valuefunc>return $value_func;</valuefunc>
         $start_new_option
         </resource>
       </state>
   CHOOSE_RESOURCES
       return $result;
   }
   #
   #   Generate the helper XML for a code choice helper dialog:
   #
   # Paramters:
   #   $helper       - Reference to the helper.
   #   $state        - Name of the state for the chooser.
   #   $next_state   - Name fo the state to follow the chooser.
   #   $bubble_types - Populates the bubble sheet type dropt down.
   #   $code_selections - Provides set of code choices that have been used
   #   $saved_codes  - Provides the list of saved codes.
   #
   # Returns;
   #   The Xml of the code chooser.
   #
   sub generate_code_selector {
       my ($helper,
    $state,
    $next_state,
    $bubble_types,
    $code_selections,
    $saved_codes) = @_; # Unpack the parameters.
   
       my $result = <<CHOOSE_ANON1;
     <state name="$state" title="Specify CODEd Assignments">
       <nextstate>$next_state</nextstate>
       <message><h4>Fill out one of the forms below</h4></message>
       <message><br /><hr /> <br /></message>
       <message><h3>Generate new CODEd Assignments</h3></message>
       <message><table><tr><td><b>Number of CODEd assignments to print:</b></td><td></message>
       <string variable="NUMBER_TO_PRINT_TOTAL" maxlength="5" size="5"  noproceed="1">
          <validator>
    if (((\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}+0) < 1) &&
       !\$helper->{'VARS'}{'REUSE_OLD_CODES'}                &&
               !\$helper->{'VARS'}{'SINGLE_CODE'}                    &&
       !\$helper->{'VARS'}{'CODE_SELECTED_FROM_LIST'} ) {
   
       return "You need to specify the number of assignments to print";
    }
           if (((\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}+0) >= 1)  &&
                (\$helper->{'VARS'}{'SINGLE_CODE'} ne '') ) {
               return 'Specifying number of codes to print and a specific code is not compatible';
           }
    return undef;
          </validator>
       </string>
       <message></td></tr><tr><td></message>
       <message><b>Names to save the CODEs under for later:</b></message>
       <message></td><td></message>
       <string variable="ANON_CODE_STORAGE_NAME" maxlength="50" size="20" />
       <message></td></tr><tr><td></message>
       <message><b>Bubblesheet type:</b></message>
       <message></td><td></message>
       <dropdown variable="CODE_OPTION" multichoice="0" allowempty="0">
       $bubble_types
       </dropdown>
       <message></td></tr><tr><td colspan="2"></td></tr><tr><td></message>
       <message></td></tr><tr><td></table></message>
       <message><br /><hr /><h3>Print a Specific CODE </h3><br /><table></message>
       <message><tr><td><b>Enter a CODE to print:</b></td><td></message>
       <string variable="SINGLE_CODE" size="10">
           <validator>
      if(!\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}           &&
         !\$helper->{'VARS'}{'REUSE_OLD_CODES'}                 &&
         !\$helper->{'VARS'}{'CODE_SELECTED_FROM_LIST'}) {
         return &Apache::lonprintout::is_code_valid(\$helper->{'VARS'}{'SINGLE_CODE'},
         \$helper->{'VARS'}{'CODE_OPTION'});
     } elsif (\$helper->{'VARS'}{'SINGLE_CODE'} ne ''){
         return 'Specifying a code name is incompatible with specifying number of codes.';
      } else {
          return undef; # Other forces control us.
      }
           </validator>
       </string>
       <message></td></tr><tr><td></message>
           $code_selections
       <message></td></tr></table></message>
       <message><hr /><h3>Reprint a Set of Saved CODEs</h3><table><tr><td></message>
       <message><b>Select saved CODEs:</b></message>
       <message></td><td></message>
       <dropdown variable="REUSE_OLD_CODES">
           $saved_codes
       </dropdown>
       <message></td></tr></table></message>
     </state>
   CHOOSE_ANON1
   
      return $result;
   }
   
   #  Returns the XML for choosing how assignments are to be formatted 
   #  that text must still be parsed by the helper xml parser.
   # Parameters: 3 (required)
   
   #   helper       - The helper; $helper->{'VARS'}->{'PRINT_TYPE'} used
   #                  to check if splitting PDFs by section can be offered.
   #   title        - Title for the current state. 
   #   this_state   - State name of the chooser.
   
   sub generate_format_selector {
       my ($helper,$title,$this_state) = @_;
       my $secpdfoption;
       unless (($helper->{'VARS'}->{'PRINT_TYPE'} eq 'problems_for_anon')     ||
               ($helper->{'VARS'}->{'PRINT_TYPE'} eq 'problems_for_anon_page') ||
               ($helper->{'VARS'}->{'PRINT_TYPE'} eq 'resources_for_anon')  ) {
           $secpdfoption =  '<choice computer="sections">Each PDF contains exactly one section</choice>';
       }
       return <<RESOURCE_SELECTOR;
       <state name="$this_state" title="$title">
       <message><br /><big><i><b>How should the results be printed?</b></i></big><br /></message>
       <choices variable="EMPTY_PAGES">
         <choice computer='0'>Start each student\'s assignment on a new page/column (add a pagefeed after each assignment)</choice>
         <choice computer='1'>Add one empty page/column after each student\'s assignment</choice>
         <choice computer='2'>Add two empty pages/column after each student\'s assignment</choice>
         <choice computer='3'>Add three empty pages/column after each student\'s assignment</choice>
       </choices>
       <nextstate>PAGESIZE</nextstate>
       <message><hr width='33%' /><b>How do you want assignments split into PDF files? </b></message>
       <choices variable="SPLIT_PDFS">
          <choice computer="all">All assignments in a single PDF file</choice>
          $secpdfoption
          <choice computer="oneper">Each PDF contains exactly one assignment</choice>
          <choice computer="usenumber" relatedvalue="NUMBER_TO_PRINT">
               Specify the number of assignments per PDF:</choice>
       </choices>
       </state>
   RESOURCE_SELECTOR
   }
   
   #-----------------------------------------------------------------------
   
   # Computes an open and close date from a list of open/close dates for a resource's
   # parts.
   #
   # @param \@opens - reference to an array of open dates.
   # @param \@closes - reference to an array of close dates.
   #
   # @return ($open, $close) 
   #
   # @note If open/close dates are not defined they will be retunred as undef
   # @note It is possible for there to be no overlap in which case -1,-1 
   #       will be returned.
   # @note The algorithm used is to take the latest open date and the earliest end date.
   #
   sub compute_open_window {
       my ($opensref, $closesref) = @_;
   
       my @opens   = @$opensref;
       my @closes  = @$closesref;
   
       # latest open date:
       my $latest_open;
   
       foreach my $open (@opens) {
    if (!defined($latest_open) || ($open > $latest_open)) {
       $latest_open = $open;
    }
       }
       # Earliest close:
   
       my $earliest_close;
       foreach my $close (@closes) {
    if (!defined($earliest_close) || ($close < $earliest_close)) {
       $earliest_close = $close;
    }
       }
   
       # If no overlap...both are -1 as promised.
   
       if (defined($earliest_close) && defined($latest_open)
    && ($earliest_close < $latest_open)) {
    $latest_open  = -1;
    $earliest_close = -1;
       }
       
       return ($latest_open, $earliest_close);
     
   }
   
   ##
   #  Determines if 'now' is within the set of printable dates.
   #
   #  @param $open_date - Starting date/timestamp.
   #  @param $close_date - Ending date/timestamp.
   #
   #  @return 0 - Not open.
   #  @return 1 - open.
   #
   sub printable {
       my ($open_date, $close_date) = @_;
   
   
       my $now = time();
   
       # Have to do a bit of fancy footwork around undefined open/close dates:
   
       if ($open_date && ($open_date > $now)) {
    return 0;
       }
   
       if ($close_date && ($close_date < $now)) {
    return 0;
       }
       
       return 1;
   
   }
   
   ##
   # Returns the innermost print start/print end dates for a resource.
   # This is done by looking at the start/end dates for its parts and choosing
   # the intersection of those dates.
   # 
   # @param res - lonnvamaps::resource object that represents the resource.
   #
   # @return (opendate, closedate)
   #
   # @note If open/close dates are not defined they will be retunred as undef
   # @note It is possible for there to be no overlap in which case -1,-1 
   #       will be returned.
   # @note The algorithm used is to take the latest open date and the earliest end date.
   #
   
   sub get_print_dates {
       my $res = shift;
       my $partsref = $res->parts();
       my @parts;
       if (ref($partsref) eq 'ARRAY') {
           @parts   = @{$partsref};
       }
       my $open_date;
       my $close_date;
       my @open_dates;
       my @close_dates;
   
   
       if (@parts) {
    foreach my $part (@parts) {
       my $partopen  = $res->parmval('printstartdate', $part);
       my $partclose = $res->parmval('printenddate',  $part);
   
       push(@open_dates, $partopen);
       push(@close_dates, $partclose);
    }
       }
   
       ($open_date, $close_date)  = &compute_open_window(\@open_dates, \@close_dates);
   
       if ($open_date) {
    $open_date  = POSIX::strftime('%D', localtime($open_date));
       }
       if ($close_date) {
    $close_date = POSIX::strftime('%D', localtime($close_date));
       }
   
       return ($open_date, $close_date);
   }
   
   ##
   # Get the dates for which a course says a resource can be printed.  This is like
   # get_print_dates but namvaps::course_print_dates are gotten...and not converted
   # to times either.
   #
   # @param $res - Reference to a resource has from lonnvampas::resource.
   #
   # @return (opendate, closedate)
   #
   sub course_print_dates {
       my $res = shift;
       my $partsref = $res->parts();
       my @parts    = @$partsref;
       my $open_date;
       my $close_date;
       my @open_dates;
       my @close_dates;
       my $navmap = $res->{NAV_MAP}; # Slightly OO dirty.
   
       # Don't bother looping over undefined or empty parts arraY;
   
       if (@parts) {
    foreach my $part (@parts) {
       my ($partopen, $partclose) = $navmap->course_printdates($res, $part);
       push(@open_dates, $partopen);
       push(@close_dates, $partclose);
    }
    ($open_date, $close_date) = &compute_open_window(\@open_dates, \@close_dates);
       }
       return ($open_date, $close_date);
   }
   ##
   # Same as above but for the enclosing map:
   #
   sub map_print_dates {
       my $res = shift;
       my $partsref = $res->parts();
       my @parts    = @$partsref;
       my $open_date;
       my $close_date;
       my @open_dates;
       my @close_dates;
       my $navmap = $res->{NAV_MAP}; # slightly OO dirty.
   
   
       # Don't bother looping over undefined or empty parts arraY;
   
       if (@parts) {
    foreach my $part (@parts) {
       my ($partopen, $partclose) = $navmap->map_printdates($res, $part);
       push(@open_dates, $partopen);
       push(@close_dates, $partclose);
    }
    ($open_date, $close_date) = &compute_open_window(\@open_dates, \@close_dates);
       }
       return ($open_date, $close_date);
   }
   
   # Determine if a resource is incomplete given the map:
   # Parameters:
   #   $username - Name of user for whom we are checking.
   #   $domain   - Domain of user we are checking.
   #   $map - map name.
   # Returns:
   #     0 - map is not incomplete.
   #     1 - map is incomplete.
   #
   sub incomplete {
       my ($username, $domain, $map) = @_;
   
   
       my $navmap = Apache::lonnavmaps::navmap->new($username, $domain);
       
   
       if (defined($navmap)) {
    my $res = $navmap->getResourceByUrl($map);
    my $result = $res->is_incomplete();
    return $result;
       } else {
    return 1;
       }
   }
   #
   #  When printing for students, the resoures and order of the
   #  resources may need to be altered if there are folders with
   #  random selectiopn or random ordering (or both) enabled.
   #  This sub computes the set of resources to print for a student
   #  modified both by random ordering and selection and filtered
   #  to only those that are in the original set selcted to be printed.
   #
   # Parameters:
   #   $map - The URL of the folder being printed.
   #          Used to determine which startResource and finishResource
   #          to use when using the navmap's getIterator method.
   #   $seq   - The original set of resources to print.
   #            (really an array of resource names (array of symb's).
   #   $who   - Student/domain for whome the sequence will be generated.
   #   $code  - CODE being printed when printing Problems/Resources
   #            from folder for CODEd assignments
   #
   # Implicit inputs:
   #   $
   # Returns:
   #   reference to an array of resources that can be passed to
   #   print_resources.
   # 
   sub master_seq_to_person_seq {
       my ($map, $seq, $who, $code) = @_;
   
   
       my ($username, $userdomain, $usersection) = split(/:/, $who);
   
       # Toss the sequence up into a hash so that we have O(1) lookup time.
       # on the items that come out of the user's list of resources.
       #
   
       my %seq_hash = map {$_  => 1} @$seq;
       my @output_seq;
       
       my $navmap           = Apache::lonnavmaps::navmap->new($username, $userdomain,
                                                              $code);
       my ($start,$finish);
   
       if ($map) {
           my $mapres = $navmap->getResourceByUrl($map);
           if ($mapres->is_map()) {
               $start = $mapres->map_start();
               $finish = $mapres->map_finish();
           }
       }
       unless ($start && $finish) {
           $start = $navmap->firstResource();
           $finish = $navmap->finishResource();
       }
   
       my $iterator         = $navmap->getIterator($start,$finish,{},1);
   
       #  Iterate on the resource..select the items that are randomly selected
       #  and that are in the seq_has.  Presumably the iterator will take care
       # of the random ordering part of the deal.
       #
       my $curres;
       while ($curres = $iterator->next()) {
    #
    #  Only process resources..that are not removed by randomout...
    #  and are selected for printint as well.
    #
   
           if (ref($curres) && ! $curres->randomout()) {
               my $currsymb = $curres->symb();
               if (exists($seq_hash{$currsymb})) {
                   push(@output_seq, $currsymb);
       }
    }
       }
   
       return \@output_seq; # for now.
       
   }
   
   
   # Fetch the contents of a resource, uninterpreted.
   # This is used here to fetch a latex file to be included
   # verbatim into the printout<
   # NOTE: Ask Guy if there is a lonnet function similar to this?
   #
   # Parameters:
   #   URL of the file
   #
   sub fetch_raw_resource {
       my ($url) = @_;
   
       my $filename  = &Apache::lonnet::filelocation("", $url);
       my $contents  = &Apache::lonnet::getfile($filename);
   
       if ($contents == -1) {
    return "File open failed for $filename";      # This will bomb the print.
       }
       return $contents;
   
       
   }
   
   #  Fetch the annotations associated with a URL and 
   #  put a centered 'annotations:' title.
   #  This is all suppressed if the annotations are empty.
   #
   sub annotate {
       my ($symb) = @_;
   
       my $annotation_text = &Apache::loncommon::get_annotation($symb, 1);
   
   
       my $result = "";
   
       if (length($annotation_text) > 0) {
    $result .= '\\hspace*{\\fill} \\\\[\\baselineskip] \textbf{Annotations:} \\\\ ';
    $result .= "\n";
    $result .= &Apache::lonxml::latex_special_symbols($annotation_text,""); # Escape latex.
    $result .= "\n\n";
       }
       return $result;
   }
   
   #
   #   Set a global document font size:
   #   This is done by replacing \begin{document}
   #   with \begin{document}{\some-font-directive
   #   and \end{document} with
   #   }\end{document
   #
   sub set_font_size {
   
       my ($text) = @_;
   
       # There appear to be cases where the font directive is empty.. in which
       # case the first substituion would  insert a spurious \ oh happy day.
       # as this has been the cause of much mystery and hair pulling _sigh_
   
       if ($font_size ne '') {
   
    $text =~ s/\\begin{document}/\\begin{document}{\\$font_size/;
       }
       $text =~ s/\\end{document}/}\\end{document}/;
       return $text;
   
   
   }
   
   # include_pdf - PDF files are included into the 
   # output as follows:
   #  - The PDF, if necessary, is replicated.
   #  - The PDF is added to the list of files to convert to postscript (along with the images).
   #  - The LaTeX is added to include the final converted postscript in the file as an included
   #    job.  The assumption is that the includedpsheader.ps header will be included.
   #
   # Parameters:
   #   pdf_uri   - URI of the PDF file to include.
   #   
   # Returns:
   #  The LaTeX to include.
   #
   # Assumptions:
   #    The uri is actually a PDF file
   #    The postscript will have the includepsheader.ps included.
   #
   #
   sub include_pdf {
       my ($pdf_uri) = @_;
   
       # Where is the file? If not local we'll need to repcopy it:'
   
       my $file = &Apache::lonnet::filelocation('', $pdf_uri);
       if (! -e $file) {
    &Apache::lonnet::repcopy($file);
    $file = &Apache::lonnet::filelocation('',$pdf_uri);
       }
   
       #  The file isn ow replicated locally.. or it did not exist in the first place
       # (unlikely).  If it did exist, add the pdf to the set of files/images that
       # need tob e converted for this print job:
   
       my $londocroot = $Apache::lonnet::perlvar{'lonDocRoot'};
       $file =~ s{(.*)/res/}{$londocroot/res/};
   
       open(FILE,">>$Apache::lonnet::perlvar{'lonPrtDir'}/$env{'user.name'}_$env{'user.domain'}_printout.dat");
       print FILE ("$file\n");
       close (FILE);
   
       # Construct the special to put out.  To do this we need to get the
       # resulting filename after conversion.  The file will have the same name
       # but will be in the user's spool directory with converted images.
   
       my $dirname = "/home/httpd/prtspool/$env{'user.name'}/";
       my ( $base, $path,  $ext) = &fileparse($file, '.pdf');
   #    my $destname = $dirname.'/'.$base.'.eps'; # Not really an eps but easier in printout.pl
       $base =~ s/ /\_/g;
   
   
       my $output = &print_latex_header();
       $output    .= '\special{ps: _begin_job_ ('
    .$base.'.pdf.eps'.
    ')run _end_job_}';
   
       return $output;
   
   
   }
   ##
   #  Collect the various \select_language{language_name}
   #  latex tags to build a \usepackage[lang-list]{babel} which will
   #  appear just prior to the \begin{document} at the front of the concatenated
   #  set of resources:
   # @param doc - The string of latex to search/replace.
   # @return string
   # @retval - the modified document stringt.
   #
   sub collect_languages {
       my $doc = shift;
       my %languages;
       while ($doc =~ /\\selectlanguage{(\w+)}/mg) {
    $languages{$1} = 1; # allows us to request each language exactly once.
       }
       my @lang_list = (keys(%languages)); # List of unique languages
       if (scalar @lang_list) {
    my $babel_header = '\usepackage[' . join(',', @lang_list) .']{babel}'. "\n";
    $doc =~ s/\\begin{document}/$babel_header\\begin{document}/;
       }
       return $doc;
   }
   #-------------------------------------------------------------------
   
   #
   #   ssi_with_retries- Does the server side include of a resource.
   #                      if the ssi call returns an error we'll retry it up to
   #                      the number of times requested by the caller.
   #                      If we still have a proble, no text is appended to the
   #                      output and we set some global variables.
   #                      to indicate to the caller an SSI error occurred.  
   #                      All of this is supposed to deal with the issues described
   #                      in LonCAPA BZ 5631 see:
   #                      http://bugs.lon-capa.org/show_bug.cgi?id=5631
   #                      by informing the user that this happened.
   #
   # Parameters:
   #   resource   - The resource to include.  This is passed directly, without
   #                interpretation to lonnet::ssi.
   #   form       - The form hash parameters that guide the interpretation of the resource
   #                
   #   retries    - Number of retries allowed before giving up completely.
   # Returns:
   #   On success, returns the rendered resource identified by the resource parameter.
   # Side Effects:
   #   The following global variables can be set:
   #    ssi_error                - If an unrecoverable error occurred this becomes true.
   #                               It is up to the caller to initialize this to false
   #                               if desired.
   #    ssi_last_error_resource  - If an unrecoverable error occurred, this is the value
   #                               of the resource that could not be rendered by the ssi
   #                               call.
   #    ssi_last_error           - The error string fetched from the ssi response
   #                               in the event of an error.
   #
   sub ssi_with_retries {
       my ($resource, $retries, %form) = @_;
   
       my $target = $form{'grade_target'};
       my $aom    = $form{'answer_output_mode'};
   
   
   
       my ($content, $response) = &Apache::loncommon::ssi_with_retries($resource, $retries, %form);
       if (!$response->is_success) {
    $ssi_error               = 1;
    $ssi_last_error_resource = $resource;
    $ssi_last_error          = $response->code . " " . $response->message;
           $content='\section*{!!! An error occurred !!!}';
       }
   
       return $content;
   
   }
   
   sub get_student_view_with_retries {
       my ($curresline,$retries,$username,$userdomain,$courseid,$target,$moreenv)=@_;
   
       my ($content, $response) = &Apache::loncommon::get_student_view_with_retries($curresline,$retries,$username,$userdomain,$courseid,$target,$moreenv);
       if (!$response->is_success) {
           $ssi_error               = 1;
           $ssi_last_error_resource = $curresline.' for user '.$username.':'.$userdomain;
           $ssi_last_error          = $response->code . " " . $response->message;
           $content='\section*{!!! An error occurred !!!}';
       }
       return $content;
   
   }
   
   #
   #   printf_style_subst  item format_string repl
   #  
   # Does printf style substitution for a format string that
   # can have %[n]item in it.. wherever, %[n]item occurs,
   # rep is substituted in format_string.  Note that
   # [n] is an optional integer length.  If provided,
   # repl is truncated to at most [n] characters prior to 
   # substitution.
   #
   sub printf_style_subst {
       my ($item, $format_string, $repl) = @_;
       my $result = "";
       while ($format_string =~ /(%)(\d*)\Q$item\E/g ) {
    my $fmt = $1;
    my $size = $2;
    my $subst = $repl;
    if ($size ne "") {
       $subst = substr($subst, 0, $size);
       
       #  Here's a nice edge case.. supose the end of the
       #  substring is a \.  In that case may have  just
       #  chopped off a TeX escape... in that case, we append
       #   " " for the trailing character, and let the field 
       #  spill over a bit (sigh).
       #  We don't just chop off the last character in order to deal
       #  with one last pathology, and that would be if substr had
       #  trimmed us to e.g. \\\  
   
   
       if ($subst =~ /\\$/) {
    $subst .= " ";
       }
    }
    my $item_pos = pos($format_string);
    $result .= substr($format_string, 0, $item_pos - length($size) -2) . $subst;
           $format_string = substr($format_string, pos($format_string));
       }
   
       # Put the residual format string into the result:
   
       $result .= $format_string;
   
       return $result;
   }
   
   
   # Format a header according to a format.  
   # 
   
   # Substitutions:
   #     %a    - Assignment name.
   #     %c    - Course name.
   #     %n    - Student name.
   #     %s    - The section if it is supplied.
   #
   sub format_page_header {
       my ($width, $format, $assignment, $course, $student, $section) = @_;
   
   
   
       $width = &recalcto_mm($width); # Get width in mm.
       my $chars_per_line = int($width/1.6);   # Character/textline.
   
       #  Default format?
   
       if ($format eq '') {
    # For the default format, we may need to truncate
    # elements..  To do this we need to get the page width.
    # we assume that each character is about 2mm in width.
    # (correct for the header text size??).  We ignore
    # any formatting (e.g. boldfacing in this).
    # 
    # - Allow the student/course to be one line.
    #   but only truncate the course.
    # - Allow the assignment to be 2 lines (wrapped).
    #
   
   
   
    my $name_length    = int($chars_per_line *3 /4);
    my $sec_length     = int($chars_per_line / 5);
   
    $format  = "%$name_length".'n';
   
    if ($section) {
       $format .=  ' - Sec: '."%$sec_length".'s';
    }
   
    $format .= '\\\\%c \\\\ %a';
           
   
       }
       # An open question is how to handle long user formatted page headers...
       # A possible future is to support e.g. %na so that the user can control
       # the truncation of the elements that can appear in the header.
       #
       $format =  &printf_style_subst("a", $format, $assignment);
       $format =  &printf_style_subst("c", $format, $course);
       $format =  &printf_style_subst("n", $format, $student);
       $format =  &printf_style_subst("s", $format, $section);
       
       
       # If the user put %'s in the format string, they  must be escaped
       # to \% else LaTeX will think they are comments and terminate
       # the line.. which is bad!!!
       
       # If the user has role author, $course and $assignment are empty so
       # there is '\\ \\ ' in the page header. That's cause a error in LaTeX
       if($format =~ /\\\\\s\\\\\s/) {
           #TODO find sensible caption for page header
           my $testPrintout = '\\\\'.&mt('Construction Space').' \\\\'.&mt('Test-Printout ');
           $format =~ s/\\\\\s\\\\\s/$testPrintout/;
       }
       #
       #  We're going to trust LaTeX to break lines appropriately, but
       #  we'll truncate anything that's more than 3 lines worth of
       # text.  This is also assuming (which will probably end badly)
       # nobody's going to embed LaTeX control sequences in the title
       # header or rather that those control sequences won't get broken
       # by the stuff below.
       #
       my $total_length = 3*$chars_per_line;
       if (length($format) > $total_length) {
    $format = substr($format, 0, $total_length);
       }
   
   
       return $format;
       
   }
   
   #
   #   Convert a numeric code to letters
   #
   sub num_to_letters {
       my ($num) = @_;
       my @nums= split('',$num);
       my @num_to_let=('A'..'Z');
       my $word;
       foreach my $digit (@nums) { $word.=$num_to_let[$digit]; }
       return $word;
   }
   #   Convert a letter code to numeric.
   #
   sub letters_to_num {
       my ($letters) = @_;
       my @letters = split('', uc($letters));
      my %substitution;
       my $digit = 0;
       foreach my $letter ('A'..'J') {
    $substitution{$letter} = $digit;
    $digit++;
       }
       #  The substitution is done as below to preserve leading
       #  zeroes which are needed to keep the code size exact
       #
       my $result ="";
       foreach my $letter (@letters) {
    $result.=$substitution{$letter};
       }
       return $result;
   }
   
   #  Determine if a code is a valid numeric code.  Valid
   #  numeric codes must be comprised entirely of digits and
   #  have a correct number of digits.
   #
   #  Parameters:
   #     value      - proposed code value.
   #     num_digits - Number of digits required.
   #
   sub is_valid_numeric_code {
       my ($value, $num_digits) = @_;
       #   Remove leading/trailing whitespace;
       $value =~ s/^\s*//g;
       $value =~ s/\s*$//g;
       
       #  All digits?
       if ($value !~ /^[0-9]+$/) {
    return "Numeric code $value has invalid characters - must only be digits";
       }
       if (length($value) != $num_digits) {
    return "Numeric code $value incorrect number of digits (correct = $num_digits)";
       }
       return undef;
   }
   #   Determines if a code is a valid alhpa code.  Alpha codes
   #   are ciphers that map  [A-J,a-j] -> 0..9 0..9.
   #   They also have a correct digit count.
   # Parameters:
   #     value          - Proposed code value.
   #     num_letters    - correct number of letters.
   # Note:
   #    leading and trailing whitespace are ignored.
   #
   sub is_valid_alpha_code {
       my ($value, $num_letters) = @_;
       
        # strip leading and trailing spaces.
   
       $value =~ s/^\s*//g;
       $value =~ s/\s*$//g;
   
       #  All alphas in the right range?
       if ($value !~ /^[A-J,a-j]+$/) {
    return "Invalid letter code $value must only contain A-J";
       }
       if (length($value) != $num_letters) {
    return "Letter code $value has incorrect number of letters (correct = $num_letters)";
       }
       return undef;
   }
   
   #   Determine if a code entered by the user in a helper is valid.
   #   valid depends on the code type and the type of code selected.
   #   The type of code selected can either be numeric or 
   #   Alphabetic.  If alphabetic, the code, in fact is a simple
   #   substitution cipher for the actual numeric code: 0->A, 1->B ...
   #   We'll be nice and be case insensitive for alpha codes.
   # Parameters:
   #    code_value    - the value of the code the user typed in.
   #    code_option   - The code type selected from the set in the scantron format
   #                    table.
   # Returns:
   #    undef         - The code is valid.
   #    other         - An error message indicating what's wrong.
   #
   sub is_code_valid {
       my ($code_value, $code_option) = @_;
       my ($code_type, $code_length) = ('letter', 6); # defaults.
       my @lines = &Apache::grades::get_scantronformat_file();
       foreach my $line (@lines) {
    my ($name, $type, $length) = (split(/:/, $line))[0,2,4];
    if($name eq $code_option) {
       $code_length = $length;
       if($type eq 'number') {
    $code_type = 'number';
       }
    }
       }
       my $valid;
       if ($code_type eq 'number') {
    return &is_valid_numeric_code($code_value, $code_length);
       } else {
    return &is_valid_alpha_code($code_value, $code_length);
       }
   
   }
   #
   # Compare two students by section (Used to sort by section).
   #
   #  Implicit inputs, 
   #    $a - The first one
   #    $b - The second one.
   #
   #  Returns:
   #     a-section cmp b-section
   #
   sub compare_sections {
       my ($u1, $d1, $s1, $n1, $stat1) = split(/:/, $a);
       my ($u2, $d2, $s2, $n2, $stat2) = split(/:/, $b);
   
       return $s1 cmp $s2;
   }
   
   #   Compare two students by name.  The students are in the form
   #   returned by the helper:
   #      user:domain:section:last,   first:status
   #   This is a helper function for the perl sort built-in  therefore:
   # Implicit Inputs:
   #    $a     - The first element to compare (global)
   #    $b     - The second element to compare (global)
   # Returns:
   #   -1   - $a < $b
   #    0   - $a == $b
   #   +1   - $a > $b
   #   Note that the initial comparison is done on the last names with the
   #   first names only used to break the tie.
   #
   #
   sub compare_names {
       #  First split the names up into the primary fields.
   
       my ($u1, $d1, $s1, $n1, $stat1) = split(/:/, $a);
       my ($u2, $d2, $s2, $n2, $stat2) = split(/:/, $b);
   
       # Now split the last name and first name of each n:
       #
   
       my ($l1,$f1) = split(/,/, $n1);
       my ($l2,$f2) = split(/,/, $n2);
   
       # We don't bother to remove the leading/trailing whitespace from the
       # firstname, unless the last names compare identical.
   
       if($l1 lt $l2) {
    return -1;
       }
       if($l1 gt $l2) {
    return  1;
       }
   
       # Break the tie on the first name, but there are leading (possibly trailing
       # whitespaces to get rid of first 
       #
       $f1 =~ s/^\s+//; # Remove leading...
       $f1 =~ s/\s+$//; # Trailing spaces from first 1...
       
       $f2 =~ s/^\s+//;
       $f2 =~ s/\s+$//; # And the same for first 2...
   
       if($f1 lt $f2) {
    return -1;
       }
       if($f1 gt $f2) {
    return 1;
       }
       
       #  Must be the same name.
   
       return 0;
   }
   
   sub latex_header_footer_remove {
       my $text = shift;
       $text =~ s/\\end{document}//;
       $text =~ s/\\documentclass([^&]*)\\begin{document}//;
       return $text;
   }
   #
   #  If necessary, encapsulate text inside 
   #  a minipage env.
   #  necessity is determined by the problem_split param.
   #
   sub encapsulate_minipage {
       my ($text) = @_;
       if (!($env{'form.problem.split'} =~ /yes/i)) {
    $text = '\begin{minipage}{\textwidth}'.$text.'\end{minipage}';
       }
       return $text;
   }
   #
   #  The NUMBER_TO_PRINT and SPLIT_PDFS
   #  variables interact, this sub looks at these two parameters
   #  and comes up with a final value for NUMBER_TO_PRINT which can be:
   #     all     - if SPLIT_PDFS eq 'all'.
   #     1       - if SPLIT_PDFS eq 'oneper'
   #     section - if SPLIT_PDFS eq 'sections'
   #     <unchanged> - if SPLIT_PDFS eq 'usenumber'
   #
   sub adjust_number_to_print {
       my $helper = shift;
   
       my $split_pdf = $helper->{'VARS'}->{'SPLIT_PDFS'};
       
       if ($split_pdf eq 'all') {
    $helper->{'VARS'}->{'NUMBER_TO_PRINT'} = 'all';
       } elsif ($split_pdf eq 'oneper') {
    $helper->{'VARS'}->{'NUMBER_TO_PRINT'} = 1;
       } elsif ($split_pdf eq 'sections') {
    $helper->{'VARS'}->{'NUMBER_TO_PRINT'} = 'section';
       } elsif ($split_pdf eq 'usenumber') {
    #  Unmodified.
       } else {
    # Error!!!!
   
    croak "bad SPLIT_PDFS: $split_pdf in lonprintout::adjust_number_to_print";
   
       }
   }
   
   
   sub character_chart {
       my $result = shift;
       return  &Apache::entities::replace_entities($result);
   }
   
   sub old_character_chart {
       my $result = shift;
       $result =~ s/&\#0?0?(7|9);//g;
       $result =~ s/&\#0?(10|13);//g;
       $result =~ s/&\#0?32;/ /g;
       $result =~ s/&\#0?33;/!/g;
       $result =~ s/&(\#0?34|quot);/\"/g;
       $result =~ s/&\#0?35;/\\\#/g;
       $result =~ s/&\#0?36;/\\\$/g;
       $result =~ s/&\#0?37;/\\%/g; 
       $result =~ s/&(\#0?38|amp);/\\&/g; 
       $result =~ s/&\#(0?39|146);/\'/g;
       $result =~ s/&\#0?40;/(/g;
       $result =~ s/&\#0?41;/)/g;
       $result =~ s/&\#0?42;/\*/g;
       $result =~ s/&\#0?43;/\+/g;
       $result =~ s/&\#(0?44|130);/,/g;
       $result =~ s/&\#0?45;/-/g;
       $result =~ s/&\#0?46;/\./g;
       $result =~ s/&\#0?47;/\//g;
       $result =~ s/&\#0?48;/0/g;
       $result =~ s/&\#0?49;/1/g;
       $result =~ s/&\#0?50;/2/g;
       $result =~ s/&\#0?51;/3/g;
       $result =~ s/&\#0?52;/4/g;
       $result =~ s/&\#0?53;/5/g;
       $result =~ s/&\#0?54;/6/g;
       $result =~ s/&\#0?55;/7/g;
       $result =~ s/&\#0?56;/8/g;
       $result =~ s/&\#0?57;/9/g;
       $result =~ s/&\#0?58;/:/g;
       $result =~ s/&\#0?59;/;/g;
       $result =~ s/&(\#0?60|lt|\#139);/\$<\$/g;
       $result =~ s/&\#0?61;/\\ensuremath\{=\}/g;
       $result =~ s/&(\#0?62|gt|\#155);/\\ensuremath\{>\}/g;
       $result =~ s/&\#0?63;/\?/g;
       $result =~ s/&\#0?65;/A/g;
       $result =~ s/&\#0?66;/B/g;
       $result =~ s/&\#0?67;/C/g;
       $result =~ s/&\#0?68;/D/g;
       $result =~ s/&\#0?69;/E/g;
       $result =~ s/&\#0?70;/F/g;
       $result =~ s/&\#0?71;/G/g;
       $result =~ s/&\#0?72;/H/g;
       $result =~ s/&\#0?73;/I/g;
       $result =~ s/&\#0?74;/J/g;
       $result =~ s/&\#0?75;/K/g;
       $result =~ s/&\#0?76;/L/g;
       $result =~ s/&\#0?77;/M/g;
       $result =~ s/&\#0?78;/N/g;
       $result =~ s/&\#0?79;/O/g;
       $result =~ s/&\#0?80;/P/g;
       $result =~ s/&\#0?81;/Q/g;
       $result =~ s/&\#0?82;/R/g;
       $result =~ s/&\#0?83;/S/g;
       $result =~ s/&\#0?84;/T/g;
       $result =~ s/&\#0?85;/U/g;
       $result =~ s/&\#0?86;/V/g;
       $result =~ s/&\#0?87;/W/g;
       $result =~ s/&\#0?88;/X/g;
       $result =~ s/&\#0?89;/Y/g;
       $result =~ s/&\#0?90;/Z/g;
       $result =~ s/&\#0?91;/[/g;
       $result =~ s/&\#0?92;/\\ensuremath\{\\setminus\}/g;
       $result =~ s/&\#0?93;/]/g;
       $result =~ s/&\#(0?94|136);/\\ensuremath\{\\wedge\}/g;
       $result =~ s/&\#(0?95|138|154);/\\underline{\\makebox[2mm]{\\strut}}/g;
       $result =~ s/&\#(0?96|145);/\`/g;
       $result =~ s/&\#0?97;/a/g;
       $result =~ s/&\#0?98;/b/g;
       $result =~ s/&\#0?99;/c/g;
       $result =~ s/&\#100;/d/g;
       $result =~ s/&\#101;/e/g;
       $result =~ s/&\#102;/f/g;
       $result =~ s/&\#103;/g/g;
       $result =~ s/&\#104;/h/g;
       $result =~ s/&\#105;/i/g;
       $result =~ s/&\#106;/j/g;
       $result =~ s/&\#107;/k/g;
       $result =~ s/&\#108;/l/g;
       $result =~ s/&\#109;/m/g;
       $result =~ s/&\#110;/n/g;
       $result =~ s/&\#111;/o/g;
       $result =~ s/&\#112;/p/g;
       $result =~ s/&\#113;/q/g;
       $result =~ s/&\#114;/r/g;
       $result =~ s/&\#115;/s/g;
       $result =~ s/&\#116;/t/g;
       $result =~ s/&\#117;/u/g;
       $result =~ s/&\#118;/v/g;
       $result =~ s/&\#119;/w/g;
       $result =~ s/&\#120;/x/g;
       $result =~ s/&\#121;/y/g;
       $result =~ s/&\#122;/z/g;
       $result =~ s/&\#123;/\\{/g;
       $result =~ s/&\#124;/\|/g;
       $result =~ s/&\#125;/\\}/g;
       $result =~ s/&\#126;/\~/g;
       $result =~ s/&\#131;/\\textflorin /g;
       $result =~ s/&\#132;/\"/g;
       $result =~ s/&\#133;/\\ensuremath\{\\ldots\}/g;
       $result =~ s/&\#134;/\\ensuremath\{\\dagger\}/g;
       $result =~ s/&\#135;/\\ensuremath\{\\ddagger\}/g;
       $result =~ s/&\#137;/\\textperthousand /g;
       $result =~ s/&\#140;/{\\OE}/g;
       $result =~ s/&\#147;/\`\`/g;
       $result =~ s/&\#148;/\'\'/g;
       $result =~ s/&\#149;/\\ensuremath\{\\bullet\}/g;
       $result =~ s/&(\#150|\#8211);/--/g;
       $result =~ s/&\#151;/---/g;
       $result =~ s/&\#152;/\\ensuremath\{\\sim\}/g;
       $result =~ s/&\#153;/\\texttrademark /g;
       $result =~ s/&\#156;/\\oe/g;
       $result =~ s/&\#159;/\\\"Y/g;
       $result =~ s/&(\#160|nbsp);/~/g;
       $result =~ s/&(\#161|iexcl);/!\`/g;
       $result =~ s/&(\#162|cent);/\\textcent /g;
       $result =~ s/&(\#163|pound);/\\pounds /g; 
       $result =~ s/&(\#164|curren);/\\textcurrency /g;
       $result =~ s/&(\#165|yen);/\\textyen /g;
       $result =~ s/&(\#166|brvbar);/\\textbrokenbar /g;
       $result =~ s/&(\#167|sect);/\\textsection /g;
       $result =~ s/&(\#168|uml);/\\"\{\} /g;
       $result =~ s/&(\#169|copy);/\\copyright /g;
       $result =~ s/&(\#170|ordf);/\\textordfeminine /g;
       $result =~ s/&(\#172|not);/\\ensuremath\{\\neg\}/g;
       $result =~ s/&(\#173|shy);/ - /g;
       $result =~ s/&(\#174|reg);/\\textregistered /g;
       $result =~ s/&(\#175|macr);/\\ensuremath\{^{-}\}/g;
       $result =~ s/&(\#176|deg);/\\ensuremath\{^{\\circ}\}/g;
       $result =~ s/&(\#177|plusmn);/\\ensuremath\{\\pm\}/g;
       $result =~ s/&(\#178|sup2);/\\ensuremath\{^2\}/g;
       $result =~ s/&(\#179|sup3);/\\ensuremath\{^3\}/g;
       $result =~ s/&(\#180|acute);/\\'\{\} /g;
       $result =~ s/&(\#181|micro);/\\ensuremath\{\\mu\}/g;
       $result =~ s/&(\#182|para);/\\P/g;
       $result =~ s/&(\#183|middot);/\\ensuremath\{\\cdot\}/g;
       $result =~ s/&(\#184|cedil);/\\c{\\strut}/g;
       $result =~ s/&(\#185|sup1);/\\ensuremath\{^1\}/g;
       $result =~ s/&(\#186|ordm);/\\textordmasculine /g;
       $result =~ s/&(\#188|frac14);/\\textonequarter /g;
       $result =~ s/&(\#189|frac12);/\\textonehalf /g;
       $result =~ s/&(\#190|frac34);/\\textthreequarters /g;
       $result =~ s/&(\#191|iquest);/?\`/g;   
       $result =~ s/&(\#192|Agrave);/\\\`{A}/g;  
       $result =~ s/&(\#193|Aacute);/\\\'{A}/g; 
       $result =~ s/&(\#194|Acirc);/\\^{A}/g;
       $result =~ s/&(\#195|Atilde);/\\~{A}/g;
       $result =~ s/&(\#196|Auml);/\\\"{A}/g; 
       $result =~ s/&(\#197|Aring);/{\\AA}/g;
       $result =~ s/&(\#198|AElig);/{\\AE}/g;
       $result =~ s/&(\#199|Ccedil);/\\c{c}/g;
       $result =~ s/&(\#200|Egrave);/\\\`{E}/g;  
       $result =~ s/&(\#201|Eacute);/\\\'{E}/g;    
       $result =~ s/&(\#202|Ecirc);/\\^{E}/g;
       $result =~ s/&(\#203|Euml);/\\\"{E}/g;
       $result =~ s/&(\#204|Igrave);/\\\`{I}/g;
       $result =~ s/&(\#205|Iacute);/\\\'{I}/g;    
       $result =~ s/&(\#206|Icirc);/\\^{I}/g;
       $result =~ s/&(\#207|Iuml);/\\\"{I}/g;    
       $result =~ s/&(\#209|Ntilde);/\\~{N}/g;
       $result =~ s/&(\#210|Ograve);/\\\`{O}/g;
       $result =~ s/&(\#211|Oacute);/\\\'{O}/g;
       $result =~ s/&(\#212|Ocirc);/\\^{O}/g;
       $result =~ s/&(\#213|Otilde);/\\~{O}/g;
       $result =~ s/&(\#214|Ouml);/\\\"{O}/g;    
       $result =~ s/&(\#215|times);/\\ensuremath\{\\times\}/g;
       $result =~ s/&(\#216|Oslash);/{\\O}/g;
       $result =~ s/&(\#217|Ugrave);/\\\`{U}/g;    
       $result =~ s/&(\#218|Uacute);/\\\'{U}/g;
       $result =~ s/&(\#219|Ucirc);/\\^{U}/g;
       $result =~ s/&(\#220|Uuml);/\\\"{U}/g;
       $result =~ s/&(\#221|Yacute);/\\\'{Y}/g;
       $result =~ s/&(\#223|szlig);/{\\ss}/g;
       $result =~ s/&(\#224|agrave);/\\\`{a}/g;
       $result =~ s/&(\#225|aacute);/\\\'{a}/g;
       $result =~ s/&(\#226|acirc);/\\^{a}/g;
       $result =~ s/&(\#227|atilde);/\\~{a}/g;
       $result =~ s/&(\#228|auml);/\\\"{a}/g;
       $result =~ s/&(\#229|aring);/{\\aa}/g;
       $result =~ s/&(\#230|aelig);/{\\ae}/g;
       $result =~ s/&(\#231|ccedil);/\\c{c}/g;
       $result =~ s/&(\#232|egrave);/\\\`{e}/g;
       $result =~ s/&(\#233|eacute);/\\\'{e}/g;
       $result =~ s/&(\#234|ecirc);/\\^{e}/g;
       $result =~ s/&(\#235|euml);/\\\"{e}/g;
       $result =~ s/&(\#236|igrave);/\\\`{i}/g;
       $result =~ s/&(\#237|iacute);/\\\'{i}/g;
       $result =~ s/&(\#238|icirc);/\\^{i}/g;
       $result =~ s/&(\#239|iuml);/\\\"{i}/g;
       $result =~ s/&(\#240|eth);/\\ensuremath\{\\partial\}/g;
       $result =~ s/&(\#241|ntilde);/\\~{n}/g;
       $result =~ s/&(\#242|ograve);/\\\`{o}/g;
       $result =~ s/&(\#243|oacute);/\\\'{o}/g;
       $result =~ s/&(\#244|ocirc);/\\^{o}/g;
       $result =~ s/&(\#245|otilde);/\\~{o}/g;
       $result =~ s/&(\#246|ouml);/\\\"{o}/g;
       $result =~ s/&(\#247|divide);/\\ensuremath\{\\div\}/g;
       $result =~ s/&(\#248|oslash);/{\\o}/g;
       $result =~ s/&(\#249|ugrave);/\\\`{u}/g; 
       $result =~ s/&(\#250|uacute);/\\\'{u}/g;
       $result =~ s/&(\#251|ucirc);/\\^{u}/g;
       $result =~ s/&(\#252|uuml);/\\\"{u}/g;
       $result =~ s/&(\#253|yacute);/\\\'{y}/g;
       $result =~ s/&(\#255|yuml);/\\\"{y}/g;
       $result =~ s/&\#295;/\\ensuremath\{\\hbar\}/g;
       $result =~ s/&\#952;/\\ensuremath\{\\theta\}/g;
   #Greek Alphabet
       $result =~ s/&(alpha|\#945);/\\ensuremath\{\\alpha\}/g;
       $result =~ s/&(beta|\#946);/\\ensuremath\{\\beta\}/g;
       $result =~ s/&(gamma|\#947);/\\ensuremath\{\\gamma\}/g;
       $result =~ s/&(delta|\#948);/\\ensuremath\{\\delta\}/g;
       $result =~ s/&(epsilon|\#949);/\\ensuremath\{\\epsilon\}/g;
       $result =~ s/&(zeta|\#950);/\\ensuremath\{\\zeta\}/g;
       $result =~ s/&(eta|\#951);/\\ensuremath\{\\eta\}/g;
       $result =~ s/&(theta|\#952);/\\ensuremath\{\\theta\}/g;
       $result =~ s/&(iota|\#953);/\\ensuremath\{\\iota\}/g;
       $result =~ s/&(kappa|\#954);/\\ensuremath\{\\kappa\}/g;
       $result =~ s/&(lambda|\#955);/\\ensuremath\{\\lambda\}/g;
       $result =~ s/&(mu|\#956);/\\ensuremath\{\\mu\}/g;
       $result =~ s/&(nu|\#957);/\\ensuremath\{\\nu\}/g;
       $result =~ s/&(xi|\#958);/\\ensuremath\{\\xi\}/g;
       $result =~ s/&(omicron|\#959);/o/g;
       $result =~ s/&(pi|\#960);/\\ensuremath\{\\pi\}/g;
       $result =~ s/&(rho|\#961);/\\ensuremath\{\\rho\}/g;
       $result =~ s/&(sigma|\#963);/\\ensuremath\{\\sigma\}/g;
       $result =~ s/&(tau|\#964);/\\ensuremath\{\\tau\}/g;
       $result =~ s/&(upsilon|\#965);/\\ensuremath\{\\upsilon\}/g;
       $result =~ s/&(phi|\#966);/\\ensuremath\{\\phi\}/g;
       $result =~ s/&(chi|\#967);/\\ensuremath\{\\chi\}/g;
       $result =~ s/&(psi|\#968);/\\ensuremath\{\\psi\}/g;
       $result =~ s/&(omega|\#969);/\\ensuremath\{\\omega\}/g;
       $result =~ s/&(thetasym|\#977);/\\ensuremath\{\\vartheta\}/g;
       $result =~ s/&(piv|\#982);/\\ensuremath\{\\varpi\}/g;
       $result =~ s/&(Alpha|\#913);/A/g;
       $result =~ s/&(Beta|\#914);/B/g;
       $result =~ s/&(Gamma|\#915);/\\ensuremath\{\\Gamma\}/g;
       $result =~ s/&(Delta|\#916);/\\ensuremath\{\\Delta\}/g;
       $result =~ s/&(Epsilon|\#917);/E/g;
       $result =~ s/&(Zeta|\#918);/Z/g;
       $result =~ s/&(Eta|\#919);/H/g;
       $result =~ s/&(Theta|\#920);/\\ensuremath\{\\Theta\}/g;
       $result =~ s/&(Iota|\#921);/I/g;
       $result =~ s/&(Kappa|\#922);/K/g;
       $result =~ s/&(Lambda|\#923);/\\ensuremath\{\\Lambda\}/g;
       $result =~ s/&(Mu|\#924);/M/g;
       $result =~ s/&(Nu|\#925);/N/g;
       $result =~ s/&(Xi|\#926);/\\ensuremath\{\\Xi\}/g;
       $result =~ s/&(Omicron|\#927);/O/g;
       $result =~ s/&(Pi|\#928);/\\ensuremath\{\\Pi\}/g;
       $result =~ s/&(Rho|\#929);/P/g;
       $result =~ s/&(Sigma|\#931);/\\ensuremath\{\\Sigma\}/g;
       $result =~ s/&(Tau|\#932);/T/g;
       $result =~ s/&(Upsilon|\#933);/\\ensuremath\{\\Upsilon\}/g;
       $result =~ s/&(Phi|\#934);/\\ensuremath\{\\Phi\}/g;
       $result =~ s/&(Chi|\#935);/X/g;
       $result =~ s/&(Psi|\#936);/\\ensuremath\{\\Psi\}/g;
       $result =~ s/&(Omega|\#937);/\\ensuremath\{\\Omega\}/g;
   #Arrows (extended HTML 4.01)
       $result =~ s/&(larr|\#8592);/\\ensuremath\{\\leftarrow\}/g;
       $result =~ s/&(uarr|\#8593);/\\ensuremath\{\\uparrow\}/g;
       $result =~ s/&(rarr|\#8594);/\\ensuremath\{\\rightarrow\}/g;
       $result =~ s/&(darr|\#8595);/\\ensuremath\{\\downarrow\}/g;
       $result =~ s/&(harr|\#8596);/\\ensuremath\{\\leftrightarrow\}/g;
       $result =~ s/&(lArr|\#8656);/\\ensuremath\{\\Leftarrow\}/g;
       $result =~ s/&(uArr|\#8657);/\\ensuremath\{\\Uparrow\}/g;
       $result =~ s/&(rArr|\#8658);/\\ensuremath\{\\Rightarrow\}/g;
       $result =~ s/&(dArr|\#8659);/\\ensuremath\{\\Downarrow\}/g;
       $result =~ s/&(hArr|\#8660);/\\ensuremath\{\\Leftrightarrow\}/g;
   #Mathematical Operators (extended HTML 4.01)
       $result =~ s/&(forall|\#8704);/\\ensuremath\{\\forall\}/g;
       $result =~ s/&(part|\#8706);/\\ensuremath\{\\partial\}/g;
       $result =~ s/&(exist|\#8707);/\\ensuremath\{\\exists\}/g;
       $result =~ s/&(empty|\#8709);/\\ensuremath\{\\emptyset\}/g;
       $result =~ s/&(nabla|\#8711);/\\ensuremath\{\\nabla\}/g;
       $result =~ s/&(isin|\#8712);/\\ensuremath\{\\in\}/g;
       $result =~ s/&(notin|\#8713);/\\ensuremath\{\\notin\}/g;
       $result =~ s/&(ni|\#8715);/\\ensuremath\{\\ni\}/g;
       $result =~ s/&(prod|\#8719);/\\ensuremath\{\\prod\}/g;
       $result =~ s/&(sum|\#8721);/\\ensuremath\{\\sum\}/g;
       $result =~ s/&(minus|\#8722);/\\ensuremath\{-\}/g;
       $result =~ s/–/\\ensuremath\{-\}/g;
       $result =~ s/&(lowast|\#8727);/\\ensuremath\{*\}/g;
       $result =~ s/&(radic|\#8730);/\\ensuremath\{\\surd\}/g;
       $result =~ s/&(prop|\#8733);/\\ensuremath\{\\propto\}/g;
       $result =~ s/&(infin|\#8734);/\\ensuremath\{\\infty\}/g;
       $result =~ s/&(ang|\#8736);/\\ensuremath\{\\angle\}/g;
       $result =~ s/&(and|\#8743);/\\ensuremath\{\\wedge\}/g;
       $result =~ s/&(or|\#8744);/\\ensuremath\{\\vee\}/g;
       $result =~ s/&(cap|\#8745);/\\ensuremath\{\\cap\}/g;
       $result =~ s/&(cup|\#8746);/\\ensuremath\{\\cup\}/g;
       $result =~ s/&(int|\#8747);/\\ensuremath\{\\int\}/g;
       $result =~ s/&(sim|\#8764);/\\ensuremath\{\\sim\}/g;
       $result =~ s/&(cong|\#8773);/\\ensuremath\{\\cong\}/g;
       $result =~ s/&(asymp|\#8776);/\\ensuremath\{\\approx\}/g;
       $result =~ s/&(ne|\#8800);/\\ensuremath\{\\not=\}/g;
       $result =~ s/&(equiv|\#8801);/\\ensuremath\{\\equiv\}/g;
       $result =~ s/&(le|\#8804);/\\ensuremath\{\\leq\}/g;
       $result =~ s/&(ge|\#8805);/\\ensuremath\{\\geq\}/g;
       $result =~ s/&(sub|\#8834);/\\ensuremath\{\\subset\}/g;
       $result =~ s/&(sup|\#8835);/\\ensuremath\{\\supset\}/g;
       $result =~ s/&(nsub|\#8836);/\\ensuremath\{\\not\\subset\}/g;
       $result =~ s/&(sube|\#8838);/\\ensuremath\{\\subseteq\}/g;
       $result =~ s/&(supe|\#8839);/\\ensuremath\{\\supseteq\}/g;
       $result =~ s/&(oplus|\#8853);/\\ensuremath\{\\oplus\}/g;
       $result =~ s/&(otimes|\#8855);/\\ensuremath\{\\otimes\}/g;
       $result =~ s/&(perp|\#8869);/\\ensuremath\{\\perp\}/g;
       $result =~ s/&(sdot|\#8901);/\\ensuremath\{\\cdot\}/g;
   #Geometric Shapes (extended HTML 4.01)
       $result =~ s/&(loz|\#9674);/\\ensuremath\{\\Diamond\}/g;
   #Miscellaneous Symbols (extended HTML 4.01)
       $result =~ s/&(spades|\#9824);/\\ensuremath\{\\spadesuit\}/g;
       $result =~ s/&(clubs|\#9827);/\\ensuremath\{\\clubsuit\}/g;
       $result =~ s/&(hearts|\#9829);/\\ensuremath\{\\heartsuit\}/g;
       $result =~ s/&(diams|\#9830);/\\ensuremath\{\\diamondsuit\}/g;
   #   Chemically useful 'things' contributed by Hon Kie (bug 4652).
   
       $result =~ s/&\#8636;/\\ensuremath\{\\leftharpoonup\}/g;
       $result =~ s/&\#8637;/\\ensuremath\{\\leftharpoondown\}/g;
       $result =~ s/&\#8640;/\\ensuremath\{\\rightharpoonup\}/g;
       $result =~ s/&\#8641;/\\ensuremath\{\\rightharpoondown\}/g;
       $result =~ s/&\#8652;/\\ensuremath\{\\rightleftharpoons\}/g;
       $result =~ s/&\#8605;/\\ensuremath\{\\leadsto\}/g;
       $result =~ s/&\#8617;/\\ensuremath\{\\hookleftarrow\}/g;
       $result =~ s/&\#8618;/\\ensuremath\{\\hookrightarrow\}/g;
       $result =~ s/&\#8614;/\\ensuremath\{\\mapsto\}/g;
       $result =~ s/&\#8599;/\\ensuremath\{\\nearrow\}/g;
       $result =~ s/&\#8600;/\\ensuremath\{\\searrow\}/g;
       $result =~ s/&\#8601;/\\ensuremath\{\\swarrow\}/g;
       $result =~ s/&\#8598;/\\ensuremath\{\\nwarrow\}/g;
   
       # Left/right quotations:
   
       $result =~ s/&(ldquo|#8220);/\`\`/g;
       $result =~ s/&(rdquo|#8221);/\'\'/g;
   
   
   
       return $result;
   }
   
   
                     #width, height, oddsidemargin, evensidemargin, topmargin
   my %page_formats=
       ('letter' => {
    'book' => {
        '1' => [ '7.1 in','9.8 in', '-0.57 in','-0.57 in','0.275 in'],
        '2' => ['3.66 in','9.8 in', '-0.57 in','-0.57 in','0.275 in']
    },
    'album' => {
        '1' => [ '8.8 in', '6.8 in','-0.55 in',  '-0.55 in','0.394 in'],
        '2' => [ '4.8 in', '6.8 in','-0.5 in', '-1.0 in','3.5 in']
    },
        },
        'legal' => {
    'book' => {
        '1' => ['7.1 in','13 in',,'-0.57 in','-0.57 in','-0.5 in'],
        '2' => ['3.66 in','13 in','-0.57 in','-0.57 in','-0.5 in']
    },
    'album' => {
        '1' => ['12 in','7.1 in',,'-0.57 in','-0.57 in','-0.5 in'],
                '2' => ['6.0 in','7.1 in','-1 in','-1 in','5 in']
             },
        },
        'tabloid' => {
    'book' => {
        '1' => ['9.8 in','16 in','-0.57 in','-0.57 in','-0.5 in'],
        '2' => ['4.9 in','16 in','-0.57 in','-0.57 in','-0.5 in']
    },
    'album' => {
        '1' => ['16 in','9.8 in','-0.57 in','-0.57 in','-0.5 in'],
        '2' => ['16 in','4.9 in','-0.57 in','-0.57 in','-0.5 in']
             },
        },
        'executive' => {
    'book' => {
        '1' => ['6.8 in','9 in','-0.57 in','-0.57 in','1.2 in'],
        '2' => ['3.1 in','9 in','-0.57 in','-0.57 in','1.2 in']
    },
    'album' => {
        '1' => [],
        '2' => []
             },
        },
        'a2' => {
    'book' => {
        '1' => [],
        '2' => []
    },
    'album' => {
        '1' => [],
        '2' => []
             },
        },
        'a3' => {
    'book' => {
        '1' => [],
        '2' => []
    },
    'album' => {
        '1' => [],
        '2' => []
             },
        },
        'a4' => {
    'book' => {
        '1' => ['17.6 cm','27.2 cm','-1.397 cm','-2.11 cm','-1.27 cm'],
        '2' => [ '9.1 cm','27.2 cm','-1.397 cm','-2.11 cm','-1.27 cm']
    },
    'album' => {
        '1' => ['21.59 cm','19.558 cm','-1.397cm','-2.11 cm','0 cm'],
        '2' => ['9.91 cm','19.558 cm','-1.397 cm','-2.11 cm','0 cm']
    },
        },
        'a5' => {
    'book' => {
        '1' => [],
        '2' => []
    },
    'album' => {
        '1' => [],
        '2' => []
             },
        },
        'a6' => {
    'book' => {
        '1' => [],
        '2' => []
    },
    'album' => {
        '1' => [],
        '2' => []
             },
        },
        );
   
   sub page_format {
   #
   #Supported paper format: "Letter [8 1/2x11 in]",      "Legal [8 1/2x14 in]",
   #                        "Ledger/Tabloid [11x17 in]", "Executive [7 1/2x10 in]",
   #                        "A2 [420x594 mm]",           "A3 [297x420 mm]",
   #                        "A4 [210x297 mm]",           "A5 [148x210 mm]",
   #                        "A6 [105x148 mm]"
   # 
       my ($papersize,$layout,$numberofcolumns) = @_; 
       return @{$page_formats{$papersize}->{$layout}->{$numberofcolumns}};
   }
   
   
   sub get_name {
       my ($uname,$udom)=@_;
       if (!defined($uname)) { $uname=$env{'user.name'}; }
       if (!defined($udom)) { $udom=$env{'user.domain'}; }
       my $plainname=&Apache::loncommon::plainname($uname,$udom);
       if ($plainname=~/^\s*$/) { $plainname=$uname.'@'.$udom; }
      $plainname=&Apache::lonxml::latex_special_symbols($plainname,'header');
       return $plainname;
   }
   
   sub get_course {
       my $courseidinfo;
       if (defined($env{'request.course.id'})) {
    $courseidinfo = &Apache::lonxml::latex_special_symbols(&unescape($env{'course.'.$env{'request.course.id'}.'.description'}),'header');
    my $sec = $env{'request.course.sec'};
       
       }
       return $courseidinfo;
   }
   
   sub page_format_transformation {
       my ($papersize,$layout,$numberofcolumns,$choice,$text,$assignment,$tableofcontents,$indexlist,$selectionmade) = @_; 
       my ($textwidth,$textheight,$oddoffset,$evenoffset,$topmargin);
   
       if ($selectionmade eq '4') {
    if ($choice eq 'all_problems') {
               $assignment=&mt('Problems from the Whole Course');
    } else {
               $assignment=&mt('Resources from the Whole Course');
    }
       } else {
    $assignment=&Apache::lonxml::latex_special_symbols($assignment,'header');
       }
       ($textwidth,$textheight,$oddoffset,$evenoffset,$topmargin) = &page_format($papersize,$layout,$numberofcolumns,$topmargin);
   
   
       my $name = &get_name();
       my $courseidinfo = &get_course();
       my $header_text  = $parmhash{'print_header_format'};
       $header_text     = &format_page_header($textwidth, $header_text, $assignment,
      $courseidinfo, $name);
       my $topmargintoinsert = '';
       if ($topmargin ne '0') {$topmargintoinsert='\setlength{\topmargin}{'.$topmargin.'}';}
       my $fancypagestatement='';
       if ($numberofcolumns eq '2') {
    $fancypagestatement="\\fancyhead{}\\fancyhead[LO]{$header_text}";
       } else {
    $fancypagestatement="\\rhead{}\\chead{}\\lhead{$header_text}";
       }
       if ($layout eq 'album') {
       $text =~ s/\\begin{document}/\\setlength{\\oddsidemargin}{$oddoffset}\\setlength{\\evensidemargin}{$evenoffset}$topmargintoinsert\n\\setlength{\\textwidth}{$textwidth}\\setlength{\\textheight}{$textheight}\\setlength{\\textfloatsep}{8pt plus 2\.0pt minus 4\.0pt}\n\\newlength{\\minipagewidth}\\setlength{\\minipagewidth}{\\textwidth\/\$number_of_columns-0\.2cm}\\usepackage{fancyhdr}\\addtolength{\\headheight}{\\baselineskip}\n\\pagestyle{fancy}$fancypagestatement\\usepackage{booktabs}\\begin{document}\\voffset=-0\.8 cm\\setcounter{page}{1}\n /;
       } elsif ($layout eq 'book') {
    if ($choice ne 'All class print') { 
       $text =~ s/\\begin{document}/\\textheight $textheight\\oddsidemargin = $evenoffset\\evensidemargin = $evenoffset $topmargintoinsert\n\\textwidth= $textwidth\\newlength{\\minipagewidth}\\setlength{\\minipagewidth}{\\textwidth\/\$number_of_columns-0\.2cm}\n\\renewcommand{\\ref}{\\keephidden\}\\usepackage{fancyhdr}\\addtolength{\\headheight}{\\baselineskip}\\pagestyle{fancy}$fancypagestatement\\usepackage{booktabs}\\begin{document}\n\\voffset=-0\.8 cm\\setcounter{page}{1}\n/;
    } else {
       $text =~ s/\\pagestyle{fancy}\\rhead{}\\chead{}\s*\\begin{document}/\\textheight = $textheight\\oddsidemargin = $evenoffset\n\\evensidemargin = $evenoffset $topmargintoinsert\\textwidth= $textwidth\\newlength{\\minipagewidth}\n\\setlength{\\minipagewidth}{\\textwidth\/\$number_of_columns-0\.2cm}\\renewcommand{\\ref}{\\keephidden\}\\pagestyle{fancy}\\rhead{}\\chead{}\\usepackage{booktabs}\\begin{document}\\voffset=-0\.8cm\n\\setcounter{page}{1}  \\vskip 5 mm\n /;
    }
    if ($papersize eq 'a4') {
       my $papersize_text;
       if ($perm{'pav'}) {
    $papersize_text = '\\special{papersize=210mm,297mm}';
       } else {
    $papersize_text = '\special{papersize=210mm,297mm}';
       }
       $text =~ s/(\\begin{document})/$1$papersize_text/;
    }
       }
       if ($tableofcontents eq 'yes') {$text=~s/(\\setcounter\{page\}\{1\})/$1 \\tableofcontents\\newpage /;}
       if ($indexlist eq 'yes') {
    $text=~s/(\\begin{document})/\\makeindex $1/;
    $text=~s/(\\end{document})/\\strut\\\\\\strut\\printindex $1/;
       }
       return $text;
   }
   
   
   sub page_cleanup {
       my $result = shift;
    
       $result =~ m/\\end{document}(\d*)$/;
       my $number_of_columns = $1;
       my $insert = '{';
       for (my $id=1;$id<=$number_of_columns;$id++) { $insert .='l'; }
       $insert .= '}';
       $result =~ s/(\\begin{longtable})INSERTTHEHEADOFLONGTABLE\\endfirsthead\\endhead/$1$insert/g;
       $result =~ s/&\s*REMOVETHEHEADOFLONGTABLE\\\\/\\\\/g;
       return $result,$number_of_columns;
   }
   
   
   sub details_for_menu {
       my ($helper)=@_;
       my $postdata=$env{'form.postdata'};
       if (!$postdata) { $postdata=$helper->{VARS}{'postdata'}; }
       my $name_of_resource = &Apache::lonnet::gettitle($postdata);
       my $symbolic = &Apache::lonnet::symbread($postdata);
       return if ( $symbolic eq '');
   
       my ($map,$id,$resource)=&Apache::lonnet::decode_symb($symbolic);
       $map=&Apache::lonnet::clutter($map);
       my $name_of_sequence = &Apache::lonnet::gettitle($map);
       if ($name_of_sequence =~ /^\s*$/) {
    $map =~ m|([^/]+)$|;
    $name_of_sequence = $1;
       }
       my $name_of_map = &Apache::lonnet::gettitle($env{'request.course.uri'});
       if ($name_of_map =~ /^\s*$/) {
    $env{'request.course.uri'} =~ m|([^/]+)$|;
    $name_of_map = $1;
       }
       return ($name_of_resource,$name_of_sequence,$name_of_map);
   }
   
   sub copyright_line {
       return '\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill}\vspace*{-2 mm}\newline\noindent{\tiny Printed from LON-CAPA\copyright MSU{\hfill} Licensed under GNU General Public License } ';
   }
   my $end_of_student = "\n".'\special{ps:ENDOFSTUDENTSTAMP}'."\n";
   
   sub latex_corrections {
       my ($number_of_columns,$result,$selectionmade,$answer_mode) = @_;
   #    $result =~ s/\\includegraphics{/\\includegraphics\[width=\\minipagewidth\]{/g;
       my $copyright = &copyright_line();
       if ($selectionmade eq '1' || $answer_mode eq 'only') {
    $result =~ s/(\\end{document})/\\strut\\vskip 0 mm $copyright $end_of_student $1/;
       } else {
    $result =~ s/(\\end{document})/\\strut\\vspace\*{-4 mm}\\newline $copyright $end_of_student $1/;
       }
       $result =~ s/\$number_of_columns/$number_of_columns/g;
       $result =~ s/(\\end{longtable}\s*)(\\strut\\newline\\noindent\\makebox\[\\textwidth\/$number_of_columns\]\[b\]{\\hrulefill})/$2$1/g;
       $result =~ s/(\\end{longtable}\s*)\\strut\\newline/$1/g;
   #-- LaTeX corrections     
       my $first_comment = index($result,'<!--',0);
       while ($first_comment != -1) {
    my $end_comment = index($result,'-->',$first_comment);
    substr($result,$first_comment,$end_comment-$first_comment+3) = '';
    $first_comment = index($result,'<!--',$first_comment);
       }
       $result =~ s/^\s+$//gm; #remove empty lines
       #removes more than one empty space
       $result =~ s|(\s\s+)|($1=~/[\n\r]/)?"\n":" "|ge;
       $result =~ s/\\\\\s*\\vskip/\\vskip/gm;
       $result =~ s/\\\\\s*\\noindent\s*(\\\\)+/\\\\\\noindent /g;
       $result =~ s/{\\par }\s*\\\\/\\\\/gm;
       $result =~ s/\\\\\s+\[/ \[/g;
       #conversion of html characters to LaTeX equivalents
       if ($result =~ m/&(\w+|#\d+);/) {
    $result = &character_chart($result);
       }
       $result =~ s/(\\end{tabular})\s*\\vskip 0 mm/$1/g;
       $result =~ s/(\\begin{enumerate})\s*\\noindent/$1/g;
       return $result;
   }
   
   
   sub index_table {
       my $currentURL = shift;
       my $insex_string='';
       $currentURL=~s/\.([^\/+])$/\.$1\.meta/;
       $insex_string=&Apache::lonnet::metadata($currentURL,'keywords');
       return $insex_string;
   }
   
   
   sub IndexCreation {
       my ($texversion,$currentURL)=@_;
       my @key_words=split(/,/,&index_table($currentURL));
       my $chunk='';
       my $st=index $texversion,'\addcontentsline{toc}{subsection}{';
       if ($st>0) {
    for (my $i=0;$i<3;$i++) {$st=(index $texversion,'}',$st+1);}
    $chunk=substr($texversion,0,$st+1);
    substr($texversion,0,$st+1)=' ';
       }
       foreach my $key_word (@key_words) {
    if ($key_word=~/\S+/) {
       $texversion=~s/\b($key_word)\b/$1 \\index{$key_word} /i;
    }
       }
       if ($st>0) {substr($texversion,0,1)=$chunk;}
       return $texversion;
   }
   
   sub print_latex_header {
       my $mode=shift;
   
       return &Apache::londefdef::latex_header($mode);
   }
   
   sub path_to_problem {
       my ($urlp,$colwidth)=@_;
       $urlp=&Apache::lonnet::clutter($urlp);
   
       my $newurlp = '';
       $colwidth=~s/\s*mm\s*$//;
   #characters average about 2 mm in width
       if (length($urlp)*2 > $colwidth) {
    my @elements = split('/',$urlp);
    my $curlength=0;
    foreach my $element (@elements) {
       if ($element eq '') { next; }
       if ($curlength+(length($element)*2) > $colwidth) {
    $newurlp .=  '|\vskip -1 mm \verb|';
    $curlength=length($element)*2;
       } else {
    $curlength+=length($element)*2;
       }
       $newurlp.='/'.$element;
    }
       } else {
    $newurlp=$urlp;
       }
       return '{\small\noindent\verb|'.$newurlp.'|\vskip 0 mm}';
   }
   
   sub recalcto_mm {
       my $textwidth=shift;
       my $LaTeXwidth;
       if ($textwidth=~/(-?\d+\.?\d*)\s*cm/) {
    $LaTeXwidth = $1*10;
       } elsif ($textwidth=~/(-?\d+\.?\d*)\s*mm/) {
    $LaTeXwidth = $1;
       } elsif ($textwidth=~/(-?\d+\.?\d*)\s*in/) {
    $LaTeXwidth = $1*25.4;
       }
       $LaTeXwidth.=' mm';
       return $LaTeXwidth;
   }
   
   sub get_textwidth {
       my ($helper,$LaTeXwidth)=@_;
       my $textwidth=$LaTeXwidth;
       if ($helper->{'VARS'}->{'pagesize.width'}=~/\d+/ &&
    $helper->{'VARS'}->{'pagesize.widthunit'}=~/\w+/) {
    $textwidth=&recalcto_mm($helper->{'VARS'}->{'pagesize.width'}.' '.
    $helper->{'VARS'}->{'pagesize.widthunit'});
       }
       return $textwidth;
   }
   
   
   sub unsupported {
       my ($currentURL,$mode,$symb)=@_;
       if ($mode ne '') {$mode='\\'.$mode}
       my $result.= &print_latex_header($mode);
       if ($currentURL=~m|^(/adm/wrapper/)?ext/|) {
    $currentURL=~s|^(/adm/wrapper/)?ext/|http://|;
           $currentURL=~s|^http://https://|https://|;
    my $title=&Apache::lonnet::gettitle($symb);
    $title = &Apache::lonxml::latex_special_symbols($title);
    $result.=' \strut \\\\ '.$title.' \strut \\\\ '.$currentURL.' ';
       } else {
    $result.=$currentURL;
       }
       $result.= '\vskip 0.5mm\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill} \end{document}';
       return $result;
   }
   
   #
   #  Map from helper layout style to the book/album:
   #
   sub map_laystyle {
       my ($laystyle) = @_;
       if ($laystyle eq 'L') {
    $laystyle='album';
       } else {
    $laystyle='book';
       }
       return $laystyle;
   }
   
   sub print_page_in_course {
       my ($helper, $rparmhash, $currentURL, $resources) = @_;
   
       my %parmhash       = %$rparmhash;
       my @page_resources = @$resources;
       my $mode = $helper->{'VARS'}->{'LATEX_TYPE'};
       my $symb = $helper->{'VARS'}->{'symb'};
   
   
       my $format_from_helper = $helper->{'VARS'}->{'FORMAT'};
   
   
       my @temporary_array=split /\|/,$format_from_helper;
       my ($laystyle,$numberofcolumns,$papersize,$pdfFormFields)=@temporary_array;
       $laystyle = &map_laystyle($laystyle);
       my ($textwidth,$textheight,$oddoffset,$evenoffset) = &page_format($papersize,$laystyle,
         $numberofcolumns);
       my $LaTeXwidth=&recalcto_mm($textwidth); 
   
   
       if ($mode ne '') {$mode='\\'.$mode}
       my $result   =    &print_latex_header($mode);
       if ($currentURL=~m|^(/adm/wrapper/)?ext/|) {
    $currentURL=~s|^(/adm/wrapper/)?ext/|http://|;
    my $title=&Apache::lonnet::gettitle($symb);
    $title = &Apache::lonxml::latex_special_symbols($title);
       } else {
           my $esc_currentURL= $currentURL;
           $esc_currentURL =~ s/_/\\_/g;
    $result.=$esc_currentURL;
       }
       $result .= '\\\\';
   
       if ($helper->{'VARS'}->{'style_file'}=~/\w/) {
    &Apache::lonnet::appenv({'construct.style' =>
    $helper->{'VARS'}->{'style_file'}});
       } elsif ($env{'construct.style'}) {
    &Apache::lonnet::delenv('construct.style');
       }
   
       # First is the overall page description.  This is then followed by the 
       # components of the page. Each of which must be printed independently.
       my $the_page = shift(@page_resources); 
   
   
       foreach my $resource (@page_resources) {
    my $resource_src   = $resource->src(); # Essentially the URL of the resource.
    $result           .= $resource->title() . '\\\\';
   
    # Recurse if a .page:
   
    if ($resource_src =~ /.page$/i) {
       my $navmap         = Apache::lonnavmaps::navmap->new();
       my @page_resources = $navmap->retrieveResources($resource_src);
       $result           .= &print_page_in_course($helper, $rparmhash, 
          $resource_src, \@page_resources);
           } elsif ($resource->ext()) {
               $result .= &unsupported($currentURL,$mode,$symb);
    }
    # these resources go through the XML transformer:
   
    elsif ($resource_src =~ /\.(problem|exam|quiz|assess|survey|form|library|xml|html|htm|xhtml|xhtm)$/)  {
   
       my $urlp = &Apache::lonnet::clutter($resource_src);
   
       my %form;
       my %moreenv;
   
       &Apache::lonxml::remember_problem_counter();
       $moreenv{'request.filename'}=$urlp;
       if ($helper->{'VARS'}->{'probstatus'} eq 'exam') {$form{'problemtype'}='exam';}
   
       $form{'grade_target'}  = 'tex';
       $form{'textwidth'}    = &get_textwidth($helper, $LaTeXwidth);
       $form{'pdfFormFields'} = $pdfFormFields; # 
       $form{'showallfoils'} = $helper->{'VARS'}->{'showallfoils'};    
       
       $form{'problem_split'}=$parmhash{'problem_stream_switch'};
       $form{'suppress_tries'}=$parmhash{'suppress_tries'};
       $form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
       $form{'print_discussions'}=$helper->{'VARS'}->{'PRINT_DISCUSSIONS'};
       $form{'print_annotations'}=$helper->{'VARS'}->{'PRINT_ANNOTATIONS'};
       if (($helper->{'VARS'}->{'PRINT_DISCUSSIONS'} eq 'yes') ||
    ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes')) {
    $form{'problem_split'}='yes';
       }
       my $rndseed = time;
       if ($helper->{'VARS'}->{'curseed'}) {
    $rndseed=$helper->{'VARS'}->{'curseed'};
       }
       $form{'rndseed'}=$rndseed;
       &Apache::lonnet::appenv(\%moreenv);
       
       &Apache::lonxml::clear_problem_counter();
   
       my $texversion = &ssi_with_retries($urlp, $ssi_retry_count, %form);
   
   
       # current document with answers.. no need to encap in minipage
       #  since there's only one answer.
   
       if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
          ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
    my %answerform = %form;
   
   
    $answerform{'problem_split'}=$parmhash{'problem_stream_switch'};
    $answerform{'grade_target'}='answer';
    $answerform{'answer_output_mode'}='tex';
    $answerform{'rndseed'}=$rndseed;
                   if ($helper->{'VARS'}->{'probstatus'} eq 'exam') {
       $answerform{'problemtype'}='exam';
    }
    $resources_printed .= $urlp.':';
    my $answer=&ssi_with_retries($urlp,$ssi_retry_count, %answerform);
   
    if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
       $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
    } else {
       $texversion= &print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
       if ($helper->{'VARS'}->{'construction'} ne '1') {
    my $title = &Apache::lonnet::gettitle($helper->{'VARS'}->{'symb'});
    $title = &Apache::lonxml::latex_special_symbols($title);
    $texversion.='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
    $texversion.=&path_to_problem($urlp,$LaTeXwidth);
       } else {
    $texversion.='\vskip 0 mm \noindent\textbf{'.
                           &mt("Printing from Construction Space: No Title").'}\vskip 0 mm ';
    $texversion.=&path_to_problem($urlp,$LaTeXwidth);
       }
       $texversion.='\vskip 1 mm '.$answer.'\end{document}';
    }
   
   
   
   
       
       }
       # Print annotations.
   
   
       if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
    my $annotation .= &annotate($currentURL);
    $texversion =~ s/(\\keephidden{ENDOFPROBLEM})/$annotation$1/;
       }
       
       if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
    $texversion=&IndexCreation($texversion,$currentURL);
       }
       if ($helper->{'VARS'}->{'CONSTR_RESOURSE_URL'} eq 'yes') {
    $texversion=~s/(\\addcontentsline\{toc\}\{subsection\}\{[^\}]*\})/$1 URL: \\verb|$currentURL| \\strut\\\\\\strut /;
   
       }
       $texversion = &latex_header_footer_remove($texversion);
   
       # the first remaining line is a comment from londefdef the second
       # line  seems to be an extraneous \vskip 1mm \\\\ :
               # (imperfect removal from header_footer_remove?
   
       $texversion =~ s/\\vskip 1mm \\\\\\\\//;
   
       $result .= $texversion;
       if ($currentURL=~m/\.page\s*$/) {
    ($result,$numberofcolumns) = &page_cleanup($result);
       }
    }
       }
   
       $result.= '\vskip 0.5mm\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill} \end{document}';
       return $result;
   }
   
   
   #
   # List of recently generated print files
   #
   sub recently_generated {
       my ($prtspool) = @_;
       my $output;
       my $zip_result;
       my $pdf_result;
       opendir(DIR,$prtspool);
   
       my @files = 
    grep(/^$env{'user.name'}_$env{'user.domain'}_printout_(\d+)_.*\.(pdf|zip)$/,readdir(DIR));
       closedir(DIR);
   
       @files = sort {
    my ($actime) = (stat($prtspool.'/'.$a))[10];
    my ($bctime) = (stat($prtspool.'/'.$b))[10];
    return $bctime <=> $actime;
       } (@files);
   
       foreach my $filename (@files) {
    my ($ext) = ($filename =~ m/(pdf|zip)$/);
    my ($cdev,$cino,$cmode,$cnlink,
       $cuid,$cgid,$crdev,$csize,
       $catime,$cmtime,$cctime,
       $cblksize,$cblocks)=stat($prtspool.'/'.$filename);
           my $ext_text = 'pdf' ? &mt('PDF File'):&mt('Zip File');
    my $result=&Apache::loncommon::start_data_table_row()
                     .'<td>'
                     .'<a href="/prtspool/'.$filename.'">'.$ext_text.'</a>'
                     .'</td>'
                     .'<td>'.&Apache::lonlocal::locallocaltime($cctime).'</td>'
                     .'<td align="right">'.$csize.'</td>'
                     .&Apache::loncommon::end_data_table_row();
    if ($ext eq 'pdf') { $pdf_result .= $result; }
    if ($ext eq 'zip') { $zip_result .= $result; }
       }
       if ($zip_result || $pdf_result) {
           $output ='<hr />';
       }
       if ($zip_result) {
    $output .='<h3>'.&mt('Recently generated printout zip files')."</h3>\n"
                     .&Apache::loncommon::start_data_table()
                     .&Apache::loncommon::start_data_table_header_row()
                     .'<th>'.&mt('Download').'</th>'
                     .'<th>'.&mt('Creation Date').'</th>'
                     .'<th>'.&mt('File Size (Bytes)').'</th>'
                     .&Apache::loncommon::end_data_table_header_row()
                     .$zip_result
                     .&Apache::loncommon::end_data_table();
       }
       if ($pdf_result) {
    $output .='<h3>'.&mt('Recently generated printouts')."</h3>\n"
                     .&Apache::loncommon::start_data_table()
                     .&Apache::loncommon::start_data_table_header_row()
                     .'<th>'.&mt('Download').'</th>'
                     .'<th>'.&mt('Creation Date').'</th>'
                     .'<th>'.&mt('File Size (Bytes)').'</th>'
                     .&Apache::loncommon::end_data_table_header_row()
                     .$pdf_result
                     .&Apache::loncommon::end_data_table();
       }
       return $output;
   }
   
   #
   #   Retrieve the hash of page breaks.
   #
   #  Inputs:
   #    helper   - reference to helper object.
   #  Outputs
   #    A reference to a page break hash.
   #
   #
   # use Data::Dumper;
   # sub dump_helper_vars {
   #    my ($helper) = @_;
   #    my $helpervars = Dumper($helper->{'VARS'});
   #    &Apache::lonnet::logthis("Dump of helper vars:\n $helpervars");
   #}
   
   sub get_page_breaks  {
       my ($helper) = @_;
       my %page_breaks;
   
       foreach my $break (split /\|\|\|/, $helper->{'VARS'}->{'FINISHPAGE'}) {
    $page_breaks{$break} = 1;
       }
       return %page_breaks;
   }
   # 
   #   Returns text to insert for any extra vskip prior to the resource.
   #   Parameters:
   #     helper   - Reference to the helper object driving the printout.
   #     resource - Identifies the resource about to be printed.
   #
   #   This is done as follows:
   #    POSSIBLE_RESOURCES has the list of possible resources.
   #    EXTRASPACE         has the list of extra space values.
   #    EXTRASPACE_UNITS   is the set of resources for which the units are
   #                       mm. All others are 'in'.
   #    
   #    The resource is found in the POSSIBLE_RESOURCES to get the index
   #    of the EXTRASPACE value.
   #
   #   In order to speed this up for lengthy printouts, the first time,
   #   POSSIBLE_RESOURCES is turned into a look up hash and
   #   EXTRASPACE is turned into an array.
   #
   
   
   my %possible_resources;
   my %extraspace_mm;
   my @extraspace;
   my $skips_loaded       = 0;
   
   #  Function to load the skips hash and array
   
   sub load_skips {
   
       my ($helper)  = @_;
   
       #  If this is the first time, unrap the resources and extra spaces:
   
       if (!$skips_loaded) {
    @extraspace = (split(/\|\|\|/, $helper->{'VARS'}->{'EXTRASPACE'}));
    my @resource_list = (split(/\|\|\|/, $helper->{'VARS'}->{'POSSIBLE_RESOURCES'}));
    my $i = 0;
    foreach my $resource (@resource_list) {
       $possible_resources{$resource} = $i;
       $i++;
    }
    foreach my $mm_resource (split(/\|\|\|/, $helper->{'VARS'}->{'EXTRASPACE_UNITS'})) {
       $extraspace_mm{$mm_resource} = 1;
    }
    $skips_loaded = 1;
       }
 }  }
   
   sub get_extra_vspaces {
       my ($helper, $resource) = @_;
   
       &load_skips($helper);
   
       #  Lookup the resource in the possible resources hash.. that is the index
       # into the extraspace array that gives us either an empty string or
       # the number of mm to skip:
   
       my $index = $possible_resources{$resource};
       my $skip  = $extraspace[$index];
   
       my $result = '';
       if ($skip ne '') {
    my $units = 'in';
    if (defined($extraspace_mm{$resource})) {
       $units = 'mm';
    }
    $result = '\vskip '.$skip.' '.$units;
       }
   
   
       return $result;
   
   
   }
   
   #
   #  The resource chooser part of the helper needs more than just
   #  the value of the extraspaces var to recover the value into a text
   #  field option.  This sub produces the required format for the saved var:
   #  specifically 
   #    ||| separated fields of the form resourcename=value
   #
   #  Parameters:
   #    $helper     - Refers to the helper we are configuring
   #  Implicit input:
   #     $helper->{'VARS'}->{'EXTRASPACE'}  - the spaces helper var has the text field
   #                                          value.
   #     $helper->{'VARS'}->{'EXTRASPACE_UNITS'} - units for the skips (checkboxes).
   #     $helper->{'VARS'}->{'POSSIBLE_RESOURCES'}  - has the list of resources. |||
   #                                          separated of course.
   #  Implicit outputs:
   #     $env{'form.extraspace'}
   #     $env{'form.extraspace_units'}
   #
   sub set_form_extraspace {
       my ($helper) = @_;
   
       # the most convenient way to do this is to drive from the skips arrays/hash.
       # may not be the fastest, but this is once per print request so it's not so
       # speed critical:
   
       &load_skips($helper);
   
       my $result = '';
   
       foreach my $resource (keys(%possible_resources)) {
    my $vskip = $extraspace[$possible_resources{$resource}];
    $result  .= $resource .'=' . $vskip . '|||';
       }
   
       $env{'form.extraspace'}  = $result;
       $env{'form.extraspace_units'} = $helper->{'VARS'}->{'EXTRASPACE_UNITS'};
       return $result;
       
   }
   
   #  Output a sequence (recursively if neeed)
   #  from construction space.
   # Parameters:
   #    url     = URL of the sequence to print.
   #    helper  - Reference to the helper hash.
   #    form    - Copy of the format hash.
   #    LaTeXWidth
   # Returns:
   #   Text to add to the printout.
   #   NOTE if the first element of the outermost sequence
   #   is itself a sequence, the outermost caller may need to
   #   prefix the latex with the page headers stuff.
   #
   sub print_construction_sequence {
       my ($currentURL, $helper, %form, $LaTeXwidth) = @_;
   
       my $result;
       my $rndseed=time;
       if ($helper->{'VARS'}->{'curseed'}) {
    $rndseed=$helper->{'VARS'}->{'curseed'};
       }
       my $errtext=&LONCAPA::map::mapread(&Apache::lonnet::filelocation('',$currentURL));
   
       # 
       #  These make this all support recursing for subsequences.
       #
       my @order    = @LONCAPA::map::order;
       my @resources = @LONCAPA::map::resources; 
   
       for (my $member=0;$member<=$#order;$member++) {
    $resources[$order[$member]]=~/^([^:]*):([^:]*):/;
    my $urlp=$2;
    if ($urlp=~/\.(problem|exam|quiz|assess|survey|form|library|xml|html|htm|xhtml|xhtm)$/) {
       my $texversion='';
       if ($helper->{'VARS'}->{'ANSWER_TYPE'} ne 'only') {
    $form{'problem_split'}=$parmhash{'problem_stream_switch'};
    $form{'suppress_tries'}=$parmhash{'suppress_tries'};
    $form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
    $form{'rndseed'}=$rndseed;
    $resources_printed .=$urlp.':';
    $texversion=&ssi_with_retries($urlp, $ssi_retry_count, %form);
       }
       if((($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
    ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) && 
          ($urlp=~/$LONCAPA::assess_page_re/)) {
    #  Don't permanently modify %$form...
    my %answerform = %form;
    $answerform{'grade_target'}='answer';
    $answerform{'answer_output_mode'}='tex';
    $answerform{'rndseed'}=$rndseed;
    $answerform{'problem_split'}=$parmhash{'problem_stream_switch'};
    if ($urlp=~/\/res\//) {$env{'request.state'}='published';}
    $resources_printed .= $urlp.':';
    my $answer=&ssi_with_retries($urlp, $ssi_retry_count, %answerform);
    if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
       $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
    } else {
       # If necessary, encapsulate answer in minipage:
       
       $texversion=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
       my $title = &Apache::lonnet::gettitle($helper->{'VARS'}->{'symb'});
       $title = &Apache::lonxml::latex_special_symbols($title);
       my $body ='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
       $body.=&path_to_problem($urlp,$LaTeXwidth);
       $body.='\vskip 1 mm '.$answer.'\end{document}';
       $body = &encapsulate_minipage($body);
       $texversion.=$body;
    }
       }
       $texversion = &latex_header_footer_remove($texversion);
   
       if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
    $texversion=&IndexCreation($texversion,$urlp);
       }
       if ($helper->{'VARS'}->{'CONSTR_RESOURSE_URL'} eq 'yes') {
    $texversion=~s/(\\addcontentsline\{toc\}\{subsection\}\{[^\}]*\})/$1 URL: \\verb|$urlp| \\strut\\\\\\strut /;
       }
       $result.=$texversion;
   
    } elsif ($urlp=~/\.(sequence|page)$/) {
    
       # header:
   
       $result.='\strut\newline\noindent Sequence/page '.$urlp.'\strut\newline\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill}\newline\noindent ';
   
       # IF sequence, recurse:
       
       if ($urlp =~ /\.sequence$/) {
    $result .= &print_construction_sequence($urlp, 
    $helper, %form, 
    $LaTeXwidth);
       }
    }
    elsif ($urlp =~ /\.pdf$/i) {
       my $texversion;
       if ($member != 0) {
    $texversion .= '\cleardoublepage';
       }
   
       $texversion .= &include_pdf($urlp);
       $texversion = &latex_header_footer_remove($texversion);
       if ($member != $#order) {
    $texversion .= '\\ \cleardoublepage';
       }
       
       $result .= $texversion;
    }
       }
       if ($helper->{VARS}->{'construction'} eq '1') {$result=~s/(\\begin{document})/$1 \\fbox\{RANDOM SEED IS $rndseed\} /;}
       return $result;
   }
   
   #
   #  Top level for generating print output.
   #
   #  May call print_resources if multiple resources will be printed.
   #
   #  The main driver is $selectionmade which reflects the type of print out
   #  requested:
   #   Value    Print type:
   #   1        Print resource that's being looked at.
   #   2        Print problems in a map or in a page.
   #   3        Print pages in a map or resources in a page.
   #   4        Print all problems  or all resources.
   #   5        Print problems for seleted students.
   #   6        Print selected problems from a folder.
   #   7        Print print selected resources from some scope.
   #   8        Print resources for selected students.
   #
   #BZ 5209
   #   2        map_incomplete_problems_seq Print incomplete problems from the current
   #            folder in student context.
   #   5      map_incomplete_problems_people_seq Print incomplete problems from the
   #            current folder in privileged context.
   #    5      incomplete_problems_selpeople_course Print incomplete problems for
   #            selected people from the entire course.
   #
   #   Item 101 has much the same processing as 8,
   #
   #  Differences:  Item 101, 102 require per-student filtering of the resource
   #  set so that only the incomplete resources are printed.
   #  For item 100, filtering was done at the helper level.
   
 sub output_data {  sub output_data {
     my $r = shift;  
     $r->print(<<ENDPART);      my ($r,$helper,$rparmhash) = @_;
 <html>      my %parmhash = %$rparmhash;
 <head>      $ssi_error = 0; # This will be set nonzero by failing ssi's.
 <title>LON-CAPA output for printing</title>      $resources_printed = '';
 </head>      $font_size = $helper->{'VARS'}->{'fontsize'};
 <body bgcolor="FFFFFF">      my $print_type = $helper->{'VARS'}->{'PRINT_TYPE'}; # Allows textual simplification.
 <hr>      my $do_postprocessing = 1;
       my $js = <<ENDPART;
   <script type="text/javascript">
       var editbrowser;
       function openbrowser(formname,elementname,only,omit) {
           var url = '/res/?';
           if (editbrowser == null) {
               url += 'launch=1&';
           }
           url += 'catalogmode=interactive&';
           url += 'mode=parmset&';
           url += 'form=' + formname + '&';
           if (only != null) {
               url += 'only=' + only + '&';
           } 
           if (omit != null) {
               url += 'omit=' + omit + '&';
           }
           url += 'element=' + elementname + '';
           var title = 'Browser';
           var options = 'scrollbars=1,resizable=1,menubar=0';
           options += ',width=700,height=600';
           editbrowser = open(url,title,options,'1');
           editbrowser.focus();
       }
   </script>
 ENDPART  ENDPART
   
     my $choice = $ENV{'form.choice'};  
     my $layout = $ENV{'form.layout'};  
     my $laystyle = 'book';  
     my $result = '';  
     my %mystyle;  
     my $filename;  
   
     if ($choice eq 'Standard LaTeX output for current document') {      # Breadcrumbs
       my %moreenv;      #FIXME: Choose better/different breadcrumbs?!? Links?
       my $currequest=$ENV{'request.filename'};      my $brcrum = [{'href' => '',
       $moreenv{'form.grade_target'}='tex';                     'text' => 'Helper'}, #FIXME: Different origin possible than print out helper?
       $moreenv{'request.filename'}=$ENV{'form.url'};                    {'href' => '',
       &Apache::lonnet::appenv(%moreenv);                     'text' => 'Preparing Printout'}];
       my $texversion=&Apache::lonnet::ssi($ENV{'form.url'});  
       &Apache::lonnet::delenv('form.grade_target');      my $start_page  = &Apache::loncommon::start_page('Preparing Printout',
       %moreenv = ();                                                       $js,
       $moreenv{'request.filename'}=$currequest;                                                       {'bread_crumbs' => $brcrum,});
       &Apache::lonnet::appenv(%moreenv);      my $msg = &mt('Please stand by while processing your print request, this may take some time ...');
       $result .= $texversion;  
       $r->print($start_page."\n<p>\n$msg\n</p>\n");
     } elsif ($choice eq 'Standard LaTeX output for the primary sequence' or $choice eq 'Standard LaTeX output for whole primary sequence') {  
 #-- where is the primary sequence containing file?      # fetch the pagebreaks and store them in the course environment
  my %moreenv;      # The page breaks will be pulled into the hash %page_breaks which is
  my $symbolic = &Apache::lonnet::symbread($ENV{'form.url'});      # indexed by symb and contains 1's for each break.
  $_ = $symbolic;  
  m/([^_]+)_/;      $env{'form.pagebreaks'}  = $helper->{'VARS'}->{'FINISHPAGE'};
  my $primary_sequence = '/res/'.$1;      &set_form_extraspace($helper);
 #-- open and analyses the primary sequence      $env{'form.lastprinttype'} = $print_type; 
  my $sequence_file=&Apache::lonnet::filelocation("",$primary_sequence);      &Apache::loncommon::store_course_settings('print',
  my $sequencefilecontents=&Apache::lonnet::getfile($sequence_file);        {'pagebreaks'    => 'scalar',
  my @master_seq = &content_map($sequencefilecontents);         'extraspace'    => 'scalar',
 #-- produce an output string         'extraspace_units' => 'scalar',
          'lastprinttype' => 'scalar'});
       my %page_breaks  = &get_page_breaks($helper);
   
       my $format_from_helper = $helper->{'VARS'}->{'FORMAT'};
       my ($result,$selectionmade) = ('','');
       my $number_of_columns = 1; #used only for pages to determine the width of the cell
       my @temporary_array=split /\|/,$format_from_helper;
       my ($laystyle,$numberofcolumns,$papersize,$pdfFormFields)=@temporary_array;
   
       $laystyle = &map_laystyle($laystyle);
       my ($textwidth,$textheight,$oddoffset,$evenoffset) = &page_format($papersize,$laystyle,$numberofcolumns);
       my $assignment =  $env{'form.assignment'};
       my $LaTeXwidth=&recalcto_mm($textwidth); 
       my @print_array=();
       my @student_names=();
   
        
       #  Common settings for the %form has:
       # In some cases these settings get overriddent by specific cases, but the
       # settings are common enough to make it worthwhile factoring them out
       # here.
       #
       my %form;
       $form{'grade_target'} = 'tex';
       $form{'textwidth'}    = &get_textwidth($helper, $LaTeXwidth);
       $form{'pdfFormFields'} = $pdfFormFields;
   
       # If form.showallfoils is set, then request all foils be shown:
       # privilege will be enforced both by not allowing the 
       # check box selecting this option to be presnt unless it's ok,
       # and by lonresponse's priv. check.
       # The if is here because lonresponse.pm only cares that
       # showallfoils is defined, not what the value is.
   
       if ($helper->{'VARS'}->{'showallfoils'} eq "1") { 
    $form{'showallfoils'} = $helper->{'VARS'}->{'showallfoils'};
       }
       
       if ($helper->{'VARS'}->{'style_file'}=~/\w/) {
    &Apache::lonnet::appenv({'construct.style' =>
    $helper->{'VARS'}->{'style_file'}});
       } elsif ($env{'construct.style'}) {
    &Apache::lonnet::delenv('construct.style');
       }
   
       if ($print_type eq 'current_document') {
         #-- single document - problem, page, html, xml, ...
    my ($currentURL,$cleanURL);
   
    if ($helper->{'VARS'}->{'construction'} ne '1') {
               #prints published resource
       $currentURL=$helper->{'VARS'}->{'postdata'};
       $cleanURL=&Apache::lonenc::check_decrypt($currentURL);
    } else {
   
               #prints resource from the construction space
       $currentURL=$helper->{'VARS'}->{'filename'};
       $cleanURL=$currentURL;
    }
    $selectionmade = 1;
         
    if ($cleanURL!~m|^/adm/|
       && $cleanURL=~/\.(problem|exam|quiz|assess|survey|form|library|xml|html|htm|xhtml|xhtm)$/) {
       my $rndseed=time;
       my $texversion='';
       if ($helper->{'VARS'}->{'ANSWER_TYPE'} ne 'only') {
    my %moreenv;
    $moreenv{'request.filename'}=$cleanURL;
                   if ($helper->{'VARS'}->{'probstatus'} eq 'exam') {$form{'problemtype'}='exam';}
    $form{'problem_split'}=$parmhash{'problem_stream_switch'};
    $form{'suppress_tries'}=$parmhash{'suppress_tries'};
    $form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
    $form{'print_discussions'}=$helper->{'VARS'}->{'PRINT_DISCUSSIONS'};
    $form{'print_annotations'}=$helper->{'VARS'}->{'PRINT_ANNOTATIONS'};
    if (($helper->{'VARS'}->{'PRINT_DISCUSSIONS'} eq 'yes') ||
       ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes')) {
       $form{'problem_split'}='yes';
    }
    if ($helper->{'VARS'}->{'curseed'}) {
       $rndseed=$helper->{'VARS'}->{'curseed'};
    }
    $form{'rndseed'}=$rndseed;
    &Apache::lonnet::appenv(\%moreenv);
   
    &Apache::lonxml::clear_problem_counter();
   
    $resources_printed .= $currentURL.':';
    $texversion.=&ssi_with_retries($currentURL,$ssi_retry_count, %form);
   
    #  Add annotations if required:
       
    &Apache::lonxml::clear_problem_counter();
   
    &Apache::lonnet::delenv('request.filename');
       }
       # current document with answers.. no need to encap in minipage
       #  since there's only one answer.
   
       if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
          ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
   
    $form{'problem_split'}=$parmhash{'problem_stream_switch'};
    $form{'grade_target'}='answer';
    $form{'answer_output_mode'}='tex';
    $form{'rndseed'}=$rndseed;
                   if ($helper->{'VARS'}->{'probstatus'} eq 'exam') {
       $form{'problemtype'}='exam';
    }
    $resources_printed .= $currentURL.':';
    my $answer=&ssi_with_retries($currentURL,$ssi_retry_count, %form);
   
   
    if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
       $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
    } else {
       $texversion=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
       if ($helper->{'VARS'}->{'construction'} ne '1') {
    my $title = &Apache::lonnet::gettitle($helper->{'VARS'}->{'symb'});
    $title = &Apache::lonxml::latex_special_symbols($title);
    $texversion.='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
    $texversion.=&path_to_problem($cleanURL,$LaTeXwidth);
       } else {
    $texversion.='\vskip 0 mm \noindent\textbf{'.
                           &mt("Printing from Construction Space: No Title").'}\vskip 0 mm ';
   
    $texversion.=&path_to_problem($cleanURL,$LaTeXwidth);
       }
       $texversion.='\vskip 1 mm '.$answer.'\end{document}';
    }
   
   
   
   
       
       }
       # Print annotations.
   
   
       if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
    my $annotation .= &annotate($currentURL);
    $texversion =~ s/(\\keephidden{ENDOFPROBLEM})/$annotation$1/;
       }
   
   
       if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
    $texversion=&IndexCreation($texversion,$currentURL);
       }
       if ($helper->{'VARS'}->{'CONSTR_RESOURSE_URL'} eq 'yes') {
    $texversion=~s/(\\addcontentsline\{toc\}\{subsection\}\{[^\}]*\})/$1 URL: \\verb|$currentURL| \\strut\\\\\\strut /;
   
       }
       $result .= $texversion;
       if ($currentURL=~m/\.page\s*$/) {
    ($result,$number_of_columns) = &page_cleanup($result);
       }
           } elsif ($cleanURL!~m|^/adm/|
    && $currentURL=~/\.(sequence|page)$/ && $helper->{'VARS'}->{'construction'} eq '1') {
       $result .= &print_construction_sequence($currentURL, $helper, %form,
       $LaTeXwidth);
       $result .= '\end{document}';  
       if (!($result =~ /\\begin\{document\}/)) {
    $result = &print_latex_header() . $result;
       }
       # End construction space sequence.
    } elsif ($cleanURL=~/\/(smppg|syllabus|aboutme|bulletinboard)$/) { 
    $form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
    if ($currentURL=~/\/syllabus$/) {$currentURL=~s/\/res//;}
    $resources_printed .= $currentURL.':';
    my $texversion = &ssi_with_retries($currentURL, $ssi_retry_count, %form);
    if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
       my $annotation = &annotate($currentURL);
       $texversion    =~ s/(\\end{document})/$annotation$1/;
    }
    $result .= $texversion;
    } elsif ($cleanURL =~/\.tex$/) {
       # For this sort of print of a single LaTeX file,
       # We can just print the LaTeX file as it is uninterpreted in any way:
       #
   
       $result = &fetch_raw_resource($currentURL);
       if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
    my $annotation = &annotate($currentURL);
    $result =~ s/(\\end{document})/$annotation$1/;
       }
   
       $do_postprocessing = 0; # Don't massage the result.
   
    } elsif ($cleanURL =~ /\.pdf$/i) {
       $result .= &include_pdf($cleanURL);
       $result .= '\end{document}';
    } elsif ($cleanURL =~ /\.page$/i) { #  Print page in non construction space contexts.
   
       # Determine the set of resources in the map of the page:
   
       my $navmap         =  Apache::lonnavmaps::navmap->new();
       my @page_resources =  $navmap->retrieveResources($cleanURL);
       $result           .=  &print_page_in_course($helper, $rparmhash,
    $cleanURL, \@page_resources);
   
          
    } else {
       $result.=&unsupported($currentURL,$helper->{'VARS'}->{'LATEX_TYPE'},
     $helper->{'VARS'}->{'symb'});
    }
       } elsif (($print_type eq 'map_problems')          or
        ($print_type eq 'map_problems_in_page')  or
        ($print_type eq 'map_resources_in_page') or
                ($print_type eq 'map_problems_pages')    or
                ($print_type eq 'all_problems')          or
        ($print_type eq 'all_resources')         or # BUGBUG
        ($print_type eq 'select_sequences')      or
        ($print_type eq 'map_incomplete_problems_seq')
        ) {
    
           #-- produce an output string
    if (($print_type eq 'map_problems')                or
       ($print_type eq 'map_incomplete_problems_seq') or
       ($print_type eq 'map_problems_in_page') ) {
       $selectionmade = 2;
    } elsif (($print_type eq 'map_problems_pages') or
    ($print_type eq 'map_resources_in_page'))
    {
       $selectionmade = 3;
    } elsif (($print_type eq 'all_problems') 
    ) {
       $selectionmade = 4;
    } elsif ($print_type eq 'all_resources') {  #BUGBUG
       $selectionmade = 4;
    } elsif ($print_type eq 'select_sequences') {
       $selectionmade = 7;
    }
   
    $form{'problem_split'}=$parmhash{'problem_stream_switch'};
    $form{'suppress_tries'}=$parmhash{'suppress_tries'};
    $form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
    $form{'print_discussions'}=$helper->{'VARS'}->{'PRINT_DISCUSSIONS'};
    $form{'print_annotations'} = $helper->{'VARS'}->{'PRINT_ANNOTATIONS'};
    if (($helper->{'VARS'}->{'PRINT_DISCUSSIONS'} eq 'yes')   ||
       ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') ) {
       $form{'problem_split'}='yes';
    }
    my $flag_latex_header_remove = 'NO';
    my $flag_page_in_sequence = 'NO';
    my @master_seq=split /\|\|\|/, $helper->{'VARS'}->{'RESOURCES'};
    my $prevassignment='';
   
    &Apache::lonxml::clear_problem_counter();
   
    my $pbreakresources = keys %page_breaks;
  for (my $i=0;$i<=$#master_seq;$i++) {   for (my $i=0;$i<=$#master_seq;$i++) {
     $_ = $master_seq[$i];  
     m/\"(.*)\"/;      &Apache::lonenc::reset_enc();
             $_ = $1;  
             my $urlp = $1;  
     if ($choice eq 'Standard LaTeX output for the primary sequence') {      # Note due to document structure, not allowed to put \newpage
  if (/\.problem/) {      # prior to the first resource
     my %moreenv;  
     $moreenv{'form.grade_target'}='tex';      if (defined $page_breaks{$master_seq[$i]}) {
     &Apache::lonnet::appenv(%moreenv);   if($i != 0) {
     my $texversion=&Apache::lonnet::ssi($urlp);      $result.="\\newpage\n";
     &Apache::lonnet::delenv('form.grade_target');   }
     $texversion =~ s!\.gif!\.eps!g;      }
     $result .= $texversion;              $result .= &get_extra_vspaces($helper, $master_seq[$i]);
       my ($sequence,$middle_thingy,$urlp)=&Apache::lonnet::decode_symb($master_seq[$i]);
       $urlp=&Apache::lonnet::clutter($urlp);
       $form{'symb'}=$master_seq[$i];
   
       my $assignment=&Apache::lonxml::latex_special_symbols(&Apache::lonnet::gettitle($sequence),'header'); #title of the assignment which contains this problem
   
       if ($selectionmade==7) {$helper->{VARS}->{'assignment'}=$assignment;}
       if ($i==0) {$prevassignment=$assignment;}
       my $texversion='';
       if ($urlp!~m|^/adm/|
    && $urlp=~/\.(problem|exam|quiz|assess|survey|form|library|page|xml|html|htm|xhtml|xhtm)$/) {
    $resources_printed .= $urlp.':';
    &Apache::lonxml::remember_problem_counter();
    if ($flag_latex_header_remove eq 'NO') {
       $texversion.=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});  # RF
                       unless (($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only') ||
                               (($i==0) &&
                                (($urlp=~/\.page$/) ||
                                 ($print_type eq 'map_problems_in_page') ||
                                 ($print_type eq 'map_resources_in_page')))) {
                           $flag_latex_header_remove = 'YES';
                       }
    }
    $texversion.=&ssi_with_retries($urlp, $ssi_retry_count, %form);
    if ($urlp=~/\.page$/) {
       ($texversion,my $number_of_columns_page) = &page_cleanup($texversion);
       if ($number_of_columns_page > $number_of_columns) {$number_of_columns=$number_of_columns_page;} 
       $texversion =~ s/\\end{document}\d*/\\end{document}/;
       $flag_page_in_sequence = 'YES';
    }
   
    if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
      ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
       #  Don't permanently pervert the %form hash
       my %answerform = %form;
       $answerform{'grade_target'}='answer';
       $answerform{'answer_output_mode'}='tex';
       $resources_printed .= $urlp.':';
   
       &Apache::lonxml::restore_problem_counter();
       my $answer=&ssi_with_retries($urlp, $ssi_retry_count, %answerform);
                       if ($urlp =~ /\.page$/) {
                           $answer =~ s/\\end{document}(\d*)$//;
                       }
       if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
                           if ($urlp =~ /\.page$/) {
                               my @probs = split(/\\keephidden{ENDOFPROBLEM}/,$texversion);
                               my $lastprob = pop(@probs);
                               $texversion = join('\keephidden{ENDOFPROBLEM}',@probs).
                               $answer.'\keephidden{ENDOFPROBLEM}'.$lastprob;
                           } else {
                               $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
                           }
       } else {
    if ($urlp=~/$LONCAPA::assess_page_re/) {
       $texversion=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
   #    $texversion =~ s/\\begin{document}//; # FIXME
       my $title = &Apache::lonnet::gettitle($master_seq[$i]);
       $title = &Apache::lonxml::latex_special_symbols($title);
       my $body ='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
       $body   .= &path_to_problem ($urlp,$LaTeXwidth);
       $body   .='\vskip 1 mm '.$answer;
       $body    = &encapsulate_minipage($body);
       $texversion .= $body;
    } else {
       $texversion='';
    }
       }
   
    }
    if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
       my $annotation .= &annotate($urlp);
       $texversion =~ s/(\\keephidden{ENDOFPROBLEM})/$annotation$1/;
    }
   
    if ($flag_latex_header_remove ne 'NO') {
       $texversion = &latex_header_footer_remove($texversion);
    } else {
       $texversion =~ s/\\end{document}//;
    }
    if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
       $texversion=&IndexCreation($texversion,$urlp);
    }
    if (($selectionmade == 4) and ($assignment ne $prevassignment)) {
       my $name = &get_name();
       my $courseidinfo = &get_course();
       $prevassignment=$assignment;
       my $header_text = $parmhash{'print_header_format'};
       $header_text    = &format_page_header($textwidth, $header_text,
     $assignment, 
     $courseidinfo, 
     $name);
       if ($numberofcolumns eq '1') {
    $result .='\newpage \noindent\parbox{\minipagewidth}{\noindent\\lhead{'.$header_text.'}} \vskip 5 mm ';
       } else {
    $result .='\newpage \noindent\parbox{\minipagewidth}{\noindent\\fancyhead[LO]{'.$header_text.'}} \vskip 5 mm ';
       }
    }
    $result .= $texversion;
    $flag_latex_header_remove = 'YES';   
       } elsif ($urlp=~/\/(smppg|syllabus|aboutme|bulletinboard)$/) { 
    $form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
    if ($urlp=~/\/syllabus$/) {$urlp=~s/\/res//;}
    $resources_printed .= $urlp.':';
    my $texversion = &ssi_with_retries($urlp, $ssi_retry_count, %form);
    if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
       my $annotation = &annotate($urlp);
       $texversion =~ s/(\\end{document)/$annotation$1/;
    }
   
    if ($flag_latex_header_remove ne 'NO') {
       $texversion = &latex_header_footer_remove($texversion);
    } else {
       $texversion =~ s/\\end{document}/\\vskip 0\.5mm\\noindent\\makebox\[\\textwidth\/\$number_of_columns\]\[b\]\{\\hrulefill\}/;
    }
    $result .= $texversion;
    $flag_latex_header_remove = 'YES'; 
       } elsif ($urlp=~ /\.pdf$/i) {
    if ($i > 0) {
       $result .= '\cleardoublepage';
    }
                   my $texfrompdf = &include_pdf($urlp);
                   if ($flag_latex_header_remove ne 'NO') {
                       $texfrompdf = &latex_header_footer_remove($texfrompdf);
                   }
                   $result .= $texfrompdf;
    if ($i != $#master_seq) {
       if ($numberofcolumns eq '1') {
    $result .= '\newpage';
       } else {
    # the \\'s seem to be needed to let LaTeX know there's something
    # on the page since LaTeX seems to not like to clear an empty page.
    #
    $result .= '\\ \cleardoublepage';
       }
  }   }
    $flag_latex_header_remove = 'YES';
   
     } else {      } else {
  $moreenv{'form.grade_target'}='tex';   $texversion=&unsupported($urlp,$helper->{'VARS'}->{'LATEX_TYPE'},
  &Apache::lonnet::appenv(%moreenv);   $master_seq[$i]);
  my $texversion=&Apache::lonnet::ssi($urlp);   if ($flag_latex_header_remove ne 'NO') {
  &Apache::lonnet::delenv('form.grade_target');      $texversion = &latex_header_footer_remove($texversion);
  $texversion =~ s!\.gif!\.eps!g;   } else {
  $result .= $texversion;          $texversion =~ s/\\end{document}//;
     }   }
  }   $result .= $texversion;
 #-- additional cleanup for output   $flag_latex_header_remove = 'YES';   
  my $first_app = index($result,'\documentclass',0);      }
  $first_app = index($result,'\documentclass',$first_app+5);      if (&Apache::loncommon::connection_aborted($r)) { 
  while ($first_app != -1) {   last; 
     my $second_app = index($result,'begin{document}',$first_app);  
     $first_app = rindex($result,'\end{document}',$first_app);  
     substr($result,$first_app,$second_app-$first_app+15) = '\vskip 3 mm';  
     $first_app = index($result,'\documentclass',$first_app+5);  
  }  
     }  elsif ($choice eq 'Standard LaTeX output for the top level sequence') {  
  my @master_seq = ();  
  my @add_file_seq = ();  
 #-- where is the main sequence of the course?  
  my $main_seq = '/res/'.$ENV{'request.course.uri'};  
  my $file=&Apache::lonnet::filelocation("",$main_seq);  
  my $filecontents=&Apache::lonnet::getfile($file);  
  my @file_seq = &content_map($filecontents);  
 #-- do we have any other sequence inside?  
  my $i=0;  
  while ($i<=$#file_seq) {  
     $_ = $file_seq[$i];  
     if (/\.sequence$/) {  
  $file = &Apache::lonnet::filelocation("",$file_seq[$i]);  
  $filecontents=&Apache::lonnet::getfile($file);  
  @add_file_seq = &content_map($filecontents);  
  splice(@file_seq,$i,1,@add_file_seq);  
  @add_file_seq = ();  
  $i = -1;  
     }      }
     $i++;  
  }   }
  @master_seq = @file_seq;   &Apache::lonxml::clear_problem_counter();
 #-- produce an output string   if ($flag_page_in_sequence eq 'YES') {
  for (my $i=0;$i<=$#master_seq;$i++) {      $result =~ s/\\usepackage{calc}/\\usepackage{calc}\\usepackage{longtable}/;
     $_ = $master_seq[$i];   }
     m/\"(.*)\"/;   $result .= '\end{document}';
             $_ = $1;       } elsif (($print_type eq 'problems_for_students')           ||
             my $urlp = $1;        ($print_type eq 'problems_for_students_from_page') ||
             if (/\.problem/) {        ($print_type eq 'all_problems_students')           ||
  my %moreenv;        ($print_type eq 'resources_for_students')          ||
  $moreenv{'form.grade_target'}='tex';        ($print_type eq 'incomplete_problems_selpeople_course') ||
  &Apache::lonnet::appenv(%moreenv);        ($print_type eq 'map_incomplete_problems_people_seq')){
  my $texversion=&Apache::lonnet::ssi($urlp);  
  &Apache::lonnet::delenv('form.grade_target');  
  $texversion =~ s!\.gif!\.eps!;       #-- prints assignments for whole class or for selected students  
  $result .= $texversion;           my $type;
     }   if (($print_type eq 'problems_for_students')           ||
  }       ($print_type eq 'problems_for_students_from_page') ||
 #-- additional cleanup for output       ($print_type eq 'all_problems_students')           ||
  my $first_app = index($result,'\documentclass',0);       ($print_type eq 'incomplete_problems_selpeople_course') ||
  $first_app = index($result,'\documentclass',$first_app+5);       ($print_type eq 'map_incomplete_problems_people_seq')) {
  while ($first_app != -1) {       $selectionmade=5;
     my $second_app = index($result,'begin{document}',$first_app);       $type='problems';
     $first_app = rindex($result,'\end{document}',$first_app);   } elsif ($print_type eq 'resources_for_students') {
     substr($result,$first_app,$second_app-$first_app+15) = '\vskip 3 mm';       $selectionmade=8;
     $first_app = index($result,'\documentclass',$first_app+5);       $type='resources';
  }   }
     }   my @students=split /\|\|\|/, $helper->{'VARS'}->{'STUDENTS'};
 #-- corrections for the different page formats   #   The normal sort order is by section then by students within the
     if ($layout eq 'CBI') {   #   section. If the helper var student_sort is 1, then the user has elected
  $result =~ s/\\begin{document}/\\setlength{\\oddsidemargin}{-40pt}\\setlength{\\evensidemargin}{-60pt}\\setlength{\\topmargin}{200pt}\\setlength{\\textwidth}{4\.4in}\\setlength{\\textheight}{6\.8in}\\setlength{\\parindent}{20pt}\\setlength{\\marginparwidth}{90pt}\\setlength{\\textfloatsep}{8pt plus 2\.0pt minus 4\.0pt} \\begin{document}/;   #   to override this and output the students by name.
         $laystyle = 'album';   #    Each element of the students array is of the form:
     } elsif ($layout eq 'CAPA') {   #       username:domain:section:last, first:status
         my $courseidinfo = $ENV{'request.role'};   #    
         $_ = $courseidinfo;   #  Note that student sort is not compatible with printing 
         m/.*\/(.*)/;   #  1 section per pdf...so that setting overrides.
         $courseidinfo = $ENV{'course.physnet_'.$1.'.description'};   #   
  $result =~ s/\\documentclass\[letterpaper\]{article}/\\documentclass\[twocolumn\]{article}/;   if (($helper->{'VARS'}->{'student_sort'}    eq 1)  && 
  $result =~ s/\\begin{document}/\\textheight 25\.9cm\\oddsidemargin = -0\.57in\\evensidemargin = -0\.57in\\textwidth= 7\.7in\\begin{document}\\voffset=-1\.8cm\\setcounter{page}{1}\\noindent\\fbox{\\textbf{$ENV{'environment.firstname'} $ENV{'environment.lastname'}}}\\hskip 1\.4in $courseidinfo \\vskip 5 mm /;       ($helper->{'VARS'}->{'SPLIT_PDFS'} ne "sections")) {
  $result =~ s/\\includegraphics/\\includegraphics\[width=9\.0 cm\]/g;       @students = sort compare_names  @students;
  $result =~ s/(\\end{document})/\\newline\\noindent\\makebox\[9.0cm\]\[b\]{\\hrulefill}\\newline\\noindent\\tiny Dept\. of Physics and Astronomy, MSU\\makebox\[1.0cm\]\[b\]{\\hfill}LON-CAPA\\copyright MSU GNU\/GPS $1/;   } else {
        @students = sort compare_sections @students; 
    }
    &adjust_number_to_print($helper);
   
            if ($helper->{'VARS'}->{'NUMBER_TO_PRINT'} eq '0' ||
        $helper->{'VARS'}->{'NUMBER_TO_PRINT'} eq 'all' ) {
        $helper->{'VARS'}->{'NUMBER_TO_PRINT'}=$#students+1;
    }
    # If we are splitting on section boundaries, we need 
    # to remember that in split_on_sections and 
    # print all of the students in the list.
    #
    my $split_on_sections = 0;
    if ($helper->{'VARS'}->{'NUMBER_TO_PRINT'} eq 'section') {
        $split_on_sections = 1;
        $helper->{'VARS'}->{'NUMBER_TO_PRINT'} = $#students+1;
    }
    my @master_seq=split /\|\|\|/, $helper->{'VARS'}->{'RESOURCES'};
   
            my $map;
            if ($helper->{VARS}->{'symb'}) {
                ($map, my $id, my $resource) =
                    &Apache::lonnet::decode_symb($helper->{VARS}->{'symb'});
            }
   
    #loop over students
   
     my $flag_latex_header_remove = 'NO';
    my %moreenv;
            $moreenv{'instructor_comments'}='hide';
    $moreenv{'textwidth'}=&get_textwidth($helper,$LaTeXwidth);
    $moreenv{'print_discussions'}=$helper->{'VARS'}->{'PRINT_DISCUSSIONS'};
    $moreenv{'print_annotations'} = $helper->{'VARS'}->{'PRINT_ANNOTATIONS'};
    $moreenv{'problem_split'}    = $parmhash{'problem_stream_switch'};
    $moreenv{'suppress_tries'}   = $parmhash{'suppress_tries'};
    if (($helper->{'VARS'}->{'PRINT_DISCUSSIONS'} eq 'yes')  ||
        ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes')) {
        $moreenv{'problem_split'}='yes';
    }
    my %prog_state=&Apache::lonhtmlcommon::Create_PrgWin($r,$#students+1);
    my $student_counter=-1;
    my $i = 0;
    my $last_section = (split(/:/,$students[0]))[2];
    foreach my $person (@students) {
                my $duefile="/home/httpd/prtspool/$env{'user.name'}_$env{'user.domain'}_printout.due";
        if (-e $duefile) {
    my $temp_file = Apache::File->new('>>'.$duefile);
    print $temp_file "1969\n";
        }
        $student_counter++;
        if ($split_on_sections) {
    my $this_section = (split(/:/,$person))[2];
    if ($this_section ne $last_section) {
        $i++;
        $last_section = $this_section;
    }
        } else {
    $i=int($student_counter/$helper->{'VARS'}{'NUMBER_TO_PRINT'});
        }
        my $actual_seq = master_seq_to_person_seq($map, \@master_seq,
                                                          $person);
        my ($output,$fullname, $printed)=&print_resources($r,$helper,
        $person,$type,
        \%moreenv,  $actual_seq,
        $flag_latex_header_remove,
        $LaTeXwidth);
        $resources_printed .= ":";
        $print_array[$i].=$output;
        $student_names[$i].=$person.':'.$fullname.'_END_';
   #     &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,&mt('last student').' '.$fullname);
        &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,'last student');
        $flag_latex_header_remove = 'YES';
        if (&Apache::loncommon::connection_aborted($r)) { last; }
    }
    &Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state);
    $result .= $print_array[0].'  \end{document}';
        } elsif (($print_type eq 'problems_for_anon')      ||
         ($print_type eq 'problems_for_anon_page') ||
         ($print_type eq 'resources_for_anon')  ) { 
    my $cdom =$env{'course.'.$env{'request.course.id'}.'.domain'};
    my $cnum =$env{'course.'.$env{'request.course.id'}.'.num'};
    my $num_todo=$helper->{'VARS'}->{'NUMBER_TO_PRINT_TOTAL'};
    my $code_name=$helper->{'VARS'}->{'ANON_CODE_STORAGE_NAME'};
    my $old_name=$helper->{'VARS'}->{'REUSE_OLD_CODES'};
    my $single_code = $helper->{'VARS'}->{'SINGLE_CODE'};
    my $selected_code = $helper->{'VARS'}->{'CODE_SELECTED_FROM_LIST'};
    my $code_option=$helper->{'VARS'}->{'CODE_OPTION'};
            my @lines = &Apache::grades::get_scantronformat_file();
    my ($code_type,$code_length,$bubbles_per_row)=('letter',6,10);
    foreach my $line (@lines) {
                chomp($line);
        my ($name,$type,$length,$bubbles_per_item) = 
                    (split(/:/,$line))[0,2,4,17];
        if ($name eq $code_option) {
    $code_length=$length;
    if ($type eq 'number') { $code_type = 'number'; }
                    chomp($bubbles_per_item); 
                    if (($bubbles_per_item ne '') && ($bubbles_per_item > 0)) {
                        $bubbles_per_row = $bubbles_per_item; 
                    }
        }
    }
            my ($randomorder,$randompick,$map);
            if ($helper->{VARS}{'symb'}) {
                ($map, my $id, my $resource) =
                    &Apache::lonnet::decode_symb($helper->{VARS}{'symb'});
                my $navmap = Apache::lonnavmaps::navmap->new();
                if (defined($navmap)) {
                    if ($map) {
                        my $mapres = $navmap->getResourceByUrl($map);
                        $randomorder = $mapres->randomorder();
                        $randompick = $mapres->randompick();
                    }
                }
            }
    my %moreenv = ('textwidth' => &get_textwidth($helper,$LaTeXwidth));
    $moreenv{'problem_split'}    = $parmhash{'problem_stream_switch'};
            $moreenv{'instructor_comments'}='hide';
            $moreenv{'bubbles_per_row'} = $bubbles_per_row;
    my $seed=time+($$<<16)+($$);
    my @allcodes;
    if ($old_name) {
        my %result=&Apache::lonnet::get('CODEs',
        [$old_name,"type\0$old_name"],
        $cdom,$cnum);
        $code_type=$result{"type\0$old_name"};
        @allcodes=split(',',$result{$old_name});
        $num_todo=scalar(@allcodes);
    } elsif ($selected_code) { # Selection value is always numeric.
        $num_todo = 1;
        @allcodes = ($selected_code);
    } elsif ($single_code) {
   
        $num_todo    = 1; # Unconditionally one code to do.
        # If an alpha code have to convert to numbers so it can be
        # converted back to letters again :-)
        #
        if ($code_type ne 'number') {
    $single_code = &letters_to_num($single_code);
        }
        @allcodes = ($single_code);
    } else {
        my %allcodes;
        srand($seed);
        for (my $i=0;$i<$num_todo;$i++) {
    $moreenv{'CODE'}=&get_CODE(\%allcodes,$i,$seed,$code_length,
       $code_type);
        }
        if ($code_name) {
    &Apache::lonnet::put('CODEs',
         {
    $code_name =>join(',',keys(%allcodes)),
    "type\0$code_name" => $code_type
         },
         $cdom,$cnum);
        }
        @allcodes=keys(%allcodes);
    }
    my @master_seq=split /\|\|\|/, $helper->{'VARS'}->{'RESOURCES'};
    my ($type) = split(/_/,$print_type);
    &adjust_number_to_print($helper);
    my $number_per_page=$helper->{'VARS'}->{'NUMBER_TO_PRINT'};
    if ($number_per_page eq '0' || $number_per_page eq 'all'
        || $number_per_page eq 'section') {
        $number_per_page=$num_todo > 0 ? $num_todo : 1;
    }
    my $flag_latex_header_remove = 'NO'; 
    my %prog_state=&Apache::lonhtmlcommon::Create_PrgWin($r,$num_todo);
    my $count=0;
    foreach my $code (sort(@allcodes)) {
        my $file_num=int($count/$number_per_page);
        if ($code_type eq 'number') { 
    $moreenv{'CODE'}=$code;
        } else {
    $moreenv{'CODE'}=&num_to_letters($code);
        }
                my $actual_seq = \@master_seq;
                if ($randomorder) {
                    $env{'form.CODE'} = $moreenv{'CODE'};
                    $actual_seq = master_seq_to_person_seq($map, \@master_seq,
                                                           undef,
                                                           $moreenv{'CODE'});
                    delete($env{'form.CODE'});
                }
        my ($output,$fullname, $printed)=
    &print_resources($r,$helper,'anonymous',$type,\%moreenv,
     $actual_seq,$flag_latex_header_remove,
     $LaTeXwidth);
        $resources_printed .= ":";
        $print_array[$file_num].=$output;
        &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,
          &mt('last assignment').' '.$fullname);
        $flag_latex_header_remove = 'YES';
        $count++;
        if (&Apache::loncommon::connection_aborted($r)) { last; }
    }
    &Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state);
    $result .= $print_array[0].'  \end{document}';
        } elsif ($print_type eq 'problems_from_directory') {      
       #prints selected problems from the subdirectory 
    $selectionmade = 6;
           my @list_of_files=split /\|\|\|/, $helper->{'VARS'}->{'FILES'};
    @list_of_files=sort @list_of_files;
    my $flag_latex_header_remove = 'NO'; 
    my $rndseed=time;
    if ($helper->{'VARS'}->{'curseed'}) {
       $rndseed=$helper->{'VARS'}->{'curseed'};
    }
    for (my $i=0;$i<=$#list_of_files;$i++) {
   
       &Apache::lonenc::reset_enc();
   
       my $urlp = $list_of_files[$i];
       $urlp=~s|//|/|;
       if ($urlp=~/\//) {
    $form{'problem_split'}=$parmhash{'problem_stream_switch'};
    $form{'rndseed'}=$rndseed;
    $urlp =~ s|^$Apache::lonnet::perlvar{'lonDocRoot'}||;
    $resources_printed .= $urlp.':';
    my $texversion=&ssi_with_retries($urlp, $ssi_retry_count, %form);
    if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
      ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
       #  Don't permanently pervert %form:
       my %answerform = %form;
       $answerform{'grade_target'}='answer';
       $answerform{'answer_output_mode'}='tex';
       $answerform{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
       $answerform{'rndseed'}=$rndseed;
       $resources_printed .= $urlp.':';
       my $answer=&ssi_with_retries($urlp, $ssi_retry_count, %answerform);
       if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
    $texversion=~s/(\\keephidden{ENDOFPROBLEM})/$answer$1/;
       } else {
    $texversion=&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
    if ($helper->{'VARS'}->{'construction'} ne '1') {
       $texversion.='\vskip 0 mm \noindent ';
       $texversion.=&path_to_problem ($urlp,$LaTeXwidth);
    } else {
       $texversion.='\vskip 0 mm \noindent\textbf{'.
                                            &mt("Printing from Construction Space: No Title").'}\vskip 0 mm ';
       $texversion.=&path_to_problem ($urlp,$LaTeXwidth);
    }
    $texversion.='\vskip 1 mm '.$answer.'\end{document}';
       }
    }
                   #this chunk is responsible for printing the path to problem
   
    my $newurlp=&path_to_problem($urlp,$LaTeXwidth);
    $texversion =~ s/(\\begin{minipage}{\\textwidth})/$1 $newurlp/;
    if ($flag_latex_header_remove ne 'NO') {
       $texversion = &latex_header_footer_remove($texversion);
    } else {
       $texversion =~ s/\\end{document}//;
    }
    if ($helper->{'VARS'}->{'TABLE_INDEX'} eq 'yes') {
       $texversion=&IndexCreation($texversion,$urlp);
    }
    if ($helper->{'VARS'}->{'CONSTR_RESOURSE_URL'} eq 'yes') {
       $texversion=~s/(\\addcontentsline\{toc\}\{subsection\}\{[^\}]*\})/$1 URL: \\verb|$urlp| \\strut\\\\\\strut /;
       
    }
    $result .= $texversion;
       }
       $flag_latex_header_remove = 'YES';  
    }
    if ($helper->{VARS}->{'construction'} eq '1') {$result=~s/(\\typeout)/ RANDOM SEED IS $rndseed $1/;}
    $result .= '\end{document}';      
     }      }
 #-- LaTeX corrections   #-------------------------------------------------------- corrections for the different page formats
     $result =~ s/^\s+$//gm; #remove empty lines  
     $result =~ s/%/\\%/g;   #corrects %      # Only post process if that has not been turned off e.g. by a raw latex resource.
     $result =~ s/(\s)+/$1/g; #removes more than one empty space  
     $result =~ s/\\\\\s*(\\vskip)/ $1/gm;      if ($do_postprocessing) {
    $result = &page_format_transformation($papersize,
         $laystyle,$numberofcolumns,
         $print_type,$result,
         $helper->{VARS}->{'assignment'},
         $helper->{'VARS'}->{'TABLE_CONTENTS'},
         $helper->{'VARS'}->{'TABLE_INDEX'},
         $selectionmade);
    $result = &latex_corrections($number_of_columns,$result,$selectionmade,
        $helper->{'VARS'}->{'ANSWER_TYPE'});
    #if ($numberofcolumns == 1) {
    $result =~ s/\\textwidth\s*=\s*-?\d*\.?\d*\s*(cm|mm|in)/\\textwidth= $helper->{'VARS'}->{'pagesize.width'} $helper->{'VARS'}->{'pagesize.widthunit'} /;
    $result =~ s/\\textheight\s*=?\s*-?\d*\.?\d*\s*(cm|mm|in)/\\textheight $helper->{'VARS'}->{'pagesize.height'} $helper->{'VARS'}->{'pagesize.heightunit'} /;
    $result =~ s/\\evensidemargin\s*=\s*-?\d*\.?\d*\s*(cm|mm|in)/\\evensidemargin= $helper->{'VARS'}->{'pagesize.lmargin'} $helper->{'VARS'}->{'pagesize.lmarginunit'} /;
    $result =~ s/\\oddsidemargin\s*=\s*-?\d*\.?\d*\s*(cm|mm|in)/\\oddsidemargin= $helper->{'VARS'}->{'pagesize.lmargin'} $helper->{'VARS'}->{'pagesize.lmarginunit'} /;
    #}
       }
   
       # Set URLback if this is a construction space print so we can provide
       # a link to the resource being edited.
       #
   
       my $URLback=''; #link to original document
       if ($helper->{'VARS'}->{'construction'} eq '1') {
    $URLback=$helper->{'VARS'}->{'filename'};
       }
       #
       # Final adjustment of the font size:
       #
   
       $result = set_font_size($result);
   
       # Insert any babel headers required.
   
       $result       = &collect_languages($result);
   
   
 #-- writing .tex file in prtspool   #-- writing .tex file in prtspool 
     my $temp_file;      my $temp_file;
     $filename = "/home/httpd/prtspool/$ENV{'user.name'}$ENV{'user.domain'}temp$ENV{'user.login.time'}.tex";      my $identifier = &Apache::loncommon::get_cgi_id();
     unless ($temp_file = Apache::File->new('>'.$filename)) {      my $filename = "/home/httpd/prtspool/$env{'user.name'}_$env{'user.domain'}_printout_$identifier.tex";
  $r->log_error("Couldn't open $filename for output $!");      if (!($#print_array>0)) { 
  return SERVER_ERROR;          unless ($temp_file = Apache::File->new('>'.$filename)) {
     }     $r->log_error("Couldn't open $filename for output $!");
     print $temp_file $result;    return SERVER_ERROR; 
 $r->print(<<FINALEND);         }
 <meta http-equiv="Refresh" content="0; url=/cgi-bin/printout.pl?$filename&$laystyle">         print $temp_file $result;
 </body>         my $begin=index($result,'\begin{document}',0);
 </html>         my $inc=substr($result,0,$begin+16); 
       } else {
          my $begin=index($result,'\begin{document}',0);
          my $inc=substr($result,0,$begin+16);
          for (my $i=0;$i<=$#print_array;$i++) {
     if ($i==0) {
         $print_array[$i]=$result;
     } else {
         $print_array[$i].='\end{document}';
         $print_array[$i] = 
    &latex_corrections($number_of_columns,$print_array[$i],
      $selectionmade, 
      $helper->{'VARS'}->{'ANSWER_TYPE'});
       
         my $anobegin=index($print_array[$i],'\setcounter{page}',0);
         substr($print_array[$i],0,$anobegin)='';
         $print_array[$i]=$inc.$print_array[$i];
     }
     my $temp_file;
     my $newfilename=$filename;
     my $num=$i+1;
     $newfilename =~s/\.tex$//; 
     $newfilename=sprintf("%s_%03d.tex",$newfilename, $num);
     unless ($temp_file = Apache::File->new('>'.$newfilename)) {
         $r->log_error("Couldn't open $newfilename for output $!");
         return SERVER_ERROR; 
     }
     print $temp_file $print_array[$i];
          }
       }
       my $student_names='';
       if ($#print_array>0) {
           for (my $i=0;$i<=$#print_array;$i++) {
      $student_names.=$student_names[$i].'_ENDPERSON_';
    }
       } else {
    if ($#student_names>-1) {
      $student_names=$student_names[0].'_ENDPERSON_';
    } else {
              my $fullname = &get_name($env{'user.name'},$env{'user.domain'});
      $student_names=join(':',$env{'user.name'},$env{'user.domain'},
       $env{'request.course.sec'},$fullname).
    '_ENDPERSON_'.'_END_';
    }
        }
   
        # logic for now is too complex to trace if this has been defined
        #  yet.
        my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
        my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
        &Apache::lonnet::appenv({'cgi.'.$identifier.'.file'   => $filename,
    'cgi.'.$identifier.'.layout'  => $laystyle,
    'cgi.'.$identifier.'.numcol'  => $numberofcolumns,
    'cgi.'.$identifier.'.paper'  => $papersize,
    'cgi.'.$identifier.'.selection' => $selectionmade,
    'cgi.'.$identifier.'.tableofcontents' => $helper->{'VARS'}->{'TABLE_CONTENTS'},
    'cgi.'.$identifier.'.tableofindex' => $helper->{'VARS'}->{'TABLE_INDEX'},
    'cgi.'.$identifier.'.role' => $perm{'pav'},
    'cgi.'.$identifier.'.numberoffiles' => $#print_array,
    'cgi.'.$identifier.'.studentnames' => $student_names,
    'cgi.'.$identifier.'.backref' => $URLback,});
       &Apache::lonnet::appenv({"cgi.$identifier.user"    => $env{'user.name'},
    "cgi.$identifier.domain"  => $env{'user.domain'},
    "cgi.$identifier.courseid" => $cnum, 
    "cgi.$identifier.coursedom" => $cdom, 
    "cgi.$identifier.resources" => $resources_printed});
   
       my $end_page = &Apache::loncommon::end_page();
       my $continue_text = &mt('Continue');
       # If there's been an unrecoverable SSI error, report it to the user
       if ($ssi_error) {
           my $helpurl = &Apache::loncommon::top_nav_help('Helpdesk');
           $r->print('<br /><p class="LC_error">'.&mt('An unrecoverable network error occurred:').'</p><p>'.
                     &mt('At least one of the resources you chose to print could not be rendered due to an unrecoverable error when communicating with a server:').
                     '<br />'.$ssi_last_error_resource.'<br />'.$ssi_last_error.
                     '</p><p>'.&mt('You can continue using the link provided below, but make sure to carefully inspect your output file! The errors will be marked in the file.').'<br />'.
                     &mt('You may be able to reprint the individual resources for which this error occurred, as the issue may be temporary.').
                     '<br />'.&mt('If the error persists, please contact the [_1] for assistance.',$helpurl).'</p><p>'.
                     &mt('We apologize for the inconvenience.').'</p>'.
                     '<a href="/cgi-bin/printout.pl?'.$identifier.'">'.$continue_text.'</a>'.$end_page);
       } else {
    $r->print(<<FINALEND);
   <br />
   <meta http-equiv="Refresh" content="0; url=/cgi-bin/printout.pl?$identifier" />
   <a href="/cgi-bin/printout.pl?$identifier">$continue_text</a>
   $end_page
 FINALEND  FINALEND
       }                                     # endif ssi errors.
 }  }
   
   
   sub get_CODE {
       my ($all_codes,$num,$seed,$size,$type)=@_;
       my $max='1'.'0'x$size;
       my $newcode;
       while(1) {
    $newcode=sprintf("%0".$size."d",int(rand($max)));
    if (!exists($$all_codes{$newcode})) {
       $$all_codes{$newcode}=1;
       if ($type eq 'number' ) {
    return $newcode;
       } else {
    return &num_to_letters($newcode);
       }
    }
       }
   }
   
   sub print_resources {
       my ($r,$helper,$person,$type,$moreenv,$master_seq,$remove_latex_header,
    $LaTeXwidth)=@_;
       my $current_output = ''; 
       my $printed = '';
       my ($username,$userdomain,$usersection) = split /:/,$person;
       my $fullname = &get_name($username,$userdomain);
       my $namepostfix = "\\\\"; # Both anon and not anon should get the same vspace.
   
   
 sub content_map {      #
 #-- find a list of files to print      # Figure out if we need to filter the output by
     my $map_string = shift;      # the incomplete problems for that person
     my @number_seq = ();      #
     my @file_seq = ();      my $print_type = $helper->{'VARS'}->{'PRINT_TYPE'};
     my $startlink = index($map_string,'<link',0);      my $print_incomplete = 0;
     my $endlink = index($map_string,'</link>',$startlink);      if (($print_type eq 'map_incomplete_problems_people_seq')   ||
     my $chunk = substr($map_string,$startlink,$endlink-$startlink+7);   ($print_type eq 'incomplete_problems_selpeople_course')) {
     $_ = $chunk;   $print_incomplete = 1;
     m/from=\"(\d+)\"/;      }
     push @number_seq,$1;      if ($person eq 'anonymous') {
     while ($startlink != -1) {   $namepostfix .=&mt('Name:')." ";
  $endlink = index($map_string,'</link>',$startlink);   $fullname = "CODE - ".$moreenv->{'CODE'};
  $chunk = substr($map_string,$startlink,$endlink-$startlink+7);      }
  substr($map_string,$startlink,$endlink-$startlink+7) = '';  
  $_ = $chunk;      #  Fullname may have special latex characters that need \ prefixing:
         m/to=\"(\d+)\"/;      #
  push @number_seq,$1;  
  $startlink = index($map_string,'from="'.$1.'"',$startlink);      my $i           = 0;
  $startlink = rindex($map_string,'<link ',$startlink);      my $actually_printed = 0; # Count of resources printed.
     }      #goes through all resources, checks if they are available for 
     my $stalink = index($map_string,' to="'.$number_seq[0].'"',$startlink);      #current student, and produces output   
     while ($stalink != -1) {  
  $startlink = rindex($map_string,'<link ',$stalink);      &Apache::lonxml::clear_problem_counter();
  $endlink = index($map_string,'</link>',$startlink);      my %page_breaks  = &get_page_breaks($helper);
  $chunk = substr($map_string,$startlink,$endlink-$startlink+7);      my $columns_in_format = (split(/\|/,$helper->{'VARS'}->{'FORMAT'}))[1];
  substr($map_string,$startlink,$endlink-$startlink+7) = '';      #
  $_ = $chunk;      #   end each student with a 
         m/from=\"(\d+)\"/;      #   Special that allows the post processor to even out the page
  unshift @number_seq,$1;      #   counts later.  Nasty problem this... it would be really
  $stalink = index($map_string,' to="'.$number_seq[0].'"',0);      #   nice to put the special in as a postscript comment
     }      #   e.g. \special{ps:\ENDOFSTUDENTSTAMP}  unfortunately,
     for (my $i=0;$i<=$#number_seq;$i++) {      #   The special gets passed the \ and dvips puts it in the output file
  $stalink = index($map_string,' id="'.$number_seq[$i].'"',0);      #   so we will just rely on prntout.pl to strip  ENDOFSTUDENTSTAMP from the
         {          #   postscript.  Each ENDOFSTUDENTSTAMP will go on a line by itself.
     my $ahed1 = index($map_string,'src="',$stalink);      #
     my $ahed2 = index($map_string,'</resource>',$stalink);  
     if ($ahed1 != -1) {      my $syllabus_first = 0;
  if ($ahed1 < $ahed2) {      my $current_assignment = "";
     $startlink = $ahed1;      my $assignment;
       my $courseidinfo = &get_course();
   
       foreach my $curresline (@{$master_seq})  {
    if (defined $page_breaks{$curresline}) {
       if($i != 0) {
    $current_output.= "\\newpage\n";
       }
    }
    $current_output .= &get_extra_vspaces($helper, $curresline);
    $i++;
    my ($map,$id,$res_url) = &Apache::lonnet::decode_symb($curresline);
   
    # See if we need to emit a new header:
   
    if ( !($type eq 'problems' && 
          ($curresline!~ m/$LONCAPA::assess_page_re/)) ) {
       if ($print_incomplete && !&incomplete($username, $userdomain, $res_url)) {
    next;
       }
       $actually_printed++; # we're going to print one.
       if (&Apache::lonnet::allowed('bre',$res_url)) {
    if ($res_url!~m|^ext/|
       && $res_url=~/\.(problem|exam|quiz|assess|survey|form|library|page|xml|html|htm|xhtml|xhtm)$/) {
       $printed .= $curresline.':';
       &Apache::lonxml::remember_problem_counter();    
   
       my $rendered = &get_student_view_with_retries($curresline,$ssi_retry_count,$username,$userdomain,$env{'request.course.id'},'tex',$moreenv);
                       if ($res_url =~ /\.page$/) {
                           if ($remove_latex_header eq 'NO') {
                               if (!($rendered =~ /\\begin\{document\}/)) {
                                   $rendered = &print_latex_header().$rendered;
                               }
                           }
   ;
                           if ($remove_latex_header eq 'YES') {
                               $rendered = &latex_header_footer_remove($rendered);
                           } else {
                               $rendered =~ s/\\end{document}\d*//;
                           }
                       }
       if(($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') ||
          ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only')) {
    #   Use a copy of the hash so we don't pervert it on future loop passes.
    my %answerenv = %{$moreenv};
    $answerenv{'answer_output_mode'}='tex';
   
   
    $answerenv{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
   
    &Apache::lonxml::restore_problem_counter();
   
    my $ansrendered = &Apache::loncommon::get_student_answers($curresline,$username,$userdomain,$env{'request.course.id'},%answerenv);
   
    if ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'no') {
       $rendered=~s/(\\keephidden{ENDOFPROBLEM})/$ansrendered$1/;
    } else {
   
       
       my $header =&print_latex_header($helper->{'VARS'}->{'LATEX_TYPE'});
                               unless ($helper->{'VARS'}->{'ANSWER_TYPE'} eq 'only') {
                                   $header =~ s/\\begin{document}//;     #<<<<<
                               }
       my $title = &Apache::lonnet::gettitle($curresline);
       $title = &Apache::lonxml::latex_special_symbols($title);
       my $body   ='\vskip 0 mm \noindent\textbf{'.$title.'}\vskip 0 mm ';
       $body     .=&path_to_problem($res_url,$LaTeXwidth);
       $body     .='\vskip 1 mm '.$ansrendered;
       $body     = &encapsulate_minipage($body);
       $rendered = $header.$body;
    }
       }
       if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
    my $url = &Apache::lonnet::clutter($res_url);
    my $annotation = &annotate($url);
    $rendered =~  s/(\\keephidden{ENDOFPROBLEM})/$annotation$1/;
       }
       my $junk;
       if ($remove_latex_header eq 'YES') {
    $rendered = &latex_header_footer_remove($rendered);
       } else {
    $rendered =~ s/\\end{document}//;
       }
       $current_output .= $rendered;    
    } elsif ($res_url=~/\/(smppg|syllabus|aboutme|bulletinboard)$/) {
       if ($i == 1) {
    $syllabus_first = 1;
       }
       $printed .= $curresline.':';
       my $rendered = &get_student_view_with_retries($curresline,$ssi_retry_count,$username,$userdomain,$env{'request.course.id'},'tex',$moreenv);
       if ($helper->{'VARS'}->{'PRINT_ANNOTATIONS'} eq 'yes') {
    my $url = &Apache::lonnet::clutter($res_url);
    my $annotation = &annotate($url);
    $annotation    =~ s/(\\end{document})/$annotation$1/;
       }
       if ($remove_latex_header eq 'YES') {
    $rendered = &latex_header_footer_remove($rendered);
       } else {
    $rendered =~ s/\\end{document}//;
       }
       $current_output .= $rendered.'\vskip 0.5mm\noindent\makebox[\textwidth/$number_of_columns][b]{\hrulefill}\strut \vskip 0 mm \strut ';
    } elsif($res_url = ~/\.pdf$/) {
       my $url = &Apache::lonnet::clutter($res_url);
       my $rendered  = &include_pdf($url);
       if ($remove_latex_header ne 'NO') {
    $rendered = &latex_header_footer_remove($rendered);
       }
       $current_output .= $rendered;
  } else {   } else {
     $startlink = rindex($map_string,'src="',$stalink);      my $rendered = &unsupported($res_url,$helper->{'VARS'}->{'LATEX_TYPE'},$curresline);
       if ($remove_latex_header ne 'NO') {
    $rendered = &latex_header_footer_remove($rendered);
       } else {
    $rendered =~ s/\\end{document}//;
       }
       $current_output .= $rendered;
  }   }
     } else {  
  $startlink = rindex($map_string,'src="',$stalink);  
     }      }
       $remove_latex_header = 'YES';
    }
    $assignment = &Apache::lonxml::latex_special_symbols(
       &Apache::lonnet::gettitle($map), 'header');
    if (($assignment ne $current_assignment) && ($assignment ne "")) {
       my $header_line = &format_page_header($LaTeXwidth, $parmhash{'print_header_format'},
     $assignment, $courseidinfo, 
     $fullname, $usersection);
       my $header_start = ($columns_in_format == 1) ? '\lhead'
    : '\fancyhead[LO]';
       $header_line = $header_start.'{'.$header_line.'}';
       $current_output = $current_output . $header_line;
       $current_assignment = $assignment;
    }
   
    if (&Apache::loncommon::connection_aborted($r)) { last; }
       }
       # If we are printing incomplete it's possible we don't have
       # anything to print.  The print subsystem is not so good at handling
       # that so we're going to generate a stub that says there are no
       # incomplete resources for the person.
       #
   
       if ($actually_printed == 0) {
    $current_output  = &encapsulate_minipage("\\vskip -10mm \nNo incomplete resources\n \\vskip 100 mm { }\n");
    if ($remove_latex_header eq "NO") {
       $current_output = &print_latex_header() . $current_output;
    } else {
       $current_output = &latex_header_footer_remove($current_output);
  }   }
  $startlink = index($map_string,'"',$startlink);  
  $endlink = index($map_string,'"',$startlink+1);  
  $chunk = substr($map_string,$startlink,$endlink-$startlink+1);  
  push @file_seq,$chunk;  
     }      }
     return @file_seq;  
 }  
   
       if ($syllabus_first) {
           $current_output =~ s/\\\\ Last updated:/Last updated:/
       }
       if (0) {
    my $currentassignment=&Apache::lonxml::latex_special_symbols($helper->{VARS}->{'assignment'},'header');
    my $header_line =
       &format_page_header($LaTeXwidth, $parmhash{'print_header_format'},
    $currentassignment, $courseidinfo, $fullname, $usersection);
    my $header_start = ($columns_in_format == 1) ? '\lhead'
       : '\fancyhead[LO]';
    $header_line = $header_start.'{'.$header_line.'}';
       }
       if ($current_output=~/\\documentclass/) {
   # $current_output =~ s/\\begin{document}/\\setlength{\\topmargin}{1cm} \\begin{document}\\noindent\\parbox{\\minipagewidth}{\\noindent$header_line$namepostfix}\\vskip 5 mm /;
    $current_output =~ s/\\begin{document}/\\setlength{\\topmargin}{1cm} \\begin{document}\\noindent\\parbox{\\minipagewidth}{\\noindent$namepostfix}\\vskip 5 mm /;
   
       } else {
    my $blankpages = 
       '\clearpage\strut\clearpage'x$helper->{'VARS'}->{'EMPTY_PAGES'};
   
   # $current_output = '\strut\vspace*{-6 mm}\\newline'.
   #    &copyright_line().' \newpage '.$blankpages.$end_of_student.
   #    '\setcounter{page}{1}\noindent\parbox{\minipagewidth}{\noindent'.
   #    $header_line.$namepostfix. '} \vskip 5 mm '.$current_output;
    $current_output = '\strut\vspace*{-6 mm}\\newline'.
       &copyright_line().' \newpage '.$blankpages.$end_of_student.
       '\setcounter{page}{1}\noindent\parbox{\minipagewidth}{\noindent'
       .$namepostfix. '} \vskip 5 mm '.$current_output;
   
       }
       #
       #  Close the student bracketing.
       #
       return ($current_output,$fullname, $printed);
   
   }
   
   sub printing_blocked {
       my ($r,$blocktext) = @_;
       my $title = &mt('Preparing Printout');
       &Apache::lonhtmlcommon::clear_breadcrumbs();
       &Apache::lonhtmlcommon::add_breadcrumb({href=>'/adm/printout',
                                               text=> $title});
       my $breadcrumbs = &Apache::lonhtmlcommon::breadcrumbs($title);
       &Apache::loncommon::content_type($r,'text/html');
       &Apache::loncommon::no_cache($r);
       $r->send_http_header;
       $r->print(&Apache::loncommon::start_page('Preparing Printout').
                 $breadcrumbs.
                 $blocktext.
                 &Apache::loncommon::end_page());
       return;
   }
   
 sub handler {  sub handler {
   
     my $r = shift;      my $r = shift;
     $r->content_type('text/html');  
       if ($env{'request.course.id'}) {
           my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
           my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
           my ($blocked,$blocktext) = 
               &Apache::loncommon::blocking_status('printout',$cnum,$cdom);
           if ($blocked) {
               my $checkrole = "cm./$cdom/$cnum";
               if ($env{'request.course.sec'} ne '') {
                   $checkrole .= "/$env{'request.course.sec'}";
               }
               unless ((&Apache::lonnet::allowed('evb',undef,undef,$checkrole)) && 
                       ($env{'request.role'} !~ m{^st\./$cdom/$cnum})) {
                   &printing_blocked($r,$blocktext);
                   return OK;
               }
           }
       }
       
       &init_perm();
       my $helper = printHelper($r);
       if (!ref($helper)) {
    return $helper;
       }
      
   
       %parmhash=&Apache::lonnet::coursedescription($env{'request.course.id'});
    
   
   
   
       #  If a figure conversion queue file exists for this user.domain
       # we delete it since it can only be bad (if it were good, printout.pl
       # would have deleted it the last time around.
   
       my $conversion_queuefile = "/home/httpd/prtspool/$env{'user.name'}_$env{'user.domain'}_printout.dat";
       if(-e $conversion_queuefile) {
    unlink $conversion_queuefile;
       }
       
   
       &output_data($r,$helper,\%parmhash);
       return OK;
   }
   
   use Apache::lonhelper;
   
   sub addMessage {
       my $text = shift;
       my $paramHash = Apache::lonhelper::getParamHash();
       $paramHash->{MESSAGE_TEXT} = $text;
       Apache::lonhelper::message->new();
   }
   
   
   
   sub init_perm {
       undef(%perm);
       $perm{'pav'}=&Apache::lonnet::allowed('pav',$env{'request.course.id'});
       if (!$perm{'pav'}) {
    $perm{'pav'}=&Apache::lonnet::allowed('pav',
     $env{'request.course.id'}.'/'.$env{'request.course.sec'});
       }
       $perm{'pfo'}=&Apache::lonnet::allowed('pfo',$env{'request.course.id'});
       if (!$perm{'pfo'}) {
    $perm{'pfo'}=&Apache::lonnet::allowed('pfo',
     $env{'request.course.id'}.'/'.$env{'request.course.sec'});
       }
       $perm{'vgr'}=&Apache::lonnet::allowed('vgr',$env{'request.course.id'});
       if (!$perm{'vgr'}) {
           $perm{'vgr'}=&Apache::lonnet::allowed('vgr',
                      $env{'request.course.id'}.'/'.$env{'request.course.sec'});
       }
   }
   
   sub get_randomly_ordered_warning {
       my ($helper,$map) = @_;
   
       my $message;
   
       my $postdata = $env{'form.postdata'} || $helper->{VARS}{'postdata'};
       my $navmap = Apache::lonnavmaps::navmap->new();
       if (defined($navmap)) {
           my $res = $navmap->getResourceByUrl($map);
           if ($res) {
       my $func = 
           sub { return ($_[0]->is_map() && $_[0]->randomorder); };
       my @matches = $navmap->retrieveResources($res, $func,1,1,1);
   
           }
       } else {
           $message = "Retrieval of information about ordering of resources failed."; 
           return '<message type="warning">'.$message.'</message>';
       }
       return;
   }
   
   sub printHelper {
       my $r = shift;
   
       if ($r->header_only) {
           if ($env{'browser.mathml'}) {
               &Apache::loncommon::content_type($r,'text/xml');
           } else {
               &Apache::loncommon::content_type($r,'text/html');
           }
           $r->send_http_header;
           return OK;
       }
   
       # Send header, nocache
       if ($env{'browser.mathml'}) {
           &Apache::loncommon::content_type($r,'text/xml');
       } else {
           &Apache::loncommon::content_type($r,'text/html');
       }
       &Apache::loncommon::no_cache($r);
     $r->send_http_header;      $r->send_http_header;
       $r->rflush();
   
       # Unfortunately, this helper is so complicated we have to
       # write it by hand
   
       Apache::loncommon::get_unprocessed_cgi($ENV{QUERY_STRING});
       
       my $helper = Apache::lonhelper::helper->new("Printing Helper");
       $helper->declareVar('symb');
       $helper->declareVar('postdata');    
       $helper->declareVar('curseed'); 
       $helper->declareVar('probstatus');   
       $helper->declareVar('filename');
       $helper->declareVar('construction');
       $helper->declareVar('assignment');
       $helper->declareVar('style_file');
       $helper->declareVar('student_sort');
       $helper->declareVar('FINISHPAGE');
       $helper->declareVar('PRINT_TYPE');
       $helper->declareVar("showallfoils");
       $helper->declareVar("STUDENTS");
       $helper->declareVar("EXTRASPACE");
   
      
   
   
       #  The page breaks and extra spaces
       #  can get loaded initially from the course environment:
       # But we only do this in the initial state so that they are allowed to change.
       #
   
       
       &Apache::loncommon::restore_course_settings('print',
    {'pagebreaks'  => 'scalar',
    'extraspace'  => 'scalar',
    'extraspace_units' => 'scalar',
            'lastprinttype' => 'scalar'});
       
       # This will persistently load in the data we want from the
       # very first screen.
       
       if($helper->{VARS}->{PRINT_TYPE} eq $env{'form.lastprinttype'}) {
    if (!defined ($env{"form.CURRENT_STATE"})) {
       
       $helper->{VARS}->{FINISHPAGE} = $env{'form.pagebreaks'};
       $helper->{VARS}->{EXTRASPACE} = $env{'form.extraspace'};
       $helper->{VARS}->{EXTRASPACE_UNITS} = $env{'form.extraspace_units'};
    } else {
       my $state = $env{"form.CURRENT_STATE"};
       if ($state eq "START") {
    $helper->{VARS}->{FINISHPAGE} = $env{'form.pagebreaks'};
    $helper->{VARS}->{EXTRASPACE} = $env{'form.extraspace'};
    $helper->{VARS}->{EXTRASPACE_UNITS} = $env{'form.extraspace_units'};
   
       }
    }
   
       }
   
       # Detect whether we're coming from construction space
       if ($env{'form.postdata'}=~m{^/priv}) {
           $helper->{VARS}->{'filename'} = $env{'form.postdata'};
           $helper->{VARS}->{'construction'} = 1;
       } else {
           if ($env{'form.postdata'}) {
               $helper->{VARS}->{'symb'} = &Apache::lonnet::symbread($env{'form.postdata'});
       if ( $helper->{VARS}->{'symb'} eq '') {
    $helper->{VARS}->{'postdata'} = $env{'form.postdata'};
       }
           }
           if ($env{'form.symb'}) {
               $helper->{VARS}->{'symb'} = $env{'form.symb'};
           }
           if ($env{'form.url'}) {
               $helper->{VARS}->{'symb'} = &Apache::lonnet::symbread($helper->{VARS}->{'postdata'});
           }
   
       }
   
       if ($env{'form.symb'}) {
           $helper->{VARS}->{'symb'} = $env{'form.symb'};
       }
       if ($env{'form.url'}) {
           $helper->{VARS}->{'symb'} = &Apache::lonnet::symbread($helper->{VARS}->{'postdata'});
   
       }
       $helper->{VARS}->{'symb'}=
    &Apache::lonenc::check_encrypt($helper->{VARS}->{'symb'});
       my ($resourceTitle,$sequenceTitle,$mapTitle) = &details_for_menu($helper);
       if ($sequenceTitle ne '') {$helper->{VARS}->{'assignment'}=$sequenceTitle;}
   
       
       # Extract map
       my $symb = $helper->{VARS}->{'symb'};
       my ($map, $id, $url);
       my $subdir;
       my $is_published=0; # True when printing from resource space.
       my $res_printable = 1; # By default the current resource is printable.    
       my $userCanPrint = ($perm{'pav'} || $perm{'pfo'});
       my $res_printstartdate;
       my $res_printenddate;
       my $map_open = 0;
       my $map_close = 0xffffffff;
       my $course_open = 0;
       my $course_close = 0xffffffff;
   
       # Get the resource name from construction space
       if ($helper->{VARS}->{'construction'}) {
           $resourceTitle = substr($helper->{VARS}->{'filename'}, 
                                   rindex($helper->{VARS}->{'filename'}, '/')+1);
           $subdir = substr($helper->{VARS}->{'filename'},
                            0, rindex($helper->{VARS}->{'filename'}, '/') + 1);
       } else {
    # From course space:
   
    if ($symb ne '') {
       ($map, $id, $url) = &Apache::lonnet::decode_symb($symb);
       $helper->{VARS}->{'postdata'} = 
    &Apache::lonenc::check_encrypt(&Apache::lonnet::clutter($url));
       my $navmap = Apache::lonnavmaps::navmap->new();
       my $res   = $navmap->getBySymb($symb);
       $res_printable  = $res->resprintable() | $userCanPrint; #printability in course context
       ($res_printstartdate, $res_printenddate) = &get_print_dates($res);
       ($course_open, $course_close) = &course_print_dates($res);
       ($map_open, $map_close)       = &map_print_dates($res);
   
    } else {
       # Resource space.
   
       $url = $helper->{VARS}->{'postdata'};
       $is_published=1; # From resource space.
    }
    $url = &Apache::lonnet::clutter($url);
           if (!$resourceTitle) { # if the resource doesn't have a title, use the filename
               my $postdata = $helper->{VARS}->{'postdata'};
               $resourceTitle = substr($postdata, rindex($postdata, '/') + 1);
           }
           $subdir = &Apache::lonnet::filelocation("", $url);
   
   
       }
       if (!$helper->{VARS}->{'curseed'} && $env{'form.curseed'}) {
    $helper->{VARS}->{'curseed'}=$env{'form.curseed'};
       }
   
       if (!$helper->{VARS}->{'probstatus'} && $env{'form.problemtype'}) {
    $helper->{VARS}->{'probstatus'}=$env{'form.problemstatus'};
       }
   
       my $userCanSeeHidden = Apache::lonnavmaps::advancedUser();
   
       Apache::lonhelper::registerHelperTags();
   
       # "Delete everything after the last slash."
       $subdir =~ s|/[^/]+$||;
   
       # What can be printed is a very dynamic decision based on
       # lots of factors. So we need to dynamically build this list.
       # To prevent security leaks, states are only added to the wizard
       # if they can be reached, which ensures manipulating the form input
       # won't allow anyone to reach states they shouldn't have permission
       # to reach.
   
       # printChoices is tracking the kind of printing the user can
       # do, and will be used in a choices construction later.
       # In the meantime we will be adding states and elements to
       # the helper by hand.
       my $printChoices = [];
       my $paramHash;
   
       # If there is a current resource and it is printable
       # Give that as a choice.
   
       if ($resourceTitle && $res_printable) {
           push @{$printChoices}, ["<b><i>$resourceTitle</i></b> (".&mt('the resource you just saw on the screen').")", 'current_document', 'PAGESIZE'];
       } 
   
       # Useful filter strings
   
       my $isPrintable = ' && $res->resprintable()';
   
       my $isProblem = '(($res->is_problem()||$res->contains_problem() ||$res->is_practice()))';
       $isProblem .= $isPrintable unless $userCanPrint;
       $isProblem .= ' && !$res->randomout()' if !$userCanSeeHidden;
       my $isProblemOrMap = '($res->is_problem() || $res->contains_problem() || $res->is_sequence() || $res->is_practice())';
       $isProblemOrMap .= $isPrintable unless $userCanPrint;
       my $isNotMap = '(!$res->is_sequence())';
       $isNotMap .= $isPrintable unless $userCanPrint;
       $isNotMap .= ' && !$res->randomout()' if !$userCanSeeHidden;
       my $isMap = '$res->is_map()';
       $isMap .= $isPrintable unless $userCanPrint;
       my $symbFilter = '$res->shown_symb() ';
       my $urlValue = '$res->link()';
   
       $helper->declareVar('SEQUENCE');
   
       # If we're in a sequence...
   
       my $start_new_option;
       if ($perm{'pav'}) {
    $start_new_option = 
       "<option text='".&mt('Start new page<br />before selected').
       "' variable='FINISHPAGE' />".
       "<option text='".&mt('Extra space<br />before selected').
       "' variable='EXTRASPACE' type='text' />" .
       "<option " .
       "' variable='POSSIBLE_RESOURCES' type='hidden' />".
       "<option text='".&mt('Space units<br />check for mm').
       "' variable='EXTRASPACE_UNITS' type='checkbox' />"
       ;
       
   
       }
   
       # If not construction space user can print the components of a page:
   
       my $page_ispage;
       my $page_title;
       if (!$helper->{VARS}->{'construction'}) {
    my $varspostdata = $helper->{VARS}->{'postdata'};
    my $varsassignment = $helper->{VARS}->{'assignment'};
    my $page_navmap         = Apache::lonnavmaps::navmap->new();
    if (defined($page_navmap)) {
       my @page_resources      = $page_navmap->retrieveResources($url);
       if(defined($page_resources[0])) {
    $page_ispage       = $page_resources[0]->is_page();
    $page_title     = $page_resources[0]->title();
    my $resourcesymb   = $page_resources[0]->symb();
    my ($pagemap, $pageid, $pageurl) = &Apache::lonnet::decode_symb($symb);
    if ($page_ispage) {
       push @{$printChoices}, 
       [&mt('Selected [_1]Problems[_2] from page [_3]', '<b>', '</b>', '<b><i>'.$page_title.'</i></b>'), 
        'map_problems_in_page', 
        'CHOOSE_PROBLEMS_PAGE'];
       push @{$printChoices}, 
       [&mt('Selected [_1]Resources[_2] from page [_3]', '<b>', '</b>', '<b><i>'.$page_title.'</i></b>'), 
        'map_resources_in_page', 
        'CHOOSE_RESOURCES_PAGE'];
    }
           my $helperFragment = &generate_resource_chooser('CHOOSE_PROBLEMS_PAGE',
    'Select Problem(s) to print',
    "multichoice='1' toponly='1' addstatus='1' closeallpages='1'",
    'RESOURCES',
    'PAGESIZE',
    $url,
    $isProblem, '',  $symbFilter,
    $start_new_option);
   
   
         $helperFragment .= &generate_resource_chooser('CHOOSE_RESOURCES_PAGE',
       'Select Resource(s) to print',
       'multichoice="1" toponly="1" addstatus="1" closeallpages="1"',
       'RESOURCES',
       'PAGESIZE',
       $url,
       $isNotMap, '', $symbFilter,
       $start_new_option);
   
       
   
   
   
    &Apache::lonxml::xmlparse($r, 'helper', $helperFragment);
   
       }
    }
       }
   
       if (($helper->{'VAR'}->{'construction'} ne '1' ) &&
    $helper->{VARS}->{'postdata'} &&
    $helper->{VARS}->{'assignment'}) {
   
    # BZ 5209 - Print incomplete problems from sequence:
    # the exact form of this depends on whether or not we are privileged or a mere
    # plebe of s student:
   
    my $printSelector = 'map_incomplete_problems_seq';
    my $nextState     = 'CHOOSE_INCOMPLETE_SEQ';
    my $textSuffix    = '';
   
    if ($userCanPrint)  {
       $printSelector = 'map_incomplete_problems_people_seq';
       $nextState     = 'CHOOSE_INCOMPLETE_PEOPLE_SEQ';
       $textSuffix    = ' for selected students';
       my $helperStates =
    &create_incomplete_folder_selstud_helper($helper, $map); 
       &Apache::lonxml::xmlparse($r, 'helper', $helperStates);
    } else {
       if (&printable($map_open, $map_close)) {
    my $helperStates = &create_incomplete_folder_helper($helper, $map); # Create needed states for student.
    &Apache::lonxml::xmlparse($r, 'helper', $helperStates);
       } else {
    # TODO: Figure out how to break the news...this folder is not printable.
       }
    }
   
    if ($userCanPrint || &printable($map_open, $map_close)) {
       push(@{$printChoices},
    [&mt('Selected  [_1]Incomplete Problems[_2] from folder [_3]' . $textSuffix,
         '<b>', '</b>',
         '<b><i>'. $sequenceTitle . '</b></i>'),
     $printSelector,
     $nextState]);
    }
           # Allow problems from sequence
    if ($userCanPrint || &printable($map_open, $map_close)) {
       push @{$printChoices}, 
       [&mt('Selected [_1]Problems[_2] from folder [_3]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>'), 
        'map_problems', 
        'CHOOSE_PROBLEMS'];
       # Allow all resources from sequence
       push @{$printChoices}, [&mt('Selected [_1]Resources[_2] from folder [_3]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>'), 
       'map_problems_pages', 
       'CHOOSE_PROBLEMS_HTML'];
       my $helperFragment = &generate_resource_chooser('CHOOSE_PROBLEMS',
       'Select Problem(s) to print',
       'multichoice="1" toponly="1" addstatus="1" closeallpages="1"',
       'RESOURCES',
       'PAGESIZE',
       $map,
       $isProblem, '',
       $symbFilter,
       $start_new_option);
       $helperFragment .= &generate_resource_chooser('CHOOSE_PROBLEMS_HTML',
     'Select Resource(s) to print',
     'multichoice="1" toponly="1" addstatus="1" closeallpages="1"',
     'RESOURCES',
     'PAGESIZE',
     $map,
     $isNotMap, '',
     $symbFilter,
     $start_new_option);
       
       &Apache::lonxml::xmlparse($r, 'helper', $helperFragment);
    } else {
       # TODO: Figure out how to tell them the folder is not printable.
    }
       }
    # If the user has pfo (print for others) allow them to print all 
    # problems and resources  in the entire course, optionally for selected students
    my $post_data = $helper->{VARS}->{'postdata'};
       
       if ($perm{'pfo'} &&  !$is_published  &&
           ($post_data=~/\/res\// || $post_data =~/\/(syllabus|smppg|aboutme|bulletinboard)$/)) { 
   
    # BZ 5209 - incomplete problems from entire course:
   
    push(@{$printChoices},
        [&mtn('Selected <b>Incomplete Problems</b> from <b>entire course</b> for selected people'),
         'incomplete_problems_selpeople_course', 'INCOMPLETE_PROBLEMS_COURSE_RESOURCES']);
    my $helperFragment = &create_incomplete_course_helper($helper); # Create needed states.
   
    &Apache::lonxml::xmlparse($r, 'helper', $helperFragment);
   
    #  Selected problems/resources from entire course:
   
           push @{$printChoices}, [&mtn('Selected <b>Problems</b> from <b>entire course</b>'), 'all_problems', 'ALL_PROBLEMS'];
    push @{$printChoices}, [&mtn('Selected <b>Resources</b> from <b>entire course</b>'), 'all_resources', 'ALL_RESOURCES'];
    push @{$printChoices}, [&mtn('Selected <b>Problems</b> from <b>entire course</b> for <b>selected people</b>'), 'all_problems_students', 'ALL_PROBLEMS_STUDENTS'];
   my $suffixXml = <<ALL_PROBLEMS;
     <state name="STUDENTS1" title="Select People">
         <message><b>Select sorting order of printout</b> </message>
       <choices variable='student_sort'>
         <choice computer='0'>Sort by section then student</choice>
         <choice computer='1'>Sort by students across sections.</choice>
       </choices>
         <message><br /><hr /><br /> </message>
         <student multichoice='1' variable="STUDENTS" nextstate="PRINT_FORMATTING" coursepersonnel="1"/>
     </state>
   ALL_PROBLEMS
            &Apache::lonxml::xmlparse($r, 'helper', 
      &generate_resource_chooser('ALL_PROBLEMS',
         'SelectProblem(s) to print',
         'multichoice="1" suppressEmptySequences="0" addstatus="1" closeallpages="1"',
         'RESOURCES',
         'PAGESIZE',
         '',
         $isProblemOrMap, $isNotMap,
         $symbFilter,
         $start_new_option) .
      &generate_resource_chooser('ALL_RESOURCES',
         'Select Resource(s) to print',
         " toponly='0' multichoice='1' suppressEmptySequences='0' addstatus='1' closeallpages='1'",
         'RESOURCES',
         'PAGESIZE',
         '',
         $isNotMap,'',$symbFilter,
         $start_new_option) .
      &generate_resource_chooser('ALL_PROBLEMS_STUDENTS',
         'Select Problem(s) to print',
         'toponly="0" multichoice="1" suppressEmptySequences="0" addstatus="1" closeallpages="1"',
         'RESOURCES',
         'STUDENTS1',
         '',
         $isProblemOrMap,'' , $symbFilter,
         $start_new_option) .
        $suffixXml
      );
   
    if ($helper->{VARS}->{'assignment'}) {
   
       # If we were looking at a page, allow a selection of problems from the page
       # either for selected students or for coded assignments.
   
       if ($page_ispage) {
    push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from page [_3] for [_4]selected people[_5]',
       '<b>', '</b>', '<b><i>'.$page_title.'</i></b>', '<b>', '</b>'),
    'problems_for_students_from_page', 'CHOOSE_TGT_STUDENTS_PAGE'];
    push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from page [_3] for [_4]CODEd assignments[_5]',
       '<b>', '</b>', '<b><i>'.$page_title.'</i></b>', '<b>', '</b>'),
    'problems_for_anon_page', 'CHOOSE_ANON1_PAGE'];
       }
       push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from folder [_3] for [_4]selected people[_5]',
    '<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>','<b>','</b>'), 
       'problems_for_students', 'CHOOSE_STUDENTS'];
       push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from folder [_3] for [_4]CODEd assignments[_5]',
    '<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>','<b>','</b>'), 
       'problems_for_anon', 'CHOOSE_ANON1'];
    }
   
    my $randomly_ordered_warning = 
               &get_randomly_ordered_warning($helper, $map);
   
    # resource_selector will hold a few states that:
    #   - Allow resources to be selected for printing.
    #   - Determine pagination between assignments.
    #   - Determine how many assignments should be bundled into a single PDF.
           # TODO:
    #    Probably good to do things like separate this up into several vars, each
    #    with one state, and use REGEXPs at inclusion time to set state names
    #    and next states for better mix and match capability
    #
    my $resource_selector= &generate_resource_chooser('SELECT_PROBLEMS',
     'Select resources to print',
     'multichoice="1" addstatus="1" closeallpages="1"',
     'RESOURCES', 
     'PRINT_FORMATTING',
     $map,
     $isProblem, '', $symbFilter,
     $start_new_option);
    $resource_selector .=  &generate_format_selector($helper,
                                                            'How should results be printed?',
                                                            'PRINT_FORMATTING').
                                  &generate_resource_chooser('CHOOSE_STUDENTS_PAGE',
    'Select Problem(s) to print',
    "multichoice='1' addstatus='1' closeallpages ='1'",
    'RESOURCES',
    'PRINT_FORMATTING',
    $url,
    $isProblem, '',  $symbFilter,
    $start_new_option);
   
   
   # Generate student choosers.
   
   
   
           &Apache::lonxml::xmlparse($r, 'helper',
     &generate_student_chooser('CHOOSE_TGT_STUDENTS_PAGE',
       'student_sort',
       'STUDENTS',
       'CHOOSE_STUDENTS_PAGE'));
    &Apache::lonxml::xmlparse($r, 'helper', 
     &generate_student_chooser('CHOOSE_STUDENTS',
       'student_sort',
       'STUDENTS',
       'SELECT_PROBLEMS'));
    &Apache::lonxml::xmlparse($r, 'helper', $resource_selector);
   
    my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
    my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
           my @names=&Apache::lonnet::getkeys('CODEs',$cdom,$cnum);
    my $namechoice='<choice></choice>';
    foreach my $name (sort {uc($a) cmp uc($b)} @names) {
       if ($name =~ /^error: 2 /) { next; }
       if ($name =~ /^type\0/) { next; }
       $namechoice.='<choice computer="'.$name.'">'.$name.'</choice>';
    }
   
   
    my %code_values;
    my %codes_to_print;
    foreach my $key (@names) {
       %code_values = &Apache::grades::get_codes($key, $cdom, $cnum);
       foreach my $key (keys(%code_values)) {
    $codes_to_print{$key} = 1;
       }
    }
   
    my $code_selection;
    foreach my $code (sort {uc($a) cmp uc($b)} (keys(%codes_to_print))) {
       my $choice  = $code;
       if ($code =~ /^[A-Z]+$/) { # Alpha code
    $choice = &letters_to_num($code);
       }
       push(@{$helper->{DATA}{ALL_CODE_CHOICES}},[$code,$choice]);
    }
    if (%codes_to_print) {
       $code_selection .='   
       <message><b>Choose single CODE from list:</b></message>
    <message></td><td></message>
    <dropdown variable="CODE_SELECTED_FROM_LIST" multichoice="0" allowempty="0">
                     <choice></choice>
                     <exec>
                        push(@{$state->{CHOICES}},@{$helper->{DATA}{ALL_CODE_CHOICES}});
                     </exec>
    </dropdown>
       <message></td></tr><tr><td></message>
               '.$/;
   
    }
   
           my @lines = &Apache::grades::get_scantronformat_file();
    my $codechoice='';
    foreach my $line (@lines) {
       my ($name,$description,$code_type,$code_length)=
    (split(/:/,$line))[0,1,2,4];
       if ($code_length > 0 && 
    $code_type =~/^(letter|number|-1)/) {
    $codechoice.='<choice computer="'.$name.'">'.$description.'</choice>';
       }
    }
    if ($codechoice eq '') {
       $codechoice='<choice computer="default">Default</choice>';
    }
    my $anon1 = &generate_code_selector($helper, 
       'CHOOSE_ANON1',
       'SELECT_PROBLEMS',
       $codechoice,
       $code_selection,
       $namechoice) . $resource_selector;
       
       
           &Apache::lonxml::xmlparse($r, 'helper',$anon1);
   
    my $anon_page = &generate_code_selector($helper,
    'CHOOSE_ANON1_PAGE',
    'SELECT_PROBLEMS_PAGE',
    $codechoice,
    $code_selection,
    $namechoice) .
    &generate_resource_chooser('SELECT_PROBLEMS_PAGE',
      'Select Problem(s) to print',
      "multichoice='1' addstatus='1' closeallpages ='1'",
      'RESOURCES',
      'PRINT_FORMATTING',
      $url,
      $isProblem, '',  $symbFilter,
      $start_new_option);
    &Apache::lonxml::xmlparse($r, 'helper', $anon_page);
   
   
    if ($helper->{VARS}->{'assignment'}) {
   
       # Assignment printing:
   
       push @{$printChoices}, [&mt('Selected [_1]Resources[_2] from folder [_3] for [_4]selected people[_5]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>','<b>','</b>'), 'resources_for_students', 'CHOOSE_STUDENTS1'];
       push @{$printChoices}, [&mt('Selected [_1]Resources[_2] from folder [_3] for [_4]CODEd assignments[_5]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>','<b>','</b>'), 'resources_for_anon', 'CHOOSE_ANON2'];
    }
       
   
    $resource_selector=<<RESOURCE_SELECTOR;
       <state name="SELECT_RESOURCES" title="Select Resources">
       $randomly_ordered_warning
       <nextstate>PRINT_FORMATTING</nextstate>
       <message><br /><big><i><b>Select resources for the assignment</b></i></big><br /></message>
       <resource variable="RESOURCES" multichoice="1" addstatus="1" 
                 closeallpages="1">
         <filterfunc>return $isNotMap;</filterfunc>
         <mapurl>$map</mapurl>
         <valuefunc>return $symbFilter;</valuefunc>
         $start_new_option
         </resource>
       </state>
   RESOURCE_SELECTOR
   
           $resource_selector .= &generate_format_selector($helper,
                                                           'Format of the print job',
                                                           'PRINT_FORMATTING');
    &Apache::lonxml::xmlparse($r, 'helper', <<CHOOSE_STUDENTS1);
     <state name="CHOOSE_STUDENTS1" title="Select Students and Resources">
       <choices variable='student_sort'>
         <choice computer='0'>Sort by section then student</choice>
         <choice computer='1'>Sort by students across sections.</choice>
       </choices>
       <message><br /><hr /><br /></message>
       <student multichoice='1' variable="STUDENTS" nextstate="SELECT_RESOURCES" coursepersonnel="1" />
   
       </state>
       $resource_selector
   CHOOSE_STUDENTS1
   
    &Apache::lonxml::xmlparse($r, 'helper', <<CHOOSE_ANON2);
     <state name="CHOOSE_ANON2" title="Select CODEd Assignments">
       <nextstate>SELECT_RESOURCES</nextstate>
       <message><h4>Fill out one of the forms below</h4></message>
       <message><br /><hr /> <br /></message>
       <message><h3>Generate new CODEd Assignments</h3></message>
       <message><table><tr><td><b>Number of CODEd assignments to print:</b></td><td></message>
       <string variable="NUMBER_TO_PRINT_TOTAL" maxlength="5" size="5"  noproceed="1">
          <validator>
    if (((\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}+0) < 1) &&
       !\$helper->{'VARS'}{'REUSE_OLD_CODES'}                &&
       !\$helper->{'VARS'}{'SINGLE_CODE'}                   &&
       !\$helper->{'VARS'}{'CODE_SELECTED_FROM_LIST'}) {
       return "You need to specify the number of assignments to print";
    }
           if (((\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}+0) >= 1)  &&
                (\$helper->{'VARS'}{'SINGLE_CODE'} ne '') ) {
               return 'Specifying number of codes to print and a specific code is not compatible';
           }
    return undef;
          </validator>
       </string>
       <message></td></tr><tr><td></message>
       <message><b>Names to save the CODEs under for later:</b></message>
       <message></td><td></message>
       <string variable="ANON_CODE_STORAGE_NAME" maxlength="50" size="20" />
       <message></td></tr><tr><td></message>
       <message><b>Bubblesheet type:</b></message>
       <message></td><td></message>
       <dropdown variable="CODE_OPTION" multichoice="0" allowempty="0">
       $codechoice
       </dropdown>
       <message></td></tr><tr><td></table></message>
       <message><br /><hr /><h3>Print a Specific CODE </h3><br /><table></message>
       <message><tr><td><b>Enter a CODE to print:</b></td><td></message>
       <string variable="SINGLE_CODE" size="10">
           <validator>
      if(!\$helper->{'VARS'}{'NUMBER_TO_PRINT_TOTAL'}           &&
         !\$helper->{'VARS'}{'REUSE_OLD_CODES'}                 &&
         !\$helper->{'VARS'}{'CODE_SELECTED_FROM_LIST'}) {
         return &Apache::lonprintout::is_code_valid(\$helper->{'VARS'}{'SINGLE_CODE'},
         \$helper->{'VARS'}{'CODE_OPTION'});
     } elsif (\$helper->{'VARS'}{'SINGLE_CODE'} ne ''){
         return 'Specifying a code name is incompatible specifying number of codes.';
      } else {
          return undef; # Other forces control us.
      }
           </validator>
       </string>
       <message></td></tr><tr><td></message>
           $code_selection
       <message></td></tr></table></message>
       <message><hr /><h3>Reprint a Set of Saved CODEs</h3><table><tr><td></message>
       <message><b>Select saved CODEs:</b></message>
       <message></td><td></message>
       <dropdown variable="REUSE_OLD_CODES">
           $namechoice
       </dropdown>
       <message></td></tr></table></message>
     </state>
       $resource_selector
   CHOOSE_ANON2
       }
   
       # FIXME: That RE should come from a library somewhere.
       if (($perm{'pav'} 
    && $subdir ne $Apache::lonnet::perlvar{'lonDocRoot'}.'/res/'
    && (defined($helper->{'VARS'}->{'construction'})
       ||
       (&Apache::lonnet::allowed('bre',$subdir) eq 'F'
        && 
        $helper->{VARS}->{'postdata'}=~/\.(problem|exam|quiz|assess|survey|form|library|page|xml|html|htm|xhtml|xhtm)/)
       )) 
    && $helper->{VARS}->{'assignment'} eq ""
    ) {
    my $pretty_dir = &Apache::lonnet::hreflocation($subdir);
           push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from current subdirectory [_3]','<b>','</b>','<b><i>'.$pretty_dir.'</i></b>','<b>','</b>'), 'problems_from_directory', 'CHOOSE_FROM_SUBDIR'];
           my $xmlfrag = <<CHOOSE_FROM_SUBDIR;
     <state name="CHOOSE_FROM_SUBDIR" title="Select File(s) from <b><small>$pretty_dir</small></b> to print">
   
       <files variable="FILES" multichoice='1'>
         <nextstate>PAGESIZE</nextstate>
         <filechoice>return '$subdir';</filechoice>
   CHOOSE_FROM_SUBDIR
           
           # this is broken up because I really want interpolation above,
           # and I really DON'T want it below
           $xmlfrag .= <<'CHOOSE_FROM_SUBDIR';
         <filefilter>return Apache::lonhelper::files::not_old_version($filename) &&
     $filename =~ m/\.(problem|exam|quiz|assess|survey|form|library)$/;
         </filefilter>
         </files>
       </state>
   CHOOSE_FROM_SUBDIR
           &Apache::lonxml::xmlparse($r, 'helper', $xmlfrag);
       }
   
       # Allow the user to select any sequence in the course, feed it to
       # another resource selector for that sequence
       if (!$helper->{VARS}->{'construction'} && !$is_published) {
    push @$printChoices, [&mtn("Selected <b>Resources</b> from <b>selected folder</b> in course"),
         'select_sequences', 'CHOOSE_SEQUENCE'];
    my $escapedSequenceName = $helper->{VARS}->{'SEQUENCE'};
    #Escape apostrophes and backslashes for Perl
    $escapedSequenceName =~ s/\\/\\\\/g;
    $escapedSequenceName =~ s/'/\\'/g;
    &Apache::lonxml::xmlparse($r, 'helper', <<CHOOSE_FROM_ANY_SEQUENCE);
     <state name="CHOOSE_SEQUENCE" title="Select Sequence To Print From">
       <message>Select the sequence to print resources from:</message>
       <resource variable="SEQUENCE">
         <nextstate>CHOOSE_FROM_ANY_SEQUENCE</nextstate>
         <filterfunc>return &Apache::lonprintout::printable_sequence(\$res);</filterfunc>
         <valuefunc>return $urlValue;</valuefunc>
         <choicefunc>return \$res->hasResource(\$res,sub { return !\$_[0]->is_sequence() },0,0);
    </choicefunc>
         </resource>
       </state>
     <state name="CHOOSE_FROM_ANY_SEQUENCE" title="Select Resources To Print">
       <message>(mark desired resources then click "next" button) <br /></message>
       <resource variable="RESOURCES" multichoice="1" toponly='1' addstatus="1"
                 closeallpages="1">
         <nextstate>PAGESIZE</nextstate>
         <filterfunc>return $isNotMap</filterfunc>
         <mapurl evaluate='1'>return '$escapedSequenceName';</mapurl>
         <valuefunc>return $symbFilter;</valuefunc>
         $start_new_option
         </resource>
       </state>
   CHOOSE_FROM_ANY_SEQUENCE
   }
   
       # Generate the first state, to select which resources get printed.
       Apache::lonhelper::state->new("START", "Select Printing Options:");
       if (!$res_printable) {
    $paramHash = Apache::lonhelper::getParamHash();
    $paramHash->{MESSAGE_TEXT} = 
       &mt('[_1]Printing for current resource is only possible between [_2] and [_3]',
           '<p><b>',$res_printstartdate, $res_printenddate.'</b></p>');
    Apache::lonhelper::message->new();
       }
       $paramHash = Apache::lonhelper::getParamHash();
       $paramHash = Apache::lonhelper::getParamHash();
       $paramHash->{MESSAGE_TEXT} = "";
       Apache::lonhelper::message->new();
       $paramHash = Apache::lonhelper::getParamHash();
       $paramHash->{'variable'} = 'PRINT_TYPE';
       $paramHash->{CHOICES} = $printChoices;
       Apache::lonhelper::choices->new();
   
       my $startedTable = 0; # have we started an HTML table yet? (need
                             # to close it later)
   
       if (($perm{'pav'} and $perm{'vgr'}) or 
    ($helper->{VARS}->{'construction'} eq '1')) {
    &addMessage('<br />'
                      .'<h3>'.&mt('Print Options').'</h3>'
                      .&Apache::lonhtmlcommon::start_pick_box()
                      .&Apache::lonhtmlcommon::row_title(
                          '<label for="ANSWER_TYPE_forminput">'
                         .&mt('Print Answers')
                         .'</label>'
                       )
           );
           $paramHash = Apache::lonhelper::getParamHash();
    $paramHash->{'variable'} = 'ANSWER_TYPE';   
    $helper->declareVar('ANSWER_TYPE');         
           $paramHash->{CHOICES} = [
                                      ['Without Answers', 'yes'],
                                      ['With Answers', 'no'],
                                      ['Only Answers', 'only']
                                   ];
           Apache::lonhelper::dropdown->new();
    &addMessage(&Apache::lonhtmlcommon::row_closure());
    $startedTable = 1;
   
   #
   #  Select font size.
   #
   
               $helper->declareVar('fontsize');
               &addMessage(&Apache::lonhtmlcommon::row_title(&mt('Font Size')));
               my $xmlfrag = << "FONT_SELECTION";
   
             
               <dropdown variable='fontsize' multichoice='0', allowempty='0'>
               <defaultvalue>
     return 'normalsize';
               </defaultvalue>
               <choice computer='tiny'>Tiny</choice>
               <choice computer='sub/superscriptsize'>Script Size</choice>
               <choice computer='footnotesize'>Footnote Size</choice>
               <choice computer='small'>Small</choice>
               <choice computer='normalsize'>Normal (default)</choice>
               <choice computer='large'>larger than normal</choice>
               <choice computer='Large'>Even larger than normal</choice>
               <choice computer='LARGE'>Still larger than normal</choice>
               <choice computer='huge'>huge font size</choice>
               <choice computer='Huge'>Largest possible size</choice>
               </dropdown>
   FONT_SELECTION
               &Apache::lonxml::xmlparse($r, 'helper', $xmlfrag);
               &addMessage(&Apache::lonhtmlcommon::row_closure(1));
       }
   
 #-- start form      if ($perm{'pav'}) {
     &headerform($r);   if (!$startedTable) {
 #-- menu for output      addMessage("<hr width='33%' /><table><tr><td align='right'>".
     unless  ($ENV{'form.phase'}) {                         '<label for="LATEX_TYPE_forminput">'.
  &menu_for_output($r);                         &mt('LaTeX mode').
                          "</label>: </td><td>");
       $startedTable = 1;
    } else {
       &addMessage(&Apache::lonhtmlcommon::row_title(
                              '<label for="LATEX_TYPE_forminput">'
                              .&mt('LaTeX mode')
                              .'</label>'
                           )
               );
    }
           $paramHash = Apache::lonhelper::getParamHash();
    $paramHash->{'variable'} = 'LATEX_TYPE';   
    $helper->declareVar('LATEX_TYPE');  
    if ($helper->{VARS}->{'construction'} eq '1') {       
       $paramHash->{CHOICES} = [
        ['standard LaTeX mode', 'standard'], 
        ['LaTeX batchmode', 'batchmode'], ];
    } else {
       $paramHash->{CHOICES} = [
        ['LaTeX batchmode', 'batchmode'],
        ['standard LaTeX mode', 'standard'] ];
    }
           Apache::lonhelper::dropdown->new();
    
    &addMessage(&Apache::lonhtmlcommon::row_closure()
                      .&Apache::lonhtmlcommon::row_title(
                           '<label for="TABLE_CONTENTS_forminput">'
                          .&mt('Print Table of Contents')
                          .'</label>'
                       )
           );
           $paramHash = Apache::lonhelper::getParamHash();
    $paramHash->{'variable'} = 'TABLE_CONTENTS';   
    $helper->declareVar('TABLE_CONTENTS');         
           $paramHash->{CHOICES} = [
                                      ['No', 'no'],
                                      ['Yes', 'yes'] ];
           Apache::lonhelper::dropdown->new();
    &addMessage(&Apache::lonhtmlcommon::row_closure());
           
    if (not $helper->{VARS}->{'construction'}) {
       &addMessage(&Apache::lonhtmlcommon::row_title(
                               '<label for="TABLE_INDEX_forminput">'
                              .&mt('Print Index')
                              .'</label>'
                           )
               );
       $paramHash = Apache::lonhelper::getParamHash();
       $paramHash->{'variable'} = 'TABLE_INDEX';   
       $helper->declareVar('TABLE_INDEX');         
       $paramHash->{CHOICES} = [
        ['No', 'no'],
        ['Yes', 'yes'] ];
       Apache::lonhelper::dropdown->new();
               &addMessage(&Apache::lonhtmlcommon::row_closure());
               &addMessage(&Apache::lonhtmlcommon::row_title(
                               '<label for="PRINT_DISCUSSIONS_forminput">'
                              .&mt('Print Discussions')
                              .'</label>'
                           )
               );
       $paramHash = Apache::lonhelper::getParamHash();
       $paramHash->{'variable'} = 'PRINT_DISCUSSIONS';   
       $helper->declareVar('PRINT_DISCUSSIONS');         
       $paramHash->{CHOICES} = [
        ['No', 'no'],
        ['Yes', 'yes'] ];
       Apache::lonhelper::dropdown->new();
               &addMessage(&Apache::lonhtmlcommon::row_closure());
   
       # Prompt for printing annotations too.
   
       &addMessage(&Apache::lonhtmlcommon::row_title(
                               '<label for="PRINT_ANNOTATIONS_forminput">'
                              .&mt('Print Annotations')
                              .'</label>'
                           )
               );
       $paramHash = Apache::lonhelper::getParamHash();
       $paramHash->{'variable'} = "PRINT_ANNOTATIONS";
       $helper->declareVar("PRINT_ANNOTATIONS");
       $paramHash->{CHOICES} = [
        ['No', 'no'],
        ['Yes', 'yes']];
       Apache::lonhelper::dropdown->new();
               &addMessage(&Apache::lonhtmlcommon::row_closure());
   
               &addMessage(&Apache::lonhtmlcommon::row_title(&mt('Foils')));
       $paramHash = Apache::lonhelper::getParamHash();
       $paramHash->{'multichoice'} = "true";
       $paramHash->{'allowempty'}  = "true";
       $paramHash->{'variable'}   = "showallfoils";
       $paramHash->{'CHOICES'} = [ [&mt('Show All Foils'), "1"] ];
       Apache::lonhelper::choices->new();
               &addMessage(&Apache::lonhtmlcommon::row_closure(1));
    }
   
    if ($helper->{'VARS'}->{'construction'}) { 
       my $stylevalue='$Apache::lonnet::env{"construct.style"}';
               my $randseedtext=&mt("Use random seed");
               my $stylefiletext=&mt("Use style file");
               my $selectfiletext=&mt("Select style file");
   
       my $xmlfrag .= '<message>'
               .&Apache::lonhtmlcommon::row_title('<label for="curseed_forminput">'
                                                 .$randseedtext
                                                 .'</label>'
                )
               .'</message>
               <string variable="curseed" size="15" maxlength="15">
                   <defaultvalue>
                      return '.$helper->{VARS}->{'curseed'}.';
                   </defaultvalue>'
               .'</string>'
               .'<message>'
               .&Apache::lonhtmlcommon::row_closure()
               .&Apache::lonhtmlcommon::row_title('<label for="style_file">'
                                                 .$stylefiletext
                                                 .'</label>'
                )
               .'</message>
                <string variable="style_file" size="40">
                   <defaultvalue>
                       return '.$stylevalue.';
                   </defaultvalue>
                </string><message>&nbsp;'
   .qq|<a href="javascript:openbrowser('helpform','style_file_forminput','sty')">|
   .$selectfiletext.'</a>'
               .&Apache::lonhtmlcommon::row_closure()
               .&Apache::lonhtmlcommon::row_title(&mt('Show All Foils'))
               .'</message>
        <choices allowempty="1" multichoice="true" variable="showallfoils">
                   <choice computer="1">&nbsp;</choice>
                </choices>'
       .'<message>'
               .&Apache::lonhtmlcommon::row_closure()
               .'</message>';
               &Apache::lonxml::xmlparse($r, 'helper', $xmlfrag);
   
   
               &addMessage(&Apache::lonhtmlcommon::row_title(&mt('Problem Type')));
       #
       # Initial value from construction space:
       #
       if (!$helper->{VARS}->{'probstatus'} && $env{'form.problemtype'}) {
    $helper->{VARS}->{'probstatus'} = $env{'form.problemtype'}; # initial value
       }
       $xmlfrag = << "PROBTYPE";
    <dropdown variable="probstatus" multichoice="0" allowempty="0">
      <defaultvalue>
         return "$helper->{VARS}->{'probstatus'}";
                      </defaultvalue>
      <choice computer="problem">Homework Problem</choice>
      <choice computer="exam">Bubblesheet Exam Problem</choice>
      <choice computer="survey">Survey question</choice>
                      ,choice computer="anonsurvey"Anonymous survey question</choice>
    </dropdown>
   PROBTYPE
               &Apache::lonxml::xmlparse($r, 'helper', $xmlfrag);
               &addMessage(&Apache::lonhtmlcommon::row_closure(1));
   
   
   
           }
     }      }
   
   
 #-- core part   
     if ($ENV{'form.phase'} eq 'two') {  
  &output_data($r);  
   
   
       if ($startedTable) {
           &addMessage(&Apache::lonhtmlcommon::end_pick_box());
     }      }
   
       Apache::lonprintout::page_format_state->new("FORMAT");
   
       # Generate the PAGESIZE state which will offer the user the margin
       # choices if they select one column
       Apache::lonhelper::state->new("PAGESIZE", "Set Margins");
       Apache::lonprintout::page_size_state->new('pagesize', 'FORMAT', 'FINAL');
   
   
       $helper->process();
   
   
       # MANUAL BAILOUT CONDITION:
       # If we're in the "final" state, bailout and return to handler
       if ($helper->{STATE} eq 'FINAL') {
           return $helper;
       }    
   
       my $footer;
       if ($helper->{STATE} eq 'START') {
           my $prtspool=$r->dir_config('lonPrtDir'); 
    $footer = &recently_generated($prtspool);
       }
       $r->print($helper->display($footer));
       &Apache::lonhelper::unregisterHelperTags();
   
     return OK;      return OK;
   }
   
 }   
   
 1;  1;
 __END__  
   
   package Apache::lonprintout::page_format_state;
   
   =pod
   
   =head1 Helper element: page_format_state
   
   See lonhelper.pm documentation for discussion of the helper framework.
   
   Apache::lonprintout::page_format_state is an element that gives the 
   user an opportunity to select the page layout they wish to print 
   with: Number of columns, portrait/landscape, and paper size. If you 
   want to change the paper size choices, change the @paperSize array 
   contents in this package.
   
   page_format_state is always directly invoked in lonprintout.pm, so there
   is no tag interface. You actually pass parameters to the constructor.
   
   =over 4
   
   =item * B<new>(varName): varName is where the print information will be stored in the format FIXME.
   
   =back
   
   =cut
   
   use Apache::lonhelper;
   
   no strict;
   @ISA = ("Apache::lonhelper::element");
   use strict;
   use Apache::lonlocal;
   use Apache::lonnet;
   
   my $maxColumns = 2;
   # it'd be nice if these all worked
   #my @paperSize = ("letter [8 1/2x11 in]", "legal [8 1/2x14 in]", 
   #                 "tabloid (ledger) [11x17 in]", "executive [7 1/2x10 in]",
   #                 "a2 [420x594 mm]", "a3 [297x420 mm]", "a4 [210x297 mm]", 
   #                 "a5 [148x210 mm]", "a6 [105x148 mm]" );
   my @paperSize = ("letter [8 1/2x11 in]", "legal [8 1/2x14 in]", 
    "a4 [210x297 mm]");
   
   # Tentative format: Orientation (L = Landscape, P = portrait) | Colnum |
   #                   Paper type
   
   sub new { 
       my $self = Apache::lonhelper::element->new();
   
       shift;
   
       $self->{'variable'} = shift;
       my $helper = Apache::lonhelper::getHelper();
       $helper->declareVar($self->{'variable'});
       bless($self);
       return $self;
   }
   
   sub render {
       my $self = shift;
       my $helper = Apache::lonhelper::getHelper();
       my $result = '';
       my $var = $self->{'variable'};
       my $PageLayout=&mt('Page layout');
       my $NumberOfColumns=&mt('Number of columns');
       my $PaperType=&mt('Paper type');
       my $landscape=&mt('Landscape');
       my $portrait=&mt('Portrait');
       my $pdfFormLabel=&mt('PDF-Formfields');
       my $with=&mt('with Formfields');
       my $without=&mt('without Formfields');
       
   
       $result.='<h3>'.&mt('Layout Options').'</h3>'
               .&Apache::loncommon::start_data_table()
               .&Apache::loncommon::start_data_table_header_row()
               .'<th>'.$PageLayout.'</th>'
               .'<th>'.$NumberOfColumns.'</th>'
               .'<th>'.$PaperType.'</th>'
               .'<th>'.$pdfFormLabel.'</th>'
               .&Apache::loncommon::end_data_table_header_row()
               .&Apache::loncommon::start_data_table_row()
       .'<td>'
       .'<label><input type="radio" name="'.${var}.'.layout" value="L" />'.$landscape.'</label><br />'
       .'<label><input type="radio" name="'.${var}.'.layout" value="P" checked="checked" />'.$portrait.'</label>'
       .'</td>';
   
       $result.='<td align="center">'
               .'<select name="'.${var}.'.cols">';
   
       my $i;
       for ($i = 1; $i <= $maxColumns; $i++) {
           if ($i == 2) {
               $result .= '<option value="'.$i.'" selected="selected">'.$i.'</option>'."\n";
           } else {
               $result .= '<option value="'.$i.'">'.$i.'</option>'."\n";
           }
       }
   
       $result .= "</select></td><td>\n";
       $result .= "<select name='${var}.paper'>\n";
   
       my %parmhash=&Apache::lonnet::coursedescription($env{'request.course.id'});
       my $DefaultPaperSize=lc($parmhash{'default_paper_size'});
       $DefaultPaperSize=~s/\s//g;
       if ($DefaultPaperSize eq '') {$DefaultPaperSize='letter';}
       $i = 0;
       foreach (@paperSize) {
    $_=~/(\w+)/;
    my $papersize=$1;
           if ($paperSize[$i]=~/$DefaultPaperSize/) {
               $result .= '<option selected="selected" value="'.$papersize.'">'.$paperSize[$i].'</option>'."\n";
           } else {
               $result .= '<option value="'.$papersize.'">'.$paperSize[$i].'</option>'."\n";
           }
           $i++;
       }
       $result .= <<HTML;
           </select>
       </td>
       <td align='center'>
           <select name='${var}.pdfFormFields'>
               <option selected="selected" value="no">$without</option>
               <option value="yes">$with</option>
           </select>
       </td>
   HTML
       $result.=&Apache::loncommon::end_data_table_row()
               .&Apache::loncommon::end_data_table();
   
       return $result;
   }
   
   sub postprocess {
       my $self = shift;
   
       my $var = $self->{'variable'};
       my $helper = Apache::lonhelper->getHelper();
       $helper->{VARS}->{$var} = 
           $env{"form.$var.layout"} . '|' . $env{"form.$var.cols"} . '|' .
           $env{"form.$var.paper"} . '|' . $env{"form.$var.pdfFormFields"};
       return 1;
   }
   
   1;
   
   package Apache::lonprintout::page_size_state;
   
   =pod
   
   =head1 Helper element: page_size_state
   
   See lonhelper.pm documentation for discussion of the helper framework.
   
   Apache::lonprintout::page_size_state is an element that gives the 
   user the opportunity to further refine the page settings if they
   select a single-column page.
   
   page_size_state is always directly invoked in lonprintout.pm, so there
   is no tag interface. You actually pass parameters to the constructor.
   
   =over 4
   
   =item * B<new>(varName): varName is where the print information will be stored in the format FIXME.
   
   =back
   
   =cut
   
   use Apache::lonhelper;
   use Apache::lonnet;
   no strict;
   @ISA = ("Apache::lonhelper::element");
   use strict;
   
   
   
   sub new { 
       my $self = Apache::lonhelper::element->new();
   
       shift; # disturbs me (probably prevents subclassing) but works (drops
              # package descriptor)... - Jeremy
   
       $self->{'variable'} = shift;
       my $helper = Apache::lonhelper::getHelper();
       $helper->declareVar($self->{'variable'});
   
       # The variable name of the format element, so we can look into 
       # $helper->{VARS} to figure out whether the columns are one or two
       $self->{'formatvar'} = shift;
   
   
       $self->{NEXTSTATE} = shift;
       bless($self);
   
       return $self;
   }
   
   sub render {
       my $self = shift;
       my $helper = Apache::lonhelper::getHelper();
       my $result = '';
       my $var = $self->{'variable'};
   
   
   
       if (defined $self->{ERROR_MSG}) {
           $result .= '<br /><span class="LC_error">' . $self->{ERROR_MSG} . '</span><br />';
       }
   
       my $format = $helper->{VARS}->{$self->{'formatvar'}};
   
       # Use format to get sensible defaults for the margins:
   
   
       my ($laystyle, $cols, $papersize) = split(/\|/, $format);
       ($papersize)                      = split(/ /, $papersize);
   
       $laystyle = &Apache::lonprintout::map_laystyle($laystyle);
   
   
   
       my %size;
       ($size{'width_and_units'},
        $size{'height_and_units'},
        $size{'margin_and_units'})=
    &Apache::lonprintout::page_format($papersize, $laystyle, $cols);
       
       foreach my $dimension ('width','height','margin') {
    ($size{$dimension},$size{$dimension.'_unit'}) =
       split(/ +/, $size{$dimension.'_and_units'},2);
          
    foreach my $unit ('cm','in') {
       $size{$dimension.'_options'} .= '<option ';
       if ($size{$dimension.'_unit'} eq $unit) {
    $size{$dimension.'_options'} .= 'selected="selected" ';
       }
       $size{$dimension.'_options'} .= '>'.$unit.'</option>';
    }
       }
   
       # Adjust margin for LaTeX margin: .. requires units == cm or in.
   
       if ($size{'margin_unit'} eq 'in') {
    $size{'margin'} += 1;
       }  else {
    $size{'margin'} += 2.54;
       }
       my %lt = &Apache::lonlocal::texthash(
           'format' => 'How should each column be formatted?',
           'width'  => 'Width',
           'height' => 'Height',
           'margin' => 'Left Margin'
       );
   
       $result .= '<p>'.$lt{'format'}.'</p>'
                 .&Apache::lonhtmlcommon::start_pick_box()
                 .&Apache::lonhtmlcommon::row_title($lt{'width'})
                 .'<input type="text" name="'.$var.'.width" value="'.$size{'width'}.'" size="4" />'
                 .'<select name="'.$var.'.widthunit">'
                 .$size{'width_options'}
                 .'</select>'
                 .&Apache::lonhtmlcommon::row_closure()
                 .&Apache::lonhtmlcommon::row_title($lt{'height'})
                 .'<input type="text" name="'.$var.'.height" value="'.$size{'height'}.'" size="4" />'
                 .'<select name="'.$var.'.heightunit">'
                 .$size{'height_options'}
                 .'</select>'
                 .&Apache::lonhtmlcommon::row_closure()
                 .&Apache::lonhtmlcommon::row_title($lt{'margin'})
                 .'<input type="text" name="'.$var.'.lmargin" value="'.$size{'margin'}.'" size="4" />'
                 .'<select name="'.$var.'.lmarginunit">'
                 .$size{'margin_options'}
                 .'</select>'
                 .&Apache::lonhtmlcommon::row_closure(1)
                 .&Apache::lonhtmlcommon::end_pick_box();
       # <p>Hint: Some instructors like to leave scratch space for the student by
       # making the width much smaller than the width of the page.</p>
   
       return $result;
   }
   
   
   sub preprocess {
       my $self = shift;
       my $helper = Apache::lonhelper::getHelper();
   
       my $format = $helper->{VARS}->{$self->{'formatvar'}};
   
       #  If the user does not have 'pav' privilege, set default widths and
       #  on to the next state right away.
       #
       if (!$perm{'pav'}) {
    my $var = $self->{'variable'};
    my $format = $helper->{VARS}->{$self->{'formatvar'}};
   
    my ($laystyle, $cols, $papersize) = split(/\|/, $format);
    ($papersize)                      = split(/ /, $papersize);
   
   
    $laystyle = &Apache::lonprintout::map_laystyle($laystyle);
   
    #  Figure out some good defaults for the print out and set them:
   
    my %size;
    ($size{'width'},
    $size{'height'},
    $size{'lmargin'})=
        &Apache::lonprintout::page_format($papersize, $laystyle, $cols);
   
    foreach my $dim ('width', 'height', 'lmargin') {
       my ($value, $units) = split(/ /, $size{$dim});
           
       $helper->{VARS}->{"$var.".$dim}      = $value;
       $helper->{VARS}->{"$var.".$dim.'unit'} = $units;
       
    }
   
   
    # Transition to the next state
   
    $helper->changeState($self->{NEXTSTATE});
       }
      
       return 1;
   }
   
   sub postprocess {
       my $self = shift;
   
       my $var = $self->{'variable'};
       my $helper = Apache::lonhelper->getHelper();
       my $width = $helper->{VARS}->{$var .'.width'} = $env{"form.${var}.width"}; 
       my $height = $helper->{VARS}->{$var .'.height'} = $env{"form.${var}.height"}; 
       my $lmargin = $helper->{VARS}->{$var .'.lmargin'} = $env{"form.${var}.lmargin"}; 
       $helper->{VARS}->{$var .'.widthunit'} = $env{"form.${var}.widthunit"}; 
       $helper->{VARS}->{$var .'.heightunit'} = $env{"form.${var}.heightunit"}; 
       $helper->{VARS}->{$var .'.lmarginunit'} = $env{"form.${var}.lmarginunit"}; 
   
       my $error = '';
   
       # /^-?[0-9]+(\.[0-9]*)?$/ -> optional minus, at least on digit, followed 
       # by an optional period, followed by digits, ending the string
   
       if ($width !~  /^-?[0-9]*(\.[0-9]*)?$/) {
           $error .= "Invalid width; please type only a number.<br />\n";
       }
       if ($height !~  /^-?[0-9]*(\.[0-9]*)?$/) {
           $error .= "Invalid height; please type only a number.<br />\n";
       }
       if ($lmargin !~  /^-?[0-9]*(\.[0-9]*)?$/) {
           $error .= "Invalid left margin; please type only a number.<br />\n";
       } else {
    # Adjust for LaTeX 1.0 inch margin:
   
    if ($env{"form.${var}.lmarginunit"} eq "in") {
       $helper->{VARS}->{$var.'.lmargin'} = $lmargin - 1;
    } else {
       $helper->{VARS}->{$var.'.lmargin'} = $lmargin - 2.54;
    }
       }
   
       if (!$error) {
           Apache::lonhelper::getHelper()->changeState($self->{NEXTSTATE});
           return 1;
       } else {
           $self->{ERROR_MSG} = $error;
           return 0;
       }
   }
   
   __END__
   
 #### Test block  
 #    my $ere;  
 #    foreach $ere (%ENV) {  
 # $result .= ' SS '.$ere.' => '.$ENV{$ere}.' FF '."\n\n";  
 #    }  
 ####  

Removed from v.1.20  
changed lines
  Added in v.1.628


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>