Skip to main content
On this page

Content Management

This page explains how to manage the content of a Hugo project and introduces Hugo’s page types along with the two Deca template modes.

Page Types

Page types form the basic structure of a Hugo project. Understanding them ensures your project renders as expected.

Single Page

A regular content page rendered with page.html in the base templates, conceptually corresponding to a leaf bundle.

content/
  docs/
    my-post/
      index.md      ← Single page
      image.png     ← Page resource of the single page

List Page

A list page used to display child pages, rendered with section.html in the base templates, corresponding to a branch bundle.

content/
  docs/
    tutorial/
      _index.md     ← List page
      image.png     ← Page resource of the list page
Note

If a directory contains other pages, its Markdown file should not be named index.md.

Deca Templates

Deca uses the Hugo new templating system, which automatically matches paths and selects the appropriate template for rendering. By default, all templates render in document style, while articles under the content/blog directory use the blog layout.

If a path is not under blog but you still want to use the blog layout, add the following front matter at the top-level _index.md of that path:

---
title: Another blog section
cascade:
  type: blog
---