mkdocs-h5p 0.1.0

MkDocs plugin for embedding H5P files in Markdown using h5p-standalone.

mkdocs-h5p

Embed H5P packages in MkDocs Markdown using tunapanda/h5p-standalone.

The plugin extracts each referenced .h5p file during mkdocs build and injects the standalone H5P player into the generated page.

Installation

pip install -e .

Enable the plugin in mkdocs.yml:

plugins:
  - search
  - h5p

Markdown Usage

Use the image-like syntax with h5p as the alt text:

![h5p](activities/example.h5p)

You can also use the explicit shortcode form:

{{ h5p("activities/example.h5p") }}

Paths are resolved relative to the Markdown file first, then relative to docs_dir.

Configuration

plugins:
  - h5p:
      h5p_dir: assets/h5p
      player_url: https://cdn.jsdelivr.net/npm/h5p-standalone@3.8.0/dist
      frame: true
      full_screen: true
      export: false
      embed: false
      copyright: false
      player_options:
        icon: true

player_url points to the dist directory for h5p-standalone. By default it uses jsDelivr with version 3.8.0 pinned. For offline sites, download the h5p-standalone dist files into your MkDocs docs folder and set player_url to that local URL.

Notes

Some H5P exports do not include every required library. The standalone player can only run content when the .h5p package includes the libraries it needs.