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