pages-gem VS Jekyll

The documentation is built with MkDocs and hosted on GitHub Pages. You can browse the complete documentation at carpet.jerolba.com.

Upload your folder to Netlify, GitHub Pages, or Vercel — and boom, your portfolio is online!

Here is the link to my portfolio, generated by lovable.dev and hosted on GitHub Pages

GitHub Pages: Host your site directly from a GitHub repository.

GitHub Pages - platform provided by GitHub, the leading company that provides source code hosting. The service is well-known among many software developers.

It was long my desire to write a blog with stuff that interests me. Lately i was studying Golang and i came across Hugo which is a really nice and fast site generation utility. This was a great opportunity to start my own blog by using Hugo and Github Pages in order to host it. Why?

GitHub Pages - (https://pages.github.com/) – if you already have a git account, kindly ignore this.

If you do not need a domain you can also publish a static page as your blog on Github: https://pages.github.com

If you don't want to use Jekyll as your static site generator for GitHub Pages and you want to have a custom domain for your GitHub Pages. This post is for you!

At the end of my last post, we had a structure in place that used GitHub Actions to run a workflow every time a change was committed to the PPC repository. That workflow would rebuild the website and publish it on GitHub Pages.

Jekyll

If you don't want to use Jekyll as your static site generator for GitHub Pages and you want to have a custom domain for your GitHub Pages. This post is for you!

Jekyll is a static site generator that transforms Markdown files into a fully functional website. Everything is generated into plain HTML, which makes it simple to deploy on platforms like GitHub Pages.

Obviously, there are a dozen choices for generating static websites (efficiently and quickly), from the classic Jekyll to the new Next.js. And you are good to go with any of them as long as your confident with it. I choose 11ty because:

That would be an improvement, but it still wouldn't be equivalent to what you can do with Ruby and Jekyll. For example I do [1] so I don't need to put dates in my post names, which also fixes a bug [2] I encountered but was never fixed.

[1]: https://stackoverflow.com/a/68287682/660921

[2]: https://github.com/jekyll/jekyll/issues/8707

In your repository settings you need to turn on GitHub Pages to make it pull Jekyll content (that's the magic✨ default GitHub Pages build tool) from your GitHub repository.

If you're looking to start a blog (or if you're thinking of redesigning yours although you haven't posted in 2 years), you'll stumble upon a lot of options and it can be incredibly daunting; and if you stumble with the newest Josh's post about his stack it is easy to feel overwhelmed with the shown stack.

Here I am, signing off from a self-hosted WordPress site and finding a welcome change in Jekyll, a blog-aware static site generator. There is nothing new about this, several well-known bloggers have already migrated to Jekyll in the last few years. Ever since Tom Preston Werner created this software in 2008 and published his infamous article about Blogging Like a Hacker, it has become the go-to thing for at least the small and indie bloggers.