このサイトは当初は Quartz v3で構築 していました。 2023-08-20 にv4がリリースされていて構成が大きく変わっているので、アップデート時に行ったことを記録します。
v3からの変更点
- Hugo からPreactになった
- Hugoのテンプレートに書き慣れていなかったので、JSXでフロントエンドのカスタマイズができるのは助かる
- 開発中のhot reloadが効くようになった
- v3ではファイルを変更しても反映されないことが結構あったから助かる
configuration
とplugin
の機構が導入された- UIのカスタマイズがしやすくなった
手順
https://quartz.jzhao.xyz/migrating-from-Quartz-3
Quartzのリポジトリをcloneして、ビルドする
カスタマイズ
年ごとの記事一覧ページを作成 したり、リンクをカード形式で表示されるように したり、その他細かい表示の変更などをしています。 その他修正内容は Commits を見てください。
その他
Quartz v3で公開するときにWikilink形式でうまくリンクが貼られなかったので、Markdown linkに変換したがv4では改善されていました。 ObsidianのMarkdown linkをWikilinkに変換するCLI でWikilinkに戻しました。
おわりに
v4でpreactになって、カスタマイズがしやすくなりました。 公開手順等のドキュメントも充実しているので、v3と比べるとハードルが低くなったように感じます。 vaultを公開してみたいけどObsidisn Publishは高いと感じる場合は十分ありな選択だと思います。