Metadata can be added to Pages and custom Resources by using YAML. The YAML front matter must be the first thing in the file and takes the form of:

title: Using YAML Front Matter
layout: false

Predefined Metadata

title This is the title of the Page. By default it will be generated from the basename of the Page file. For Example: my-first-post.haml would become 'My First Post'.
extension This would be the extension of the file generated from the Page file. This defaults to '.html'.
url This is the URL that will be used to determine the output file's location and name. This defaults to the same location (relative to the pages directory) of the Page and its filename without the extension (and dasherized). For Example: The Page: pages/about_us/our_services.haml would default to the URL: '/about-us/our-services/'.
layout This is the name of the layout used for the Page. Settings this value to false will process the Page without a layout. This defaults to 'main'.

Custom Metadata

Any other metadata will be available as locals in your pages. For instance:

title: It's Christmas!
date: 2009-12-25
<h1><%= title %></h1>
<p><%= date.strftime("%m, %e, %Y") %></p>

The page object will also be available in your layout as page, and the same methods can be called on it:

    <title><%= page.title %></title>
    <%= yield %>
Fork me on GitHub