Page Designs
A page is displayed by exactly one page design and represented by Hugo’s reserved type
front matter.
The Relearn theme offers the page designs home
, chapter
, and default
but you can define further custom page designs.
Regardless of shipped or custom page design, you are using them in the same way.
-
If you have an archetype file, you can just do
hugo new --kind chapter chapter1/_index.md
-
If you are creating your Markdown files manually, you can achieve the same by just setting
type='chapter'
in the front matter.
Your resulting Markdown file needs to have at least the type
front matter set to the value of the page design
+++
title = "Chapter 1"
type = "chapter"
+++
Predefined Designs
Home
A Home page is the starting page of your project. It’s best to have only one page of this kind in your project.
To create a home page, run the following command
hugo new --kind home _index.md
Chapter
A Chapter displays a page meant to be used as introduction for a set of child pages.
Commonly, it contains a title front matter and a short description in the content.
To create a chapter page, run the following command
hugo new --kind chapter chapter1/_index.md
If a numerical weight
front matter is set, it will be used to generate the subtitle of the chapter page. Set the number to a consecutive value starting at 1 for each new chapter on the same directory level.
Default
A Default page is any other content page.
To create a default page, run either one of the following commands
hugo new chapter1/page1/_index.md
or
hugo new chapter1/page1.md