npryce/courseware

XML document type and tool chain for creating training courses

courseware's Issues

Customizable master and boilerplate pages

Make it easy to build courses with different boilerplate pages at the start and master pages.

For example, I would like to distribute the same courseware under Creative Commons non-commercial license and under a commercial license. The freely available version should be branded with the Creative Commons license on all slides and handout pages.

include handouts in presenter notes, but not student notes

Image attributions and licensing

Page of image attributions at end of document or attribution in small text at footer of page.

Link from exercise element in presentation to the exercise document

Link from exercise element in presentation to the exercise document (e.g. clicking on it will load the exercise in XXE)

Prompt elements in notes.

An inline "prompt" element that highlights text in presenter notes, to act as prompts that can be skim-read when presenting.

Copyrights on Presentations

Currently copyrights are assigned to courses.

It would be nice if they were assigned to presentations, and then collated and reported at the front of the notes for courses.

Presenter instructions for exercises

Allow exercises to contain both student handouts and presenter instructions (both in DocBook format)

Change default visual background to white

Use XLink and XInclude instead of custom attributes for linking

This would let us take better advantage of tools and libraries that build on these XML standards.

relative links don't work properly

Visual URLs are resolved relative to the course document, not to the presentation document that contains the link.

The stylesheets and build should not impose any file or directory structure on the courseware. Given a course file, they should resolve all the necessary content by links in the files.

Sort out font handling.

Allow more interesting fonts than raw PDF

Generate slides directly from presentation files that are not linked from a course file

Add a bookmark with slide title for each slide.

still problems with output/depends

on os/x

readlink: illegal option -- f
usage: readlink [-n] [file ...]

Use XML namespace

Currently the Courseware doctype does not use an XML namespace. Maybe it should.

Makefile does not support handouts

Add timing attributes to slides

Ant build fails if a course has no handouts

(Have not committed the Ant build yet, so this may be a non-issue)

Allow slides to be excluded from notes

Sometimes you want a slide in a presentation but it's wasteful to put it in the notes. E.g. a blank screen during a demo or hands-on exercise.

There should be a way of marking a slide as only to be included in a presentation slide deck, not a notes document.

Term List

Add a Term List element containing one or more Term Definitons, each containing a Term and a Definition.

I (Nat) have added these elements to the schema and XXE configuration, but not to the XSLT.

Have student and presenter content for inline exercises

Allow linked exercises

In courses, allow an exercise element to contain a fileref attribute or inline content

Share parts of a presentation among presentations without copy-and-pasting.

I’d like to be able to share parts of a presentation among presentations without copy-and-pasting. We need a “section” or "snippet" element that contains a sequence of slides. A presentation can include sections from either other presentations or from sections stored alone in files.

Collate presentation copyrights up to course level

Presentations can now have copyrights, rather than just the entire course.

It would be nice if they were automatically collated and reported at the front of the notes for courses.

Notes as list

I’d like the notes for a slide to be a list of note elements, each of which can contain (optional) student and presenter elements. This would let presenter notes to be associated with a part of the student notes and aligned with them in the PDF output to help presenters understand the notes.

Upgrade to XSLT 2.0

This will make it easier to fix other issues.