Quartz

かなり良いmd → htmlの変換ツール

• もともとObsidian用に作られていたらしく、特に設定することなくObsidian向けのパースができた
• 今使ってる全部の機能に対応しているかはまだ未確認
  • ノートの埋め込みOK
  • リンクが.htmlをつけない形式なので、なんか動かない。サーバーで動かしたらいい感じに動くのかな？
• 差分更新の機能はないらしく、現在の778ファイルを更新するたびに10秒近くかかる
  • ちょっと遅い(700ファイルで10秒)上に差分更新もないけれど、手元で動かさないなら十分な気がする

ローカルではリンクがうまく動かない

• 内部リンクの際のパスに.htmlが挿入されず、ローカルで試すとうまく参照できない
  • ソースコードを改修すれば行けるんじゃないかと思ってすべてのaタグの箇所に,htmlを付け足してみたけれど、それでもだめだった
  • コードを追ってみるとhast-util-to-jsx-runtimeというライブラリを使っているらしく、それ以上はよくわからなかった
• サーバーで動かすと行けるのか？試してみるか
  • GitHub Pagesで動かすとうまくいった。リンクも正常に動いてる

GitHub Actions用のスクリプトについて

• Build Quartz for GitHub Pages · Actions · GitHub Marketplace · GitHub
  • GitHub Pages用のスクリプトもあった。うまく動いたし最初から探してればよかった
• Hosting
  • GitHub Pages用のスクリプト、公式のがあるじゃん！！！！
    • 最初からこっち使ってればよかった。こっちならバグもないだろうし
  • ⇒ なんかエラーが出て動かなかった。なぜ

不満点について

• GitHub Actionsで実行するとファイルの作成日時が上手く反映されない
  • フロントマターとgitとファイルのメタデータの3段構成だけど、少なくともgitとファイルのメータデータが動いてない
  • こっちはまだ何とかなりそうだし、解決してコントリビュートしていきたいね
  • QuartzでGitから作成日時を調べる機能が上手く動作しないで調査した
• 差分ビルドに対応していなくてビルド時間が長い
  • ローカルで動かさないので問題はないと言う考えもある