nigel.stanger / XML
Browse code
- Initial efforts towards rolling the teaching calendar XSLT into the main
framework.
master
1 parent 59e15a0 commit e1f65e547d2270812b5074f044a9e75c86d19e2c
nstanger authored on 12 Jun 2012
Patch
Showing 4 changed files
View
6
■■■■■
 Makefile
 
MODULES:=$(shell $(FIND) modules -type f -name "*.xml" )
 
 
all: xml2html.xsl xml2xhtml.xsl xml2latex.xsl xml2xelatex.xsl oracle-docs.xsl
all: xml2html.xsl xml2xhtml.xsl xml2latex.xsl xml2xelatex.xsl oracle-docs.xsl calendar_dates.xsl
 
 
xml2html.xsl xml2latex.xsl xml2xelatex.xsl: format-master.xml $(MODULES) xml2xslt.xsl oracle-docs.xsl Makefile
$(call xslt,$<,xml2xslt.xsl,$(call xslt_parameter,target-format,$(@:xml2%.xsl=%))) > $@
xml2xhtml.xsl: format-master.xml $(MODULES) xml2xslt.xsl oracle-docs.xsl Makefile
$(call xslt,$<,xml2xslt.xsl,$(call xslt_parameter,target-format,$(@:xml2%.xsl=%))) > $@
 
 
calendar_dates.xsl: generate_calendar_dates.php
php $< > $@
 
 
oracle-docs.xsl: oracle-docs.perl
perl $< '.*' xslt > $@
 
 
View
224
■■■■■
 generate_calendar_dates.php 0 → 100755
<?php
 
/*
File: $Id$
This script generates an XSLT include file that contains templates specifying the date ranges for every week of the three main teaching periods through the year (i.e., summer school, first semester, second semester). Simply set the configuration as outlined below and make to regenerate the templates.
*/
 
 
/*
Teaching period configuration. It's easily extensible to a new teaching period simply by adding a new specification for that period. The key should be mixed-case alphanumeric (i.e., no whitespace, no punctuation or other special characters). The components of each period specification are:
start_date: The date of the first day of the first week of the period.
num_weeks: The total number of weeks in the period, /including/ any
breaks (e.g., 13 teaching weeks plus 1 week mid-semester
break = 14 weeks).
break_weeks: A list of breaks that occur during the teaching period.
Each is specified by the start (break_start) and end
(break_end) week. If a break is only one week long, then
break_start and break_end should be equal. If there are no
breaks in the teaching period, include a single break
specification with both break_start and break_end set to zero.
The list should ideally be in ascending order, but the
script doesn't assume this and sorts the list anyway. Weeks
are numbered by absolute calendar week number (i.e., week
1 is the first calendar week of the year). The date of the
first Monday of the year is stored in $first_monday below
(everything is Monday-indexed).
*/
$first_monday = new DateTime( "2012-01-02" );
 
$periods = array(
'SummerSchool' => array(
'first_week' => 2,
'last_week' => 7,
'break_weeks' => array(
array(
'break_starts' => 0,
'break_ends' => 0,
),
),
),
'SemesterOne' => array(
'first_week' => 9,
'last_week' => 22,
'break_weeks' => array(
array(
'break_starts' => 15,
'break_ends' => 15,
),
),
),
'SemesterTwo' => array(
'first_week' => 28,
'last_week' => 41,
'break_weeks' => array(
array(
'break_starts' => 35,
'break_ends' => 35,
),
),
),
'FullYear' => array(
'first_week' => 9,
'last_week' => 41,
'break_weeks' => array(
array(
'break_starts' => 23,
'break_ends' => 27,
),
array(
'break_starts' => 15,
'break_ends' => 15,
),
array(
'break_starts' => 35,
'break_ends' => 35,
),
),
),
);
 
 
// A couple of handy date intervals: four days to the end of the current week,
// and seven days to the start of next week.
$plus_four_days = new DateInterval( 'P4D' );
$plus_seven_days = new DateInterval( 'P7D' );
 
 
// Header boilerplate.
print<<<EOT
<?xml version="1.0" encoding="utf-8"?>
<!-- Do not edit! Automatically generated by generate_calendar_dates.php! -->
 
<stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<!--
General template for formatting teaching dates.
-->
 
 
EOT;
 
