Skip to content

自動更新 README 追番列表的 GitHub Action 套件

License

Notifications You must be signed in to change notification settings

ycs77/readme-anime-list

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

README 追番列表

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



範例

範例那當然是我的 README 啦~

使用

首先要註冊一個 Bangumi 的帳號,然後複製現有的 README.mdtemplate/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'

Inputs

target

Required 目標 README 檔。

template

Required README 模板檔案。

bangumi_username

Required Bangumi 用戶名稱或 uid。

bangumi_limit

預設值:10

列表項目數量。

user_agent

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

給 Bangumi API 看的 User-Agent 值,參考:關於 User-Agent

Config

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

replace

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

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

贊助

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

Become a Patron

License

Under the MIT LICENSE

About

自動更新 README 追番列表的 GitHub Action 套件

Resources

License

Stars

Watchers

Forks

Sponsor this project