backup/bb/README.txt

   1 Ziba Scott <ziba@linuxbox.com> 06/23/05
   2
   3 This is a utility to convert Blackboard Course export zip files into
   4 Moodle course export zip files. It has been successfully tested with
   5 Blackboard 5.5 and Moodle 1.4.1 and Moodle CVS. There is minimal
   6 Blackboard 6 support.  It will convert:
   7
   8     * Course Name/Title
   9     * Forum Topics
  10     * Course Documents
  11     * Assignments
  12     * External Links
  13
  14
  15 AUTOMATED OPERATION:
  16
  17   REQUIREMENTS FOR WEB INTERFACE:
  18     *Moodle 1.4.1 or greater
  19     *PHP 4.3 compiled with --enable-xslt  --with-xslt-sablot options
  20     (Check php.net for instructions on enabling xslt for your platform)
  21     *Alternatively, PHP 5 compiled with xml and xsl support (-with-xsl)
  22
  23   INSTALLATION:
  24     *Unpack this file into the "backup" directory
  25
  26
  27
  28 MANUAL OPERATION:
  29
  30   REQUIREMENTS:
  31
  32     *An XSLT 1.0 processor (like Sablotron)
  33     *A zipping utility
  34
  35   REQUIREMENTS FOR COMMAND LINE INTERFACE:
  36
  37     *Linux/Unix
  38     *PHP 4 compiled with --enable-xslt  --with-xslt-sablot options.
  39     *PHP 5 compiled with -with-xsl and the default xml support left in.
  40     *Apache with write access to /tmp
  41     *A commandline zipping utility
  42
  43   COMMAND LINE INSTRUCTIONS:
  44
  45     1) Download and uncompress the Blackboard export into a directory.
  46
  47     2) Copy bb2moodle.xslt into the Blackboard course directory.
  48
  49     3) Run your XSLT processor on imsmanifest.xml with bb2moodle.xslt
  50        as the input and moodle.xml as the output.  If you are using
  51        Sablotron on linux, this command will look like this:
  52           sabcmd bb2moodle.xslt imsmanifest.xml > moodle.xml
  53
  54     4) Create a moodle zip file with this structure:
  55        moodle.xml
  56        user_files/
  57        course_files/
  58
  59     5) Copy every subdirectory and its contents from the Blackboard
  60        export directory into the course_files directory.  This does
  61        not include the Blackboard XML files, only the course
  62        documents.  Your moodle zip file will now look similar to
  63        this:
  64        moodle.xml
  65        user_files/
  66        course_files/res0009/myfile.doc
  67        course_files/res0010/myotherfile.doc
  68        course_files/res0010/mypicture.jpg
  69
  70     6) Upload and restore your moodle zip file