search

naturalis / mebioda

Course repository for Methods in Biodiversity Analysis
MIT License
21 stars 81 forks source link

export / integration with blackboard #86

Closed rvosa closed 4 years ago

rvosa commented 5 years ago

Assuming you wanted the contents of a markdown document to end up on blackboard, there is the option of doing this as a SCORM object. This is somewhat attractive because such objects can also contain quizzes and other interactive content, and blackboard (at least the version used by Leiden University) is able to import these so they can be added to courses. Here are the steps:

Convert Markdown to HTML

There are numerous options for this. One option is to make a single HTML file, for example like this:

pandoc --from markdown --to=html --css=pandoc.css \
--standalone --out=lecture1.html lecture1.md

In this case, the styling can be much improved by using this pandoc.css

Another option is to make slides, e.g. as follows:

pandoc --to=slidy --standalone --out=lecture1.html lecture1.md

In this case, you may achieve more visually appealing results using some of the other options besides slidy, although the other ones require more supporting file scaffolding. See here

  1. package the html (with all assets) into a SCORM archive using libscorm
  2. upload the archive to blackboard (Content > Build content > Content Package (SCORM))
rvosa commented 4 years ago

We're not doing this for the following reasons:

  1. this is all rather buggy due to different SCORM implementations. Interactive content never worked, for example.
  2. we run the risk of de-synchronizing between the repo and the blackboard
  3. the github interfaces (gh-pages, gitbook) are far superior