Chapter 1 Structuring your theme
The way in which you organise the files in your theme is very important, but also very simple. You only need a single html file
The liquid HTML file(s)
The only requirement for your theme is that you have a single file called ‘status-page.liquid’ which is basically an HTML file which contains the markup for your status page.
In addition, you can also include error-page.liquid which you can display to your users when your site is down. This usually contains a general notice, and can also display any notices from the status page should you wish.
So why the .liquid extension? We use the Liquid templating language from the clever folks at Shopify. This will allow you to control the dynamic content of your page.
The ‘includes’ folder
Sometimes your liquid layouts will become more complex, and you’ll find yourself duplicating code across various templates, which can feel a little messy. Put any snippets like this into the includes folder, and you can then reuse them with the liquid include tag
The ‘locales’ folder
This is how we provide multilingual support to your theme, and also allows people to personalize the content. In this folder you have a set of JSON files, one for each language you wish to support, containing a set of keys and the translated phrase.
The ‘assets’ folder
Important: The assets folder cannot contain subfolders.