Pages

In site.nix, a page is declared as an attribute set in the pages attribute, example:

pages = {
  about = {
    path     = "/about.html";
    template = templates.page.full;
    layout   = templates.layout;
  } // data.about;
};

Note: This example merges a data set in the page set, this is usual way to create pages from data.

Basics

During site generation, styx evaluates generatePage on each pages page.
generatePage definition is page: pages.layout (page.template page), it simply evaluates a page set by its template, and evaluate that result with the layout.
The generated page content is output in the page path file.

A simple example of a page is:

pages = {
  hello = {
    layout = template: "<html><body>${template}</body></html>";
    template = page: ''
      <h1>Styx example page</h1>
      ${page.content}
    '';
    content = "<p>Hello world!</p>";
    path = "/hello.html";
  };
}

Will generate /hello.html with the following contents:

<html><body><h1>Styx example page</h1>
<p>Hello world!</p>
</body></html>

Helper functions

The standard library provide helper functions to generate multiple type of pages: