Eleventy as a static site framework.

I've dabbled with a million 'static site generators' and frankly got bored before ever putting something online with one. This might be the first to break that habit.

Set up was easy #

I didn't have to set things up for ages and deal with weird JS errors. That's genuienly a first.

I set it up to bring accross a thing about Space #

And it was super easy to bring accross an html page and convert it to partial markdown. You can see it here:

Space content

The nitty gritty #

This is an https://www.11ty.dev/ static site. Eleventy is a static site generator. To quote them:

Eleventy was created to be a JavaScript alternative to Jekyll. It’s zero-config by default but has flexible configuration options. Eleventy works with your project’s existing directory structure.

Eleventy uses independent template engines. We don’t want to hold your content hostage. If you decide to use something else later, having your content decoupled in this way will make migration easier.

I run it locally, then deploy when I choose. It's hosted on GitHub, and then deployed automagically to an AWS S3 Bucket. The deploy is done with AWS CodeDeploy (does what it says on the tin), which handles the connection and auth to GitHub.

I had some issues with the folder structure, as the site is built into a _site folder, but I want to commit the entire repo to GitHub. The hacky solve was to have ANOTHER GitHub repo for the _site folder as well as the root dir. I'm 100% sure there is a niftier way to do that. I couldn't see where AWS would let me deploy just the _site dir though.

← Home