hugo
Call it The GCDLADB if you like.
NPM to Rule Them All 1 min read May 30, 2023
NPM for the Win, EVERYWHERE My first experiences with the EVERYWHERE component of this subject involved my personal blog and then Rootstalk. So, I’m not going to elaborate on this here, I’ll just provide a link to specifics documented in my personal blog: https://blog.summittdweller.com/wrap-everything-in-npm/ That’s all folks… use the Force links, Luke! ...
A Pagefind Problem? 3 min read May 10, 2023 | Updated: Jun 26, 2023 10:04
Not Just a Pagefind Issue Take note of the question mark at the end of the title, otherwise it could be somewhat misleading. This is not really a problem with Pagefind or Hugo, but one with cloud deployment of static apps, particularly as an Azure Static Web App or DigitalOcean static site. The Nutshell As you may know from post 143, I have successfully installed and configured Pagefind in Rootstalk, but thus far it only works locally. When I try to deploy Pagefind to the cloud, specifically as an Azure Static Web App, I can’t make it work because there’s no apparent way to invoke the necessary npx pagefind. ...
Adding a Custom 404 Page in Hugo 7 min read Feb 16, 2023 | Updated: Feb 21, 2023 10:39
The task du jour is to begin, and perhaps complete, the process of adding a custom 404 page to Rootstalk. Thus far I’ve found a couple of promising resources to guide the effort: Custom 404 Page Custom 404 pages in Hugo done right In particular, I’m focusing on “Option 2” in the “…done right” document, and the “Azure Static Web App” portion of the first document. Need a New Azure API Key? Early in this journey I found that I could not deploy changes to https://thankful-flower-0a2308810. ...
Hugo: Attachments and Bundles 2 min read Jan 12, 2023
This post was written as follow-up to my previous post where I implemented a custom Hugo shortcode, attachments.html, documented in attachments.html below. The implementation of this shortcode required a Hugo Page Bundles content structure and the transition to such a structure is documented below in Page Bundles Structure. attachments.html This shortcode, attachments.html, was lifted from Hugo Attachment shortcode, a blog post by Nelis Oostens. Successfull implementation of this shortcode one minor modification (my theme did not have a referenced partial) and conversion of my content/posts from individual Markdown (. ...
Blog Migration Details 1 min read Oct 8, 2021
The Grinnell College Digital Library Application Developer’s Blog I’m getting really lazy in my old age, so what I’ve posted here is just the meager README.md file from my blog’s new GitHub repo. This project, my Grinnell College Digital Library Application Developer’s blog, is no longer a Docker “Multi-Stage” build. GitHub Pages I successfully moved this blog to GitHub Pages in October 2021, after creating instances of it on DigitalOcean and Azure. GH Pages, specifically https://static.grinnell.edu/dlad-blog/ seems like the right home for it, finally. ...
Moving Static Sites to GitHub Pages 2 min read Oct 5, 2021 | Updated: Oct 6, 2021 07:43
Pertinent Resources This section simply tabluates the posts and documentation used to effect migration of all sites from the Grinnell College static host to GitHub Pages. Resource Address Hugo: Host on GitHub https://gohugo.io/hosting-and-deployment/hosting-on-github/ GitHub: Getting started with GitHub Pages https://docs.github.com/en/pages/getting-started-with-github-pages GitHub: Creating a GitHub Pages site https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site GitHub: Managing a custom domain for your GitHub Pages site https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain Customizations Do NOT Set publishDir = "docs" Do NOT change the publishDir parameter in your configuration, if you even have one! The default public setting is correct. ...
Collaborating on Hugo Site Development 9 min read Nov 12, 2020 | Updated: Sep 27, 2021 13:42
I’ve nearly completed migration of all Grinnell College Libraries’ static sites to Azure and I’m updating this post to reflect that move. Wherever possible I’ll strike-through outdated information like this, and replace it with updated info. This post will instruct the reader to install necessary tools and engage the workflow I now use to develop and maintain a handful of Hugo static websites. The list of sites now includes both professional, those owned and operated by Grinnell College, as well as “personal” sites that I develop, maintain and host myself. ...
Scheduled Updates for a Hugo Static Site 5 min read Jul 18, 2020 Mackenzie McFate
A few months ago I migrated a site, The Compass Rose Band, from Drupal to Hugo for my Uncle. Since then I have been maintaining the site, adding and removing dates, and updating the site about every other week. With the passage of time events on the site “automatically” move from “upcoming” to “past”, but since it is a “static” site, that only happens when I recompile and rebuild the site. So I needed to automate builds. I tried a few different ideas I’d heard about, including crontab, but on my Mac desktop I ended up settling on an Automator workflow tied to a Calendar event. ...
New Blog Style and Features 1 min read Mar 10, 2020
Welcome to my new blog theme/style with new features. All of the content, aka ‘posts’, from my old blog have been moved here, but there are still lots of remnants of the new theme, Zzo, lurking here. Please be patient with this new format while I work to fully implement all the features that this setup provides. Also, thank you, Mackenzie. My daughter played an important role in helping me with this transition. And it’s time to do some real work… I’ll be back to share more here soon. ...
Hugo, Goldmark and CommonMark Compliance 1 min read Feb 11, 2020
Just making a note here that Hugo, as of version 0.60.0, is now using the Goldmark markdown rendering library, and that library is CommonMark compliant. The official word, from this document states that: Goldmark is from Hugo 0.60 the default library used for Markdown. It’s fast, it’s CommonMark compliant and it’s very flexible. Note that the feature set of Goldmark vs Blackfriday isn’t the same; you gain a lot but also lose some, but we will work to bridge any gap in the upcoming Hugo versions. ...