このサイトはどうやってビルドされるのか
このサイトにはフレームワークがありません。代わりに、Viteプラグインが一つ、ビルド時にすべてのページを生成します。
流れ
content/以下のMarkdownを読み込み、front-matter(タイトル、日付、要約)を分離します。- 本文をHTMLに変換します。
- 言語ごとにテンプレート関数へ渡して、
/ko/…、/ja/…、/en/…のページを作ります。 - 翻訳がない記事は別の言語版で代用し、案内の文を付けます。
テンプレートは「データ → HTML文字列」の純粋な関数です。そのため、開発サーバーではリクエストのたびに実行し、ビルドでは同じ関数を一度だけ実行してファイルに書き出します。
なぜこうしたのか
記事が少ないサイトにフレームワークは大げさだと思いました。それに、自分で作れば静的サイトジェネレーターが実際に何をしているのかを目で確かめられます。