Design

Cantos is a static site generator. It is made up of generator functions that create streams of text for us to save to the file system. A generator may operate on a number of input text streams, or just conjure text out of thin air.

An input stream has optional front matter and some content. A generator function is responsible for deciding how to transform the content of the input streams it cares about. For example, if blog posts are written in markdown, then the blog generator will transform this to HTML. However, the blog generator will not be responsible for laying this content out within a site template, this will be handled by a global transformer.

Having said that, the Site data provided to each generator will contain a standard set of transformers, so you can choose to use them.