ericmjl/bayesian-stats-modelling-tutorial

Steps for html version of tutorial

hugobowne opened this issue · 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 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.

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