// printf( " <template name=\"%sTeachingDate\" match=\"%sTeachingDate\">\n" );
// print( " <common>\n" );
// print( " <xsl:variable name=\"period-start\" as=\"xs:date\">\n" );
// print( " <xsl:if test=\"@period-start\">\n" );
// print( " <xsl:value-of select=\"@period-start\">\n" );
// print( " </xsl:if\n" );
// printf( " <xsl:text>%s</xsl:text> \n", );
// print( " </xsl:variable name=\"period-start\">\n" );
// <xsl:variable name="break-start" select="@break-start" />
// <xsl:variable name="period-start" select="@period-start" />
// <xsl:variable name="period-start" select="@period-start" />
// <xsl:value-of select="infosci:format-number( node() )" />
// </common>
// </template>
 
 
foreach ( $periods as $period_name => $period_data )
{
$week_start = clone( $first_monday );
// Jump forward the correct number of weeks to the start of the teaching period.
$week_start->add( new DateInterval( sprintf( "P%dD", ( $period_data['first_week'] - 1 ) * 7 ) ) );
$week_number = 0;
$num_breaks = 0;
// Grab the first break week off the front of the list.
sort( $period_data['break_weeks'] );
$break_week = array_shift( $period_data['break_weeks'] );
for ( $week = $period_data['first_week']; $week <= $period_data['last_week']; $week++ )
{
$week_end = clone( $week_start );
$week_end->add( $plus_four_days );
// Handle break weeks.
if ( ( $week >= $break_week['break_starts'] ) && ( $week <= $break_week['break_ends'] ) )
{
if ( $week == $break_week['break_starts'] )
{
$num_breaks++;
// Work out the end date of the break.
$break_end = clone( $week_start );
// Note: +4 days to get to Friday.
$break_end->add(
new DateInterval(
sprintf( "P%dD", ( ( $break_week['break_ends'] - $break_week['break_starts'] ) * 7 ) + 4 )
)
);
// Output template for inclusion in paper calendar.
printf( "\t<xsl:template name=\"%sBreak%d\" match=\"%sBreak%d\">\n",
$period_name,
$num_breaks,
$period_name,
$num_breaks
);
printf( "\t\t<xsl:text>%s</xsl:text>\n",
// If the week start and end dates are in the same month, we only
// need to output the month name once.
( $week_start->format( 'n' ) == $break_end->format( 'n' ) ) ? $week_start->format( 'j' ) : $week_start->format( 'j M' )
);
print( "\t\t<xsl:call-template name=\"endash\" />\n" );
printf( "\t\t<xsl:text%s</xsl:text>\n", $break_end->format( 'j M' ) );
print( "\t</xsl:template>\n\n" );
} // if current week == first week of break
if ( $week == $break_week['break_ends'] )
{
// Grab the next break week off the front of the list.
$break_week = array_shift( $period_data['break_weeks'] );
} // if current week == last week of break
} // if current week is a break week
else
{
$week_number++;
// Output template for inclusion in paper calendar.
printf( "\t<xsl:template name=\"%sWeek%d\" match=\"%sWeek%d\">\n",
$period_name,
$week_number,
$period_name,
$week_number
);
// If the week start and end dates are in the same month, we only
// need to output the month name once.
if ( $week_start->format( 'n' ) == $week_end->format( 'n' ) )
{
printf( "\t\t<xsl:text>%s</xsl:text>\n", $week_start->format( 'j' ) );
print( "\t\t<xsl:call-template name=\"endash\" />\n" );
printf( "\t\t<xsl:text>%s</xsl:text>\n", $week_end->format( 'j' ) );
print( "\t\t<xsl:call-template name=\"newline\" />\n" );
printf( "\t\t<xsl:text>%s</xsl:text>\n", $week_end->format( 'M' ) );
} // if same month
else
{
printf( "\t\t<xsl:text>%s</xsl:text>\n", $week_start->format( 'j M' ) );
print( "\t\t<xsl:call-template name=\"endash\" />\n" );
printf( "\t\t<xsl:text>%s</xsl:text>\n", $week_end->format( 'j M' ) );
} // else different months
printf( "\t</xsl:template>\n\n" );
} // else normal teaching week
$week_start->add( $plus_seven_days );
}
}
 
 
// Footer boilerplate.
print( "</xsl:stylesheet>\n" );
?>
 
View
14
■■■■■
 modules/paper-calendar.xml 0 → 100755
<?xml version="1.0" encoding="utf-8"?>
 
<!--
Elements and functions for generating teaching period dates.
-->
 
<stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 
 
 
 
</stylesheet>
View
5
■■■■■
 xml2xslt.xsl
<xsl-out:variable name="cvs-user" select="$cvs-id-tokens[6]" />
 
<!-- Include the generated Oracle documentation code. -->
<xsl-out:include href="oracle-docs.xsl" />
 
<!-- Include the generated teaching calendar dates. -->
<!--
<xsl-out:include href="calendar_dates.xsl" />
-->
 
<!--
We're going to use the text encoding in a few different places, so let's work out what it should be now.
-->