feat: 更新 README 以反映新功能與結構調整，移除不必要的文章瀏覽量佔位符

Author: Zakkaus

README.md

@@ -1,56 +1,60 @@
-## Zakk Blog
-
-Multi-language personal site built with [Hugo](https://gohugo.io/) + [Blowfish](https://blowfish.page/) theme.
-
-### Tech Stack
-- Hugo static site (content in English / 繁體中文 / 简体中文)
-- Blowfish theme with custom partial overrides & shortcodes
-- Custom Cloudflare Stats Worker (PV / UV counting, batch list queries, popular posts via D1)
-- Cloudflare Pages / CDN + custom domain assets
-
-### Directories
-| Path | Purpose |
-|------|---------|
-| `content/` | Markdown content (posts, about, timeline, localized `_index` files) |
-| `layouts/` | Custom partials, list templates, shortcodes (e.g. `topPosts`) |
-| `assets/js/` | Front-end ES modules processed by Hugo Pipes (`cloudflare-stats.js`, `cloudflare-top.js`) |
-| `i18n/` | Translation bundles (adds `stats.*` keys for popular posts widget) |
-| `cloudflare-stats-worker/` | Worker + D1 schema & infra docs |
-
-### Cloudflare Stats Integration
-The worker exposes:
-- `GET /api/count?url=/path/` increment + return PV/UV (page + site)
-- `GET /api/batch?urls=/a,/b` batch read up to 50 paths
-- `GET /api/stats?url=/path/` read only (no increment) or omit `url` for site totals
-- `GET /api/top?limit=5&min_pv=10` popular posts (D1 backed)
-- `GET /health` health & version
-
-Front-end scripts auto-detect placeholders by ID prefix `views_` and `[data-stats-site]` attributes. Popular section is rendered via the `{{< topPosts >}}` shortcode inserting a container with `data-stats-top` consumed by `cloudflare-top.js`.
-
-### Development
+## Zakk Blog / 雙語部落格
+
+Personal bilingual site (English / 繁體中文 / 简体中文) powered by [Hugo](https://gohugo.io/) + [Blowfish](https://blowfish.page/). Clean content first; minimal custom code kept inside this repo.
+
+### ✨ Features
+- Multilingual content & navigation
+- Lightweight PV/UV stats (self‑hosted Cloudflare Worker + KV + D1)
+- Popular posts widget (server sorted by D1 `/api/top`)
+- Batch list page stats (reduces requests)
+- Fully static build deployed via Cloudflare Pages
+
+### 📂 Structure (kept small)
+| Dir | Description |
+|-----|-------------|
+| `content/` | Articles, about page, timeline, localized `_index.*.md` |
+| `layouts/` | Only necessary overrides (partials, shortcode `topPosts`) |
+| `assets/js/` | Front-end logic: `cloudflare-stats.js`, `cloudflare-top.js` |
+| `i18n/` | Translation files (adds `stats.*` keys) |
+| `cloudflare-stats-worker/` | Worker project + D1 schema + verify scripts |
+
+### 🧮 Stats API (Worker)
+| Endpoint | Purpose |
+|----------|---------|
+| `/api/count?url=/path/` | Increment + return page + site PV/UV |
+| `/api/batch?urls=/a,/b` | Read many pages (no increment) |
+| `/api/stats?url=/path/` | Read single page (no increment) |
+| `/api/stats` | Site totals only |
+| `/api/top?limit=5` | Popular posts by PV (D1) |
+| `/health` | Health & version |
+
+Front-end auto-detects `span[id^="views_"]` and `[data-stats-site]` placeholders; no inline framework needed.
+
+### 🚀 Develop
 ```bash
-# Run Hugo local server
+# Start site
 hugo server -D
 
-# (Optional) Dev the Cloudflare worker in parallel
+# (Optional) Worker dev (in sub dir)
 cd cloudflare-stats-worker
 wrangler dev --local --persist-to=./.data
 ```
 
-### Popular Posts (D1)
-`cloudflare-stats-worker/schema.sql` defines `page_stats` table. Each `/api/count` syncs PV/UV into D1 (best-effort). The `/api/top` endpoint reads and caches results (60s edge cache).
+### 🔄 Deploy (manual outline)
+```bash
+git add .
+git commit -m "chore: content & stats update"
+git push origin main   # Triggers Cloudflare Pages build
 
-### i18n Additions
-Added keys under `stats.*` used by the popular widget:
-```
-stats.popularTitle
-stats.loading
-stats.error
-stats.empty
+# Deploy worker (if code changed)
+cd cloudflare-stats-worker
+wrangler deploy
 ```
 
-### License
+### 🌐 i18n Keys Added
+`stats.popularTitle`, `stats.loading`, `stats.error`, `stats.empty`
+
+### 📜 License
 MIT
 
----
-See `cloudflare-stats-worker/README.md` for the full worker / cost / architecture documentation.
+More infra / cost notes: see `cloudflare-stats-worker/README.md`.

layouts/partials/article-views.html

@@ -1,13 +1 @@
-{{/* Minimal placeholder for page views. Keep it tiny and let JS fill number. */}}
-{{ $page := . }}
-{{ with $page.File }}
-  {{ $path := .Path }}
-  {{ range $page.AllTranslations }}
-    {{ $lang := print "."  .Lang  ".md" }}
-    {{ $path = replace $path $lang ".md" }}
-  {{ end }}
-  <span id="views_{{ $path }}" class="inline-block min-w-[2ch] text-neutral-500 dark:text-neutral-400" data-loading>
-    <span class="sr-only">Views</span>
-    <span class="animate-pulse text-transparent bg-neutral-300 dark:bg-neutral-600 rounded-full px-2">000</span>
-  </span>
-{{ end }}
+{{/* (Removed; theme handles views placeholder) */}}