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: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.