Convert DocBook to SCORM

Overview

Pyxx DocBook 2 SCORM Converter is the command-line Ant-based java application intended to generate SCORM compliant packages from DocBook sources. Both SCORM 1.2 and SCORM 2004 are supported. Converter is free to use but not open source. It uses Docbook XSLT to generate HTML resources.

Application is open-source, source and binary files are available through the Google Code project page.

The main part of the application is the Ant build file that calls XSL transformation and IMS manifest generation processes. See below for instructions on configuration and running. Users familiar to DocBook XSL and Apache Ant may find many additional configuration options if they look into the build.xml file. Feel free to contact Sasha Philippov: philya@gmail.com if you have questions or comments regarding the software.

See more on

Download

Download version 1.3.014 from the Google Code.

Setup

IMPORTANT: converter is based on Apache Ant build utility. Before setting up the converter you should install Java, Apache Ant and configure the environment (set JAVA_HOME, ANT_HOME and PATH environment variables). See “Installing Ant” section in the Apache Ant User Manual.

Extract contents of the archive to the chosen directory. In that directory run the following command:

ant configure

Setup is finished Ok if script execution completed with the message “BUILD SUCCESSFUL”.

Usage

Go to the DocBook2SCORM home directory. This is directory where the build.xml file lies.

You could run the sample conversion by the command:

ant

That would make SCORM package from DocBook sources located in the sample directory.

Use following command-line arguments to specify conversion parameters:

  • -DdocbookSrc=<filename> specifies location of the source DocBook XML file
  • -DpackageFile=<filename> specifies name of the SCORM package file to be generated
  • -DresourcesDir=<filename> specifies directory containing static resources for content package, such as images, styles etc.
  • -DscormVersion=<version> specifies the SCORM version for generated package. Allowed values are: 12 for SCORM 1.2 and
  • 13 for SCORM 2004. Default value is 12.

Unix Example:

ant -DscormVersion=13 \
-DdocbookSrc=sample/src/manual.xml \
-DpackageFile=sample/package.zip \
-DresourcesDir=sample/resources