All .pug files in ./src will be converted to matching .html files in
./dist.
Each .pug file can start with a custom frontmatter block. Such blocks are
comments delimited by //- --- and contains key/values pairs of data that will
be forwarded to the Pug rendering engine.
You can use this block to change some of the page metadata, like its title or
description.
//- ---
//- title: This is my page title
//- description: This is my page description
//- ---
p This is my page content
Note that this frontmatter syntax is not valid in Pug. This is a custom syntax
specific for norska, hence why we need to "hide" it in comments.
By default, all .pug file will use the default layout. You can change the
layout of a specific page by setting its layout key in the frontmatter.
//- ---
//- layout: blog
//- ---
p This page will use the blog layout (provided you have one)
Check the layouts page to see how to add your own layouts.
Single files will be converted to a directory of the same name, with an
index.html file inside. This means that ./src/about.pug will be converted to
./dist/about/index.html.
This allows cleaner url in the final website: /about/ instead of
/about.html.