Authoring Cover Images and Audio Articles

Author Name — Sat, 22 Feb 2025 00:00:00 +0000

Adding Cover Images

Assign The Cover Images

To add a cover image to your article, you have two options:

Front Matter Method

You can use either cover or images parameter for the images source. And alt, coverAlt or imagesAlt parameter for alt text.

---
title: "My Article"
images: "images/my-cover.jpg"
alt: "Description of the images"
---

Page Bundle Method

Create a folder for your post
Name your image cover.*
Place it in the same folder as your content
Set the alt text in your post frontmatter

Place The Cover

You can place your featured images in various layout, anywhere on article content with {{< figure >}} shortcode:

{{< figure src="cover" caption="alt" >}}

This is freedom of authoring!

Cat named Cooper with styrofoam on his fur due to electrostatic charge.

Adding Audio Articles

Front Matter Method

---
title: "My Article"
audio: "audio/my-audio.ogg"
---

Page Bundle Method

You can upload multiple audio format with this method:

Create a folder for your post
Name your audio audio.*
Place it in the same folder as your content

Page Bundle Method Examples

Here’s how your folder structure should look:

content/
└── posts/
 └── my-article/
 ├── index.md
 ├── cover.jpg
 ├── audio.mp3
 └── audio.ogg

Authoring Terms Entry

Author Name & A.N. Other — Mon, 03 Feb 2025 00:00:00 +0000

You can change the cover of each terms entry by adding the cover parameter in _index.md under [lang]\[taxonomies]\[terms]\. For example, to set the cover of the term configuration in categories, add the parameter in content\en\categories\configuration\_index.md.

---
title: "Configuration"
description: "Configuration description, this might be useful for HTML metadata"
cover: "https://example.com/cover.png"
translationKey: configuration
---

If something is written here, the text will be displayed as hero section.

To link the terms entry in another language, you can add the translationKey parameter. For example, if you want to link the terms entry in Indonesian, add the parameter in content\id\categories\konfigurasi\_index.md.

---
title: "Konfigurasi"
description: "Deskripsi konfigurasi, ini bisa berguna untuk metadata HTML"
cover: "https://example.com/cover.png"
translationKey: configuration
---

Jika ada teks yang ditulis di sini, teks akan ditampilkan sebagai bagian hero.

The same way, you can set the cover of each terms entry for series and author taxonomies. After making these changes, rebuild your site to see the updated cover and translations in breadcrumbs. The cover will replace the flowlines images on taxonomies listing.