自動抓自己的 Bangumi 追番進度到 README 頁面的 GitHub Action 套件

範例那當然是我的 README 啦~

首先要註冊一個 Bangumi 的帳號，然後複製現有的 README.md 到 template/README-eta.md，在想要放列表的地方貼上以下：

| 圖片 | 番劇 |
| --- | --- |
<% it.data.forEach(function (anime) { %>
| ![](<%= anime.subject.images.grid %>) | <%= anime.subject.name_cn %> |
| <img src="<%= anime.subject.images.grid %>" width="48"> | <%= anime.subject.name_cn %> |
<% }) %>

上面那個是1欄的，如果你想要和圖片中一樣使用2欄的表格，可以參考下面的：

| 圖片 | 番劇 | 圖片 | 番劇 |
| --- | --- | --- | --- |
<% it.data.forEach(function (anime) { %><%= anime.index % 2 == 1 ? '|' : '' %> <img src="<%= anime.subject.images.grid %>" width="48"> | <%= anime.subject.name_cn %> |<%= anime.index % 2 == 0 ? '\n' : '' %><% }) %><%= it.data.length % 2 == 0 ? '' : ' | |\n' %>

模板引擎是使用 eta，而可以使用的資料來源則是 Bangumi API 的 獲取用戶收藏，可以自行查詢可使用的資料。

最後增加一個 workflow 檔，把 bangumi_username 改成你的 Bangumi 用戶名稱或 uid，user_agent 改成 [你的GitHub名稱]/[你的GitHub倉庫] README：

.github/workflows/anime_list.yml

name: Update anime list to README

on:
  push:
  schedule:
    - cron: '0 0 * * *'

jobs:
  anime_list:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Update anime list
        uses: ycs77/readme-anime-list@main
        with:
          target: 'README.md'
          template: 'template/README-eta.md'
          bangumi_username: '715333'
          bangumi_limit: 10
          user_agent: 'ycs77/ycs77 README'

      - name: Commit
        uses: EndBug/add-and-commit@v9
        with:
          message: 'Update generated README'

Required 目標 README 檔。

Required README 模板檔案。

Required Bangumi 用戶名稱或 uid。

預設值：10

列表項目數量。

預設值："ycs77/readme-anime-list"

給 Bangumi API 看的 User-Agent 值，參考：關於 User-Agent。

在倉庫根目錄下增加 readme-anime-list.config.json，可以增加一些比較複雜的設定。

替換標題文字，可以改成自己比較喜歡的翻譯。左邊是 Bangumi 原有的文字，右邊是可以自己設定的翻譯：

{
  "replace": {
    "莉可丽丝": "莉可麗絲",
    "神渣☆爱豆": "神渣☆偶像"
  }
}

如果我的套件有幫助到你，可以考慮贊助我~ 我會很感謝你~ 而且還可以顯示您的大頭貼在我的主要專案中！

Under the MIT LICENSE