make scripts dir as a module, to be included by find_packages() of setuptools

[thammegowda]

Closes #210

[choldgraf]

I'll merge this and push a new minor version of jupyterbook, then can you check if it works on your end as expected?

[thammegowda]

@choldgraf
I had already tested (with local installation)

• by removing the pip installed remote package
• reinstalling locally pip install . from the root of this repo (after the fix)

it updated the toc. I dont think it would be any different than remote pip install. I can test it again if needed.

Feedback: the toc generated by generate_toc.py was not usable for me.
Mainly, it didn't preserve the subsections and order (which are a must-have for me).
For now, I am hand creating the toc (since I can define order and subsections the way I want).

I dont know if you are planning, here are some suggestions for future enhancements :

1. Deterministic sorting (alphanumeric should be okay) to preserve the order
2. sub-directories maybe be treated as sub-sections
3. Before overwriting, take backup of tac file, or update the yaml preserving much of metadata: numbered or not etc.

[choldgraf]

@thammegowda totally agree - the TOC script can definitely be improved. Wanna create an issue for this enhancement so we can track it? I think some of those things will actually be tricky (you'd need to encode the proper ordering of the TOC in the naming of the folders and/or sub-folders) but it's worth improving. Initially the TOC was just meant to be a quick helper for people to get started, with the idea that they'd manually update the TOC after this. But if there's a way to improve its functionality without making it super complicated, I'm for it