/tags/hugo/ Recent content in Hugo on Jack Gregory Hugo -- gohugo.io en © 2026 Jack Gregory Wed, 05 Aug 2026 00:00:00 +0000 /blog/hugo-apero-taxonomy-index-pages/ Wed, 05 Aug 2026 00:00:00 +0000 /blog/hugo-apero-taxonomy-index-pages/ TL;DR In this blog, I summarize the steps necessary to add index pages for categories and tags on a Hugo-Apéro website — an alphabetical, described list of categories, and a grouped, alphabetised list of tags — while keeping the theme’s default term pages intact. Introduction Hugo-Apéro’s default taxonomy setup generates a page for every individual term — /categories/web-development/, /tags/hugo/, and so on — listing the posts that carry it. What it doesn’t generate is a landing page at /categories/ or /tags/ that summarizes all terms at once. /blog/hugo-apero-publication/ Tue, 21 Jul 2026 00:00:00 +0000 /blog/hugo-apero-publication/ TL;DR In this blog, I summarize the steps necessary to add a dedicated publication content type to a Hugo-Apéro website — including a custom byline field for the publishing venue, a choice between one- and two-column layouts, and a sidebar link for citing the work. Introduction Our publications section had been repurposed from an older Academic/Wowchemy-style front matter (format: hugo, featured, publishDate, slug), which meant it inherited Hugo-Apéro’s generic _default templates by default — the same ones used by blog posts, talks, and every other section. /blog/hugo-apero-contact/ Sat, 03 Feb 2024 00:00:00 +0000 /blog/hugo-apero-contact/ TL;DR In this blog, I summarize the steps necessary to move the Contact link on a Hugo-Apéro site from its default spot in the bottom-right footer menu (next to License) up into the top header menu, as the last item. Introduction Hugo-Apéro keeps its navigation in two separate lists in config.toml: [[menu.header]], which renders as the top ribbon of links; and, [[menu.footer]], which renders bottom-right alongside License and Contributors. Contact ships as a footer entry by default. /blog/hugo-apero-blog-toc/ Thu, 18 Jan 2024 00:00:00 +0000 /blog/hugo-apero-blog-toc/ TL;DR In this blog, I summarize the steps necessary to add a table of contents to individual posts on a Hugo-Apéro website, including an optional per-post control over how many heading levels are shown. Introduction Hugo-Apéro doesn’t ship with a toc: true front-matter switch for ordinary blog posts. The theme’s “On this page” table of contents only renders automatically for posts that belong to a series/collection ( hugo-apero/hugo-apero#106) — a standalone post never gets one, no matter how many headings it has. /blog/hugo-apero-homepage/ Thu, 20 Oct 2022 00:00:00 +0000 /blog/hugo-apero-homepage/ TL;DR In this blog, I summarize the steps necessary to change the homepage of a Hugo-Apéro website from the theme’s default side-by-side image/text layout to a stacked layout, with a full-width image on top and centered text below. Introduction Hugo-Apéro’s default layouts/index.html lays the homepage out as two flexbox columns: a text column (title, subtitle, social links, description, action link) on one side, and an image column on the other, toggled left/right with the image_left front-matter param. /blog/google-analytics/ Fri, 09 Sep 2022 00:00:00 +0000 /blog/google-analytics/ TL;DR In this blog, I summarize the steps necessary to set up Google Analytics on a Hugo-Apéro website. Introduction Google Analytics is a useful tool for measuring and understanding engagement with your personal website. In my experience, it is probably the most painless method for accessing detailed tracking data for a Hugo site. Helpfully, most Hugo themes come with it pre-installed through an internal template. In this blog, I’ll outline the two steps necessary to configure Google Analytics for your Hugo-Apéro website: /blog/hugo-apero-private/ Thu, 01 Sep 2022 00:00:00 +0000 /blog/hugo-apero-private/ TL;DR In this blog, I summarize the steps necessary to adapt the deployment of a Hugo-Apéro website to GitHub Pages while keeping either the content or the full website code private. Introduction This is a followup to my companion blog post titled: How to setup hugo-apéro on GitHub Pages. If you’re looking for details on how to setup your Hugo-Apéro website from scratch, I would recommend starting there. In the previous post, the setup resulted in a public GitHub repository for your website. /blog/hugo-apero/ Mon, 29 Aug 2022 00:00:00 +0000 /blog/hugo-apero/ TL;DR In this blog, I summarize the steps necessary to adapt the deployment of a Hugo-Apéro website to GitHub Pages. I also discuss how to use git submodules to include a theme dynamically. Introduction Hugo-Apéro is a Hugo theme for publishing websites using the blogdown package within R. In fact, it’s what I’m using to publish my personal site here! Even if you’ve never used Hugo or blogdown previously, the setup is fairly straightforward.