Static Sites with Sphinx and Markdown Transcripts
Chapter: More Authoring
Lecture: Introduction to More Authoring
0:00 We've done some simple markdown but we're aiming higher static websites with richer content and structure
0:07 of the kinds of things that Sphinx can do in this step,
0:10 we'll look at more of what's possible thanks to MyST and it's Markdown parser we'll
0:17 show how to do more with images.
0:19 Thanks to some alternate syntaxes that MyST introduces.
0:23 We'll go a little further into the knobs that govern the funky kind of table of
0:28 contents thingy. That's key to Sphinx.
0:32 If you've seen doc's you've probably seen air quotes,
0:36 admonitions, those cool call outs for warnings and notes etcetera.
0:42 MyST has some cool stuff here too.
0:45 Do you want to include downloadable files such as PDFs into your generated site?
0:51 We'll take a look at that and just to flex a little,
0:54 we'll talk a little bit about Sphinx's browser side search widget,
1:00 which has had for a long time to give search capabilities to static websites.