sphinxcontrib-jupyter icon indicating copy to clipboard operation
sphinxcontrib-jupyter copied to clipboard

[FEAT]: Improve ability to have multiple TOC

Open mmcky opened this issue 5 years ago • 5 comments

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:

  1. Use metadata to build various supporting index files such as introducing a toc directive for build the necessary objects and the author would label each file in a category
  2. 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.

mmcky avatar Nov 18 '19 23:11 mmcky

I think the steps would be:

  • [ ] explore what we want as a toc object that would support the lectures
  • [ ] figure out how to get sphinxcontrib-jupyter to build it programmatic ally.

mmcky avatar Nov 18 '19 23:11 mmcky

Or break the project up into two projects :-)

jstac avatar Nov 18 '19 23:11 jstac

thanks @jstac forgot to add that option.

mmcky avatar Nov 18 '19 23:11 mmcky

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? :)

DrDrij avatar Nov 19 '19 10:11 DrDrij

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.

jstac avatar Nov 19 '19 17:11 jstac