gomazarashi.github.io

個人用ウェブサイトのリポジトリです。
Typst / Tola を使って静的サイトを生成し、GitHub Pages で公開する前提です。

公開中のサイト:

https://gomazarashi.com/

使用技術

• Typst
• Tola
• Nix (nix develop)
• just
• GitHub Pages

初回セットアップ

1. リポジトリをクローンする。
2. 開発シェルに入る。

nix develop

3. ツールが揃っているか確認する。

just doctor

よく使うコマンド

just build

• サイトをビルドする（出力: docs/）。

just serve

• ローカル開発サーバーを起動する。

just rebuild

• docs/ と .tola/ を削除してから再生成する。

ディレクトリ運用

• docs/ はビルド成果物の出力先。
• .tola/ は Tola の内部作業ディレクトリ。
• docs/ は Git 管理し、just build で更新してから commit / push する。
• GitHub Pages は Deploy from a branch を選び、公開元を main ブランチの /docs に設定する。
• public/ は旧ビルド出力先として不要だが、誤生成された場合に備えて引き続き Git 管理しない。
• .tola/ は Git 管理しない運用（.gitignore 設定済み）。

記事ファイル命名規則

content/posts/ 配下の記事は、以下の形式で作成する。

yyyymmdd-slug.typ

例: 20260412-first-post.typ