Organising files

Here is a fictional cheese lab in the IOT category.

 โ””โ”€โ”€ ๐Ÿ“cheese-lab/
     โ””โ”€โ”€ ๐Ÿ“images/
         โ”œโ”€โ”€ camembert.png
         โ”œโ”€โ”€ cheddar.png
         โ”œโ”€โ”€ roquefort.png
         โ””โ”€โ”€ stilton.png

The main page is /iot/ Jekyll will render this as, 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 /web/ file.

Additional files

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 /iot/cheese-lab/images/stilton.png or images/stilton.png.


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.

โ—„ Content โ–ฒ Index Front Matter โ–บ


Leave a comment