Skip to main content

建置完成後的步驟

✅ 建置完成後​

1. 啟動預覽伺服器​

方法 A：使用批次檔（推薦）

開啟文件管理系統-預覽模式.bat

方法 B：手動執行

npm run serve

預覽伺服器會啟動在 http://localhost:3000

2. 測試搜尋功能​

  1. 開啟網站：訪問 http://localhost:3000
  2. 使用搜尋：點擊 Navbar 右側的搜尋框
  3. 輸入關鍵字：測試搜尋功能是否正常
  4. 檢查結果：確認搜尋結果包含最新的文檔

3. 確認搜尋索引已建立​

檢查 build/search/ 資料夾：

  • 應該包含 search-index.json 或類似的索引檔案
  • 如果資料夾不存在或為空，表示索引建立失敗

4. 測試新文檔是否被索引​

如果新增了文檔（例如 PDF.md）：

  • 在搜尋框中輸入文檔中的關鍵字
  • 應該能在搜尋結果中看到新文檔

🔄 何時需要重新建置​

需要重新建置的情況：​

  1. 新增文檔：新增 .md 檔案
  2. 修改文檔內容：更新文檔的文字內容
  3. 刪除文檔：移除文檔檔案
  4. 修改配置：更改 docusaurus.config.js 或 sidebars.js

不需要重新建置的情況：​

  1. 修改 CSS：只改樣式（開發模式會自動重新載入）
  2. 修改圖片：只更換圖片檔案（需要重新載入頁面）

📝 工作流程建議​

日常編輯（快速預覽）​

npm start
  • 適合：編輯文檔內容、調整樣式
  • 優點：自動重新載入，速度快
  • 缺點：搜尋功能可能無法使用

測試搜尋功能​

npm run build
npm run serve

或使用：

開啟文件管理系統-預覽模式.bat
  • 適合：測試搜尋、檢查完整功能
  • 優點：搜尋功能可用，接近生產環境
  • 缺點：需要重新建置，較慢

🚀 部署前檢查​

在部署到 Netlify 或其他平台前，確認：

  1. ✅ 執行 npm run build 成功
  2. ✅ 執行 npm run serve 測試預覽
  3. ✅ 搜尋功能正常運作
  4. ✅ 所有文檔都能正常訪問
  5. ✅ 圖片和 PDF 檔案都能正常顯示
  6. ✅ 語言切換功能正常

💡 提示​

  • 開發時：使用 npm start 快速預覽
  • 測試搜尋：使用 npm run build && npm run serve
  • 部署前：確保建置成功且所有功能正常