You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.3 KiB
1.3 KiB
THIS DOCUMENT IS A DRAFT
Contributions welcome!
Courses Model
Each Course MUST have:
- one Identifier (unique, URL-safe, path-safe)
- one Title
- one Content
- one Topic
- one Language
ISO 639-1(two letter code, eg:fr)
Each course MAY have
- one or more Courses as dependencies
- one or more Tags
Keep it simple, for now. There will be room for events (class projects, etc.) later.
Course File Format
We should probably follow something akin to what Grav does.
- A frontmatter in YAML holding metadata
- The course in Markdown + HTML
The markdown enhancements should be documented here as well.
Ideas:
- use gitlab's flavor as base, since it has latex and mermaid already
- https://zestedesavoir.com/ has a pretty good markdown flavor as well (information and warning bubbles), tailored for education
Possible driver implementations
- with Grav
- with Moodle
- with schema.org (jsonld?) (may use Grav for this)
- with OAI-PMH (may use Grav for this?)
Multiple frontends may be buit to display these courses.
Tips
TODO
- Look up https://schema.org/Course and comply somehow
- Look up OAI-PMH and comply somehow