Page Bundle A

tags: page-bundles leaf-bundle

---

Description/Summary

Index page of Page Bundle A. Link to Leaf Bundle B Link to Branch Bundle C Link to images not in the current directory # Source path contains /static/ # When path contains /static/, the path translations are the exact same as those for non-bundle cases. More details Source path contains the bundle name # See this other test for examples. Inside <ORG_FILE_DIR> Copied-to location inside BUNDLE Explanation <ORG_FILE_DIR>/bar/<BUNDLE>/baz/foo.png <HUGO_BASE_DIR>/content/<SECTION>/<BUNDLE>/baz/foo.png If the file directory path contains "/<BUNDLE>/", the directory structure following that "/<BUNDLE>/" is preserved.

---

Content

Index page of Page Bundle A.

• Link to Leaf Bundle B
• Link to Branch Bundle C

Link to images not in the current directory #

Source path contains /static/ #

When path contains /static/, the path translations are the exact same as those for non-bundle cases.

More details

Source path contains the bundle name #

See this other test for examples.

Inside <ORG_FILE_DIR>	Copied-to location inside BUNDLE	Explanation
<ORG_FILE_DIR>/bar/<BUNDLE>/baz/foo.png	<HUGO_BASE_DIR>/content/<SECTION>/<BUNDLE>/baz/foo.png	If the file directory path contains "/<BUNDLE>/", the directory structure following that "/<BUNDLE>/" is preserved.

Special case: Home page branch bundle #

In this case, both HUGO_SECTION and HUGO_BUNDLE values will be /.

So the images to be copied to the home page branch bundle i.e. the content/ dir must be placed in a special _home/ directory. Here are some examples:

Inside <ORG_FILE_DIR>	Copied-to location inside BUNDLE	Explanation
<ORG_FILE_DIR>/bar/_home/baz/foo.png	<HUGO_BASE_DIR>/content/baz/foo.png	If the page is the home page branch bundle, and the file directory path contains "/_home/", the directory structure following that "/_home/" is preserved.
<ORG_FILE_DIR>/bar/_home/foo.png	<HUGO_BASE_DIR>/content/foo.png

Source path contains neither /static/ nor the bundle name #

Outside static	Copied-to location inside BUNDLE	Explanation
~/temp/bar/baz/foo.png	<HUGO_BASE_DIR>/content/<SECTION>/<BUNDLE>/foo.png	Here, as the outside path does not have /static/, the file is copied directly to the BUNDLE dir.

Same image, but hyperlinked #

Page Bundles with images in the same dir as content Org file #

Inside <ORG_FILE_DIR>	Copied-to location inside BUNDLE	Explanation
<ORG_FILE_DIR>/bar/baz/foo.png	<HUGO_BASE_DIR>/content/<SECTION>/<BUNDLE>/bar/baz/foo.png	Even if the outside path does not have /static/, it is still inside the same dir as the Org file, so the directory structure is preserved.

See this other test for an example.

---

Resources

• Second copy of Org mode logo
• Page (no link, only embedded in page)
• Page (no link, only embedded in page)

---

Bundled Sub-pages

Bundled page bar

“Bar” page in Page Bundle A.

Bundled page foo

“Foo” page in Page Bundle A.

---

Page (Debug)

Page Params (Debug)

Resources (Debug)

File Object (Debug)