🇨🇴 Una base de datos de cursos en diferentes lenguajes. 🇫🇷 Une base de données de cours dans différents langages. 🇳🇴 En database med kurs på forskjellige språk. 🇺🇸 A flat-file database of courses in multiple languages.
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.

52 lines
1.3 KiB

  1. # THIS DOCUMENT IS A DRAFT
  2. > Contributions welcome!
  3. ## Courses Model
  4. Each Course MUST have:
  5. - one Identifier _(unique, URL-safe, path-safe)_
  6. - one Title
  7. - one Content
  8. - one Topic
  9. - one Language `ISO 639-1` (two letter code, eg: `fr`)
  10. Each course MAY have
  11. - one or more Courses as dependencies
  12. - one or more Tags
  13. Keep it simple, for now. There will be room for events (class projects, etc.) later.
  14. ## Course File Format
  15. We should probably follow something akin to [what Grav does](https://learn.getgrav.org/15/content/content-pages).
  16. - A frontmatter in YAML holding metadata
  17. - The course in Markdown + HTML
  18. The markdown enhancements should be documented here as well.
  19. Ideas:
  20. - use gitlab's flavor as base, since it has latex and mermaid already
  21. - https://zestedesavoir.com/ has a pretty good markdown flavor as well (information and warning bubbles), tailored for education
  22. ## Possible driver implementations
  23. - with Grav
  24. - with Moodle
  25. - with schema.org (jsonld?) (may use Grav for this)
  26. - with OAI-PMH (may use Grav for this?)
  27. Multiple frontends may be buit to display these courses.
  28. ## Tips
  29. http://flagpedia.net/emoji
  30. ## TODO
  31. - Look up https://schema.org/Course and comply somehow
  32. - Look up [OAI-PMH](ttp://www.unit.eu/ressources-educatives-libres/valoriser-des-rel) and comply somehow