TheCloud/hugoDocs
1
0
Fork 0
mirror of https://github.com/gohugoio/hugoDocs.git synced 2025-09-15 20:14:56 -04:00
Code Issues Packages Projects Releases Wiki Activity

Clarify leaf bundle explanation and related FAQ

Browse Source 
Organize the content of the leaf bundle such that the example with 4 leaf
bundles shows four headings. Align headings with branch bundles.
Explain that the content files will not result in rendered pages.

Add a hint to check for index.md's that may inadvertently have created
a leaf bundle thus preventing a page from being rendered.
This commit is contained in:
Sebastiaan Lampo 2021-02-10 11:17:59 -07:00 committed by Bjørn Erik Pedersen
parent 0c6b32bb91
commit 89aa723cc5
2 changed files with 12 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
content/en/content-management/page-bundles.md
View File

@ -64,26 +64,27 @@ content/
In the above example `content/` directory, there are four leaf In the above example `content/` directory, there are four leaf
bundles: bundles:
about `about`
: This leaf bundle is at the root level (directly under : This leaf bundle is at the root level (directly under
`content` directory) and has only the `index.md`. `content` directory) and has only the `index.md`.
my-post `my-post`
: This leaf bundle has the `index.md`, two other content : This leaf bundle has the `index.md`, two other content
Markdown files and two image files. Markdown files and two image files.
image1 - image1, image2:
: This image is a page resource of `my-post` These images are page resources of `my-post`
and only available in `my-post/index.md` resources. and only available in `my-post/index.md` resources.
image2 - content1, content2:
: This image is a page resource of `my-post` These content files are page resources of `my-post`
and only available in `my-post/index.md` resources. and only available in `my-post/index.md` resources.
They will **not** be rendered as individual pages.
my-other-post `my-other-post`
: This leaf bundle has only the `index.md`. : This leaf bundle has only the `index.md`.
another-leaf-bundle `another-leaf-bundle`
: This leaf bundle is nested under couple of : This leaf bundle is nested under couple of
directories. This bundle also has only the `index.md`. directories. This bundle also has only the `index.md`.

2
content/en/troubleshooting/faq.md
View File

@ -21,6 +21,8 @@ aliases: [/faq/]
Is your markdown file [in draft mode](https://gohugo.io/content-management/front-matter/#front-matter-variables)? When testing, run `hugo server` with the `-D` or `--buildDrafts` [switch](https://gohugo.io/getting-started/usage/#draft-future-and-expired-content). Is your markdown file [in draft mode](https://gohugo.io/content-management/front-matter/#front-matter-variables)? When testing, run `hugo server` with the `-D` or `--buildDrafts` [switch](https://gohugo.io/getting-started/usage/#draft-future-and-expired-content).
Is your markdown file part of a [leaf bundle](/content-management/page-bundles/)? If there is an `index.md` file in the same or any parent directory then other markdown files will not be rendered as individual pages.
## Can I set configuration variables via OS environment? ## Can I set configuration variables via OS environment?
Yes you can! See [Configure with Environment Variables](/getting-started/configuration/#configure-with-environment-variables). Yes you can! See [Configure with Environment Variables](/getting-started/configuration/#configure-with-environment-variables).