quartz-research-note/content/Quartz.md

3.1 KiB
Raw Blame History

#obsidian #tools

Quartz

このノートを公開する仕組み

https://github.com/jackyzha0/quartz

ObsidianのものをなるべくそのままHugoで使えるようにしている

→v4から完全にJSベースの仕組みに変わった

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

いいところ

  • Wikilink[[link]]を変換してくれる
  • Github Pagesでホスト可能
  • 静的サイトなのになんかSSRされたSPAになってる(millionというのを使ってるらしい)のでページ読み込みめっちゃ早い。マウスオンでのプレビューとかもできる
  • 全文検索もできる

難点

-文中でハッシュタグが使えない(フロントマッターにタグを指定するしかない -→v4で可能になった。うれしい。

  • 記事未作成だったり、titleが設定されてないリンクはGraph View上で日本語がうまく表示されないファイル名だと日本語がエスケープされてんのかな
    • →パーセントエンコーディングをデコードするようにしたら治った。
      • プルリク立てた
      • これはv4でも治ってなかったので別途手元で修正している最中
    • フロントマッターにtitle要素を指定する必要はない。よってフロントマッター基本不要になった
  • 手元でサーバー立ててプレビューするのがちょっと辛いhugo-obsidianコマンドが手元で使える必要があるので、GoをインストールかDockerイメージを利用する感じになる) -v4で解決

v4以降の難点

  • SPAでの読み込みが若干怪しく、youtubeの埋め込みがある記事は一回リロードしないときちんと読まれない時がある
  • グラフのオプション指定がなぜかデフォルトパラメーターで上書きされるバグがあったので修正している。
  • GitHub Pagesのデプロイ用アクションはリポジトリから消えてたので別途作成。
  • 作成されてないWikilinkのリンクが有効なリンクとして表示されてる。グラフには反映されてないところ見るとレンダリング側でのミスなのかな
  • サイト外に飛ぶリンクにはObsidianみたく矢印マークつけてほしい。
  • Graphにタグが反映されない。これはインラインでタグ使うようにしてフロントマッターから消去したらできるのか
    • そんなこともないみたい
  • タグをインラインで先頭に書いておくスタイルだと、タグ一覧の下にまた手動で書いたタグ一覧が並んでちょっと座りが悪い
    • quartz.layout.tsの部分をこんな感じでコメントアウト
beforeBody: [Component.ArticleTitle(), Component.ContentMeta(),/*Component.TagList()*/],

このレイアウトの仕組みよくできてんなー