Parakeet: Pages

A Parakeet page is any file which results in a HTML file being produced.

.page files

A file with the .page extension is interpreted as consisting of an optional header and a body. The body part contains the markup of the page.

The header can be used to set meta-data about the page, for example, the navigation title or categories. All data in the header can be set in the associated config file, but being able to specify everything in one file is more convienant.

The header data is set in the format of key: value. The header section ends when the first non-blank line not in that format is seen, or when a line of dashes is seen.

For example, for a blog post we may wish to specify the post is in categories “dogs” and “animals”, and can be accessed with the quicklink “pets”.

category: dogs
category: animals

quick link: pets

---+ Why dogs are great
They just are.

The header can also specify which markup language to use. Presuming the site default is Peanut, and we wanted just this page to be in Markdown, we would write:

category: dogs
category: animals

quick link: pets

markup: markdown

# Why dogs are great
They just are.

Naked pages

A naked page is a file which only contains the markup and has no header section.

A file named .md (or .markdown) will be intepreted as a naked page containing Markdown data. Similarly a file named .peanut will be treated as a naked page containing Peanut data.

In general I would recommend using .page files to benefit from the header section.