Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Courses
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
6
Issues
6
List
Board
Labels
Milestones
Merge Requests
4
Merge Requests
4
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
M3P2
Courses
Commits
0e469ec0
Commit
0e469ec0
authored
Mar 14, 2019
by
Goutte
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add more information about the course file format.
Also add a reference to unit.eu's protocol OAI-PMH. Looks nice.
parent
1f4252ba
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
33 additions
and
1 deletion
+33
-1
SPECIFICATIONS.md
SPECIFICATIONS.md
+33
-1
No files found.
SPECIFICATIONS.md
View file @
0e469ec0
# THIS DOCUMENT IS A DRAFT
> Contributions welcome!
## Courses Model
## Courses Model
Each Course MUST have:
Each Course MUST have:
...
@@ -14,7 +18,35 @@ Each course MAY have
...
@@ -14,7 +18,35 @@ Each course MAY have
-
one or more Courses as dependencies
-
one or more Courses as dependencies
-
one or more Tags
-
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
](
https://learn.getgrav.org/15/content/content-pages
)
.
-
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
http://flagpedia.net/emoji
## TODO
## TODO
-
Look up https://schema.org/Course and comply somehow
-
Look up https://schema.org/Course and comply somehow
\ No newline at end of file
-
Look up
[
OAI-PMH
](
ttp://www.unit.eu/ressources-educatives-libres/valoriser-des-rel
)
and comply somehow
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment