Homepage
The homepage is built from two parts: the body copy you write in your homepage content file, and an optional list of recent posts that Ananke adds below it.
The homepage content file #
The text at the top of the homepage comes from content/_index.md. Whatever you
write in the body of that file is rendered as the homepage introduction:
+++
title = "Welcome"
featured_image = "/images/home.jpg"
+++
This is the homepage introduction. Write anything you like here — it is
rendered as the top of the homepage.If content/_index.md does not exist, the homepage shows only the recent posts
(if enabled) and no introduction text.
Recent posts #
By default Ananke lists recent posts below the homepage introduction. Toggle
this with show_recent_posts under the ananke namespace:
# config/_default/params.toml
[ananke]
show_recent_posts = trueSet it to false to hide the list entirely (see
A homepage without blog posts).
How many posts appear #
The number of recent posts shown is controlled by recent_posts_number, which
defaults to 3:
# config/_default/params.toml
[params]
recent_posts_number = 3After the first recent_posts_number posts (shown as summary cards), the
homepage adds a “More” list with links to the next few posts, so visitors can
reach older content without a full archive page.
[!NOTE]
show_recent_postslives under the[ananke]table, whilerecent_posts_numberis a top-level[params]value. This is intentional — copy each example to the table shown in its comment.
Which section recent posts come from #
Recent posts are drawn from your site’s main sections. If you do not set them, Hugo uses the section with the most pages, which is not always your blog. To select the section, for example posts or blog, set mainSections:
# config/_default/params.toml
[params]
mainSections = ["posts"]Posts are in Hugo’s default order: by weight first, then by date with the newest first, then by title. A post with a weight in its front matter therefore comes before newer posts without one.
A homepage without blog posts #
For a static site or a simple landing page with no post list, disable recent
posts and write your content in content/_index.md:
# config/_default/params.toml
[ananke]
show_recent_posts = false+++
title = "My Studio"
featured_image = "/images/studio.jpg"
+++
We design and build things. Get in touch to start a project.The homepage then shows just your introduction and hero image.
Content alignment #
The homepage introduction can be aligned left, centre, or right with
ananke.home.content_alignment (the default is center):
# config/_default/params.toml
[ananke.home]
content_alignment = "left"The homepage hero image #
The large image at the top of the homepage is the homepage’s featured_image,
set in the front matter of content/_index.md as shown above. The lookup rules,
static vs page-bundle paths, and the colour fallback when no image is set are
all described in Page headers.