After leaving temama.soy neglected for so long, I finally decided to rewrite it into something that I can show people.
Mainly, I want to loosely document:
- My background (About)
- Descriptions and updates of the OSS I’ve built (Tools)
- Random thoughts and notes (Blogs)
Structure
I came across Hugo by chance and decided to give it a try.
Since my update frequency isn’t going to be high, I remembered coming across Hugo when I was searching for a static site generator (apparently they call it SSG) CMS.
Choosing a Theme
I browsed through the Blog tag on Hugo Themes, and these four caught my eye:
- adityatelange/hugo-PaperMod (demo)
- Simple, minimal movement
- The way it assumes the top page text is specified in the config didn’t quite fit what I had in mind
- humrochagf/colordrop (demo)
- You can set a theme color that spreads across the whole site, leaving a strong impression
- Since I’ve already decided my theme color will be Nakakobai-iro (a deep pink), it seemed like a good fit
- Fastbyte01/KeepIt (demo)
- Suitable for simple blogs
- g1eny0ung/hugo-theme-dream (demo)
- It looks nice when images are lined up in the post list
- But the motion when clicking the icon to switch to the portfolio page didn’t quite sit right with me
After trying out a few, I settled on PaperMod. The reasons are:
- After writing and placing a few posts, it turned out just the way I imagined
- Hugo themes can be a bit tricky depending on the theme, especially when it comes to how lists are displayed, so I couldn’t just pick one based on design alone
- Since my focus is more on blogging than building a portfolio, I liked how it could show a list of blog posts on the home page
- I ran into an issue where only Blogs or Tools were showing up in the list, but after a closer look, I found a small note in the documentation that explained the issue:
- If you don’t specify
params.mainSections
, Hugo defaults tosites.mainSection
, which limits what gets displayed.
Deployment
I set up Nginx on GCE and just dropped the hugo
-generated files directly.
Soon, I’ll make it so I can deploy with GitHub Actions (feeling motivated).
Bilingual Support
I’m feeding the articles I write in Japanese into ChatGPT to get an English version and will put it up as well.
I’ll review and fix any parts where the nuance seems off, at least.
By placing both article-name.ja.md
and article-name.en.md
, PaperMod conveniently provides links between the two versions.
Hugo is great! Someday I’d like to write my own theme too.
I want to incorporate Nakakobai-iro somewhere.