diff --git a/exampleSite/content/docs/guide/organize-files.md b/exampleSite/content/docs/guide/organize-files.md index 8c343abc..e3a69662 100644 --- a/exampleSite/content/docs/guide/organize-files.md +++ b/exampleSite/content/docs/guide/organize-files.md @@ -82,6 +82,45 @@ weight: 2 It is recommended to keep the sidebar not too deep. If you have a lot of content, consider **splitting them into multiple sections**. {{< /callout >}} +## Breadcrumb Navigation + +Breadcrumbs are auto-generated based on the directory structure of `/content`. + +For example, consider the file structure [demonstrated above](#directory-structure). Given that structure, the breadcrumbs atop the page at `/docs/guide/organize-files/` would appear automatically as follows: + +``` +Documentation > Guide > Organize Files +``` + +### Customizing Breadcrumb Link Titles + +By default, each breadcrumb link is generated based on that page's `title` parameter. You can customize this by specifying a `linkTitle`. + +For example, if instead of `Organize Files` we wanted the breadcrumb to be `Foo Bar`: + +```yaml {filename="content/docs/guide/organize-files.md"} +--- +linkTitle: Foo Bar +title: Organize Files +--- +``` + +This would now generate the following breadcrumbs: +``` +Documentation > Guide > Foo Bar +``` + +### Hiding Breadcrumbs + +You can hide breadcrumbs completely from a page by specfying `breadcrumbs: false` in its front matter: + +```yaml {filename="content/docs/guide/organize-files.md"} +--- +breadcrumbs: false +title: Organize Files +--- +``` + ## Configure Content Directory By default, the root `content/` directory is used by Hugo to build the site. diff --git a/layouts/partials/breadcrumb.html b/layouts/partials/breadcrumb.html index f3852754..fa52f9b9 100644 --- a/layouts/partials/breadcrumb.html +++ b/layouts/partials/breadcrumb.html @@ -1,13 +1,15 @@ -
- {{- range .Ancestors.Reverse }} - {{- if not .IsHome }} -
- {{- partial "utils/title" . -}} -
- {{- partial "utils/icon.html" (dict "name" "chevron-right" "attributes" "class=\"hx-w-3.5 hx-shrink-0 rtl:-hx-rotate-180\"") -}} +{{- if (default true .Params.breadcrumbs) }} +
+ {{- range .Ancestors.Reverse }} + {{- if not .IsHome }} + + {{- partial "utils/icon.html" (dict "name" "chevron-right" "attributes" "class=\"hx-w-3.5 hx-shrink-0 rtl:-hx-rotate-180\"") -}} + {{ end -}} {{ end -}} - {{ end -}} -
- {{- partial "utils/title" . -}} +
+ {{- partial "utils/title" . -}} +
-
+{{ end -}}