As you can see, this blog hasn't had a post since forever.

And I'm gonna explain why.

First of all, I'm only covering the technical aspect here; the personal reasons for the absence of written content have their own post on my gemini capsule.


Ever since the beginning of this blog, I've written all the html and CSS by hand. This has had its advantages:

okay, I guess it's time for a list of all the SSGs I tried:

  1. Jekyll;
  2. 11ty;
  3. Hugo;
  4. Franklin.jl (yes, i tried Julia too, that will get its own rant blogpost later); and last but not least
  5. Gatsby

The problem with these wasn't the fact that they don't work at all; I mean, people use these tools daily and make some really beautiful themes for them.

I don't want to use their themes. I want the website to stay the same, visually.

That means I need to be able to figure out how to port over my website to one of these SSGs, since I'm not spending the time to rebuild my website from scratch just to have it fit one of them. That might sound lazy, and it is; however, you'll soon understand why.

So, how did they fare?

in short? not well.

longer explanation? Well, here's a breakdown:

  1. Jekyll: Since Github Pages, on which the website is currently hosted, is built in Jekyll, it should be the best option; however, I wasn't able to understand how to import a custom css file for Jekyll. As far as I can see, the only way to get custom styling in jekyll is to make my own theme, host it on Github, and reference it in the _config.yml like this:

    remote_theme: "not-a-web-developer/my-jekyll-theme"
    

    making an entire jekyll theme by myself is too much for me to be able to do, so that's one option down.

  2. 11ty: same problem as Jekyll, the website was really complicated for me to navigate through, and I couldn't figure out how to get CSS working, or even what to write in; long story short, it was choice paralysis and the explanations for all the options went over my head, which didn't help.

  3. Hugo: Hugo also apparently requires you to choose a theme, and making a theme requires knowing Go; which unfortunately makes it a no-go for me, since i'm not quite interested (nor have the mental capacity) in learning Go at the moment.
    <tangent>
    I understand that I can abuse the static files directory (this) to store my css, but this is just a workaround and i do not expect it to work at all.
    </tangent>

  4. Franklin.jl: Franklin is fairly simple, but i have a few issues with Julia as a language that came in the way.

  5. Gatsby: oh god. Gatsby is so complicated, I can't even in good faith call it an SSG anymore.

Enter teeny.

I found this simple wrapper around marked.js while randomly browsing Github: teeny-cli

The way it works is by taking in markdown files as content, runs it through marked.js, and does some extra magic to make sure links to static files work properly.

if that sounds simple, it is. However, that's exactly what i need for this website to be a lot easier to write for, while having easy control on the css and any optional javascript I add. (speaking of which, if you block javascript, that's perfectly fine; I only use it for syntax highlighting at the moment)

So in conclusion:

The website is now easier for me to work on without being any heavier to run on either the client or on my laptop (oh yeah i got a laptop, review coming soon™).


PS: I started writing this post in July, but life happened and now it's October ༎ຶ⁠‿⁠༎ຶ

After university starts (yes, that also requires its own post) I'll hopefully have more time for writing blog posts.

until then, adios.



Go back to home