Skip to main content

Reference - Front matter

Published:

These parameters extend standard Hugo functionality and are categorized into global site parameters and page-level front matter.

Blog Config

Article Pages

Configurations of index.md.

VariableTypeDescription
layoutStringSets the article layout. Support values: 2-col, 3-col.
imagePositionStringSets the CSS object-position for the featured image to keep the subject properly framed. Supported values are as specified in the MDN documentation.
breadcrumbBoolControls whether hierarchical breadcrumb navigation is shown at the top of the article.
pageHeroStyleStringDefines the visual style of the page hero section. Supported values: background, big, disable.
pageFeatureImageStringDefines the featured image of a single page.
pageShowSeriesStringControls the visibility and placement of the series taxonomy navigation. Supported values: top, bottom, both, disable.
pageShowNextBoolControls whether a pagination link to the next chronological article is displayed.
pageShowRelatedBoolControls whether the Related Articles section is displayed at the end of the content.
pageShowTagsBoolControls whether taxonomy tags assigned to the article are displayed.
pageShowCategoriesBoolControls whether taxonomy categories assigned to the article are displayed.
pageNoListBoolExclude the page from list pages and search.

Section Pages

Configurations of _index.md.

VariableTypeDescription
sectionQuickReferenceBoolGenerates a simplified index for the section to support quick content discovery.

Docs Config

Article Pages

Configurations of index.md.

VariableTypeDescription
docsIconStringDefines the icon for the specific entry in the documentation list.
docsIconClassStringSpecifies CSS classes applied to the docsIcon wrapper for custom styling.

Section Pages

Configurations of _index.md.

VariableTypeDescription
docsIconStringDefines the icon for the specific entry in the documentation list.
docsIconClassStringSpecifies CSS classes applied to the docsIcon wrapper for custom styling.
docsNavCollapsedBoolDetermines whether the navigation list for the current section is collapsed by default.