eleventy 🕚⚡️ VS Metalsmith

This post outlines the steps for migrating an existing BlogCFC blog to a JamStack, with a focus on using Eleventy.

I suggest you to try out eleventhy (https://www.11ty.dev/)

Quite simple to start, and a nice system to add some scripting and styles without the requirement of bringing in a framework.

A production flag enables you to run activities in dev or production such as minifying assets, showing draft posts, etc. There isn't a built-in flag or function that comes with eleventy (11ty) specifically for this. However we have this info at our fingertips.

I can't recommend Eleventy enough!

https://www.11ty.dev

I converted my WordPress blog to Eleventy 4 years ago and never looked back, it's been delightful!

https://www.joshcanhelp.com/taking-wordpress-to-eleventy/

It’s 2024, and you are about to start a new project. Do you reach for React, a framework you know and love or do you look at one of the other hot new frameworks like Astro, Enhance, 11ty, SvelteKit or gasp, plain vanilla Web Components?

The "dev" script is running the eleventy server in dev mode. The details of the script are not important for this discussion, but to round out the background here is an abbreviated version of my package.json:

Eleventy is a fast and powerful SSG that really shines when it comes to pure static site generation because it does not require the loading of a client-side JavaScript bundle in order to serve content.

The irony is using a JavaScript-based static site generator to make the site: https://www.11ty.dev

https://doublejosh.com/post/186193119278/metalsmithjs-is-sti...

Then two years ago I needed a more robust SSR system based on React, so I went with GatsbyJS. It's insanely mature and intuitive, but as we all know that community and business is now drying up too. But the framework is still great.

Now everyone sings the praises of NextJS, which can be used for SSR but is intended for applications and active server endpoints. But more complexity doesn't mean better.

I'm keen to try other simple frameworks when the result is a static site. I may give https://www.11ty.dev a shot.

11ty is a lightweight static site generator. I chopped up my HTML and used the 11ty starter template called eleventy-base-blog as the structural foundation for the site.

Metalsmith — the best customizable SSG

I use Metalsmith. Been happy with it. I build my site into a self-contained nginx docker image.

const Metalsmith = require('metalsmith') const markdown = require('@metalsmith/markdown') const layouts = require('metalsmith-layouts') const permalinks = require('@metalsmith/permalinks') const collections = require('metalsmith-collections') Metalsmith(__dirname) .metadata({ sitename: 'Website Name', description: "Website description.", generator: 'Metalsmith', url: 'https://metalsmith.io/' }) .source('./src') .destination('./build') // .clean(true) .use( collections({ projects: 'pages/*.md', reverse: true, refer: true }) ) .use(markdown()) .use(permalinks()) .use( layouts({ engineOptions: { helpers: { formattedDate: function (date) { return new Date(date).toLocaleDateString() } } } }) ) .build(function (err, files) { if (err) throw err })

I also started to move to hugo, but they didn't merge the pr [2] which would have helped in the transition. :(

The look is still similar to what it was in the beginning, in terms of colors at least.

[1] https://github.com/metalsmith/metalsmith

Metalsmith

A static site generator I've been enjoying lately (and using for my blog) is Metalsmith: https://metalsmith.io/

It feel like it's the best of both worlds, because it's simple to learn and customize, but there are plugins for the things you don't want to spend time writing yourself.

For example, I'm using plugins to: check for broken links, generate an RSS feed, and run a test server with automatic reloading.

But then I was able to easily add in my own code to handle relative links, generate Graphviz diagrams, and format dates.

One other recommendation: I hated almost every template language I ran across (Hugo's, Liquid, Nunjucks, EJS), but I'm thrilled with the simplicity of Handlebars (https://handlebarsjs.com/), although it is a bit limiting and the "block helper with parameters" syntax is strange (perhaps an indicator that I'm trying to do too much in the templating language!).

I believe Metalsmith [1] is trying that approach

[1] https://metalsmith.io/