Metalsmith VS handlebars.js

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/

If you have a bit of Nodejs SSR background, you would already be accustomed to templating libraries like Pug, Handlebars, EJS, etc. If you’re from a PHP background you would be familiar with the Blade templating engine. These templating libraries basically help you render dynamic data from the backend on the frontend. They also help you generate markup with loops based on conditions.

It’s time to create our code template. To do this, we use handlebars js, which allows us to create templates at a basic level. We create a folder called templates in the project home directory and add our template files inside.

Templating engine: SSGs rely on templating engines to define the structure of web pages. These engines enable developers to create reusable templates and incorporate dynamic content. Popular templating engines include Liquid, Handlebars, Mustache, EJS, ERB, HAML, and Slim.

Here's our first usage of the handlebars (docs) template. The .hbs extension will be removed once we run the action. Inside index.ts.hbs, add:

Id use handlerbars JS - https://handlebarsjs.com/

Node.js programming language will be used for simplicity. Handlebars template engine to separate data from the presentation. html2pdf.app to convert HTML to PDF, but as an alternative Puppeteer can be used also (you can find a complete tutorial How to convert HTML to PDF with puppeteer).

Handlebars.js site

But a valid question is: Why not use a template like Handlebars? For the use case inside Woovi, templates won't help us because we would need two core points: reuse our design system and ensure the usage of GraphQL in our payment link.

You might want to brush up on https://handlebarsjs.com/ if you want to make templates.

Once the package is set up, it will provide a MailService class that has a method named sendEmail that will receive some parameters and then send the mail. But first, we need to create the mail template and for that, we will use handlebars. It will allow us, to create HTML templates in which we can pass dynamics parameters, such as the user name or its information, and write inline CSS to style our email.