Partials
Banner
Banner is ‘hero’ type partial, applied to sections by default. This partial will use the page title as a level 1 header (h1
), and renders the page description.
{{ partial "banner" . }}
Breadcrumb
Renders a breadcrumb trail of the page ancestors, as defined by Hugo. Utilizes bootstrap breadcrumb classes. Configurable in parameters file.
{{ partial "breadcrumb" . }}
Card Tree
Creates navigation cards for a given context. On the home
page, creates cards for sections only. On section
and page
pages, creates cards for all pages. Includes a page counter when multiple pages are nested.
{{ partial "card-tree" . }}
Carousel
Creates carousel of images. Pass images in as a dictionary. Uses carousel-image
partial to process images for output.
{{ $projectImages := resources.Match "images/example/*" }}
{{ partial "carousel" (dict "images" $projectImages) }}
{{ $projectImages := slice "images/example/1.jpg" "img/exp/4.jpg" }}
{{ partial "carousel" (dict "images" $projectImages) }}
Carousel Image
Processing partial for images loaded in the carousel
partial. Resizes the images to 1920x, preserving aspect ratio, and compresses the image using lanczos
.
{{ range $projectImages }}
{{ partial "carousel-image" . }}
{{ end }}
Connect
Connect renders the “connect” menu (.Site.Menus.Connect
) in an unordered list with the nav
class. Will use link, title, icon, and color information as configured.
{{ partial "connect" . }}
Foot
Foot partial used to load Bootstrap, Shock, and custom site scripts. All loaded scripts include “sha384” file integrities.
{{ partial "foot" . }}
Footer
Loads the “footer” menu (.Site.Menus.Footer
), copyright statement, and “connect” menu (.Site.Menus.Connect
) by default.
{{ partial "footer" . }}
Head
HTML <head>
configuration for all pages, includes SCSS loading. Loaded CSS stylesheets will include “sha384” file integrities.
{{ partial "head" . }}
Header
Main header and navigation bar.
{{ partial "header" . }}
Heading
Render document heading include h1
with page title and togglable last modified date.
{{ partial "heading" . }}
Icon
Load specified icon from Lucide icon pack. If it does not find a matching icon, it will attempt to use an icon from Simple Icons with icon-brand
.
{{ partial "icon" "globe" }}
Shortcode
The icon
partial has a matching shortcode.
{{< icon "globe" >}}
Shortcode Example | Output | Notes |
---|---|---|
{{< icon "globe" >}} | Icon from Lucide. | |
{{< icon "hugo" >}} | Icon from Simple Icons. |
Icon Brand
Load specified brand icon from Simple Icons icon pack.
{{ partial "icon-brand" "hugo" }}
Shortcode
The icon-brand
partial has a matching shortcode.
{{< icon "hugo" >}}
Shortcode Example | Output | Notes |
---|---|---|
{{< icon-brand "hugo" >}} | Icon from Simple Icons. | |
{{< icon-brand "codeberg" >}} | Icon from Simple Icons. |
Include Markdown
Include a markdown file and markdownify it.
{{ partial "include-md" . }}
Shortcode
The include-md
partial has a matching shortcode.
{{< include-md "path/to/file.md" >}}
Last Mod
Last modified date for given context.
{{ partial "lastmod" . }}
Shortcode
The lastmod
partial has a matching shortcode.
{{< lastmod >}}
Shortcode Example | Output | Notes |
---|---|---|
{{< lastmod >}} | 2025.02.13 | Works as markdown or HTML shortcode. Only HTML variant will integrate with document formatting, as seen here. |
Sidebar
Render sidebar on page. For home and section pages this will include links and sub-links to section content. For single pages this will include a table of contents of the page.
{{ partial "sidebar" . }}
Title
Page title, with appended site name on non-home pages.
{{ partial "title" . }}