Make necessary changes for `make html` docs target

[jpolchlo]

From a reasonably fresh install, from the docs dir, make html fails due to needing sphinx, sphinx-rst-theme, nbsphinx, and pandoc. There should be a requirements.txt in that folder or some make target to add the needed packages.

[jpolchlo]

There is also some suggestion that the nbsphinx dependency should be eliminated, though perhaps that should be a separate issue.

[bhavybarca]

@jpolchlo is this issue still open,if yes could you assign it to me?

[jbouffard]

Hey @bhavybarca! This issue is still open, and I'd be happy to assign it to you.

[jbouffard]

Actually, I'm not sure if I can assign you to this issue. However, we'll make sure that no one else picks it up.

[bhavybarca]

hey @jpolchlo , okay so from what i understood i need to make a new file "requirements.txt" and add the relevant dependencies line by line. that's all right? but i don't see any file called "html" in the doc directory on which "make" is running, is it because i am just viewing the code on github and not cloned on my pc ?

[jbouffard]

Hello, @bhavybarca! Yes, that's correct. That'll be added to the docs directory. html is not a file, but rather a command that you pass to make. When you run make html, a directory called, _build will be created that has a folder called html in it.