“Frontmatter” allows page-specific variables to be included at the top of a template using YAML. For a general introduction on frontmatter, see the Middleman frontmatter docs.
These attributes determine the date when the page needs to be reviewed next. See the separate documentation for page expiry for more details.
You can use this in combination with owner_slack to set an owner for the page.
The layout of the page.
--- layout: core ---
There are 2 available page layouts.
layout layout (default)
By default, pages will use the
layout layout. This layout will parse the page and generate a sidebar with a table of contents consisting of each
--- layout: layout --- # The title ## A subheader ### A h3 subheader ## Another subheader
Will generate a page with the headings from the content in the sidebar.
If you want more control about the layout, use
core layout. This allows you to specify the sidebar manually with a
--- layout: core --- <% content_for :sidebar do %> You can put anything in the sidebar. <% end %> This page has a configurable sidebar that is independent of the content.
If you do not specify a sidebar, you will get a simple one-column layout without one.
--- layout: core --- This page does not have a sidebar.
Any paths of pages that should redirect to this page.
--- old_paths: - /some-old-page.html ---
The Slack username or channel of the page owner. This can be used to appoint an individual or team as responsible for keeping the page up to date.
--- owner_slack: "#operations-teams" ---
If the contribution banner is turned on, you can override the “View source” link
The browser title of the page.
--- title: My beautiful page ---
Affects the order a page is displayed in the sidebar navigation tree. Lower weights float to the top. Higher weights sink to the bottom.
--- weight: 20 ---
hide_in_navigation: true to prevent the page from being rendered in the
main page tree navigation.
--- hide_in_navigation: true ---
The page that should be highlighted as ‘active’ in the navigation.
--- parent: shaving-yaks.html ---