Quartz Wiki 構築・運用マニュアル

作成日: 2026-02-22
作成者: Antigravity
ステータス: 稼働中

概要

ObsidianのVaultをQuartzで静的サイト化し、GitHubを経由してCloudflare Pagesへ自動デプロイする仕組みを構築した。 Obsidianでメモを保存するだけで、10秒後に自動でWebに公開される。

システム構成

Obsidianで保存
    ↓（10秒デバウンス）
quartz_auto_deploy.py が検知
    ↓ git add / commit / push
GitHub Private Repo（Umebiz5726/quartz-wiki）
    ↓ 自動トリガー
Cloudflare Pages ビルド（npx quartz build）
    ↓
https://quartz-wiki.pages.dev に公開

役割	パス
Quartzプロジェクト	`C:\ai_work\quartz-site\`
コンテンツ（Vault）	`C:\ai_work\quartz-site\content\`
自動デプロイスクリプト	`C:\ai_work\quartz_auto_deploy.py`
Watchdog（常駐管理）	`C:\ai_work\watchdog.ps1`
デプロイログ	`C:\ai_work\logs\quartz_auto_deploy.log`
GitHubリポジトリ	https://github.com/Umebiz5726/quartz-wiki
公開URL	https://quartz-wiki.pages.dev

セキュリティ除外設定

以下のフォルダはGit・ビルドどちらからも除外されており、Webに公開されない。

フォルダ	除外設定箇所
`content/00_System/`	`.gitignore` + `quartz.config.ts`
`content/01_Core/`	`.gitignore` + `quartz.config.ts`
`content/.obsidian/`	`.gitignore` + `quartz.config.ts`
`content/_*/`	`.gitignore` + `quartz.config.ts`

初期構築手順（再現用）

1. Quartzセットアップ

git clone https://github.com/jackyzha0/quartz.git C:\ai_work\quartz-site
cd C:\ai_work\quartz-site
npm install
npx quartz create
# → Empty Quartz / Treat links as shortest path を選択

2. Vaultの統合

robocopy "C:\ai_work\obsidian-Local\obsidian valut" "C:\ai_work\quartz-site\content" /E /XD ".obsidian"

3. セキュリティ設定（.gitignore追記）

content/00_System/
content/01_Core/
content/.obsidian/
content/_*/

4. quartz.config.ts の ignorePatterns 設定

ignorePatterns: ["private", "templates", ".obsidian", "00_System", "00_system", "01_Core", "01_core", "_*"],

5. GitHub連携

cd C:\ai_work\quartz-site
git init
git add .
git commit -m "Initial commit: Quartz v4.5.2"
git remote add origin https://github.com/Umebiz5726/quartz-wiki.git
git push -u origin main

6. Cloudflare Pages設定

項目	値
Framework preset	None
Build command	`npx quartz build`
Build output directory	`public`
Branch	`main`

7. 自動デプロイ常駐化

watchdog.ps1 が quartz_auto_deploy.py を自動起動・クラッシュ時再起動する。

日常運用

Obsidianの使い方（変更なし）

Vaultを C:\ai_work\quartz-site\content に切り替え
通常通りメモを書いて保存
10秒後に自動でWebに反映される

手動でPushしたい場合

cd C:\ai_work\quartz-site
git add .
git commit -m "手動更新"
git push

ローカルプレビュー

cd C:\ai_work\quartz-site
npx quartz build --serve
# → http://localhost:8080 でプレビュー可能

トラブルシューティング

症状	対処
Webに反映されない	`C:\ai_work\logs\quartz_auto_deploy.log` を確認
watchdogが止まっている	`watchdog.ps1` を再起動
ビルドエラー	`npx quartz build` をローカル実行してエラー確認
GitHubへのPush失敗	`.env` の `GITHUB_TOKEN` が期限切れでないか確認（90日有効）
機密ファイルが公開された疑い	`quartz.config.ts` の `ignorePatterns` を確認

社内ポータル

エクスプローラー

QuartzWiki構築運用手順