如何使用
| 2021-10-8
0  |  阅读时长 0 分钟

Showcase

可以使用 Notion 来查看并管理你所有的 GitHub starred repo,并且还可以添加自己的标签、批注、以及其他内容。
notion image
 

复制 Notion 模板

复制这个模板:
📫
Github Notion Star
notion image

Fork Github Repo

Fork 这个 repo:
 
Fork 之后,需要在 Settings / Secrets 里面新建三个环境变量,分别是:
  • NOTION_API_KEY Notion 的 API KEY,用于对页面进行修改
  • NOTION_DATABASE_ID 上面复制的页面的 database id
  • TOKEN_OF_GITHUB Github 的 TOKEN,用于查询 star 过的 repo
notion image

如何获取配置

获取 Notion Database Id
  1. 打开 database 的单独页面(可以从左侧进入)
 
  1. 页面形如 https://www.notion.so/lcj/82be7d43506548ea82f994f6796e51f8?v=e285b32b024e4c619ed5a72bd4f3c0a1 ,而前面的部分就是 database id:82be7d43506548ea82f994f6796e51f8
notion image
获取 Notion API Key
 
注意,需要把 Database 页面所在的文档,分享给这个 Notion API
notion image
获取 GitHub API Key
 
注意,这里申请 API Key 的时候,不需要授予任何权限。
 
 

开始同步

(可选)全量同步

全量同步会一次性的将之前所有 star 的 repo 同步到数据库(默认会同步 2000 个,可以通过覆盖 FULLSYNC_LIMIT 这个环境变量来修改),只需要执行一次就行。
只需要在 GitHub 的 Actions 页面,执行 FullSync Notion Star 即可:
notion image

(可选,推荐开启)定时增量同步

增量同步会同步最近 star 的若干个 repo(默认为 20 个,可以通过覆盖 PARTIALSYNC_LIMIT 环境变量来修改)
增量同步的默认时间间隔是两小时,可以通过修改 github-notion-star/.github/workflows/partial-sync.yml 文件中间的 cron 时间来修改。
开启增量同步,需要在 GitHub Actions 中,启用 Partial Sync Notion Star 这个 Action
notion image

测试

完成「配置定时增量同步后」,可以给这个项目点一下 star,并手动执行下 Partial Sync(或者等待自动执行),不出意外会在 database 里面发现这个项目了。
 
 
 
Loading...
目录