I absolutely love the quantecon project and it has inspired me to use jupyter-notebooks + sphinx to try to build a couple courses (albeit on a far more modest scale) on applied micro theory and trade/development topics for a couple courses aimed at undergrad and MA students.
Could you help me understand how you are using Sphinx to generate your site? I understand the basics of how Sphinx is used to generate static sites and I clearly see how, say, the notebook gallery was generated from the notebooks.rst file in the github repo but I’m failing to find the similar restructured text files on the repo(s) to build the main textbook/course site page http://quant-econ.net/py/index.html (or the PDF). I see some of the content files (e.g. solution notebooks) on the repo but I don’t see the main text which must have involved a fair bit of latex. You appear to be using Sphinx to tie together content from ipython/ijulia notebook, latex, py, and perhaps other formats but I’m failing to see how all the pieces are tied together? Am I failing to see files in the repo, or is some of the content not there?
Could you explain briefly how you generate the main textbook/course site? Are you using any special scripts or extensions? I’m not looking for a lengthy explanation just a few pointers to help save me (and perhaps others) some time in trying to recreate something similar.
You are providing a huge public service to the Economics profession with this material. It’s not just that you are making a lot of really interesting economic material much easier to understand and access, you’re also introducing new tools: python, julia, git, and Sphinx which are way underused in our field. This is fun. Thanks!