/tags/tutorial/ Recent content in Tutorial 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/itc-fragility-index/ Mon, 01 May 2023 00:00:00 +0000 /blog/itc-fragility-index/ TL;DR The ITC Fragility Index turns a set of business-survey questions about insecurity, trust, and economic performance into a single 0–100 fragility score for each business. We use exploratory factor analysis (EFA) to uncover three underlying dimensions—Human Security, Social Cohesion, and Economic Performance—and then use confirmatory factor analysis (CFA) to test the resulting structure. The three pillars are standardized and combined to produce the final index. Along the way, we demonstrate a practical, reproducible approach to using factor analysis in R to turn a multidimensional survey into a theoretically grounded composite index. /blog/itc-instability-indicators/ Tue, 21 Mar 2023 00:00:00 +0000 /blog/itc-instability-indicators/ TL;DR This blog shows how to use Armed Conflict Location and Event Data (ACLED) event data and geospatial techniques in R to construct location-specific indicators of local instability. Using hypothetical business locations in Ecuador, I demonstrate how nearby adverse events can be aggregated into a simple measure of exposure to insecurity, which can then be used to compare locations or incorporated into analyses of business outcomes. Introduction In the Western world, we can sometimes overlook the benefits derived from operating within stable and peaceful communities. /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.