Hugo Page Bundles, Leafs and Branch Bundles
Leaf Bundle | Branch Bundle | |
---|---|---|
Usage | Collection of content and attachments for single pages | Collection of attachments for section pages (home page, section, taxonomy terms, taxonomy list) |
Index file name | index.md |
_index.md |
Allowed Resources | Page and non-page (like images, pdf, etc.) types | Only non-page (like images, pdf, etc.) types |
Where can the Resources live? | At any directory level within the leaf bundle directory. | Only in the directory level of the branch bundle directory i.e. the directory containing the _index.md . |
Layout type | single |
list |
Nesting | Does not allow nesting of more bundles under it | Allows nesting of leaf or branch bundles under it |
Example | content/posts/my-post/index.md |
content/posts/_index.md |
Content from non-index page files… | Accessed only as page resources | Accessed only as regular pages |
Multi-Lingual URLs
Content | Example | Front Matter Fields | Configurable Permalink |
---|---|---|---|
Simple Page | content/post/test-1.md |
slug, url | Yes |
Leaf Bundle | content/post/test-2/index.md |
slug, url | Yes |
Section Page / Branch Bundle | content/post/_index.md |
url | No |
-
When both slug and url are specified in front matter, url takes precedence
-
You cannot specify a slug in the front matter of a section page / branch bundle
-
Permalinks defined in site configuration are not applicable to section pages / branch bundles
-
https://github.com/gohugoio/hugo/issues/8970#issuecomment-939399129