1
0
mirror of https://github.com/google/comprehensive-rust.git synced 2025-04-28 01:49:05 +02:00
Dustin J. Mitchell 4815264e2d
Add mdbook-course to handle parsing frontmatter (#1224)
In v2 of the course, I'd like to include an estimate of the time to be
spent on each segment in the Markdown file. I think a good place for
such metadata is in the frontmatter.

For review purposes, though, I just want to display that information.
So, this is a start at a new mdbook preprocessor that just separates out
the frontmatter and includes it in a `<pre>` block. Eventually, I'd like
to parse it and put the time in the speaker notes.

---------

Co-authored-by: Martin Geisler <martin@geisler.net>
2023-09-20 10:01:53 -04:00

18 lines
546 B
Markdown

# mdbook-course
This is an mdBook preprocessor to handle some specific details of Comprehensive
Rust.
## Frontmatter
The preprocessor parses "frontmatter" -- YAML between `---` at the beginning of
a Markdown file -- and removes it from the rendered result. At the moment, to
aid review of the new course, it places this content in a `<pre>` block.
## Future Work
- Parse the `minutes` property from frontmatter and
- Generate a course timeline
- Include timing information in the speaker notes
- Generate per-segment tables of contents.