Skip to main content

準備動作

安裝 Node.js 和 npm​

# 安裝 nvm (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# 安裝 Node.js 20
nvm install 20
nvm use 20

# 確認版本
node -v
npm -v

建立 Docusaurus 專案​

# 創建新專案
npx create-docusaurus@latest storyinspirit-blog classic

# 進入專案資料夾
cd storyinspirit-blog

# 啟動開發伺服器
npm start

個人化部落格​

可以參考其他的 Docusaurus Blog，並且請教 Claude AI 架設部落格。

部署 Docusaurus Blog 到 GitHub

初始化 Git 並首次提交​

# 初始化 Git 倉庫
git init

# 設定使用者資訊
git config user.name "StoryinSpirit"
git config user.email "StoryinSpirit@users.noreply.github.com"

# 設定主分支名稱
git branch -M main

# 加入所有檔案
git add .

# 首次提交
git commit -m "Initial commit"

# 連結到 GitHub 遠端倉庫
git remote add origin https://github.com/StoryinSpirit/storyinspirit-blog.git

# 推送到 GitHub
git push -u origin main

建置與部署​

# 清除快取
npm run clear

# 建置生產版本
npm run build

# 測試生產版本
npm run serve

常見問題修正

如果遇到 Git email 隱私錯誤：

git config user.email "StoryinSpirit@users.noreply.github.com"
git commit --amend --reset-author --no-edit
git push -u origin main

如果遇到 broken links 錯誤：

  • 檢查 docs/home.md 中的連結是否正確
  • 確保所有連結的檔案都存在
  • 或在 docusaurus.config.js 設定 onBrokenLinks: 'warn'

安裝搜尋功能（可選）：

npm install --save @easyops-cn/docusaurus-search-local

然後在 docusaurus.config.js 加入搜尋插件配置。

日常更新流程

# 修改檔案後
git add .
git commit -m "更新內容描述"
git push

# 建置新版本
npm run build