Static Sites with Sphinx and Markdown Transcripts
Chapter: Simple Markdown
Lecture: What this means for Sphinx
0:00 Okay, big deal. A static site generator.
0:02 They can use markdown syntax. There's hundreds if not thousands of these ones probably being
0:08 written right now. We'll show in the coming sections the rich engine.
0:13 Thanks to Sphinx underneath this markdown syntax.
0:16 But even for these simple formatting cases,
0:19 there's a lot more going on than you think first.
0:22 It's not just html Sure. You see an italic,
0:25 you see a bold, but it's actually inserting a intermediate semantic node,
0:30 which can then work with other builders,
0:32 for example, to do italics in pdf.
0:35 The Rich linking. Sure, you have markdown syntax.
0:38 That looks simple, but with Sphinx plus MyST its linking to structure,
0:43 its connecting two pieces of information.
0:46 We saw that a little bit with generating the link,
0:49 text from the target and finally the headings.
0:53 Sure, it's big and bold,
0:55 right? But in Sphinx it's actually sub structure in a document which can be put
1:01 to use in many ways. For example,
1:02 toc trees can link to headings within a document.
1:07 There's a big engine underneath Sphinx and MyST even for italics links and headings.
1:11 This engine can be used for rich organized websites. We'll see more of this in the course.