Ciara

A Micro.blog-compatible Hugo port of the Peli-Kiera Pelican theme (itself an homage to Hugo-Kiera).

It keeps the typography, layout, and image-placement conventions of Peli-Kiera while restructuring the templates for Hugo and Micro.blog:

• h-feed / h-entry microformats on listings and single posts.
• Title-less posts (Micro.blog "short notes") render inline with no heading.
• microhook.html partial so Micro.blog can inject custom CSS/JS.
• RSS and JSON Feed link tags, rel=me, rel=webmention, IndieAuth-friendly hooks.
• Year-grouped archive listings (matching the Peli-Kiera category page).

Installing on Micro.blog

1. In your Micro.blog account, go to Design → Edit Custom Themes → New Theme and pull the theme from your GitHub fork, or upload it as a theme plug-in.
2. Set this theme as the active design.
3. Optional: add the parameters listed below under [params] in your blog settings (or directly in the theme's config.json).

Installing as a regular Hugo theme

cd your-hugo-site
git submodule add https://github.com/zacbir/Ciara themes/Ciara

Then point Hugo at it:

# hugo.yaml
theme: Ciara
languageCode: en
title: My Site

params:
  subtitle: "An evergreen blog"
  author: "Your Name"
  copyright: "2026"
  description: "Short description used for OG tags and the default meta description."
  displayPagesOnMenu: true
  displayCategoriesOnMenu: false
  gitHubURL: "https://github.com/your-handle"
  customCSS: ""
  disqusShortname: ""
  relMe:
    - "https://micro.blog/your-handle"
    - "https://github.com/your-handle"
  webmentionEndpoint: ""
  indieAuthEndpoint: ""
  webring:
    variablesURL: "https://woodpaneled.org/scripts/onionring-variables.js"
    widgetURL: "https://woodpaneled.org/scripts/onionring-widget.js"

menu:
  main:
    - identifier: archives
      name: Archives
      url: /archives/
      weight: 10
    - identifier: categories
      name: Categories
      url: /categories/
      weight: 20
    - identifier: tags
      name: Tags
      url: /tags/
      weight: 30

Authoring

A regular long-form post:

---
title: "Simple is better than complex"
date: 2026-05-20
tags: [python, jupyter]
categories: [Python]
description: "The Zen of Python"
---

### Introduction

This is a standard paragraph.

A Micro.blog short note (no title):

---
date: 2026-05-20T09:12:00-04:00
---

Just a quick thought — no title needed.

Image placements

The original Peli-Kiera image-placement conventions are preserved. Append a URL fragment to your image source to control how it's laid out:

![camera]({{< ref "images/camera.png" >}}#float-right "camera icon")

Supported fragments: #float-right, #float-left, #mid, #full.

You can also wrap raw HTML in a <figure class="float-right">, figure.float-left, figure.mid, or figure.full for the same effect.

Features

• Atom/RSS/JSON feeds (Hugo built-ins) with auto-discovery <link> tags.
• Mobile friendly.
• Microformats2 (h-card, h-feed, h-entry) for Micro.blog and IndieWeb compat.
• Disqus comment fallback (off by default).
• Font Awesome icons via CDN.
• Numbered pagination centered on the current page (+/- 3 neighbors), as in the original.
• Year-grouped archive lists.

License

MIT, via Hugo-Kiera and Peli-Kiera.