独自の静的サイトジェネレーターを構築する

[3w36zj6]

現在のWebサイトは、typst-docsでドキュメントの構造を出力し、それを元に中国語コミュニティで作成された静的サイトジェネレーターを使用して構築しています。前者はApache License 2.0ですが、後者にはライセンスの問題があり、公式は有用であることは認めつつも、良くない状態であると主張しています¹。

そこで、将来的にはライセンスの問題がない独自の静的サイトジェネレーターを構築することが求められます。

Footnotes

1. https://github.com/typst/typst/pull/3425#issuecomment-1954341630 ↩

[3w36zj6]

現在はテンプレートエンジンとしてJinja2が使われていますが、JavaScriptのエコシステムを活用できるようにJSXベースのものを採用するのが良いと考えています。
また、メンテナーへの学習負荷を小さくするため、採用するフレームワークはできるだけ軽量のものが良いと考えています。以下に検討している候補を示します。

• Vocs
  • React + Vite
• VitePress
  • Vue + Vite
• Hono JSX

[3w36zj6]

UIの開発にはTailwind CSSとAlpine.jsの使用を検討しています。これらはJSXベースの静的サイトとの親和性、拡張性、学習コスト、Vibe Codingなどの面で優れた選択肢となると考えています。