Eleventy Theme Updated

Series: 11ty Theme

tl;dr: I've completed some major theme updates for this site. This post is an introduction, with more details in later posts.

Series Description: However many years later, I have actually done something resembling completing the design of this site using eleventy aka 11ty! I'm sure there are still more things I'll decide to change later, but the general idea I'm pretty happy with. This series describes some of the main challenges I faced. You can navigate other posts in the series using the list of links in the sidebar.

I also redid the ryanrobinson.ca landing page with some similar design, but I'm not going to talk about that any more here - that's plain HTML and CSS and the only hard decisions was in what content I should put there.

The Code Structure

For this post, I'm just going to note how the code is structured.

The code is split into two:

  1. The theme that is shared between the two sites, housed at the 11ty-theme project in my GitHub.
  2. The individual site's project, which sets a lot of site configuration as well as contains all the post content.

The theme is not fully abstracted. There are some things in there which are uniquely intended for me, like all the social media links in the footer, but they are the same for the two sites so it didn't seem worth the effort to make the theme more abstract and then have to define all the links on each site separately. I could still do that if I learned that somebody else really wanted to use that theme, but that isn't likely so I can keep it more efficient and easier to maintain this way.

In the rest of this series, I'll look at some of the more confusing parts: pages listing posts by tag and by year, nested pagination, sidebar flexibility, tag and series descriptions, search, and maybe some more if I think of it later.