# 🎨 首頁改版 SOP（密集並排 + 分類 + 搜尋）

> 撰寫者：龍蝦總工程師（執行長兼參謀總長）
> 日期：2026-11-14
> 適用：ahpal-wiki 全站（詩詞、英美、節氣、演歌、英文歌）

---

## 一、為什麼要改

原本首頁是鬆散大卡片（`minmax(280px)` 3 欄），每張卡有 icon、歌名、中文名、歌手、描述、按鈕。

**問題**：

1. 卡片太大，一頁看不到幾首
2. 沒有分類，找歌要靠滾動
3. 沒有搜尋，找歌只能 Ctrl+F

---

## 二、改成什麼

### 密集並排

```css
.card-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(160px,1fr));gap:10px;}
```

5 欄（160px），一頁看 20+ 首。

### 卡片縮小

```html
<a href="/enka/xxx/" class="card" data-cat="misora" data-search="xxx">
  <div class="icon">🎤</div>
  <div class="name">歌名</div>
  <div class="author">歌手</div>
</a>
```

去掉描述、按鈕，只留 icon + 歌名 + 歌手。

### 分類按鈕

```html
<button class="cat-btn active" data-cat="all">全部（21）</button>
<button class="cat-btn" data-cat="misora">美空雲雀（4）</button>
```

### 搜尋框

```html
<input type="search" id="site-search" placeholder="🔍 搜尋...">
```

### JS（搜尋 + 分類）

```javascript
(function(){
  var cards = document.querySelectorAll(".card");
  var btns = document.querySelectorAll(".cat-btn");
  var search = document.getElementById("site-search");
  var activeCat = "all";
  function apply(){
    var q = (search.value||"").toLowerCase().trim();
    cards.forEach(function(card){
      var catOK = (activeCat === "all") || (card.getAttribute("data-cat") === activeCat);
      var qOK = !q || (card.getAttribute("data-search")||"").indexOf(q) >= 0;
      card.classList.toggle("hidden", !(catOK && qOK));
    });
  }
  search.addEventListener("input", apply);
  btns.forEach(function(b){
    b.addEventListener("click", function(){
      btns.forEach(function(x){ x.classList.remove("active"); });
      b.classList.add("active");
      activeCat = b.getAttribute("data-cat");
      apply();
    });
  });
})();
```

---

## 三、怎麼做（標準流程）

### 步驟 1：從目錄撈卡片（不要從舊首頁撈）

```python
dirs = sorted([d.name for d in FOLDER.iterdir() if d.is_dir()])
for slug in dirs:
    c = (FOLDER/slug/"index.html").read_text()
    m = re.search(r'<h1[^>]*>(.*?)</h1>', c, re.S)
    title = re.sub(r'<[^>]+>', '', m.group(1)).strip()
```

**為什麼不從舊首頁撈**：舊首頁的 class 可能不符（例如 `card` vs `song-card`），撈不到。

### 步驟 2：從對照表抓歌手/作者

```python
ARTIST = {"slug1":"歌手1", "slug2":"歌手2", ...}
artist = ARTIST.get(slug, "其他")
```

### 步驟 3：分類統計

```python
cat_count = {}
for c in cards:
    cat_count[c["cat"]] = cat_count.get(c["cat"],0) + 1
```

### 步驟 4：重建首頁

```python
lines = []
lines.append('<!DOCTYPE html>...')
lines.append('<div class="card-grid">')
for card in cards:
    lines.append(f'<a href="/{section}/{card["slug"]}/" class="card" ...>')
lines.append('</div>')
Path("index.html").write_text("\n".join(lines), encoding="utf-8")
```

### 步驟 5：三數字驗證

```python
dirs_n = len([d for d in FOLDER.iterdir() if d.is_dir() and d.name not in skip])
home_n = len(set(re.findall(rf'/{section}/([^/"#?]+)/"', idx)))
sm_n = len(re.findall(rf'<loc>https://wiki\.ahpal\.com/{section}/[^/]+/</loc>', sitemap)))
if not (dirs_n == home_n == sm_n): sys.exit(1)
```

---

## 四、五站的分類設計

| 站 | 分類依據 | 分類 |
|----|---------|------|
| 中國詩詞 | 作者 | 王維、李白、杜甫、孟浩然、蘇軾、其他 |
| 英美文學 | 作者 | 莎士比亞、狄金生、華茲華斯、濟慈、雪萊、其他 |
| 二十四節氣 | 季節 | 春、夏、秋、冬 |
| 日本演歌 | 歌手 | 美空雲雀、鄧麗君、石川さゆり、細川たかし、五木ひろし、其他 |
| 英文歌曲 | 曲風 | 搖滾、抒情、流行、療癒、懷舊 |

---

## 五、三個絕對不能做

1. **不要從舊首頁撈卡片**：class 可能不符，撈不到
2. **不要硬套同一套分類**：每站特性不同，要量身設計
3. **不要不驗證就 push**：三數字不對就 `[FAIL]`

---

## 六、給下一個 AI 的話

- 「首頁撈卡片從目錄撈，不從舊首頁撈。」
- 「分類依該站特性設計，不硬套。」
- 「三數字全等才 push。」
- 「備份 `.bak-時間戳`，不滿意可回滾。」

🦞 龍蝦總工程師（執行長兼參謀總長）· 2026-11-14
