Tophhttps://justwheel.github.io/toph-hugo-theme/tags/toph/Honorary biography page of Septima Clark, a Civil Rights Movement pioneer and activist.Hugo -- gohugo.ioen-usSeptima Poinsette ClarkMon, 01 Jan 0001 00:00:00 +0000Blogging with AsciiDoc in Tophhttps://justwheel.github.io/toph-hugo-theme/blog/asciidoc-blogging/Mon, 23 Mar 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/blog/asciidoc-blogging/

Toph treats AsciiDoc as a first-class content format. Everything that works with Markdown also works with AsciiDoc β€” taxonomy badges, post metadata, cover images, heading anchors, and navigation.

Why AsciiDoc?

AsciiDoc offers features that Markdown does not:

  • Native table of contents with :toc: document attribute

  • Admonition blocks (NOTE, TIP, WARNING, IMPORTANT, CAUTION)

  • Include directives for reusing content across pages

  • Built-in support for complex tables and nested lists

If you are already comfortable writing in AsciiDoc, Toph will serve your needs without compromise.

Creating an AsciiDoc post

Create a file with the .adoc extension in your blog directory:

hugo new blog/my-post.adoc

Add YAML front matter at the top of the file, followed by AsciiDoc content:

---
title: "My Post Title"
date: 2026-01-15
draft: false
categories:
  - "tech"
tags:
  - "hugo"
  - "asciidoc"
author: "Author Name"
description: "A short summary of the post."
---

Your AsciiDoc content starts here.

Table of contents

To enable a table of contents, add the :toc: attribute after the front matter:

---
title: "My Post Title"
toc: true
---
:toc:

== First Section

Toph’s CSS styles the AsciiDoc-generated table of contents identically to Markdown’s toc: true front matter option. Both formats produce the same visual result.

Heading anchors

Clickable anchor links (πŸ”—) appear on hover for all section headings. For Markdown, this is handled by a Hugo render hook. For AsciiDoc, Toph injects the same anchor markup via template processing. Both formats produce identical results.

Learn more

]]>Hello World: Introducing Blogging in Tophhttps://justwheel.github.io/toph-hugo-theme/blog/hello-world/Sun, 22 Mar 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/blog/hello-world/We’re excited to announce that the Toph Hugo theme now supports blogging! Toph started as a lightweight biography and portfolio theme, but it has grown into a capable publishing platform. Here’s a quick tour of what’s new.

Taxonomy support πŸ”—

Posts can be organized with categories and tags. Categories are broad groupings displayed as magazine-style cards on the categories page. Tags are more granular and shown as a visual word cloud on the tags page.

To use them, add categories and tags to your post’s front matter:

categories: ["announcements"]
tags: ["toph", "blogging", "hugo"]

Post metadata πŸ”—

Every blog post automatically displays its publication date, author, reading time, and word count. Categories and tags appear as linked badges beneath the metadata bar. If your site has enableGitInfo: true, an “Updated” date appears when the post is modified after publication.

Blog archive πŸ”—

The blog archive groups posts by year and month in a collapsible accordion layout. The most recent year and month are expanded by default, keeping the archive scannable even as it grows.

Recent posts on the homepage πŸ”—

The five most recent blog posts appear on the homepage automatically. The latest post is featured in a large card, with the next four in a compact grid below it. No configuration is needed β€” if blog posts exist, they show up.

Post navigation πŸ”—

At the bottom of each post, previous and next links let readers move between posts without going back to the archive.

Getting started πŸ”—

Create a new blog post with Hugo’s built-in archetype:

hugo new blog/my-first-post.md

This scaffolds a new post with the right front matter fields. Set draft: false when you’re ready to publish, and rebuild your site.

For more details, see the Toph theme repository.

]]>