Balloon Layout Document

Balloon is useful for demonstrating information step-by-step.

This layout can be used on both section page (_index.md) and regular post (xxx.md).

Configuration

---
type: 'balloon'
---

Specify type in front-matter will change the template lookup order.

balloon_resources

Content resources. URL can be an absolute path (with / prefix, relative to base URL), or relative path (without /, relative to current path)

Hugo will handle multilingual scenario out of the box

For example:

https://kaiiiz.github.io/hugo-theme-monochrome/about
        \____________________________________/\____/
                    base URL           balloon_resources
---
balloon_resources: "/about"
---

default: error will occur in page

balloon_img_src

Balloon head image URL. URL must be relative to the base URL. (without / prefix)

For example:

https://kaiiiz.github.io/hugo-theme-monochrome/thanks.jpg
        \_____________________________________/\________/
                    base URL                 balloon_img_src
---
balloon_img_src: 'thanks.jpg'
---

default: fallback to balloon_img_src_dark, if failed, image become dot

balloon_img_src_dark

Balloon head image URL for dark mode. URL must be relative to the base URL. (without / prefix)

For example:

https://kaiiiz.github.io/hugo-theme-monochrome/thanks.jpg
        \_____________________________________/\________/
                    base URL              balloon_img_src
---
balloon_img_src_dark: 'thanks.jpg'
---

default: fallback to balloon_img_src, if failed, image become dot

balloon_circle

balloon head shape can be square or circle.

---
balloon_circle: true
---

default: true

Resouces Configuration

These settings are under the resource specified in balloon_resources.

title

Title of content card.

---
title: 'Story before hugo'
---

default: no title

weight

---
weight: 3
---

default: default order

Headless Bundle

Hugo supports an amazing feature called Headless Bundle, which elegantly resolved the resouces publish issue.

For example, if you don’t want to publish the resouces of the balloon layout, you can create a leaf bundle and specified headless = true in index.md’s front-matter. These resources will only be used during rendering process. In other word, no file will be generated to /public folder.

Checkout Headless Bundle for more details.