backup

BUSUANZI_RSS_SETUP.md

@@ -0,0 +1,159 @@
+# RSS 優化與 Busuanzi 統計配置完成報告
+
+## ✅ 已完成的配置
+
+### 1. RSS 優化
+- ✅ 創建自定義 RSS 模板：`layouts/_default/rss.xml`
+- ✅ 添加完整內容支持（`content:encoded`）
+- ✅ 添加作者信息（從 `params.authors`）
+- ✅ 添加封面圖片支持（`media:content`）
+- ✅ 添加標籤分類（`category`）
+- ✅ 支持多語言 RSS
+
+### 2. Busuanzi 不蒜子統計系統
+已創建以下組件：
+
+#### 腳本加載
+- ✅ `layouts/partials/extend-head.html` - 自動載入 busuanzi 腳本
+
+#### 統計組件
+- ✅ `layouts/partials/meta/views.html` - 文章頁面瀏覽量
+- ✅ `layouts/partials/footer-stats.html` - 網站總統計（footer）
+- ✅ `layouts/partials/footer.html` - 覆寫主題 footer 整合統計
+
+#### 多語言支持
+- ✅ `i18n/zh-tw.yaml` - 繁體中文翻譯
+- ✅ `i18n/zh-cn.yaml` - 簡體中文翻譯
+- ✅ `i18n/en.yaml` - 英文翻譯
+
+### 3. 配置文件更新
+- ✅ `config/_default/params.toml`
+  - `[article] showViews = true` - 啟用文章瀏覽量
+  - `[footer] showStats = true` - 啟用網站總統計
+
+## 📊 統計功能展示位置
+
+### 文章頁面
+- 位置：文章標題下方的 meta 信息區
+- 顯示：👁️ [數字] 次瀏覽
+- 條件：`showViews = true`
+
+### 網站 Footer
+- 位置：頁面底部 footer
+- 顯示：
+  - 📈 總瀏覽量: [數字]
+  - 👥 總訪客數: [數字]
+- 條件：`showStats = true`
+
+## 🎯 如何使用
+
+### 啟用/停用文章瀏覽量
+編輯 `config/_default/params.toml`:
+```toml
+[article]
+  showViews = true  # 改為 false 停用
+```
+
+### 啟用/停用網站統計
+編輯 `config/_default/params.toml`:
+```toml
+[footer]
+  showStats = true  # 改為 false 停用
+```
+
+### 單獨控制某篇文章
+在文章的 front matter 中：
+```yaml
+---
+title: "我的文章"
+showViews: false  # 這篇文章不顯示瀏覽量
+---
+```
+
+## 📁 創建的文件清單
+
+```
+layouts/
+├── _default/
+│   └── rss.xml                    # RSS 優化模板
+├── partials/
+│   ├── extend-head.html           # 已更新：加入 busuanzi 腳本
+│   ├── footer.html                # 覆寫：整合網站統計
+│   ├── footer-stats.html          # 新增：網站總統計組件
+│   └── meta/
+│       └── views.html             # 覆寫：文章瀏覽量組件
+i18n/
+├── en.yaml                        # 新增：英文翻譯
+├── zh-tw.yaml                     # 已更新：繁體中文翻譯
+└── zh-cn.yaml                     # 已更新：簡體中文翻譯
+```
+
+## 🚀 部署到 Cloudflare
+
+現有配置已可直接部署，不需要額外設置：
+
+```bash
+# 構建網站
+hugo
+
+# Cloudflare Pages 會自動檢測 Hugo 項目
+# 構建命令：hugo
+# 輸出目錄：public
+```
+
+## 🎨 自定義樣式
+
+如需調整統計顯示樣式，編輯 `layouts/partials/extend-head.html` 中的 CSS：
+
+```css
+.busuanzi-stats {
+  display: inline-flex;
+  align-items: center;
+  gap: 1rem;              /* 間距 */
+  font-size: 0.875rem;    /* 字體大小 */
+  opacity: 0.7;           /* 透明度 */
+  margin: 0.5rem 0;       /* 外邊距 */
+}
+```
+
+## 📈 統計數據
+
+- **文章頁 PV (Page Views)**：每次訪問文章累加
+- **網站總 PV**：所有頁面瀏覽總數
+- **網站總 UV (Unique Visitors)**：獨立訪客數（基於 IP）
+
+## ⚠️ 注意事項
+
+1. **首次部署**：統計數據從 0 開始，會隨著訪問逐漸累積
+2. **緩存問題**：Cloudflare CDN 可能會緩存頁面，導致計數延遲
+3. **數據持久性**：busuanzi 的數據由第三方服務管理
+4. **隱私友好**：不蒐集個人資訊，符合 GDPR
+
+## 🔧 進階優化（可選）
+
+### 使用 Cloudflare Workers 自建統計
+如果想要更精確的控制和數據所有權，可以：
+1. 創建 Cloudflare Workers + KV
+2. 替換 busuanzi 腳本
+3. 自行管理統計數據
+
+詳見之前提供的 Workers 方案。
+
+## ✅ 驗證清單
+
+- [x] Hugo 構建成功
+- [x] RSS 包含完整內容
+- [x] RSS 包含作者和標籤
+- [x] 文章頁顯示瀏覽量
+- [x] Footer 顯示網站統計
+- [x] 三語言翻譯完整
+- [x] 配置文件正確
+
+## 📝 下一步
+
+1. 提交代碼到 Git
+2. 推送到 GitHub
+3. Cloudflare Pages 自動部署
+4. 訪問網站驗證統計功能
+
+部署後約 24-48 小時，busuanzi 統計數據會開始正常顯示。