iT邦幫忙

2026 iThome 鐵人賽

DAY 25
0
AI Engineering

個人知識庫、第二大腦,都用不好?我讓 AI 當維護者,自己只負責讀、想、問系列 第 25 篇

第二十五篇 - 把 Obsidian 知識庫變成公開站:Quartz + Netlify 部署實做

  • 分享至 

  • xImage
  •  

這一篇要講實做,這讓我回想了一下......我當初是怎麼做的呢?

我先到官網研究了一下官方對於 Quartz 的介紹,然後再整理我之前用 Netlify 架設部落格的筆記,最後才叫 AI 幫我切一個新的 git 分支出來,因為這最簡單......

才怪,通通叫 AI 做,你也叫 AI 做就好
.
.
.
真的,沒有坑、沒有隱藏內容或是隱形牆壁,你看到那邊有牆壁你就是叫 AI 把牆壁給炸了

這讓我很難動筆,我覺得就來做個簡單的畫面展示好了,讓大家看看成品,有興趣的讀者應該就會自己動手了,這篇文章提供參考。


Quartz 轉檔、Netlify 部署、GitHub 觸發

上一篇已經說了我們用的是 Quartz + Netlify + GitHub 的組合

用 Quartz 把整個 Obsidian 的內容變成靜態網頁專案

用 Netlify 把網頁專案部署到雲端

部署到雲端的方式會是透過 Netlify 提供的自動部署功能,只要推上 GitHub 就會直接觸發

配置的部份沒有很複雜,因為基本上整個 CICD 的流程都讓 Netlify 給包了。

那我簡單分享一下這怎麼做的,細節就不展開。


時間軸:從切分支到上線

切分支、搭骨架

  • 從 master 切出 public-site,加入 Quartz v5 骨架(obsidian template)=> 先用空白內容測試
  • 設定改成正式的:baseUrl 換成 ramblewiki.netlify.app、locale 改 zh-TW、pageTitle 改 RambleWiki

內容上線,踩雷

  1. 定案分享四個(writing、LLM Wiki、建設歷程、心理)
  2. 第一次修 bug:因為網站有無限重新整理的 bug,猜測是「大小寫敏感」,所以把資料夾名稱改小寫,沒解決問題。
  3. 因為 bootstrap-cli.mjs 這個檔案權限設錯,導致 Netlify 每次 build 都直接失敗,也導致 2. 修正的部份沒有成功部署,commit 後解決問題。
  4. 公開版 CLAUDE.md 上線
  5. 五支 skill 也公開了
  6. 補充說明 Telegram 同步腳本本體不公開
  7. claude.md 頁面大小寫 bug 復發(這次是 CLAUDE.md 檔名),改名 claude.md,問題解決

基本上在開發 Quartz、Netlify 註冊這些動作上都不會有太大問題,就像我開頭說的,有問題就讓 AI 把問題炸掉

我們只是要一個簡單的公開站,公開的內容也都是被偷了也無傷大雅的資訊

只要沒有資安的風險,手法粗糙點都是可以接受的。

唯一可能卡住的地方:Netlify 串 GitHub

有問題的可能會是 Netlify + GitHub 部署 這塊,比較不熟的讀者可能會不知從何下手,這邊截一些圖做範例:

1. 到 Netlify 建立新專案

進到 Netlify 後台,點右上角「Add new project」。

https://ithelp.ithome.com.tw/upload/images/20260925/20160279EK4d6rcn0f.png

2. 選擇用 Git repository 匯入

新專案畫面下面有幾個來源可以選,這裡選「Import a Git repository」底下的 GitHub。

https://ithelp.ithome.com.tw/upload/images/20260925/20160279aRAqwWNuUy.png

3. 選 repo

授權完 GitHub 之後,會列出你帳號底下的 repo。這裡看到 DragonsHoard 已經列在清單裡了(標著 Private)——但是如果你的 repo 沒有出現在這個清單,代表 Netlify 這個 GitHub App 還沒被授權讀取它,要點下面「Configure the Netlify app on GitHub」自己去設定。

https://ithelp.ithome.com.tw/upload/images/20260925/20160279Dx1eeAeMbJ.png

4. Private repo 要另外授權

點過去會到 GitHub 這邊 Netlify App 的設定頁。

https://ithelp.ithome.com.tw/upload/images/20260925/20160279UfPD1S3euH.png

往下捲會看到「Repository access」,選「Only select repositories」,把要部署的 repo(這裡是 DragonsHoard)加進去。這步是關鍵:
private repo 預設不會讓任何第三方服務看到,要在這裡明確授權 Netlify 能讀取這一個 repo,不是整個帳號都開放。

https://ithelp.ithome.com.tw/upload/images/20260925/20160279RhgCIi3qcN.png

5. 回到 Netlify,這時候就選得到了

授權完回到 Netlify,剛剛的 repo 清單就能正常選取,往下走完設定(選分支、填 build 指令)就會開始第一次部署。

https://ithelp.ithome.com.tw/upload/images/20260925/20160279mRKTwwGSrr.png

接下來只要 push 到指定分支,Netlify 就會自動重新部署。


成品:RambleWiki 怎麼逛

最後放上線的成品,教大家怎麼逛:

網址在這裡:RambleWiki

首頁列出來的就是目前篩選過、可以公開的部分:writing、LLM Wiki、DragonsHoard 建設歷程、心理,還有 Skills(AI 協作腳本)。

https://ithelp.ithome.com.tw/upload/images/20260925/20160279qYeqR5tL0h.png

左側欄的資料夾結構是刻意對照真實 repo 長相的(wiki/evergreen、wiki/projects 平行放)。

靠目錄,或者

可以用 wikilink 跟反向連結跳來跳去就好——文章裡提到的名詞點下去會跳到對應頁面,頁面最下面的「反向連結」會告訴你還有哪些地方提到這篇。

https://ithelp.ithome.com.tw/upload/images/20260925/20160279Ovu0STdyWK.png

有興趣的自己點點看。


上一篇
第二十四篇 - 偷偷停更的示範庫,和一個不會過時的公開站
系列文
個人知識庫、第二大腦,都用不好?我讓 AI 當維護者,自己只負責讀、想、問 共 25 篇
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言