ar.falsy.cat/content/note/info-tech/publish-obsidian-by-quartz.md

title	tags
ObsidianとQuartzによるセカンドブレインデジタルガーデンの構築	note info-tech web

概要

• QuartzでObsidianのVaultを公開する
• 「セカンドブレインデジタルガーデン」という御大層な言葉はQuartzの紹介文からの引用

初期設定

1. Quartzをforkする
2. GitHub Actionsを有効化
3. repoの設定でworkflow permissionをread and write permissionsへ変更
   • これしないとdeployに失敗する
4. repoをローカルにclone
5. data/config.yamlをいい感じに編集
   • authorなど
6. config.tomlをいい感じに編集
   • baseURLなど
7. pushする
8. deployが終わったらGitHub Pagesのドメイン設定をする

記事の執筆

1. ローカルrepoのcontent/ディレクトリをVaultとしてObisidianで開く
   • content/templates/は弄ってはいけない
2. 記事を書く
3. pushする

ローカルプレビュー

• まだqemu上のマシンへのOSインストール作業ができていないので，また今度試す
• なるべくホストマシンは汚したくない(切実)

カスタマイズ

Recent Notesの表示数を変更する

1. layouts/partials/recent.htmlのfirst 3 $notesを変更する

トップページにグローバルグラフを表示する

1. data/graphConfig.yamlのenableGlobalGraphをtrueにする

記事にRelated Notesを表示する

1. layouts/partials/recent.htmlを作成
2. layouts/_default/single.htmlの好きな位置に{{partial "related.html" .}}を挿入
3. i18n/en.tomlにrelated_notesの翻訳を追加

layouts/partials/recent.html

<div class="content-list">
  <h2>{{ i18n "related_notes" }}</h2>
  {{$notes := .Site.RegularPages.Related .}}
  {{partial "page-list.html" (first 3 $notes)}}
</div>

所感

• 扱いやすいObsidianで執筆して，Quartzでいい感じに公開ができた
• 執筆のためにリポジトリをcloneしなければならないため，記事数が増えた時の複数PCの同期コストが問題になりそう
  • ブランチ分けてPullRequest活用すれば解決する？
    • 記事書くたびにPR作るのはクソめんどくさそう