bayesian-stats-modelling-tutorial icon indicating copy to clipboard operation
bayesian-stats-modelling-tutorial copied to clipboard

Steps for html version of tutorial

Open hugobowne opened this issue 5 years ago • 2 comments

@ericmjl Today we discussed steps for an html version of tutorial:

  • add notebooks to subdir of /docs
  • make sure they execute programmatically: can do this manually by making sure all cells execute in order; can you remind me of how to automate this step?
  • Travis will build and create github pages

Did I get that mostly correct?


Update from @ericmjl:

  • Place custom source code in src/bayes_tutorial/<something_appropriate>.py. Then import it back into the notebook.
  • Use the matplotlibrc file that @hugobowne provided to style all of the plots.
  • We should probably put this in a "style guide" documentation.

hugobowne avatar Oct 29 '20 03:10 hugobowne

@hugobowne yep, that's right!

can do this manually by making sure all cells execute in order; can you remind me of how to automate this step?

Use nbconvert to programmatically execute the notebooks. Ideally they should execute fast, to keep build times short.

ericmjl avatar Oct 29 '20 16:10 ericmjl

@hugobowne I updated your comment with further details, so we both have a reference in this issue right at the top of the thread.

ericmjl avatar Nov 11 '20 14:11 ericmjl