Skip to content

Latest commit

 

History

History
66 lines (47 loc) · 2.11 KB

README.md

File metadata and controls

66 lines (47 loc) · 2.11 KB
Raw

llab-to-edx

This too takes in course content from our "llab" formatted courses and mostly turns them into something usable for uploading to edX.

TOC -- coming someday.

Overview

Right now there are a bunch of single-use style scripts:

* apcsa_simple_edx_build.js
* apcsa_test.js
* edc_test.js (start with this, probably)

These do various content transformations, and are somewhat specific to our needs.

Basically, the scripts in a topic file, which is a list of HTML pages organized into sections. The script will process each HTML file, and modify the content as necessary to work in edX. There are a few common modifications:

Each HTML file is designed to be 1 page in edX. Some HTML pages are split in "sections" in edX, because that have interactive quizzes.

  • CSS mods:
    • We "compile" the llab CSS into 1 file, and link that at the top of each course page in edX.
  • JS Mods:
    • A JS file edx-llab-hack.js is inserted at the top of each page.
  • Quizzes:
    • LLAB includes an HTML-style quiz. There's a set of Python tools that translate this to the edXML / OLX formatted XML.
  • URL transformations:
    • all the images and files we link to will have different URLs on edX.
    • The inline-replaces those URLs with ones edX will translate correctly.
    • Some URLs (like in-course content links) still need to be manually translated.
  • Section Headings:
    • Removing the first <h2> page title
    • Inserts section heading text.

Running The Builder

Building EDC content in curriculum/bjc-r:

DO:

node edc_test.js <unit-num> <unit-num...>

Accessibility Fixes

Example Courses

Misc. Notes

CSS Processing

  • Use built in rules
  • Rules are executed in the order they are defined.
    • This is something that can be relied on so you can create dependencies

Requirements