jbusecke / cookiecutter-science-project

Cookiecutter template for science analysis projects
MIT License
86 stars 13 forks source link

jupyter-book integration #28

Open dcherian opened 3 years ago

dcherian commented 3 years ago

Nice cookiecutter.

Just a suggestion: it's been really useful to have my notebooks folder built with jupyter-book and automatically deploying to Github Pages. Very nice for discussing with collaborators.

See https://github.com/dcherian/pump for an example, there's a github workflow and a bunch of yaml files in notebooks/. You can set it to only render the notebooks (_config.yml) and not rerun them, so no worries about datasets not being accessible on the cloud etc...

Rendered here: https://cherian.net/pump/intro.html

jbusecke commented 3 years ago

Cool idea! Can you comment on jupyter book? Having the ability to comment on jupyter notebooks somehow would be the last thing I really want to have for my workflow!

dcherian commented 3 years ago

https://jupyterbook.org/interactive/comments.html

jbusecke commented 3 years ago

Oh that is hella cool. Need to check this out for sure!