1.4. Creating a page 📄index.md

Folder structure

📂content
┣ 📄index.md
┗ 📂 mypage
   ┣ 📄index.md
   ┣ 📄slide1.md
   ┣ 📄slide2.md
   ┣ 📄slide3.md
   ┗ 📂figures
     ┗ 📊figure1.png

• Add the pages title (e.g. # myPage)

• Use the {% if slide %}...{% else %}...{% endif %} to separate single slides and the page content

• Within the {% if slide %}...{% else %} create a toctree and import the slides:

  ```{toctree}
  :maxdepth: 2
  ./slide1
  ...
  ```
  

• Include the slides in the {% else %}...{% endif%}

  <!-- BUILDING THE PAGES -->
  ```{include} ./slide1.md
  ```
  

• Optionally add further content to the page in {% else %}...{% endif%}

  <!-- BUILDING THE PAGES -->
  This is some additional text to introduce content from slide1
  ```{include} ./slide1.md
  ```
  ```{margin}
  and some site note we want to add in the page
  ```