このサイトは当初は Quartz v3で構築 していました。 2023-08-20 にv4がリリースされていて構成が大きく変わっているので、アップデート時に行ったことを記録します。

Welcome to Quartz 4 favicon quartz.jzhao.xyz
Welcome to Quartz 4
Quartz is a fast, batteries-included static-site generator that transforms Markdown content into fully functional websites. Thousands of students, developers, and teachers are already using Quartz to publish personal notes, websites, and digital gardens to the web.
Welcome to Quartz 4

v3からの変更点

  • Hugo からPreactになった
    • Hugoのテンプレートに書き慣れていなかったので、JSXでフロントエンドのカスタマイズができるのは助かる
  • 開発中のhot reloadが効くようになった
    • v3ではファイルを変更しても反映されないことが結構あったから助かる
  • configurationplugin の機構が導入された
    • UIのカスタマイズがしやすくなった

手順

https://quartz.jzhao.xyz/migrating-from-Quartz-3

Quartzのリポジトリをcloneして、ビルドする

git fetch
git checkout v4
git pull upstream v4
npm i
npx quartz create

カスタマイズ

年ごとの記事一覧ページを作成 したり、リンクをカード形式で表示されるように したり、その他細かい表示の変更などをしています。 その他修正内容は Commits を見てください。

その他

Quartz v3で公開するときにWikilink形式でうまくリンクが貼られなかったので、Markdown linkに変換したがv4では改善されていました。 ObsidianのMarkdown linkをWikilinkに変換するCLI でWikilinkに戻しました。

おわりに

v4でpreactになって、カスタマイズがしやすくなりました。 公開手順等のドキュメントも充実しているので、v3と比べるとハードルが低くなったように感じます。 vaultを公開してみたいけどObsidisn Publishは高いと感じる場合は十分ありな選択だと思います。