Navigation
Print Share Copy URL
Breadcrumb
🌼 budding

Authoring Cover Images and Audio Articles

A guide on adding cover images and audio articles

Adding Cover Images

Assign The Cover Images

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

  1. 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"
---
  1. 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. Cat named Cooper with styrofoam on his fur due to electrostatic charge.

Adding Audio Articles

  1. Front Matter Method
---
title: "My Article"
audio: "audio/my-audio.ogg"
---
  1. 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

Giscus require Javascript and LocalStorage to be enable.