Rarely does a day go by that I don’t read of yet another person deciding to move their website to one of the two static site generators (SSGs) closest to my heart: Eleventy and Hugo.
Good going, aforementioned “yet another person.”
To do my part in helping to lure more folks to one of these two happy places, I’m pleased to announce that I’ve created two new starter sets, one for Eleventy and one for Hugo, based on my site.
I’ve also converted my existing Hugo-based version of the Eleventy repo (i.e., the one from which Vercel builds this site) to being another starter set.1 (Why two Hugo starter sets? I’ll explain that shortly.)
Starter vs. non-starter
First, let me deal with one even more salient question: what exactly is a starter set where SSGs are concerned?
In my starter sets’ cases, at least, the term refers to a site repo that has been pared down to a sufficiently minimal set of content and configuration so that, while someone new to the SSG can load and run it, they then can also customize it without having to delete a ton of unneeded stuff.
A few months back, I made public the Hugo and Gatsby versions of this site’s repo. This was a follow-up to my having made my Eleventy repo public last December (the webpack-based version I had for a while) and two months ago (the current, non-webpack version). I thus hoped the choice among the three repos I’d used would be as helpful to me as I have found it to see others’ repos.
The problem with that approach was, as I noted in the repos’ README files, each definitely wasn’t a starter set although it could be used as one — if, of course, one was willing to go through and carve away all my content. (Yeah, right.)
Then, more recently, I pared back both the Hugo and Gatsby versions to a very small number of posts, hoping that would simplify things. Still, the posts that did remain were the actual content rather than more generic (and very short) posts, and thus the repos remained not truly “starter-ish.”
In addition to that, I had no reduced-size repo for helping folks interested in Eleventy, and that really griped my cookies because that’s the SSG in which I most want to spur newbies’ interest.
So, I spent the better part of this weekend fixing this problem, resulting in those three new starter repos (well, two new starter repos and a third repo repurposed as a starter repo).
Each of the three repos has only a small number of posts, each with pretty generic front matter and content, but with a few tips of how to include things like images and code blocks. I have “generic-ized” each repo so that it doesn’t come with my name, logo, and site URL all over the place; it also doesn’t have webmentions support so you won’t have to worry about all the code involved with that.2
Two for Hugo . . .
Repeating the earlier question: why do I have two Hugo starters?
You see, there are many folks who gravitate toward Hugo because, out of the box, it doesn’t require JavaScript and/or npm dependencies. On the other hand, some like to see Hugo with additional capabilities added with JavaScript and npm dependencies. That’s why I decided to give the two sides a choice. Both repos use Hugo’s built-in image processing to provide responsive images, but they differ on how they handle styling:
The hugo_twcss repo uses, as does this site, PostCSS and the highly popular Tailwind CSS — both of which do require JavaScript and dependencies.
The hugo_solo repo is JavaScript- and dependencies-free, and uses SCSS through Hugo Pipes.
. . . and none for Gatsby
And now, we get to the elephant in the room.
Where’s the Gatsby version of all this?
Well, um, there isn’t one.
I did try to create one but, as has been my usual experience with Gatsby (as recounted here), it didn’t go all that well. Let’s just say Gatsby in dev mode was its usually finicky and glitchy self.3 Fortunately, with many Gatsby starters out there already, the lack of one more isn’t going to hurt anybody.
(I will keep the current Gatsby repo up there for the curious, but plan few or no changes to it going forward. I’ve decided that the wisest thing I can do with that repo is to, quoting the perhaps unintentionally sad sign stenciled on the launch pad where the Apollo 1 astronauts were killed in 1967, ABANDON IN PLACE.)
Plenty of good choices out there
Gatsby isn’t the only SSG blessed with numerous starter sets out there for your learning pleasure. There are tons for the considerably more venerable Hugo, and a decent and growing number for the much younger Eleventy.
In any event, I hope that my new little efforts in this regard will help anyone who, as was true for me not all that long ago, is trying to find the path to a better website-management experience that I believe either Eleventy or Hugo will provide.
Update, 2020-12-19: Each starter set has its own online demo on Vercel (formerly on Netlify), linked from its repo.
Update, 2021-03-26: See also this update on what has turned out to be a growing number of starter sets for Eleventy and Hugo.
Update, 2021-02-20: Today, I moved it from its former location. ↩︎
For those who do want to add webmentions, you may want to check out my recent five-part series on doing just that, beginning with Part 1. If you’d already seen those posts when I first issued them, please note that — given the changes I’ve made since then to various repos to which I’d linked from those posts — I have now moved the linked files to their own repo for archival purposes, as is now explained at the start of each of the five posts in the series. ↩︎
As I’ve said before, I’m fully aware that there are uncounted Gatsby users out there, especially the React-savviest among them, who have zero trouble using Gatsby. And they can have it. ↩︎