This repository has been forked off of the popular GitHub - mitmath/18337: 18.337 - Parallel Computing and Scientific Machine Learning course website to serve as a “book”/collection of lecture notes that can continue to grow apart from the yearly course structure. This website is something that can be depended on to stay for the known future. Additional content will continue to be compiled here and into the Julia-based Youtube channel:
That sounds like an interesting solution. I would love to get help converting it to something more suitable. Three years ago I didn’t plan for it to be such a thing
When PDFs are not needed, skip Books.jl and go for PlutoStaticHTML.jl which is the basis for the Julia tutorials template. It’s easier to use, more reliable and has better parallel evaluation.
Finally came up with a clever way to do this with minimal changes to the lecture material. Check it out!
If this looks good then I can add the rest of the lectures and be done.
What I Did
Each Julia Markdown Document gets weave-d with a custom md2html template, and the generated output is used to build the page along with all other layout components (such as head, nav bar, and foot) through the Franklin.jl build process.
This seems to be the best route because it allows the lecture notes to remain untouched (except a couple additions to the front-matter). I considered using Books.jl, but this requires fairly significant changes to every code block. Converting every *.jmd to a Literate.jl script would take less time and use the builtin Franklin.jl support, but I decided not to spend time converting everything. These other routes are of course options, but I think this choice achieves a happy medium of clean site and minimal work. Any desired changes should be possible with some CSS tweaks.
Agreed. Done. In more than one place to make it easy to find.
Nothing major. Lecture 1 just doesn’t have notes, but that’s no problem.
And Lecture 12 has a link to a PDF, but I couldn’t find an associated weave file. It is not a stopper, just won’t have an entry in the Notes nav bar.