sphinxcontrib-jupyter
sphinxcontrib-jupyter copied to clipboard
[FEAT]: Improve ability to have multiple TOC
The current lecture site: python.quantecon.org implements multi-tocs for various streams such as graduate and undergraduate. It would be nice to develop a better way to specify this information rather than index proliferation as this is hard to edit and maintain.
Ideas:
- Use
metadatato build various supportingindexfiles such as introducing atocdirective for build the necessary objects and the author would label each file in a category - Build a more advanced web object (i.e. network of lectures diagram) that has a configuration file
@DrDrij would you have any idea how we could build a nicer object for presenting toc for various dimensions. One idea would be a network diagram with clickable nodes showing the flow of various streams.
I think the steps would be:
- [ ] explore what we want as a
tocobject that would support the lectures - [ ] figure out how to get
sphinxcontrib-jupyterto build it programmatic ally.
Or break the project up into two projects :-)
thanks @jstac forgot to add that option.
Interesting. Comparing the toc I see there are a handful of lectures specific to each branch.
You've mentioned D3 before @mmcky I think. Here is a gallery of examples: https://github.com/d3/d3/wiki/Gallery Anything appealing?
Assuming the smiley @jstac as a hint of sarcasm? :)
Just a hint :-)
I might discuss this with Tom though. It is a bit of a monster and breaking up the lectures would reduce compile time. The cost would be more difficult cross refs.