From Publii to Eleventy: Building My Own Technology Blog

Creating Humble Tech Journey, exploring static site generation, learning GitHub and discovering the possibilities of Cloudflare Pages.

Introduction

I've always enjoyed experimenting with technology.

Whether it's Linux, Raspberry Pi projects, electronics, 3D printing, homelabs or simply taking something apart to understand how it works, there's always something new to learn.

For quite some time, I've wanted somewhere to document those experiences. Not another generic technology website, but somewhere to share practical projects, tutorials, discoveries and, just as importantly, the occasional mistake.

That idea eventually became Humble Tech Journey.

The philosophy behind the site is simple:

Build It. Break It. Understand It.

I wanted to create something that reflected that approach while also giving me an opportunity to learn some new technologies along the way.

Why build another technology blog?

There are plenty of technology websites, YouTube channels and blogs already available.

However, much of what interests me is the practical side of technology. Following a project from its initial idea through to completion, understanding the hardware and software involved, troubleshooting problems and documenting what I've learned.

I also wanted to avoid getting caught up in the usual pressures surrounding blogging, advertising and monetisation.

This project is primarily about learning, sharing knowledge and enjoying the process.

If somebody else finds a tutorial useful or avoids a problem because I've documented my experience, that's a bonus.

Starting with Publii

My initial website was built using Publii, a desktop-based content management system that appealed to me because it offered a straightforward way of creating and managing a website without having to run a traditional WordPress installation.

I liked the idea of managing content locally and generating a static website.

I also started developing a theme specifically for Humble Tech Journey, establishing the branding, typography, colours and overall appearance.

However, as the project developed, I became increasingly interested in understanding the technology behind the website itself and exploring alternative publishing workflows.

That led me to investigate Eleventy.

Discovering Eleventy

Eleventy, often written as 11ty, is a static site generator.

Rather than relying on a traditional database-driven website, it takes source files, templates and content and generates the HTML, CSS and other assets needed for a website.

This appealed to me for several reasons:

It also presented an opportunity to build a publishing workflow that I could understand and maintain myself.

Learning GitHub along the way

One of the things I hadn't spent much time working with previously was GitHub.

I knew what it was, but hadn't really explored how it could be used in a practical project.

For Humble Tech Journey, I created a private repository called humble-tech-journey.

I then installed GitHub Desktop, cloned the repository onto my Windows machine and added the initial Eleventy project files.

This introduced me to a few important concepts:

Repositories: A place to store and organise project files.

Commits: Recorded snapshots of changes made to a project.

Pushes: Sending committed changes from a local computer to the remote GitHub repository.

These might seem like relatively small steps, but they represent a useful introduction to version control.

GitHub is also something I can see myself using for other projects involving Linux, Raspberry Pi, ESP32 and programming.

Connecting everything with Cloudflare Pages

With the initial project files safely stored in GitHub, the next step was getting the website online.

I chose Cloudflare Pages because it offers a way to deploy static websites directly from a GitHub repository.

Connecting the two was surprisingly straightforward.

I created a Pages project, selected the GitHub repository and configured the Eleventy build settings.

The important settings were:

Setting Configuration
Framework Eleventy
Production branch main
Build command npx @11ty/eleventy
Output directory _site

Cloudflare then retrieved the source files, ran the Eleventy build and deployed the resulting website.

And then came the moment I'd been waiting for.

The first deployment was successful!

Humble Tech Journey was officially online.

What have I learned so far?

Although this is only the beginning, the process has already introduced me to several technologies and concepts.

I've had the opportunity to:

Perhaps more importantly, I've started to understand how these different technologies fit together.

Rather than simply following a tutorial and copying commands, I want to understand what each component does and why it's needed.

What's next?

Getting the website online is an important milestone, but there's plenty still to do.

My next priorities are:

  1. Develop the content and start publishing practical tutorials.
  2. Continue refining the website while preserving its existing design.
  3. Explore a browser-based content management system so that articles can be written and edited more conveniently.
  4. Develop a sensible backup and maintenance workflow.
  5. Start documenting some of my existing hardware and electronics projects.

There are plenty of possibilities, but there's no need to rush.

Final thoughts

This project has already been an enjoyable learning experience.

I've gone from an initial idea and a Publii website to a working Eleventy deployment connected to GitHub and Cloudflare Pages.

It's not a finished product, and I don't expect everything to work perfectly first time.

That's rather the point.

Technology is often best understood by experimenting, making mistakes, troubleshooting and trying again.

And that's exactly what I intend to document here.

Welcome to Humble Tech Journey.

Build It. Break It. Understand It.