Here is a fictional cheese lab in the IOT category.
📁iot/ ├── cheese-lab.md └── 📁cheese-lab/ ├── prepguide.md └── 📁images/ ├── camembert.png ├── cheddar.png ├── roquefort.png └── stilton.png
The main page is
/iot/cheese-lab.md. Jekyll will render this as
https://azurecitadel.com/iot/cheese-lab/index.html, and you’ll be able to reach it at
If you have no screenshots or other linked content, then this is the only file that you need. This is a common approach for those who have their own repositories. (Also if the linked content is not within the Citadel repo.) For a good example, see Ben’s Demo Web Apps page, which is generated from the
If you need to host additional content then you’ll need to create a folder with the same name, e.g.
/iot/cheese-lab. To link to the example prep guide, either link absolutely using
/iot/cheese-lab/prepguide, or relatively using
./prepguide. To link back from the prepguide to the main cheese lab, the link would be
/iot/cheese-lab/ or just
.. to go up one level.
Images that are only used within the lab (such as screenshots) should be placed in an images folder within the lab specific folder, so the links to the stilton file would be
Take a look at the /templates folder for an example single page template. You can copy this for use. At the top of the template you’ll see a Front Matter section followed by some useful reminders.
The next page will go through how to configure the Front Matter.