# The LearningOnline Network
# Printout
#
# $Id: lonprintout.pm,v 1.705 2024/12/10 04:52:30 raeburn Exp $
#
# Copyright Michigan State University Board of Trustees
#
# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
#
# LON-CAPA is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# LON-CAPA is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with LON-CAPA; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
# /home/httpd/html/adm/gpl.txt
# http://www.lon-capa.org/
#
#
package Apache::lonprintout;
use strict;
use Apache::Constants qw(:common :http);
use Apache::lonxml;
use Apache::lonnet;
use Apache::loncommon;
use Apache::inputtags;
use Apache::grades;
use Apache::edit;
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 Apache::lonlocal;
use Carp;
use LONCAPA;
my %perm;
my %parmhash;
my $resources_printed;
# Global variables that describe errors in ssi calls detected by ssi_with_retries.
#
my $ssi_error; # True if there was an ssi error.
my $ssi_last_error_resource; # The resource URI that could not be fetched.
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.
# map - the map for which incomplete problems are to be printed
# nocurrloc - True if printout called from icon/link in Tools in /adm/navmaps
# Return:
# XML that can be parsed by the helper to drive the state machine.
#
sub create_incomplete_folder_selstud_helper {
my ($helper, $map, $nocurrloc) = @_;
my $symbFilter = '$res->shown_symb()';
my $selFilter = '$res->is_problem()';
my $resource_chooser = &generate_resource_chooser('CHOOSE_INCOMPLETE_PEOPLE_SEQ',
'Select problem(s) to print',
'multichoice="1" toponly="1" addstatus="1" closeallpages="1" modallink="1" nocurrloc="'.$nocurrloc.'"',
'RESOURCES',
'CHOOSE_STUDENTS_INCOMPLETE',
$map,
$selFilter,
'',
$symbFilter,
'');
my $student_chooser = &generate_student_chooser('CHOOSE_STUDENTS_INCOMPLETE',
'student_sort',
'STUDENTS',
'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" modallink="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.
# $nocurrloc - True if printout called from icon/link in Tools in /adm/navmaps
# Returns:
# XML that defines the helper states being created.
#
# States:
# CHOOSE_INCOMPLETE_SEQ - Resource selector.
#
sub create_incomplete_folder_helper {
my ($helper, $map, $nocurrloc) = @_;
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" modallink="1" nocurrloc="'.$nocurrloc.'"',
'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',
# modallink='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;
}
sub generate_common_choosers {
my ($r,$helper,$map,$url,$isProblem,$symbFilter,$start_new_option) = @_;
my $randomly_ordered_warning =
&get_randomly_ordered_warning($helper, $map);
# code for a few states used for printout launched from both
# /adm/navmaps and from a resource by a privileged user:
# - To allow resources to be selected for printing.
# - To determine pagination between assignments.
# - To determine how many assignments should be bundled into a single PDF.
my $resource_selector= &generate_resource_chooser('SELECT_PROBLEMS',
'Select resources to print',
'multichoice="1" addstatus="1" closeallpages="1" modallink="1" suppressNavmap="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' modallink='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::lonnet::get_scantronformat_file();
my $codechoice='';
foreach my $line (@lines) {
next if (($line =~ /^\#/) || ($line eq ''));
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' modallink='1'",
'RESOURCES',
'PRINT_FORMATTING',
$url,
$isProblem, '', $symbFilter,
$start_new_option);
&Apache::lonxml::xmlparse($r, 'helper', $anon_page);
return ($randomly_ordered_warning,$codechoice,$code_selection,$namechoice);
}
# 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') ||
($helper->{'VARS'}->{'PRINT_TYPE'} eq 'select_sequences_problems_for_anon') ||
($helper->{'VARS'}->{'PRINT_TYPE'} eq 'select_sequences_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 returned 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 (($earliest_close ne '') && ($latest_open ne '')
&& ($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 returned 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.
# For consistency with &printable() in lonnavmaps.pm determination of start
# date for printing checks printstartdate param first, then, if not set,
# opendate param, then, if not set, contentopen param.
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);
if (!$partopen) {
$partopen = $res->parmval('opendate',$part);
}
if (!$partopen) {
$partopen = $res->parmval('contentopen',$part);
}
if ($partopen) {
push(@open_dates, $partopen);
}
if ($partclose) {
push(@close_dates, $partclose);
}
push(@open_dates, $partopen);
push(@close_dates, $partclose);
}
}
($open_date, $close_date) = &compute_open_window(\@open_dates, \@close_dates);
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 hash from lonnavmaps::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.
# $section - Section for user for whom we are checking.
# $map - map name.
# Returns:
# 0 - map is not incomplete.
# 1 - map is incomplete.
#
sub incomplete {
my ($username, $domain, $section, $map) = @_;
my $navmap = Apache::lonnavmaps::navmap->new($username, $domain, $section);
if (defined($navmap)) {
my $res = $navmap->getResourceByUrl($map);
my $result = $res->is_incomplete();
return $result;
} else {
return 1;
}
}
#
# When printing for students, the resources 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 selected 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
# $nohidemap - If true, parameter in map for hiddenresource will be
# ignored. The user calling the routine should have
# both the pav and vgr privileges if this is set to true).
#
# 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, $nohidemap) = @_;
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 $unhidden;
if ($nohidemap) {
$unhidden = &Apache::lonnet::clutter($map);
}
my $navmap = Apache::lonnavmaps::navmap->new($username, $userdomain,
$usersection, $code, $unhidden);
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_hash. 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 substitution 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 includepsheader.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 is now 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 to be 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 ... suppose 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 .= '\\hfill\\thepage';
$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('Authoring 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::lonnet::get_scantronformat_file();
foreach my $line (@lines) {
next if (($line =~ /^\#/) || ($line eq ''));
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,$problem_split) = @_;
if (!($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.7 in', '-0.57 in','-0.57 in','-0.5 in'],
'2' => ['3.66 in','9.8 in', '-0.57 in','-0.57 in','-0.5 in']
},
'album' => {
'1' => [ '8.8 in', '6.8 in','-0.55 in', '-0.55 in','-0.5 in'],
'2' => [ '4.8 in', '6.7 in','-0.5 in', '-1.0 in','3.0 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' => ['5.7 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' => ['24.0 cm','18.0 cm','-1.0 cm','-1.0 cm','-1.25 cm'],
'2' => ['11.5 cm','18.0 cm','-0.7 cm','-1.7 cm','-1.25 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,$mostrecent) = @_;
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;
if ($mostrecent ne '') {
$name = $mostrecent;
} else {
$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}";
if ($parmhash{'print_header_format'} eq '') {
$fancypagestatement .= "\\fancyhead[RE]{\\thepage \\\\[\\baselineskip]}";
}
} else {
$fancypagestatement="\\rhead{}\\chead{}\\lhead{$header_text}";
}
$fancypagestatement .= "\\fancyfoot{}";
my ($paperwidth,$paperheight);
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 /;
if ($papersize eq 'a4') {
$paperwidth = '29.7cm';
$paperheight = '21.0cm';
} elsif ($numberofcolumns eq '1') {
if ($papersize eq 'letter') {
$paperwidth = '11.0in';
$paperheight = '8.5in';
} elsif ($papersize eq 'legal') {
$paperwidth = '14.0in';
$paperheight = '8.5in';
}
}
} 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') {
$paperwidth = '21.0cm';
$paperheight = '29.7cm';
} elsif ($papersize eq 'letter') {
$paperwidth = '8.5in';
$paperheight = '11.0in';
} elsif ($papersize eq 'legal') {
$paperwidth = '8.5in';
$paperheight = '14.0in';
}
}
if ($paperwidth ne '' && $paperheight ne '') {
my $papersize_text;
if ($perm{'pav'}) {
$papersize_text = '\\special{papersize='.$paperwidth.','.$paperheight.'}';
} else {
$papersize_text = '\special{papersize='.$paperwidth.','.$paperheight.'}';
}
$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 = ©right_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)=@_;
my $cleanURL=&Apache::lonenc::check_decrypt($currentURL);
my $shown = $currentURL;
if (($cleanURL ne $currentURL) || ($symb =~ m{/^enc/})) {
$shown = &mt('URL not shown (encrypted)');
}
if ($mode ne '') {$mode='\\'.$mode}
my $result = &print_latex_header($mode);
if ($cleanURL=~m|^(/adm/wrapper)?/ext/|) {
$cleanURL=~s|^(/adm/wrapper)?/ext/|http://|;
$cleanURL=~s|^http://https://|https://|;
if ($shown eq $currentURL) {
$shown = &Apache::lonxml::latex_special_symbols($cleanURL);
}
my $title=&Apache::lonnet::gettitle($symb);
$title = &Apache::lonxml::latex_special_symbols($title);
$result.=' \strut \\\\ \textit{'.$title.'} \strut \\\\ '.$shown.' ';
} else {
if ($shown eq $currentURL) {
$result.=&Apache::lonxml::latex_special_symbols($currentURL);
} else {
$result.=$shown;
}
}
$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);
my $title=&Apache::lonnet::gettitle($currentURL);
$title = &Apache::lonxml::latex_special_symbols($title);
$result .= '\noindent\textit{'.$title.'}\\\\';
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.
my $current_url = $resource->link();
# 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.=&latex_header_footer_remove(&unsupported($current_url,$mode,$resource->symb));
} elsif ($resource_src =~ /\.(problem|exam|quiz|assess|survey|form|library|xml|html|htm|xhtml|xhtm)$/) {
# these resources go through the XML transformer:
$result .= &Apache::lonxml::latex_special_symbols($resource->title()) . '\\\\';
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 Authoring 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, unwrap 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,$answerform{'problem_split'});
$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.
# 9 Print for anonymous CODEs
#
#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 {
my ($r,$helper,$rparmhash) = @_;
my %parmhash = %$rparmhash;
$ssi_error = 0; # This will be set nonzero by failing ssi's.
$resources_printed = '';
$font_size = $helper->{'VARS'}->{'fontsize'};
my $print_type = $helper->{'VARS'}->{'PRINT_TYPE'}; # Allows textual simplification.
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
# Breadcrumbs
#FIXME: Choose better/different breadcrumbs?!? Links?
my $brcrum = [{'href' => '',
'text' => 'Helper'}, #FIXME: Different origin possible than print out helper?
{'href' => '',
'text' => 'Preparing Printout'}];
my $start_page = &Apache::loncommon::start_page('Preparing Printout',
$js,
{'bread_crumbs' => $brcrum,});
my $msg = &mt('Please stand by while processing your print request, this may take some time ...');
$r->print($start_page."\n<p>\n$msg\n</p>\n");
# fetch the pagebreaks and store them in the course environment
# The page breaks will be pulled into the hash %page_breaks which is
# indexed by symb and contains 1's for each break.
$env{'form.pagebreaks'} = $helper->{'VARS'}->{'FINISHPAGE'};
&set_form_extraspace($helper);
$env{'form.lastprinttype'} = $print_type;
&Apache::loncommon::store_course_settings('print',
{'pagebreaks' => 'scalar',
'extraspace' => 'scalar',
'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=();
my $lastprinted;
# Common settings for the %form hash:
# In some cases these settings get overridden 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 Authoring 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|ext\.tool)$/) {
$form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
if ($currentURL=~/\/syllabus$/) {$currentURL=~s/\/res//;}
if ($currentURL=~/\/ext\.tool$/) {$currentURL=~s/^\/adm\/wrapper//;}
$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();
for (my $i=0;$i<=$#master_seq;$i++) {
&Apache::lonenc::reset_enc();
# Note due to document structure, not allowed to put \newpage
# prior to the first resource
if (defined $page_breaks{$master_seq[$i]}) {
if($i != 0) {
$result.="\\newpage\n";
}
}
$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)$/) {
my $extension = $1;
$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') && ($extension !~ /^x?html?$/))))) {
$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,$answerform{'problem_split'});
$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|ext\.tool)$/) {
$form{'latex_type'}=$helper->{'VARS'}->{'LATEX_TYPE'};
if ($urlp=~/\/syllabus$/) {$urlp=~s/\/res//;}
if ($urlp=~/\/ext\.tool$/) {$urlp=~s/^\/adm\/wrapper//;}
$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 {
$texversion=&unsupported($urlp,$helper->{'VARS'}->{'LATEX_TYPE'},
$master_seq[$i]);
if ($flag_latex_header_remove ne 'NO') {
$texversion = &latex_header_footer_remove($texversion);
} else {
$texversion =~ s/\\end\{document}//;
}
$result .= $texversion;
$flag_latex_header_remove = 'YES';
}
if (&Apache::loncommon::connection_aborted($r)) {
last;
}
}
&Apache::lonxml::clear_problem_counter();
if ($flag_page_in_sequence eq 'YES') {
$result =~ s/\\usepackage\{calc}/\\usepackage{calc}\\usepackage{longtable}/;
}
$result .= '\end{document}';
} elsif (($print_type eq 'problems_for_students') ||
($print_type eq 'problems_for_students_from_page') ||
($print_type eq 'all_problems_students') ||
($print_type eq 'resources_for_students') ||
($print_type eq 'incomplete_problems_selpeople_course') ||
($print_type eq 'map_incomplete_problems_people_seq') ||
($print_type eq 'select_sequences_problems_for_students') ||
($print_type eq 'select_sequences_resources_for_students')) {
#-- prints assignments for whole class or for selected students
my $type;
if (($print_type eq 'problems_for_students') ||
($print_type eq 'problems_for_students_from_page') ||
($print_type eq 'all_problems_students') ||
($print_type eq 'incomplete_problems_selpeople_course') ||
($print_type eq 'map_incomplete_problems_people_seq') ||
($print_type eq 'select_sequences_problems_for_students')) {
$selectionmade=5;
$type='problems';
} elsif (($print_type eq 'resources_for_students') ||
($print_type eq 'select_sequences_resources_for_students')) {
$selectionmade=8;
$type='resources';
}
my @students=split /\|\|\|/, $helper->{'VARS'}->{'STUDENTS'};
# The normal sort order is by section then by students within the
# section. If the helper var student_sort is 1, then the user has elected
# to override this and output the students by name.
# Each element of the students array is of the form:
# username:domain:section:last, first:status
#
# Note that student sort is not compatible with printing
# 1 section per pdf...so that setting overrides.
#
if (($helper->{'VARS'}->{'student_sort'} eq 1) &&
($helper->{'VARS'}->{'SPLIT_PDFS'} ne "sections")) {
@students = sort compare_names @students;
} 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'}) {
unless ((($print_type eq 'all_problems_students') ||
($print_type eq 'incomplete_problems_selpeople_course')) &&
$perm{'pfo'}) {
($map, my $id, my $resource) =
&Apache::lonnet::decode_symb($helper->{VARS}->{'symb'});
}
} elsif (($helper->{'VARS'}->{'postdata'} eq '/adm/navmaps') && ($perm{'pfo'})) {
$map = $helper->{'VARS'}->{'SEQUENCE'};
}
#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];
my $nohidemap;
if ($perm{'pav'} && $perm{'vgr'}) {
$nohidemap = 1;
}
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, undef, $nohidemap);
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 ($printed) {
$lastprinted = $fullname;
}
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') ||
($print_type eq 'select_sequences_problems_for_anon') ||
($print_type eq 'select_sequences_resources_for_anon')) {
$selectionmade = 9;
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::lonnet::get_scantronformat_file();
my ($code_type,$code_length,$bubbles_per_row)=('letter',6,10);
foreach my $line (@lines) {
next if (($line =~ /^\#/) || ($line eq ''));
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 $map;
if ($helper->{VARS}{'symb'}) {
($map, my $id, my $resource) =
&Apache::lonnet::decode_symb($helper->{VARS}{'symb'});
} elsif (($helper->{'VARS'}->{'postdata'} eq '/adm/navmaps') && ($perm{'pfo'})) {
$map = $helper->{'VARS'}->{'SEQUENCE'};
}
my %moreenv = ('textwidth' => &get_textwidth($helper,$LaTeXwidth));
$moreenv{'problem_split'} = $parmhash{'problem_stream_switch'};
$moreenv{'suppress_tries'} = $parmhash{'suppress_tries'};
$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);
}
$code_name =~ s/^\s+//;
$code_name =~ s/\s+$//;
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;
my $nohidemap;
if ($perm{'pav'} && $perm{'vgr'}) {
$nohidemap = 1;
}
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);
}
$env{'form.CODE'} = $moreenv{'CODE'};
my $actual_seq = master_seq_to_person_seq($map, \@master_seq,
undef,
$moreenv{'CODE'}, $nohidemap);
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 ($printed) {
$lastprinted = $fullname;
}
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 Authoring 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}';
}
#-------------------------------------------------------- corrections for the different page formats
# Only post process if that has not been turned off e.g. by a raw latex resource.
if ($do_postprocessing) {
my $mostrecent;
if ((($selectionmade == 5) || ($selectionmade == 8) || ($selectionmade == 9)) &&
(($numberofcolumns == 1) || ($laystyle eq 'album' && $papersize eq 'a4'))) {
$mostrecent = $lastprinted;
}
$result = &page_format_transformation($papersize,
$laystyle,$numberofcolumns,
$print_type,$result,
$helper->{VARS}->{'assignment'},
$helper->{'VARS'}->{'TABLE_CONTENTS'},
$helper->{'VARS'}->{'TABLE_INDEX'},
$selectionmade,$mostrecent);
$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 so we can provide a link back to the resource and to change options.
# (Since the browser back button does not currently work with https,
# the back link is useful even when there is an easy-to-miss LON-CAPA back button.)
my $URLback=''; #link to original document
if ($helper->{'VARS'}->{'construction'} eq '1') {
$URLback=$helper->{'VARS'}->{'filename'};
} elsif ($helper->{VARS}{'symb'}) {
my ($map, $id, $url) = &Apache::lonnet::decode_symb($helper->{VARS}{'symb'});
my $cdom =$env{'course.'.$env{'request.course.id'}.'.domain'};
my $cnum =$env{'course.'.$env{'request.course.id'}.'.num'};
my ($anchor,$usehttp,$plainurl);
$url = &Apache::lonnet::clutter($url);
$plainurl = $url;
if (($ENV{'SERVER_PORT'} == 443) && ($env{'request.course.id'}) &&
(($url =~ m{^\Q/public/$cdom/$cnum/syllabus\E($|\?)}) ||
($url =~ m{^\Q/adm/wrapper/ext/\E(?!https:)}))) {
unless ((&Apache::lonnet::uses_sts()) || (&Apache::lonnet::waf_allssl())) {
$usehttp = 1;
}
}
if ($env{'request.enc'}) {
$url = &Apache::lonenc::encrypted($url);
}
if ($url ne '') {
my $symb = $helper->{VARS}{'symb'};
if ($url =~ m{^\Q/adm/wrapper/ext/\E}) {
my $link = $url;
($link,$anchor) = ($url =~ /^([^\#]+)(?:|(\#[^\#]+))$/);
if ($anchor) {
($symb) = ($helper->{VARS}{'symb'} =~ /^([^\#]+)/);
}
$url = $link;
}
$URLback = $url;
if ($usehttp) {
$URLback .= (($URLback =~ /\?/) ? '&':'?').'usehttp=1';
}
unless ($plainurl =~ /\.page$/) {
$URLback .= (($URLback =~ /\?/) ? '&':'?').'symb='.&escape($symb.$anchor);
}
}
} elsif (($helper->{VARS}->{'postdata'} eq '/adm/navmaps') &&
($env{'request.course.id'})) {
$URLback=$helper->{VARS}->{'postdata'};
}
#
# 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
my $temp_file;
my $identifier = &Apache::loncommon::get_cgi_id();
my $filename = "/home/httpd/prtspool/$env{'user.name'}_$env{'user.domain'}_printout_$identifier.tex";
if (!($#print_array>0)) {
unless ($temp_file = Apache::File->new('>'.$filename)) {
$r->log_error("Couldn't open $filename for output $!");
return SERVER_ERROR;
}
print $temp_file $result;
my $begin=index($result,'\begin{document}',0);
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' => &escape($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
} # 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.
#
# Figure out if we need to filter the output by
# the incomplete problems for that person
#
my $print_type = $helper->{'VARS'}->{'PRINT_TYPE'};
my $print_incomplete = 0;
if (($print_type eq 'map_incomplete_problems_people_seq') ||
($print_type eq 'incomplete_problems_selpeople_course')) {
$print_incomplete = 1;
}
if ($person eq 'anonymous') {
$namepostfix .=&mt('Name:')." ";
$fullname = "CODE - ".$moreenv->{'CODE'};
}
# Fullname may have special latex characters that need \ prefixing:
#
my $i = 0;
my $actually_printed = 0; # Count of resources printed.
#goes through all resources, checks if they are available for
#current student, and produces output
&Apache::lonxml::clear_problem_counter();
my %page_breaks = &get_page_breaks($helper);
my $columns_in_format = (split(/\|/,$helper->{'VARS'}->{'FORMAT'}))[1];
#
# end each student with a
# Special that allows the post processor to even out the page
# counts later. Nasty problem this... it would be really
# nice to put the special in as a postscript comment
# e.g. \special{ps:\ENDOFSTUDENTSTAMP} unfortunately,
# The special gets passed the \ and dvips puts it in the output file
# so we will just rely on printout.pl to strip ENDOFSTUDENTSTAMP from the
# postscript. Each ENDOFSTUDENTSTAMP will go on a line by itself.
#
my $syllabus_first = 0;
my $current_assignment = "";
my $assignment;
my $courseidinfo = &get_course();
my $possprint = scalar(@{$master_seq});
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, $usersection, $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,$answerenv{'problem_split'});
$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|ext\.tool)$/) {
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 {
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;
}
}
$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) {
my $message = &mt('No resources to print');
if (!$possprint) {
if ($perm{'pav'} || $perm{'pfo'}) {
$message = &mt('There are no unhidden resources to print.')."\n\n".
&mt('The most likely reason is one of the following: ')."\n".
'\begin{itemize}'."\n".
'\item '.&mt("The 'Resource hidden from students' parameter is set for the folder being printed.")."\n".
'\item '.&mt("'Hidden' is checked in the Course Editor individually for each resource in the folder being printed.")."\n".
'\end{itemize}'."\n\n".
&mt("Note: to print a bubblesheet exam which you want to hide from students, ".
"use the Course Editor to check the 'Hidden' checkbox for the exam folder itself.")."\n";
}
} elsif ($print_incomplete) {
$message = &mt('No incomplete resources');
}
if ($message) {
$current_output = &encapsulate_minipage("\\vskip -10mm \n$message\n \\vskip 100 mm { }\n",$moreenv->{'problem_split'});
}
if ($remove_latex_header eq "NO") {
$current_output = &print_latex_header() . $current_output;
} else {
$current_output = &latex_header_footer_remove($current_output);
}
}
if ($syllabus_first) {
$current_output =~ s/\\\\ Last updated:/Last updated:/
}
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]';
my $newheader = $header_start.'{'.$header_line.'}';
if ($current_output=~/\\documentclass/) {
$current_output =~ s/\\begin\{document}/\\setlength{\\topmargin}{1cm} \\begin{document}\\noindent\\parbox{\\minipagewidth}{\\noindent$newheader$namepostfix}\\vskip 5 mm /;
} else {
my $blankpages =
'\clearpage\strut\clearpage'x$helper->{'VARS'}->{'EMPTY_PAGES'};
$current_output = '\strut\vspace*{-6 mm}\\newline'.
©right_line().' \newpage '.$blankpages.$end_of_student.
'\setcounter{page}{1}\noindent\parbox{\minipagewidth}{\noindent'.
$newheader.$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 {
my $r = shift;
if ($env{'request.course.id'}) {
my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
my $clientip = &Apache::lonnet::get_requestor_ip($r);
my ($blocked,$blocktext) =
&Apache::loncommon::blocking_status('printout',$clientip,$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->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'}) {
unless ($env{'form.postdata'} eq '/adm/navmaps') {
$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'}) {
unless ($env{'form.url'} eq '/adm/navmaps') {
$helper->{VARS}->{'symb'} = &Apache::lonnet::symbread($helper->{VARS}->{'postdata'});
}
}
}
if ($helper->{VARS}->{'symb'} ne '') {
$helper->{VARS}->{'symb'}=
&Apache::lonenc::check_encrypt($helper->{VARS}->{'symb'});
}
my ($resourceTitle,$sequenceTitle,$mapTitle,$cdom,$cnum);
if ($helper->{VARS}->{'postdata'} eq '/adm/navmaps') {
$cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
$cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
if ($env{'course.'.$env{'request.course.id'}.'.url'} eq
"uploaded/$cdom/$cnum/default.sequence") {
my $navmap = Apache::lonnavmaps::navmap->new();
if (ref($navmap)) {
my @toplevelres = $navmap->retrieveResources('',sub { !(($_[0]->is_map()) || ($_[0]->src =~ /^\/adm\/navmaps/)) },0,0);
if (@toplevelres) {
my @printable;
if ($perm{'pav'} || $perm{'pfo'}) {
@printable = @toplevelres;
} else {
@printable = $navmap->retrieveResources(undef,sub { $_[0]->resprintable() },0,1);
}
if (@printable) {
$sequenceTitle = 'Main Content';
$mapTitle = $sequenceTitle;
}
}
}
}
} else {
($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 $res_error;
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));
} elsif (($helper->{VARS}->{'postdata'} eq '/adm/navmaps') &&
($env{'request.course.id'} ne '')) {
if ($env{'course.'.$env{'request.course.id'}.'.url'} eq
"uploaded/$cdom/$cnum/default.sequence") {
$map = $env{'course.'.$env{'request.course.id'}.'.url'};
$url = $helper->{VARS}->{'postdata'};
}
}
if (($symb ne '') || ($map ne '')) {
if (!$userCanPrint) {
my $navmap = Apache::lonnavmaps::navmap->new();
if (ref($navmap)) {
my $res;
if ($symb ne '') {
$res = $navmap->getBySymb($symb);
} elsif ($map ne '') {
$res = $navmap->getResourceByUrl($map);
}
if (ref($res)) {
$res_printable = $res->resprintable(); #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 {
$res_error = 1;
}
} else {
$res_error = 1;
}
}
} 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);
}
if (($url eq '/adm/navmaps') && ($map eq $env{'course.'.$env{'request.course.id'}.'.url'})) {
$res_printable=0;
} else {
$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[_1]before selected','<br />').
"' variable='FINISHPAGE' />".
"<option text='".&mt('Extra space[_1]before selected','<br />').
"' variable='EXTRASPACE' type='text' />" .
"<option " .
"' variable='POSSIBLE_RESOURCES' type='hidden' />".
"<option text='".&mt('Space units[_1]check for mm','<br />').
"' 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' modallink='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" modallink="1" suppressNavmap="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 $optionText = '';
my $printSelector = 'map_incomplete_problems_seq';
my $nextState = 'CHOOSE_INCOMPLETE_SEQ';
my $textSuffix = '';
my $nocurrloc = '';
if ($helper->{VARS}->{'postdata'} eq '/adm/navmaps') {
$nocurrloc = 1;
}
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, $nocurrloc);
&Apache::lonxml::xmlparse($r, 'helper', $helperStates);
} else {
if (&printable($map_open, $map_close)) {
my $helperStates = &create_incomplete_folder_helper($helper, $map, $nocurrloc); # 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)) {
if ($helper->{VARS}->{'postdata'} eq '/adm/navmaps') {
$optionText = &mt('Selected [_1]Incomplete Problems[_2] [_3]not in a folder[_4]' . $textSuffix,
'<b>','</b>','<i>','</i>');
} else {
$optionText = &mt('Selected [_1]Incomplete Problems[_2] from folder [_3]' . $textSuffix,
'<b>','</b>','<b><i>'.$sequenceTitle.'</b></i>');
}
push(@{$printChoices},
[$optionText,
$printSelector,
$nextState]);
}
# Allow problems from sequence
if ($userCanPrint || &printable($map_open, $map_close)) {
if ($helper->{VARS}->{'postdata'} eq '/adm/navmaps') {
$optionText = &mt('Selected [_1]Problems[_2] [_3]not in a folder[_4]','<b>','</b>','<i>','</i>');
} else {
$optionText = &mt('Selected [_1]Problems[_2] from folder [_3]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>');
}
push @{$printChoices},
[$optionText,
'map_problems',
'CHOOSE_PROBLEMS'];
# Allow all resources from sequence
if ($helper->{VARS}->{'postdata'} eq '/adm/navmaps') {
$optionText = &mt('Selected [_1]Resources[_2] [_3]not in a folder[_4]','<b>','</b>','<i>','</i>');
} else {
$optionText = &mt('Selected [_1]Resources[_2] from folder [_3]','<b>','</b>','<b><i>'.$sequenceTitle.'</i></b>');
}
push @{$printChoices}, [$optionText,
'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" modallink="1" nocurrloc="'.$nocurrloc.'"',
'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" modallink="1" nocurrloc="'.$nocurrloc.'" suppressNavmap="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},
[&mt('Selected [_1]Incomplete Problems[_2] from [_3]entire course[_4] for [_5]selected people[_6]',
'<b>','</b>','<b>','</b>','<b>','</b>'),
'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}, [&mt('Selected [_1]Problems[_2] from [_3]entire course[_4]','<b>','</b>','<b>','</b>'), 'all_problems', 'ALL_PROBLEMS'];
push @{$printChoices}, [&mt('Selected [_1]Resources[_2] from [_3]entire course[_4]','<b>','</b>','<b>','</b>'), 'all_resources', 'ALL_RESOURCES'];
push @{$printChoices}, [&mt('Selected [_1]Problems[_2] from [_3]entire course[_4] for [_5]selected people[_6]','<b>','</b>','<b>','</b>','<b>','</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',
'Select Problem(s) to print',
'multichoice="1" suppressEmptySequences="0" addstatus="1" closeallpages="1" modallink="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" modallink="1" suppressNavmap="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" modallink="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,$codechoice,$code_selection,$namechoice) =
&generate_common_choosers($r,$helper,$map,$url,$isProblem,$symbFilter,$start_new_option);
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 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=<<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" modallink="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 '')
&& $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 || (($subdir eq '') && ($url eq '/adm/navmaps')))) {
push(@$printChoices,[&mt('Selected [_1]Resources[_2] from [_3]selected folder[_4] in course',
'<b>','</b>','<b>','</b>'),
'select_sequences','CHOOSE_SEQUENCE']);
my $escapedSequenceName;
if ($helper->{VARS}->{'SEQUENCE'} ne '') {
$escapedSequenceName = $helper->{VARS}->{'SEQUENCE'};
} elsif (($subdir eq '') && ($url eq '/adm/navmaps')) {
my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
if ($env{'course.'.$env{'request.course.id'}.'.url'} eq
"uploaded/$cdom/$cnum/default.sequence") {
$escapedSequenceName = $env{'course.'.$env{'request.course.id'}.'.url'};
}
}
#Escape apostrophes and backslashes for Perl
$escapedSequenceName =~ s/\\/\\\\/g;
$escapedSequenceName =~ s/'/\\'/g;
my $nocurrloc;
if (($subdir eq '') && ($url eq '/adm/navmaps')) {
$nocurrloc = 'nocurrloc="1"';
if ($perm{'pfo'}) {
push(@{$printChoices},
[&mt('Selected [_1]Problems[_2] from [_3]selected folder[_4] in course for [_5]selected people[_6]',
'<b>','</b>','<b>','</b>','<b>','</b>'),
'select_sequences_problems_for_students','CHOOSE_SEQUENCE_STUDENTS'],
[&mt('Selected [_1]Problems[_2] from [_3]selected folder[_4] in course for [_5]CODEd assignments[_6]',
'<b>','</b>','<b>','</b>','<b>','</b>'),
'select_sequences_problems_for_anon','CHOOSE_SEQUENCE_ANON1'],
[&mt('Selected [_1]Resources[_2] from [_3]selected folder[_4] in course for [_5]selected people[_6]',
'<b>','</b>','<b>','</b>','<b>','</b>'),
'select_sequences_resources_for_students','CHOOSE_SEQUENCE_STUDENTS1'],
[&mt('Selected [_1]Resources[_2] from [_3]selected folder[_4] in course for [_5]CODEd assignments[_6]',
'<b>','</b>','<b>','</b>','<b>','</b>'),
'select_sequences_resources_for_anon','CHOOSE_SEQUENCE_ANON2']);
if ($escapedSequenceName) {
my ($randomly_ordered_warning,$codechoice,$code_selection,$namechoice) =
&generate_common_choosers($r,$helper,$escapedSequenceName,$escapedSequenceName,
$isProblem,$symbFilter,$start_new_option);
my $resource_selector = <<RESOURCE_SELECTOR;
<state name="CHOOSE_STUDENTS2" 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>
<state name="SELECT_RESOURCES" title="Select Resources">
$randomly_ordered_warning
<nextstate>PRINT_FORMATTING</nextstate>
<message>(mark desired resources then click "next" button) <br /></message>
<resource variable="RESOURCES" multichoice="1" addstatus="1"
closeallpages="1" modallink="1" suppressNavmap="1" $nocurrloc>
<filterfunc>return $isNotMap;</filterfunc>
<mapurl>$escapedSequenceName</mapurl>
<valuefunc>return $symbFilter;</valuefunc>
$start_new_option
</resource>
</state>
RESOURCE_SELECTOR
my $anon3 = &generate_code_selector($helper,
'CHOOSE_ANON3',
'SELECT_RESOURCES',
$codechoice,
$code_selection,
$namechoice) . $resource_selector;
&Apache::lonxml::xmlparse($r, 'helper',$anon3);
}
}
}
if (($subdir eq '') && ($url eq '/adm/navmaps') && ($perm{'pfo'})) {
&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_SEQUENCE_STUDENTS" title="Select Sequence To Print From">
<message>Select the sequence to print resources from:</message>
<resource variable="SEQUENCE">
<nextstate>CHOOSE_STUDENTS</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_SEQUENCE_ANON1" title="Select Sequence To Print From">
<message>Select the sequence to print resources from:</message>
<resource variable="SEQUENCE">
<nextstate>CHOOSE_ANON1</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_SEQUENCE_STUDENTS1" title="Select Sequence To Print From">
<message>Select the sequence to print resources from:</message>
<resource variable="SEQUENCE">
<nextstate>CHOOSE_STUDENTS2</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_SEQUENCE_ANON2" title="Select Sequence To Print From">
<message>Select the sequence to print resources from:</message>
<resource variable="SEQUENCE">
<nextstate>CHOOSE_ANON3</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" modallink="1" suppressNavmap="1" $nocurrloc>
<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
} else {
&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" modallink="1" suppressNavmap="1" $nocurrloc>
<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
}
}
my $numchoices = 0;
if (ref($printChoices) eq 'ARRAY') {
$numchoices = @{$printChoices};
}
# Early out if nothing to print
if (!$numchoices) {
$r->print(&Apache::loncommon::start_page('Printing Helper').
'<h2>'.&mt('Unable to determine print context').'</h2>'.
'<p>'.&mt('Please display a resource, and then click the "Print" button/icon').'</p>');
my $prtspool=$r->dir_config('lonPrtDir');
my $footer = &recently_generated($prtspool);
$r->print($footer.&Apache::loncommon::end_page());
return OK;
}
# Generate the first state, to select which resources get printed.
Apache::lonhelper::state->new("START", "Select Printing Options:");
if (!$res_printable) {
my $noprintmsg;
if ($res_error) {
$noprintmsg = &mt('Print availability for current resource could not be determined');
} else {
my $now = time;
my $shownprintstart = &Apache::lonlocal::locallocaltime($res_printstartdate);
my $shownprintend = &Apache::lonlocal::locallocaltime($res_printenddate);
if (($res_printenddate) && ($res_printenddate < $now)) {
$noprintmsg = &mt('Printing for current resource no longer available (ended: [_1])',
$shownprintend);
} else {
if (($res_printstartdate) && ($res_printstartdate > $now)) {
if (($res_printenddate) && ($res_printenddate > $now) && ($res_printenddate > $res_printstartdate)) {
$noprintmsg = &mt('Printing for current resource is only possible between [_1] and [_2]',
$shownprintstart,$shownprintend);
} elsif (!$res_printenddate) {
$noprintmsg = &mt('Printing for current resource will only be possible starting [_1]',
$shownprintstart);
} else {
$noprintmsg = &mt('Printing for current resource is unavailable');
}
}
}
}
if ($noprintmsg) {
$paramHash = Apache::lonhelper::getParamHash();
$paramHash->{MESSAGE_TEXT} =
'<p class="LC_info">'.$noprintmsg.'</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));
}
if ($perm{'pav'}) {
if (!$startedTable) {
addMessage("<hr width='33%' /><table><tr><td align='right'>".
'<label for="LATEX_TYPE_forminput">'.
&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> '
.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"> </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));
}
}
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;
}
1;
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 Form Fields');
my $with=&mt('with Form Fields');
my $without=&mt('without Form Fields');
$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__
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>