Naming Things is Hard

a blog about nerd stuff

Recent Blog Posts

Static site content management systems

March 20, 2024

I've got two blogs hosted on Netlify using 11ty-based blogging systems—this one, which I generally brewed up myself using 11ty, and then my book blog site, which I recently revamped using 11ty-base-blog.

I don't update either enough, which is fine, I'm busy, but when I do, it sure is nice to have an interface to my content that doesn't require me to load up my code editor and directly interact with my files. To that end I use two separate versions of something that, once upon a time, was called Netlify CMS; for this site I use Static CMS, which forked off Netlify CMS a while back when it looked like Netlify CMS was dying on the vine, and for the book blog site, which I set back up sometime last year, I use Decap CMS, which is what Netlify CMS officially “became" when Netlify decided to officially not do it anymore.

What's worth noting off the top is that neither of these “CMS” options involve a database: they're both essentially interfaces that allow web-based editing of markdown files hosted in the site's git repo which in turn is published and hosted through Netlify (or, presumably, possibly, some parallel or similar system). I'm not sure how well this actually would work for teams collaborating on a site, or if it meets the needs of non-technical users who have a technical person handling site set-up but don't themselves require or possess technical know-how; I do not it makes it much easier for me to let the “content” and “nerdy code detail” sides of my brain drift from each other in time and space.

Set-up for both systems is fairly similar—there's an admin folder that needs to be published as part of the site deploy along with a settings or configuration file to gives the interface knowledge about the structure of the site-specific content files; all this feeds into a JavaScript-based interface. Authentication, at least for me, is through Netlify Identity. Honestly I'm pretty much at “just follow the tutorials and docs” levels of understanding here and I got them doing basically what I bare-minimum need them to do; it's not too hard, for sufficiently flexible views of what “too hard” might mean for you.

That said recently I realized that neither interface has let me know just how out of date my current versions were; for either site I was running 2 to 3 major versions behind. Luckily updating mostly meant pointing the scripts at the new versions and doing some minor under-the-hood cleanup, relatively minor because I'm not doing anything too crazy with either site. Fairly painless upgrades, in the end.

And, wow, what a difference it makes, particulalry on the Static CMS side. The thing I'd liked more about Decap CMS was that it offered an editorial workflow system—the ability to naturally save content in draft form before hitting publish. (I had a “draft” flag on posts already so I could do this, but it's nice to have that baked into the system.) When I ran the upgrades I was fairly convinced I was going to wind up moving both sites to the same system, but now I've got this site running the newest (I think, unless there's already a new version I'm not aware of) Static CMS version, and now it too has an editorial workflow system in place. Plus the overall interface has gone through a huge upgrade; there's a dark mode and just a general polish that, last I checked, Decap CMS doesn't quite have yet. It's real impressive, and if I had to recommend one or the other, I would probably go with Static CMS.

At least, that's what I'd go with today. Decap CMS does seem to better integrate with Netlify's deploy preview system, so draft posts actually get fullly-previewable links on live “copies” of the site, which is really nice; maybe that's avaialble in Static CMS yet and I haven't figured it out yet. And of course at least from a total outsider view it seems like maybe these systems running in parallel are sort of nudging each other along, and I'll be curious to see what comes next from either side. At least for now I'll take advantage of the fact that I've got too many blogs (and not enough time for any of them) as a chance to keep an eye on both sides of the fence to see what happens.

Web CompOH!nents

January 25, 2024

I've been thinking about web components and I haven't been understanding web components and then today I listened to The Vanilla JS Podcast's “The elevator pitch for web components” episode and then I got several links deep into the related blog post and now I'm staring at a mildly custom little thing I need to insert into a specific point in one page in a CMS and I'm like, oh, wait, wait, maybe I don't have to sit here manually editing and reloading this page in the CMS over and over again to get this to work. Maybe I can web componentize this, work on the JS interactivity part separately, and just reload the related page until its working the way I expect. Or am I thinking about this the wrong way, still? Do I have time to figure it out? Let's find out!

Bug Watching Considered Benficial?

September 22, 2023

Did you know you can kind of watch browsers be developed? It's true! Like once upon a time I subscribed to this "bug" against Firefox in Mozilla's Bugzilla site and ever since then I've been getting notification bits in my inbox about this dependency or that blocked issue as they've trickled out and it's just enough to remind me that this new feature I'm really interested in is definitely being worked on and is certainly coming, someday, probably. It's kind of cool.

You can also of course file bugs against browsers. Which is how I know that this incredibly weird and obscure bug I filed against Safari…does not appear to be definitely being worked on. But hey! Maybe someday!

Experimental Dark Mode

May 26, 2023

Hi. I've added a dark mode toggle. It's wildly underthought and highly experimental. Which is pretty much the entire M.O. of this site, anyway, so, you know. Anyway, you can click that button down below and maybe it'll work and not be too horrible?

Clean-up, clean-up, everybody does their share

May 26, 2023

I'm working on some clean-up here, fixing some things and rearranging some furniture that's been bothering me for a while. To that end I suspect lots of links are going to break and the RSS feed is going to probably vomit all over the place for a bit. I apologize in advance. Should be a one-time thing. (I hope.)

Additional Content

Today I Learned...

Home & About & & Feed (Atom)