{"version":3,"kind":"Notebook","sha256":"41a39b60922d552bccf8e5f188d0aa3ef5f67635e5258094ad751cb0ac6ce145","slug":"nextstep","location":"/content/lessons/2_nextstep.md","dependencies":[],"frontmatter":{"title":"More content","numbering":{"title":{"offset":0,"enabled":true}},"kernelspec":{"name":"python3","display_name":"Python 3"},"content_includes_title":false,"authors":[{"nameParsed":{"literal":"Freek Pols","given":"Freek","family":"Pols"},"name":"Freek Pols","id":"contributors-myst-generated-uid-0"},{"nameParsed":{"literal":"Luuk Fröling","given":"Luuk","family":"Fröling"},"name":"Luuk Fröling","id":"contributors-myst-generated-uid-1"},{"nameParsed":{"literal":"Robert Lanzafame","given":"Robert","family":"Lanzafame"},"name":"Robert Lanzafame","id":"contributors-myst-generated-uid-2"},{"nameParsed":{"literal":"Kirstie Whitaker","given":"Kirstie","family":"Whitaker"},"name":"Kirstie Whitaker","id":"contributors-myst-generated-uid-3"},{"nameParsed":{"literal":"Jim Madge","given":"Jim","family":"Madge"},"name":"Jim Madge","id":"contributors-myst-generated-uid-4"}],"date":"2025-11-02","license":{"content":{"id":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/","name":"Creative Commons Attribution 4.0 International","free":true,"CC":true}},"github":"https://github.com/jupyter-book/workshop-template","edit_url":null,"abbreviations":{"JB2":"Jupyter Book 2","CI/CD":"Continuous Integration/Continuous Deployment","GHA":"GitHub Actions","GH":"GitHub","IDE":"Integrated Development Environment","VSC":"Visual Studio Code","CLI":"commmand line interface"},"source_url":"https://github.com/jupyter-book/workshop-template/blob/main/content/lessons/2_nextstep.md","enumerator":"4","thumbnail":"/build/cd005ec2fd575f7a94ef86a14f7d3439.jpeg","exports":[{"format":"md","filename":"2_nextstep.md","url":"/build/2_nextstep-cbc4d0eefab7583d0db50e9f3644d2fc.md"}]},"mdast":{"type":"root","children":[{"type":"div","class":"font-light text-sm mb-4 updated-date-container","children":[{"type":"text","value":"Updated: 03 Nov 2025","key":"O01FP6Y4rs"}],"key":"XdjGD9u23u"},{"type":"block","children":[{"type":"paragraph","position":{"start":{"line":13,"column":1},"end":{"line":15,"column":1}},"children":[{"type":"text","value":"In ","position":{"start":{"line":13,"column":1},"end":{"line":13,"column":1}},"key":"idZIUpQgX1"},{"type":"link","position":{"start":{"line":13,"column":1},"end":{"line":13,"column":1}},"children":[{"type":"text","value":"Jupyter Book Fundamentals","key":"tJLphmV9ca"}],"identifier":"fundamentals","label":"fundamentals","url":"/firstedit","internal":true,"dataUrl":"/firstedit.json","key":"I1vCtd2EZ7"},{"type":"text","value":" we covered the basics of Jupyter Book structure and writing text content in markdown.\nHowever, Jupyter Book can go far beyond basic text formatting and has tools to help you share information with figures, videos, special blocks, interactive elements and advanced cross-referencing.\nIn this lesson we will look at some of these features that elevate your book over a plain-text document.","position":{"start":{"line":13,"column":1},"end":{"line":13,"column":1}},"key":"bBcdu7EqMY"}],"key":"KLa1H5S9xh"},{"type":"heading","depth":2,"position":{"start":{"line":17,"column":1},"end":{"line":17,"column":1}},"children":[{"type":"text","value":"Directives and roles","position":{"start":{"line":17,"column":1},"end":{"line":17,"column":1}},"key":"TCUIBKD1ZX"}],"identifier":"directives-and-roles","label":"Directives and roles","html_id":"directives-and-roles","implicit":true,"key":"yUmpZtGph7"},{"type":"paragraph","position":{"start":{"line":19,"column":1},"end":{"line":21,"column":1}},"children":[{"type":"text","value":"This lesson will make use of ","position":{"start":{"line":19,"column":1},"end":{"line":19,"column":1}},"key":"QuoK81SUQx"},{"type":"crossReference","url":"/syntax-overview","position":{"start":{"line":19,"column":1},"end":{"line":19,"column":1}},"children":[{"type":"text","value":"roles and directives","position":{"start":{"line":19,"column":1},"end":{"line":19,"column":1}},"key":"bcOKGWsLGF"}],"urlSource":"xref:myst-guide/syntax-overview#directives-roles","remote":true,"remoteBaseUrl":"https://mystmd.org/guide","dataUrl":"/syntax-overview.json","identifier":"directives-roles","label":"directives-roles","html_id":"directives-roles","protocol":"xref:myst","template":"{name}","resolved":true,"key":"G5VJ179AKJ"},{"type":"text","value":".\nThese have a similar syntax, and are used to extend the basic markdown features.\nThe main difference is that roles are written in-line and take a single argument, whereas directives are multi-line containers which may have multiple arguments and options.","position":{"start":{"line":19,"column":1},"end":{"line":19,"column":1}},"key":"UfzqwNs1rG"}],"key":"AJzMVN0uwR"},{"type":"paragraph","position":{"start":{"line":23,"column":1},"end":{"line":25,"column":1}},"children":[{"type":"text","value":"Both directives and roles use “fences”, which are either (at least) three colons ","position":{"start":{"line":23,"column":1},"end":{"line":23,"column":1}},"key":"QtgCbDB7Ms"},{"type":"inlineCode","value":":::","position":{"start":{"line":23,"column":1},"end":{"line":23,"column":1}},"key":"m9aNw3EQjP"},{"type":"text","value":" or backticks ","position":{"start":{"line":23,"column":1},"end":{"line":23,"column":1}},"key":"ouPKfCjRHJ"},{"type":"inlineCode","value":"```","position":{"start":{"line":23,"column":1},"end":{"line":23,"column":1}},"key":"p6pdoElvw3"},{"type":"text","value":".\nYou can use more colons or backticks to nest directives.\nThe ","position":{"start":{"line":23,"column":1},"end":{"line":23,"column":1}},"key":"NhLHvkYMYF"},{"type":"crossReference","url":"/syntax-overview","position":{"start":{"line":23,"column":1},"end":{"line":23,"column":1}},"children":[{"type":"text","value":"MyST documentation","position":{"start":{"line":23,"column":1},"end":{"line":23,"column":1}},"key":"pSZCqq2fBY"}],"urlSource":"xref:myst-guide/syntax-overview#directives-roles","remote":true,"remoteBaseUrl":"https://mystmd.org/guide","dataUrl":"/syntax-overview.json","identifier":"directives-roles","label":"directives-roles","html_id":"directives-roles","protocol":"xref:myst","template":"{name}","resolved":true,"key":"SMvc7CRIEU"},{"type":"text","value":" explains the syntax, nesting and the difference between colons and backticks in more detail.","position":{"start":{"line":23,"column":1},"end":{"line":23,"column":1}},"key":"crc0YFSU1Y"}],"key":"KczNPgRwSU"},{"type":"admonition","kind":"note","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Note","key":"X03xWBA0CJ"}],"key":"xWxXm0VUYp"},{"type":"paragraph","position":{"start":{"line":28,"column":1},"end":{"line":29,"column":1}},"children":[{"type":"text","value":"If there is a feature you would like to add to your project,\nyou could create a new role or directive in a plugin to extend the behaviour of MyST.","position":{"start":{"line":28,"column":1},"end":{"line":28,"column":1}},"key":"WsLeELKnHt"}],"key":"oyA1oUmUI6"}],"key":"SM3G3SwRtn"},{"type":"heading","depth":2,"position":{"start":{"line":32,"column":1},"end":{"line":32,"column":1}},"children":[{"type":"text","value":"Images and figures","position":{"start":{"line":32,"column":1},"end":{"line":32,"column":1}},"key":"n0Hzo92p8A"}],"identifier":"images-and-figures","label":"Images and figures","html_id":"images-and-figures","implicit":true,"key":"vuM2Kt6BWn"},{"type":"paragraph","position":{"start":{"line":34,"column":1},"end":{"line":34,"column":1}},"children":[{"type":"text","value":"The quickest way to include an image is with the Markdown notation ","position":{"start":{"line":34,"column":1},"end":{"line":34,"column":1}},"key":"m3lfMqS8aC"},{"type":"inlineCode","value":"![alt text](url-or-path)","position":{"start":{"line":34,"column":1},"end":{"line":34,"column":1}},"key":"ozluqC17GV"},{"type":"text","value":" as done below","position":{"start":{"line":34,"column":1},"end":{"line":34,"column":1}},"key":"WLjoYE0qSH"}],"key":"EVwl1jGWUD"},{"type":"code","lang":"markdown","value":"![External image](https://polslab.tnw.tudelft.nl/figures/training.JPG)","position":{"start":{"line":36,"column":1},"end":{"line":38,"column":1}},"key":"OtAAUDw1Ns"},{"type":"paragraph","position":{"start":{"line":39,"column":1},"end":{"line":40,"column":1}},"children":[{"type":"text","value":"resulting in\n","position":{"start":{"line":39,"column":1},"end":{"line":39,"column":1}},"key":"mvnbCxXC2A"},{"type":"image","url":"/build/cd005ec2fd575f7a94ef86a14f7d3439.jpeg","alt":"External image","position":{"start":{"line":39,"column":1},"end":{"line":39,"column":1}},"key":"MvNm1PzT20","urlSource":"https://polslab.tnw.tudelft.nl/figures/training.JPG"}],"key":"ivDm5VwxQX"},{"type":"paragraph","position":{"start":{"line":42,"column":1},"end":{"line":44,"column":1}},"children":[{"type":"text","value":"However, this gives us limited options to customize the figure.\nMoreover, we are dependent of a stable external URL.\nWe can include our own figures and add more options using the ","position":{"start":{"line":42,"column":1},"end":{"line":42,"column":1}},"key":"UFNhm9zFr9"},{"type":"crossReference","position":{"start":{"line":42,"column":1},"end":{"line":42,"column":1}},"children":[{"type":"inlineCode","value":"figure","position":{"start":{"line":42,"column":1},"end":{"line":42,"column":1}},"key":"T4y3urb5Ft"},{"type":"text","value":" directive","position":{"start":{"line":42,"column":1},"end":{"line":42,"column":1}},"key":"FwUOalDWJv"}],"identifier":"cheat_sheet_figures","label":"cheat_sheet_figures","kind":"heading","template":"{name}","resolved":true,"html_id":"cheat-sheet-figures","remote":true,"url":"/cheat-sheet","dataUrl":"/cheat-sheet.json","key":"ZNpf4t2hmD"},{"type":"text","value":".","position":{"start":{"line":42,"column":1},"end":{"line":42,"column":1}},"key":"wgbtwwEE8J"}],"key":"mjSLLYveBV"},{"type":"paragraph","position":{"start":{"line":46,"column":1},"end":{"line":49,"column":1}},"children":[{"type":"text","value":"If we want to add a figure to our book, we can use the URL of an external website (as in the figure above).\nHowever, this carries the risk that the figure will no longer be visible if it is moved from its location.","position":{"start":{"line":46,"column":1},"end":{"line":46,"column":1}},"key":"PPH6okghTX"},{"type":"footnoteReference","identifier":"embeddingimages","label":"embeddingimages","position":{"start":{"line":46,"column":1},"end":{"line":46,"column":1}},"enumerator":"1","key":"gMhpaUscLF"},{"type":"text","value":"\nIt is therefore better to have the figure as a local source file where you build the book.\nWe will do this by adding an image file to your git repository.","position":{"start":{"line":46,"column":1},"end":{"line":46,"column":1}},"key":"pwooKKGsON"}],"key":"TYRvoSzoT2"},{"type":"exercise","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Include a figure","position":{"start":{"line":51,"column":1},"end":{"line":51,"column":1}},"key":"WRM36DVOdo"}],"key":"iFRy0MP6fR"},{"type":"tabSet","children":[{"type":"tabItem","title":"GitHub","children":[{"type":"paragraph","position":{"start":{"line":54,"column":1},"end":{"line":54,"column":1}},"children":[{"type":"text","value":"On GitHub, under the ","position":{"start":{"line":54,"column":1},"end":{"line":54,"column":1}},"key":"JIFVDxAygd"},{"type":"inlineCode","value":"code","position":{"start":{"line":54,"column":1},"end":{"line":54,"column":1}},"key":"fnKnreE1lQ"},{"type":"text","value":" tab…","position":{"start":{"line":54,"column":1},"end":{"line":54,"column":1}},"key":"kUI7IQzxfO"}],"key":"tf6sS1J78l"},{"type":"list","ordered":true,"start":1,"spread":false,"position":{"start":{"line":56,"column":1},"end":{"line":57,"column":1}},"children":[{"type":"listItem","spread":true,"position":{"start":{"line":56,"column":1},"end":{"line":57,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Navigate to content/figures and click on ","position":{"start":{"line":56,"column":1},"end":{"line":56,"column":1}},"key":"BgRHYsRA0S"},{"type":"inlineCode","value":"add file","position":{"start":{"line":56,"column":1},"end":{"line":56,"column":1}},"key":"PVpB8GGbhe"},{"type":"text","value":" ","position":{"start":{"line":56,"column":1},"end":{"line":56,"column":1}},"key":"CXUe1g6xdg"},{"type":"inlineMath","value":"\\rightarrow","position":{"start":{"line":56,"column":1},"end":{"line":56,"column":1}},"html":"<span class=\"katex\"><span class=\"katex-mathml\"><math xmlns=\"http://www.w3.org/1998/Math/MathML\"><semantics><mrow><mo>→</mo></mrow><annotation encoding=\"application/x-tex\">\\rightarrow</annotation></semantics></math></span><span class=\"katex-html\" aria-hidden=\"true\"><span class=\"base\"><span class=\"strut\" style=\"height:0.3669em;\"></span><span class=\"mrel\">→</span></span></span></span>","key":"BOqHmBxa6A"},{"type":"text","value":" ","position":{"start":{"line":56,"column":1},"end":{"line":56,"column":1}},"key":"AutCKfyvNz"},{"type":"inlineCode","value":"Upload files","position":{"start":{"line":56,"column":1},"end":{"line":56,"column":1}},"key":"v4kG2d0xuu"},{"type":"text","value":".","position":{"start":{"line":56,"column":1},"end":{"line":56,"column":1}},"key":"NFoS2PDYb5"}],"key":"IE9jnUVyyd"}],"key":"NIQcaqDHh4"}],"key":"ZCHuc6BMlb"},{"type":"container","kind":"figure","children":[{"type":"image","url":"/build/incl_fig-da5f43fedc0107bb79f51c65b04f4612.jpg","alt":"Add a file in the folder by choosing Upload files","width":"100%","data":{"altTextIsAutoGenerated":true},"urlSource":"figures/incl_fig.jpg","key":"ssFGQAZwYZ"},{"type":"caption","children":[{"type":"paragraph","position":{"start":{"line":62,"column":1},"end":{"line":62,"column":1}},"children":[{"type":"captionNumber","kind":"figure","label":"fig_incl_fig","identifier":"fig_incl_fig","html_id":"fig-incl-fig","enumerator":"1","children":[{"type":"text","value":"Figure ","key":"AynrtA7X6B"},{"type":"text","value":"1","key":"Y14gwOKlJW"},{"type":"text","value":":","key":"mjiQ6LD44u"}],"template":"Figure %s:","key":"o0dvXkr1Ch"},{"type":"text","value":"Add a file in the folder by choosing ","position":{"start":{"line":62,"column":1},"end":{"line":62,"column":1}},"key":"tPrhohHIH7"},{"type":"inlineCode","value":"Upload files","position":{"start":{"line":62,"column":1},"end":{"line":62,"column":1}},"key":"ZRLx8dmSRT"}],"key":"TkLjl91vTl"}],"key":"cm2qpo66uh"}],"label":"fig_incl_fig","identifier":"fig_incl_fig","enumerator":"1","html_id":"fig-incl-fig","key":"UIvnZ7nHIj"},{"type":"list","ordered":true,"start":2,"spread":false,"position":{"start":{"line":64,"column":1},"end":{"line":68,"column":1}},"children":[{"type":"listItem","spread":true,"position":{"start":{"line":64,"column":1},"end":{"line":64,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Choose the figure you want to add (remember the file name!).","position":{"start":{"line":64,"column":1},"end":{"line":64,"column":1}},"key":"ZEGvj1lJ4Y"}],"key":"lUyVdPkPGk"}],"key":"rExXGdeMKn"},{"type":"listItem","spread":true,"position":{"start":{"line":65,"column":1},"end":{"line":65,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Commit your changes to GitHub (the file will be uploaded).","position":{"start":{"line":65,"column":1},"end":{"line":65,"column":1}},"key":"FQviLrvxrv"}],"key":"eN8Q9DZ3yO"}],"key":"ToEcK141b0"},{"type":"listItem","spread":true,"position":{"start":{"line":66,"column":1},"end":{"line":66,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Navigate to the ","position":{"start":{"line":66,"column":1},"end":{"line":66,"column":1}},"key":"VHi5Bs5wSS"},{"type":"inlineCode","value":"book","position":{"start":{"line":66,"column":1},"end":{"line":66,"column":1}},"key":"W8EcwsLfkm"},{"type":"text","value":" folder and open ","position":{"start":{"line":66,"column":1},"end":{"line":66,"column":1}},"key":"sjcRRELzlT"},{"type":"inlineCode","value":"intro.md","position":{"start":{"line":66,"column":1},"end":{"line":66,"column":1}},"key":"Sn2eKeJBXS"},{"type":"text","value":" and click ","position":{"start":{"line":66,"column":1},"end":{"line":66,"column":1}},"key":"T3Ghz750V5"},{"type":"inlineCode","value":"edit this file","position":{"start":{"line":66,"column":1},"end":{"line":66,"column":1}},"key":"Wnzin3R30j"},{"type":"text","value":".","position":{"start":{"line":66,"column":1},"end":{"line":66,"column":1}},"key":"QMFtLeOnmG"}],"key":"GzvUBY3P8c"}],"key":"p5X0hQTlCy"},{"type":"listItem","spread":true,"position":{"start":{"line":67,"column":1},"end":{"line":68,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Copy the code below into that file, and change the figure name to your own figure’s name.","position":{"start":{"line":67,"column":1},"end":{"line":67,"column":1}},"key":"pbv2DnfLMw"}],"key":"UHaWDDcx16"}],"key":"ZXR0xoIYj8"}],"key":"VlIXZGxRhX"},{"type":"code","lang":"myst","value":"``` {figure} figures/incl_fig.PNG\n:width: 50%\n:name: fig_myfirstfigure\nadd file in the folder\n```","key":"wpogg2gMgH"},{"type":"list","ordered":true,"start":6,"spread":false,"position":{"start":{"line":77,"column":1},"end":{"line":77,"column":1}},"children":[{"type":"listItem","spread":true,"position":{"start":{"line":77,"column":1},"end":{"line":77,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Commit your changes and view the result on GitHub pages.","position":{"start":{"line":77,"column":1},"end":{"line":77,"column":1}},"key":"pysiBuj4Uu"}],"key":"SCk1kMhosJ"}],"key":"t2oM4OkQAi"}],"key":"VACxMpnSUe"}],"key":"Hj7txF0WQJ"},{"type":"tabItem","title":"Locally","children":[{"type":"list","ordered":true,"start":1,"spread":false,"position":{"start":{"line":80,"column":1},"end":{"line":82,"column":1}},"children":[{"type":"listItem","spread":true,"position":{"start":{"line":80,"column":1},"end":{"line":80,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Put the image file you want to include to the ","position":{"start":{"line":80,"column":1},"end":{"line":80,"column":1}},"key":"IZlAV7HbhO"},{"type":"inlineCode","value":"content/figures","position":{"start":{"line":80,"column":1},"end":{"line":80,"column":1}},"key":"DwX0a58fx4"},{"type":"text","value":" folder on your computer.","position":{"start":{"line":80,"column":1},"end":{"line":80,"column":1}},"key":"BxgoyRoi0L"}],"key":"r441odwf37"}],"key":"RNOoHdopkl"},{"type":"listItem","spread":true,"position":{"start":{"line":81,"column":1},"end":{"line":81,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Navigate to the ","position":{"start":{"line":81,"column":1},"end":{"line":81,"column":1}},"key":"gwtTSJfhXD"},{"type":"inlineCode","value":"book","position":{"start":{"line":81,"column":1},"end":{"line":81,"column":1}},"key":"pgOgdmT9xM"},{"type":"text","value":" folder and open ","position":{"start":{"line":81,"column":1},"end":{"line":81,"column":1}},"key":"fnVGzmuGZv"},{"type":"inlineCode","value":"intro.md","position":{"start":{"line":81,"column":1},"end":{"line":81,"column":1}},"key":"X1yK50DpPm"},{"type":"text","value":".","position":{"start":{"line":81,"column":1},"end":{"line":81,"column":1}},"key":"izEEZpsx3U"}],"key":"lBHWSI9Xqh"}],"key":"JbxLXGLytp"},{"type":"listItem","spread":true,"position":{"start":{"line":82,"column":1},"end":{"line":82,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Copy the code below into that file, and change the figure name to your own figure’s name.","position":{"start":{"line":82,"column":1},"end":{"line":82,"column":1}},"key":"qG1UpwpW9W"}],"key":"sDQpPce8jL"}],"key":"vMXhGCityR"}],"key":"FKnLBj8j1V"},{"type":"code","lang":"myst","value":"``` {figure} figures/incl_fig.PNG\n:width: 50%\n:name: fig_myfirstfigure\nadd file in the folder\n```","key":"mGkctqzEmp"},{"type":"list","ordered":true,"start":4,"spread":false,"position":{"start":{"line":90,"column":1},"end":{"line":91,"column":1}},"children":[{"type":"listItem","spread":true,"position":{"start":{"line":90,"column":1},"end":{"line":91,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Commit your changes and view the results.","position":{"start":{"line":90,"column":1},"end":{"line":90,"column":1}},"key":"StnqdgUHrN"}],"key":"hHnHBEyUXE"}],"key":"mwtZerm8cf"}],"key":"McFP8QQiBl"},{"type":"admonition","kind":"hint","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Hint","key":"JxsntQqSw7"}],"key":"NAZ2DX2dZ4"},{"type":"paragraph","position":{"start":{"line":93,"column":1},"end":{"line":93,"column":1}},"children":[{"type":"text","value":"Remember to add your image to the repository with ","position":{"start":{"line":93,"column":1},"end":{"line":93,"column":1}},"key":"D2z3aJRZX6"},{"type":"inlineCode","value":"git add","position":{"start":{"line":93,"column":1},"end":{"line":93,"column":1}},"key":"DweEeOqeDe"},{"type":"text","value":".","position":{"start":{"line":93,"column":1},"end":{"line":93,"column":1}},"key":"nRTZuAzCGY"}],"key":"fG0j6nJdOX"}],"key":"Fsx0xHo8br"}],"key":"Y0LykUgGC2"}],"key":"pyLM2YDXat"}],"enumerated":true,"label":"exercise-hNvLK2Ta6K","identifier":"exercise-hnvlk2ta6k","enumerator":"1","html_id":"exercise-hnvlk2ta6k","key":"NZZd1syG0B"},{"type":"admonition","kind":"warning","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Warning","key":"eSHTTwEZ3a"}],"key":"nod71QaPN3"},{"type":"paragraph","position":{"start":{"line":100,"column":1},"end":{"line":103,"column":1}},"children":[{"type":"text","value":"The filename is case sensitive.\nSo it matters whether your extension is .png or .PNG.\nYou can also use .* to avoid this issue, the system will then pick the right extension where the best options is chosen first (","position":{"start":{"line":100,"column":1},"end":{"line":100,"column":1}},"key":"gBujqEjtkb"},{"type":"emphasis","position":{"start":{"line":100,"column":1},"end":{"line":100,"column":1}},"children":[{"type":"text","value":"e.g.","position":{"start":{"line":100,"column":1},"end":{"line":100,"column":1}},"key":"VGowTZVjpP"}],"key":"yCiqX9S4Qk"},{"type":"text","value":" .gif over .png, and .svg over .jpg).\nThis also avoids conversion issues for pdf output of non-static or non-supported formats","position":{"start":{"line":100,"column":1},"end":{"line":100,"column":1}},"key":"UHF6kuB7vC"}],"key":"zTsbIqGWXc"}],"key":"QfxlPNoomy"},{"type":"admonition","kind":"tip","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Tip","key":"B3Rcc1AN3P"}],"key":"ZXfIpMdSz9"},{"type":"paragraph","position":{"start":{"line":107,"column":1},"end":{"line":107,"column":1}},"children":[{"type":"text","value":"You can find more information about figure options ","position":{"start":{"line":107,"column":1},"end":{"line":107,"column":1}},"key":"Jg2lOwb4BP"},{"type":"crossReference","url":"/figures","position":{"start":{"line":107,"column":1},"end":{"line":107,"column":1}},"children":[{"type":"text","value":"in the MyST documentation","position":{"start":{"line":107,"column":1},"end":{"line":107,"column":1}},"key":"pMdmu6Gj4E"}],"urlSource":"xref:myst-guide/figures#figure-directive","remote":true,"remoteBaseUrl":"https://mystmd.org/guide","dataUrl":"/figures.json","identifier":"figure-directive","label":"figure-directive","html_id":"figure-directive","protocol":"xref:myst","template":"{name}","resolved":true,"key":"ITgn7sggrh"},{"type":"text","value":".","position":{"start":{"line":107,"column":1},"end":{"line":107,"column":1}},"key":"NtubPdFkqU"}],"key":"FcpPd50pzA"}],"key":"DI9Zee7ro8"},{"type":"paragraph","position":{"start":{"line":110,"column":1},"end":{"line":111,"column":1}},"children":[{"type":"text","value":"You can position figures in different places (left / center / right / margin), adjust the size, add a caption, ","position":{"start":{"line":110,"column":1},"end":{"line":110,"column":1}},"key":"XWaPJqkJ9k"},{"type":"emphasis","position":{"start":{"line":110,"column":1},"end":{"line":110,"column":1}},"children":[{"type":"text","value":"etc.","position":{"start":{"line":110,"column":1},"end":{"line":110,"column":1}},"key":"bvsc3qDLTz"}],"key":"LQ0LPmf3di"},{"type":"text","value":".\nCheck the documentation above and try out the different settings.","position":{"start":{"line":110,"column":1},"end":{"line":110,"column":1}},"key":"E5g9GPR29F"}],"key":"xMYkk8YwYq"},{"type":"heading","depth":2,"position":{"start":{"line":113,"column":1},"end":{"line":113,"column":1}},"children":[{"type":"text","value":"Embed a video (from YouTube)","position":{"start":{"line":113,"column":1},"end":{"line":113,"column":1}},"key":"arVrT3qxUL"}],"identifier":"embed-a-video-from-youtube","label":"Embed a video (from YouTube)","html_id":"embed-a-video-from-youtube","implicit":true,"key":"SPLzJBpQSl"},{"type":"paragraph","position":{"start":{"line":115,"column":1},"end":{"line":116,"column":1}},"children":[{"type":"text","value":"We can embed videos hosting platforms like YouTube or Vimeo using the ","position":{"start":{"line":115,"column":1},"end":{"line":115,"column":1}},"key":"bFVGDGDwAv"},{"type":"crossReference","url":"/figures","position":{"start":{"line":115,"column":1},"end":{"line":115,"column":1}},"children":[{"type":"text","value":"iframe directive","position":{"start":{"line":115,"column":1},"end":{"line":115,"column":1}},"key":"rycSHSMY8Y"}],"urlSource":"xref:myst-guide/figures#youtube-videos","remote":true,"remoteBaseUrl":"https://mystmd.org/guide","dataUrl":"/figures.json","identifier":"youtube-videos","label":"youtube-videos","html_id":"youtube-videos","protocol":"xref:myst","template":"{name}","resolved":true,"key":"sOVpU3nvKE"},{"type":"text","value":".\nFor example, the following code embeds a video about Markdown,","position":{"start":{"line":115,"column":1},"end":{"line":115,"column":1}},"key":"RgInhtomr6"}],"key":"kUXw1BJQJL"},{"type":"code","lang":"markdown","value":"```{iframe} https://www.youtube.com/embed/dhzrlXzYOlU?si=n2U0HSJyotjp-r93\n:width: 80%\n\nPurves et al. - Jupyter Book 2 0 – A Next Generation tool for sharing for Computational Content\n```","position":{"start":{"line":118,"column":1},"end":{"line":124,"column":1}},"key":"MbcGJB6v4w"},{"type":"paragraph","position":{"start":{"line":126,"column":1},"end":{"line":126,"column":1}},"children":[{"type":"text","value":"resulting in","position":{"start":{"line":126,"column":1},"end":{"line":126,"column":1}},"key":"f4PLvsaa7P"}],"key":"OSWn22NvMS"},{"type":"container","kind":"figure","children":[{"type":"iframe","src":"https://www.youtube.com/embed/dhzrlXzYOlU?si=n2U0HSJyotjp-r93","width":"80%","key":"mcc2LroWCw"},{"type":"caption","children":[{"type":"paragraph","position":{"start":{"line":131,"column":1},"end":{"line":131,"column":1}},"children":[{"type":"text","value":"Purves et al. - Jupyter Book 2 0 – A Next Generation tool for sharing for Computational Content","position":{"start":{"line":131,"column":1},"end":{"line":131,"column":1}},"key":"hmQefVMgap"}],"key":"RdiMTVQYBj"}],"key":"iaCly1yVvJ"}],"enumerator":"2","key":"qPItRvQxkJ"},{"type":"admonition","kind":"note","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Note","key":"IAXYrOTXOL"}],"key":"juN3tb36GA"},{"type":"paragraph","position":{"start":{"line":135,"column":1},"end":{"line":136,"column":1}},"children":[{"type":"text","value":"The use of iframe is not limited to videos.\nYou can embed content from other websites that support iframe embedding.","position":{"start":{"line":135,"column":1},"end":{"line":135,"column":1}},"key":"kB5WJdOU9S"}],"key":"GYmrD2FCwk"}],"key":"bDuoRFiyIe"},{"type":"admonition","kind":"note","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Note","key":"IXlJqB0zzl"}],"key":"eitS1EeNHE"},{"type":"paragraph","position":{"start":{"line":140,"column":1},"end":{"line":140,"column":1}},"children":[{"type":"text","value":"You can also use the ","position":{"start":{"line":140,"column":1},"end":{"line":140,"column":1}},"key":"NWcjOAzfL0"},{"type":"inlineCode","value":"figure","position":{"start":{"line":140,"column":1},"end":{"line":140,"column":1}},"key":"o8liFKDXhN"},{"type":"text","value":" directive to include a video from a local file, just like with images.","position":{"start":{"line":140,"column":1},"end":{"line":140,"column":1}},"key":"ehIvpw2hPX"}],"key":"IX0WWVLZWI"}],"key":"t8fd9wnx6p"},{"type":"admonition","kind":"tip","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Tip","key":"Nh8RCuxhYL"}],"key":"bvx57GRlFp"},{"type":"paragraph","position":{"start":{"line":144,"column":1},"end":{"line":144,"column":1}},"children":[{"type":"text","value":"There is a ","position":{"start":{"line":144,"column":1},"end":{"line":144,"column":1}},"key":"tqDny9ges1"},{"type":"link","url":"https://github.com/jupyter-book/myst-plugins/tree/main/plugins/iframe-to-thumbnail-pdf","position":{"start":{"line":144,"column":1},"end":{"line":144,"column":1}},"children":[{"type":"text","value":"plugin available","position":{"start":{"line":144,"column":1},"end":{"line":144,"column":1}},"key":"Q4aoFQ0nVm"}],"urlSource":"https://github.com/jupyter-book/myst-plugins/tree/main/plugins/iframe-to-thumbnail-pdf","error":true,"key":"mlzpRWJjyy"},{"type":"text","value":" that converts the YouTube clip in a qr code and a thumbnail for pdf exports.","position":{"start":{"line":144,"column":1},"end":{"line":144,"column":1}},"key":"O8e4xh6C2X"}],"key":"ZtsV0dQLQU"}],"key":"I7DUXt71jH"},{"type":"exercise","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Embed your own video","position":{"start":{"line":147,"column":1},"end":{"line":147,"column":1}},"key":"hxXlBiQiPM"}],"key":"vRQMhOxzWO"},{"type":"paragraph","position":{"start":{"line":148,"column":1},"end":{"line":149,"column":1}},"children":[{"type":"text","value":"Embed a video of your choice using either the ","position":{"start":{"line":148,"column":1},"end":{"line":148,"column":1}},"key":"znqH4lAcrC"},{"type":"inlineCode","value":"iframe","position":{"start":{"line":148,"column":1},"end":{"line":148,"column":1}},"key":"l2btu1It2t"},{"type":"text","value":" or ","position":{"start":{"line":148,"column":1},"end":{"line":148,"column":1}},"key":"AYhxYIuJmW"},{"type":"inlineCode","value":"video","position":{"start":{"line":148,"column":1},"end":{"line":148,"column":1}},"key":"BaLcLYI2qJ"},{"type":"text","value":" directive.\nYou can use a YouTube video or any other video that supports embedding.","position":{"start":{"line":148,"column":1},"end":{"line":148,"column":1}},"key":"FwAQh12Kzs"}],"key":"UbFdy7hnmb"}],"enumerated":true,"label":"exercise-elNkoOBGmi","identifier":"exercise-elnkoobgmi","enumerator":"2","html_id":"exercise-elnkoobgmi","key":"twmFlLPDAk"},{"type":"heading","depth":2,"position":{"start":{"line":152,"column":1},"end":{"line":152,"column":1}},"children":[{"type":"text","value":"Displaying code","position":{"start":{"line":152,"column":1},"end":{"line":152,"column":1}},"key":"um4vmyHzsb"}],"identifier":"displaying-code","label":"Displaying code","html_id":"displaying-code","implicit":true,"key":"rS24S00nVj"},{"type":"paragraph","position":{"start":{"line":154,"column":1},"end":{"line":154,"column":1}},"children":[{"type":"text","value":"You can display code using Markdown syntax.","position":{"start":{"line":154,"column":1},"end":{"line":154,"column":1}},"key":"X9AXzRYSFL"}],"key":"ziIje3ayKd"},{"type":"code","lang":"","value":"```language\ncode\n```","position":{"start":{"line":156,"column":1},"end":{"line":160,"column":1}},"key":"EvMe5xnnjJ"},{"type":"paragraph","position":{"start":{"line":162,"column":1},"end":{"line":162,"column":1}},"children":[{"type":"text","value":"for example,","position":{"start":{"line":162,"column":1},"end":{"line":162,"column":1}},"key":"F0A3H6nJzT"}],"key":"YcDhowb4tQ"},{"type":"code","lang":"","value":"``` python\nprint(\"Hello world!\")\n```","position":{"start":{"line":164,"column":1},"end":{"line":168,"column":1}},"key":"LJzeuMEkPv"},{"type":"paragraph","position":{"start":{"line":170,"column":1},"end":{"line":170,"column":1}},"children":[{"type":"text","value":"renders as,","position":{"start":{"line":170,"column":1},"end":{"line":170,"column":1}},"key":"Qe6GQU4uAf"}],"key":"TpoRCCMzh4"},{"type":"code","lang":"python","value":"print(\"Hello world!\")","position":{"start":{"line":172,"column":1},"end":{"line":174,"column":1}},"key":"TymlDsMYBR"},{"type":"paragraph","position":{"start":{"line":176,"column":1},"end":{"line":176,"column":1}},"children":[{"type":"text","value":"You can also use the ","position":{"start":{"line":176,"column":1},"end":{"line":176,"column":1}},"key":"BQV1JuWTM3"},{"type":"crossReference","url":"/code","position":{"start":{"line":176,"column":1},"end":{"line":176,"column":1}},"children":[{"type":"inlineCode","value":"code","position":{"start":{"line":176,"column":1},"end":{"line":176,"column":1}},"key":"lNl3t2mjzz"},{"type":"text","value":" directive","position":{"start":{"line":176,"column":1},"end":{"line":176,"column":1}},"key":"y0ctiPtrA5"}],"urlSource":"xref:myst-guide/code#code-blocks","remote":true,"remoteBaseUrl":"https://mystmd.org/guide","dataUrl":"/code.json","identifier":"code-blocks","label":"code-blocks","html_id":"code-blocks","protocol":"xref:myst","template":"{name}","resolved":true,"key":"ytTJ2ziLul"},{"type":"text","value":" which will render the code in a block and has features line line numbers and captions.","position":{"start":{"line":176,"column":1},"end":{"line":176,"column":1}},"key":"OGzsYgxtfD"}],"key":"JhdKPmOd7d"},{"type":"exercise","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Add a code block","position":{"start":{"line":178,"column":1},"end":{"line":178,"column":1}},"key":"qo0a2pjrxT"}],"key":"KoLlaHpeXo"},{"type":"paragraph","position":{"start":{"line":179,"column":1},"end":{"line":179,"column":1}},"children":[{"type":"text","value":"Take the following Python code snippet and put it in a code block with","position":{"start":{"line":179,"column":1},"end":{"line":179,"column":1}},"key":"Qfr6e3MCMt"}],"key":"bIDmqYIW6B"},{"type":"list","ordered":false,"spread":false,"position":{"start":{"line":181,"column":1},"end":{"line":184,"column":1}},"children":[{"type":"listItem","spread":true,"position":{"start":{"line":181,"column":1},"end":{"line":181,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Python syntax highlighting","position":{"start":{"line":181,"column":1},"end":{"line":181,"column":1}},"key":"Wmv4cztajn"}],"key":"dJG3aNExk9"}],"key":"Tl23UNzu5h"},{"type":"listItem","spread":true,"position":{"start":{"line":182,"column":1},"end":{"line":182,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Indicate the file name ","position":{"start":{"line":182,"column":1},"end":{"line":182,"column":1}},"key":"w2OqF5VLac"},{"type":"inlineCode","value":"fibonacci.py","position":{"start":{"line":182,"column":1},"end":{"line":182,"column":1}},"key":"xVdcUb6I7U"}],"key":"YxmaaQV6tS"}],"key":"ysdJR3PewQ"},{"type":"listItem","spread":true,"position":{"start":{"line":183,"column":1},"end":{"line":184,"column":1}},"children":[{"type":"paragraph","children":[{"type":"text","value":"Add a caption explaining that this function returns the ","position":{"start":{"line":183,"column":1},"end":{"line":183,"column":1}},"key":"hcAxiHIwwU"},{"type":"inlineCode","value":"n","position":{"start":{"line":183,"column":1},"end":{"line":183,"column":1}},"key":"Usr8jhGL5b"},{"type":"text","value":"th number in the Fibonacci series","position":{"start":{"line":183,"column":1},"end":{"line":183,"column":1}},"key":"lUrhjVeBLF"}],"key":"fu6Fvo6uYD"}],"key":"zB2VOLZq7Z"}],"key":"OUwIvZvOsC"},{"type":"code","lang":"","value":"def fib(n):\n    if n < 0:\n        return\n    if n in [0, 1]:\n        return n\n    else:\n        return fib(n-2) + fib(n-1)","position":{"start":{"line":185,"column":1},"end":{"line":193,"column":1}},"key":"Tm5Jhlw0OH"}],"enumerated":true,"label":"exercise-P6ZZWDUDXN","identifier":"exercise-p6zzwdudxn","enumerator":"3","html_id":"exercise-p6zzwdudxn","key":"s8TzsAruIw"},{"type":"heading","depth":2,"position":{"start":{"line":196,"column":1},"end":{"line":196,"column":1}},"children":[{"type":"text","value":"Diagrams","position":{"start":{"line":196,"column":1},"end":{"line":196,"column":1}},"key":"DyPSfRQ54K"}],"identifier":"diagrams","label":"Diagrams","html_id":"diagrams","implicit":true,"key":"PhZZ82dgqY"},{"type":"paragraph","position":{"start":{"line":198,"column":1},"end":{"line":201,"column":1}},"children":[{"type":"text","value":"MyST supports displaying ","position":{"start":{"line":198,"column":1},"end":{"line":198,"column":1}},"key":"VkswFYGD6s"},{"type":"link","url":"https://mermaid.js.org/","position":{"start":{"line":198,"column":1},"end":{"line":198,"column":1}},"children":[{"type":"text","value":"Mermaid","position":{"start":{"line":198,"column":1},"end":{"line":198,"column":1}},"key":"WRpBMDBdAu"}],"urlSource":"https://mermaid.js.org/","key":"VrH14PrxIj"},{"type":"text","value":" diagrams using the ","position":{"start":{"line":198,"column":1},"end":{"line":198,"column":1}},"key":"UIdp5TViPQ"},{"type":"link","url":"https://mystmd.org/guide/diagrams","position":{"start":{"line":198,"column":1},"end":{"line":198,"column":1}},"children":[{"type":"inlineCode","value":"mermaid","position":{"start":{"line":198,"column":1},"end":{"line":198,"column":1}},"key":"m8Dn1QFAZ0"},{"type":"text","value":" directive","position":{"start":{"line":198,"column":1},"end":{"line":198,"column":1}},"key":"ULtCizjWAk"}],"urlSource":"xref:myst-guide/diagrams","dataUrl":"https://mystmd.org/guide/diagrams.json","internal":false,"protocol":"xref:myst","key":"KrqkLN2jv1"},{"type":"text","value":".\nMermaid let’s you create a number of different types of diagrams using plain text.\nThis is a great way to show diagrams in your book, while keeping the source easily editable in version control.\nFor example, the following directive","position":{"start":{"line":198,"column":1},"end":{"line":198,"column":1}},"key":"Dgl78at3hp"}],"key":"qVo9Db6rq1"},{"type":"code","lang":"markdown","value":"```{mermaid}\nflowchart LR\n  Start --> Stop\n\n  A1([\"Novice\"]) --> B1\n  A2([\"I do know\"]) --> B2 & B1\n  B1([\"Expert\"])\n  B2([\"try\"])\n\n  A([\"Start\"]) --> B{\"Decision\"}\n  B --> C[\"Option A\"] & D[\"Option B\"]\n```","position":{"start":{"line":203,"column":1},"end":{"line":216,"column":1}},"key":"iP1yb7Jiq2"},{"type":"paragraph","position":{"start":{"line":218,"column":1},"end":{"line":218,"column":1}},"children":[{"type":"text","value":"Renders as,","position":{"start":{"line":218,"column":1},"end":{"line":218,"column":1}},"key":"gl70QEmulH"}],"key":"ch4Q6SFwEc"},{"type":"mermaid","value":"flowchart LR\n  Start --> Stop\n\n  A1([\"Novice\"]) --> B1\n  A2([\"I do know\"]) --> B2 & B1\n  B1([\"Expert\"])\n  B2([\"try\"])\n\n  A([\"Start\"]) --> B{\"Decision\"}\n  B --> C[\"Option A\"] & D[\"Option B\"]","key":"bmWTNYp1Nm"},{"type":"exercise","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Create a diagram","position":{"start":{"line":233,"column":1},"end":{"line":233,"column":1}},"key":"IiluYFuEXy"}],"key":"MERMvZF8Sa"},{"type":"paragraph","position":{"start":{"line":234,"column":1},"end":{"line":236,"column":1}},"children":[{"type":"text","value":"Create your own mermaid diagram.\nYou can create a diagram from scratch, consulting the syntax in the ","position":{"start":{"line":234,"column":1},"end":{"line":234,"column":1}},"key":"EFoMDhqn8f"},{"type":"link","url":"https://mermaid.js.org/intro/","position":{"start":{"line":234,"column":1},"end":{"line":234,"column":1}},"children":[{"type":"text","value":"Mermaid documentation","position":{"start":{"line":234,"column":1},"end":{"line":234,"column":1}},"key":"pQuyqOPITY"}],"urlSource":"https://mermaid.js.org/intro/","key":"Tdemr0OlQd"},{"type":"text","value":",\nor copy ","position":{"start":{"line":234,"column":1},"end":{"line":234,"column":1}},"key":"REfCB9N23l"},{"type":"link","url":"https://mermaid.js.org/syntax/examples","position":{"start":{"line":234,"column":1},"end":{"line":234,"column":1}},"children":[{"type":"text","value":"an example","position":{"start":{"line":234,"column":1},"end":{"line":234,"column":1}},"key":"to6Lk0Z5Ls"}],"urlSource":"https://mermaid.js.org/syntax/examples","key":"OdclNz7HLk"}],"key":"yrzohgM0Mi"}],"enumerated":true,"label":"exercise-kyJUKqf2RT","identifier":"exercise-kyjukqf2rt","enumerator":"4","html_id":"exercise-kyjukqf2rt","key":"Lw6klnyJMS"},{"type":"heading","depth":2,"position":{"start":{"line":239,"column":1},"end":{"line":239,"column":1}},"children":[{"type":"text","value":"Admonitions","position":{"start":{"line":239,"column":1},"end":{"line":239,"column":1}},"key":"dZUDhM5z5W"}],"identifier":"admonitions","label":"Admonitions","html_id":"admonitions","implicit":true,"key":"VVV94BD2Pa"},{"type":"paragraph","position":{"start":{"line":241,"column":1},"end":{"line":242,"column":1}},"children":[{"type":"link","url":"https://mystmd.org/guide/admonitions","position":{"start":{"line":241,"column":1},"end":{"line":241,"column":1}},"children":[{"type":"text","value":"Admonitions","position":{"start":{"line":241,"column":1},"end":{"line":241,"column":1}},"key":"Gt1aTQnrGJ"}],"urlSource":"xref:myst-guide/admonitions","dataUrl":"https://mystmd.org/guide/admonitions.json","internal":false,"protocol":"xref:myst","key":"hdXyrxiJrP"},{"type":"text","value":" can be used to separate text from the main text and highlight it appropriately.\nHere are a set of admonitions built in to Myst,","position":{"start":{"line":241,"column":1},"end":{"line":241,"column":1}},"key":"uuexQWgrYX"}],"key":"TK8W00ILuz"},{"type":"tabSet","children":[{"type":"tabItem","title":"Note","children":[{"type":"admonition","kind":"note","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Note","key":"chwDuQaft5"}],"key":"TcGYkhWwYg"},{"type":"paragraph","position":{"start":{"line":248,"column":1},"end":{"line":248,"column":1}},"children":[{"type":"text","value":"This is an note admonition","position":{"start":{"line":248,"column":1},"end":{"line":248,"column":1}},"key":"W3pYI4rwhm"}],"key":"f5QCxKcq27"}],"key":"U5YNNCyXjK"}],"key":"qBKt6ocW7m"},{"type":"tabItem","title":"Important","children":[{"type":"admonition","kind":"important","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Important","key":"wqJqIg8xwm"}],"key":"ymUzxr3jeM"},{"type":"paragraph","position":{"start":{"line":254,"column":1},"end":{"line":254,"column":1}},"children":[{"type":"text","value":"This is an important admonition","position":{"start":{"line":254,"column":1},"end":{"line":254,"column":1}},"key":"J39SrAjxKQ"}],"key":"KcMSVWq6b0"}],"key":"IbykXhGtJf"}],"key":"j3SN9IwS4m"},{"type":"tabItem","title":"Hint","children":[{"type":"admonition","kind":"hint","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Hint","key":"Vh5MMvuya5"}],"key":"vX9dlxjxdP"},{"type":"paragraph","position":{"start":{"line":260,"column":1},"end":{"line":260,"column":1}},"children":[{"type":"text","value":"This is an hint admonition","position":{"start":{"line":260,"column":1},"end":{"line":260,"column":1}},"key":"BVdKADoRRy"}],"key":"phrdpbWPlH"}],"key":"Uw9QDD9Hfm"}],"key":"tUqekg6Lqs"},{"type":"tabItem","title":"See Also","children":[{"type":"admonition","kind":"seealso","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"See Also","key":"Gf0qvcxg4M"}],"key":"x8PdZfHTTT"},{"type":"paragraph","position":{"start":{"line":266,"column":1},"end":{"line":266,"column":1}},"children":[{"type":"text","value":"This is an seealso admonition","position":{"start":{"line":266,"column":1},"end":{"line":266,"column":1}},"key":"BG0ei8IBO7"}],"key":"W2rCyAP7wQ"}],"key":"VuZ9zsTKHq"}],"key":"DFv3GRmBpf"},{"type":"tabItem","title":"Tip","children":[{"type":"admonition","kind":"tip","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Tip","key":"AMOiTUkqqs"}],"key":"gGnHg0hiG0"},{"type":"paragraph","position":{"start":{"line":272,"column":1},"end":{"line":272,"column":1}},"children":[{"type":"text","value":"This is an tip admonition","position":{"start":{"line":272,"column":1},"end":{"line":272,"column":1}},"key":"mdELtqTcxh"}],"key":"F03PfqVNNM"}],"key":"Ix37mHK0Vy"}],"key":"gBLGRLoT9I"},{"type":"tabItem","title":"Attention","children":[{"type":"admonition","kind":"attention","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Attention","key":"NussgpBqKM"}],"key":"FaRE10UeYU"},{"type":"paragraph","position":{"start":{"line":278,"column":1},"end":{"line":278,"column":1}},"children":[{"type":"text","value":"This is an attention admonition","position":{"start":{"line":278,"column":1},"end":{"line":278,"column":1}},"key":"fho9g6smZj"}],"key":"iLY6qcWndg"}],"key":"Y7fyqE9oDw"}],"key":"CJwh7a2zxd"},{"type":"tabItem","title":"Caution","children":[{"type":"admonition","kind":"caution","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Caution","key":"ggd8opO9Kh"}],"key":"Rq6uz2sTwo"},{"type":"paragraph","position":{"start":{"line":284,"column":1},"end":{"line":284,"column":1}},"children":[{"type":"text","value":"This is an caution admonition","position":{"start":{"line":284,"column":1},"end":{"line":284,"column":1}},"key":"AwJm5tWmSF"}],"key":"ocQvXEvW2Z"}],"key":"wuwI2Yoys2"}],"key":"SNxTERpuMR"},{"type":"tabItem","title":"Warning","children":[{"type":"admonition","kind":"warning","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Warning","key":"FatRsrBbhs"}],"key":"NaYCS6gI2B"},{"type":"paragraph","position":{"start":{"line":290,"column":1},"end":{"line":290,"column":1}},"children":[{"type":"text","value":"This is an warning admonition","position":{"start":{"line":290,"column":1},"end":{"line":290,"column":1}},"key":"ndYGAaakii"}],"key":"D2rbO0NFJn"}],"key":"ThEZN5N1Kq"}],"key":"UrqrRV1Gys"},{"type":"tabItem","title":"Danger","children":[{"type":"admonition","kind":"danger","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Danger","key":"AQlszINJPH"}],"key":"iasLPJJyci"},{"type":"paragraph","position":{"start":{"line":296,"column":1},"end":{"line":296,"column":1}},"children":[{"type":"text","value":"This is an danger admonition","position":{"start":{"line":296,"column":1},"end":{"line":296,"column":1}},"key":"f3R0uDVbKC"}],"key":"YhWat9LWl2"}],"key":"WuOoIp8b9M"}],"key":"PTlHNWofjr"},{"type":"tabItem","title":"Error","children":[{"type":"admonition","kind":"error","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Error","key":"Txw0KvG7FU"}],"key":"TDmeCqnsJp"},{"type":"paragraph","position":{"start":{"line":302,"column":1},"end":{"line":302,"column":1}},"children":[{"type":"text","value":"This is an error admonition","position":{"start":{"line":302,"column":1},"end":{"line":302,"column":1}},"key":"pWcOLIYzRZ"}],"key":"oDXt8qhZ2F"}],"key":"krAO0xnuSE"}],"key":"DpeKd8ctRM"}],"key":"E3EhtaugWc"},{"type":"paragraph","position":{"start":{"line":308,"column":1},"end":{"line":308,"column":1}},"children":[{"type":"text","value":"Custom admonitions can also be created in a plugin, but hiding the icon and adding your own icon in the title is a quick way to get a custom look.","position":{"start":{"line":308,"column":1},"end":{"line":308,"column":1}},"key":"cOzkFDRnFS"}],"key":"ZLtKjA2R4r"},{"type":"myst","value":"```{warning} 🌶 HOTHOTHOT\n:icon: false\n:class: dropdown\n\nThis is a custom warning admonition with a custom icon, try changing it!\n```","key":"Ud1YSM0LbJ"},{"type":"exercise","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Admonitions","position":{"start":{"line":319,"column":1},"end":{"line":319,"column":1}},"key":"JT3wlmUHVP"}],"key":"jSg1A3gnwD"},{"type":"paragraph","position":{"start":{"line":320,"column":1},"end":{"line":320,"column":1}},"children":[{"type":"text","value":"Use an appropriate admonition to contain the following paragraphs.","position":{"start":{"line":320,"column":1},"end":{"line":320,"column":1}},"key":"NWuEbAlJtC"}],"key":"UbOFdPSA0F"},{"type":"paragraph","position":{"start":{"line":322,"column":1},"end":{"line":322,"column":1}},"children":[{"type":"text","value":"Hand wash only","position":{"start":{"line":322,"column":1},"end":{"line":322,"column":1}},"key":"Nm2GWyriGI"}],"key":"xHF7Dt2Ozy"},{"type":"paragraph","position":{"start":{"line":324,"column":1},"end":{"line":324,"column":1}},"children":[{"type":"text","value":"Syntax error","position":{"start":{"line":324,"column":1},"end":{"line":324,"column":1}},"key":"nuC4WncDYU"}],"key":"DGpdfg6gfK"},{"type":"paragraph","position":{"start":{"line":326,"column":1},"end":{"line":326,"column":1}},"children":[{"type":"text","value":"Beware of the leopard","position":{"start":{"line":326,"column":1},"end":{"line":326,"column":1}},"key":"PUgkFDH7kl"}],"key":"LiJxTRGrWp"}],"enumerated":true,"label":"exercise-YzCj4A4YpS","identifier":"exercise-yzcj4a4yps","enumerator":"5","html_id":"exercise-yzcj4a4yps","key":"FuLxR36GVZ"},{"type":"heading","depth":2,"position":{"start":{"line":329,"column":1},"end":{"line":329,"column":1}},"children":[{"type":"text","value":"Tabs, cards, grids","position":{"start":{"line":329,"column":1},"end":{"line":329,"column":1}},"key":"iaGstNGOdo"}],"identifier":"tabs-cards-grids","label":"Tabs, cards, grids","html_id":"tabs-cards-grids","implicit":true,"key":"JTpv1UcMZj"},{"type":"paragraph","position":{"start":{"line":331,"column":1},"end":{"line":331,"column":1}},"children":[{"type":"text","value":"MyST has a number of features for arranging and organising content, you have already seen some of these following these lessons.","position":{"start":{"line":331,"column":1},"end":{"line":331,"column":1}},"key":"oQzVKtcjF2"}],"key":"ES0WppfNHF"},{"type":"list","ordered":false,"spread":false,"position":{"start":{"line":333,"column":1},"end":{"line":336,"column":1}},"children":[{"type":"listItem","spread":true,"position":{"start":{"line":333,"column":1},"end":{"line":333,"column":1}},"children":[{"type":"paragraph","children":[{"type":"link","url":"https://mystmd.org/guide/dropdowns-cards-and-tabs","position":{"start":{"line":333,"column":1},"end":{"line":333,"column":1}},"children":[{"type":"text","value":"Dropdowns, Grids, Tabs and Cards","key":"VoN8u6LZYQ"}],"urlSource":"xref:myst-guide/dropdowns-cards-and-tabs","dataUrl":"https://mystmd.org/guide/dropdowns-cards-and-tabs.json","internal":false,"protocol":"xref:myst","key":"VaZhCBvx2r"}],"key":"hbvOmz8lcQ"}],"key":"sXx2kEXYiJ"},{"type":"listItem","spread":true,"position":{"start":{"line":334,"column":1},"end":{"line":334,"column":1}},"children":[{"type":"paragraph","children":[{"type":"link","url":"https://mystmd.org/guide/asides","position":{"start":{"line":334,"column":1},"end":{"line":334,"column":1}},"children":[{"type":"text","value":"Asides, Margin Content, and Sidebars","key":"Cs2ND8OR5M"}],"urlSource":"xref:myst-guide/asides","dataUrl":"https://mystmd.org/guide/asides.json","internal":false,"protocol":"xref:myst","key":"gecpZztp7A"}],"key":"YbWQggzHf7"}],"key":"jQI7FoaXJs"},{"type":"listItem","spread":true,"position":{"start":{"line":335,"column":1},"end":{"line":336,"column":1}},"children":[{"type":"paragraph","children":[{"type":"link","url":"https://mystmd.org/guide/blocks","position":{"start":{"line":335,"column":1},"end":{"line":335,"column":1}},"children":[{"type":"text","value":"Blocks and Comments","key":"mQ26t6Y4Od"}],"urlSource":"xref:myst-guide/blocks","dataUrl":"https://mystmd.org/guide/blocks.json","internal":false,"protocol":"xref:myst","key":"EPJGjLbS2a"}],"key":"gq5dDit79h"}],"key":"YBmHAEOeos"}],"key":"SruFrttZ8n"},{"type":"paragraph","position":{"start":{"line":337,"column":1},"end":{"line":338,"column":1}},"children":[{"type":"text","value":"Tabs can be used to separate content into different sections that can be viewed by clicking on the tab headers.\nThey are useful when you want to present a set of mutually exclusive options.","position":{"start":{"line":337,"column":1},"end":{"line":337,"column":1}},"key":"nxRyqk6isG"}],"key":"WUDlxYIoma"},{"type":"code","lang":"markdown","value":":::: {tab-set}\n::: {tab-item} Tab 1\nContent for Tab 1\n:::\n::: {tab-item} Tab 2\nContent for Tab 2\n:::\n::::","position":{"start":{"line":340,"column":1},"end":{"line":349,"column":1}},"key":"Zp5M3UyXD5"},{"type":"paragraph","position":{"start":{"line":351,"column":1},"end":{"line":351,"column":1}},"children":[{"type":"text","value":"Renders as,","position":{"start":{"line":351,"column":1},"end":{"line":351,"column":1}},"key":"QB3HRSBy7B"}],"key":"aT4sOVns9s"},{"type":"tabSet","children":[{"type":"tabItem","title":"Tab 1","children":[{"type":"paragraph","position":{"start":{"line":355,"column":1},"end":{"line":355,"column":1}},"children":[{"type":"text","value":"Content for Tab 1","position":{"start":{"line":355,"column":1},"end":{"line":355,"column":1}},"key":"AZcUnzzitn"}],"key":"OvdDypy2qH"}],"key":"vJAG34bBab"},{"type":"tabItem","title":"Tab 2","children":[{"type":"paragraph","position":{"start":{"line":358,"column":1},"end":{"line":358,"column":1}},"children":[{"type":"text","value":"Content for Tab 2","position":{"start":{"line":358,"column":1},"end":{"line":358,"column":1}},"key":"hInaUpNUsC"}],"key":"o3t2fqN26N"}],"key":"QHyAOPJXdz"},{"type":"code","lang":"","value":"","position":{"start":{"line":360,"column":1},"end":{"line":360,"column":1}},"key":"ni7ReMxWFN"}],"key":"iKaLeaffmo"},{"type":"exercise","children":[{"type":"admonitionTitle","children":[{"type":"text","value":"Create a tab set for installing MyST","position":{"start":{"line":363,"column":1},"end":{"line":363,"column":1}},"key":"ZqopVDKeFf"}],"key":"GDDlIwNV8v"},{"type":"paragraph","position":{"start":{"line":364,"column":1},"end":{"line":365,"column":1}},"children":[{"type":"text","value":"Put the following instructions for installing MyST into a tab set,\nsplitting instructions for ","position":{"start":{"line":364,"column":1},"end":{"line":364,"column":1}},"key":"nvtatqHpQB"},{"type":"inlineCode","value":"pip","position":{"start":{"line":364,"column":1},"end":{"line":364,"column":1}},"key":"LRqzSeksd9"},{"type":"text","value":" and ","position":{"start":{"line":364,"column":1},"end":{"line":364,"column":1}},"key":"pD87PZthYy"},{"type":"inlineCode","value":"npm","position":{"start":{"line":364,"column":1},"end":{"line":364,"column":1}},"key":"AUvbGk4gf5"},{"type":"text","value":" into different tabs.","position":{"start":{"line":364,"column":1},"end":{"line":364,"column":1}},"key":"wlHhVou2lT"}],"key":"mKhY0FhdcT"},{"type":"paragraph","position":{"start":{"line":367,"column":1},"end":{"line":367,"column":1}},"children":[{"type":"text","value":"Install MyST","position":{"start":{"line":367,"column":1},"end":{"line":367,"column":1}},"key":"oSAM1unEYL"}],"key":"eDSdg4RR5D"},{"type":"paragraph","position":{"start":{"line":369,"column":1},"end":{"line":369,"column":1}},"children":[{"type":"emphasis","position":{"start":{"line":369,"column":1},"end":{"line":369,"column":1}},"children":[{"type":"text","value":"Using pip:","position":{"start":{"line":369,"column":1},"end":{"line":369,"column":1}},"key":"bHbxwxMVnl"}],"key":"JzSnsNzLYR"},{"type":"text","value":" ","position":{"start":{"line":369,"column":1},"end":{"line":369,"column":1}},"key":"zFequN8iBR"},{"type":"inlineCode","value":"pip install mystmd","position":{"start":{"line":369,"column":1},"end":{"line":369,"column":1}},"key":"JQduRVEyio"}],"key":"ZWCDKJB5Sr"},{"type":"paragraph","position":{"start":{"line":371,"column":1},"end":{"line":371,"column":1}},"children":[{"type":"emphasis","position":{"start":{"line":371,"column":1},"end":{"line":371,"column":1}},"children":[{"type":"text","value":"Using npm:","position":{"start":{"line":371,"column":1},"end":{"line":371,"column":1}},"key":"vo0Hh2Et4Y"}],"key":"Bu2IbibxRQ"},{"type":"text","value":" ","position":{"start":{"line":371,"column":1},"end":{"line":371,"column":1}},"key":"pM4oKDGyod"},{"type":"inlineCode","value":"npm install -g mystmd","position":{"start":{"line":371,"column":1},"end":{"line":371,"column":1}},"key":"heeTGzGiYP"}],"key":"JZ3uUVtZHD"}],"enumerated":true,"label":"exercise-TwJRmMlwWy","identifier":"exercise-twjrmmlwwy","enumerator":"6","html_id":"exercise-twjrmmlwwy","key":"NOnVHdUT1K"},{"type":"footnoteDefinition","identifier":"embeddingimages","label":"embeddingimages","position":{"start":{"line":371,"column":1},"end":{"line":371,"column":1}},"children":[{"type":"paragraph","position":{"start":{"line":374,"column":1},"end":{"line":374,"column":1}},"children":[{"type":"text","value":"Fetching images from someone else’s site also puts strain on their web server, which they may not appreciate.","position":{"start":{"line":374,"column":1},"end":{"line":374,"column":1}},"key":"lwKbU64Bqd"}],"key":"b7N4rKBSyA"}],"enumerator":"1","key":"fzyeTagjjp"}],"key":"IJGSkNoTDU"}],"key":"lVijUS8jy2"},"references":{"cite":{"order":[],"data":{}}},"footer":{"navigation":{"prev":{"title":"Create your own landing page","url":"/landingpage","group":"Jupyter Book 2 Workshop Template"},"next":{"title":"Plugins 🌶","url":"/a-plugins","group":"Jupyter Book 2 Workshop Template"}}},"domain":"http://localhost:3000"}