pytti-tools / pytti-book

PyTTI Documentation and Tutorials
https://pytti-tools.github.io/pytti-book/intro.html
36 stars 10 forks source link

break up the crash course from a single notebook into multiple separate files for improved caching behavior #19

Closed dmarx closed 2 years ago

dmarx commented 2 years ago

https://jupyterbook.org/structure/sections-headers.html#toc-structure

dmarx commented 2 years ago

{include} myst directive might be what I need here

section/headings functionality really only nests headers as I'm picturing if using latex output, otw jupyter-book specifies a 1-1 mapping from source files to generated html pages without a clear mechanism for concatenating.

dmarx commented 2 years ago

more on directives: https://myst-parser.readthedocs.io/en/latest/syntax/syntax.html

dmarx commented 2 years ago

this could be useful for building tables of image studies: https://myst-parser.readthedocs.io/en/latest/syntax/optional.html#substitutions-with-jinja2

dmarx commented 2 years ago

{include} directive might cause issues with links (assuming it's even supported). could try {literalinclude}: https://myst-parser.readthedocs.io/en/latest/sphinx/use.html?highlight=%7Binclude%7D#include-markdown-files-into-an-rst-file

dmarx commented 2 years ago

yeah... increasingly looking like my use case isn't supported. maybe add an issue to the jupyter-book repo

dmarx commented 2 years ago

closing this as nofix, I've sunk enough time into this.