Static site generators are one of my favourite things about the Internet. I remember when almost every website built around me was based on Joomla or WordPress. I dread that time.
My website, which you are on right now, is built with Hugo. I have a page on this website listing some of my open-source projects. And I wanted an easy way to show the number of GitHub stars on my Hugo-based website for my open-source projects.
Something like this (e.g. for my Go implementation of Redlock):2168
The number is not hard coded. It is fetched from a GitHub API every time I regenerate my website. And for that, I can either use a shortcode (if it is a part of the content):
Or, a partial (if it is a part of the layout):
Implementing them both is pretty straightforward.
First, implement a partial template like so:
This partial template fetches the repository data from GitHub API. The star count is in the
stargazers_count field of the response JSON.
The template adds “star.svg” from your “assets” directory to the left of the count.
Add this template to the “layouts/partials” directory.
This provides the partial template that you can now use in your layouts. And you can also use this in your shortcodes:
Add this shortcode to the “layouts/shortcodes” directory.
And that’s it! You can show your (or any) GitHub repository star count on your Hugo website.
comments powered by Disqus