blog@tuan

日本語で書いてみる

Tue, 25 Aug 2026 09:00:00 +0900

このテーマはベトナム語と英語を想定して作られた。日本語は後から足した言語なので、うまく組めているかどうかは実際に日本語を流し込んでみないと分からない。このページはそのための一枚である。

本文に lang: ja を書くと、記事の <article> に lang="ja" が付く。その一行で書体・行間・禁則処理が日本語向けに切り替わる。サイト全体を多言語化しなくても、記事単位で切り替えられる。

What Markdown Renders

Mon, 24 Aug 2026 10:30:00 +0700

There is no argument on this page. It is a lookup table: what you type on top, what the theme renders underneath. Open it when you are mid-sentence and have forgotten a mark.

Welcome to blog@tuan

Thu, 20 Aug 2026 09:00:00 +0700

blog@tuan is a Hugo theme for people who write at length. It deliberately holds very little: one column of text, one cool grey palette, and nothing blinking for the reader’s attention.

This page is both a greeting and a test: nearly every element the theme knows how to render turns up somewhere below.

The Art of White Space

Sun, 12 Jul 2026 20:15:00 +0700

The hard part of a blog is not what you put on the page but what you agree to leave off. Every sidebar, every badge, every share button takes a little of the attention that belonged to the sentences.

Mathematics with LaTeX

Tue, 02 Jun 2026 14:30:00 +0700

Most Hugo themes render mathematics by shipping KaTeX or MathJax to the browser and having it re-scan the whole page. This theme does not: Hugo calls KaTeX directly during the build and writes HTML with MathML into the static file. The reader downloads exactly one extra stylesheet.

Syntax Highlighting at Build Time

Mon, 18 May 2026 11:00:00 +0700

Every code block on this site was coloured before the HTML ever left the build machine. The browser receives <span> elements that already carry their classes, and the palette is nothing but CSS variables — so switching between light and dark recolours the code immediately, with nothing to re-render.

Diagrams with Mermaid

Sun, 05 Apr 2026 16:45:00 +0700

This is the one thing in the theme that genuinely needs JavaScript, and it only loads on the pages that actually contain a diagram. The palette is read out of the same CSS variables everything else uses, so a diagram can never drift out of tone with the page around it.

A Short Note on Hugo Modules

Sun, 30 Nov 2025 08:20:00 +0700

Git submodules still work, but the version is pinned to a bare commit hash and anyone cloning the repository has to remember --recurse-submodules. Hugo Modules sit directly on top of Go modules, so they come with real versioning.