Closed Omikhleia closed 1 year ago
Comment on parts: Jupyter has this interesting structure -- https://jupyterbook.org/en/stable/structure/toc.html#use-parts-to-organize-chapters
format: jb-book
root: index
parts:
- caption: Name of Part 1
chapters:
- file: path/to/part1/chapter1
- file: path/to/part1/chapter2
sections:
- file: path/to/part1/chapter2/section1
- caption: Name of Part 2
chapters:
- file: path/to/part2/chapter1
- file: path/to/part2/chapter2
sections:
- file: path/to/part2/chapter2/section1
And automatic header shifting for Markdown -- https://jupyterbook.org/en/stable/structure/sections-headers.html#how-headers-and-sections-map-onto-to-book-structure -- although they use a “next-header-deeper” nesting strategy which I find weird.
There are some good ideas to consider there.
Closes #18
To do:
\include
s a master document in another document (lol): fix and documentworking example - or tryusing it for the resilient documentation, and get rid of SIL as much as doablecontent
section might not be sufficient, we may need an object (file, format) in case the extension is not one expected and the appropriation logic failsMoved out of scope: