Custom shortcodes
I’ve known about custom shortcodes in Hugo for awhile, but I’ve never had the need to use them.
Now that I’m taking part in 100DaysToOffload, it makes sense to create one, because it makes it less cumbersome to write posts. I only have to make changes to one file to update copy across all of my related posts.
The implementation is concise, you create a new HTML file in layouts/shortcodes
, for example:
<!--100daystooffload.html-->
This is post number {{ $.Page.Params.sequence }} in my [100 Days To Offload](https://100daystooffload.com/) challenge.
[View all posts](/tags/100daystooffload/) or [subscribe via RSS](/tags/100daystooffload/index.xml).
---
Then you can refer to the shortcode in your posts using the filename excluding the extension:
{{% 100daystooffload %}}
The reference to $.Page.Params.sequence
is replaced with the sequence
variable defined in the frontmatter for the post. For each new post I write, I manually set the sequence
accordingly. This post, for instance, is number 4.
On the web
📝 10 May 2025 at 14:07 - So it turns out that rotavating tilling is really bloody...
Sat May 10 2025 by Kev QuirkCommitting XML horrors to style my blogroll
Sat May 10 2025 by nicholas.cloudThe Space Merchants
Fri May 9 2025 by joelchrono's websiteMoving my personal infrastructure to Kubernetes (single-node k3s)
Sun Apr 20 2025 by Stan's blogVisualizing Chess Bitboards
Sun Apr 13 2025 by Andrew Healey's Blog
Generated by openring